Hi all
I'm testing a translation patch and I cannot understand which mistake
is causing the following error:
```
$ make -j3 doc
[...]
Please check the logfile
/var/home/fede/src/lilypond-intree/Documentation/./out-www/it/usage.texi2pdf.log
for errors. Last 20 lines:
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
? ][15][16][17][18][19][20]
135850 bytes written
/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.t
exi:14: Emergency stop.
@badenverr ...temp , not @inenvironment @thisenv }
@checkenv ...@ifx @thisenv @temp @else @badenverr
@fi
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
Output written on usage.pdf (20 pages).
Transcript written on usage.log.
/usr/bin/texi2dvi:
/var/home/fede/src/lilypond-intree/scripts/build/xetex-with-options.sh
exited with bad status, quitting.
make[2]: *** [GNUmakefile:233: out-www/it/usage.pdf] Error 1
make[2]: *** Deleting file 'out-www/it/usage.pdf'
make[2]: *** Waiting for unfinished jobs....
make[1]: ***
[/var/home/fede/src/lilypond-intree/stepmake/stepmake/generic-targets.make:150:
WWW] Error 2
make: ***
[/var/home/fede/src/lilypond-intree/stepmake/stepmake/generic-targets.make:155:
doc] Error 2
```
Find attached the log file and the updating.texi generated file.
xextex-with-options.sh is failing. Perhaps I have a version which
doesn't support those options?
$ xetex --version
XeTeX 3.141592653-2.6-0.999993 (TeX Live 2021)
kpathsea version 6.3.3
Copyright 2021 SIL International, Jonathan Kew and Khaled Hosny.
There is NO warranty. Redistribution of this software is
covered by the terms of both the XeTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the XeTeX source.
Primary author of XeTeX: Jonathan Kew.
Compiled with ICU version 69.1; using 69.1
Compiled with zlib version 1.2.11; using 1.2.11
Compiled with FreeType2 version 2.11.0; using 2.11.0
Compiled with Graphite2 version 1.3.14; using 1.3.14
Compiled with HarfBuzz version 2.8.2; using 2.8.2
Compiled with libpng version 1.6.37; using 1.6.37
Compiled with pplib version v2.05 less toxic i hope
Compiled with fontconfig version 2.13.94; using 2.13.94
I may trying opening a MR and see if it fails also on Gitlab.
Command: cd out-www/it/; texi2pdf --batch -I ../ -I /var/home/fede/src/lilypond-intree/Documentation/it -I /var/home/fede/src/lilypond-intree/Documentation -I /var/home/fede/src/lilypond-intree/Documentation/en/ -o /var/home/fede/src/lilypond-intree/Documentation/./out-www/it/usage.tmp.pdf /var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.texi < /dev/null
This is XeTeX, Version 3.141592653-2.6-0.999993 (TeX Live 2021) (preloaded format=xetex)
restricted \write18 enabled.
entering extended mode
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.texi
(/var/home/fede/src/lilypond-intree/tex/texinfo.tex
Loading texinfo [version 2021-09-26.10]: pdf, fonts, glyphs, page headings,
tables, conditionals, indexing, sectioning, toc, environments, defuns, macros,
cross references, insertions,
(/usr/share/texlive/texmf-dist/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
) localization, formatting, and turning on texinfo input format.)
(/var/home/fede/src/lilypond-intree/tex/txi-it.tex no patterns for italian)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/macros.texi
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/version.texi)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/en/common-macros.t
exi
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/en/cyrillic.texi))
)
Writing index file usage.cp
[1] (/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.toc)
[-1] (/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.toc)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/running.t
exi Capitolo 1
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.aux)
[1] [2] [3]
xdvipdfmx:warning: Found a mismatched fontmap line 6170 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpcxbsl default rpcxb -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6171 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpcxsl default rpcxr -s 0.167
xdvipdfmx:warning: [4Found a mismatched fontmap line 6172 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxbsl default rpxb -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6173 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplb tx8r.enc uplb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6174 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplbi tx8r.enc uplbi8a
xdvipdfmx:warning: Found a mismatched fontmap line 6175 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplbo tx8r.enc uplb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6176 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplr tx8r.enc uplr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6177 from pdftex.map.
xdvipdfmx:warning: ]-- Ignore the current input buffer: rpxpplri tx8r.enc uplri8a
xdvipdfmx:warning: Found a mismatched fontmap line 6178 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplro tx8r.enc uplr8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6179 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxsl default rpxr -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6878 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvb tx8r.enc uhvb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6879 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvbo tx8r.enc uhvb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6880 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvr tx8r.enc uhvr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6881 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvro tx8r.enc uhvr8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6882 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmb tx8r.enc utmb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6883 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmbi tx8r.enc utmbi8a
xdvipdfmx:warning: Found a mismatched fontmap line 6884 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmbo tx8r.enc utmb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6885 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmr tx8r.enc utmr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6886 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmri tx8r.enc utmri8a
xdvipdfmx:warning: Found a mismatched fontmap line 6887 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmro tx8r.enc utmr8a -s 0.167
stdin -> usage.pdf
[5] [6] [7] [8][1
l.823: Undefined cross reference `Punta e clicca-snt'.
l.823: Undefined cross reference `Punta e clicca-snt'.
l.823: Undefined cross reference `Punta e clicca-title'.
l.823: Undefined cross reference `Punta e clicca-pg'. [9] [10] [11] [12]][2
[13] [14]][3
Overfull \hbox (16.31242pt too wide) in paragraph at lines 1312--1312
[]@texttt ### Nota che /$lilyprefix/bin/lilypond e uno script, che imposta la
variabile[]
[15] [16]
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/a3/lily-8a95f028-s
ystems.texi][4)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/1a/lily-c0a863c0-s
ystems.texi)][5][6 [17]][7][8
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/2e/lily-9b22173f-s
ystems.texi)][9
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/06/lily-77b293ac-s
ystems.texi)][10 [18]][11][12][13)][14
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.
texi
/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.t
exi:14: This command can appear only outside of any environment, not in environ
ment @raggedright.
@badenverr ...temp , not @inenvironment @thisenv }
@checkenv ...@ifx @thisenv @temp @else @badenverr
@fi
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
? ][15][16][17][18][19][20]
135850 bytes written
/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.t
exi:14: Emergency stop.
@badenverr ...temp , not @inenvironment @thisenv }
@checkenv ...@ifx @thisenv @temp @else @badenverr
@fi
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
Output written on usage.pdf (20 pages).
Transcript written on usage.log.
/usr/bin/texi2dvi: /var/home/fede/src/lilypond-intree/scripts/build/xetex-with-options.sh exited with bad status, quitting.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
Translation of GIT committish: 13d16834810d3223aa7793df89c0560b76938ffa
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
@c \version "2.21.0"
@node Aggiornare i file con convert-ly
@chapter Aggiornare i file con @command{convert-ly}
@translationof Updating files with convert-ly
@cindex aggiornare un file di LilyPond
@cindex convert-ly
Via via che LilyPond migliora, la sintassi (il linguaggio di input) di
alcuni comandi e funzioni può cambiare. Ciò può causare errori imprevisti,
avvisi e perfino output errato se i file di input, creati in precedenza per
versioni più vecchie, vengono usati con versioni più recenti.
Per superare questo problema, si può usare il comando @command{convert-ly} per
aggiornare questi file di input più vecchi alla nuova sintassi.
@menu
* Perché la sintassi cambia?::
* Utilizzo di convert-ly::
* Opzioni da linea di comando per convert-ly::
* Problemi nell'eseguire convert-ly::
* Conversioni manuali::
* Scrivere codice che funzioni su molteplici versioni::
@end menu
@node Perché la sintassi cambia?
@section Perché la sintassi cambia?
@translationof Why does the syntax change?
@cindex convert-ly
@cindex aggiornare i vecchi file di input
Le modifiche della sintassi di solito servono a rendere l'input più
facile sia da leggere che da scrivere e talvolta ad aggiungere a
LilyPond nuove funzionalità o miglioramenti di funzioni esistenti.
Ecco un esempio reale:
Tutti i nomi delle proprietà di @code{\paper} e @code{\layout} dovrebbero essere
scritte nella forma @code{primo-secondo-terzo}. Tuttavia, nella versione 2.11.60
è emerso che la proprietà @code{printallheaders} non seguiva questa convenzione.
Questa proprietà doveva essere lasciata così come era (confondendo i nuovi
utenti con un formato di input incoerente), o doveva essere cambiata
(disturbando i vecchi utenti con file di input già scritti)?
Fu deciso di cambiare il nome della proprietà in @code{print-all-headers}, e
tramite il comando @command{convert-ly} i vecchi utenti avevano a disposizione
uno strumento per aggiornare automaticamente i propri file di input.
Tuttavia il comando @command{convert-ly} non è sempre in grado di gestire tutti
i cambiamenti di sintassi. Nelle versioni di LilyPond precedenti la versione
2.4.2, gli accenti e i caratteri non inglesi venivano inseriti con la notazione
standard di LaTeX. Per esempio, per inserire la parola francese che significa
@q{Natale} si usava @code{No\"el}. Ma nelle versioni successive di LilyPond, il
carattere speciale @code{ë} deve essere inserito direttamente come carattere
UTF-8. Il comando @command{convert-ly} non può sostituire i caratteri speciali
di LaTeX con i rispettivi caratteri UTF-8, dunque è necessario aggiornare a mano
i vecchi file di input di LilyPond.
Le regole di conversione del comando @command{convert-ly} si basano sulla ricerca
e sostituzione di parole chiave (piuttosto che su una completa @q{comprensione}
del contesto di ciò che sta cambiando in un certo file di input). Ciò comporta
varie conseguenze:
@itemize @bullet
@item
L'affidabilità della conversione dipende dalla qualità di ciascun insieme
di regole applicate e dalla complessità del rispettivo cambiamento. Talvolta
le conversioni richiedono correzioni manuali ulteriori, quindi il file originale
deve essere conservato per poterlo confrontare in caso di necessità .
@item
Sono possibili solo conversioni ai cambi di sintassi più recenti: non ci
sono regole per tornare a una versione precedente di LilyPond. Dunque il file
di input deve essere aggiornato soltanto quando le versioni precedenti di
LilyPond non sono più mantenute. Di nuovo, il file di input originale deve
essere conservato per ogni evenienza, magari usando sistemi di controllo di
versione (es.: Git) per semplificare la gestione di versioni multiple dei
file di input.
@item
LilyPond ha delle robuste difese quando elabora spazi omessi o posizionati
in modo @q{originale}, ma le regole usate da @command{convert-ly} tendono spesso
a dare per scontato certe forme stilistiche. Seguire lo stile di input usato
nei manuali di LilyPond è dunque la via più sicura per aggiornamenti indolori,
soprattutto perché gli esempi dei manuali stessi sono tutti aggiornati col
comando @command{convert-ly}.
@end itemize
@node Utilizzo di convert-ly
@section Utilizzo di @command{convert-ly}
@translationof Invoking convert-ly
Il comando @command{convert-ly} usa il numero specificato da @code{\version} nel
file di input per determinare versioni precedenti. Nella maggior parte dei casi
per aggiornare il file di input è sufficiente eseguire:
@example
convert-ly -e miofile.ly
@end example
@noindent
nella directory che contiene il file di input. Questo comando aggiornerÃ
@file{miofile.ly} e preserverà il file originale rinominandolo
@file{miofile.ly~}. Verrà modificato anche il numero di @code{\version}
nel file di input aggiornato, insieme agli aggiornamenti di sintassi
richiesti.
Dopo averlo lanciato, il comando @command{convert-ly} elencherà i numeri di
versione per i quali sono state eseguite le conversioni. Se non vengono
elencati dei numeri di versione il file è già aggiornato e utilizza la sintassi
LilyPond più recente.
@warning{Per ogni nuova versione di LilyPond, viene creato un nuovo
@command{convert-ly}, ma non tutte le versioni di LilyPond necessitano
di cambi di sintassi per i propri file di input creati da una versione
precedente. Ciò significa che il comando @command{convert-ly} converterÃ
i file di input solo fino all'ultimo cambio di sintassi in suo possesso
e di conseguenza il numero di @code{\version} nel file di input aggiornato
è talvolta precedente alla versione del comando @command{convert-ly} stesso.}
Per convertire tutti i file di input in una directory si usa:
@example
convert-ly -e *.ly
@end example
Sia gli utenti Linux che MacOS@tie{}X possono usare le rispettive applicazioni
del terminale, ma gli utenti MacOS@tie{}X possono anche eseguire questo comando
direttamente dalla voce di menu @code{Compila > Aggiorna la sintassi}.
Un utente Windows deve eseguire il comando:
@example
convert-ly.py -e *.ly
@end example
@noindent
inserendolo in un @code{prompt dei comandi}, che di solito si trova in
@code{Start > Accessori > Prompt dei comandi} o, per gli utenti della
versione 8, scrivendo @q{prompt dei comandi} nella finestra di ricerca.
Per convertire tutti i file di input che si trovano in diverse sottodirectory:
@example
find . -name '*.ly' -exec convert-ly -e '@{@}' \;
@end example
Questo esempio cerca e converte tutti i file di input nella directory
corrente e in tutte le sue sottodirectory ricorsivamente. I file
convertiti saranno salvati nella stessa directory insieme all'originale
rinominato. Dovrebbe funzionare anche per gli utenti MacOS@tie{}X, anche
se solo tramite l'applicazione del terminale.
Gli utenti Windows devono usare:
@example
forfiles /s /M *.ly /c "cmd /c convert-ly.py -e @@file"
@end example
Altrimenti, si può indicare un percorso esplicito alla cartella che
contiene tutte le sottocartelle con i file di input tramite l'opzione
@code{/p}:
@example
forfiles /s /p C:\Documents\MyScores /M *.ly /c "cmd /c convert-ly.py -e @@file"
@end example
Tale percorso, se contiene spazi, deve essere racchiuso tra
virgolette doppie:
@example
forfiles /s /p "C:\Documents\My Scores" /M *.ly /c "cmd /c convert-ly.py -e @@file"
@end example
@node Opzioni da linea di comando per convert-ly
@section Opzioni da linea di comando per @command{convert-ly}
@translationof Command line options for convert-ly
Il programma viene lanciato in questo modo:
@example
convert-ly [@var{opzione}]@dots{} @var{nomefile}@dots{}
@end example
Esistono le seguenti opzioni:
@table @code
@item -d, --diff-version-update
aumenta il numero di versione in @code{\version} solo se il file è stato
modificato da @command{convert-ly}. In questo caso, la dichiarazione di
versione corrisponderà alla versione successiva all'ultimo reale cambiamento.
Il numero di una versione instabile sarà arrotondato al numero della versione
stabile successiva, a meno che ciò non vada oltre il numero di versione
obiettivo. Senza questa opzione, la versione rifletterà l'ultima
conversione @emph{tentata}.
@item -e, --edit
Applica le conversioni direttamente nel file di input, modificando
l'originale. Il file originale viene rinominato @file{nomefile.ly~}. Questo
file di backup può essere un file nascosto in alcuni sistemi operativi.
Altrimenti, se si desidera specificare un nome diverso per il file
aggiornato senza usare il predefinito @code{~} dell'opzione @code{-e}
appeso al vecchio file di input, si può usare la redirezione dell'output:
@example
convert-ly miofile.ly > mionuovofile.ly
@end example
Gli utenti Windows devono usare:
@example
convert-ly.py miofile.ly > mionuovofile.ly
@end example
@item -b, --backup-numbered
Se usato insieme all'opzione @samp{-e}, aggiunge un numero al nome dei file
di backup, in modo da non sovrascrivere i backup precedenti. I file di
backup possono essere nascosti in alcuni sistemi operativi.
@item -f, --from=@var{from-patchlevel}
Imposta la versione da cui convertire. Se non viene impostata, @command{convert-ly}
la ricaverà dalla stringa @code{\version} presente nel file.
Esempio: @option{--from=2.10.25}
@item -h, --help
Mostra la schermata di aiuto.
@item -l @var{loglevel}, --loglevel=@var{loglevel}
Imposta la verbosità dell'output su @var{loglevel}. I valori possibili, in
caratteri maiuscoli, sono @code{PROGRESS} (predefinito), @code{NONE},
@code{WARNING}, @code{ERROR} e @code{DEBUG}.
@item -n, --no-version
Normalmente @command{convert-ly} aggiunge un indicatore @code{\version}
nell'output. Questa opzione lo impedisce.
@item -s, --show-rules
Mostra tutte le conversioni conosciute ed esce.
@item -t, --to=@var{to-patchlevel}
Imposta esplicitamente la versione obiettivo della conversione, altrimenti
viene usato il valore più recente. Deve essere maggiore della versione iniziale.
@example
convert-ly --to=2.14.1 miofile.ly
@end example
@end table
Per aggiornare i frammenti LilyPond presenti nei file texinfo, si usa
@example
convert-ly --from=@dots{} --to=@dots{} --no-version *.itely
@end example
Per vedere i cambiamenti della sintassi di LilyPond tra due versioni, si usa
@example
convert-ly --from=@dots{} --to=@dots{} -s
@end example
@node Problemi nell'eseguire convert-ly
@section Problemi nell'eseguire @code{convert-ly}
@translationof Problems running convert-ly
Quando si esegue convert-ly in una finestra del Prompt dei comandi in Windows
su un file il cui nome o percorso contengano degli spazi,
è necessario includere tutto il nome del file di input con tre
(!) virgolette doppie:
@example
convert-ly """D:/Mie Partiture/Ode.ly""" > "D:/Mie Partiture/new Ode.ly"
@end example
Se il semplice comando @command{convert-ly -e *.ly} non funziona perché la
linea di comando espansa diventa troppo lunga, si può inserire il comando
@command{convert-ly} in un loop. Questo esempio per UNIX
aggiornerà tutti i file @file{.ly} nella directory corrente
@example
for f in *.ly; do convert-ly -e $f; done;
@end example
Nella finestra del Prompt dei comandi di Windows il comando corrispondente è
@example
for %x in (*.ly) do convert-ly -e """%x"""
@end example
Non vengono gestiti tutti i cambiamenti del linguaggio. Si può specificare solo
un'opzione di output. Ã piuttosto improbabile che si aggiornino automaticamente
il codice scheme e le interfacce di Scheme di LilyPond; tieniti pronto a
correggere a mano il codice Scheme.
@node Conversioni manuali
@section Conversioni manuali
@translationof Manual conversions
In teoria, un programma come @command{convert-ly} potrebbe gestire qualsiasi
cambiamento di sintassi. Dopo tutto, un programma per computer interpreta
la vecchia versione e la nuova versione, quindi un altro programma
può tradurre un file in un altro@footnote{O almeno questo è possibile
in qualsiasi file LilyPond che non contenga codice Scheme. Se c'è del
codice Scheme nel file, allora il file LilyPond contiene un linguaggio
Turing-completo, ed è possibile imbattersi in problemi col famigerato
@qq{Problema dell'arresto} in informatica.}.
Tuttavia il progetto LilyPond ha risorse limitate: non tutte le
conversioni sono compiute automaticamente. Di seguito è riportato l'elenco
dei problemi noti.
@verbatim
1.6->2.0:
Doesn't always convert figured bass correctly, specifically things like {<
>}. Mats' comment on working around this:
To be able to run convert-ly
on it, I first replaced all occurrences of '{<' to some dummy like '{#'
and similarly I replaced '>}' with '&}'. After the conversion, I could
then change back from '{ #' to '{ <' and from '& }' to '> }'.
Doesn't convert all text markup correctly. In the old markup syntax,
it was possible to group a number of markup commands together within
parentheses, e.g.
-#'((bold italic) "string")
This will incorrectly be converted into
-\markup{{\bold italic} "string"}
instead of the correct
-\markup{\bold \italic "string"}
2.0->2.2:
Doesn't handle \partCombine
Doesn't do \addlyrics => \lyricsto, this breaks some scores with multiple
stanzas.
2.0->2.4:
\magnify isn't changed to \fontsize.
- \magnify #m => \fontsize #f, where f = 6ln(m)/ln(2)
remove-tag isn't changed.
- \applyMusic #(remove-tag '. . .) => \keepWithTag #'. . .
first-page-number isn't changed.
- first-page-number no => print-first-page-number = ##f
Line breaks in header strings aren't converted.
- \\\\ as line break in \header strings => \markup \center-align <
"First Line" "Second Line" >
Crescendo and decrescendo terminators aren't converted.
- \rced => \!
- \rc => \!
2.2->2.4:
\turnOff (used in \set Staff.VoltaBracket = \turnOff) is not properly
converted.
2.4.2->2.5.9
\markup{ \center-align <{ ... }> } should be converted to:
\markup{ \center-align {\line { ... }} }
but now, \line is missing.
2.4->2.6
Special LaTeX characters such as $~$ in text are not converted to UTF8.
2.8
\score{} must now begin with a music expression. Anything else
(particularly \header{}) must come after the music.
@end verbatim
@node Scrivere codice che funzioni su molteplici versioni
@section Scrivere codice che funzioni su molteplici versioni
@translationof Writing code to support multiple versions
In alcuni casi, in particolare quando si scrive codice destinato a funzionare
come @emph{libreria}, è opportuno far sì che supporti molteplici versioni di
LilyPond nonostante le modifiche della sintassi. Per farlo si possono
avvolgere porzioni alternative di codice in espressioni condizionali che
dipendono dalla versione di LilyPond attualmente eseguita. La funzione
Scheme @code{ly:version?} prevede un operatore di confronto @var{op}
e una versione di riferimento @var{ver} passata come elenco di interi di
massimo tre elementi. Gli elementi mancanti vengono ignorati, quindi
@code{'(2 20)} equivale a @emph{qualsiasi} versione della serie di versioni
2.20. Sono possibili costrutti come il seguente:
@verbatim
#(cond
((ly:version? > '(2 20))
(ly:message "Questo è il codice da eseguire per LilyPond 2.20 o successivi"))
((ly:version? = '(2 19 57))
(ly:message "Questo verrà eseguito soltanto con LilyPond 2.19.57"))
(else (ly:message "Questo verrà eseguito con qualsiasi altra versione")))
@end verbatim
Solitamente questa funzione viene integrata nelle funzioni di una libreria,
per consentire l'uso di sintassi alternativa, ma è anche possibile usare il
confronto direttamente nell'input musicale, come nell'esempio seguente:
@verbatim
{
c' d' e' f'
#(if (ly:version? = '(2 21))
#{ \override NoteHead.color = #red #}
#{ \override NoteHead.color = #blue #})
g' a' b' c''
}
@end verbatim
@strong{Nota:} Questa funzione è stata introdotta in LilyPond 2.21.80, dunque
non è possibile fare confronti usando versioni precedenti.
Command: cd out-www/it/; texi2pdf --batch -I ../ -I /var/home/fede/src/lilypond-intree/Documentation/it -I /var/home/fede/src/lilypond-intree/Documentation -I /var/home/fede/src/lilypond-intree/Documentation/en/ -o /var/home/fede/src/lilypond-intree/Documentation/./out-www/it/usage.tmp.pdf /var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.texi < /dev/null
This is XeTeX, Version 3.141592653-2.6-0.999993 (TeX Live 2021) (preloaded format=xetex)
restricted \write18 enabled.
entering extended mode
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.texi
(/var/home/fede/src/lilypond-intree/tex/texinfo.tex
Loading texinfo [version 2021-09-26.10]: pdf, fonts, glyphs, page headings,
tables, conditionals, indexing, sectioning, toc, environments, defuns, macros,
cross references, insertions,
(/usr/share/texlive/texmf-dist/tex/generic/epsf/epsf.tex
This is `epsf.tex' v2.7.4 <14 February 2011>
) localization, formatting, and turning on texinfo input format.)
(/var/home/fede/src/lilypond-intree/tex/txi-it.tex no patterns for italian)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/macros.texi
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/version.texi)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/en/common-macros.t
exi
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/en/cyrillic.texi))
)
Writing index file usage.cp
[1] (/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.toc)
[-1] (/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.toc)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/running.t
exi Capitolo 1
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/usage.aux)
[1] [2] [3]
xdvipdfmx:warning: Found a mismatched fontmap line 6170 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpcxbsl default rpcxb -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6171 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpcxsl default rpcxr -s 0.167
xdvipdfmx:warning: [4Found a mismatched fontmap line 6172 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxbsl default rpxb -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6173 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplb tx8r.enc uplb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6174 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplbi tx8r.enc uplbi8a
xdvipdfmx:warning: Found a mismatched fontmap line 6175 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplbo tx8r.enc uplb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6176 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplr tx8r.enc uplr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6177 from pdftex.map.
xdvipdfmx:warning: ]-- Ignore the current input buffer: rpxpplri tx8r.enc uplri8a
xdvipdfmx:warning: Found a mismatched fontmap line 6178 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxpplro tx8r.enc uplr8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6179 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rpxsl default rpxr -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6878 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvb tx8r.enc uhvb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6879 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvbo tx8r.enc uhvb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6880 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvr tx8r.enc uhvr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6881 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxphvro tx8r.enc uhvr8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6882 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmb tx8r.enc utmb8a
xdvipdfmx:warning: Found a mismatched fontmap line 6883 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmbi tx8r.enc utmbi8a
xdvipdfmx:warning: Found a mismatched fontmap line 6884 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmbo tx8r.enc utmb8a -s 0.167
xdvipdfmx:warning: Found a mismatched fontmap line 6885 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmr tx8r.enc utmr8a
xdvipdfmx:warning: Found a mismatched fontmap line 6886 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmri tx8r.enc utmri8a
xdvipdfmx:warning: Found a mismatched fontmap line 6887 from pdftex.map.
xdvipdfmx:warning: -- Ignore the current input buffer: rtxptmro tx8r.enc utmr8a -s 0.167
stdin -> usage.pdf
[5] [6] [7] [8][1
l.823: Undefined cross reference `Punta e clicca-snt'.
l.823: Undefined cross reference `Punta e clicca-snt'.
l.823: Undefined cross reference `Punta e clicca-title'.
l.823: Undefined cross reference `Punta e clicca-pg'. [9] [10] [11] [12]][2
[13] [14]][3
Overfull \hbox (16.31242pt too wide) in paragraph at lines 1312--1312
[]@texttt ### Nota che /$lilyprefix/bin/lilypond e uno script, che imposta la
variabile[]
[15] [16]
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/a3/lily-8a95f028-s
ystems.texi][4)
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/1a/lily-c0a863c0-s
ystems.texi)][5][6 [17]][7][8
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/2e/lily-9b22173f-s
ystems.texi)][9
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/06/lily-77b293ac-s
ystems.texi)][10 [18]][11][12][13)][14
(/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.
texi
/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.t
exi:14: This command can appear only outside of any environment, not in environ
ment @raggedright.
@badenverr ...temp , not @inenvironment @thisenv }
@checkenv ...@ifx @thisenv @temp @else @badenverr
@fi
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
? ][15][16][17][18][19][20]
135850 bytes written
/var/home/fede/src/lilypond-intree/Documentation/out-www/it/it/usage/updating.t
exi:14: Emergency stop.
@badenverr ...temp , not @inenvironment @thisenv }
@checkenv ...@ifx @thisenv @temp @else @badenverr
@fi
@\node #1->@checkenv {}
@donode #1 ,@finishnodeparse
l.14 @node Aggiornare i file con convert-ly
Output written on usage.pdf (20 pages).
Transcript written on usage.log.
/usr/bin/texi2dvi: /var/home/fede/src/lilypond-intree/scripts/build/xetex-with-options.sh exited with bad status, quitting.
