Re: [Boost-build] [Accumulators] Problem building the combined boost documentation.

From: Jurko Gospodnetić (jurko.gospodnetic_at_[hidden])
Date: 2008-07-01 16:17:31

   Hi Eric.
>>   When running bjam on Windows from libs/accumulators/doc 
> 
> Under cygwin? Using a cygwin-built bjam?
> 
>> I get the following errors:
> <snip>
> 
> Try deleting your bin.v2 directory.

   Ok, I did another 'clean run' and the results can be found below. 
Clean run entails starting with no bin.v2 folder and running 'bjam -q 
-d+2' from the libs/accumulators/doc folder.

   Cygwin tools are on the path and my user-config.jam files used for 
these tests are as follows:

   For native Windows:

> using msvc ;
> 
> using boostbook
>     : "C:/Program Files/Cygwin/usr/share/docbook-xsl"
>     : "C:/Program Files/Cygwin/usr/share/xml/docbook/4.4"
>     : "C:/Documents and Settings/Jurko/Desktop/Boost_trunk/tools/boostbook" ;
> 
> using doxygen ;

   For cygwin:

> using gcc ;
> 
> using boostbook
>     : "/usr/share/docbook-xsl"
>     : "/usr/share/xml/docbook/4.4"
>     : "/cygdrive/c/Documents\\ and\\ Settings/Jurko/Desktop/Boost_trunk/tools/boostbook" ;
> 
> using doxygen ;

   1. When using cygwin doxygen 1.5.5 from the cmd shell and using the 
native Windows bjam built using msvc:

> xslt-xsltproc ..\..\..\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml.doxygen
> 
>     set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml
>  "xsltproc" --stringparam doxygen.xml.path "C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debu
> g\threading-multi\tagfile-xml" --xinclude -o "..\..\..\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml.doxygen" "C
> :\Documents and Settings\Jurko\Desktop\Boost_trunk\tools\boostbook\xsl\doxygen\collect.xsl" "C:\Documents and Settings\Jurko\Desktop\Boost_trunk\
> bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml\index.xml"
> 
> C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml\index.xml:117:
>  parser error : Opening and ending tag mismatch: compound line 116 and doxygenindex
> </doxygenindex>
>                ^
> C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml\index.xml:118:
>  parser error : Premature end of data in tag compound line 115
> 
> ^
> C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml\index.xml:118:
>  parser error : Premature end of data in tag compound line 97
> 
> ^
> C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xml\index.xml:118:
>  parser error : Premature end of data in tag doxygenindex line 2
> 
> ^
> unable to parse C:\Documents and Settings\Jurko\Desktop\Boost_trunk\bin.v2\libs\accumulators\doc\msvc-9.0express\debug\threading-multi\tagfile-xm
> l\index.xml
> ...failed updating 1 target...

   2. When using cygwin doxygen 1.5.5 from the cygwin bash shell and 
using the cygwin bjam built using gcc 3.4.4:

   - I had to battle a bit with paths containing spaces. :-) I'll commit 
a patch for doxygen.jam that made those problems go away. Please give 
them a spin. They should not break anything, but... :-)

   - When I do a clean build I get an error at some point stating that 
the "/cygdrive/c/Documents and 
Settings/Jurko/Desktop/Boost_trunk/bin.v2/libs/accumulators" folder can 
not be created because it already exists. The error is not reported in 
case I simply rerun the build without removing the bin.v2 folder. This 
might be something akin to your original problem. If so, then maybe we 
got lucky and I have something to go on in tracking that problem down. 
:-) I may even know where to look for this as I seem to recall dealing 
with something similar in the regular Windows bjam build a few months 
ago. But I'll have to get back to this later...

   - When running the xslt-xsltproc-dir rule I get errors about the 
XML_CATALOG_FILES environment variable failing to be exported. Those 
warnings do not seem to stop the build though.

> xslt-xsltproc-dir html/standalone_HTML.manifest
> 
>     XML_CATALOG_FILES=../../../bin.v2/boostbook_catalog.xml
> export XML_CATALOG_FILES
>  "xsltproc" --stringparam boost.max.id.length "1024" --stringparam chunk.section.depth "2" --stringparam manifest "standalone_HTML.manifest" --st
> ringparam toc.max.depth "4" --stringparam toc.section.depth "4" --xinclude -o "html/" "/cygdrive/c/Documents and Settings/Jurko/Desktop/Boost_tru
> nk/tools/boostbook/xsl/html.xsl" "../../../bin.v2/libs/accumulators/doc/gcc-3.4.4/debug/accumulators.docbook"
> 
> /bin/sh: line 2: export: `XML_CATALOG_FILES': not a valid identifier

   - When running the build there are several xslt related errors like:

> Cannot find class named 'boost::accumulators::accumulator_set'
> Cannot find class named 'boost::accumulators::depends_on'
> Cannot find class named 'boost::accumulators::feature_of'
> Cannot find class named 'boost::accumulators::as_feature'
> Cannot find class named 'boost::accumulators::features'
> Cannot find class named 'boost::accumulators::external'

   and

> ../../../bin.v2/libs/accumulators/doc/gcc-3.4.4/debug/accumulators.xml:6235: parser error : Entity 'uuml' not defined
>       to thank Daniel Egloff of <ulink url="http://www.zkb.com">Z&uuml;rcher Kan
>                                                                        ^
> ../../../bin.v2/libs/accumulators/doc/gcc-3.4.4/debug/accumulators.xml:6242: parser error : Entity 'uuml' not defined
>       Finally, I would like to thank <ulink url="http://www.zkb.com">Z&uuml;rche

   but I guess those could be a result of that XML_CATALOG_FILES 
environment variable not getting exported correctly. Unfortunately I do 
not know doxygen/xslt so can not debug this part without much extra effort.

   Btw. when compiling boostbook I get a lot of compilation warnings 
like "This header is deprecated. Please use: 
boost/spirit/include/classic_position_iterator.hpp". Was this intended 
or no one just had the time to update boostbook to use the new Spirit 
library headers?

   Best regards,
     Jurko Gospodnetić