NAME

mkpkgconfig - create pkg-config metadata files

VERSION

version v2.0.2

SYNOPSIS

mkpkgconfig options

DESCRIPTION

mkpkgconfig creates a pkg-config metadata (.pc) file. pkg-config variables and keywords are defined on the command line, variable dependencies are validated, and the configuration file is output. "Standard" variables (such as $libdir, $datadir) may be automatically created, and only variables which are used are output.

Variables and Keywords

pkg-config distinguishes between variables and keywords. Values for both may include interpolated variables, as in Cflags: -I ${include}.

Some commonly used variables have dedicated command line options:

--prefix     : base prefix for paths
--package    : filesystem compatible package name
--modversion : package version

(--modversion sets the version variable; the --version flag will output the version of mkpkgconfig).

--modversion is required. --prefix and --package may be required if a keyword requires them or --auto is set and auto-generated variables require it.

Common keywords also have dedicated options:

--Name
--Conflicts
--Description
--Requires
--Libs
--Cflags
--URL

The --Name and --Description options are required. The Version keyword is automatically set to ${version}. It is not possible to set it directly from the command line.

Other variables and keywords may be specified via the --var and --kwd options, respectively:

--var name=value
--kwd name=value

which may be used more than once.

Automatically Generated Variables

mkpkgconfig can automatically generate a number of "standard" variables, such as bindir, libdir, etc, based upon the prefix variable. Use the "--list-auto" option to output a list of these variables.

OPTIONS

General Options

• --output

  Where the configuration file is to be written. It defaults to the standard output stream.

• --usevars all|requested|needed

  Which variables should be output. It defaults to needed.

  • all

    output all variables, needed or not, including automatically generated ones if --auto was specified;

  • requested

    output only requested variables (via--var variable=value or --auto=variable,...) and keyword dependencies;

  • needed

    output only those variables actually used by keywords

Variables

• --var name=value

  Set the variable named name to value.

• --prefix value

  Set the prefix variable.

• --package value

  Set the package variable

• --modversion value

  Set the version value

• --auto

• --auto list of variables

  Generate a set of variables. Use --list-auto to see what is generated.

  If passed a list of variable names, those will be output if --usevars is set to requested.

  Individual variables may be overriden using --var.

• --list-auto

  Output a list of the automatically generated keywords and exit.

Keywords

• --kwd name=value

  Set the keyword named name to value.

• --Name value

• --name value

  Set the Name keyword. This parameter is required.

• --Description value

• --description value

  Set the Description keyword. This parameter is required.

• --Requires value

• --requires value

  Set the Requires keyword.

• --Conflicts value

• --conflicts value

  Set the Conflicts keyword.

• --Libs value

• --libs value

  Set the Libs keyword.

• --Cflags value

• --cflags value

  Set the Cflags keyword.

Miscellaneous

• --version

  Output the version of mkpkgconfig and exit.

• --help

  Output a short help message and exit.

• --manual

  Output the manual and exit.

SUPPORT

Bugs

Please report any bugs or feature requests to bug-app-mkpkgconfig@rt.cpan.org or through the web interface at: https://rt.cpan.org/Public/Dist/Display.html?Name=App-mkpkgconfig

Source

Source is available at

https://gitlab.com/djerius/app-mkpkgconfig

and may be cloned from

https://gitlab.com/djerius/app-mkpkgconfig.git

AUTHOR

Diab Jerius djerius@cpan.org

COPYRIGHT AND LICENSE

This software is Copyright (c) 2020 by Smithsonian Astrophysical Observatory.

This is free software, licensed under:

The GNU General Public License, Version 3, June 2007