@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 6ee1c53e30a461d9b36fe5045e23815a57e1e819
+ Translation of GIT committish: 0bc0ff1a281477487016b052eb699ebbd685d3e0
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c \version "2.12.0"
@c Translators: Jean-Charles Malahieude
-@c Translation checkers:
+@c Translation checkers:
@node Exécution de LilyPond
@chapter Exécution de @command{lilypond}
@translationof Running LilyPond
-@untranslated
-
+Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond.
@menu
* Utilisation habituelle::
@section Utilisation habituelle
@translationof Normal usage
-@untranslated
+La plupart des utilisateurs de LilyPond le font au travers d'une
+interface graphique (@emph{GUI} pour @emph{graphical user interface}).
+Si vous ne l'avez pas encore parcouru, lisez le @rlearning{Tutoriel}.
+Si vous utilisez un éditeur alternatif pour rédiger vos fichiers
+LilyPond, référez-vous à la documentation de celui-ci.
@node Utilisation en ligne de commande
@section Utilisation en ligne de commande
@translationof Command-line usage
-@untranslated
+Nous nous intéresserons ici aux spécificités de LilyPond employé en
+ligne de commande. La ligne de commande permet de faire appel à
+certaines options particulières. D'autre part, certains utilitaires
+associés, tels que @code{midi2ly}, ne sont disponibles qu'en ligne de
+commande.
+
+Par @qq{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
+utilisateurs de MacOS@tie{}X, ils connaissent assurément les termes
+@qq{console} et @qq{terminal}. Les paramétrages spécifiques au système
+MacOS sont abordés au chapitre @rweb{MacOS X}.
+
+Notre propos n'est pas ici d'expliquer ce qu'est l'interface de
+commande pour un système informatique ni comment elle fonctionne.
+Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux
+nombreuses documentations que vous pourrez trouver sur ce sujet.
@menu
@unnumberedsubsec Lancement de @command{lilypond}
@translationof Invoking lilypond
-@untranslated
+L'exécutable @command{lilypond} en ligne de commande se lance
+ainsi@tie{}:
+
+@example
+lilypond [@var{option}]@dots{} @var{fichier}@dots{}
+@end example
+
+Lorsque le fichier est fourni sans extension, LilyPond présume qu'il
+s'agit de @file{.ly}. Pour interpréter directement l'entrée standard
+(@emph{stdin}), fournissez un tiret (@code{-}) en lieu et place de
+@var{fichier}.
+
+Le traitement de @file{monfichier.ly} produira @file{monfichier.ps} et
+@file{monfichier.pdf}. Vous pouvez spécifier plusieurs fichiers à la
+fois@tie{}; ils seront traités indépendamment les uns des
+autres.@footnote{Le statut de GUILE n'étant pas réinitialisé après
+traitement d'un fichier @code{.ly}, veillez à ne pas modifier les
+réglages par défaut du système à partir d'assertions en Scheme.}
+
+Lorsque @file{monfichier.ly} contient plus d'une section @code{\book},
+les fichiers produits -- à partir du deuxième -- seront numérotés. Par
+ailleurs, la valeur affectée à @code{output-suffix} sera insérée entre la
+racine et le numéro. Par exemple, un fichier @var{racine} qui
+contiendrait
+
+@example
+#(define output-suffix "violon")
+\score @{ @dots{} @}
+#(define output-suffix "cello")
+\score @{ @dots{} @}
+@end example
+
+@noindent
+fournira grâce à LilyPond @file{@var{racine}-violon.pdf} et
+@file{@var{racine}-cello-1.pdf}.
+
+
+@unnumberedsubsubsec Commandes standard de l'interpréteur
+
+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@tie{}:
+
+@itemize
+
+@item
+@code{lilypond fichier.ly 1>stdout.log} pour le verbiage normal
+
+@item
+@code{lilypond fichier.ly 2>stderr.log} pour les messages d'erreur
+
+@item
+@code{lilypond fichier.ly &>tous.log} pour garder une trace de tout ce
+qui s'est passé
+
+@end itemize
+
+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.
@node Options en ligne de commande
@unnumberedsubsec Options en ligne de commande pour @command{lilypond}
@translationof Command line options
-@untranslated
+@cindex lancement de @command{lilypond}
+@cindex ligne de commande, options pour @command{lilypond}
+@cindex options, ligne de commande
+@cindex switches
+@cindex commutateurs
+
+Voici les différentes options disponibles à la ligne de commande@tie{}:
+
+@table @code
+
+@item -e,--evaluate=@var{expr}
+Évalue l'expression Scheme @var{expr} avant d'analyser tout fichier
+@file{.ly}. Lorsque vous spécifiez l'option @code{-e} à plusieurs
+reprises, l'évaluation sera faite en séquence.
+
+Dans la mesure où l'expression est évaluée par le module
+@code{guile-user}, vous devrez, dès lors que @var{expr} utilise des
+définitions, spécifier
+
+@example
+lilypond -e '(define-public a 42)'
+@end example
+
+@noindent
+en ligne de commande, et ajouter la ligne
+
+@example
+#(use-modules (guile-user))
+@end example
+
+@noindent
+en tête de votre fichier @code{.ly}.
+
+
+@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}
+
+
+@item -d,--define-default=@var{var}=@var{val}
+Affecte la valeur Scheme @var{val} à l'option interne @var{var} du
+programme. En l'absence de @var{val}, le programme utilisera @var{#t}.
+Préfixer @var{var} d'un @code{no-} vous permet de désactiver une option.
+Ainsi,
+
+@cindex point and click, ligne de commande
+
+@example
+-dno-point-and-click
+@end example
+
+@noindent
+revient au même que
+@example
+-dpoint-and-click='#f'
+@end example
+
+
+Voici quelques options des plus intéressantes.
+
+@cindex help, ligne de commande
+
+@table @samp
+@item help
+Lancer @code{lilypond -dhelp} affichera la liste de toutes les options
+@code{-d} disponibles.
+
+
+@cindex paper-size, ligne de commande
+
+@item paper-size
+Détermine la taille par défaut du papier, par exemple
+@example
+-dpaper-size=\"letter\"
+@end example
+
+@noindent
+Veillez à ne pas oublier d'encadrer la valeur par des guillemets
+échappés ( @code{\"} ).
+@c Match " in previous line to help context-sensitive editors
+
+
+@cindex safe, ligne de commande
+
+@item safe
+Ne pas avoir une confiance aveugle dans le code @code{.ly}.
+
+Lorsque LilyPond est accessible au travers d'un serveur web, il est
+@strong{impératif} d'utiliser les options @code{--safe} ou
+@code{--jail}. L'option @code{--safe} aura pour effet d'empêcher tout
+code Scheme inclus de mettre en péril votre installation grâce à quelque
+chose du style
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^#(ly:export (ly:gulp-file "/etc/passwd"))
+}
+@end verbatim
+@end quotation
+
+L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
+module sécurisé, des expressions Scheme contenues dans le fichier
+source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
+ajoute un certain nombre de fonctions -- listées dans
+@file{scm/@/safe@/-lily@/.scm} -- à l'API de LilyPond.
+
+De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
+@code{\include} ni le recours aux obliques inversées (@emph{backslash})
+dans les chaînes @TeX{}.
+
+L'import de variables LilyPond dans du code Scheme n'est pas possible
+en mode sécuritaire.
+
+L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
+ressources. Il est donc possible que le programme finisse par rester
+sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
+laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
+accessible au public, d'en limiter aussi bien les ressources processeur
+que mémoire.
+
+Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
+compilation d'un certain nombre de fragments LilyPond. L'option
+@code{--jail} est dans ce cas une excellente alternative en terme de
+sécurité, même si elle requiert plus de temps à mettre en place.
+
+
+@cindex format de sortie, définition
+
+@item backend
+Détermine le format de sortie à utiliser par le moteur de traitement.
+Les types de @code{format} reconnus sont
+@table @code
+@item ps
+@cindex PostScript output
+ pour du PostScript.
+
+Les fichiers PostScript incluent les polices TTF, Type1 et OTF, et
+aucune substitution ne sera opérée pour ces fontes. Si vous utilisez
+des caractères orientaux, le fichier aura vite fait d'atteindre une
+taille conséquente.
+
+
+@item eps
+@cindex Postscript encapsulé
+@cindex EPS (Encapsulated PostScript)
+ pour du PostScript encapsulé.
+
+Chaque page (système) fera l'objet d'un fichier @file{EPS} particulier,
+sans fontes, auquel sera associé un fichier @file{EPS} qui, lui,
+contiendra toutes les pages (systèmes) et les fontes.
+
+Notez qu'il s'agit du mode que @command{lilypond-book} utilise par défaut.
+
+@item svg
+@cindex SVG (Scalable Vector Graphics)
+ pour du SVG (@emph{Scalable Vector Graphics}).
+
+Cette option permet de créer un fichier 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 SVG alors générés devraient être lisible
+par votre éditeur SVG habituel.
+
+@item scm
+@cindex Scheme dump
+ pour une recopie brute des commandes Scheme internes de formatage.
+
+@item null
+ permet de ne pas générer de partition imprimable. Cette option est
+ équivalente à @code{-dno-print-pages}.
+
+@end table
+
+Exemple : @code{lilypond -dbackend=svg @var{monfichier}.ly}
+
+
+@item preview
+@cindex preview, ligne de commande
+Génère un fichier comprenant le titrage et le premier système. S'il
+existe plusieurs sections @code{\bookpart}, ce fichier contiendra les
+tritrage et premier système de chacun des @code{\bookpart}. Cette
+option fonctionne pour les moteurs de traitement @code{ps}, @code{eps}
+et @code{svg}.
+
+
+@item print-pages
+Génère l'intégralité des pages de la partition. L'option
+@code{-dno-print-pages} est particulièrement utile lorsqu'utilisée
+conjointement avec l'option @code{-dpreview}.
+
+@end table
+
+
+
+@item -h,--help
+Affiche un résumé des commandes.
+
+
+@item -H,--header=@var{CHAMP}
+Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
+
+
+@item --include, -I=@var{répertoire}
+@cindex recherche de fichier
+@cindex search path
+
+Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
+
+Vous pouvez mentionner plusieurs fois l'option @code{-I}, auquel cas le
+la recherche commencera dans le premier répertoire inclus et, si le
+fichier en question ne s'y trouve pas, les répertoires suivants seront
+examinés l'un après l'autre.
+
+
+@item -i,--init=@var{fichier}
+Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
+d'initialisation.
+
+
+@item -o,--output=@var{FICHIER} ou @var{RÉP}
+@cindex répertoire de destination
+@cindex fichier de destination
+
+Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
+lorsque l'argument @var{RÉP} correspond à un répertoire déjà existant,
+c'est là que les fichiers résultants seront déposés. Le suffixe adéquat
+sera ajouté (p.ex. @code{.pdf} pour du pdf) dans tous les cas.
+
+
+@cindex PostScript output
+
+@item --ps
+Génère du PostScript.
+
+
+@cindex Portable Network Graphics (PNG) output
+
+@item --png
+Génère une image par page, au format PNG@tie{}; ceci sous-entend
+l'utilisation de @code{--ps}. La résolution de l'image, en DPI, peut se
+régler en ajoutant par exemple
+@example
+-dresolution=110
+@end example
+
+
+@cindex Portable Document Format (PDF) output
+
+@item --pdf
+Génère du PDF. Ceci sous-entend l'utilisation de @code{--ps}.
+
+
+@item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
+Lance @command{lilypond} dans un environnement protégé.
+
+L'option @code{--jail} est une alternative qui offre plus de flexibilité
+que l'option @code{--safe} lorsque LilyPond est installé sur un serveur
+web ou traite des fichiers externes.
+
+L'option @code{--jail} va détourner la racine de @command{lilypond} sur
+@code{jail} juste avant d'effectuer la compilation à proprement parler.
+L'utilisateur et le groupe sont modifiés en conséquence, et le
+répertoire en cours devient @code{dir}. Ces réglages assurent -- du
+moins en théorie -- l'impossibilité de s'échapper de la cellule. Notez
+cependant que, pour que l'option @code{--jail} soit fonctionnelle,
+@code{lilypond} doit être lancé en tant qu'administrateur -- ce qui se
+réalise aisément à l'aide de la commande @command{sudo}.
+
+La création d'un environnement sécurisé requiert quelques précautions
+dans la mesure où LilyPond doit disposer de tout ce dont il a besoin
+pour compiler le fichier source @strong{à l'intérieur de la cellule}.
+L'ermitage, avant d'être viable, requiert donc les étapes
+suivantes@tie{}:
+
+@table @asis
+@item Création d'un système de fichiers indépendant
+L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
+qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
+@code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
+d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
+l'intention de créer un tel système sur une partition séparée, vous
+pouvez avoir recours à un pseudo-périphérique (@emph{loop device}) monté
+à partir d'un simple fichier de taille raisonnable. D'autre part, le
+recours à un système de fichiers indépendant permet de limiter l'espace
+dévolu à LilyPond.
+
+@item Création d'un utilisateur spécifique
+L'utilisation de LilyPond au sein de la cellule devrait être réservé à
+un utilisateur aux droits restreints. Il faudra donc créer un
+utilisateur et un groupe spécifiques -- disons @code{lily}/@code{lily}
+-- qui n'aura accès en écriture qu'à un unique répertoire déterminé par
+la valeur de @var{dir}.
+
+@item Agencement des lieux
+LilyPond a besoin d'un certain nombre de fichiers pour pouvoir tourner
+correctement. Ces fichiers devront donc tous se retrouver dans
+l'environnement protégé, distribués selon la même arborescence que dans
+le système d'origine. Ainsi l'intégralité de l'installation de LilyPond
+(en principe @file{/usr/share/lilypond}) doit y être dupliquée.
+
+En cas de problème, lancer LilyPond en utilisant @code{strace} devrait
+vous permettre de déterminer quels fichiers manquent à l'appel.
+
+@item Lancement de LilyPond
+Dans un environnement protégé monté avec l'option @code{noexec}, il est
+impossible de lancer un quelconque programme extérieur. LilyPond ne
+saurait donc avoir recours à un moteur de traitement qui le mettrait
+dans cette situation. Comme nous l'avons vu plus haut, LilyPond sera
+lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
+aussitôt --, ce qui peut nécessiter le recours à la commande
+@code{sudo}. Il est par ailleurs judicieux de limiter le temps
+processeur aloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
+exemple -- ainsi que, si votre système le permet, la taille de la
+mémoire.
+@end table
+
+
+@item -v,--version
+Affiche le numéro de version.
+
+
+@item -V,--verbose
+Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
+d'accès de chaque fichier, et information des temps de traitement.
+
+
+@item -w,--warranty
+Affiche les informations de garantie appliquables à GNU LilyPond -- il
+est livré @strong{SANS GARANTIE}@tie{}!
+@end table
@node Variables d'environnement
@unnumberedsubsec Variables d'environnement
@translationof Environment variables
-@untranslated
+@cindex LANG
+@cindex LILYPOND_DATADIR
+
+@command{lilypond} reconnaît les variables d'environnement
+suivantes@tie{}:
+@table @code
+@item LILYPOND_DATADIR
+Cette variable spécifie le répertoire où seront recherchés par défaut les
+différentes versions des messages ainsi qu'un certain nombre de fichiers
+nécessaires au traitement. Il devrait contenir les sous-répertoires
+@file{ly/}, @file{ps/}, @file{tex/}, etc.
+
+@item LANG
+Cette variable détermine la langue dans laquelle seront émis les
+messages.
+
+@item LILYPOND_GC_YIELD
+Cette variable parmet d'ajuster l'empreinte mémoire et le rendement de
+la machine. Il s'agit en fait d'un pourcentage d'allocation de
+mémoire@tie{}: lorsqu'il est élevé, le programme favorisera
+l'utilisation de la mémoire@tie{}; une faible valeur consommera plus de
+temps processeur. Par défaut, cette valeur est fixée à @code{70}.
+
+@end table
@node Exécution de LilyPond en mode protégé
@unnumberedsubsec Exécution de LilyPond en mode protégé
@translationof LilyPond in chroot jail
-@untranslated
+Paramétrer un serveur afin qu'il puisse faire fonctionner LilyPond en
+mode protégé sur un pseudo-périphérique est une tâche sensible. Les
+différentes étapes à suivre sont répertoriées ci-dessous. Les exmples
+qu'elle comportent proviennent d'une distribution Linux Ubuntu et
+nécessiteront l'utilisation de @code{sudo} autant que de besoin.
+
+@itemize
+
+@item Installation des paquetages nécessaires@tie{}: LilyPond, GhostScript et
+ImageMagick.
+
+@item Création de l'utilisateur @code{lily}:
+
+@example
+adduser lily
+@end example
+
+@noindent
+Ceci, par la même occasion, créera un groupe spécifique pour
+l'utilisateur @code{lily} ainsi que son répertoire personnel
+@code{/home/lily}.
+
+@item Création, dans le répertoire personnel de l'utilisateur
+@code{lily}, d'un espace agissant en tant que système de fichiers@tie{}:
+
+@example
+dd if=/dev/zero of=/home/lily/loopfile bs=1k count= 200000
+@end example
+
+@noindent
+Cette commande a créé un fichier de 200@tie{}MB utilisable par le
+@qq{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
+accessible en écriture pour l'utilisateur @code{lily}@tie{}:
+
+@example
+mkdir /mnt/lilyloop
+losetup /dev/loop0 /home/lily/loopfile
+mkfs -t ext3 /dev/loop0 200000
+mount -t ext3 /dev/loop0 /mnt/lilyloop
+mkdir /mnt/lilyloop/lilyhome
+chown lily /mnt/lilyloop/lilyhome
+@end example
+
+@item Affectation, au niveau configuration du serveur, de
+@code{/mnt/lilyloop} en tant que JAIL et @code{/lilyhome} en tant que
+DIR.
+
+@item Création d'une arborescence, dans l'espace protégé, et recopie de
+tous les fichiers nécessaires -- voir le script plus loin.
+
+You can use @code{sed} to create the necessary copy commands for a given
+executable:
+
+@example
+for i in "/usr/local/lilypond/usr/bin/lilypond" "/bin/sh" "/usr/bin/; do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done
+@end example
+
+@end itemize
+
+@subheading Exemple de script fonctionnel en 32-bit sur Ubuntu 8.04
+
+@example
+#!/bin/sh
+## les réglages par défaut
+
+username=lily
+home=/home
+loopdevice=/dev/loop0
+jaildir=/mnt/lilyloop
+# le préfixe (sans slash au début !)
+lilyprefix=usr/local
+# le répertoire du système où lilypond est installé
+lilydir=/$lilyprefix/lilypond/
+
+userhome=$home/$username
+loopfile=$userhome/loopfile
+adduser $username
+dd if=/dev/zero of=$loopfile bs=1k count=200000
+mkdir $jaildir
+losetup $loopdevice $loopfile
+mkfs -t ext3 $loopdevice 200000
+mount -t ext3 $loopdevice $jaildir
+mkdir $jaildir/lilyhome
+chown $username $jaildir/lilyhome
+cd $jaildir
+
+mkdir -p bin usr/bin usr/share usr/lib usr/share/fonts $lilyprefix tmp
+chmod a+w tmp
+
+cp -r -L $lilydir $lilyprefix
+cp -L /bin/sh /bin/rm bin
+cp -L /usr/bin/convert /usr/bin/gs usr/bin
+cp -L /usr/share/fonts/truetype usr/share/fonts
+
+# la formule magique de recopie des biblothèques
+for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" "/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed 's/\t\/\(.*\/\)\(.*\) (.*)$/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed '/.*=>.*/d'; done | sh -s
+
+# les fichiers partagés pour ghostscript...
+ cp -L -r /usr/share/ghostscript usr/share
+# les fichiers partagés pour ImageMagick
+ cp -L -r /usr/lib/ImageMagick* usr/lib
+
+### Partant du principe que test.ly est dans /mnt/lilyloop/lilyhome,
+### on devrait pouvoir lancer :
+### Attention : /$lilyprefix/bin/lilypond est un script qui
+### définit LD_LIBRARY_PATH - c'est primordial
+ /$lilyprefix/bin/lilypond -jlily,lily,/mnt/lilyloop,/lilyhome test.ly
+@end example
@node Messages d'erreur
@section Messages d'erreur
@translationof Error messages
-@untranslated
-
+@cindex erreur, messages
+
+Différents messages d'erreur sont susceptibles d'apparaître au cours de
+la compilation d'un fichier@tie{}:
+
+@table @emph
+
+@item Warning -- Avertissement
+@cindex warning
+@cindex avertissement
+Ce type de message est émis lorsque LilyPond détecte quelque chose de
+suspect. Si vous avez demandé quelque chose qui sort de l'ordinaire,
+vous saurez probablement ce à quoi il est fait référence et ignorerez de
+tels messages sans remord. Néanmoins, les messages d'avertissement
+indiquent la plupart du temps une incohérence dans le fichier source.
+
+@item Error -- Erreur
+@cindex error
+LilyPond a détecté une erreur. L'étape en cours, qu'il s'agisse de
+l'analyse, de l'interprétation des données ou bien du formatage, sera
+menée à son terme, puis LilyPond s'arrêtera.
+
+@item Fatal error -- Erreur fatale
+@cindex fatal error
+LilyPond est confronté à une anomalie bloquante. Ceci ne se produit que
+très rarement, et le plupart du temps en raison d'une installation
+défectueuse des fontes.
+
+@item Scheme error -- Erreur Scheme
+@cindex trace, Scheme
+@cindex call trace
+@cindex Scheme error
+Les erreurs qui interviennent lors de l'exécution de code Scheme sont
+gérées par l'interpréteur Scheme. L'utilisation du mode verbeux
+(options @code{-V} ou @code{--verbose}) vous permettra de localiser
+l'appel de fonction délictueux.
+
+@item Programming error -- Erreur de programmation
+@cindex Programming error
+@cindex Erreur de programmation
+LilyPond est confronté à une incohérence interne. Ce type de message
+est destiné à venir en aide aux développeurs et débogueurs. En règle
+générale, vous pouvez tout simplement les ignorer. Parfois, il y en a
+tant qu'ils masquent ce qui pourrait vous intéresser@dots{}
+
+@item Aborted (core dumped) -- Abandon
+@cindex Aborted (core dumped)
+Ce type de message indique que LilyPond a planté en raison d'une grave
+erreur de programmation. La survenance d'un tel message est considérée
+comme de la plus haute importance. Si vous y étiez confronté,
+transmettez un rapport de bogue.
+@end table
+
+@cindex errors, message format
+Lorsque l'avertissement ou l'erreur est directement lié au fichier
+source, le message est libellé sous la forme
+
+@example
+@var{fichier}:@var{ligne}:@var{colonne}: @var{message}
+@var{contenu de la ligne litigieuse}
+@end example
+
+Un saut de ligne est placé dans la ligne de code, indiquant l'endroit
+précis du problème, comme ici@tie{}:
+
+@example
+test.ly:2:19: erreur: n'est pas une durée: 5
+ @{ c'4 e'
+ 5 g' @}
+@end example
+
+Notez que ces coordonnées constituent l'approximation au mieux par
+LilyPond dans le code ayant déclenché l'avertissement ou l'erreur. En
+règle générale, erreurs et avertissement surviennent lorsque LilyPond
+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.
+
+Vous trouverez d'autres informations sur les erreurs au chapitre
+@ref{Quelques erreurs des plus courantes}.
@node Quelques erreurs des plus courantes
Les conditions amenant aux erreurs qui suivent sont fréquentes, bien
qu'elles ne soient pas évidentes ni facilement localisables. Nous
espérons que ces explications vous aideront à les résoudre plus
-facilement.
+facilement.
@menu
Lorsque la musique s'épanche au delà de la marge droite ou bien semble
anormalement comprimée, la raison en est le plus souvent une note à la
-durée erronée ; cela finit par provoquer le débordement de la dernière
-note d'une mesure. Rien ne s'oppose à ce que la dernière note d'une
-mesure ne s'arrête avant la barre de mesure ; on considère simplement
-qu'elle se prolonge sur la mesure suivante. Des débordements à
-répétition finissent par générer une musique comprimée ou qui sort de la
-page, pour la simple et bonne raison que les sauts de ligne automatiques
-ne peuvent intervenir qu'à la fin d'une mesure complète, autrement dit
-lorsque toutes les notes sont terminées avant la fin de la mesure.
+durée erronée@tie{}; cela finit par provoquer le débordement de la
+dernière note d'une mesure. Rien ne s'oppose à ce que la dernière note
+d'une mesure ne s'arrête avant la barre de mesure@tie{}; on considère
+simplement qu'elle se prolonge sur la mesure suivante. Des débordements
+à répétition finissent par générer une musique comprimée ou qui sort de
+la page, pour la simple et bonne raison que les sauts de ligne
+automatiques ne peuvent intervenir qu'à la fin d'une mesure complète,
+autrement dit lorsque toutes les notes sont terminées avant la fin de la
+mesure.
@warning{Une durée erronée peut empêcher les sauts de ligne, ce qui
conduit à une musique compressée, voire à un débordement de la page.}
Une erreur de durée sera bien plus facilement localisable si vous
-positionnez régulièrement des contrôles de barre de mesure -- voir
+positionnez régulièrement des contrôles de barre de mesure -- voir
@ruser{Vérification des limites et numéros de mesure}.
Si vous tenez absolument à enchainer de tels débordements, vous devrez
insérer des barres de mesure invisibles là où vous souhaitez positionner
un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
-plus de détails.
+plus de détails.
@node Apparition d'une portée supplémentaire
appliquer la directive considérée. Survient alors la commande
@w{@code{\new Staff}} qui, à son tour, crée une nouvelle portée pour
contenir les notes qui suivent. Voici la syntaxe correcte pour obtenir
-ces notes en rouge :
+ces notes en rouge@tie{}:
@lilypond[quote,verbatim,relative=2]
\new Staff {
@end lilypond
La manière adéquate de procéder consiste à inverser les commandes
-@code{\repeat} et @code{\relative}, comme ceci :
+@code{\repeat} et @code{\relative}, comme ceci@tie{}:
@lilypond[quote,verbatim]
\relative {
L'erreur la plus courante est la simple omission d'une accolade
fermante (@code{@}} à la fin du bloc @code{Score}. La solution est
-évidente en pareil cas : il suffit de vérifier que le bloc @code{Score}
-est bien clôturé. La structure des fichiers LilyPond est abordée plus
-en détails au chapitre @ref{Organisation des fichiers LilyPond}. C'est la
-raison pour laquelle nous vous invitons à utiliser un éditeur de texte
-qui prenne en charge le contrôle de parité des parenthèses, crochets et
-accolades afin de vous éviter de telles erreurs.
+évidente en pareil cas@tie{}: il suffit de vérifier que le bloc
+@code{Score} est bien clôturé. La structure des fichiers LilyPond est
+abordée plus en détails au chapitre @rlearning{Organisation des fichiers
+LilyPond}. C'est la raison pour laquelle nous vous invitons à utiliser
+un éditeur de texte qui prenne en charge le contrôle de parité des
+parenthèses, crochets et accolades afin de vous éviter de telles erreurs.
Lorsqu'il s'agit d'un guillemet fermant (@code{"}) omis, le message
d'erreur devrait vous indiquer un numéro de ligne avoisinant. L'erreur
se situe la plupart du temps une ou deux lignes au-dessus de celle
-indiquée.
+indiquée.
@node Message d'erreur Unbound variable %
Ce message d'erreur, qu'il apparaisse sur le terminal ou en fin de
fichier journal, survient lorsqu'un fichier source contient des
caractères non ASCII et qu'il n'a pas été enregistré avec un encodage
-UTF-8. Pour plus dde détails, reportez-vous au chapitre
+UTF-8. Pour plus de détails, reportez-vous au chapitre
@ruser{Codage du texte}.
projects / lilypond.git / commitdiff