Boost logo

Boost-Commit :

Subject: [Boost-commit] svn:boost r68760 - in sandbox/tools/auto_index/doc: . html html/autoindex html/autoindex/tut html/autoindex/tut/configure html/index
From: john_at_[hidden]
Date: 2011-02-10 13:00:10


Author: johnmaddock
Date: 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
New Revision: 68760
URL: http://svn.boost.org/trac/boost/changeset/68760

Log:
Tweak formatting and commit missing HTML files.
Added:
   sandbox/tools/auto_index/doc/html/autoindex/index.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/
   sandbox/tools/auto_index/doc/html/autoindex/tut/add_indexes.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/build.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/build_docs.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/configure/
   sandbox/tools/auto_index/doc/html/autoindex/tut/configure.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/configure/optional.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/configure/options.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/entries.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/refine.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/tut/script.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/autoindex/workflow.html (contents, props changed)
   sandbox/tools/auto_index/doc/html/index/
   sandbox/tools/auto_index/doc/html/index/s08.html (contents, props changed)
Text files modified:
   sandbox/tools/auto_index/doc/auto_index.qbk | 34 ++++++++++++++--------------------
   sandbox/tools/auto_index/doc/html/autoindex/script_ref.html | 22 +++++++++++-----------
   sandbox/tools/auto_index/doc/html/autoindex/tut.html | 6 ------
   sandbox/tools/auto_index/doc/html/index.html | 28 ++++++++++++----------------
   4 files changed, 37 insertions(+), 53 deletions(-)

