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

Subject: Re: [Boost-docs] Making Boost Doc builds more robust
From: Vladimir Prus (vladimir_at_[hidden])
Date: 2008-12-04 14:04:08

Beman Dawes wrote:

> Thanks to everyone who is responding to this thread, and working to improve
> the process! It doesn't feel so hopeless if I know others are working on the
> problems.
> 
> 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.

It is impossible, I think. The "No template matches..." message is coming
from xstlproc directly, we don't control it. Grepping for that specific
text is the only possible approach, and it's what we do at work.

- Volodya