diff options
author | Boris Kolpackov <boris@codesynthesis.com> | 2020-02-04 09:01:36 +0200 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2020-02-04 09:01:36 +0200 |
commit | b9d38eadae2fd9d933abb20893d2a3f822b0210e (patch) | |
tree | a2aeb2fb3cc86f39a0007d187fed142ce637a5e1 /doc | |
parent | c68ec49334b072535d79dc52e0aafa05f0015cb8 (diff) |
Add note to manual on specifying search paths in compiler mode
Diffstat (limited to 'doc')
-rw-r--r-- | doc/manual.cli | 13 |
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, |