Re: Fixes to auxiliar/doc-section.sh

2012-03-10 Thread Trevor Daniels

Hi Phil, you wrote Saturday, March 10, 2012 10:16 AM

Once you have a successful make doc, you might be surprised how little 
time it takes to remake to check changes now.  On my admittedly quick 
machine, make -j9 CPU_COUNT=9 LANGS='' doc takes about 5 seconds.


It's certainly a lot better than it was and it would be usable even on my
laptop running Ubuntu in 800Mb and 1 processor under VirtualBox.

I find make LANGS='' doc takes 4-5 minutes after a trivial change to
a single file, which I agree is quite workable now.

With the same change the script takes around 2 minutes, but in addition
checks all the cross-references and opens up the section's html in a
browser automatically.  Also there is an option to retain all the snippets
between invocations, which reduces the time to less than 30 seconds -
very useful if you know the changes are all in straight text.

Trevor


___
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel


Re: Fixes to auxiliar/doc-section.sh

2012-03-10 Thread Phil Holmes
- Original Message - 
From: "Trevor Daniels" 

To: "Lily-Devel List" 
Sent: Friday, March 09, 2012 11:06 PM
Subject: Fixes to auxiliar/doc-section.sh


I've just pushed some fixes to auxiliar/doc-section.sh to staging, as 
several things seemed to have gone wrong with it since I last used it. 
The script is intended to be used for quickly checking changes made to the 
English docs.  It compiles a section of the docs to html in a minute or so 
and displays that section in a browser.  Far better than waiting an hour 
or so (that's how long it seems to take on my laptop) for make doc to 
finish, if all you want to do is check that the texinfo and the cross-refs 
are valid.  It now works fine on my laptop under Ubuntu.  I'd be grateful 
if one or two of the doc editors could check it out too, once it moves 
into master. Thanks.


Trevor



Once you have a successful make doc, you might be surprised how little time 
it takes to remake to check changes now.  On my admittedly quick machine, 
make -j9 CPU_COUNT=9 LANGS='' doc takes about 5 seconds.


--
Phil Holmes



___
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel


Fixes to auxiliar/doc-section.sh

2012-03-09 Thread Trevor Daniels
I've just pushed some fixes to auxiliar/doc-section.sh to staging, as 
several things seemed to have gone wrong with it since I last used it.  The 
script is intended to be used for quickly checking changes made to the 
English docs.  It compiles a section of the docs to html in a minute or so 
and displays that section in a browser.  Far better than waiting an hour or 
so (that's how long it seems to take on my laptop) for make doc to finish, 
if all you want to do is check that the texinfo and the cross-refs are 
valid.  It now works fine on my laptop under Ubuntu.  I'd be grateful if one 
or two of the doc editors could check it out too, once it moves into master. 
Thanks.


Trevor


___
lilypond-devel mailing list
lilypond-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-devel