Re: [Boost-docs] Making Boost Doc builds more robust

Subject: Re: [Boost-docs] Making Boost Doc builds more robust
From: John Maddock (john_at_[hidden])
Date: 2008-12-04 13:56:48

Beman Dawes wrote:
>> One of the reasons I have so much trouble with doc builds is that
>> the log file is next to useless for debugging problems. It is too
>> large ( 3.1 megabyes), too verbose, and identifies things as errors
>> that are apparently perfectly normal. See attached.
>>
>> While it is fine to have a verbose mode that lists everything that
>> happens, the default should be to output only error messages. At the
>> very least messages like "No template matches paramtype in
>> parameter." should be prefixed with "Error: " or "Warning: " as
>> appropriate.

Agreed.

Most of these "spurious" messages come from the Boostbook stylesheets: in 
other words they are problems of our own making, and somehow we should try 
to figure out which are errors (and terminate when they occur), and which 
are warnings (and suppress them unless in some "verbose" mode).

Unfortunately Doxygen also emits a lot of messages we have no control over 
:-(

>> As it stands now, I'd can't even grep for "error", and get a
>> meaningful result. See below for the current release branch result
>> of such a grep. Are these really errors?

Unfortunately yes, those are errors: or at least they represent broken 
links.

John.