Re: [Boost-docs] [IBD] from sandbox to trunk

Subject: Re: [Boost-docs] [IBD] from sandbox to trunk
From: Frank Mori Hess (frank.hess_at_[hidden])
Date: 2007-09-14 03:05:32

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Wednesday 12 September 2007 19:52 pm, Cromwell Enage wrote:
>
> Okay, I checked those three directories out and got a
> little farther this time.  Now there are certain
> sectiondefs that cannot be handled during XSLT
> processing, so most XML autodocs are built but not any
> HTML output.
>

I've given a try at building the boost trunk documentation with boost_docs 
too.  I don't think the unknown sectiondefs are the problem, those are just 
warnings that doxygen2boostbook is ignoring something in the doxygen xml.  I 
get things like (when running bjam with the -d+2 option):

 XML_CATALOG_FILES=../bin.v2/doc/gcc-4.1.2/debug/catalog.xml
export XML_CATALOG_FILES

"/usr/bin/X11/xsltproc" --stringparam boost.doxygen.reftitle ""Gregorian 
Reference"" --xinclude -o "../bin.v2/libs/date_time/xmldoc/gcc-4.1.2/debug/gregorian_autodoc-xml.boostbook" "/home/fhess/svn/boost/tools/boostbook/xsl/doxygen/doxygen2boostbook.xsl" "../bin.v2/libs/date_time/xmldoc/gcc-4.1.2/debug/gregorian_autodoc-xml.doxygen"

warning: failed to load external entity "Reference"
cannot parse Reference

Note the double quotation marks around "Gregorian Reference".  If I escape the 
interior pair of quotation marks, the xstlproc command runs fine.  In fact, I 
can get bjam out of its jam (sorry) by running all such commands that it 
fails on manually with the quotation mark escaped.  I wouldn't know how to 
write a jamfile to tell bjam to build "hello_world", so I'm a bit lost at 
figuring out where the unescaped quotes are coming from.

Another oddity: the catalog.xml file referenced by XML_CATALOG_FILES for the 
doxygen2boostbook.xsl xsltproc calls isn't created until after the xsltproc 
runs. Is there a missing dependency?
 
Then, after I added a declaration of annotation.support to docbook-params.xsl 
(not sure if this a proper fix?) in response to an error about it being 
undeclared, I finally get html!  Allthough, it doesn't look that great 
because it looks like project.root is up two directories too far.

- -- 
Frank
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFG6fqA5vihyNWuA4URAvI/AKDa6AjHp7whor25CkkuWczNS+0ozwCfZVq7
4qdeNcDLBXxqYVPWVQn5iks=
=/beT
-----END PGP SIGNATURE-----