summaryrefslogtreecommitdiff
path: root/pkg-config.1
Commit message (Collapse)AuthorAgeFilesLines
* pkg: Check INCLUDE environment variable for MSVCDan Nicholson2017-03-201-1/+9
| | | | | | | | | On Windows builds when --msvc-syntax is in use, add paths in the INCLUDE environment variable to the system include search path and ignore the various GCC environment variables. See https://msdn.microsoft.com/en-us/library/73f9s62w.aspx for details. https://bugs.freedesktop.org/show_bug.cgi?id=94729
* man: Document PKG_PROG_PKG_CONFIG conditional issue thereDan Nicholson2017-03-201-1/+9
| | | | | | | The issue of PKG_PROG_PKG_CONFIG being run first from a conditional affects more than PKG_CHECK_MODULES and PKG_CHECK_EXISTS since PKG_PROG_PKG_CONFIG is AC_REQUIRE'd from many other macros. Describe the issue completely in the PKG_PROG_PKG_CONFIG section.
* man: Fix PKG_CHECK_EXISTS comment about PKG_PROG_PKG_CONFIGDan Nicholson2017-03-201-3/+4
| | | | | | | | The sentence is clearly referring to the issue of running PKG_PROG_PKG_CONFIG from outside of a conditional. Thanks to Reuben Thomas for the suggestion. https://bugs.freedesktop.org/show_bug.cgi?id=99885
* man: Put valid make syntax in the exampleDan Nicholson2017-03-191-1/+1
| | | | | | | | Use backquotes for substitution in the Makefile example as using the $() form of command substitution would actually use make's variable substitution and fail. Thanks to joerg.strebel@gmail.com for the report. https://bugs.freedesktop.org/show_bug.cgi?id=98011
* man: Document system search path environment variablesDan Nicholson2017-03-191-2/+30
| | | | | | | | | None of the environment variables affecting the system include and library paths were documented. This includes the pkg-config specific variables like PKG_CONFIG_SYSTEM_INCLUDE_PATH as well as the GCC variables like C_INCLUDE_PATH. https://bugs.freedesktop.org/show_bug.cgi?id=99224
* Allow overriding package variables with env varsAlexander Larsson2016-01-291-0/+7
| | | | | | | | | | | | | | pkg-config allows a way to override package variables through the --define-prefix interface, but this is very cumbersome to do in a global way since it always needs to be passed on the command line and the override cannot be scoped to a single packge. Allow overriding package variables using environment variables of the form PKG_CONFIG_$PACKAGE_$VARIABLE. For example, setting PKG_CONFIG_GLADEUI_2_0_CATALOGDIR will override the variable "catalogdir" in the "gladeui-2.0" package. https://bugs.freedesktop.org/show_bug.cgi?id=90917
* m4: Add PKG_PREREQ version checking macroDan Nicholson2015-09-261-0/+6
| | | | | | | | | | While PKG_PROG_PKG_CONFIG checks the version of pkg-config available at build time, it doesn't check the version of the pkg-config macros being used. PKG_PREREQ (like AC_PREREQ or LT_PREREQ) can be used to check the version of the macros in use when configure is being generated by the developer. https://bugs.freedesktop.org/show_bug.cgi?id=89267
* Add --validate option to check .pc syntax without dependenciesDan Nicholson2014-09-271-1/+13
| | | | | | | | | Provide developers a way to check their .pc files prior to release. This works the same as --exists except that package dependencies are not processed. That allows the .pc file to be checked in complete isolation of others. Freedesktop #7000 (https://bugs.freedesktop.org/show_bug.cgi?id=7000)
* Add missing options to manualMatthias Clasen2013-09-211-2/+18
| | | | Freedesktop #66155 (https://bugs.freedesktop.org/show_bug.cgi?id=66155)
* Add static linking variant of PKG_CHECK_MODULESDan Nicholson2013-05-181-0/+4
| | | | | | | | PKG_CHECK_MODULES_STATIC is a convenience autoconf macro wrapping PKG_CHECK_MODULES with --static enabled. This gives developers a way to get static linking information from a specific set of modules. Freedesktop #19541 (https://bugs.freedesktop.org/show_bug.cgi?id=19541)
* Document all pkg-config derived metadata variablesDan Nicholson2013-05-171-5/+36
| | | | | | | | | | | The derived variables pcfiledir, pc_top_builddir and pc_sysrootdir were lacking in documentation. Rework the "QUERYING PKG-CONFIG'S DEFAULTS" section to describe these and pc_path. The example of using "pkg-config --modversion pkg-config" was removed since it's superfluous to "pkg-config --version". Freedesktop #62018 (https://bugs.freedesktop.org/show_bug.cgi?id=62018)
* Make the --define-prefix feature available on all platformsDan Nicholson2013-05-171-23/+23
| | | | | | | | Allowing pkg-config to override the prefix variable in .pc files is a useful feature for making packages relocatable. There's nothing Windows specific about it. Freedesktop #63602 (https://bugs.freedesktop.org/show_bug.cgi?id=63602)
* Allow Windows prefix redefinition in any pkgconfig directoryDan Nicholson2013-05-171-6/+13
| | | | | | | | | | | | | | The prefix redefinition feature on Windows to make packages relocatable was being confined only to locations where the .pc file was in a directory ending in lib/pkgconfig or share/pkgconfig. This is too restrictive as it's quite common for the libdir to have a different name such as lib64. This keeps the convention that the feature will only be enabled when the .pc file is in a pkgconfig directory, and it continues to define the prefix to the grandparent of the pkgconfig directory. The path handling is switched over to standard glib functions g_path_get_basename and g_path_get_dirname to avoid handrolled handling of Windows paths.
* Allow more control of redefined prefix behaviorDan Nicholson2013-05-171-5/+14
| | | | | | | | | | | Currently the native Win32 builds default to redefining the prefix variable in .pc files based on their installation paths. This behavior is not always desired when pkg-config is being used in a traditional fixed path environment (e.g., /mingw like /usr). Allow the default to be set via configure switch --enable/disable-define-prefix, and allow it to be set both ways at runtime through the --[dont-]define-prefix pkg-config option.
* Fix default path in PKG_CONFIG_LIBDIR descriptionDan Nicholson2013-04-201-1/+4
| | | | It's been a long time that $datadir/pkgconfig was in the default path.
* Document search path construction on WindowsDan Nicholson2013-04-181-0/+12
|
* Remove duplicate LIBRARIES in manualDan Nicholson2013-04-061-2/+2
| | | | Freedesktop #62374 (https://bugs.freedesktop.org/show_bug.cgi?id=62374)
* Add root /lib* directories to the default -L pathsDan Nicholson2012-12-191-1/+1
| | | | | | | Avoids outputting -L/lib, which the linker will search in implicitly like -L/usr/lib. Freedesktop #58363 (https://bugs.freedesktop.org/show_bug.cgi?id=58363)
* Include PKG_CHECK_VAR macro for reading variables in .pc filesDavid Michael2012-12-141-0/+7
| | | | Freedesktop #48098 (https://bugs.freedesktop.org/show_bug.cgi?id=48098)
* Enforce that only the first --atleast/exact/max-version option honoredDan Nicholson2012-12-111-1/+3
| | | | | | This provides the user with output matching the behavior of the code. When multiple --atleast/exact/max-version options are supplied, only the first will be honored.
* Explicitly set --exists as the default optionDan Nicholson2012-12-111-1/+2
| | | | | | | | This happened basically by accident before when "pkg-config foo" was run because the code wouldn't find any options set and just fall through to the end after processing the package arguments. However, it would act differently in that Requires.private was only enabled with an explicit --exists.
* Document PKG*INSTALLDIR autoconf macros in manpageDan Nicholson2012-12-081-0/+15
| | | | Freedesktop #54463 (https://bugs.freedesktop.org/show_bug.cgi?id=54463)
* Fix formatting for --print-provides in man pageDan Nicholson2012-10-031-1/+1
|
* Discourage repeated usage of VARIABLE-PREFIX in PKG_CHECK_MODULESDan Nicholson2012-08-221-0/+5
| | | | | | | | | | | | | | | When the VARIABLE-PREFIX tag is used more than once in PKG_CHECK_MODULES it can result in later runs reporting success without actually running pkg-config. This is because PKG_CHECK_MODULES looks for FOO_CFLAGS and FOO_LIBS from the environment as a way to allow users to override the test. PKG_CHECK_MODULES also sets these variables, though, and subsequent calls will simply use these values. Although there are legitimate ways to use the same VARIABLE-PREFIX (e.g., they're all under conditionals meaning only one will be used), document that repeated usage is not recommended. Freedesktop #3550
* Document a couple more pkg-config optionsDan Nicholson2012-05-101-1/+12
|
* Fix errors in man page source cause missing contentLawrence A. Murakami2012-05-101-1/+3
| | | | Freedesktop #29011
* Remove unused roff macros causing problems on old groff/nroffDan Nicholson2012-04-161-19/+0
| | | | | | | | | | The DW and EW roff macros had been used to suppress warnings around the documentation on the now removed Windows registry keys. These macro definitions are unneeded and cause problems with older groff and nroff versions. Numerous patches exist around the web to remove them. I confirmed this with an old nroff from the Heirloom project. Fixes Freedesktop #5214
* Document specifying paths to .pc filesTollef Fog Heen2011-05-151-0/+4
| | | | | | Thanks to Binki for the patch Freedesktop #32622
* Mention that auto* recommends building .pc files at build timeTollef Fog Heen2011-04-131-2/+5
| | | | Fixes Freedesktop #32094
* Man page syntax and spelling fixes.Ville Skyttä2011-04-131-8/+8
|
* Document pc_path a bitTollef Fog Heen2010-05-271-1/+10
|
* Fix typo in man pageTollef Fog Heen2010-05-241-1/+1
|
* Add --print-provides and --print-requires-private to the manual pageJohannes Schmid2010-05-101-0/+10
|
* Fix formatting typo in pkg-config.1Kirill Smelkov2010-05-091-1/+1
| | | | | Without <dot>TP, "Requires" and "Requires.private" are rendered as one paragraph.
* Add listing of variablesJorn Amundsen2010-05-091-0/+5
| | | | Fixes Freedesktop #133
* Fix up man pageTollef Fog Heen2010-05-091-41/+55
| | | | | | | Make sure to avoid \ macros at the start of lines, as that makes some man implementations unhappy. Fixes freedesktop #17914
* Make it clearer which directory PKG_CONFIG_LIBDIR refers toTollef Fog Heen2010-05-081-1/+1
| | | | Fixes Freedesktop.org #26879
* Use $() rather than ``Tollef Fog Heen2010-05-081-1/+1
| | | | Fixes Freedesktop.org #27376
* Document --list-all option in man pageDan Nicholson2010-05-081-1/+4
| | | | Present in the --help output, but not the manual...
* Add link to bugs.fd.o in man pageTollef Fog Heen2009-12-061-0/+3
| | | | Bug #4793
* 2009-06-12 Tor Lillqvist <tml@iki.fi>Tollef Fog Heen2009-06-301-0/+4
| | | | | | | | | | | | | | * parse.c: On Win32, if the value of a a variable other than the "prefix" one starts with the non-overridden value of "prefix", then replace that prefix, too, with the run-time one. To avoid shadowing warnings, rename a 'p' variable to 'q'. * pkg-config.1: Corresponding update. * main.c * pkg.h: Move the Win32 redefinition of PKG_CONFIG_PC_PATH from main.c to pkg.h as it now is needed in pkg.c, too.
* 2009-03-30 Tollef Fog Heen <tfheen@err.no>Tollef Fog Heen2009-03-301-1/+3
| | | | | * pkg-config.1: Verbosify the text about Libs.private a bit. Patch from Loïc Minier.
* 2009-03-30 Tollef Fog Heen <tfheen@err.no>Tollef Fog Heen2009-03-301-0/+4
| | | | | * pkg-config.1: Add documentation for --cflags-only-I, patch from Loïc Minier.
* 2008-03-23 Stepan Kasal <skasal@redhat.com>Tollef Fog Heen2008-03-231-0/+13
| | | | | * pkg-config.1: Document "Requires.private" and recommend it for libraries. Freedesktop #13188
* 2008-03-23 Stepan Kasal <skasal@redhat.com>Tollef Fog Heen2008-03-231-39/+12
| | | | | | * pkg-config.1: Fix a few typos--add two omitted .TP tags and two omitted full stops; and empty lines do influence the formatting in nroff.
* 2008-02-19 Tor Lillqvist <tml@novell.com>Tollef Fog Heen2008-03-231-14/+4
| | | | | | | | | | | | | | | | | | | | * main.c: Remove the possibility to have a default PKG_CONFIG_PATH in the Registry. It is much more flexible to just use environment variables. In general the Registry is not used in the ports of GTK+ or GNOME libraries and software to Windows. * parse.c (parse_line): On Windows, handle also .pc files found in a share/pkgconfig folder when automatically redefining a prefix variable for the package. * pkg-config.1: Corresponding changes. 2008-02-18 Tor Lillqvist <tml@novell.com> * main.c: Fix some bitrot: On Windows, don't use the compile-time PKG_CONFIG_PC_PATH, but deduce a default one at run-time based on the location of the executable. This was originally what pkg-config did on Windows, but it had bit-rotted.
* 2008-01-16 Tollef Fog Heen <tfheen@err.no>Tollef Fog Heen2008-01-161-0/+9
| | | | | | * pkg.h, pkg.c (string_list_to_string), pkg-config.1, main.c (main): Add sysroot support and document same. Triggered by setting PKG_CONFIG_SYSROOT_DIR in the environment.
* 2006-08-16 Tollef Fog Heen <tfheen@err.no>Tollef Fog Heen2006-08-161-0/+9
| | | | | * pkg-config.1: Apply patch from Ed Catmur to document PKG_CHECK_EXIST. Thanks a lot for both patches.
* 2006-08-16 Tollef Fog Heen <tfheen@err.no>Tollef Fog Heen2006-08-161-0/+4
| | | | | | * pkg-config.1: Apply patch from Ed Catmur to document PKG_PROG_PKG_CONFIG and that it should be used if the first call to PKG_CHECK_MODULES might not happen.
* 2005-06-03 Tollef Fog Heen <tfheen@err.no>Arch Librarian2005-07-141-1/+1
| | | | | | | | | Author: tfheen Date: 2005-06-03 06:53:20 GMT 2005-06-03 Tollef Fog Heen <tfheen@err.no> * pkg.m4, README, pkg-config.1: s/configure.in/configure.ac/, thanks to Morten Brix Pedersen <morten@wtf.dk>