]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/tutorial.itely
Merge branch 'master' of ssh://kainhofer@git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / Documentation / fr / user / tutorial.itely
index a2439c6cd4b66700e9648a8dc4aa64f8d60db465..4d7bfa6134a8e49dda24dcf21cf8816552840a58 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-   Translation of GIT committish: b40f25ec7472b855483b5eb9126747bfb9487fe1
+   Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@@ -34,6 +34,10 @@ Tutorial guidelines:
 
 @c Your first LilyPond score in 10 minutes?
 
+@c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek
+@c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau
+
+
 @node Tutorial
 @chapter Tutorial
 
@@ -50,18 +54,18 @@ verrez exactement le code LilyPond utilisé pour générer cette image.
 Essayez sur cette image :
 
 @c no verbatim here
+@c KEEP LY
 @lilypond[quote,ragged-right]
 \relative c'' {
-  c-\markup { \bold \huge { Click here.  } }
+  c-\markup { \bold \huge { Cliquez ici.  } }
 }
 @end lilypond
 
-En copiant et en collant tout le code @qq{ly snippet} dans un fichier test,
-vous aurez un modèle de base pour faire vos expériences.  Si vous
-apprenez de cette façon, vous aurez probablement envie d'imprimer ou
-de garder un lien vers la
-@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles
-pour une consultation rapide.
+En copiant et en collant tout le code de l'extrait ly dans un fichier
+test, vous aurez un modèle de base pour faire vos expériences.  Si vous
+apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
+garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
+commandes usuelles pour une consultation rapide.
 @end ifhtml
 
 @menu
@@ -121,7 +125,7 @@ est préférable d'entourer les accolades par des espaces ou retours à
 la ligne.  Bien que certains exemples de ce manuel ne comportent pas
 d'accolades, ne les oubliez pas dans vos partitions !
 
-@cindex Case sensitive
+@cindex casse, prise en compte de
 De plus, LilyPond est sensible à  la casse.  @code{ @{ c d e @} } est
 un code valide ; @code{ @{ C D E @} } produira un message d'erreur.
 
@@ -134,7 +138,7 @@ comment voir ou imprimer le résultat de LilyPond.
 
 @subsubheading MacOS X
 
-Si vous double-cliquez sur LilyPond.app, un fichier d'exemple
+Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple
 s'ouvrira.  Sauvegardez-le, par exemple, sous @file{test.ly} sur votre
 bureau, et traitez-le ensuite avec la commande du menu @samp{Compile >
 Typeset File}.  Le fichier PDF résultant sera alors affiché sur votre
@@ -150,38 +154,29 @@ traitement, vous la trouverez dans la fenêtre @qq{log}.
 
 @subsubheading Windows
 
-Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel
-éditeur simple ou orienté programmation, qui prend en charge le codage
-de caractères UTF-8, fera l'affaire, par exemple le Bloc-notes.  N'utilisez
-pas de traitement de texte car ceux-ci insèrent des codes de formatage
-qui posent problème à  LilyPond.}  et saisissez
-
-@verbatim
-{
-  c' e' g' e'
-}
-@end verbatim
-
-Enregistrez-le sur le bureau sous @file{test.ly} et vérifiez bien
-qu'il ne s'appelle pas @file{test.ly.TXT}.  Double-cliquez sur le
-fichier @file{test.ly} pour le traiter et afficher le fichier
-PDF résultant.  Pour modifier un fichier @file{.ly} existant, faites
-un clic droit dessus et sélectionnez @qq{Éditer la source}.
-
-Si vous double-cliquez sur l'icône LilyPond sur le Bureau, un fichier
-d'exemple s'ouvrira dans un simple éditeur de texte.  Enregistrez-le,
-par exemple en tant que @file{test.ly} sur votre Bureau, puis
-double-cliquez dessus pour le traiter.  Après quelques secondes, vous
-obtiendrez un fichier @file{test.pdf} sur votre Bureau, fichier que
-vous pourrez ouvrir pour voir la partition imprimée.  Une autre
-méthode pour lancer le traitement du fichier @file{test.ly} est de le
-glisser avec votre souris sur l'icône de LilyPond.
+Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se
+trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple
+éditeur de texte.  Enregistrez-le, par exemple en tant que
+@file{test.ly} sur votre Bureau, puis double-cliquez sur son icône
+(qui montre une note de musique) pour le traiter.  Après quelques
+secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau,
+fichier que vous pourrez ouvrir pour voir la partition imprimée.  Une
+autre méthode pour lancer le traitement du fichier @file{test.ly} est
+de le glisser avec votre souris sur l'icône de LilyPond.
+
+Pour modifier un fichier @file{.ly} existant, faites un clic droit
+dessus et sélectionnez @qq{Éditer la source}.  Pour partir d'un
+fichier vide, lancez l'éditeur en ouvrant un fichier existant et
+utilisez la commande @qq{New} du menu @qq{File}.
 
 En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier
 PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond
-a effectuées sur votre fichier.  Si une erreur advient, c'est ce
+a effectuées sur votre fichier.  Si une erreur survient, c'est ce
 fichier qu'il vous faudra étudier.
 
+Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un
+meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}.
+
 @subsubheading Unix
 
 
@@ -193,7 +188,7 @@ de VIM et un
 encore installés, consultez le fichier @file{INSTALL.txt}.  L'outil
 d'édition le plus facile d'utilisation est de loin
 @file{LilyPondTool}.  Vous trouverez plus d'informations dans
-@ref{Editor support}.}  Dans votre
+@rprogram{Text editor support}.}  Dans votre
 éditeur, entrez le texte suivant et sauvegardez le fichier sous
 @file{test.ly}
 
