aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2020-02-04 09:03:01 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2020-02-04 09:03:01 +0200
commitf44fdc24c5b8d99a71ea8adaadb96af0d1162c92 (patch)
tree24fa2d56813fc161715862d057a55763b1ee6d73
parentf41dd568e79739365d4b9e4fe21c2dacb9733b89 (diff)
Add note to intro on specifying search paths in compiler mode
-rw-r--r--doc/intro.cli13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/intro.cli b/doc/intro.cli
index c703399..82c15a8 100644
--- a/doc/intro.cli
+++ b/doc/intro.cli
@@ -429,6 +429,19 @@ $ bdep init ... cc \
config.cxx=\"clang++ -m32 -stdlib=libc++\"
\
+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:
+
+\
+$ bdep init ... cc config.cxx=\"g++ -L/opt/install\"
+\
+
|
One difference you might have noticed when creating the \c{gcc} and \c{clang}