Re: snippets manual is not rebuilt

[Knut Petersen]

On 15.12.20 06:51, Federico Bruni wrote:
> It's not just the snippets manual.
>
> It just happened with the usage manual. I fixed an error in a menu, re-run 
> 'make doc' and I keep getting the same error message as if I did not fix it. 
> But I'm sure I did.
>
> Any other translator confirming the issue? Jean-Charles?
>
> Can someone test the attached patch?


Ok .... first I built  a fresh lilypond master:

   knut@golem ~/sources/gitlab/lilypond (master=)$ ../mklily_intree
   Building LILYPOND cf2ae39e9d93c2dcdc50afd7d0389c314898273c...
      exec git reset --hard in /home/knut/sources/gitlab/lilypond ... succeeded 
after 0 seconds
      exec git clean -dfx in /home/knut/sources/gitlab/lilypond ... succeeded 
after 0 seconds
      exec ./autogen.sh --noconfigure in /home/knut/sources/gitlab/lilypond ... 
succeeded after 0 seconds
      exec ./configure --prefix=/home/knut/sources/lilybuilt 
--with-urwotf-dir=/home/knut/sources/urw-core35-fonts --enable-gs-api in 
/home/knut/sources/gitlab/lilypond ... succeeded after 6 seconds
      exec make  -j 16 CPU_COUNT=16 all in /home/knut/sources/gitlab/lilypond 
... succeeded after 89 seconds
      exec make  -j 16 CPU_COUNT=16 install in 
/home/knut/sources/gitlab/lilypond ... succeeded after 4 seconds
   LILYPOND binary build time: 99 seconds
   Building documentation ...
      exec make  -j 16 CPU_COUNT=16 doc in /home/knut/sources/gitlab/lilypond 
... succeeded after 589 seconds
      exec make  -j 16 CPU_COUNT=16 install-doc in 
/home/knut/sources/gitlab/lilypond ... succeeded after 98 seconds
   LILYPOND documentation build time: 687 seconds


Then I applied your patch:

   knut@golem ~/sources/gitlab/lilypond (master=)$ patch -p 1 < 
../0001-Doc-it-Update-essay-learning-and-usage-manuals.patch
   patching file Documentation/it/essay.tely
   patching file Documentation/it/essay/engraving.itely
   patching file Documentation/it/included/helpus.itexi
   patching file Documentation/it/learning.tely
   patching file Documentation/it/learning/common-notation.itely
   patching file Documentation/it/learning/fundamental.itely
   patching file Documentation/it/learning/templates.itely
   patching file Documentation/it/learning/tutorial.itely
   patching file Documentation/it/learning/tweaks.itely
   patching file Documentation/it/macros.itexi
   patching file Documentation/it/usage.tely
   patching file Documentation/it/usage/external.itely
   patching file Documentation/it/usage/lilypond-book.itely
   patching file Documentation/it/usage/running.itely
   patching file Documentation/it/usage/suggestions.itely
   patching file Documentation/it/usage/updating.itely


After that I executed "make doc" again:

   knut@golem ~/sources/gitlab/lilypond (master *=)$ make doc
   Making Documentation/out-www/it/essay.texi < tely
   Making latt1095.tfm in TeXLive (mktextfm)
   Making larm1095.tfm in TeXLive (mktextfm)
   Making Documentation/out-www/it/essay.pdf < texi
   Making Documentation/out-www/it/learning.texi < tely
   Making Documentation/out-www/it/learning.pdf < texi
   Making Documentation/out-www/it/usage.texi < tely
   Making Documentation/out-www/it/usage.pdf < texi
   Making Documentation/out-www/it/essay.xref-map < texi
   Making Documentation/out-www/it/learning.xref-map < texi
   Making Documentation/out-www/it/usage.xref-map < texi
   Making Documentation/out-www/it/essay-big-page.html < texi
   Making Documentation/out-www/it/learning-big-page.html < texi
   Making Documentation/out-www/it/notation-big-page.html < texi
   Making Documentation/out-www/it/snippets-big-page.html < texi
   Making Documentation/out-www/it/usage-big-page.html < texi
   Making Documentation/out-www/it/web-big-page.html < texi
   Making Documentation/out-www/it/essay/index.html < texi
   Making Documentation/out-www/it/learning/index.html < texi
   Making Documentation/out-www/it/notation/index.html < texi
   Making Documentation/out-www/it/snippets/index.html < texi
   Making Documentation/out-www/it/usage/index.html < texi
   Making Documentation/out-www/it/web/index.html < texi
   Making Documentation/out-www/webdoc