@@ -229,8 +224,8 @@ Converting to `test.pdf'...
 Suivant votre installation, ces messages peuvent être traduits.
 @c END DIV
 
-@cindex PDF file
-@cindex Viewing music
+@cindex fichier PDF
+@cindex visionnage de la musique
 
 @noindent
 De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer
@@ -265,7 +260,7 @@ Le moyen le plus simple d'entrer des notes est d'utiliser le mode
 @code{\relative}.  Avec ce mode, l'@rglos{interval} entre la note et
 celle qui la précède est supposé inférieur ou égal à une
 @rglos{fourth}.  Commençons par entrer la partition la plus
-élémentaire qui soit, une (@rglos{scale}).
+élémentaire qui soit, une @rglos{scale}.
 
 @lilypond[quote,ragged-right,verbatim]
 \relative c' {
@@ -275,11 +270,10 @@ celle qui la précède est supposé inférieur ou égal à une
 @end lilypond
 
 La note de départ est @rglos{middle C}.  Chacune des notes qui suivent
-est à moins d'une quarte de la note précédente -- en d'autres termes,
-le premier @samp{c} est le Do dit "du milieu", entre la clé de Sol et
-la clé de Fa, puis est suivi par le ré le plus proche, et ainsi de
-suite.  On peut bien sûr créer des mélodies d'intervalles plus étendus
-:
+est à moins d'une quarte de la note précédente --- en d'autres termes,
+le premier @samp{c} est le do central, entre la clé de sol et
+la clé de fa, puis est suivi par le ré le plus proche, et ainsi de
+suite.  On peut bien sûr créer des mélodies d'intervalles plus étendus :
 
 @lilypond[quote,ragged-right,verbatim]
 \relative c' {
@@ -290,7 +284,7 @@ suite.  On peut bien sûr créer des mélodies d'intervalles plus étendus
 
 @noindent
 Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du
-milieu.  La première note -- le @samp{d} -- est le ré qui en est le
+milieu.  La première note --- le @samp{d} --- est le ré qui en est le
 plus proche.
 
 Pour ajouter des intervalles supérieurs à une quarte, il suffit
@@ -306,10 +300,10 @@ ajoutant respectivement une apostrophe @code{'} ou une virgule
 @end lilypond
 
 @noindent
-Pour envoyer une note deux octaves (ou davantage !) plus haut ou plus
-bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} --
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
+bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} ---
 attention cependant à bien mettre deux apostrophes @code{''}, et non
-deux guillemets @code{"}@tie{}! C'est de cette même manière que l'on
+un guillemet @code{"}@tie{}!  C'est de cette même manière que l'on
 peut modifier la valeur de départ de @code{\relative c'}.
 
 
@@ -334,7 +328,7 @@ Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée
 pour les notes suivantes.  En l'absence d'indication, la première note
 est une noire.
 
-Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.}  à
+Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.}  à
 la valeur rythmique.
 
 @lilypond[quote,ragged-right,verbatim]
@@ -347,7 +341,7 @@ la valeur rythmique.
 
 @subheading Rests
 
-On saisit un (@rglos{rest}) tout comme une note, mais avec le
+On saisit un @rglos{rest} tout comme une note, mais avec le
 caractère @samp{r}.
 
 @lilypond[quote,ragged-right,verbatim]
@@ -360,7 +354,7 @@ caractère @samp{r}.
 
 @subheading Time signature
 
-Le @rglos{time signature}) peut être défini à l'aide de la commande
+La @rglos{time signature} peut être définie à l'aide de la commande
 @code{\time} :
 
 @lilypond[quote,ragged-right,verbatim]
@@ -406,17 +400,17 @@ Voici un bref exemple qui montre tous ces éléments ensemble :
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Entrer des hauteurs et des durées
-voir @ref{Pitches} and @ref{Durations}.
+voir @ruser{Pitches} and @ruser{Durations}.
 @item Les silences
-voir @ref{Rests}.
+voir @ruser{Rests}.
 @item Les chiffres de mesure et autres commandes de métrique
-voir @ref{Time signature}.
+voir @ruser{Time signature}.
 @item Les clés
-voir @ref{Clef}.
+voir @ruser{Clef}.
 @end table
 @end quotation
 
@@ -424,29 +418,29 @@ voir @ref{Clef}.
 @node Working on text files
 @subsection Working on text files
 
-Les fichiers d'entrée de LilyPond sont traités comme la plupart des
-langages de programmation : la casse est prise en compte mais pas les
-espaces vides, les expressions musicales sont délimitées par des
-accolades @{ @}, et les commentaires par des @code{%} ou @code{%@{ ..
-%@}}.
+Le traitement des fichiers source de LilyPond est semblable à celui du
+code de nombreux langages de programmation répandus : la casse est prise
+en compte, et les caractères considérés comme espaces ont généralement
+peu d'importance.  Les expressions sont délimitées par des accolades @{
+@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}.
 
 Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
 Tous ces termes vont être expliqués :
 
 @itemize
 
-@cindex Case sensitive
+@cindex casse, prise en compte de
 @item @strong{La casse} :
-LilyPond est sensible à  la casse, c'est à dire qu'une lettre en
-capitales n'a pas la même valeur qu'une lettre en minuscules.  Les
-notes, par exemple, doivent être entrées en minuscules :  @code{ @{ c
-d e @} } est
-un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur.
+LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
+n'a pas la même valeur qu'une lettre minuscule.  Les notes, par
+exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est
+un code valide, alors que @code{@{ C D E @}} produira un message
+d'erreur.
 
 @item @strong{Les espaces multiples} :
 LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la
-ligne.  @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @
-d e @} } ou que
+ligne.  @code{@{ c d e @}} a le
+même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que
 @example
          @{
 c                        d
@@ -463,7 +457,7 @@ soit des doubles espaces :
 @}
 @end example
 
-@item @strong{Expressions musicales :}
+@item @strong{Expressions musicales} :
 Tout morceau saisi dans LilyPond doit être placé entre @strong{@{
 accolades @}}.  Ces caractères indiquent à LilyPond que ce bloc de
 texte est une et une seule expression musicale, tout comme les
@@ -471,12 +465,12 @@ parenthèses @samp{()} en mathématiques.  Il est préférable, pour
 éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à
 moins qu'ils se trouvent au début ou à la fin d'une ligne.
 
-Une fonction telle que @code{\relative @{ @}} ) compte également comme
-une seule expression musicale.
+Une fonction --- @code{\relative @{ @}} par exemple --- compte
+également comme une seule expression musicale.
 
-@cindex comments
-@cindex line comment
-@cindex block comment
+@cindex commentaires
+@cindex commentaire de fin de ligne
+@cindex commentaire-bloc
 @item @strong{Les commentaires} :
 Un commentaire est une indication pour tout lecteur humain d'un
 fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun
@@ -487,7 +481,7 @@ commentaires :
 tout ce qui suit ce symbole sur cette ligne sera ignoré.
 @item le bloc de commentaire, qui peut être de plusieurs lignes voire
 de toute une section : tout ce qui se trouve entre @code{%@{} et
-@code{%@}} est ignoré.
+@code{%@}} est ignoré.  Les blocs de commentaires ne peuvent s'imbriquer.
 @end itemize
 Le fragment suivant met en évidence quelques usages possibles des commentaires :
 
@@ -507,13 +501,13 @@ Le fragment suivant met en évidence quelques usages possibles des commentaires
 @end itemize
 
 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
 
 
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-Comme nous l'avons vu dans @ref{Working on text files}, un code
+Comme nous l'avons vu dans @ruser{Working on text files}, un code
 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
 c'' @{ ...  @}} afin d'être compris.  Cependant, dans la suite de ce
 manuel, la plupart des exemples ne feront pas apparaître ces signes.
@@ -558,16 +552,16 @@ Cette section présente la notation courante dont on a besoin pour
 @node Relative note names
 @subsection Relative note names
 
-Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
+Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
 hauteur de chaque note en fonction de la précédente@footnote{Il existe
-un autre mode de saisie des hauteurs, le mode @ref{Absolute note
+un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
 au mode de hauteurs relatives.}.  Si aucune indication supplémentaire
-d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est
+d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
 située à une quarte au plus de la note précédente.
 
 Lilypond tient compte des intervalles induits par les noms des notes
--- en d'autres termes,une quarte augmentée n'est @emph{pas}
+--- en d'autres termes, une quarte augmentée n'est @emph{pas}
 équivalente à une quinte diminuée.  Ainsi, si l'on part d'un Do, un Fa
 dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé
 au-dessous.
@@ -577,13 +571,13 @@ c2 fis
 c2 ges
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
-@item Les Octaves Relatives
-voir @ref{Relative octaves}.
+@item Les hauteurs de note relatives
+voir @ruser{Relative octaves}.
 @item Les vérifications d'octaves
-voir @ref{Octave check}.
+voir @ruser{Octave check}.
 @end table
 @end quotation
 
@@ -594,31 +588,30 @@ voir @ref{Octave check}.
 
 @subheading Accidentals
 
-Dans la notation par défaut,un dièse (@rglos{sharp}) s'obtient en
-ajoutant @samp{is} au nom de la
-note, et un bémol (@rglos{flat}) en ajoutant @samp{es}.  Comme vous pouvez
-vous y attendre, un double dièse ou double bémol est alors obtenu en
-ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée
-de la convention de dénomination des notes dans les langues nordiques
-et germaniques, comme l'allemand ou le hollandais.}.
+Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant
+@samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}.
+Comme vous pouvez vous y attendre, un double dièse ou double bémol est
+alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette
+syntaxe est dérivée de la convention de dénomination des notes dans
+les langues nordiques et germaniques, comme l'allemand ou le
+hollandais.}.
 
 @c DIV specific
 Cependant, si vous utilisez la commande @samp{\include "italiano.ly"}
-pour entrer
-les noms de notes français au lieu des noms hollandais, il faudra
-ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bémol.  Le
-double dièse et le double bémol s'obtiennent en ajoutant
+pour entrer les noms de notes français au lieu des noms hollandais, il
+faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un
+bémol.  Le double dièse et le double bémol s'obtiennent en ajoutant
 respectivement @samp{dd} et @samp{bb}
 @c END DIV
 
-Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
-names in other languages}.}
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
+names in other languages}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 cis1 ees fisis, aeses
 @end lilypond
 
-@cindex key signature, setting
+@cindex armure, définition de
 @subheading Key signatures
 
 L'armure est déterminée par la commande @code{\key}, suivie d'une
@@ -636,25 +629,24 @@ a
 @subheading Warning: key signatures and pitches
 
 La combinaison de l'armure et des hauteurs de note --- y compris les
-altérations --- permet à LilyPond de déterminer dans quel cas afficher les
-altérations accidentelles.  L'armure n'affecte que les altérations
+altérations --- permet à LilyPond de déterminer dans quel cas afficher
+les altérations accidentelles.  L'armure n'affecte que les altérations
 @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité
-est souvent source de
-confusion pour les nouveaux utilisateurs, aussi expliquons-la en
-détail.
+est souvent source de confusion pour les nouveaux utilisateurs, aussi
+expliquons-la en détail.
 
 LilyPond fait une nette distinction entre le contenu musical et la
-mise en forme.  L'altération d'une note -- bémol, bécarre ou dièse --
-fait partie de sa hauteur, et relève donc du contenu musical.  La
-présence ou non
-d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou
-dièse -- devant la note correspondante est une question qui relève de la mise en
-page.  Mettre en page une partition se fait selon des règles ; les
-altérations accidentelles seront donc automatiquement imprimées suivant
-ces règles.  Les hauteurs de note, en revanche, relèvent de ce que
-vous voulez entendre ; et, dans la mesure où la musique que vous
-entrez est censée être celle que vous voulez entendre, LilyPond (qui
-n'est chargé que de la gravure) ne les choisira pas à votre place.
+mise en forme.  L'altération d'une note --- bémol, bécarre ou dièse
+--- fait partie de sa hauteur, et relève donc du contenu musical.  La
+présence ou non d'une altération accidentelle --- un @emph{signe}
+bémol, bécarre ou dièse --- devant la note correspondante est une
+question qui relève de la mise en page.  Mettre en page une partition
+se fait selon des règles ; les altérations accidentelles seront donc
+automatiquement imprimées suivant ces règles.  Les hauteurs de note,
+en revanche, relèvent de ce que vous voulez entendre ; et, dans la
+mesure où la musique que vous entrez est censée être celle que vous
+voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les
+choisira pas à votre place.
 
 Dans cet exemple,
 
@@ -664,7 +656,7 @@ d cis fis
 @end lilypond
 
 @noindent
-Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez
+aucune note n'a d'altération accidentelle, et pourtant vous devrez
 entrer le @samp{is} pour les notes @code{cis} et @code{fis}.
 
 Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste
@@ -684,17 +676,17 @@ d'effort dans la phase de saisie, mais la transposition en sera
 grandement facilitée.
 De plus les altérations accidentelles
 peuvent être imprimées suivant plusieurs conventions.  Regardez
-@ref{Automatic accidentals} pour connaître les différentes manières dont les
+@ruser{Automatic accidentals} pour connaître les différentes manières dont les
 altérations accidentelles peuvent être imprimées, suivant les règles
 que vous choisirez.
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Les altérations
-voir @ref{Accidentals} and @ref{Automatic accidentals}.
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
 @item Les armures
-voir @ref{Key signature}.
+voir @ruser{Key signature}.
 @end table
 @end quotation
 
@@ -702,7 +694,7 @@ voir @ref{Key signature}.
 @node Ties and slurs
 @subsection Ties and slurs
 
-@cindex ties
+@cindex liaisons de prolongation
 @subheading Ties
 Une @rglos{tie}@footnote{parfois aussi appelée liaison de
 tenue} se crée en ajoutant un tilde @samp{~} à la première note liée.
@@ -712,7 +704,7 @@ g4~ g c2~
 c4 ~ c8 a8 ~ a2
 @end lilypond
 
-@cindex slurs
+@cindex liaisons d'articulation
 @subheading Slurs
 
 @c Le terme de "slur" a deux sens en français : articulation et phrasé.
@@ -720,18 +712,16 @@ c4 ~ c8 a8 ~ a2
 @c car c'est celui qui me semble le plus couramment employé.
 
 Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober
-plusieurs notes.  La note de départ et d'arrivée reçoivent
+plusieurs notes.  Les notes de départ et d'arrivée reçoivent
 respectivement un signe @samp{(} et @samp{)}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 d4( c16) cis( d e c cis d) e( d4)
 @end lilypond
 
-@cindex slurs, phrasing
-@cindex phrasing slurs
+@cindex liaisons de phrasé
 @subheading Phrasing slurs
 
-@cindex phrasing slurs
 De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et
 @code{\)}.  Il est possible d'avoir en même temps des legatos et des
 phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois.
@@ -742,8 +732,8 @@ a8(\( ais b c) cis2 b'2 a4 cis,\)
 
 @sp 1
 
-@cindex slurs versus ties
-@subheading Warnings: slurs vs.  ties
+@cindex liaisons de phrasé et de prolongation, différences
+@subheading Warnings: slurs vs. ties
 
 Une liaison d'articulation ou de phrasé ressemble à une liaison de
 tenue, mais n'a pas la même signification.  Alors qu'une liaison de
@@ -755,15 +745,12 @@ liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
-@item Liaisons de prolongation
-voir @ref{Ties}.
-@item Legato
-voir @ref{Slurs}.
-@item Liaisons de phrasé
-voir @ref{Phrasing slurs}.
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
 @end table
 @end quotation
 
@@ -776,14 +763,14 @@ voir @ref{Phrasing slurs}.
 @cindex staccato
 @subheading Articulations
 
-Des @rglos{articulations} peuvent être ajoutées à une note, au moyen
+Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen
 d'un tiret @samp{-} suivi d'un caractère :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 c-. c-- c-> c-^ c-+ c-_
 @end lilypond
 
-@cindex fingering
+@cindex doigtés
 @subheading Fingerings
 De même, des indications de doigté peuvent être ajoutées à une note en
 utilisant un tiret (@samp{-}) et le chiffre à écrire :
@@ -794,9 +781,10 @@ c-3 e-5 b-2 a-1
 
 Articulations et doigtés sont habituellement placés automatiquement,
 mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut)
-ou @samp{_} (en bas).  Vous pouvez aussi utiliser plusieurs articulations
-sur la même note.  Dans la plupart des cas, cependant, il est mieux de
-laisser LilyPond déterminer l'emplacement de l'articulation.
+ou @samp{_} (en bas).  Vous pouvez aussi utiliser plusieurs
+articulations sur la même note.  Dans la plupart des cas, cependant, il
+est mieux de laisser LilyPond déterminer l'emplacement de
+l'articulation.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 c_-^1 d^. f^4_2-> e^-_+
@@ -810,7 +798,7 @@ précédées d'un anti-slash @samp{\} :
 c\ff c\mf c\p c\pp
 @end lilypond
 
-@cindex dynamics
+@cindex nuances
 @cindex decrescendo
 @cindex crescendo
 
@@ -818,23 +806,19 @@ c\ff c\mf c\p c\pp
 @c selon Littré, plutôt à la française (en "-os" qu'en "-i")
 
 Crescendos et decrescendos débutent avec les commandes @code{\<} et
-@code{\>}.  Ils se terminent soit par une nuance d'arrivée, par
-exemple @code{\f},
-soit par la commande @code{\!} :
+@code{\>}.  Ils se terminent soit par une nuance d'arrivée, par exemple
+@code{\f}, soit par la commande @code{\!} :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
-@item Ponctuations
-voir @ref{Articulations}.
-@item Doigtés
-voir @ref{Fingering instructions}.
-@item Nuances
-voir @ref{Dynamics}.
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
 @end table
 @end quotation
 
@@ -842,8 +826,8 @@ voir @ref{Dynamics}.
 @node Automatic and manual beams
 @subsection Automatic and manual beams
 
-@cindex beams, by hand
-Toutes les @rglos{beam}s sont dessinées automatiquement :
+@cindex ligatures manuelles
+Toutes les @rglos{beam} sont dessinées automatiquement :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 a8 ais d ees r d c16 b a8
@@ -851,20 +835,20 @@ a8 ais d ees r d c16 b a8
 
 @noindent
 Lorsqu'on n'aime pas la manière dont les notes sont automatiquement
-groupées, il est possible de les entrer à la main, en marquant la
+groupées, il est possible de les ligaturer manuellement, en marquant la
 première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Groupements de notes et ligatures automatiques
-voir @ref{Automatic beams}.
+voir @ruser{Automatic beams}.
 @item Groupements et ligatures manuels
-voir @ref{Manual beams}.
+voir @ruser{Manual beams}.
 @end table
 @end quotation
 
@@ -872,28 +856,27 @@ voir @ref{Manual beams}.
 @node Advanced rhythmic commands
 @subsection Advanced rhythmic commands
 
-@cindex pickup
-@cindex anacruse
-@cindex partial measure
+@cindex levée
+@cindex anacrouse
+@cindex mesure incomplète
 @subheading Partial measure
 
 Une levée (ou @rglos{anacrusis}) est entrée avec la commande
 @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée
-d'une noire et
-@code{\partial 8} d'une croche.
+d'une noire et @code{\partial 8} d'une croche.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 \partial 8
 f8 c2 d
 @end lilypond
 
-@cindex tuplets
-@cindex triplets
+@cindex nolets
+@cindex triolets
 @subheading Tuplets
-Les nolets sont créés avec la commande @code{\times}, qui prend
-deux arguments : une fraction et une expression musicale.  La durée des
-notes de l'expression musicale est multipliée par la fraction.  Par exemple les
-notes d'un triolet durent les deux tiers du temps de leur notation
+Les nolets sont créés avec la commande @code{\times}, qui prend deux
+arguments : une fraction et une expression musicale.  La durée des notes
+de l'expression musicale est multipliée par la fraction.  Par exemple
+les notes d'un triolet durent les deux tiers du temps de leur notation
 réelle, cette fraction est donc de 2/3 pour les triolets :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
@@ -903,13 +886,13 @@ réelle, cette fraction est donc de 2/3 pour les triolets :
 \times 2/3 { d4 a8 }
 @end lilypond
 
-@cindex grace notes
-@cindex acciaccatura
-@cindex appoggiatura
+@cindex notes d'ornement
+@cindex ornementation
+@cindex appoggiature
 @subheading Grace notes
 
-Des notes d'ornement sont produites par la commande @code{\grace},
-mais aussi en préfixant une expression musicale avec le mot-clé
+Des notes d'ornement sont produites par la commande @code{\grace}, mais
+aussi en préfixant une expression musicale avec le mot-clé
 @code{\appoggiatura} ou @code{\acciaccatura} :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
@@ -918,15 +901,15 @@ c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Notes d'ornement
-voir @ref{Grace notes},
+voir @ruser{Grace notes},
 @item nolets
-voir @ref{Tuplets},
+voir @ruser{Tuplets},
 @item levées
-voir @ref{Partial measures}.
+voir @ruser{Partial measures}.
 @end table
 @end quotation
 
@@ -934,9 +917,9 @@ voir @ref{Partial measures}.
 @node Multiple notes at once
 @section Multiple notes at once
 
-Cette section traite des situations où l'on a plus d'une note à la
-fois : plusieurs instruments, plusieurs portées pour un même
-instrument (le piano, par exemple), et les accords.
+Cette section traite des situations où l'on a plus d'une note à la fois
+: plusieurs instruments, plusieurs portées pour un même instrument (le
+piano, par exemple), et les accords.
 
 La polyphonie, en théorie musicale, est la notion d'une musique
 constituée de plusieurs voix ; dans lilypond, ce terme désigne les
@@ -946,18 +929,18 @@ situations où il y a plus d'une voix sur une même portée.
 * Music expressions explained::
 * Multiple staves::
 * Piano staves::
-* Single staff polyphony::
 * Combining notes into chords::
+* Single staff polyphony::
 @end menu
 
 
 @node Music expressions explained
 @subsection Music expressions explained
 
-Dans les fichiers source LilyPond, la musique est représentée par ce qu'on
-appelle des @emph{expressions musicales}.  En soi, une seule note peut
-constituer une
-expression  musicale, si tant est qu'elle soit correctement encadrée :
+Dans les fichiers source LilyPond, la musique est représentée par ce
+qu'on appelle des @emph{expressions musicales}.  En soi, une seule note
+peut constituer une expression musicale, si tant est qu'elle soit
+correctement encadrée :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 a4
@@ -970,8 +953,8 @@ musicale :
 { a4 g4 }
 @end lilypond
 
-Placer une séquence d'expressions musicales -- des notes par exemple
--- entre accolades signifie qu'elles doivent être jouées
+Placer une séquence d'expressions musicales --- des notes par exemple
+--- entre accolades signifie qu'elles doivent être jouées
 successivement, les unes après les autres.  Le résultat est une
 expression, qui peut elle-même être regroupée séquentiellement avec
 d'autres expressions.  Ici, l'expression de l'exemple précédent est
@@ -983,14 +966,14 @@ combinée à deux notes :
 
 @subheading Simultaneous music expressions: multiple staves
 
-Cette technique est utile pour de la musique polyphonique.  Pour
-entrer une musique avec plusieurs voix ou plusieurs portées, nous
-pouvons aussi combiner en parallèle les expressions.  Deux voix qui doivent être
+Cette technique est utile pour de la musique polyphonique.  Pour entrer
+une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi
+combiner en parallèle les expressions.  Deux voix qui doivent être
 jouées en même temps, sont entrées comme une combinaison simultanée de
 deux expressions.  Une expression musicale @q{simultanée} est formée en
 entourant les expressions entre @code{<<} et @code{>>}.  Dans l'exemple
-suivant, trois expressions (contenant chacune deux notes distinctes) sont
-combinées simultanément.
+suivant, trois expressions (contenant chacune deux notes distinctes)
+sont combinées simultanément.
 
 @lilypond[quote,ragged-right,verbatim]
 \relative c'' {
@@ -1002,10 +985,10 @@ combinées simultanément.
 }
 @end lilypond
 
-Notez que nous avons ici indenté chaque niveau du fichier d'entrée
-avec un nombre d'espaces différent.  LilyPond se moque de l'espace
-qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant
-votre code vous le rendrez bien plus facile à lire pour les humains.
+Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec
+un nombre d'espaces différent.  LilyPond se moque de l'espace qu'il peut
+y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous
+le rendrez bien plus facile à lire pour les humains.
 
 @strong{Attention} : chaque note saisie est relative à la précédente,
 mais pas au @code{c''} de la commande @code{\relative} de départ.
@@ -1026,7 +1009,7 @@ portée.
 @end lilypond
 
 @cindex expression
-@cindex music expression
+@cindex expression musicale
 @subheading Analogy: mathematical expressions
 
 Ce mécanisme est similaire au formules mathématiques : une grosse
@@ -1046,28 +1029,28 @@ longues et complexes.  Par exemple,
 @end example
 
 Ceci est une suite d'expressions, où chacune est contenue dans la
-suivante.  Les expressions les plus simples sont les nombres, et de
-plus grandes expressions sont produites en combinant des expressions
-avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des
+suivante.  Les expressions les plus simples sont les nombres, et de plus
+grandes expressions sont produites en combinant des expressions avec des
+opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des
 parenthèses.  Tout comme les expressions mathématiques, les expressions
-musicales peuvent être imbriquées avec une profondeur arbitraire, ce
-qui est nécessaire pour de la musique complexe comme des partitions
+musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui
+est nécessaire pour de la musique complexe comme des partitions
 polyphoniques.
 
 
 @node Multiple staves
 @subsection Multiple staves
 
-Comme nous l'avons vu dans @ref{Music expressions explained}, un
-fichier d'entrée LilyPond est fait d'expressions musicales.  Si la
-partition commence par plusieurs expressions simultanées, LilyPond
-créera plusieurs portées.  Cependant, il est plus facile de voir ce
-qu'il advient si l'on crée explicitement chacune des portées.
+Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
+d'entrée LilyPond est fait d'expressions musicales.  Si la partition
+commence par plusieurs expressions simultanées, LilyPond créera
+plusieurs portées.  Cependant, il est plus facile de voir ce qu'il
+advient si l'on crée explicitement chacune des portées.
 
 Pour créer plus d'une portée, chaque partie de la musique constituant
-une portée est entrée en la faisant précéder de @code{\new Staff}.
-Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
- @code{<<} et @code{>>}, comme ceci :
+une portée est entrée en la faisant précéder de @code{\new Staff}.  Ces
+éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<}
+et @code{>>}, comme ceci :
 
 @lilypond[quote,ragged-right,verbatim]
 \relative c'' {
@@ -1079,13 +1062,13 @@ Ces éléments @code{Staff} sont ensuite combinés en parallèle avec
 @end lilypond
 
 
-La commande @code{\new} introduit un « contexte de notation ».  Un
+La commande @code{\new} introduit un @qq{contexte de notation}.  Un
 contexte de notation est un environnement dans lequel les événements
-musicaux -- comme les notes ou les commandes @code{\clef} -- sont
-interprétés.   Pour des pièces simples, ces contextes sont créés
+musicaux --- comme les notes ou les commandes @code{\clef} --- sont
+interprétés.  Pour des pièces simples, ces contextes sont créés
 automatiquement.  Pour des pièces plus complexes, il est préférable de
-spécifier explicitement les contextes.  Cela assure que chaque
-fragment aura sa propre portée.
+spécifier explicitement les contextes.  Cela assure que chaque fragment
+aura sa propre portée.
 
 Il existe différents types de contextes.  Les contextes @code{Staff}
 (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la
@@ -1094,14 +1077,14 @@ notation de la mélodie, alors que @code{Lyrics} gère les paroles et
 
 En termes de syntaxe, faire précéder une expression musicale de
 @code{\new} crée une plus grosse expression musicale.  En reprenant la
-comparaison, cela ressemble au signe « moins » en mathématiques.  La
-formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une
-plus grosse expression.
+comparaison, cela ressemble au signe @qq{moins} en mathématiques.  La
+formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus
+grosse expression.
 
-Les chiffres de mesure figurant sur une portée affectent toutes les
-autres portées ; en revanche l'armure d'une portée n'affectera
-@emph{pas} les autres portées.@footnote{Ce comportement peut être
-modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
+Les chiffres de métrique indiqués sur une portée affectent toutes les
+autres portées@footnote{Ce comportement peut être modifié si nécessaire,
+voir @ruser{Polymetric notation}.}.  En revanche l'armure d'une portée
+n'affecte @emph{pas} les autres portées.
 
 @lilypond[quote,ragged-right,verbatim]
 \relative c'' {
@@ -1118,13 +1101,12 @@ modifié si nécessaire : voir pour cela @ref{Changing defaults}.}.
 @node Piano staves
 @subsection Piano staves
 
-@cindex staff switch, manual
-@cindex cross staff voice, manual
-La musique pour piano s'écrit sur deux portées reliées par une
-accolade.  Imprimer ce type de portée revient au même que dans
-l'exemple de musique polyphonique de (@ref{Multiple staves}), mais
-maintenant cette expression entière doit être interprétée dans un
-contexte @code{PianoStaff} :
+@cindex changement de portée manuel
+@cindex voix changeant manuellement de portée
+La musique pour piano s'écrit sur deux portées reliées par une accolade.
+Imprimer ce type de portée revient au même que dans l'exemple de musique
+polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
+entière doit être interprétée dans un contexte @code{PianoStaff} :
 
 @example
 \new PianoStaff <<
@@ -1144,27 +1126,50 @@ Voici un bref exemple :
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Voir @ref{Piano music}.
+Voir @ruser{Piano music}.
 @end quotation
 
 
+@node Combining notes into chords
+@subsection Combining notes into chords
+
+@cindex accords
+Des accords peuvent être produits en entourant les hauteurs de notes
+par des angles gauche et droit --- @samp{<} et @samp{>} ---
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>4 <c f a>2
+@end lilypond
+
+Vous pouvez combiner les indications comme les liaisons et les ligatures
+de croches avec les accords.  Ils doivent cependant être placés en
+dehors des angles :
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8[ <c f a>]~ <c f a>2
+@end lilypond
+
+@lilypond[quote,fragment,verbatim,relative=2,fragment]
+r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
+@end lilypond
+
+
 @node Single staff polyphony
 @subsection Single staff polyphony
 
-@cindex polyphony
-@cindex multiple voices
-@cindex voices, more -- on a staff
-Quand différentes lignes mélodiques sont combinées sur une seule et
-même portée, elles sont imprimées comme des voix polyphoniques ;
-chaque voix a ses propre hampes@footnote{familièrement appelées queues
-de note.}, liaisons et ligatures, la voix supérieure ayant les hampes
-vers le haut, la voix inférieure vers le bas.
+@cindex polyphonie
+@cindex voix multiples sur une portée
+Quand différentes lignes mélodiques sont combinées sur une seule et même
+portée, elles sont imprimées comme des voix polyphoniques ; chaque voix
+a ses propre hampes@footnote{familièrement appelées queues de note.},
+liaisons et ligatures, la voix supérieure ayant les hampes vers le haut,
+la voix inférieure vers le bas.
 
 Ce type de partition est réalisé en entrant chaque voix comme une
 séquence (avec @code{@{...@}}), en combinant simultanément les voix et
-en les séparant par  @code{\\} :
+en les séparant par @code{\\} :
 
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
@@ -1175,10 +1180,10 @@ en les séparant par  @code{\\} :
 @end lilypond
 
 Pour l'écriture de musique polyphonique, les silences invisibles
-s'avèrent bien pratiques : ce sont des silences qui ne s'impriment
-pas.  Ils sont utiles pour remplir des voix qui, temporairement, ne
-jouent rien.  On peut voir ici le même exemple avec un silence
-invisible (@code{s}) à la place d'un silence normal (@code{r}) :
+s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas.
+Ils sont utiles pour remplir des voix qui, temporairement, ne jouent
+rien.  On peut voir ici le même exemple avec un silence invisible
+(@code{s}) à la place d'un silence normal (@code{r}) :
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 <<
@@ -1204,41 +1209,16 @@ Là encore, ces expressions peuvent s'imbriquer arbitrairement :
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Voir @ref{Basic polyphony}.
+Voir @ruser{Basic polyphony}.
 @end quotation
 
 
-@node Combining notes into chords
-@subsection Combining notes into chords
-
-@cindex chords
-Des accords peuvent être produits en entourant les hauteurs de notes
-par des angles gauche et droit -- @samp{<} et @samp{>} --
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>4 <c f a>2
-@end lilypond
-
-Vous pouvez combiner les indications comme les liaisons et les
-ligatures de croches avec les accords.  Ils doivent cependant être
-placés en dehors des angles :
-
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8[ <c f a>]~ <c f a>2
-@end lilypond
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
-@end lilypond
-
-
 @node Songs
 @section Songs
 
-Cette section présente l'écriture vocale, et les partitions de variété.
+Cette section présente l'écriture vocale et les partitions de variété.
 
 @menu
 * Printing lyrics::
@@ -1249,8 +1229,8 @@ Cette section présente l'écriture vocale, et les partitions de variété.
 @node Printing lyrics
 @subsection Printing lyrics
 
-@cindex Lyrics
-@cindex Songs
+@cindex paroles
+@cindex chansons
 Prenons une mélodie toute simple :
 
 @lilypond[quote,ragged-right,verbatim]
@@ -1260,9 +1240,9 @@ Prenons une mélodie toute simple :
 }
 @end lilypond
 
-Des paroles peuvent être associées à ces notes, en les combinant avec
-la commande @code{\addlyrics}.  Les paroles sont entrées en séparant
-chaque syllable par un espace :
+Des paroles peuvent être associées à ces notes, en les combinant avec la
+commande @code{\addlyrics}.  Les paroles sont entrées en séparant chaque
+syllable par un espace :
 
 @lilypond[quote,ragged-right,verbatim]
 <<
@@ -1274,10 +1254,10 @@ chaque syllable par un espace :
 >>
 @end lilypond
 
-@cindex melisma
-@cindex extender line
+@cindex mélisme
+@cindex ligne d'extension
 Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une
-seule syllable (« free ») correspond à plus d'une note.  Ceci est
+seule syllable (@qq{free}) correspond à plus d'une note.  Ceci est
 indiqué avec une @emph{ligne d'extension}.  Elle est entrée avec deux
 caractères souligné (@code{_}), c'est-à-dire :
 
@@ -1306,34 +1286,32 @@ entre les deux syllabes :
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Plus de possibilités, comme celle d'ajouter plusieurs lignes de
-paroles en dessous d'une même mélodie sont exposées dans @ref{Vocal
-music}.
+Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
+en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
 @end quotation
 
 
 @node A lead sheet
 @subsection A lead sheet
 
-@cindex Lead sheets
-@cindex chords
-@cindex chord names
+@cindex partition de chanson
+@cindex chanson, partition complète
+@cindex accords, noms
+@cindex noms d'accords
 
-En musique de variété, il est courant d'indiquer l'accompagnement par
-le nom des accords.  De tels accords peuvent être entrés comme les
-notes :
+En musique de variété, il est courant d'indiquer l'accompagnement par le
+nom des accords.  De tels accords peuvent être entrés comme les notes :
 
 @lilypond[quote,ragged-right,verbatim]
 \chordmode { c2 f4. g8 }
 @end lilypond
 
-Maintenant, chaque hauteur est lue comme la base de l'accord à la
-place de la note.  Ce mode est activé avec @code{\chordmode}.
-D'autres accords peuvent être créés en ajoutant des modifiacteurs
-après deux points.  L'exemple suivant montre quelques modificateurs
-usuels :
+Maintenant, chaque hauteur est lue comme la base de l'accord à la place
+de la note.  Ce mode est activé avec @code{\chordmode}.  D'autres
+accords peuvent être créés en ajoutant des modificateurs après deux
+points.  L'exemple suivant montre quelques modificateurs usuels :
 
 @lilypond[quote,verbatim,ragged-right]
 \chordmode { c2 f4:m g4:maj7 gis1:dim7 }
@@ -1342,15 +1320,16 @@ usuels :
 Pour la musique improvisée, les accords ne sont pas imprimés sur des
 portées mais comme des lignes à part entière.  Ceci s'obtient en
 utilisant @code{\chords} à la place de @code{\chordmode}.  La même
-syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le
-rendu des notes interviendra dans un contexte de @code{ChordNames},
-avec le résultat suivant :
+syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu
+des notes interviendra dans un contexte @code{ChordNames}, avec le
+résultat suivant :
 
 @lilypond[quote,verbatim,ragged-right]
 \chords { c2 f4.:m g4.:maj7 gis8:dim7 }
 @end lilypond
 
-@cindex lead sheet
+@cindex partition de chanson
+@cindex chanson, partition complète
 Une fois assemblés, les accords, paroles et mélodie forment une
 partition de chanson :
 
@@ -1366,19 +1345,19 @@ partition de chanson :
 @end lilypond
 
 
-@moreinfo
+@seealso
 @quotation
-Une liste complète de modificateurs et d'autres options de mise en
-forme se trouve à la section @ref{Chords}.
+Une liste complète de modificateurs et d'autres options de mise en forme
+se trouve à la section @ruser{Chords}.
 @end quotation
 
 
 @node Final touches
 @section Final touches
 
-Voici l'ultime section de ce tutoriel, qui montre comment ajouter la
-touche finale à des morceaux simples, et sert d'introduction pour le
-reste du Manuel.
+L'ultime section de ce tutoriel montre comment ajouter une touche finale
+à des morceaux simples, et consititue une introduction au reste du
+manuel.
 
 @menu
 * Version number::
@@ -1393,36 +1372,34 @@ reste du Manuel.
 @node Version number
 @subsection Version number
 
-@cindex versioning
+@cindex versions
 La déclaration @code{\version} stipule le numéro de la version de
-LilyPond pour laquelle le fichier a été écrit.  Pour donner à un
-fichier la version 2.11.20, ajoutez
+LilyPond pour laquelle le fichier a été écrit,
 
 @example
-\version "2.11.20"
+\version @w{"@version{}"}
 @end example
 
 @noindent
-tout en haut de votre fichier LilyPond.
+que l'on place par convention en début de fichier.
 
 Cette annotation permet de faciliter les prochaines mises à jour de
-LilyPond.  Les changements dans la syntaxe sont gérés avec un
-programme spécial, @file{convert-ly} -- voir @ref{Updating files with
-convert-ly} -- et il utilise @code{\version} pour déterminer les
-règles de conversion à appliquer au fichier.
+LilyPond.  Les changements dans la syntaxe sont gérés avec un programme
+spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly}
+--- et il utilise @code{\version} pour déterminer les règles de
+conversion à appliquer au fichier.
 
 
 @node Adding titles
 @subsection Adding titles
 
-Les informations bibliographiques (nom du morceau, du compositeur,
-etc) sont entrées dans un bloc séparé, le bloc d'en-tête
-(@code{\header}), qui existe indépendamment des expressions musicales
-principales.  Le bloc @code{\header} est habituellement placé en début
-de fichier.
+Les informations bibliographiques (nom du morceau, du compositeur, etc)
+sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}),
+qui existe indépendamment des expressions musicales principales.  Le
+bloc @code{\header} est habituellement placé en début de fichier.
 
 @example
-\version "2.11.20"
+\version "2.11.38"
 \header @{
   title = "Symphonie"
   composer = "Moi"
@@ -1433,23 +1410,23 @@ de fichier.
  @dots{} music @dots{}
 @}
 @end example
-Quand le fichier est traité, le titre et le compositeur sont imprimés
-en haut de la partition.  Vous trouverez plus d'informations sur les
-titres à @ref{Creating titles}.
+Quand le fichier est traité, le titre et le compositeur sont imprimés en
+haut de la partition.  Vous trouverez plus d'informations sur les titres
+à @ruser{Creating titles}.
 
 @node Absolute note names
 @subsection Absolute note names
 
-Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
-définir les hauteurs de notes.  Si c'est effectivement le moyen le
-plus simple d'entrer la majeure partie de votre musique, il existe une
-autre façon de procéder : le mode de hauteurs absolues.
+Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir
+les hauteurs de notes.  Si c'est effectivement le moyen le plus simple
+d'entrer la majeure partie de votre musique, il existe une autre façon
+de procéder : le mode des hauteurs absolues.
 
 Si vous omettez la commande @code{\relative}, LilyPond considérera
 toutes les hauteurs comme des hauteurs absolues.  Un @code{c'} sera
-toujours un do du milieu, un @code{b} sera toujours une note
-au-dessous du précédent, et un @code{g,} sera toujours la note la plus
-grave dans la portée de clé de Fa.
+toujours un do du milieu, un @code{b} sera toujours une note au-dessous
+du précédent, et un @code{g,} sera toujours la note la plus grave dans
+la portée de clé de fa.
 
 @lilypond[quote,verbatim,ragged-right]
 {
@@ -1476,8 +1453,8 @@ Voici une gamme sur 4 octaves :
 }
 @end lilypond
 
-Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire
-de la musique dans un registre aigu.  Regardez cet extrait de Mozart :
+Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de
+la musique dans un registre aigu.  Regardez cet extrait de Mozart :
 
 @lilypond[quote,verbatim,ragged-right]
 {
@@ -1489,8 +1466,8 @@ de la musique dans un registre aigu.  Regardez cet extrait de Mozart :
 @end lilypond
 
 Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc
-une source d'erreurs.  En mode @code{\relative}, le même exemple
-devient bien plus facile à lire :
+une source d'erreurs.  En mode @code{\relative}, le même exemple devient
+bien plus facile à lire :
 
 @lilypond[quote,verbatim,ragged-right]
 \relative c'' {
@@ -1502,14 +1479,14 @@ devient bien plus facile à lire :
 @end lilypond
 
 Si d'aventure vous faites une erreur d'octaviation, le mode
-@code{\relative} la rendra frappante -- toutes les notes suivantes
-seront placées à la mauvaise octave.  En mode de hauteurs absolues,
-une erreur isolée ne serait pas aussi visible, et donc aussi facile à
+@code{\relative} la rendra frappante --- toutes les notes suivantes
+seront placées à la mauvaise octave.  En mode de hauteurs absolues, une
+erreur isolée ne serait pas auntant visible, et donc aussi facile à
 dénicher.
 
-Cependant, le mode de hauteurs absolues reste utile pour les musiques
-où les intervalles sont étendus, surtout pour les fichiers LilyPond
-créés par ordinateur.
+Cependant, le mode de hauteurs absolues reste utile pour les musiques où
+les intervalles sont étendus, surtout pour les fichiers LilyPond créés
+par ordinateur.
 
 
 @node Organizing pieces with identifiers
@@ -1517,10 +1494,10 @@ créés par ordinateur.
 
 Lorsque l'on combine tous les éléments étudiés plus haut pour produire
 des fichiers plus volumineux, les blocs @code{\score} deviennent
-beaucoup plus gros parce que les expressions musicales sont plus
-longues et, dans le cas des pièces polyphoniques, profondément
-imbriquées.  De telles expressions imposantes finissent par devenir
-peu maniables.  Cet inconvénient peut être résolu par l'utilisation
+beaucoup plus gros parce que les expressions musicales sont plus longues
+et, dans le cas des pièces polyphoniques, profondément imbriquées.  De
+telles expressions imposantes finissent par devenir peu maniables.  Cet
+inconvénient peut être résolu par l'utilisation
 d'@emph{identificateurs}.
 
 En utilisant ces identificateurs, que l'on pourrait aussi appeler
@@ -1533,9 +1510,9 @@ MusiqueToto = @{ @dots{} @}
 
 Le contenu de l'expression musicale @code{MusiqueToto} pourra être
 utilisé plus loin en faisant précéder son nom d'un anti-slash,
-c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle
-commande LilyPond.  Tous les identificateurs doivent être définis
-@emph{avant} l'expression musicale principale.
+c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande
+LilyPond.  Tous les identificateurs doivent être définis @emph{avant}
+l'expression musicale principale.
 
 @lilypond[quote,verbatim,ragged-right]
 violin = \new Staff { \relative c'' {
@@ -1566,8 +1543,7 @@ aFivePaper = \paper @{ paperheight = 21.0 \cm @}
 @end example
 
 En fonction de son contenu, un identificateur peut être utilisé à
-différents endroits.  L'exemple suivant utilise la variable ci-dessus
-:
+différents endroits.  L'exemple suivant utilise la variable ci-dessus :
 
 @example
 \paper @{
@@ -1581,42 +1557,42 @@ différents endroits.  L'exemple suivant utilise la variable ci-dessus
 @node After the tutorial
 @subsection After the tutorial
 
-Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire
-un morceau ou deux.  Commencez par copier l'un des modèles types
-(@ref{Templates}) et ajoutez-y des notes.  Si vous voulez employer une
-notation que vous n'avez pas trouvé dans le tutoriel, consultez la
-référence de notation, en commençant par la @ref{Basic notation}.  Si
-vous désirez écrire pour un ensemble instrumental non couvert par les
-@ref{Example templates}, lisez la section @ref{Extending the
-templates}.
-
-Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
-du manuel d'apprentissage.  Rien ne s'oppose à ce que vous consultiez
-dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du
-manuel de l'utilisateur part du principe que vous avez déjà bien
-assimilé la syntaxe de LilyPond.  Vous pouvez toujours survoler le
-reste du manuel, et y revenir plus tard après avoir acquis de
-l'expérience.
+Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
+morceau ou deux.  Commencez par copier l'un des @ruser{Templates} types et
+ajoutez-y des notes.  Si vous voulez employer une notation que vous
+n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
+en commençant par la @ruser{Basic notation}.  Si vous désirez écrire pour
+un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
+section @ruser{Extending the templates}.
+
+Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
+manuel d'apprentissage.  Rien ne s'oppose à ce que vous consultiez dès à
+présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel
+de l'utilisateur part du principe que vous avez déjà bien assimilé la
+syntaxe de LilyPond.  Vous pouvez toujours survoler le reste du manuel,
+et y revenir plus tard après avoir acquis de l'expérience.
 
 @node How to read the manual
 @subsection How to read the manual
 
-Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
-nombreux exemples du tutoriel n'ont pas fait apparaître le
+Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
+nombreux exemples du tutoriel n'ont pas fait apparaître
 @code{\relative c'' @{ ...  @}} dans l'extrait de code affiché.
 
-Dans le reste du manuel, les exemples utilisés sont encore beaucoup
-plus souples : parfois il leur manque le @code{\relative c'' @{ ...
-@}}, mais d'autres fois ils ont recours à une autre hauteur de
-référence, telle que @code{c'} ou @code{c,,}), et dans certains cas
-c'est même l'exemple entier qui est en mode de hauteurs absolues !
-Cependant, de telles ambiguïtés ne se trouvent que dans des contextes
-où les hauteurs n'ont que peu d'importance.  Dans tous les exemples où
-elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est
-explicitement spécifié.
-
-Si vous ne vous y retrouvez toujours pas pour savoir quel code
-LilyPond produit précisément tel ou tel exemple, consultez la version
-HTML de ce manuel (si ce n'est pas déjà le cas), et cliquez sur
-l'image de la partition.  La source exacte utilisée pour générer ce
-manuel s'affichera alors.
+Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus
+souples : parfois il leur manque le @code{\relative c'' @{ ...  @}},
+mais d'autres fois ils ont recours à une autre hauteur de référence,
+telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même
+l'exemple entier qui est en mode de hauteurs absolues !  Cependant, de
+telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs
+n'ont que peu d'importance.  Dans tous les exemples où elles en ont, le
+mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié.
+
+Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond
+produit précisément tel ou tel exemple, consultez la version HTML de ce
+manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la
+partition.  La source exacte utilisée pour générer ce manuel s'affichera
+alors.
+
+Pour en savoir plus sur l'organisation de la suite de ce manuel,
+reportez-vous à @ruser{About this manual}.