man: document more recently added features in the frontend

pull/100/head
William Pitcock 2016-11-15 22:52:07 -06:00
parent 8ecf7c186b
commit 3f61f58c20
1 changed files with 44 additions and 3 deletions

View File

@ -1,4 +1,4 @@
.\" Copyright (c) 2011, 2012, 2013, 2014 pkgconf authors (see AUTHORS). .\" Copyright (c) 2011, 2012, 2013, 2014, 2015, 2016 pkgconf authors (see AUTHORS).
.\" .\"
.\" Permission to use, copy, modify, and/or distribute this software for any .\" Permission to use, copy, modify, and/or distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above .\" purpose with or without fee is hereby granted, provided that the above
@ -7,7 +7,7 @@
.\" This software is provided 'as is' and without any warranty, express or .\" This software is provided 'as is' and without any warranty, express or
.\" implied. In no event shall the authors be liable for any damages arising .\" implied. In no event shall the authors be liable for any damages arising
.\" from the use of this software. .\" from the use of this software.
.Dd February 2, 2015 .Dd November 15, 2016
.Dt PKGCONF 1 .Dt PKGCONF 1
.Os .Os
.Sh NAME .Sh NAME
@ -56,6 +56,15 @@ modules added to the resolver's solution.
.It Fl -static .It Fl -static
Compute a deeper dependency graph and use compiler/linker flags intended for Compute a deeper dependency graph and use compiler/linker flags intended for
static linking. static linking.
.It Fl -pure
Treats the computed dependency graph as if it were pure. This is mainly intended
for use with the
.Fl -static
flag.
.It Fl -no-provides
Ignore
.Sq Provides
rules in modules when resolving dependencies.
.El .El
.Sh MODULE-SPECIFIC OPTIONS .Sh MODULE-SPECIFIC OPTIONS
.Bl -tag -width indent .Bl -tag -width indent
@ -104,6 +113,10 @@ Variables are used in query output, and some modules' results may change based
on the presence of a variable definition. on the presence of a variable definition.
.It Fl -print-variables .It Fl -print-variables
Print all seen variables for a module to the output channel. Print all seen variables for a module to the output channel.
.It Fl -print-provides
Print all relevant
.Sq Provides
entries for a module to the output channel.
.It Fl -variable Ns = Ns Ar VARNAME .It Fl -variable Ns = Ns Ar VARNAME
Print the value of Print the value of
.Va VARNAME . .Va VARNAME .
@ -121,7 +134,11 @@ file. This can be used with graphviz to visualize module interdependencies.
.Sh ENVIRONMENT .Sh ENVIRONMENT
.Bl -tag -width indent .Bl -tag -width indent
.It Va PKG_CONFIG_PATH .It Va PKG_CONFIG_PATH
List of directories where List of secondary directories where
.Sq .pc
files are looked up.
.It Va PKG_CONFIG_LIBDIR
List of primary directories where
.Sq .pc .Sq .pc
files are looked up. files are looked up.
.It Va PKG_CONFIG_SYSROOT_DIR .It Va PKG_CONFIG_SYSROOT_DIR
@ -129,6 +146,30 @@ files are looked up.
directory, will be prepended to every path defined in directory, will be prepended to every path defined in
.Va PKG_CONFIG_PATH . .Va PKG_CONFIG_PATH .
Useful for cross compilation. Useful for cross compilation.
.It Va PKG_CONFIG_TOP_BUILD_DIR
Provides an alternative setting for the
.Sq pc_top_builddir
global variable.
.It Va PKG_CONFIG_PURE_DEPGRAPH
If set, enables the same behaviour as the
.Fl -pure
flag.
.It Va PKG_CONFIG_SYSTEM_INCLUDE_PATH
List of paths that are considered system include paths by the toolchain.
This is a pkgconf-specific extension.
.It Va PKG_CONFIG_SYSTEM_LIBRARY_PATH
List of paths that are considered system library paths by the toolchain.
This is a pkgconf-specific extension.
.It Va PKG_CONFIG_DISABLE_UNINSTALLED
If set, enables the same behaviour as the
.Fl -no-uninstalled
flag.
.It Va PKG_CONFIG_LOG
.Sq logfile
which is used for dumping audit information concerning installed module versions.
.It Va PKG_CONFIG_DEBUG_SPEW
If set, enables additional debug logging. The format of the debug log messages is
implementation-specific.
.El .El
.Sh EXAMPLES .Sh EXAMPLES
Displaying the CFLAGS of a package: Displaying the CFLAGS of a package: