Opened 10 years ago
Last modified 10 years ago
#7533 new Bugs
Quickbook build fails without bjam --hash if filenames are too long
| Reported by: | Paul A. Bristow | Owned by: | Vladimir Prus |
|---|---|---|---|
| Milestone: | Boost 1.52.0 | Component: | build |
| Version: | Boost 1.52.0 | Severity: | Optimization |
| Keywords: | Cc: |
Description
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>
(In [81016]) Add documentation of --hash and --abbreviate-paths in the list of options. Also add an index entry for Target Paths. Refs #7533.