From f0aa9287831b65542246795e80b4cbb3fa0b4a44 Mon Sep 17 00:00:00 2001
From: Steven Watanabe <steven@providere-consulting.com>
Date: Fri, 19 Oct 2012 17:30:02 +0000
Subject: [PATCH] Add documentation of --hash and --abbreviate-paths in the
 list of options.  Also add an index entry for Target Paths.  Refs #7533.

[SVN r81016]
---
 v2/doc/src/overview.xml  | 22 ++++++++++++++++++++++
 v2/doc/src/path.xml      |  1 +
 v2/doc/src/reference.xml |  1 +
 3 files changed, 24 insertions(+)

diff --git a/v2/doc/src/overview.xml b/v2/doc/src/overview.xml
index 66ab027ec..d0b3c193f 100644
--- a/v2/doc/src/overview.xml
+++ b/v2/doc/src/overview.xml
@@ -687,6 +687,28 @@ b2 toolset=gcc variant=debug optimization=space
             </listitem>
           </varlistentry>
 
+          <varlistentry>
+            <term><option>--abbreviate-paths</option></term>
+            <listitem>
+              <para>Compresses target paths by abbreviating each component.
+              This option is useful to keep paths from becoming longer than
+              the filesystem supports.  See also <xref linkend="bbv2.reference.buildprocess.targetpath"/>.
+              </para>
+            </listitem>
+          </varlistentry>
+
+          <varlistentry>
+            <term><option>--hash</option></term>
+            <listitem>
+              <para>Compresses target paths using an MD5 hash.  This option is
+              useful to keep paths from becoming longer than the filesystem
+              supports.  This option produces shorter paths than --abbreviate-paths
+              does, but at the cost of making them less understandable.
+              See also <xref linkend="bbv2.reference.buildprocess.targetpath"/>.
+              </para>
+            </listitem>
+          </varlistentry>
+
           <varlistentry>
             <term><option>--version</option></term>
             <listitem>
diff --git a/v2/doc/src/path.xml b/v2/doc/src/path.xml
index 31f47a8dc..f11906db5 100644
--- a/v2/doc/src/path.xml
+++ b/v2/doc/src/path.xml
@@ -7,6 +7,7 @@
   <title>path</title>
   <indexterm>
     <primary>path</primary>
+    <secondary>module</secondary>
   </indexterm>
 
   <para>
diff --git a/v2/doc/src/reference.xml b/v2/doc/src/reference.xml
index deee17c98..6316f09db 100644
--- a/v2/doc/src/reference.xml
+++ b/v2/doc/src/reference.xml
@@ -2089,6 +2089,7 @@ exe a : a.cpp
     
     <section id="bbv2.reference.buildprocess.targetpath">
       <title>Target Paths</title>
+      <indexterm><primary>path</primary><secondary>for targets</secondary></indexterm>
 
       <para>Several factors determine the location of a concrete
       file target.  All files in a project are built under