[Boost-docs] Improving Boostbook's Output

Subject: [Boost-docs] Improving Boostbook's Output
From: John Maddock (john_at_[hidden])
Date: 2008-12-04 15:47:07

Currently the Boostbook XSL stylesheets generate a lot of verbose output
when run: to put this in perspective a complete build of the docs under
boost-root/doc/ generates 3.1 Mb of messages, quite a large proportion of
which are from Boostbook. Consequently at present it's impossible to figure
out what represents a real issue, and what's just "chaff".

So I'm proposing changing the Boostbook stylesheets as follows:

* Add a new xsl:param "boostbook.verbose" which defaults to 0.
* For each occurrence of xsl:message in the style sheets, we will either:
    * Terminate with an error if the message looks like it's a possible
genuine error.
    * Otherwise emit a warning *only* if boostbook.verbose=1

I'm prepared to invest some time to make this work, but any comments or
possible issues anyone foresees from this change?

Cheers, John.

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:40 UTC