]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/usage/running.itely
Doc-fr: updates NR, AU and web
[lilypond.git] / Documentation / fr / usage / running.itely
index cdfe4f3e8b2c2a6ca1974daa2aed8abe79c824cd..6d1d3365f3db519a1ce9ffeb134788abe91ccdb2 100644 (file)
@@ -1,11 +1,11 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: d1eb959d5c774b5b81bf74436350efa5976498af
+   Translation of GIT committish: 2034ca4fcbed9253b5a85e9360e47d3fe3ff1d09
 
-    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..
+   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.17.6"
@@ -15,7 +15,7 @@
 
 @node Exécution de lilypond
 @chapter Exécution de @command{lilypond}
-@translationof Running lilyPond
+@translationof Running lilypond
 
 Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond.
 
@@ -47,11 +47,11 @@ certaines options particulières.  D'autre part, certains utilitaires
 associés, tel que @code{midi2ly}, ne sont disponibles qu'en ligne de
 commande.
 
-Par @qq{ligne de commande}, nous entendons l'interface de commande du
+Par « ligne de commande », nous entendons l'interface de commande du
 système.  Les utilisateurs de Windows seront certainement plus familiers
-des termes @qq{fenêtre DOS} ou @qq{invite de commande}.  Quant aux
+des termes « fenêtre DOS » ou « invite de commande ».  Quant aux
 utilisateurs de MacOS X, ils connaissent assurément les termes
-@qq{console} et @qq{terminal}.  Les paramétrages spécifiques au système
+« console » et « terminal ».  Les paramétrages spécifiques au système
 MacOS font l'objet d'un @rwebnamed{MacOS X,chapitre particulier}.
 
 Notre propos n'est pas ici d'expliquer ce qu'est l'interface de
@@ -60,7 +60,7 @@ Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux
 nombreuses documentations que vous pourrez trouver sur ce sujet.
 
 @menu
-* Lancement de lilypond::
+* Lancement de LilyPond::
 * Options basiques de lilypond::
 * Options avancées de lilypond::
 * Variables d'environnement::
@@ -68,9 +68,9 @@ nombreuses documentations que vous pourrez trouver sur ce sujet.
 @end menu
 
 
-@node Lancement de lilypond
-@unnumberedsubsec Lancement de @command{lilypond}
-@translationof Invoking lilypond
+@node Lancement de LilyPond
+@unnumberedsubsec Lancement de LilyPond
+@translationof Invoking LilyPond
 
 L'exécutable @command{lilypond} en ligne de commande se lance ainsi :
 
@@ -108,32 +108,80 @@ fournira grâce à LilyPond @file{@var{racine}-violon.pdf} et
 @file{@var{racine}-cello-1.pdf}.
 
 
-@unnumberedsubsubsec Commandes standard de l'interpréteur
-@translationof Standard shell commands
+@unnumberedsubsubsec Utilisation de LilyPond avec les fonctionnalités standard de l'interpréteur
+@translationof Using LilyPond with standard shell features
 
-Si votre interpréteur -- terminal, console, etc. -- prend en charge les
-redirections, les commandes qui suivent vous permettront de
-judicieusement rediriger les affichages de la console dans un
-fichier :
+Dans la mesure où LilyPond est une application qui fonctionne en ligne
+de commande, les fonctionnalités de l'interpréteur utilisé pour lancer
+LilyPond peuvent se révéler utiles.
 
-@itemize
+Par exemple,
 
-@item
-@code{lilypond fichier.ly 1>stdout.log} pour le verbiage normal
+@example
+lilypond *.ly
+@end example
 
-@item
-@code{lilypond fichier.ly 2>stderr.log} pour les messages d'erreur
+@noindent
+traitera tous les fichiers LilyPond présents dans le répertoire en
+cours.
 
-@item
-@code{lilypond fichier.ly &>tous.log} pour garder une trace de tout ce
-qui s'est passé
+Rediriger, par exemple dans un fichier, ce qui est émis à l'écran peut
+s'avérer utile.
 
