Re: stop breaking the docs

[John Mandereau]

Le lundi 25 février 2008 à 15:33 -0800, Graham Percival a écrit :
> Folks,
> 
> Please bloody test with GUB, especially if you're working on the
> makefiles and the like.

The problem is, I make so much changes these days that it's difficult to
test all of them one at a time with traditional compilation, building
with an external binary, and building with GUB (which I even don't do
because I think my 1.4 GHz Celeron M is not fast enough).  I'll commit 


>   I cannot build the docs now. Yes, I did
> another rm -rf *; git reset --hard.

That's a very radical way, I've never had to do so.  Except the 'make
clean' bug in mf/, checking the state of the working tree with 'git
status' and doing 'make web-clean && make clean' always results in a
clean working tree for me.


> I am using GUB 2.11.41 and following the instructions in
> AU 1.2.4 "building the docs without compiling lilypond".  If
> I'm supposed to do something else to get this
> automatic-lilypond-version thing working, add that to
> the docs.

There should be nothing to add there, and I hope makefiles changes I do
these days will make manual cleaning of Documentation/user unnecessary
for remaking manuals.



> Overfull \hbox (12.1685pt too wide) in paragraph at lines 113--113
>  \smallrm Internals Reference91[] 
> ./lilypond-learning.cps:136: TeX capacity exceeded, sorry [grouping
> levels=255] .
> <recently read> {
>                  
> \ ->{\spaceskip = 0pt{
>                       } }
> \tclose ...on \rawbackslash \plainfrenchspacing #1
>                                                   }\null 
> \codex #1->\tclose {#1}
>                        \endgroup 
> l.136 \entry {\code 
>                     {\xeatspaces {melisma}}}{30}
> ./lilypond-learning.cps:136:  ==> Fatal error occurred, the output PDF
> file is not finished!
> Transcript written on lilypond-learning.log.
> /Users/gperciva/usr/bin/texi2dvi: pdfetex exited with bad status,
> quitting. make[1]: *** [out-www/lilypond-learning.pdf] Error 1
> make: *** [web] Error 2

TeX logs are hard to understand, and as in this case, the last hundred
lines of the log are often needed to find the source of the error.


> I'm not positive that this was rebuilding from a clean checkout,
> though, since "make clean" fails in the middle due to
> make[1]: *** No rule to make target
> `/home/lilypond/lilypond/buildscripts/./out/gen-emmentaler-scripts',
> needed by `out/emmentaler-26.dep'.  Stop.

I work around this with 'rm -rf mf/out' and do 'make clean' again.  I'll
try a fix suggested some weeks ago by Han-Wen on my new branch.
'rm -rf *; git reset --hard' should definitely not be the way of
cleaning the build, but that's not your fault, it's the fault of people
hacking makefiles like me :-)


-- 
John Mandereau <address@hidden>