Modified: sandbox/tools/auto_index/doc/auto_index.qbk
==============================================================================
--- sandbox/tools/auto_index/doc/auto_index.qbk (original)
+++ sandbox/tools/auto_index/doc/auto_index.qbk 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -245,14 +245,14 @@
 [[<auto-index-prefix>filename][Optionally specifies a directory to apply
 as a prefix to all relative file paths in the script file.
 
-You may wish to do this to reduce typing of pathnames, and/or where the
+You may wish to do this to reduce typing of pathnames, and\/or where the
 paths can't be located relative to the script file location,
 typically if the headers are in the Boost trunk,
 but the script file is in Boost sandbox.
 
 For Boost standard library layout,
 [^<auto-index-prefix>..\/..\/..] will get you back up to the 'root' of the Boost tree,
-so !scan-path [~boost\/mylibrary/] is where your headers will be, and [~libs\/mylibrary] for other files.
+so [^!scan-path boost\/mylibrary\/] is where your headers will be, and [^libs\/mylibrary] for other files.
 Without a prefix all relative paths are relative to the location of the script file.
 ]]
 [[<auto-index-type>element-name][Specifies the name of the XML element to enclose internally generated indexes in:
@@ -497,14 +497,14 @@
 [caution The second ['file-name-regex] argument is a regular expression and not a filename GLOB!]
 
 [caution The scan-path is modified by any setting of <auto-index-prefix>.
-The examples here assume that this is [=<auto-index-prefix>../../..]
+The examples here assume that this is [^<auto-index-prefix>..\/..\/..]
 so that `boost/mylibrary` will be your header files,
 `libs/mylibrary/doc` will contain your documentation files and
 `libs/mylibrary/example` will contain your examples.
 ]
 
 You could also scan any examples (.cpp) files,
-typically in folder `\/mylibrary\/lib\/example`.
+typically in folder `/mylibrary/lib/example`.
 
 [pre
 # All example source files, assuming no sub-folders.
@@ -613,7 +613,12 @@
 Further rules can then be added to the script to handle these cases
 and the next iteration examined, and so on.
 
-[section:restrict Restricting which Sections are indexed for a particular term]
+[tip If you don't understand why a particular term is (or is not) present in the index,
+try adding a ['!debug regular-expression]
+directive to the [link autoindex.script_ref script file].
+] [/tip]
+
+[heading Restricting which Sections are indexed for a particular term]
 
 You can restrict which sections are indexed for a particular term.
 So assuming that the docbook document has the usual hierarchical names for section ID's
@@ -631,17 +636,6 @@
 This would avoid an index entry every time [deg] kelvin is found,
 something the user is unlikely to find helpful.
 
-[endsect] [/section:restrict Restricting which Sections are indexed for a particular term]
-
-[section:debug Why particular term is (or is not) present in the index]
-
-[tip If you don't understand why a particular term is (or is not) present in the index,
-try adding a ['!debug regular-expression]
-directive to the [link autoindex.script_ref script file].
-] [/tip]
-
-[endsect] [/section:debug Why particular term is (or is not) present in the index]
-
 [endsect] [/section:refine Step 7: Iterate - to refine your index]
 
 [endsect] [/section:tut Getting Started and Tutorial]
@@ -954,7 +948,7 @@
   then, if autoindex has been instructed to generate the index itself,
   it creates the necessary XML and inserts this into the __DOM.
 
-# Finally the whole DOM is written out as a new Docbook XML file,
+# Finally the whole __DOM is written out as a new Docbook XML file,
   and normal processing of this continues via the XSL stylesheets (with xsltproc)
   to actually build the final human-readable docs.
 
@@ -1004,10 +998,10 @@
 [section:index Index]
 [/Insert a single index of the documentation text.]
 
-[pre
+[endsect] [/section:index Index]
+
 '''
   <index/>
 '''
-]
 
-[endsect] [/section:index Index]
+

Added: sandbox/tools/auto_index/doc/html/autoindex/index.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/index.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,34 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Index</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../index.html" title="AutoIndex">
+<link rel="up" href="../index.html" title="AutoIndex">
+<link rel="prev" href="comm_ref.html" title="Command Line Reference">
+<link rel="next" href="../index/s08.html" title="Index">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="comm_ref.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="../index/s08.html"><img src="../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="autoindex.index"></a><a class="link" href="index.html" title="Index">Index</a>
+</h2></div></div></div></div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="comm_ref.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="../index/s08.html"><img src="../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/tools/auto_index/doc/html/autoindex/script_ref.html
==============================================================================
--- sandbox/tools/auto_index/doc/html/autoindex/script_ref.html (original)
+++ sandbox/tools/auto_index/doc/html/autoindex/script_ref.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -6,14 +6,14 @@
 <meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 <link rel="home" href="../index.html" title="AutoIndex">
 <link rel="up" href="../index.html" title="AutoIndex">
-<link rel="prev" href="tut/refine/debug.html" title="Why particular term is (or is not) present in the index">
+<link rel="prev" href="tut/refine.html" title="Step 7: Iterate - to refine your index">
 <link rel="next" href="workflow.html" title="Understanding The AutoIndex Workflow">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 <table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
 <hr>
 <div class="spirit-nav">
-<a accesskey="p" href="tut/refine/debug.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="workflow.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="tut/refine.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="workflow.html"><img src="../images/next.png" alt="Next"></a>
 </div>
 <div class="section" lang="en">
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
@@ -23,7 +23,7 @@
       The following elements can occur in a script:
     </p>
 <a name="autoindex.script_ref.comments_and_blank_lines"></a><h5>
-<a name="id871865"></a>
+<a name="id874974"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.comments_and_blank_lines">Comments and
       blank lines</a>
     </h5>
@@ -32,7 +32,7 @@
       comments onto the end of a line!).
     </p>
 <a name="autoindex.script_ref.inclusion_of_index_terms"></a><h5>
-<a name="id871888"></a>
+<a name="id874997"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.inclusion_of_index_terms">Inclusion of
       Index terms</a>
     </h5>
@@ -207,7 +207,7 @@
 </dl>
 </div>
 <a name="autoindex.script_ref.source_file_scanning"></a><h5>
-<a name="id872352"></a>
+<a name="id876008"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.source_file_scanning">Source File Scanning</a>
     </h5>
 <pre class="programlisting"><span class="special">!</span><span class="identifier">scan</span> <span class="identifier">source</span><span class="special">-</span><span class="identifier">file</span><span class="special">-</span><span class="identifier">name</span>
@@ -236,7 +236,7 @@
       </p></td></tr>
 </table></div>
 <a name="autoindex.script_ref.directory_and_source_file_scanning"></a><h5>
-<a name="id872429"></a>
+<a name="id876085"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.directory_and_source_file_scanning">Directory
       and Source File Scanning</a>
     </h5>
@@ -265,7 +265,7 @@
 </dl>
 </div>
 <a name="autoindex.script_ref.excluding_terms"></a><h5>
-<a name="id872554"></a>
+<a name="id876210"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.excluding_terms">Excluding Terms</a>
     </h5>
 <pre class="programlisting"><span class="special">!</span><span class="identifier">exclude</span> <span class="identifier">term</span><span class="special">-</span><span class="identifier">list</span>
@@ -278,7 +278,7 @@
       of things to index.
     </p>
 <a name="autoindex.script_ref.rewriting_section_names"></a><h5>
-<a name="id872609"></a>
+<a name="id876265"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.rewriting_section_names">Rewriting Section
       Names</a>
     </h5>
@@ -325,7 +325,7 @@
       all index entries - thus preventing lots of entries under "The" etc!
     </p>
 <a name="autoindex.script_ref.defining_or_changing_the_file_scanners"></a><h5>
-<a name="id872763"></a>
+<a name="id876418"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.defining_or_changing_the_file_scanners">Defining
       or Changing the File Scanners</a>
     </h5>
@@ -428,7 +428,7 @@
       scanner may find in the documentation.
     </p>
 <a name="autoindex.script_ref.debugging_scanning"></a><h5>
-<a name="id873953"></a>
+<a name="id876920"></a>
       <a class="link" href="script_ref.html#autoindex.script_ref.debugging_scanning">Debugging scanning</a>
     </h5>
 <p>
@@ -466,7 +466,7 @@
 </tr></table>
 <hr>
 <div class="spirit-nav">
-<a accesskey="p" href="tut/refine/debug.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="workflow.html"><img src="../images/next.png" alt="Next"></a>
+<a accesskey="p" href="tut/refine.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="workflow.html"><img src="../images/next.png" alt="Next"></a>
 </div>
 </body>
 </html>

Modified: sandbox/tools/auto_index/doc/html/autoindex/tut.html
==============================================================================
--- sandbox/tools/auto_index/doc/html/autoindex/tut.html (original)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -38,12 +38,6 @@
 <dt><span class="section">Step 6: Build the Docs</span></dt>
 <dt><span class="section"><a href="tut/refine.html">Step 7: Iterate - to refine your
       index</a></span></dt>
-<dd><dl>
-<dt><span class="section"><a href="tut/refine/restrict.html">Restricting which Sections
- are indexed for a particular term</a></span></dt>
-<dt><span class="section"><a href="tut/refine/debug.html">Why particular term is
- (or is not) present in the index</a></span></dt>
-</dl></dd>
 </dl></div>
 </div>
 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/add_indexes.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/add_indexes.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,168 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 3: Add indexes to your documentation</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="configure/optional.html" title="Making AutoIndex optional">
+<link rel="next" href="script.html" title="Step 4: Create the .idx script file - to control what to terms to index">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="configure/optional.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="script.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.add_indexes"></a><a class="link" href="add_indexes.html" title="Step 3: Add indexes to your documentation">Step 3: Add indexes to your
+ documentation</a>
+</h3></div></div></div>
+<p>
+ To add a single "include everything" index to a BoostBook/Docbook
+ document, (perhaps generated using Quickbook, and perhaps also using Doxygen
+ reference section), add <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">index</span><span class="special">/&gt;</span></code>
+ at the location where you want the index to appear. The index will be rendered
+ as a separate section called "Index" when the documentation is
+ built.
+ </p>
+<p>
+ To add multiple indexes, then give each one a title and set its <code class="computeroutput"><span class="identifier">type</span></code> attribute to specify which terms will
+ be included, for example to place the <span class="emphasis"><em>function</em></span>, <span class="emphasis"><em>class</em></span>,
+ <span class="emphasis"><em>macro</em></span> or <span class="emphasis"><em>typedef</em></span> names indexed
+ by <span class="emphasis"><em>auto_index</em></span> in separate indexes along with a main
+ "include everything" index as well, one could add:
+ </p>
+<pre class="programlisting">&lt;index type="class_name"&gt;
+&lt;title&gt;Class Index&lt;/title&gt;
+&lt;/index&gt;
+
+&lt;index type="typedef_name"&gt;
+&lt;title&gt;Typedef Index&lt;/title&gt;
+&lt;/index&gt;
+
+&lt;index type="function_name"&gt;
+&lt;title&gt;Function Index&lt;/title&gt;
+&lt;/index&gt;
+
+&lt;index type="macro_name"&gt;
+&lt;title&gt;Macro Index&lt;/title&gt;
+&lt;/index&gt;
+
+&lt;index/&gt;
+</pre>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ Multiple indexes like this only work correctly if you tell the XSL stylesheets
+ to honor the "type" attribute on each index as by default . You
+ can turn the feature on by adding <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">xsl</span><span class="special">:</span><span class="identifier">param</span><span class="special">&gt;</span><span class="identifier">index</span><span class="special">.</span><span class="identifier">on</span><span class="special">.</span><span class="identifier">type</span><span class="special">=</span><span class="number">1</span></code> to your
+ projects requirements in the Jamfile.
+ </p></td></tr>
+</table></div>
+<p>
+ In Quickbook, you add the same markup but enclose it between two triple-tick
+ ''' escapes, thus
+ </p>
+<pre class="programlisting">'''&lt;index/&gt;''' </pre>
+<p>
+ If you are writing a Quickbook document with Doxygen reference documentation,
+ the position of a <code class="computeroutput"><span class="special">[</span><span class="identifier">xinclude</span>
+ <span class="identifier">autodoc</span><span class="special">.</span><span class="identifier">xml</span><span class="special">]</span></code> line
+ in the Quickbook file determines the location of the Doxygen references section.
+ You will almost certainly want this as well.
+ </p>
+<pre class="programlisting">[xinclude autodoc.xml] # Using <span class="emphasis"><em>Doxygen reference documentation</em></span>.
+</pre>
+<p>
+ You can control the <span class="emphasis"><em>displayed name</em></span> of the Doxygen reference
+ section thus by adding to the end of the Doxygen autodoc section in your
+ jamfile.
+ </p>
+<pre class="programlisting">&lt;xsl:param&gt;"boost.doxygen.reftitle=Boost.mylibrary C++ Reference"
+</pre>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ AutoIndex knows nothing of the XML <code class="computeroutput"><span class="identifier">xinclude</span></code>
+ element, so if you're writing raw Docbook XML then you may want to run
+ this through an XSL processor to flatten everything to one XML file before
+ passing to AutoIndex. If you're using Boostbook or quickbook though, this
+ all happens for you anyway, and AutoIndex will index the whole document
+ including any sections included with <code class="computeroutput"><span class="identifier">xinclude</span></code>.
+ </p></td></tr>
+</table></div>
+<p>
+ If you are using auto-index's internal index generation on
+ </p>
+<pre class="programlisting">&lt;auto-index-internal&gt;on
+</pre>
+<p>
+ (usually recommended for HTML output, and not the default) then you can also
+ decide what kind of XML wrapper the generated index is placed in. By default
+ this is a <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">section</span><span class="special">&gt;...&lt;/</span><span class="identifier">section</span><span class="special">&gt;</span></code> XML block (this replaces the original
+ <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">index</span><span class="special">&gt;...&lt;/</span><span class="identifier">index</span><span class="special">&gt;</span></code> block). However, depending upon the structure
+ of the document and whether or not you want the index on a separate page
+ - or else on the front page after the TOC - you may want to place the index
+ inside a different type of XML block. For example if your document uses
+ <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">chapter</span><span class="special">&gt;</span></code> top level content rather than <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">section</span><span class="special">&gt;</span></code>s then it may be preferable to place the
+ index in a <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">chapter</span><span class="special">&gt;</span></code> or <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">appendix</span><span class="special">&gt;</span></code>
+ block. You can also place the index inside an <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">index</span><span class="special">&gt;</span></code>
+ block if you prefer, in which case the index does not appear in on a page
+ of its own, but after the TOC in the HTML output.
+ </p>
+<p>
+ You control the type of XML block used by setting the <code class="literal">&lt;auto-index-type&gt;element-name</code>
+ attribute in the Jamfile, or via the <code class="computeroutput"><span class="identifier">index</span><span class="special">-</span><span class="identifier">type</span><span class="special">=</span><span class="identifier">element</span><span class="special">-</span><span class="identifier">name</span></code> command line option to auto-index
+ itself. For example, to place the index in an appendix, your Jamfile might
+ look like:
+ </p>
+<pre class="programlisting">using quickbook ;
+using auto-index ;
+
+xml mylibrary : mylibary.qbk ;
+boostbook standalone
+ :
+ mylibrary
+ :
+ # auto-indexing is on:
+ &lt;auto-index&gt;on
+
+ # PDFs rely on the XSL stylesheets to generate the index:
+ &lt;format&gt;pdf:&lt;auto-index-internal&gt;off
+
+ # HTML output uses auto-index to generate the index:
+ &lt;format&gt;html:&lt;auto-index-internal&gt;on
+
+ # Name of script file to use:
+ &lt;auto-index-script&gt;index.idx
+
+ # Set the XML wrapper for HML Indexes to "appendix":
+ &lt;format&gt;html:&lt;auto-index-type&gt;appendix
+
+ # Turn on multiple index support:
+ &lt;xsl:param&gt;index.on.type=1
+</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="configure/optional.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="script.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/build.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/build.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,86 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 1: Build the AutoIndex tool</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="next" href="configure.html" title="Step 2: Configure Boost.Build jamfile to use AutoIndex">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tut.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="configure.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.build"></a><a class="link" href="build.html" title="Step 1: Build the AutoIndex tool">Step 1: Build the AutoIndex tool</a>
+</h3></div></div></div>
+<p>
+ cd into <code class="computeroutput"><span class="identifier">tools</span><span class="special">/</span><span class="identifier">auto_index</span><span class="special">/</span><span class="identifier">build</span></code> and invoke bjam as:
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="identifier">release</span>
+</pre>
+<p>
+ Optionally pass the name of the compiler toolset you want to use to bjam
+ as well:
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="identifier">release</span> <span class="identifier">gcc</span>
+</pre>
+<p>
+ Now open up your <code class="computeroutput"><span class="identifier">user</span><span class="special">-</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">jam</span></code> file and at the end of the file add
+ the line:
+ </p>
+<pre class="programlisting">using auto-index : <span class="emphasis"><em>full-path-of-executable-auto-index.exe</em></span> ;
+</pre>
+<div class="note"><table border="0" summary="Note">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../images/note.png"></td>
+<th align="left">Note</th>
+</tr>
+<tr><td align="left" valign="top">
+<p>
+ This declaration must go towards the end of <code class="computeroutput"><span class="identifier">user</span><span class="special">-</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">jam</span></code>,
+ or in any case after the Boostbook initialisation.
+ </p>
+<p>
+ Also note that Windows users must use forward slashes in the paths in
+ <code class="computeroutput"><span class="identifier">user</span><span class="special">-</span><span class="identifier">config</span><span class="special">.</span><span class="identifier">jam</span></code>
+ </p>
+</td></tr>
+</table></div>
+<p>
+ Finally note that <code class="computeroutput"><span class="identifier">tools</span><span class="special">/</span><span class="identifier">auto_index</span><span class="special">/</span><span class="keyword">auto</span><span class="special">-</span><span class="identifier">index</span><span class="special">.</span><span class="identifier">jam</span></code> gets
+ copied into the same directory as the rest of the Boost.Build tools (under
+ <code class="computeroutput"><span class="identifier">tools</span><span class="special">/</span><span class="identifier">build</span><span class="special">/</span><span class="identifier">v2</span><span class="special">/</span><span class="identifier">tools</span></code>
+ in your main Boost tree): this is a temporary fix that will go away if the
+ tool is accepted into Boost.
+ </p>
+<div class="caution"><table border="0" summary="Caution">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../images/caution.png"></td>
+<th align="left">Caution</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ If you move to a new machine you will need to do this! An error message
+ will warn about missing <code class="computeroutput"><span class="keyword">auto</span><span class="special">-</span><span class="identifier">index</span><span class="special">.</span><span class="identifier">jam</span></code>.
+ </p></td></tr>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../tut.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="configure.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/build_docs.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/build_docs.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,70 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 6: Build the Docs</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="entries.html" title="Step 5: Add Manual Index Entries to Docbook XML - Optional">
+<link rel="next" href="refine.html" title="Step 7: Iterate - to refine your index">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="entries.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="refine.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.build_docs"></a><a class="link" href="build_docs.html" title="Step 6: Build the Docs">Step 6: Build the Docs</a>
+</h3></div></div></div>
+<p>
+ Using Boost.Build you build the docs with either:
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="identifier">release</span> <span class="special">&gt;</span> <span class="identifier">mylibrary_html</span><span class="special">.</span><span class="identifier">log</span>
+</pre>
+<p>
+ To build the html docs or:
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="identifier">pdf</span> <span class="identifier">release</span> <span class="special">&gt;</span> <span class="identifier">mylibrary_pdf</span><span class="special">.</span><span class="identifier">log</span>
+</pre>
+<p>
+ To build the pdf.
+ </p>
+<p>
+ During the build process you should see AutoIndex emit a message in the log
+ file such as:
+ </p>
+<pre class="programlisting">Indexing 990 terms... </pre>
+<p>
+ If you don't see that, or if it's indexing 0 terms then something is wrong!
+ </p>
+<p>
+ Likewise when index generation is complete, AutoIndex will emit another message:
+ </p>
+<pre class="programlisting">38 Index entries were created.</pre>
+<p>
+ Again, if you see that 0 entries were created then something is wrong!
+ </p>
+<p>
+ Examine the log file, and if the cause is not obvious, make sure that you
+ have <code class="literal">&lt;auto-index-verbose&gt;on</code> and that any needed
+ <code class="literal">!debug regular-expression</code> directives are in your script
+ file.
+ </p>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="entries.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="refine.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/configure.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/configure.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,132 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 2: Configure Boost.Build jamfile to use AutoIndex</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="build.html" title="Step 1: Build the AutoIndex tool">
+<link rel="next" href="configure/options.html" title="Available Indexing Options">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="build.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="configure/options.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.configure"></a><a class="link" href="configure.html" title="Step 2: Configure Boost.Build jamfile to use AutoIndex">Step 2: Configure Boost.Build
+ jamfile to use AutoIndex</a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><span class="section"><a href="configure/options.html">Available Indexing
+ Options</a></span></dt>
+<dt><span class="section"><a href="configure/optional.html">Making AutoIndex
+ optional</a></span></dt>
+</dl></div>
+<p>
+ Assuming you have a Jamfile for building your documentation that looks something
+ like:
+ </p>
+<pre class="programlisting">boostbook standalone
+ :
+ mylibrary
+ :
+ # build requirements go here:
+ ;
+</pre>
+<p>
+ Then add the line:
+ </p>
+<pre class="programlisting">using auto-index ; </pre>
+<p>
+ to the start of the Jamfile, and then add whatever auto-index options you
+ want to the <span class="emphasis"><em>build requirements section</em></span>, for example:
+ </p>
+<pre class="programlisting">boostbook standalone
+ :
+ mylibrary
+ :
+ # Build requirements go here:
+
+ # &lt;auto-index&gt;on (or off) one turns on (or off) indexing:
+ &lt;auto-index&gt;on
+
+ # Turns on (or off) auto-index-verbose for diagnostic info.
+ # This is highly recommended until you have got all the many details correct!
+ &lt;auto-index-verbose&gt;on
+
+ # Choose the indexing method (separately for html and PDF) - see manual.
+ # Choose indexing method for PDFs:
+ &lt;format&gt;pdf:&lt;auto-index-internal&gt;off
+
+ # Choose indexing method for html:
+ &lt;format&gt;html:&lt;auto-index-internal&gt;on
+
+ # Set the name of the script file to use (index.idx is popular):
+ &lt;auto-index-script&gt;index.idx
+ # Commands in the script file should all use RELATIVE PATHS
+ # otherwise the script will not be portable to other machines.
+ # Relative paths are normally taken as relative to the location
+ # of the script file, but we can add a prefix to all
+ # those relative paths using the &lt;auto-index-prefix&gt; feature.
+ # The path specified by &lt;auto-index-prefix&gt; may be either relative or
+ # absolute, for example the following will get us up to the boost root
+ # directory for most Boost libraries:
+ &lt;auto-index-prefix&gt;../../..
+
+ # Tell Quickbook that it should enable indexing.
+ &lt;quickbook-define&gt; ;
+
+ ;
+</pre>
+<div class="tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ Always send the output to a log file. It will contain of lot of stuff,
+ but is invaluable to check if all has gone right, and else diagnose what
+ has gone wrong.
+ </p></td></tr>
+</table></div>
+<div class="tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ A return code of 0 is not a reliable indication that you have got what
+ you really want - inspecting the log file is the only certain way.
+ </p></td></tr>
+</table></div>
+<div class="tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ If you upgrade compiler version, for example MSVC from 9 to 10, then you
+ may need to rebuild Autoindex to avoid what Microsoft call a 'side-by-side'
+ error. And make sure that the autoindex.exe version you are using is the
+ new one.
+ </p></td></tr>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="build.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="configure/options.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/configure/optional.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/configure/optional.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,85 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Making AutoIndex optional</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../../index.html" title="AutoIndex">
+<link rel="up" href="../configure.html" title="Step 2: Configure Boost.Build jamfile to use AutoIndex">
+<link rel="prev" href="options.html" title="Available Indexing Options">
+<link rel="next" href="../add_indexes.html" title="Step 3: Add indexes to your documentation">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="options.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../configure.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="../add_indexes.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="autoindex.tut.configure.optional"></a><a class="link" href="optional.html" title="Making AutoIndex optional">Making AutoIndex
+ optional</a>
+</h4></div></div></div>
+<p>
+ It is considerate to make the <span class="bold"><strong>use of auto-index optional</strong></span>
+ in Boost.Build, to allow users who do not have AutoIndex installed to still
+ be able to build your documentation.
+ </p>
+<p>
+ This also very convenient while you are refining your documentation, to
+ allow you to decide to build indexes, or not: building indexes can take
+ long time, if you are just correcting typos, you won't want to wait while
+ you keep rebuilding the index!
+ </p>
+<p>
+ One method of setting up optional AutoIndex support is to place all AutoIndex
+ configuration in a the body of a bjam if statement:
+ </p>
+<pre class="programlisting">if --enable-index in [ modules.peek : ARGV ]
+ {
+ ECHO "Building the docs with automatic index generation enabled." ;
+
+ using auto-index ;
+ project : requirements
+ &lt;auto-index&gt;on
+ &lt;auto-index-script&gt;index.idx
+
+ ... other auto-index options here...
+ ;
+ }
+ else
+ {
+ ECHO "Building the my_library docs with automatic index generation disabled. To get an auto-index, try building with --enable-index." ;
+ }
+</pre>
+<p>
+ To use this, you need to cd to your docs folder, for example:
+ </p>
+<pre class="programlisting"><span class="identifier">cd</span> <span class="special">\</span><span class="identifier">boost</span><span class="special">-</span><span class="identifier">sandbox</span><span class="special">\</span><span class="identifier">guild</span><span class="special">\</span><span class="identifier">mylibrary</span><span class="special">\</span><span class="identifier">libs</span><span class="special">\</span><span class="identifier">mylibrary</span><span class="special">\</span><span class="identifier">doc</span>
+</pre>
+<p>
+ and then run <code class="computeroutput"><span class="identifier">bjam</span></code> to build
+ the docs without index, for example:
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="special">-</span><span class="identifier">a</span> <span class="identifier">html</span> <span class="special">&gt;</span> <span class="identifier">mylibrary_html</span><span class="special">.</span><span class="identifier">log</span>
+</pre>
+<p>
+ or with index(es)
+ </p>
+<pre class="programlisting"><span class="identifier">bjam</span> <span class="special">-</span><span class="identifier">a</span> <span class="identifier">html</span> <span class="special">--</span><span class="identifier">enable</span><span class="special">-</span><span class="identifier">index</span> <span class="special">&gt;</span> <span class="identifier">mylibrary_html_index</span><span class="special">.</span><span class="identifier">log</span>
+</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="options.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../configure.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="../add_indexes.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/configure/options.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/configure/options.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,265 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Available Indexing Options</title>
+<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../../index.html" title="AutoIndex">
+<link rel="up" href="../configure.html" title="Step 2: Configure Boost.Build jamfile to use AutoIndex">
+<link rel="prev" href="../configure.html" title="Step 2: Configure Boost.Build jamfile to use AutoIndex">
+<link rel="next" href="optional.html" title="Making AutoIndex optional">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../configure.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../configure.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="autoindex.tut.configure.options"></a><a class="link" href="options.html" title="Available Indexing Options">Available Indexing
+ Options</a>
+</h4></div></div></div>
+<p>
+ The available options are:
+ </p>
+<div class="variablelist">
+<p class="title"><b></b></p>
+<dl>
+<dt><span class="term">&lt;auto-index&gt;off/on</span></dt>
+<dd><p>
+ Turns indexing of the document on, defaults to "off", so
+ be sure to set this if you want AutoIndex invoked!
+ </p></dd>
+<dt><span class="term">&lt;auto-index-internal&gt;off/on</span></dt>
+<dd><p>
+ Chooses whether AutoIndex creates the index itself (feature on),
+ or whether it simply inserts the necessary DocBook markup so that
+ the DocBook XSL stylesheets can create the index. Defaults to "off".
+ </p></dd>
+<dt><span class="term">&lt;auto-index-script&gt;filename</span></dt>
+<dd><p>
+ Specifies the name of the script to load.
+ </p></dd>
+<dt><span class="term">&lt;auto-index-no-duplicates&gt;off/on</span></dt>
+<dd><p>
+ When <span class="emphasis"><em>on</em></span> AutoIndex will only index a term once
+ in any given section, otherwise (the default) multiple index entries
+ per term may be created if the term occurs more than once in the
+ section.
+ </p></dd>
+<dt><span class="term">&lt;auto-index-section-names&gt;off/on</span></dt>
+<dd><p>
+ When <span class="emphasis"><em>on</em></span> AutoIndex will use create two index
+ entries for each term found - one uses the term itself as the primary
+ index key, the other uses the enclosing section name. When off the
+ index entry that uses the section title is not created. Defaults
+ to "on"
+ </p></dd>
+<dt><span class="term">&lt;auto-index-verbose&gt;off/on</span></dt>
+<dd><p>
+ Defaults to "off". When turned on AutoIndex prints progress
+ information - useful for debugging purposes during setup.
+ </p></dd>
+<dt><span class="term">&lt;auto-index-prefix&gt;filename</span></dt>
+<dd>
+<p>
+ Optionally specifies a directory to apply as a prefix to all relative
+ file paths in the script file.
+ </p>
+<p>
+ You may wish to do this to reduce typing of pathnames, and/or where
+ the paths can't be located relative to the script file location,
+ typically if the headers are in the Boost trunk, but the script file
+ is in Boost sandbox.
+ </p>
+<p>
+ For Boost standard library layout, <code class="literal">&lt;auto-index-prefix&gt;../../..</code>
+ will get you back up to the 'root' of the Boost tree, so <code class="literal">!scan-path
+ boost/mylibrary/</code> is where your headers will be, and <code class="literal">libs/mylibrary</code>
+ for other files. Without a prefix all relative paths are relative
+ to the location of the script file.
+ </p>
+</dd>
+<dt><span class="term">&lt;auto-index-type&gt;element-name</span></dt>
+<dd><p>
+ Specifies the name of the XML element to enclose internally generated
+ indexes in: defaults to <span class="emphasis"><em>section</em></span>, but could equally
+ be <span class="emphasis"><em>appendix</em></span> or <span class="emphasis"><em>chapter</em></span>
+ or some other block level element that has a formal title. The actual
+ list of available options depends upon the document type, the following
+ table gives the available options:
+ </p></dd>
+</dl>
+</div>
+<div class="informaltable"><table class="table">
+<colgroup>
+<col>
+<col>
+</colgroup>
+<thead><tr>
+<th>
+ <p>
+ Document Type
+ </p>
+ </th>
+<th>
+ <p>
+ Available Index Types
+ </p>
+ </th>
+</tr></thead>
+<tbody>
+<tr>
+<td>
+ <p>
+ book
+ </p>
+ </td>
+<td>
+ <p>
+ appendix index article chapter reference part
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ article
+ </p>
+ </td>
+<td>
+ <p>
+ section appendix index sect1
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ library
+ </p>
+ </td>
+<td>
+ <p>
+ See Chapter
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ chapter
+ </p>
+ </td>
+<td>
+ <p>
+ section index sect1
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ part
+ </p>
+ </td>
+<td>
+ <p>
+ appendix index article chapter reference
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ appendix
+ </p>
+ </td>
+<td>
+ <p>
+ section index sect1
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ preface
+ </p>
+ </td>
+<td>
+ <p>
+ section index sect1
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ qandadiv
+ </p>
+ </td>
+<td>
+ <p>
+ N/A: an index would have to be placed within a subsection of
+ the document.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ qandaset
+ </p>
+ </td>
+<td>
+ <p>
+ N/A: an index would have to be placed within a subsection of
+ the document.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ reference
+ </p>
+ </td>
+<td>
+ <p>
+ N/A: an index would have to be placed within a subsection of
+ the document.
+ </p>
+ </td>
+</tr>
+<tr>
+<td>
+ <p>
+ set
+ </p>
+ </td>
+<td>
+ <p>
+ N/A: an index would have to be placed within a subsection of
+ the document.
+ </p>
+ </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../configure.html"><img src="../../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../configure.html"><img src="../../../images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../images/home.png" alt="Home"></a><a accesskey="n" href="optional.html"><img src="../../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/entries.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/entries.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,51 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 5: Add Manual Index Entries to Docbook XML - Optional</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="script.html" title="Step 4: Create the .idx script file - to control what to terms to index">
+<link rel="next" href="build_docs.html" title="Step 6: Build the Docs">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="script.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="build_docs.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.entries"></a><a class="link" href="entries.html" title="Step 5: Add Manual Index Entries to Docbook XML - Optional">Step 5: Add Manual Index Entries
+ to Docbook XML - Optional</a>
+</h3></div></div></div>
+<p>
+ If you add manual <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">indexentry</span><span class="special">&gt;</span></code> markup to your Docbook XML then these
+ will be passed through unchanged. Please note however, that if you are using
+ AutoIndex's internal index generation then it only recognises <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">primary</span><span class="special">&gt;</span></code> and <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">secondary</span><span class="special">&gt;</span></code>
+ elements within the <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">indexterm</span><span class="special">&gt;</span></code>. <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">tertiary</span><span class="special">&gt;</span></code>,
+ <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">see</span><span class="special">&gt;</span></code> and <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">seealso</span><span class="special">&gt;</span></code>
+ elements are not currently recognised and auto-index will emit a warning
+ if these are used.
+ </p>
+<p>
+ Likewise none of the attributes which can be applied to these elements are
+ used when AutoIndex generates the index itself, with the exception of the
+ <code class="computeroutput"><span class="special">&lt;</span><span class="identifier">type</span><span class="special">&gt;</span></code> attribute.
+ </p>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="script.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="build_docs.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/refine.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/refine.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,93 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 7: Iterate - to refine your index</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="build_docs.html" title="Step 6: Build the Docs">
+<link rel="next" href="../script_ref.html" title="Script File (.idx) Reference">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="build_docs.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../script_ref.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.refine"></a><a class="link" href="refine.html" title="Step 7: Iterate - to refine your index">Step 7: Iterate - to refine your
+ index</a>
+</h3></div></div></div>
+<p>
+ Creating a good index is an iterative process, often the first step is just
+ to add a header scanning rule to the script file and then generate the documentation
+ and see:
+ </p>
+<div class="itemizedlist"><ul type="disc">
+<li>
+ What's missing.
+ </li>
+<li>
+ What's been included that shouldn't be.
+ </li>
+<li>
+ What's been included under a poor name.
+ </li>
+</ul></div>
+<p>
+ Further rules can then be added to the script to handle these cases and the
+ next iteration examined, and so on.
+ </p>
+<div class="tip"><table border="0" summary="Tip">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../images/tip.png"></td>
+<th align="left">Tip</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ If you don't understand why a particular term is (or is not) present in
+ the index, try adding a <span class="emphasis"><em>!debug regular-expression</em></span>
+ directive to the <a class="link" href="../script_ref.html" title="Script File (.idx) Reference">script file</a>.
+ </p></td></tr>
+</table></div>
+<a name="autoindex.tut.refine.restricting_which_sections_are_indexed_for_a_particular_term"></a><h5>
+<a name="id874913"></a>
+ <a class="link" href="refine.html#autoindex.tut.refine.restricting_which_sections_are_indexed_for_a_particular_term">Restricting
+ which Sections are indexed for a particular term</a>
+ </h5>
+<p>
+ You can restrict which sections are indexed for a particular term. So assuming
+ that the docbook document has the usual hierarchical names for section ID's
+ hierarchical names for section IDs(as Quickbook generates, for example),
+ you can easily place a constraint on which sections are examined for a particular
+ term.
+ </p>
+<p>
+ For example, if you want to index occurrences of Lord Kelvin's name, but
+ only in the introduction section, you might then add:
+ </p>
+<pre class="programlisting"><span class="identifier">Kelvin</span> <span class="string">""</span> <span class="string">".*introduction.*"</span>
+</pre>
+<p>
+ to the script file, assuming that the section ID of the intro is "some_library_or_chapter_name.introduction".
+ </p>
+<p>
+ This would avoid an index entry every time &#176; kelvin is found, something the
+ user is unlikely to find helpful.
+ </p>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="build_docs.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="../script_ref.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/tut/script.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/tut/script.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,153 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Step 4: Create the .idx script file - to control what to terms to index</title>
+<link rel="stylesheet" href="../../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../../index.html" title="AutoIndex">
+<link rel="up" href="../tut.html" title="Getting Started and Tutorial">
+<link rel="prev" href="add_indexes.html" title="Step 3: Add indexes to your documentation">
+<link rel="next" href="entries.html" title="Step 5: Add Manual Index Entries to Docbook XML - Optional">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="add_indexes.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="entries.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="autoindex.tut.script"></a><a class="link" href="script.html" title="Step 4: Create the .idx script file - to control what to terms to index">Step 4: Create the .idx script
+ file - to control what to terms to index</a>
+</h3></div></div></div>
+<p>
+ AutoIndex works by reading a script file that tells it what terms to index.
+ </p>
+<p>
+ If your document contains largely text, and only a small amount of simple
+ C++, and/or if you are using Doxygen to provide a C++ Reference section (that
+ lists the C++ elements), and/or if you are relying on the indexing provided
+ from a Standalone Doxygen Index, you may decide that a index is not needed
+ and that you may only want the text part indexed.
+ </p>
+<p>
+ But if you want C++ classes functions, typedefs and/or macros AutoIndexed,
+ optionally, the script file also tells which other C++ files to scan.
+ </p>
+<p>
+ At its simplest, it will scan one or more headers for terms that should be
+ indexed in the documentation. So for example to scan "myheader.hpp"
+ the script file would just contain:
+ </p>
+<pre class="programlisting"><span class="special">!</span><span class="identifier">scan</span> <span class="identifier">myheader</span><span class="special">.</span><span class="identifier">hpp</span>
+<span class="special">!</span><span class="identifier">scan</span> <span class="identifier">mydetailsheader</span><span class="special">.</span><span class="identifier">hpp</span>
+</pre>
+<p>
+ Or, more likely in practice, so we can recursively scan through directories
+ looking for all the files to scan whose <span class="bold"><strong>name matches
+ a particular regular expression</strong></span>:
+ </p>
+<pre class="programlisting">!scan-path "boost/mylibrary" ".*.hpp" true </pre>
+<p>
+ Each argument is whitespace separated and can be optionally enclosed in "double
+ quotes" (recommended).
+ </p>
+<p>
+ The final <span class="emphasis"><em>true</em></span> argument indicates that subdirectories
+ in <code class="computeroutput"><span class="special">/</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">math</span><span class="special">/</span><span class="identifier">mylibrary</span></code> should be searched recursively
+ in addition to that directory.
+ </p>
+<div class="caution"><table border="0" summary="Caution">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../images/caution.png"></td>
+<th align="left">Caution</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ The second <span class="emphasis"><em>file-name-regex</em></span> argument is a regular expression
+ and not a filename GLOB!
+ </p></td></tr>
+</table></div>
+<div class="caution"><table border="0" summary="Caution">
+<tr>
+<td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../images/caution.png"></td>
+<th align="left">Caution</th>
+</tr>
+<tr><td align="left" valign="top"><p>
+ The scan-path is modified by any setting of &lt;auto-index-prefix&gt;.
+ The examples here assume that this is <code class="literal">&lt;auto-index-prefix&gt;../../..</code>
+ so that <code class="computeroutput"><span class="identifier">boost</span><span class="special">/</span><span class="identifier">mylibrary</span></code> will be your header files,
+ <code class="computeroutput"><span class="identifier">libs</span><span class="special">/</span><span class="identifier">mylibrary</span><span class="special">/</span><span class="identifier">doc</span></code> will contain your documentation files
+ and <code class="computeroutput"><span class="identifier">libs</span><span class="special">/</span><span class="identifier">mylibrary</span><span class="special">/</span><span class="identifier">example</span></code> will contain your examples.
+ </p></td></tr>
+</table></div>
+<p>
+ You could also scan any examples (.cpp) files, typically in folder <code class="computeroutput"><span class="special">/</span><span class="identifier">mylibrary</span><span class="special">/</span><span class="identifier">lib</span><span class="special">/</span><span class="identifier">example</span></code>.
+ </p>
+<pre class="programlisting"># All example source files, assuming no sub-folders.
+!scan-path "libs/mylibrary/example" ".*\.cpp"
+</pre>
+<p>
+ Often the <span class="emphasis"><em>scan</em></span> or <span class="emphasis"><em>scan-path</em></span> rules
+ will bring in too many terms to search for, so we need to be able to exclude
+ terms as well:
+ </p>
+<pre class="programlisting"><span class="special">!</span><span class="identifier">exclude</span> <span class="identifier">type</span>
+</pre>
+<p>
+ Which excludes the term "type" from being indexed.
+ </p>
+<p>
+ We can also add terms manually:
+ </p>
+<pre class="programlisting"><span class="identifier">foobar</span>
+</pre>
+<p>
+ will index occurrences of "foobar" and:
+ </p>
+<pre class="programlisting"><span class="identifier">foobar</span> <span class="special">\&lt;\</span><span class="identifier">w</span><span class="special">*(</span><span class="identifier">foo</span><span class="special">|</span><span class="identifier">bar</span><span class="special">)\</span><span class="identifier">w</span><span class="special">*\&gt;</span>
+</pre>
+<p>
+ will index any whole word containing either "foo" or "bar"
+ within it, this is useful when you want to index a lot of similar or related
+ words under one entry, for example:
+ </p>
+<pre class="programlisting"><span class="identifier">reflex</span>
+</pre>
+<p>
+ Will only index occurrences of "reflex" as a whole word, but:
+ </p>
+<pre class="programlisting"><span class="identifier">reflex</span> <span class="special">\&lt;</span><span class="identifier">reflex</span><span class="special">\</span><span class="identifier">w</span><span class="special">*\&gt;</span>
+</pre>
+<p>
+ will index occurrences of "reflex", "reflexing" and "reflexed"
+ all under the same entry <span class="emphasis"><em>reflex</em></span>. You will very often
+ need to use this to deal with plurals and other variants.
+ </p>
+<p>
+ This inclusion rule can also restrict the term to certain sections, and add
+ an index category that the term should belong to (so it only appears in certain
+ indexes).
+ </p>
+<p>
+ Finally the script can add rewrite rules, that rename section names that
+ are automatically used as index entries. For example we might want to remove
+ leading "A" or "The" prefixes from section titles when
+ AutoIndex uses them as an index entry:
+ </p>
+<pre class="programlisting"><span class="special">!</span><span class="identifier">rewrite</span><span class="special">-</span><span class="identifier">name</span> <span class="string">"(?i)(?:A|The)\s+(.*)"</span> <span class="string">"\1"</span>
+</pre>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="add_indexes.html"><img src="../../images/prev.png" alt="Prev"></a><a accesskey="u" href="../tut.html"><img src="../../images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../images/home.png" alt="Home"></a><a accesskey="n" href="entries.html"><img src="../../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/tools/auto_index/doc/html/autoindex/workflow.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/autoindex/workflow.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,79 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Understanding The AutoIndex Workflow</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../index.html" title="AutoIndex">
+<link rel="up" href="../index.html" title="AutoIndex">
+<link rel="prev" href="script_ref.html" title="Script File (.idx) Reference">
+<link rel="next" href="xml.html" title="XML Handling">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="script_ref.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="xml.html"><img src="../images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="autoindex.workflow"></a><a class="link" href="workflow.html" title="Understanding The AutoIndex Workflow">Understanding The AutoIndex Workflow</a>
+</h2></div></div></div>
+<div class="orderedlist"><ol type="1">
+<li>
+ Load the script file (usually index.idx) and process it one line at a time,
+ producing one or more index term per (non-comment) line.
+ </li>
+<li>
+ Reading all lines builds a list of <span class="emphasis"><em>terms to index</em></span>.
+ Some of those may be terms defined (by you) directly in the script file,
+ others may be terms found by scanning C++ header and source files that
+ were specified by the <span class="emphasis"><em>!scan-path</em></span> directive.
+ </li>
+<li>
+ Once the complete list of <span class="emphasis"><em>terms to index</em></span> is complete,
+ it loads the Docbook XML file. (If this comes from Quickbook/Doxygen/Boostbook/Docbook
+ then this is the complete documentation after conversion to Docbook format).
+ </li>
+<li>
+ AutoIndex builds an internal __DOM of the Docbook XML. This internal representation
+ then gets scanned for occurrences of the <span class="emphasis"><em>terms to index</em></span>.
+ This scanning works at the XML paragraph level (or equivalent sibling such
+ as a table or code block) - so all the XML encoding within a paragraph
+ gets flattened to plain text.<br> This flattening means the regular expressions
+ used to search for <span class="emphasis"><em>terms to index</em></span> can find anything
+ that is completely contained within a paragraph (or code block etc).
+ </li>
+<li>
+ For each term found then an <span class="emphasis"><em>indexterm</em></span> Docbook element
+ is inserted into the __DOM (provided internal index generation is off),
+ </li>
+<li>
+ Also the AutoIndex's internal index representation gets updated.
+ </li>
+<li>
+ Once the whole XML document has been indexed, then, if autoindex has been
+ instructed to generate the index itself, it creates the necessary XML and
+ inserts this into the __DOM.
+ </li>
+<li>
+ Finally the whole __DOM is written out as a new Docbook XML file, and normal
+ processing of this continues via the XSL stylesheets (with xsltproc) to
+ actually build the final human-readable docs.
+ </li>
+</ol></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="script_ref.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a><a accesskey="n" href="xml.html"><img src="../images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/tools/auto_index/doc/html/index.html
==============================================================================
--- sandbox/tools/auto_index/doc/html/index.html (original)
+++ sandbox/tools/auto_index/doc/html/index.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -21,7 +21,7 @@
 </h3></div></div></div>
 <div><p class="copyright">Copyright &#169; 2008 , 2011 John Maddock</p></div>
 <div><div class="legalnotice">
-<a name="id858267"></a><p>
+<a name="id864897"></a><p>
         Distributed under the Boost Software License, Version 1.0. (See accompanying
         file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
       </p>
@@ -39,36 +39,32 @@
 <dt><span class="section"><a href="autoindex/tut/configure.html">Step 2: Configure Boost.Build
       jamfile to use AutoIndex</a></span></dt>
 <dd><dl>
-<dt><span class="section">Available options</span></dt>
-<dt><span class="section"><a href="autoindex/tut/configure/optional.html">Making AuotIndex
+<dt><span class="section"><a href="autoindex/tut/configure/options.html">Available Indexing
+ Options</a></span></dt>
+<dt><span class="section"><a href="autoindex/tut/configure/optional.html">Making AutoIndex
         optional</a></span></dt>
 </dl></dd>
 <dt><span class="section"><a href="autoindex/tut/add_indexes.html">Step 3: Add indexes to your
       documentation</a></span></dt>
-<dt><span class="section"><a href="autoindex/tut/script.html">Step 4: Create the script file
- - to control what to terms to index</a></span></dt>
+<dt><span class="section"><a href="autoindex/tut/script.html">Step 4: Create the .idx script
+ file - to control what to terms to index</a></span></dt>
 <dt><span class="section"><a href="autoindex/tut/entries.html">Step 5: Add Manual Index Entries
       to Docbook XML - Optional</a></span></dt>
 <dt><span class="section">Step 6: Build the Docs</span></dt>
 <dt><span class="section"><a href="autoindex/tut/refine.html">Step 7: Iterate - to refine your
       index</a></span></dt>
-<dd><dl>
-<dt><span class="section"><a href="autoindex/tut/refine/restrict.html">Restricting which Sections
- are indexed for a particular term</a></span></dt>
-<dt><span class="section"><a href="autoindex/tut/refine/debug.html">Why particular term is
- (or is not) present in the index</a></span></dt>
-</dl></dd>
 </dl></dd>
-<dt><span class="section">AutoIndex Workflow</span></dt>
-<dt><span class="section">Script File Reference</span></dt>
-<dt><span class="section">How XML is searched for index terms</span></dt>
+<dt><span class="section">Script File (.idx) Reference</span></dt>
+<dt><span class="section">Understanding The AutoIndex Workflow</span></dt>
+<dt><span class="section">XML Handling</span></dt>
 <dt><span class="section">Command Line Reference</span></dt>
-<dt><span class="section">Index</span></dt>
+<dt><span class="section">Index</span></dt>
+<dt><span class="section">Index</span></dt>
 </dl>
 </div>
 </div>
 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left"><p><small>Last revised: February 04, 2011 at 11:22:23 GMT</small></p></td>
+<td align="left"><p><small>Last revised: February 10, 2011 at 17:40:50 GMT</small></p></td>
 <td align="right"><div class="copyright-footer"></div></td>
 </tr></table>
 <hr>

Added: sandbox/tools/auto_index/doc/html/index/s08.html
==============================================================================
--- (empty file)
+++ sandbox/tools/auto_index/doc/html/index/s08.html 2011-02-10 13:00:07 EST (Thu, 10 Feb 2011)
@@ -0,0 +1,36 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
+<title>Index</title>
+<link rel="stylesheet" href="../boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
+<link rel="home" href="../index.html" title="AutoIndex">
+<link rel="up" href="../index.html" title="AutoIndex">
+<link rel="prev" href="../autoindex/index.html" title="Index">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr><td valign="top"></td></tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../autoindex/index.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h2 class="title" style="clear: both">
+<a name="id877294"></a>Index</h2></div></div></div>
+<p></p>
+<div class="variablelist"><dl></dl></div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright &#169; 2008 , 2011 John Maddock<p>
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ </p>
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="../autoindex/index.html"><img src="../images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../images/home.png" alt="Home"></a>
+</div>
+</body>
+</html>


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk