summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Nicholson <dbn.lists@gmail.com>2017-03-20 06:48:28 -0500
committerDan Nicholson <dbn.lists@gmail.com>2017-03-20 06:51:27 -0500
commit325ddf2f4b19a9084dedd3d458f7d02f5b854dec (patch)
treef3690cf88c08fe68fa8714053ded4f92a23f35ba
parent99ef6fd55a5735bd800c9e5ed0393eac9047362d (diff)
man: Document PKG_PROG_PKG_CONFIG conditional issue there
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.
-rw-r--r--pkg-config.110
1 files changed, 9 insertions, 1 deletions
diff --git a/pkg-config.1 b/pkg-config.1
index e4bc757..c8cec84 100644
--- a/pkg-config.1
+++ b/pkg-config.1
@@ -468,7 +468,15 @@ macro will be available.
Defines the PKG_CONFIG variable to the best pkg-config available,
useful if you need pkg-config but don't want to use PKG_CHECK_MODULES.
-.\"
+
+If the first call to PKG_PROG_PKG_CONFIG is conditional, then it will
+not work correctly in all cases. Since many of the other macros such as
+PKG_CHECK_MODULES require PKG_PROG_PKG_CONFIG to know which pkg-config
+program to run, PKG_PROG_PKG_CONFIG may be run for the first time from a
+conditional from one of these macros. Therefore, if any of the
+pkg-config macros will be used under a conditional, it's best to run
+PKG_PROG_PKG_CONFIG before any of the other macros are used.
+
.TP
.I "PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES [,ACTION-IF-FOUND [,ACTION-IF-NOT-FOUND]])"
Enables static linking through --static prior to calling