-@end itemize
+@example
+lilypond fichier.ly 1> stdout.log
+
+lilypond fichier.ly 2> stderr.log
+
+lilypond fichier.ly &> tous.log
+@end example
+
+@noindent
+redirigeront respectivement le « verbiage normal », les erreurs ou tout,
+dans un fichier texte.
 
 Consultez avant tout la documentation de votre interpréteur habituel
-pour vérifier qu'il prend en charge ces options dans cette syntaxe.
-Notez bien qu'il s'agit ici de commandes internes à l'interpréteur et
-qui n'ont rien à voir avec LilyPond.
+-- terminal, console, etc. -- pour vérifier qu'il prend en charge les
+options dans cette syntaxe.
+
+Voici comment traiter un jeu de fichiers répartis dans un répertoire
+donné ainsi que tous ses différents sous-répertoires.  Les fichiers
+résultants seront regroupés dans le répertoire à partir duquel la
+commande a été exécutée, non selon l'emplacement des fichiers sources.
+
+@example
+find . -name '*.ly' -exec lilypond '@{@}' \;
+@end example
+
+@noindent
+Cette commande, bien qu'effective uniquement dans un terminal, devrait
+être fonctionnelle aussi pour les utilisateurs de MacOS X.
+
+Les utilisateurs de windows utiliseront l'instruction
+
+@example
+forfiles /s /M *.ly /c "cmd /c lilypond @@file"
+@end example
+
+@noindent
+dans l'@code{interpréteur de commandes}, qui se trouve normalement sous
+@code{Démarrer > Accessoires > Interpréteur de commandes} ou, pour la
+version 8, en faisant une recherche sur « interpréteur de commande ».
+
+Par ailleurs, il est possible de spécifier de manière explicite le chemin
+d'accès au dossier comportant des sous-répertoires où se trouvent les
+fichiers sources, à l'aide de l'option @code{/p} :
+
+@example
+forfiles /s /p C:\Documents\MesPartitions /M *.ly /c "cmd /c lilypond @@file"
+@end example
+
+Dans le cas où ce chemin d'accès comporte des espaces, l'intégralité de
+ce chemin devra être borné par des guillemets informatiques :
+
+@example
+forfiles /s /p "C:\Documents\Mes Partitions" /M *.ly /c "cmd /c lilypond @@file"
+@end example
 
 
 @node Options basiques de lilypond
@@ -150,12 +198,41 @@ Différentes options sont disponibles en ligne de commande :
 
 @table @code
 
-@item -d,--define-default=@var{variable}=@var{valeur}
+@item -b, --bigpdfs
+@cindex bigpdfs
+
+Les fichiers PDF générés peuvent être beaucoup plus lourd que la normale
+selon le degré d'optimisation des fontes.  Néanmoins, lorsque plusieurs
+fichiers PDF sont inclus dans un document @code{pdftex}, @code{xetex} ou
+@code{luatex}, ils peuvent faire l'objet d'un traitement supplémentaire
+par @code{ghostscript} afin de fusionner les données de fontes
+redondantes et ainsi obtenir un fichier PDF @emph{significativement}
+plus léger.
+
+@example
+lilypond -b monfichier
+@end example
+
+Puis lancer @code{ghostscript} :
+
+@example
+gs -q -sDEVICE=pdfwrite -o gsout.pdf monfichier.pdf
+@end example
+
+@code{pdfsizeopt.py} vient alors en complément pour optimiser encore la
+taille du fichier :
+
+@example
+pdfsizeopt.py --use-multivalent=no gsout.pdf final.pdf
+@end example
+
+
+@item -d, --define-default=@var{variable}=@var{valeur}
 Voir @ref{Options avancées de lilypond}.
 
 @cindex Scheme, évaluation d'expression
 @cindex expression Scheme, évaluation
-@item -e,--evaluate=@var{expr}
+@item -e, --evaluate=@var{expr}
 Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
 @file{.ly}.  Lorsque vous spécifiez l'option @option{-e} à plusieurs
 reprises, l'évaluation sera faite en séquence.
