From 80ef5875a09c8df302b3b2f840113144c5de0b2e Mon Sep 17 00:00:00 2001
From: Steven Knight <knight@baldmt.com>
Date: Sun, 10 Feb 2002 16:37:58 +0000
Subject: Document the LIBPATH construction variable.

---
 doc/man/scons.1 | 25 +++++++++++++++++++++++++
 src/CHANGES.txt |  3 +++
 2 files changed, 28 insertions(+)

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index 7595724..a50d7b5 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -844,6 +844,31 @@ The prefix used to specify a library to link on the linker command line.
 .IP LIBLINKSUFFIX
 The suffix used to specify a library to link on the linker command line.
 
+.IP LIBPATH
+The list of directories that will be searched for libraries.
+The implicit dependency scanner will search these
+directories for include files. Don't explicitly put include directory
+arguments in LINKFLAGS because the result will be non-portable
+and the directories will not be searched by the dependency scanner. Note:
+directory names in LIBPATH will be looked-up relative to the SConscript
+directory when they are used in a command. To force 
+.B scons
+to look-up a directory relative to the root of the source tree use #:
+
+.ES
+env = Environment(LIBPATH='#/libs')
+.EE
+
+.IP
+The directory look-up can also be forced using the 
+.BR Dir ()
+function:
+
+.ES
+libs = Dir('libs')
+env = Environment(LIBPATH=libs)
+.EE
+
 .IP LIBPREFIX
 The prefix used for library file names.
 
diff --git a/src/CHANGES.txt b/src/CHANGES.txt
index e77074a..ae2f487 100644
--- a/src/CHANGES.txt
+++ b/src/CHANGES.txt
@@ -53,6 +53,9 @@ RELEASE 0.05 -
   - Allow the list of variables exported to an SConscript file to be
     a UserList, too.
 
+  - Document the overlooked LIBPATH construction variable.
+    (Bug reported by Eicke Godehardt.)
+
   From Anthony Roach:
 
   - Make the scons script return an error code on failures.
-- 
cgit v0.12