From b9d38eadae2fd9d933abb20893d2a3f822b0210e Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Tue, 4 Feb 2020 09:01:36 +0200 Subject: Add note to manual on specifying search paths in compiler mode --- doc/manual.cli | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'doc') 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, -- cgit v1.1