Re: [Boost-docs] Failure to Build quickbook docs when indexing isenabled

Subject: Re: [Boost-docs] Failure to Build quickbook docs when indexing isenabled
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-09-21 08:37:46

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of
> John Maddock
> Sent: Wednesday, September 21, 2011 9:19 AM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Failure to Build quickbook docs when indexing isenabled
> 
> > It builds OK without --enable-index in the bjam command.
> >
> > The error reported is
> >
> > xslt-xsltproc.windows
> > bin\msvc-10.0\debug\auto-index-internal-on\auto-index-verbose-on\auto-
> > index-on\threading-multi\autod
> > oc-xml.doxygen
> > file:///I%3A/boost-sandbox/endian_2/libs/endian/doc/bin/msvc-10.0/debu
> > g/auto-index-internal-on/auto-
> > index-verbose-on/auto-index-on/threading-multi/autodoc-xml/index.xml:150:
> > parser error : Opening and
> > ending tag mismatch: compound line 24 and doxygenindex
> >
> > ...
> > </doxygenindex>
> >
> > John has pointed out that this can't be the autoindex program itself
> > because this isn't run yet.
> >
> > I've tried deleting the /bin folder (and repeating with bjam -a (with
> > the same results))
> >
> > but this gives a possible clue
> >
> >      "The folder contains items whose names are too long for the
> > recycle bin"
> >
> > The Doxygen log also contains the following warnings about files not
> > being available for writing
> >
> > Cannot open file
> > I:/boost-sandbox/endian_2/libs/endian/doc/bin/msvc-10.0/debug/auto-ind
> > ex-internal-on/auto-index-verb
> > ose-on/auto-index-on/threading-multi/autodoc-xml/classboost_1_1endian_
> > 1_1endian_3_01endianness_1_1li
> > ttle_00_01_t_00_01n__bits_00_01alignment_1_1aligned_01_4.xml for writing!
> > Cannot open file
> > I:/boost-sandbox/endian_2/libs/endian/doc/bin/msvc-10.0/debug/auto-ind
> > ex-internal-on/auto-index-verb
> > ose-on/auto-index-on/threading-multi/autodoc-xml/classboost_1_1endian_
> > 1_1endian_3_01endianness_1_1li
> > ttle_00_01_t_00_01n__bits_00_01alignment_1_1unaligned_01_4.xml for
> > writing!
> > Cannot open file
> > I:/boost-sandbox/endian_2/libs/endian/doc/bin/msvc-10.0/debug/auto-ind
> > ex-internal-on/auto-index-verb
> > ose-on/auto-index-on/threading-multi/autodoc-xml/classboost_1_1endian_
> > 1_1endian_3_01endianness_1_1na
> > tive_00_01_t_00_01n__bits_00_01alignment_1_1unaligned_01_4.xml for
> > writing!
> >
> > This looks as though a limit on the filename length might be
> > reached/exceeded?
> 
> There's an (undocumented?!?) --hash option to boost build which fixes that issue - of course the
directory
> names become unreadable in that case...

I hope not to need to read the directory names!

Great - that does the trick!  Builds and provides the index as expected.

Thanks

Paul