id,summary,reporter,owner,description,type,status,milestone,component,version,severity,resolution,keywords,cc
7533,Quickbook build fails without bjam --hash if filenames are too long,Paul A. Bristow,Vladimir Prus,"Quickbook documentation (usually when using both Doxygen and auto-indexing)can cause filenames to become too long so xsltproc fails to process correctly.

A sample of the format of an error message is shown below.

The issue can be triggered by deep nesting of folders, creating very long filename, and will often only occur when autoindex is added with --enable-index  (thereby increasing folder depth). The problem was very puzzling to diagnose because it occured with apparently identical files on different systems!  

The 'cure' is to use the undocumented bjam --hash option (which compresses the filename).

This ticket is to provide a record of this in Trac and to request that the --hash option be documented.  

Building the Odeint docs with automatic index generation enabled.
...patience...
...patience...
...found 1925 targets...
...updating 8 targets...
doxygen-action bin\msvc-10.0\debug\auto-index-internal-on\auto-index-verbose-on\auto-index-on\threading-multi\reference-xml.xml-dir

<snip>

finished...
xslt-xsltproc.windows bin\msvc-10.0\debug\auto-index-internal-on\auto-index-verbose-on\auto-index-on\threading-multi\reference-xml.doxygen
file:///I%3A/boost-sandbox/odeint-v2/libs/numeric/odeint/doc/bin/msvc-10.0/debug/auto-index-internal-on/auto-index-verbose-on/auto-index-on/threading-multi/reference-xml/index.xml:2067: parser error : Opening and ending tag mismatch: compound line 1792 and doxygenindex
</doxygenindex>
               ^
",Bugs,new,Boost 1.52.0,build,Boost 1.52.0,Optimization,,,