Re: [Boost-docs] [boostbook][patch] typedef class member descriptions

Subject: Re: [Boost-docs] [boostbook][patch] typedef class member descriptions
From: Frank Mori Hess (frank.hess_at_[hidden])
Date: 2007-10-30 20:40:56

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

On Monday 29 October 2007 14:33 pm, Eric Niebler wrote:
> Do you have commit access? I haven't looked into your changes in detail,

Yes.

> but they sound great! Have you tried building all the Boost docs with
> your changes? Unless someone else objects, I suggest you try that,

Yes, I've been periodically building the main boost html and pdf docs with my 
changes.  There are a couple fixes I have to have locally in my tree to 
build, like patching a date_time Jamfile, but those problems aren't caused by 
my changes to boostbook.  

Building the pdf version of the boost docs has a few more problems, due to 
apache fop being more strict about the validitity of its input.  For example, 
some of the generated-from-doxygen date_time xml winds up with multiple 
elements with the same name attribute, that I have to fix manually.  It's 
caused by things like multiple definitions for typedefs in header files that 
are ordinarily selected by the preprocessor when compiling, but which all get 
dumped into the doxygen-generated xml.  It might be fixable in the 
doxygen2boostbook.xsl stylesheet, but I haven't looked into it.

> spot-check the docs by hand, and then commit all your changes to the
> trunk. Then send around a heads up so the individual authors can check
> the results for their docs.

I've been committing the patches I've been posting here after waiting about a 
week for anyone to comment on them.  After the two I posted yesterday, there 
are just a few more I want to merge over from the sandbox/boost_docs tree.  
I'll post them after the current batch go in, as they touch some of the same 
files.

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

iD8DBQFHJ5bd5vihyNWuA4URAqwzAKDM6Jvkyk8uVh2qpK03H2NKss01CACg3Opk
rW1xK4QtyuekgAIwG13554g=
=749G
-----END PGP SIGNATURE-----