Struggling to get a clean make doc

[James Lowe]

Hello,

I have not been able to get a consistent clean make of doc for about 2 weeks 
now.

I've been blaming myself (because it usually is my fault) but I've been on 
three different Linux Machines (2 VMs one physical) and get the same basic 
error after every couple of git-pulls.

I've been building in and out of the tree (i.e. make doc in the lilypond-git 
dir and also in a lilypond-git/build/ dir as requested in the CG.

Sometimes I can just touch a *.tely file, do another make doc and sometimes not.

I started to notice this when we had some 'cs' translation checkins, I got a 
slew of 'unable to find node...' and then it gives me an error 21 about and 
index.XX.html file and says 

*** Can't open ./out-www/lilypond-git/Documentation/./out-www/web/index.cs.html 
  (as an example).

In the case of the out of tree build it is

*** Can't open 
./out-www/lilypond-git/build/Documentation/./out-www/web/index.cs.html

The error is not random but it is not always in the same place during the 
compile albeit during a different language (I get it mostly on CS but have had 
it on HU and JA), however the message I get IS the same each time.

I saw a message between Graham and Reinhold (I think) about these CS language 
messages but there was some 'more than 5 and I worry about it' message, this 
may or may not be a coincidence.

It's getting a bit frustrating now and has stopped me from being to do most doc 
work these last few days as I can't keep touching and re-doing a make doc on 
the off chance that this time it will work.

I'll paste the latest snippet of the error here:

--snip--

Writing snippets...
All snippets are up to date...
Compiling 
/home/james/lilypond-git/Documentation/cs/out-www/learning/tweaks.texi...
/home/james/lilypond-git/Documentation/cs/out-www/learning/tweaks.texi is up to 
date.
Processing include: learning/templates.itely
Reading learning/templates.itely...
Dissecting...
Writing snippets...
All snippets are up to date...
Compiling 
/home/james/lilypond-git/Documentation/cs/out-www/learning/templates.texi...
/home/james/lilypond-git/Documentation/cs/out-www/learning/templates.texi is up 
to date.
Processing include: fdl.itexi
Reading /home/james/lilypond-git/Documentation/fdl.itexi...
Dissecting...
Writing snippets...
All snippets are up to date...
Compiling /home/james/lilypond-git/Documentation/cs/out-www/fdl.texi...
/home/james/lilypond-git/Documentation/cs/out-www/fdl.texi is up to date.
/home/james/lilypond-git/scripts/build/out/extract_texi_filenames -o 
/home/james/lilypond-git/./out-www/xref-maps -I ./out-www -I. 
--master-map-file=/home/james/lilypond-git/./out-www/xref-maps/learning.xref-map
 out-www/learning.texi
extract_texi_filenames.py: Processing out-www/learning.texi
No such file: learning/working.itely
Search path: .:./out-www:.
No such file: learning/scheme-tutorial.itely
Search path: .:./out-www:.
writing: /home/james/lilypond-git/./out-www/xref-maps/learning.cs.xref-map
find ./out-www \( -name 'lily-*.png' -o -name 'lily-*.ly' \) | sed 
's!./out-www/!!g' | xargs /home/james/lilypond-git/scripts/build/out/mass-link 
hard ./out-www /home/james/lilypond-git/Documentation/./out-www
mass-link.py
find ./out-www \( -name '*.??.idx' \) | sed 's!./out-www/!!g' | xargs 
/home/james/lilypond-git/scripts/build/out/mass-link hard ./out-www 
/home/james/lilypond-git/Documentation/./out-www
mass-link.py
touch out-www/translation-lily-images
mkdir -p /home/james/lilypond-git/Documentation/./out-www/web/
mkdir -p ./out-www/web
DEPTH=../../../ TOP_SRC_DIR=/home/james/lilypond-git PERL_UNICODE=SD texi2html 
--prefix=index --split=section --I=. --I=. --I=./out-www -I 
/home/james/lilypond-git/Documentation/cs/included -I 
/home/james/lilypond-git/Documentation -I 
/home/james/lilypond-git/Documentation/./out-www 
--I=/home/james/lilypond-git/./out-www/xref-maps --lang=cs 
--init-file=/home/james/lilypond-git/Documentation/lilypond-texi2html.init  
--output=./out-www/web out-www/web.texi
Initializing settings for web site: [cs]
File name: 
File name: 
WARNING: Unable to find node 'Začátek' in book music-glossary.
WARNING: Unable to find node 'Začátek' in book essay.
WARNING: Unable to find node 'Začátek' in book notation.
WARNING: Unable to find node 'Začátek' in book usage.
WARNING: Unable to find node 'Začátek' in book snippets.
WARNING: Unable to load the map file 
WARNING: Unable to find node 'Začátek' in book lilypond-changes.
WARNING: Unable to find node 'Začátek' in book extending.
WARNING: Unable to find node 'Začátek' in book internals.
WARNING: Unable to find node 'Řešení potíží' in book usage.
WARNING: Unable to find node 'Proč se mění skladba?' in book usage.
*** Can't open ./out-www/web/ for writing: Is a directory
make[3]: *** 
[/home/james/lilypond-git/Documentation/./out-www/web/index.cs.html] Error 21
make[3]: Leaving directory `/home/james/lilypond-git/Documentation/cs'
make[2]: *** [WWW-2] Error 2
rm out-www/weblinks.itexi
make[2]: Leaving directory `/home/james/lilypond-git/Documentation'
make[1]: *** [WWW-2] Error 2
make[1]: Leaving directory `/home/james/lilypond-git'
make: *** [doc] Error 2

---snip---

As I say this can happen in the 'same' place but for other language 
translations - but I have never had it in fr or de.

I am also wondering (because my VMs are relatively underpowered - 2GB RAM?) 
that perhaps these warnings generate some memory leak or similar and the 
failure is just something like that. I say this because of the 
'sometimes-a-touch-make-doc' works after this error.

Thanks

James

<<attachment: winmail.dat>>