summaryrefslogtreecommitdiff
path: root/pkg-config.1
diff options
context:
space:
mode:
Diffstat (limited to 'pkg-config.1')
-rw-r--r--pkg-config.133
1 files changed, 29 insertions, 4 deletions
diff --git a/pkg-config.1 b/pkg-config.1
index e8df5b3..dd4a8f8 100644
--- a/pkg-config.1
+++ b/pkg-config.1
@@ -186,14 +186,17 @@ command line are known to \fIpkg-config\fP, and optionally whether the
version number of a package meets certain constraints. If all packages
exist and meet the specified version constraints,
.I pkg-config
-exits successfully. Otherwise it exits unsuccessfully.
+exits successfully. Otherwise it exits unsuccessfully. Only the first
+VERSION comparing option will be honored. Subsequent options of this
+type will be ignored.
Rather than using the version-test options, you can simply give a version
constraint after each package name, for example:
.nf
$ pkg-config --exists 'glib-2.0 >= 1.3.4 libxml = 1.8.3'
.fi
-Remember to use \-\-print-errors if you want error messages.
+Remember to use \-\-print-errors if you want error messages. When no
+output options are supplied to \fIpkg-config\fP, \-\-exists is implied.
.TP
.I "--msvc-syntax"
This option is available only on Windows. It causes \fIpkg-config\fP
@@ -223,7 +226,7 @@ output.
.I "--list-all"
List all modules found in the \fIpkg-config\fP path.
.TP
--I "--print-provides"
+.I "--print-provides"
List all modules the given packages provides.
.TP
.I "--print-requires"
@@ -266,7 +269,7 @@ disables said behavior.
Don't strip -I/usr/include out of cflags.
.TP
.I "PKG_CONFIG_ALLOW_SYSTEM_LIBS"
-Don't strip -L/usr/lib out of libs
+Don't strip -L/usr/lib or -L/lib out of libs.
.TP
.I "PKG_CONFIG_SYSROOT_DIR"
Modify -I and -L to use the directories located in target sysroot.
@@ -344,6 +347,28 @@ to PKG_CHECK_MODULES(), but does not set variables or print errors.
Similar to PKG_CHECK_MODULES, make sure that the first instance of
this or PKG_CHECK_MODULES is called, or make sure to call
PKG_CHECK_EXISTS manually.
+.TP
+.I "PKG_INSTALLDIR(DIRECTORY)"
+
+Substitutes the variable pkgconfigdir as the location where a module
+should install pkg-config .pc files. By default the directory is
+$libdir/pkgconfig, but the default can be changed by passing DIRECTORY.
+The user can override through the --with-pkgconfigdir parameter.
+.TP
+.I "PKG_NOARCH_INSTALLDIR(DIRECTORY)"
+
+Substitutes the variable noarch_pkgconfigdir as the location where a
+module should install arch-independent pkg-config .pc files. By default
+the directory is $datadir/pkgconfig, but the default can be changed by
+passing DIRECTORY. The user can override through the
+--with-noarch-pkgconfigdir parameter.
+.TP
+.I "PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])"
+
+Retrieves the value of the pkg-config variable CONFIG-VARIABLE from
+MODULE and stores it in VARIABLE. Note that repeated usage of VARIABLE
+is not recommended as the check will be skipped if the variable is
+already set.
.SH METADATA FILE SYNTAX
To add a library to the set of packages \fIpkg-config\fP knows about,