diff --git a/doc/src/reference.xml b/doc/src/reference.xml
index 17746c3fd..3dc7e6a05 100644
--- a/doc/src/reference.xml
+++ b/doc/src/reference.xml
@@ -2023,7 +2023,46 @@ exe a : a.cpp
-
+
+
+
+ Target Paths
+
+ Several factors determine the location of a concrete
+ file target. All files in a project are built under
+ the directory bin unless this is overriden by the build-dir project
+ attribute. Under bin is a path that depends on the properties
+ used to build each target. This path is uniquely determined by
+ all non-free, non-incidental properties. For example,
+ given a property set containing:
+ <toolset>gcc <toolset-gcc:version>4.6.1 <variant>debug
+ <warnings>all <define>_DEBUG <include>/usr/local/include
+ <link>static,
+ the path will be gcc-4.6.1/debug/link-static. <warnings> is an
+ incidental feature and <define> and <include> are
+ free features, so they do not affect the path.
+
+ Sometimes the paths produced by Boost.Build can become excessively
+ long. There are a couple of command line options that can help with this.
+ --abbreviate-paths reduces each element to no more than five characters.
+ For example, link-static becomes lnk-sttc. The --hash option reduces the
+ path to a single directory using an MD5 hash.
+
+ There are two features that affect the build
+ directory. The <location> feature completely
+ overrides the default build directory. For example,
+ exe a : a.cpp : <location>. ;
+ builds all the files produced by a
+ in the directory of the Jamfile. This is generally
+ discouraged, as it precludes variant builds.
+
+ The <location-prefix> feature adds a
+ prefix to the path, under the project's build
+ directory. For example,
+ exe a : a.cpp : <location-prefix>subdir ;
+ will create the files for a in bin/subdir/gcc-4.6.1/debug
+
+
@@ -2125,7 +2164,7 @@ exe a : a.cpp
Non-incidental features are assumed to affect build
products, so the files for targets whose build specification
differs in non-incidental features are placed in different
- directories as described in "target paths" below. [ where? ]
+ directories as described in .