Re: make doc

[Phil Holmes]

----- 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?

--
Phil Holmes