aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2022-03-28 10:02:40 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2022-03-28 10:02:40 +0200
commit9e55ab1d39bf987d7df87a027c4331e9be309d09 (patch)
treed65e8c2900cae4077b4ca7b591be874c784d1382 /doc
parent7d50db8924b8ce4faf05cde737bce9114df58f0d (diff)
Add ability to customize pkg-config header and library search paths
Specifically, {cc,c,cxx}.pkgconfig.{include,lib} variables specify header (-I) and library (-L) search paths to use in the generated .pc files instead of the default install.{include,lib}. Relative paths are resolved as install paths.
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli33
1 files changed, 27 insertions, 6 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 910ca0a..36e36bd 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -2353,6 +2353,27 @@ the \c{details/} subdirectory with the \c{utility.hxx} header, then this
header would have been installed as
\c{.../include/libhello/details/utility.hxx}.
+\N|By default the generated \c{pkg-config} files will contain
+\c{install.include} and \c{install.lib} directories as header (\c{-I}) and
+library (\c{-L}) search paths, respectively. However, these can be customized
+with the \c{{c,cxx\}.pkgconfig.{include,lib\}} variables. For example,
+sometimes we may need to install headers into a subdirectory of the include
+directory but include them without this subdirectory:
+
+\
+# Install headers into hello/libhello/ subdirectory of, say,
+# /usr/include/ but include them as <libhello/*>.
+#
+hxx{*}:
+{
+ install = include/hello/libhello/
+ install.subdirs = true
+}
+
+lib{hello}: cxx.pkgconfig.include = include/hello/
+\
+
+|
\h2#intro-operations-dist|Distributing|
@@ -6508,12 +6529,12 @@ config.c
config.cxx
cc.id
- c.target
- c.target.cpu
- c.target.vendor
- c.target.system
- c.target.version
- c.target.class
+ cc.target
+ cc.target.cpu
+ cc.target.vendor
+ cc.target.system
+ cc.target.version
+ cc.target.class
config.cc.poptions
cc.poptions