buliding the docs without compiling lilypond: success

[Graham Percival]

Anybody interested in viewing the docs (or perhaps the translated docs) 
can build them locally without compiling lilypond from scratch.

From a fresh git checkout, do

./autogen.sh  % ignore any warning messages
cp GNUmakefile.in GNUmakefile
make -C python
nice make 
LILYPOND_EXTERNAL_BINARY=~/Apps/LilyPond.app/Contents/Resources/bin/lilypond 
web

% change the lilypond directory as appropriate

Note that you must have the most recent unstable version of lilypond to 
compile git stuff.  Also note that this may break sometimes -- for 
example, if a new feature is added with a test file in input/regression, 
even the latest unstable Lily will fail to build the docs.

You may build the manual ( Documentation/user/ ) without building all 
the input/* stuff.


There are two problems with the build, both with work-arounds:
1.  texinfo 4.8  has a file allocation leak.  Patches to fix this exist, 
and I'm pretty certain that these patches have been integrated into the 
texinfo cvs.  However, if you're still using texinfo 4.8  (ie you simply 
install texinfo via "fink install" or "apt-get" or whatever), then run

ulimit -n 4096

before trying to build the user manual.


2.  There seems to be a memory leak in lilypond 2.11.11; during the 
build process, I noticed lilypond using > 230 megs.  I stopped the build 
a few times to let the memory clear out.

Cheers,
- Graham