aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2020-02-04 09:01:36 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2020-02-04 09:01:36 +0200
commitb9d38eadae2fd9d933abb20893d2a3f822b0210e (patch)
treea2aeb2fb3cc86f39a0007d187fed142ce637a5e1 /doc
parentc68ec49334b072535d79dc52e0aafa05f0015cb8 (diff)
Add note to manual on specifying search paths in compiler mode
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index bd06809..525d74e 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1732,6 +1732,19 @@ will appear last on the command lines. For example:
$ b configure config.cxx=\"g++ -m32\"
\
+The compiler mode options are also the correct place to specify
+\i{system-like} header (\c{-I}) and library (\c{-L}, \c{/LIBPATH}) search
+paths. Where by system-like we mean common installation directories like
+\c{/usr/include} or \c{/usr/local/lib} which may contain older versions of the
+libraries we are trying to build and/or use. By specifying these paths as part
+of the mode options (as opposed to \c{config.*.poptions} and
+\c{config.*.loptions}) we make sure they will be considered last, similar to
+the compiler's build-in search paths. For example:
+
+\
+$ b configure config.cxx=\"g++ -L/opt/install\"
+\
+
|
We can also configure out of source builds of our projects. In this case,