@@ -184,25 +261,29 @@ doubles @code{"} en lieu et place des guillemets simples @code{'}.}
 
 @cindex sortie, format
 @cindex format de sortie
-@item -f,--format=@var{format}
+@item -f, --format=@var{format}
 Détermine le format à produire.  Il peut s'agir de @code{ps}, @code{pdf}
 ou @code{png}.
 
-Exemple : @code{lilypond -fpng @var{monfichier}.ly}
+Exemple : @code{lilypond -fpng @var{monfichier}.ly}
+
+@noindent
+Les formats @code{svg} et @code{eps} s'obtiennent à l'aide de
+l'option @code{-dbackend} -- voir @ref{Options avancées de lilypond}.
 
-@item -h,--help
+@item -h, --help
 Affiche un résumé des commandes.
 
-@item -H,--header=@var{CHAMP}
+@item -H, --header=@var{CHAMP}
 Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
 
-@item -i,--init=@var{fichier}
+@item -i, --init=@var{fichier}
 Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
 d'initialisation.
 
 @cindex recherche de fichier
 @cindex chemin de recherche
-@item -I,--include=@var{répertoire}
+@item -I, --include=@var{répertoire}
 Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
 
 Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
@@ -211,7 +292,7 @@ fichier en question ne s'y trouve pas, les répertoires suivants seront
 examinés l'un après l'autre.
 
 @cindex chroot jail, fonctionnement
-@item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
+@item -j, --jail=@var{user},@var{group},@var{jail},@var{dir}
 Lance @command{lilypond} dans un environnement protégé.
 
 L'option @option{--jail} est une alternative qui offre plus de
@@ -279,7 +360,7 @@ mémoire.  Voir aussi @ref{Exécution de LilyPond en mode protégé}.
 
 @cindex loglevel
 @cindex verbosité, définir le degré de
-@item -l,--loglevel=@var{DEGRÉ}
+@item -l, --loglevel=@var{DEGRÉ}
 Règle le niveau de verbosité des messages console à @var{DEGRÉ}.  Les
 différentes valeurs sont :
 
@@ -314,7 +395,7 @@ Tout ce qui peut être affiché, y compris le verbiage utile au débogage.
 @cindex redirection
 @cindex répertoire de destination
 @cindex fichier de destination
-@item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
+@item -o, --output=@var{FICHIER} ou @var{RÉPERTOIRE}
 Détermine le nom par défaut du fichier résultant à @var{FICHIER} ;
 lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
 existant, c'est là que les fichiers résultants seront déposés.  Le
@@ -341,14 +422,14 @@ se régler en ajoutant par exemple
 @item --pdf
 Génère du PDF.  Ceci sous-entend l'utilisation de @option{--ps}.
 
-@item -v,--version
+@item -v, --version
 Affiche le numéro de version.
 
-@item -V,--verbose
+@item -V, --verbose
 Active le mode verbeux : affichage de l'intégralité du chemin
 d'accès de chaque fichier, et information des temps de traitement.
 
-@item -w,--warranty
+@item -w, --warranty
 Affiche les informations de garantie applicables à GNU LilyPond -- il
 est livré @strong{SANS GARANTIE} !
 
@@ -361,9 +442,10 @@ est livré @strong{SANS GARANTIE} !
 
 @table @code
 
-@item -d@var{[nom-option]}=@var{[valeur]},--define-default=@var{[nom-option]}=@var{[valeur]}
+@item -d@var{[nom-option]}=@var{[valeur]},
+--define-default=@var{[nom-option]}=@var{[valeur]}
 Affecte la valeur Scheme @var{valeur} à l'option interne
-@var{nom-option} du programme.
+@var{nom-option} du programme, comme par exemple
 
 @example
 -dbackend=svg
@@ -399,7 +481,7 @@ valeur par défaut.
 @item @code{anti-alias-factor}
 @tab @code{1}
 @tab Adopte une résolution supérieure (selon le facteur donné),puis
-réduit au niveau du résultat afin d'éviter les @qq{distorsions} des
+réduit au niveau du résultat afin d'éviter les « distorsions » des
 images @code{PNG}.
 
 @item @code{aux-files}
@@ -428,29 +510,58 @@ utilise par défaut.
 @tab Ne génère aucun fichier imprimable.  Cette option est équivalente à
 @code{-dno-print-pages}.
 
-@item
-@tab @code{svg}
-@tab Génère du@emph{Scalable Vector Graphics}.  Cette option permet de
-créer un fichier @code{SVG} par page, sans incorporation des fontes.
-Nous vous recommandons d'installer les fontes Century Schoolbook
-comprises dans le paquetage LilyPond afin d'obtenir le meilleur rendu
-possible.  Sous UNIX, il suffit de les recopier, à partir du répertoire
-@file{/usr/share/lilypond/VERSION/fonts/otf/}, dans @file{~/.fonts/}.
-Les fichiers @code{SVG} alors générés devraient être lisibles par votre
-éditeur SVG habituel.  L'option @code{svg-woff} -- voir ci-après --
-permet d'utiliser les fontes @code{woff} avec le moteur @code{SVG}.
-
 @item
 @tab @code{scm}
 @tab Recopie littéralement les commandes Scheme internes de formatage.
 
+@item
+@tab @code{svg}
+@tab Génère du @emph{Scalable Vector Graphics}.  Cette option permet de
+créer un fichier SVG par page.  Les glyphes musicaux sont codés en tant
+que graphiques vectoriels mais les fontes textuelles @b{ne sont pas}
+incorporées aux fichiers @file{SVG} résultants.  Quel que soit le
+programme utilisé pour visionner ces fichiers, il devra avoir accès aux
+fontes en question pour pouvoir afficher correctement les textes et
+paroles.  Il est préférable de ne pas recourir aux « alias de police »
+ni aux listes de fontes si la visionneuse de fichier SVG ne peut le
+traîter correctement.  L'option supplémentaire @code{--svg-woff} -- voir
+ci-après -- permet d'utiliser les fontes WOFF (@emph{Web Open Font
+Format}) avec le moteur SVG.
+@end multitable
+
+@noindent
+@strong{Note à propos des sorties SVG :}
+Par défaut, LilyPond utilise des valeurs de @code{font-family}
+génériques -- @code{Serif}, @code{Sans Serif} et @code{Monospace}.  Le
+recours au moteur @code{svg} requiert donc que ces polices par défaut
+soient explicitement définies dans le fichier source :
+
+@quotation
+@verbatim
+\paper  {
+  #(define fonts
+    (make-pango-font-tree "TeX Gyre Schola"
+                          "TeX Gyre Heros"
+                          "TeX Gyre Cursor"
+                          (/ staff-height pt 20)))
+}
+@end verbatim
+@end quotation
+
+Voir aussi @ruser{Choix des fontes par défaut}.
+
+@multitable @columnfractions .33 .16 .51
 @item @code{check-internal-types}
 @tab @code{#f}
 @tab Vérifie qu'à chaque propriété est bien affecté un type.
 
 @item @code{clip-systems}
 @tab @code{#f}
-@tab Génère des typons à partir d'une partition.
+@tab Extrait des fragments musicaux d'une partition.  Ceci requiert que
+la fonction @code{clip-regions} a été définie au sein du bloc
+@code{\layout} -- voir @ruser{Extraction de fragments musicaux}.  Bien
+entendu, aucun fragment ne sera extrait si l'on utilise l'option
+@option{-dno-print-pages}
 
 @item @code{datadir}
 @tab
@@ -506,6 +617,10 @@ pour chaque fichier.
 @tab Génère une copie des signatures de chaque système.  Cette option
 est utilisée pour les tests de régression.
 
+@item @code{embed-source-code}
+@tab @code{#f}
+@tab Intègre les fichiers source LilyPond au document PDF généré.
+
 @item @code{eps-box-padding}
 @tab @code{#f}
 @tab Décale le bord gauche du typon EPS d'une valeur donnée en
@@ -578,11 +693,6 @@ donnée en argument.
 @tab Convertit les chaînes textuelles en chemins lorsque les glyphes
 font partie d'une fonte musicale.
 
-@item @code{old-relative}
-@tab @code{#f}
-@tab Affecte au mode @code{\relative} le même comportement pour de la
-musique simultanée que celui d'une syntaxe d'accords.
-
 @cindex paper-size, ligne de commande
 @item @code{paper-size}
 @tab @code{\"a4\"}
@@ -596,8 +706,8 @@ d'encadrer la valeur par des guillemets échappés (@code{\"}).
 Ghostscript.
 
 @item @code{point-and-click}
-@tab @code{#f}
-@tab Ajoute les liens @qq{point & click} à la sortie @code{PDF}.  Voir
+@tab @code{#t}
+@tab Ajoute les liens « point & click » à la sortie PDF ou SVG.  Voir
 @ref{Pointer-cliquer}.
 
 @cindex format de sortie, définition
@@ -668,9 +778,9 @@ quelque chose du style
 
 @quotation
 @verbatim
-#(system "rm -rf /")
+#(s ystem "rm -rf /") % trop dangeureux à écrire sans faute
 {
-  c4^$(ly:gulp-file "/etc/passwd")
+  c4^$(ly:gulp-file "/etc/passwd") % malveillant mais pas destructeur
 }
 @end verbatim
 @end quotation
@@ -720,9 +830,34 @@ flottante @code{Inf} ou @code{NaN} -- infini ou non-nombre.
 @tab Supprime, lors du nommage des fichiers résultant, la partie
 correspondant au répertoire des fichiers sources.
 
+@item @code{strokeadjust}
+@tab @code{#f}
+@tab Force l'ajustement des traits PostScript.  Cette option trouve
+toute son utilité pour générer du PDF à partir de PostScript --
+l'ajustement des traits est en principe automatiquement activé pour les
+périphériques bitmap à faible résolution.  Sans cette option, les
+visionneurs de PDF ont tendance à ne pas rendre de manière constante
+l'épaisseur des hampes dans les résolutions habituelles des écrans.
+Bien que n'affectant pas notoirement la qualité d'impression, cette
+option accroit notablement la taille des fichiers PDF.
+
 @item @code{svg-woff}
 @tab @code{#f}
-@tab Utilise, avec le moteur SVG, les fontes @code{woff}.
+@tab Cette option est obligatoire dès lors que sont utilisées, avec le
+moteur SVG, les fontes @emph{Web Open Font Format} (WOFF).  Un fichier
+SVG sera généré pour chacune des pages produites.  En dehors des glyphes
+musicaux propres à LilyPond, aucune autre information ne sera incluse.
+Quelque soir le visionneur de SVG utilisé, il devra avoir à disposition
+les fontes requises pour pouvoir afficher les éléments textuels et les
+paroles.  Dans la mesure où le visionneur pourrait ne pas savoir le
+gérer, mieux vaut s'abstenir derecourir aux alias ou listes de fontes.
+
+
+Lorsque celles-ci sont utilisées correctement, nul n'est besoin
+d'installer les fontes que les fichiers SVG utiliseront dans
+l'environnement du visionneur.  Néanmoins, LilyPond ne dispose pas de
+fichier de fonte @code{woff} textuelle.  La présence du fichier de fonte
+@code{woff} est un prérequis.
 
 @item @code{trace-memory-frequency}
 @tab @code{#f}
@@ -741,8 +876,8 @@ journalisation @code{DEBUG} (lecture seule).
 
 @item @code{warning-as-error}
 @tab @code{#f}
-@tab Considère tous les messages d'avertissement et @qq{erreur de
-programmation} comme étant de véritables erreurs.
+@tab Considère tous les messages d'avertissement et « erreur de
+programmation » comme étant de véritables erreurs.
 @end multitable
 
 
@@ -818,7 +953,7 @@ dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
 
 @noindent
 Cette commande a créé un fichier de 200 MB utilisable par le
-@qq{système protégé}.
+« système protégé ».
 
 @item Création d'un pseudo-périphérique, génération d'un système de
 fichiers et chargement de celui-ci, puis création d'un répertoire
@@ -989,6 +1124,15 @@ rencontre quelque chose d'inattendu.  Lorsque la ligne indiquée ne vous
 semble pas comporter d'élément litigieux, remontez de quelques lignes
 dans votre code.
 
+Par ailleurs, des diagnostics peuvent être déclenchés à n'importe quel
+moment au cours des différentes étapes du traitement.  Par exemple,
+lorsque certaines parties de la source sont traitées plusieurs fois --
+sortie MIDI et sortie imprimable -- ou qu'une même variable musicale est
+utilisée dans plusieurs contextes, peut apparaître le même message à
+plusieurs reprises.  Les diagnostics effectués à une étape avancée du
+traitement, tels que les contrôles de mesure, sont aussi susceptibles
+d'apparaître plusieurs fois.
+
 Vous trouverez d'autres informations sur les erreurs au chapitre
 @ref{Quelques erreurs des plus courantes}.
 
@@ -1008,6 +1152,8 @@ facilement.
 * Message d'erreur Unbound variable %::
 * Message d'erreur FT_Get_Glyph_Name::
 * staff-affinities devraient aller en ordre décroissant::
+* Message d'erreur unexpected new::
+* Cette voix requiert un voiceXx ou un réglage shiftXx::
 @end menu
 
 
@@ -1050,14 +1196,14 @@ s'appliquer au contexte en cours.  Pour des partitions simples, le fait
 que les contextes soient automatiquement créés rend bien des services,
 et c'est d'ailleurs le cas pour la majorité des exemples contenus dans
 les manuels de LilyPond.  Cependant, la création implicite d'un contexte
-peut aboutir à l'apparition d'une portée @qq{parasite}.  On s'attend par
+peut aboutir à l'apparition d'une portée « parasite ».  On s'attend par
 exemple, en lisant le code qui suit, à ce que toutes les têtes de note
 soient en rouge, alors que le résultat nous présente deux portées et que
 les notes, placées sur la portée inférieure, restent en noir.
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim,fragment]
 \override Staff.NoteHead.color = #red
-\new Staff { a }
+\new Staff { a' }
 @end lilypond
 
 Étant donné qu'aucun contexte @code{Staff} n'existe lorsque la
@@ -1067,33 +1213,10 @@ appliquer la directive considérée.  Survient alors la commande
 contenir les notes qui suivent.  Voici la syntaxe correcte pour obtenir
 ces notes en rouge :
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
 \new Staff {
   \override Staff.NoteHead.color = #red
-  a
-}
-@end lilypond
-
-Autre exemple : la présence d'une commande @code{\relative} à
-l'intérieur d'une section @code{\repeat} générera obligatoirement une
-portée intempestive.  Cela tient au fait que la commande @code{\repeat}
-va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
-implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
-
-@lilypond[quote,verbatim]
-\repeat unfold 2 {
-  \relative c' { c4 d e f }
-}
-@end lilypond
-
-La manière adéquate de procéder consiste à inverser les commandes
-@code{\repeat} et @code{\relative}, comme ceci :
-
-@lilypond[quote,verbatim]
-\new Voice {
-  \repeat unfold 2 {
-    \relative c' { c4 d e f }
-  }
+  a'
 }
 @end lilypond
 
@@ -1103,8 +1226,8 @@ La manière adéquate de procéder consiste à inverser les commandes
 @translationof Error message Unbound variable %
 
 Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
-fichier journal, est associé à un message du type @qq{GUILE a signalé
-une erreur@dots{}}. Il survient à chaque fois qu'un commentaire
+fichier journal, est associé à un message du type « GUILE a signalé
+une erreur@dots{} ». Il survient à chaque fois qu'un commentaire
 @emph{LilyPond} est indûment placé dans une routine @emph{Scheme}.
 
 Un commentaire LilyPond est introduit par le signe pourcent (@code{%})
@@ -1141,3 +1264,95 @@ une portée, à l'aide de l'instruction
 que vous insérerez dès sa création.  Pour plus d'information,
 reportez-vous à la rubrique
 @ruser{Espacement des lignes rattachées à des portées}.
+
+
+@node Message d'erreur unexpected new
+@unnumberedsubsec Message d'erreur unexpected @code{@bs{}new}
+@translationof Error message unexpected new
+
+Un bloc @code{\score} ne peut contenir qu'@strong{une seule} expression
+musicale. Si, par contre, il comporte plusieurs @code{\new Staff},
+@code{\new StaffGroup} ou autres contextes introduits par une commande
+@code{\new} qui ne seraient pas bornés par des accolades
+@code{@{ @dots{} @}} ou des doubles chevrons @code{<< @dots{} >>} comme
+ici :
+
+@example
+\score @{
+  % Invalide ! Génère l'erreur : syntax error, unexpected \new
+  % en français : erreur de syntaxe : \new inattendu
+  \new Staff @{ @dots{} @}
+  \new Staff @{ @dots{} @}
+@}
+@end example
+
+@noindent
+vous obtiendrez ce message d'erreur.
+
+Cette erreur sera évitée dès lors que toutes les instances de
+@code{\new} sont bornées par des accolades ou des doubles chevrons.
+
+Des accolades placeront ces clauses @code{\new} en séquence :
+
+@lilypond[quote,verbatim]
+\score {
+  {
+    \new Staff { a' a' a' a' }
+    \new Staff { g' g' g' g' }
+  }
+}
+@end lilypond
+
+@noindent
+alors que des doubles chevrons les placeront en parallèle ; autrement
+dit, LilyPond les traitera simultanément :
+
+@lilypond[quote,verbatim]
+\score {
+  <<
+    \new Staff { a' a' a' a' }
+    \new Staff { g' g' g' g' }
+  >>
+}
+@end lilypond
+
+
+@node Cette voix requiert un voiceXx ou un réglage shiftXx
+@unnumberedsubsec Cette voix requiert un @code{@bs{}voiceXx} ou un réglage @code{@bs{}shiftXx}
+@translationof Warning this voice needs a voiceXx or shiftXx setting
+
+Lorsque des notes affectées à des voix différentes et ayant la même
+orientation de hampe interviennent au même instant musical et qu'aucun
+décalage spécifique à la voix n'a été spécifié, LilyPond émet
+@code{Avertissement : Cette voix requiert un voiceXx ou un réglage
+shiftXx} (@emph{warning: this voice needs a \voiceXx or \shiftXx
+setting}).  Cet avertissement est émis même lorsque ces notes n'ont pas
+de hampe visible, comme par exemple des rondes, si les hampes des durées
+inférieures à ces même hauteurs avaient la même orientation.
+
+N'oublions pas que l'orientation des hampes dépend de la position des
+notes sur la portée à moins que cette orientation n'ait été spécifiée,
+par exemple à l'aide d'un @code{\voiceOne} ou autre clause.  En pareil
+cas, l'avertissement ne sera émis que lorsque les hampes auront la même
+orientation, autrement dit lorsque les notes seront dans la même moitié
+de la portée.
+
+Le fait de placer les notes dans des voix auxquelles sont attachés
+orientation de hampe et décalage, comme @code{\voiceOne} ou autre, peut
+permettre d'éviter ces avertissements.
+
+Les notes se trouvant dans des voix au numéro plus élévé --
+@code{\voiceThree} ou @code{\voiceFour} -- sont automatiquement décalées
+pour éviter que les empilements se chevauchent.  Ceci aura pour résultat
+de visuellement décaler les notes affublées de hampe sans toutefois
+bouger les rondes, hormis dans le cas d'un réel chevauchement ou lorsque
+ces voix se croisent (@code{\voiceThree} au dessus de@code{\voiceOne}).
+
+@seealso
+Manuel d'initiation :
+@rlearning{Instanciation explicite des voix},
+@rlearning{Exemple concret}.
+
+Manuel de notation :
+@ruser{Polyphonie sur une portée},
+@ruser{Résolution des collisions}.