Re: make doc

[Carl Sorensen]

On 5/28/11 8:24 AM, "Phil Holmes" <address@hidden> wrote:

> ----- Original Message -----
> From: "Graham Percival" <address@hidden>
> To: "Phil Holmes" <address@hidden>
> Cc: <address@hidden>
> Sent: Friday, May 27, 2011 6:40 PM
> Subject: Re: make doc
> 
> 
>> On Fri, May 27, 2011 at 06:25:20PM +0100, Phil Holmes wrote:
>>> Is the aim with make docs to try to make it silent, unless there are
>>> errors, like we have done with make website?
>> 
>> Yes.  Ideally we should have no texinfo errors, no .ly errors, etc
>> etc.
>> 
>>> I realise that to make this happen there will have to be lots of
>>> work to understand it better,
>> 
>> ETA: 150 hours for the English docs alone.  Another 50-100 hours
>> for the translations.
>> 
>>> Is it worth raising a tracking issue report?
>> 
>> I wouldn't bother adding an issue to the tracker, but there's
>> certainly no harm in doing so.
>> 
>> Cheers,
>> - Graham
>> 
> 
> OK - one of the first things I see is that lilypond is always invoked with
> the --verbose flag - so each time we call lilypond (and it's quite a bit -
> over 180 as an estimate from grep) we get 100s of lines of lilypond debug
> output - this probably adds 20-30,000 lines to the output.  My suggestion
> for task 1 is to get rid of the --verbose flag.  Any idea why it's there?

So we can see which scm files are loaded, etc.  It's very helpful in
debugging problems.

Certainly lose it with the -s flag.

Carl