Thats all. (un)fortunately I see NO error message.


> Here's the 'make doc' error I see:
>
> Command: DEPTH=../../ TOP_SRC_DIR=/home/fede/src/lilypond-git PERL_UNICODE=SD texi2html --prefix=index --split=section --error-limit=0 -I /home/fede/src/lilypond-git/Documentation/it -I /home/fede/src/lilypond-git/Documentation/pictures -I out-www/it/usage/ -I ./out-www/en -I 
> /home/fede/src/lilypond-git/Documentation/en -I /home/fede/src/lilypond-git/Documentation/en/included -I ./out-www -I /home/fede/src/lilypond-git/Documentation --init-file=/home/fede/src/lilypond-git/Documentation/lilypond-texi2html-lang.init --document-language=it 
> --init-file=/home/fede/src/lilypond-git/Documentation/lilypond-texi2html.init --output=out-www/it/usage/ out-www/it/usage.texi
>
> ** Node following `Variabili d'ambiente' in menu `Relocation' and in 
> sectionning `Riposizionamento' differ
> ** `Riposizionamento' doesn't appear in menus
> ** `Uso da linea di comando' is up for `Riposizionamento', but has no menu 
> entry for this node
> ** No node following `Riposizionamento' in menu, but `LilyPond in una gabbia 
> chroot' follows in sectionning
> *** Unknown node in menu entry `Relocation' (in out-www/it/usage/running.texi 
> l. 59)
> Max error number exceeded

Probably that error message is from _your_ 
Documentation/out-www/it/usage.splittexi.log.


Now let's have a look at _my_ Documentation/out-www/it/usage.splittexi.log:

   Command:  DEPTH=../../ TOP_SRC_DIR=/home/knut/sources/gitlab/lilypond 
PERL_UNICODE=SD texi2html  --prefix=index --split=section  -I 
/home/knut/sources/gitlab/lilypond/Documentation/it -I 
/home/knut/sources/gitlab/lilypond/Documentation/pictures -I out-www/it/usage/ 
-I ./out-www/en -I
   /home/knut/sources/gitlab/lilypond/Documentation/en -I 
/home/knut/sources/gitlab/lilypond/Documentation/en/included -I ./out-www -I 
/home/knut/sources/gitlab/lilypond/Documentation 
--init-file=/home/knut/sources/gitlab/lilypond/Documentation/lilypond-texi2html-lang.init
 --document-language=it
   
--init-file=/home/knut/sources/gitlab/lilypond/Documentation/lilypond-texi2html.init
 --output=out-www/it/usage/ out-www/it/usage.texi

   out-www/it/usage.texi:34: warning: @copyrightDeclare defined with zero or 
more than one argument should be invoked with {} (via @lilyTitlePage)
   out-www/it/usage.texi:55: warning: @docMain defined with zero or more than 
one argument should be invoked with {}
   out-www/it//usage/running.texi:1696: warning: @morerefs defined with zero or 
more than one argument should be invoked with {}
   out-www/it//usage/lilypond-book.texi:456: warning: @snippets defined with 
zero or more than one argument should be invoked with {}
   out-www/it//usage/lilypond-book.texi:526: warning: @morerefs defined with 
zero or more than one argument should be invoked with {}
   out-www/it//usage/lilypond-book.texi:1117: warning: @knownissues defined 
with zero or more than one argument should be invoked with {}
   out-www/it//usage/lilypond-book.texi:1282: warning: @knownissues defined 
with zero or more than one argument should be invoked with {}
   out-www/it//usage/external.texi:422: warning: @knownissues defined with zero 
or more than one argument should be invoked with {}
   out-www/it//usage/external.texi:518: warning: @knownissues defined with zero 
or more than one argument should be invoked with {}
   out-www/it//usage/external.texi:699: warning: @knownissues defined with zero 
or more than one argument should be invoked with {}
   out-www/it//usage/external.texi:751: warning: @knownissues defined with zero 
or more than one argument should be invoked with {}
   out-www/it//usage/suggestions.texi:659: warning: @morerefs defined with zero 
or more than one argument should be invoked with {}
   WARNING: Unable to load the map file
   WARNING: Unable to find node 'Staff' in book internals.
   WARNING: Unable to find node 'Voice' in book internals.


Please quote the entire contents of that file on your system.

Which versions of makeinfo / texi2html are installed on your system?  
(texi2html --version, makeinfo --version)

Do you work on translations of manuals in the 'master' branch?


Knut