Re: [boost] Boost.Book problems

From: John Maddock (john_at_[hidden])
Date: 2007-08-14 05:23:20

Matthias Schabel wrote:
>>> warn: Unable to construct ./standalone
>>
>> ./standalone is the name of the main target
>> that generates the html.  (check the Jamfile.v2)
>
> I get the same error when I try to build docs for Boost.MPI (from CVS-
> HEAD), so I don't think the problem is with the Boost.Units
> documentation per se. This is the kind of stuff that makes me less
> than lukewarm on the homegrown Boost documentation tools - doxygen
> alone may not be as flexible or produce output that is as pretty, but
> at least it worked reliably... There are few things that are less fun
> than writing documentation, but having to deal with faulty tools for
> documentation is one of them.

:-(

MPI docs build OK for me, here's what my user-config.jam looks like in case 
it helps:

using xsltproc
    : "C:/download/open/xml/bin/xsltproc-win32/xsltproc.exe"
    ;

using boostbook
    : "C:/download/open/xml/docbook-xsl-snapshot"
      #"C:/download/open/xml/docbook-xsl"
    : "C:/download/open/xml/docbook-xml"
    ;

using fop :  #C:/download/open/xml/fop-0.93/fop.bat
             #C:/download/open/xml/fop-0.20.5/fop.bat
             C:/Progra~1/xep/xep.bat
           : C:/PROGRA~1/Java/j2re1.4.2_12
           ;

using quickbook : "C:/download/open/xml/bin/quickbook.exe" ;

using doxygen : "C:/Program Files/doxygen/bin/doxygen.exe" ;

I tried building the current SVN/sandbox docs for Boost.Units but get the 
following error:

xslt-xsltproc 
..\..\..\bin.v2\libs\units\doc\msvc-8.0\debug\threading-multi\unit
s_reference-xml.boostbook
warning: failed to load external entity "Reference"
cannot parse Reference

  set 
XML_CATALOG_FILES=..\..\..\bin.v2\libs\units\doc\msvc-8.0\debug\threading-
multi/catalog.xml
 "C:/download/open/xml/bin/xsltproc-win32/xsltproc.exe" --stringparam 
boost.doxy
gen.reftitle ""Units Reference"" --xinclude -o 
"..\..\..\bin.v2\libs\units\doc\m
svc-8.0\debug\threading-multi\units_reference-xml.boostbook" 
"c:\data\boost\boos
t\trunk\tools\boostbook\xsl\doxygen\doxygen2boostbook.xsl" 
"..\..\..\bin.v2\libs
\units\doc\msvc-8.0\debug\threading-multi\units_reference-xml.doxygen"

Not sure what "Reference" is?

HTH, John.