Boost C++ Libraries: Ticket #7533: Quickbook build fails without bjam --hash if filenames are too long https://svn.boost.org/trac10/ticket/7533 <p> Quickbook documentation (usually when using both Doxygen and auto-indexing)can cause filenames to become too long so xsltproc fails to process correctly. </p> <p> A sample of the format of an error message is shown below. </p> <p> 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! </p> <p> The 'cure' is to use the undocumented bjam --hash option (which compresses the filename). </p> <p> This ticket is to provide a record of this in Trac and to request that the --hash option be documented. </p> <p> 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 </p> <p> &lt;snip&gt; </p> <p> 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 <a class="ext-link" href="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"><span class="icon">​</span>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</a>: parser error : Opening and ending tag mismatch: compound line 1792 and doxygenindex &lt;/doxygenindex&gt; </p> <blockquote> <p> <sup> </sup></p> </blockquote> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/7533 Trac 1.4.3 Steven Watanabe Fri, 19 Oct 2012 17:30:05 GMT <link>https://svn.boost.org/trac10/ticket/7533#comment:1 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7533#comment:1</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/81016" title="Add documentation of --hash and --abbreviate-paths in the list of ...">[81016]</a>) Add documentation of --hash and --abbreviate-paths in the list of options. Also add an index entry for Target Paths. Refs <a class="new ticket" href="https://svn.boost.org/trac10/ticket/7533" title="#7533: Bugs: Quickbook build fails without bjam --hash if filenames are too long (new)">#7533</a>. </p> </description> <category>Ticket</category> </item> <item> <dc:creator>Steven Watanabe</dc:creator> <pubDate>Fri, 19 Oct 2012 17:44:16 GMT</pubDate> <title/> <link>https://svn.boost.org/trac10/ticket/7533#comment:2 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/7533#comment:2</guid> <description> <p> (In <a class="changeset" href="https://svn.boost.org/trac10/changeset/81017" title="Add documentation of --hash to b2 --help-options. Refs #7533.">[81017]</a>) Add documentation of --hash to b2 --help-options. Refs <a class="new ticket" href="https://svn.boost.org/trac10/ticket/7533" title="#7533: Bugs: Quickbook build fails without bjam --hash if filenames are too long (new)">#7533</a>. </p> </description> <category>Ticket</category> </item> </channel> </rss>