]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/pitches.itely
Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation
[lilypond.git] / Documentation / fr / notation / pitches.itely
index 52227dd13a2d68ed3393252b57e87101cb7609c1..2142ff86a7d13e359b3dd37f2e7b9e6a55ad3304 100644 (file)
@@ -1,50 +1,56 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
-    Translation of GIT committish: a6b100669bfc3847b3a03029d6a46ee9b1609e73
+    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes.
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.19.22"
 
-@c Translators: Frédéric Chiasson
+@c Translators: Frédéric Chiasson, Jean-Charles Malahieude
 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
 
-@node Pitches
-@section Pitches
+@node Hauteurs
+@section Hauteurs
+@translationof Pitches
 
 @lilypondfile[quote]{pitches-headword.ly}
 
-Cette section détaille la façon d'indiquer les hauteurs de notes, sous
-trois aspects : la saisie des hauteurs, la modification des hauteurs
-et les options de gravure.
+Cette section détaille la façon d'indiquer la hauteur des notes, sous
+trois aspects : la saisie des hauteurs, la modification des hauteurs et
+les options de gravure.
 
 @menu
-* Writing pitches::             
-* Changing multiple pitches::   
-* Displaying pitches::          
-* Note heads::                  
+* Écriture des hauteurs de note::
+* Modification de plusieurs hauteurs::
+* Gravure des hauteurs::
+* Têtes de note::
 @end menu
 
 
-@node Writing pitches
-@subsection Writing pitches
+@node Écriture des hauteurs de note
+@subsection Écriture des hauteurs de note
+@translationof Writing pitches
 
-Cette section explique la manière d'indiquer les hauteurs de note.  Il
-y a deux modes d'indiquer l'octave des notes : le mode absolu, et le
-mode relatif.  Le dernier est le plus pratique lors de la saisie d'un
+Cette section explique la manière d'indiquer les hauteurs de note.  Deux
+modes permettent d'indiquer l'octave des notes : le mode absolu, et le
+mode relatif.  Ce dernier est le plus pratique lors de la saisie d'un
 fichier source au clavier de l'ordinateur.
 
 @menu
-* Absolute octave entry::       
-* Relative octave entry::       
-* Accidentals::                 
-* Note names in other languages::  
+* Hauteurs avec octave absolue::
+* Octaves relatives::
+* Altérations::
+* Nom des notes dans d'autres langues::
 @end menu
 
-@node Absolute octave entry
-@unnumberedsubsubsec Absolute octave entry
+
+@node Hauteurs avec octave absolue
+@unnumberedsubsubsec Hauteurs avec octave absolue
+@translationof Absolute octave entry
 
 @cindex noms de note
 @cindex hauteurs
@@ -52,179 +58,317 @@ fichier source au clavier de l'ordinateur.
 @cindex absolues, octaves
 @cindex octaves absolues
 
-La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
-notation batave, en utilisant les lettres @code{a} à @code{g}.
-Une gamme ascendante de do majeur s'écrit
+La hauteur s'écrit -- à moins de préciser une autre langue -- avec la
+notation batave, en utilisant les lettres de @code{a} à @code{g}.
+Les notes @code{c} (do) et @code{b} (si) sont écrites une octave sous le
+do central.
 
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef bass
-c d e f g a b c'
+@c don't use c' here.
+@lilypond[verbatim,quote]
+{
+  \clef bass
+  c4 d e f
+  g4 a b c
+  d4 e f g
+}
 @end lilypond
 
-La note @code{c} est écrite une octave sous le do central.
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef treble
-c1
-\clef bass
-c1
-@end lilypond
+@cindex octave, spécification
 
 @funindex '
 @funindex ,
 
-L'octave peut être précisée sous forme d'une série d'apostrophes
-@samp{'} ou d'une série de virgules @samp{,}.  Chaque @samp{'} hausse la
-note d'une octave, chaque @samp{,} baisse la note d'une octave.
+L'octave peut être précisée sous forme d'une série
+d'apostrophes @code{'} ou d'une série de virgules @code{,}.
+Chaque @code{'} hausse la note d'une octave ;
+chaque @code{,} baisse la note d'une octave.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\clef treble
-c' c'' e' g d'' d' d c
-\clef bass
-c, c,, e, g d,, d, d c
+@lilypond[verbatim,quote]
+{
+  \clef treble
+  c'4 c'' e' g
+  d''4 d' d c
+  \clef bass
+  c,4 c,, e, g
+  d,,4 d, d c
+}
 @end lilypond
 
-Il existe une autre méthode pour préciser à quelle octave se situe la
-note à graver ; cette méthode demande moins d'indications d'octave
-(@code{'} ou @code{,}) --- voir @ref{Relative octave entry}.
+@funindex absolute
+@funindex \absolute
+
+Une musique peut être déclarée explicitement comme étant en notation
+absolue à l'aide de la commande @code{\absolute} :
+
+@example
+\absolute @var{expression_musicale}
+@end example
+
+sera interprété en mode d'octaves absolues quel que soit le contexte où
+elle apparait.
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{Pitch names,Noms des notes}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
 
 
-@node Relative octave entry
-@unnumberedsubsubsec Relative octave entry
+@node Octaves relatives
+@unnumberedsubsubsec Octaves relatives
+@translationof Relative octave entry
 
 @cindex relatif
 @cindex indication d'octave relative
+@cindex octave relative, indication
+
 @funindex \relative
+@funindex relative
 
-On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
-hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
-à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
-Le mode d'écriture \relative prévient ces erreurs dans la mesure où
-elles deviennent beaucoup plus évidentes : une seule erreur décale le
-reste de la pièce à une mauvaise octave.
+Le mode d'écriture en octave absolue requiert d'indiquer l'octave de
+chaque note.  Pour le mode d'écriture en octave relative, par contre,
+l'octave d'une note est déterminée par rapport à la note précédente :
+modifier l'octave d'une note aura des répercussions sur toutes les notes
+à venir.
 
+Une musique peut être déclarée explicitement comme étant en notation
+relative à l'aide de la commande @code{\relative} :
 
 @example
-\relative @var{hauteur_de_référence} @var{musicexpr}
+\relative @var{hauteur_de_référence} @var{expression_musicale}
 @end example
 
-@noindent
-ou
+En mode relatif, chaque note est considérée comme étant le plus proche
+possible de celle qui la précède.  L'octave des notes mentionnées dans
+@var{expression_musicale} va être calculée de la manière suivante :
+
+@itemize
+@item
+Si aucun signe de changement d'octave n'est utilisé, l'intervalle de
+base entre la note actuelle et la précédente sera toujours au plus d'une
+quarte.  Cet intervalle est déterminé sans tenir compte des altérations.
+
+@item
+Un signe de changement d'octave @code{'} ou @code{,} peut être
+ajouté pour hausser ou baisser la note d'une octave par rapport à la
+hauteur calculée sans spécification.
+
+@item
+Ces signes de changement d'octave peuvent être multipliés.  Par exemple,
+@code{''} ou @code{,,} ajouteront une octave supplémentaire.
+
+@item
+La première hauteur de @code{@var{expression_musicale}} est
+déterminée relativement à @code{@var{hauteur_de_référence}}.
+Cette @code{@var{hauteur_de_référence}} s'exprime en octave
+absolue ; plusieurs options s'offrent à vous :
+
+@table @asis
+@item une octave de do (@code{c})
+Un @code{c'} identifiant le do placé entre les portées d'un piano,
+il est de fait aisé de déterminer d'autres octaves de @code{c}.
+Pour une musique qui commencerait par un sol dièse (@code{gis}) au
+dessus du do suraigu (@code{c'''}), vous écririez quelque chose
+comme @code{\relative @{ gis''' @dots{} @}}
+
+@item une octave de la première note de l'expression
+Écrire @code{\relative @{ gis''' @dots{} @}} permet de
+déterminer facilement la hauteur absolue de la première note de
+l'expression.
+
+@item pas de hauteur de référence explicite
+Ceci (écrire @code{\relative @{ gis''' @dots{} @}}) peut se voir
+comme une version abrégée de l'option précédente : la première
+note de l'expression est écrite en octave absolue.  Cette option
+est équivalente à prendre un @code{f} comme hauteur de référence.
+@end table
 
-@example
-\relative @var{musicexpr}
-@end example
+La documentation de LilyPond utilise en règle générale la première
+option.
+@end itemize
 
-@noindent
-@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
-définie.
-
-L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
-la manière suivante : si aucun signe de changement d'octave n'est
-utilisé, l'intervalle de base entre la note actuelle et la précédente
-sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
-tenir compte des altérations ; ainsi un @code{fisis} après un
-@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
-une quarte doublement augmentée demeure considérée comme un intervavlle
-plus petit qu'une quinte diminuée, bien que la quarte doublement
-augmentée soit de sept demi-tons et la quinte diminuée de seulement six
-demi-tons.
-
-Les signes de changement d'octave @code{'} et @code{,} peuvent être
-ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
-Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
-départ peut être spécifiée, et agira dès lors comme si elle précédait la
-première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
-spécifiée, le do central sert de point de départ.
-
-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
+Voici le mode @code{\relative} en action.
+
+@lilypond[verbatim,quote]
+\relative {
+  \clef bass
+  c d e f
+  g a b c
+  d e f g
 }
 @end lilypond
 
 On utilise les signes de changement d'octave pour les intervalles
 dépassant la quarte.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
+@lilypond[verbatim,quote]
+\relative {
+  c'' g c f,
+  c' a, e'' c
 }
 @end lilypond
 
-Si l'expression précédente est un accord, c'est la première note de
-l'accord qui détermine l'emplacement de la première note du prochain
-accord.
+Bien que ne comportant aucun signe de changement d'octave, une séquence
+de notes peut tout à fait couvrir un intervalle important.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
+@lilypond[verbatim,quote]
+\relative {
+  c f b e
+  a d g c
 }
 @end lilypond
 
-La hauteur après @code{\relative} contient un nom de note.
+Lorsque plusieurs blocs @code{\relative} sont imbriqués, c'est la
+dernière clause @code{\relative} qui est prise en compte.
 
-La conversion en mode \relative n'affectera pas les sections @code{\transpose},
-@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
-utiliser \relative dans de la musique transposée, un code
-@code{\relative} additionnel doit être placé dans @code{\transpose}.
+@lilypond[verbatim,quote]
+\relative {
+  c' d e f
+  \relative {
+    c'' d e f
+  }
+}
+@end lilypond
 
+@code{\relative} est sans effet sur un bloc @code{\chordmode}.
 
-@node Accidentals
-@unnumberedsubsubsec Accidentals
+@lilypond[verbatim,quote]
+\new Staff {
+  \relative c''' {
+    \chordmode { c1 }
+  }
+  \chordmode { c1 }
+}
+@end lilypond
 
-@cindex noms de note, hollandais
-@cindex noms de note, par défaut
+@code{\relative} n'est pas permis au sein d'un bloc @code{\chordmode}.
 
-Dans la notation par défaut, un dièse est formé en ajoutant @code{-is}
-après le nom de note, un bémol en ajoutant @code{-es}.  Les
-double-dièses et double-bémols sont obtenus en ajoutant @code{-isis}
-ou @code{-eses} au nom de note.
+Pour utiliser le mode d'octave relative dans de la musique transposée,
+une clause @code{\relative} additionnelle doit être placée au sein du
+bloc @code{\transpose}.
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
+@lilypond[verbatim,quote]
+\relative {
+  d' e
+  \transpose f g {
+    d e
+    \relative {
+      d' e
+    }
+  }
+}
 @end lilypond
 
-@noindent
-Ce sont les noms de note hollandais.  En hollandais, on élide @code{aes}
-pour écrire @code{as}, mais les deux formes sont acceptées.  De manière
-similaire, on accepte aussi bien @code{es} que @code{ees}.
+@cindex accords et octave relative
+@cindex octave relative et accords
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
+Si l'expression précédente est un accord, c'est la première note de
+l'accord qui détermine l'emplacement de la première note du prochain
+accord.  À l'intérieur de l'accord, les notes sont placées relativement
+à celle qui précède.  Examinez avec attention l'exemple suivant, et tout
+particulièrement le positionnement des do.
+
+@lilypond[verbatim,quote]
+\relative {
+  c'
+  <c e g>
+  <c' e g'>
+  <c, e, g''>
+}
 @end lilypond
 
-Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
-ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
-bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
-donnera une note bécarre.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a4 aes a2
+Comme nous l'avons vu, l'octaviation est déterminée sans tenir compte
+des altérations.  Ainsi un mi double-dièse qui suit un si naturel sera
+placé au-dessus de celui-ci, alors qu'un fa double-bémol se retrouvera
+en dessous.  En d'autres termes, une quarte doublement augmentée
+demeure considérée comme un intervalle plus petit qu'une quinte
+diminuée, bien que la quarte doublement augmentée soit de sept demi-tons
+et la quinte diminuée de seulement six demi-tons.
+
+@lilypond[verbatim,quote]
+\relative {
+  c''2 fis
+  c2 ges
+  b2 eisis
+  b2 feses
+}
 @end lilypond
 
-LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
-naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
-Pour plus d'information à propos de la distinction entre le contenu
-musical et sa représentation, voir @rlearning{Accidentals and key signatures}.
+L'une des conséquences de toutes ces règles est que la première note
+rencontrée dans un fragment balisé par @code{\relative  f} sera
+interprétée tout comme si elle avait été saisie en mode absolu.
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{fifth,quinte},
+@rglosnamed{interval,intervalle},
+@rglosnamed{Pitch names,nom des notes}.
+
+Manuel de notation :
+@ref{Vérifications d'octave}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{RelativeOctaveMusic}.
+
+
+@node Altérations
+@unnumberedsubsubsec Altérations
+@translationof Accidentals
 
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
+@cindex altération
+@cindex armure
+@cindex clef
+
+@c duplicated in Key signature and in Accidentals
+@warning{Les nouveaux utilisateurs sont parfois déroutés par la gestion
+des altérations et de l'armure. Pour LilyPond, un nom de note spécifie
+une hauteur ; l'armure et la clef ne feront que déterminer comment ces
+hauteurs seront retranscrites.  Un simple @code{c} signifie tout
+bonnement « do naturel » quelles que soient l'armure et la clef en
+vigueur. Pour plus d'information, reportez-vous au chapitre
+@rlearning{Hauteurs et armure}.}
+
+@cindex noms de note, hollandais
+@cindex noms de note, par défaut
+@cindex hauteur, nom par défaut
+@cindex dièse
+@cindex bémol
+@cindex double dièse
+@cindex double bémol
+@cindex naturel
+@cindex bécarre
+
+Dans la notation par défaut, un @notation{dièse} est formé en ajoutant
+@code{is} après le nom de note, un @notation{bémol} en ajoutant
+@code{es}.  Les @notation{double-dièses} et @notation{double-bémols}
+sont obtenus en ajoutant respectivement @code{isis} ou @code{eses} au
+nom de note.  Ce sont les noms de note hollandais.  Pour les autres
+langues, consultez @ref{Nom des notes dans d'autres langues}.
+
+@lilypond[verbatim,quote,relative=2]
+ais1 aes aisis aeses
 @end lilypond
 
+Une hauteur naturelle se saisit comme un simple nom de note, sans
+suffixe.  Un bécarre sera imprimé si besoin est, que ce soit pour
+annuler les effets d'un précédente altération accidentelle ou pour
+déroger à l'armure.
+
+@lilypond[verbatim,quote,relative=2]
+a4 aes a2
+@end lilypond
 
 @cindex quarts de ton
-@cindex demi-bémols, demi-dièses
+@cindex demi-bémols
+@cindex demi-dièses
 
 Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
-@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
-croissantes :
+@code{eh} et @code{ih}. Voici une série de dos altérés en hauteurs
+croissantes :
 
 @lilypond[verbatim,quote,relative=2]
 ceseh1 ces ceh c cih cis cisih
@@ -232,1126 +376,2841 @@ ceseh1 ces ceh c cih cis cisih
 
 Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 
-
-@cindex altération, de précaution
-@cindex altération, entre parenthèses
 @cindex altération de précaution
-@funindex ?
 @cindex altération entre parenthèses
+@cindex précaution, altération de
+@cindex parenthèses, altération entre
+
+@funindex ?
 @funindex !
 
 Normalement, les altérations sont imprimées automatiquement, mais il se
 peut que vous vouliez les imprimer manuellement.  On peut forcer
-l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
-point d'exclamation @samp{!} après la hauteur de note.  Une altération
-entre parenthèses peut être obtenue en ajoutant un point d'interrogation
-@samp{?} après la hauteur de note.  Ces signes peuvent aussi être
-utilisés pour imprimer des bécarres.
+l'impression d'une altération, dite « de précaution », en ajoutant un
+point d'exclamation @code{!} après la hauteur de note.  Une altération
+entre parenthèses peut être obtenue en ajoutant un point
+d'interrogation @code{?} après la hauteur de note.
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-cis cis cis! cis? c c? c! c
+@lilypond[verbatim,quote,relative=2]
+cis cis cis! cis? c c c! c?
 @end lilypond
 
+@cindex altération et liaison de tenue
+@cindex liaison de tenue et altération
+
+Lorsqu'une note est prolongée par une liaison de tenue, l'altération ne
+sera réimprimée que s'il y a un saut de ligne.
+
+@lilypond[verbatim,quote,relative=2,ragged-right]
+cis1 ~ 1 ~
+\break
+cis
+@end lilypond
 
 @snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle,ragged-right]
+{hiding-accidentals-on-tied-notes-at-the-start-of-a-new-system.ly}
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {preventing-extra-naturals-from-being-automatically-added.ly}
 
-
 @seealso
-Référence du programme : @rinternals{LedgerLineSpanner},
-@rinternals{NoteHead}.
-
-L'impression automatique des altérations peut être affinée de plusieurs
-manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
-
+Glossaire musicologique :
+@rglosnamed{sharp,dièse},
+@rglosnamed{flat,bémol},
+@rglosnamed{double sharp,double dièse},
+@rglosnamed{double flat,double bémol},
+@rglosnamed{Pitch names,Nom des notes},
+@rglosnamed{quarter tone,quart de ton}.
+
+Manuel d'initiation :
+@rlearning{Hauteurs et armure}.
+
+Manuel de notation :
+@ref{Altérations accidentelles automatiques},
+@ref{Altérations suggérées (musica ficta)},
+@ref{Nom des notes dans d'autres langues}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Références des propriétés internes :
+@rinternals{Accidental_engraver},
+@rinternals{Accidental},
+@rinternals{AccidentalCautionary},
+@rinternals{accidental-interface}.
+
+@cindex accidentel, quart de ton
+@cindex quart de ton
 
 @knownissues
-
 Il n'y a pas de standard universellement accepté pour noter le bémol et
 demi (qui abaisse la hauteur trois quarts de ton), le symbole de
 LilyPond n'est donc conforme à aucun standard.
 
 
+@node Nom des notes dans d'autres langues
+@unnumberedsubsubsec Nom des notes dans d'autres langues
+@translationof Note names in other languages
 
-@node Note names in other languages
-@unnumberedsubsubsec Note names in other languages
+@cindex notes, noms selon la langue
+@cindex noms de note, langues
+@cindex langues, noms de note
 
-Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
-langues.  Pour les utiliser, incluez le fichier d'initialisation
-spécifique à la langue voulue.  Par exemple, pour les langues romanes,
-ajoutez @code{\include "italiano.ly"} au début du fichier source.  Les
-fichiers de langues disponibles ainsi que les noms de notes utilisés
-sont les suivants :
+Vous disposez de jeux prédéfinis de noms de note et altérations pour
+plusieurs autres langues.  Pour les utiliser, il suffit de déclarer, en
+début de fichier, la langue que vous utilisez.  Voici comment, par
+exemple, utiliser l'italien pour votre saisie :
 
-@cindex noms de note, autres langues
-@example
-                       Noms de note              dièse       bémol      double          double
-                                                                        dièse           bémol
-nederlands.ly  c   d   e   f   g   a   bes b   -is         -es          -isis           -eses
-english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat     -ss/-x/         -ff/
-                                                                        -sharpshsarp    -flatflat
-deutsch.ly     c   d   e   f   g   a   b   h   -is         -es          -isis           -eses
-norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es     -ississ/-isis   -essess/-eses
-svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess         -ississ         -essess
-italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b           -dd             -bb
-catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b           -dd/-ss         -bb
-espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b           -ss             -bb
-@end example
+@lilypond[quote,verbatim]
+\language "italiano"
+
+\relative {
+  do' re mi sib
+}
+@end lilypond
+
+Les langues disponibles ainsi que les noms de note utilisés
+sont les suivants :
+
+@quotation
+@multitable {@code{nederlands}} {do re mi fa sol la sib si}
+@headitem Langue
+  @tab Nom des notes
+@item @code{nederlands}
+  @tab c d e f g a bes b
+@item @code{catalan}
+  @tab do re mi fa sol la sib si
+@item @code{deutsch}
+  @tab c d e f g a b h
+@item @code{english}
+  @tab c d e f g a bf b
+@item @code{espanol} ou @code{español}
+  @tab do re mi fa sol la sib si
+@item @code{italiano} ou @code{français}
+  @tab do re mi fa sol la sib si
+@item @code{norsk}
+  @tab c d e f g a b h
+@item @code{portugues}
+  @tab do re mi fa sol la sib si
+@item @code{suomi}
+  @tab c d e f g a b h
+@item @code{svenska}
+  @tab c d e f g a b h
+@item @code{vlaams}
+  @tab do re mi fa sol la sib si
+@end multitable
+@end quotation
+
+@noindent
+et les suffixes d'altération correspondants :
+
+@quotation
+@multitable {@code{nederlands}} {-s/--sharp} {-ess/-es} {-ss/-x/--sharpsharp} {-essess/-eses}
+@headitem Langue
+  @tab dièse @tab bémol @tab double dièse @tab double bémol
+@item @code{nederlands}
+  @tab -is @tab -es @tab -isis @tab -eses
+@item @code{catalan}
+  @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
+@item @code{deutsch}
+  @tab -is @tab -es @tab -isis @tab -eses
+@item @code{english}
+  @tab -s/--sharp @tab -f/--flat @tab -ss/-x/--sharpsharp
+    @tab -ff/--flatflat
+@item @code{espanol} ou @code{español}
+  @tab -s @tab -b @tab -ss/-x @tab -bb
+@item @code{italiano} ou @code{français}
+  @tab -d @tab -b @tab -dd @tab -bb
+@item @code{norsk}
+  @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
+    @tab -essess/-eses
+@item @code{portugues}
+  @tab -s @tab -b @tab -ss @tab -bb
+@item @code{suomi}
+  @tab -is @tab -es @tab -isis @tab -eses
+@item @code{svenska}
+  @tab -iss @tab -ess @tab -ississ @tab -essess
+@item @code{vlaams}
+  @tab -k @tab -b @tab -kk @tab -bb
+@end multitable
+@end quotation
 
 @noindent
 Notez qu'en hollandais, en allemand, en norvégien et en suédois, un
-@samp{la} altéré de bemol se note @code{aes} et @code{aeses}.  Ces
-formes sont contractées en @code{as} et @code{ases} (ou plus communément
-@code{asas}).  Dans certains fichiers linguistiques, seules ces formes
-abrégées ont été définies ; ceci s'applique aussi aux suffixes pour les
-quarts de ton.
+@notation{la} altéré de @notation{bémol} se note @code{aes} et
+@code{aeses}.  Ces formes sont contractées en @code{as} et @code{ases}
+(ou plus communément @code{asas}).  Dans certains fichiers
+linguistiques, seules ces formes abrégées ont été définies.
+
+@lilypond[verbatim,quote,relative=2]
+a2 as e es a ases e eses
+@end lilypond
+
+@cindex microtonalités
+@cindex demi-dièse
+@cindex demi-bémol
+@cindex sesqui-dièse
+@cindex sesqui-bémol
 
 @noindent
 Certaines musiques utilisent des microtonalités, pour lesquelles les
-altérations sont des fractions de dièse ou bémol @qq{normaux}.  Le
+altérations sont des fractions de dièse ou bémol « normaux ».  Le
 tableau suivant répertorie les noms de note en quart de ton, tels que
-définis dans plusieurs fichiers linguistiques. Les préfixes @q{semi-} et
-@q{sesqui-} correspondent au @q{demi-} et @q{trois demis}.  À noter
-qu'aucune définition n'existe à ce jour pour le norvégien, le suédois,
-le catalan et l'espagnol.
+définis dans plusieurs fichiers linguistiques.  Les préfixes @emph{semi-}
+et @emph{sesqui-} correspondent au @emph{demi-} et @emph{trois demis}.
+À noter qu'aucune définition n'existe à ce jour pour le norvégien, le
+suédois, le catalan et l'espagnol.
+
+@quotation
+@multitable {@code{nederlands}} {@b{semi-dièse}} {@b{semi-bémol}} {@b{sesqui-dièse}} {@b{sesqui-bémol}}
+@headitem Langue
+  @tab semi-dièse @tab semi-bémol @tab sesqui-dièse @tab sesqui-bémol
+@item @code{nederlands}
+  @tab -ih @tab -eh @tab -isih @tab -eseh
+@item @code{deutsch}
+  @tab -ih @tab -eh @tab -isih @tab -eseh
+@item @code{english}
+  @tab -qs @tab -qf @tab -tqs @tab -tqf
+@item @code{espanol}
+  @tab -cs @tab -cb @tab -tcs @tab -tcb
+@item @code{italiano}
+  @tab -sd @tab -sb @tab -dsd @tab -bsb
+@item @code{portugues}
+  @tab -sqt @tab -bqt @tab -stqt @tab -btqt
+@end multitable
+@end quotation
 
-@c What about Turkish Maquam music and similar microtonal systems?
-@c
-@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
-@c is actually misleading since the alteration is in fact one and a half
-@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
+La plupart des langues dont nous venons de parler correspondent à la
+musique classique occidentale au tempérament égal -- le concept de
+@emph{Common Practice Period} en anglais.  LilyPond prend néanmoins en
+charge d'autres systèmes de notation, comme indiqué au chapitre
+@ref{Noms des notes et altérations non-occidentaux}.
 
-@example
-                        Noms de note           semi-   semi-  sesqui-  sesqui-
-                                               dièse   bémol  dièse    bémol
-
-nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
-english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
-deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
-norsk.ly       c   d   e   f   g   a   b   h   
-svenska.ly     c   d   e   f   g   a   b   h   
-italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
-catalan.ly     do  re  mi  fa  sol la  sib si  
-espanol.ly     do  re  mi  fa  sol la  sib si  
-@end example
+@seealso
+Glossaire musicologique :
+@rglosnamed{Pitch names,Nom des notes},
+@rglos{Common Practice Period}.
+
+Manuel de notation :
+@ref{Noms des notes et altérations non-occidentaux}.
+
+Fichiers d'initialisation :
+@file{scm/define-note-names.scm}.
 
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
 
-@node Changing multiple pitches
-@subsection Changing multiple pitches
+
+@node Modification de plusieurs hauteurs
+@subsection Modification de plusieurs hauteurs
+@translationof Changing multiple pitches
+
+Cette partie traite de la manière de modifier les hauteurs de note.
 
 @menu
-* Octave checks::                
-* Transpose::                   
+* Vérifications d'octave::
+* Transposition::
+* Inversion::
+* Rétrogradation::
+* Transformations modales::
 @end menu
 
-@node Octave checks
-@unnumberedsubsubsec Octave checks
 
-@cindex vérification d'octave
+@node Vérifications d'octave
+@unnumberedsubsubsec Vérifications d'octave
+@translationof Octave checks
 
-Les tests d'octave rendent la correction d'erreurs d'octave plus facile
-dans le mode d'octave @code{relative} : une note peut être suivie de
-@code{=}@var{apostrophes/virgules} pour indiquer à quelle octave absolue
-elle devrait être.  Dans l'exemple suivant,
+@cindex vérification d'octave
+@cindex octave, vérification
+@cindex contrôle des hauteurs
 
-@example
-\relative c'' @{ c='' b=' d,='' @}
-@end example
+@funindex =
+@funindex \octaveCheck
+@funindex octaveCheck
+@funindex controlpitch
 
-@noindent
-le @code{d} générera un avertissement, puisqu'on attend un @code{d''}
-mais qu'on obtient un @code{d'} --- il n'y a qu'une tierce entre
-@code{b'} et @code{d''}.  Sur la partition, l'octave sera corrigée pour
-donner un @code{d''} et la prochaine note sera calculée en fonction de
-@code{d''} et non de @code{d'}.
+Les tests d'octave rendent la correction d'erreurs d'octave plus facile
+dans le mode d'octave @code{relative} -- un @code{,} ou
+un @code{'} oublié, ça n'arrive pas qu'aux autres !
+
+Une note peut être suivie de @w{@code{=}@var{apostrophes/virgules}}
+pour indiquer à quelle @strong{octave absolue} elle devrait être.  Dans
+l'exemple suivant, le premier @code{d} générera un avertissement,
+puisqu'on attend un @code{d''} -- intervalle inférieur à la quarte --
+mais qu'on obtient un @code{d'}.  Sur la partition, l'octave sera
+corrigée pour donner un @code{d'} et la prochaine note sera calculée en
+fonction de ce @code{d'} et non de @code{d''}.
+
+@lilypond[verbatim,quote]
+\relative {
+  c''2 d='4 d
+  e2 f
+}
+@end lilypond
 
 Il existe aussi une vérification d'octave qui ne produit pas de musique
 imprimée, ayant pour syntaxe
+@code{\octaveCheck @var{hauteur_référence}} --
+@code{@var{hauteur_référence}} étant spécifiée en mode absolu.  Cette
+commande vérifie que l'intervalle entre la note qui précède et
+@code{@var{hauteur_référence}} est inférieur à la quinte comme il se
+doit en mode relatif.  Dans le cas contraire, un message sera émis et la
+note précédente ne sera pas modifiée.  Les notes suivantes seront, par
+contre, positionnées relativement à @code{@var{hauteur_référence}}.
+
+@lilypond[verbatim,quote]
+\relative {
+  c''2 d
+  \octaveCheck c'
+  e2 f
+}
+@end lilypond
 
-@example
-\octaveCheck @var{hauteur}
-@end example
-
-Cette commande vérifie que la @var{hauteur} considérée sans apostrophe
-ni virgule et comme hauteur relative, est la même que la @var{hauteur}
-absolue considérée avec ses éventuelles apostrophes ou virgules.  Sinon,
-un avertissement est émis et l'octave est corrigée.  La @var{hauteur}
-n'est pas considérée comme une note, et donc n'est pas imprimée.
-
-Dans l'exemple ci-dessous, le premier test réussit, puisque le @code{e}
---- dans le mode @code{relative} --- est au plus à une quarte de
-@code{a'}.  Cependant, le deuxième test produit un avertissement,
-puisque le @code{e} est à quinte de @code{b'}.  Le message
-d'avertissement est émis, et l'octave est corrigée afin que les notes
-suivantes soient à nouveau à la bonne octave.
-
-@example
-\relative c' @{
-  e
-  \octaveCheck a'
-  \octaveCheck b'
-@}
-@end example
+Dans les deux mesures qui suivent, les premier et troisième
+@code{\octaveCheck} échouent, mais le deuxième est concluant.
 
-L'octave d'une note qui suit un test d'octave est déterminée selon la
-note précédente.  Dans l'exemple suivant, la dernière note est un
-@code{a'}, au-dessus du do central.  Cela veut dire que le test
-@code{\octaveCheck} réussit, et peut donc être enlevé sans changer le
-résultat sur la partition.
+@lilypond[verbatim,quote]
+\relative {
+  c''4 f g f
 
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octaveCheck b
-  a
+  c4
+  \octaveCheck c'
+  f
+  \octaveCheck c'
+  g
+  \octaveCheck c'
+  f
 }
 @end lilypond
 
+@seealso
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{RelativeOctaveCheck}.
 
-@node Transpose
-@unnumberedsubsubsec Transpose
+
+@node Transposition
+@unnumberedsubsubsec Transposition
+@translationof Transpose
 
 @cindex transposition
 @cindex transposition des hauteurs
+
 @funindex \transpose
+@funindex transpose
 
 Une expression musicale peut être transposée avec @code{\transpose}.
-Voici la syntaxe :
+En voici la syntaxe :
+
 @example
-\transpose @var{note_de départ} @var{note_d_arrivée} @var{musicexpr}
+\transpose @var{note_de_départ} @var{note_d_arrivée} @var{expression_musicale}
 @end example
 
-Cela signifie que @var{musicexpr} est transposé d'un intervalle entre
-les notes @var{note_de_départ} et @var{note_d_arrivée} : toute note
-dont la hauteur était @code{note_de_départ}
-est changée en @code{note_d_arrivée}.
+@noindent
+Cela signifie que @code{@var{expression_musicale}} est transposé de
+l'intervalle séparant @code{@var{note_de_départ}} et
+@code{@var{note_d_arrivée}} : toute note dont la hauteur était
+@code{note_de_départ} est changée en @code{note_d_arrivée} ; les
+autres notes seront changées selon le même intervalle.  Les deux
+hauteurs s'expriment en octave absolue.
+
+@warning{La musique contenue dans un bloc @code{@bs{}transpose} est en
+octaves absolues, sauf à inclure dans ce même bloc une clause
+@code{@bs{}relative}.}
 
 Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce est
 un peu trop basse pour l'interprète, elle peut être transposée en mi
-majeur avec
-@example
-\transpose d e @dots{}
-@end example
+majeur.  Vous noterez que l'armure est automatiquement modifiée.
+
+@lilypond[verbatim,quote]
+\transpose d e {
+  \relative {
+    \key d \major
+    d'4 fis a d
+  }
+}
+@end lilypond
+
+@cindex transpositeur, instrument
+@cindex instruments transpositeurs
 
-Regardons maintenant une partie écrite pour violon --- un instrument en
+Regardons maintenant une partie écrite pour violon -- un instrument en
 ut.  Si cette partie doit être jouée par une clarinette en la (écrite à
 la tierce mineure supérieure, un do écrit donnant un la réel), la
 transposition suivante créera la partie appropriée.
 
-@example
-\transpose a c @dots{}
-@end example
+@lilypond[verbatim,quote]
+\transpose a c' {
+  \relative {
+    \key c \major
+    c'4 d e g
+  }
+}
+@end lilypond
+
+@noindent
+La présence de @w{@code{\key c \major}} s'explique par le fait que, bien
+que les notes soient effectivement transposées, l'armure ne sera
+imprimée que dans la mesure où elle est explicitement mentionnée.
 
-@code{\transpose} fait la distinction entre les notes enharmoniques :
-@code{\transpose c cis} et @code{\transpose c des} transposeront la
-pièce un demi-ton plus haut.  Mais la première version écrira des
-dièses et la deuxième des bémols.
+@code{\transpose} fait la distinction entre les notes enharmoniques :
+@w{@code{\transpose c cis}} et @w{@code{\transpose c des}} transposeront
+la pièce un demi-ton plus haut, au détail près que la première version
+écrira des dièses et la deuxième des bémols.
 
-@lilypond[quote,ragged-right,verbatim]
-mus = { \key d \major cis d fis g }
+@lilypond[verbatim,quote]
+music = \relative { c' d e f }
 \new Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
+  \transpose c cis { \music }
+  \transpose c des { \music }
 }
 @end lilypond
 
 On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
 pour un instrument transpositeur.  Normalement, les hauteurs dans
 LilyPond sont écrites en ut, c'est à dire en sons réels, mais elles
-peuvent être écrites dans un autre ton.  Quand, par exemple, on écrit
-pour une trompette en si bémol, commençant sur ré note réelle, on
-pourrait écrire 
+peuvent être écrites dans un autre ton.  Prenons l'exemple d'un morceau
+pour trompette en si bémol commençant sur un ré à l'oreille ; on
+pourrait écrire
+
 @example
-\transpose c bes @{ e4 @dots{} @}
+musiqueEnSiBemol = @{ e4 @dots{} @}
+\transpose c bes, \musiqueEnSiBemol
 @end example
 
-Pour imprimer cette musique en si bémol à nouveau --- et de ce fait
-produire une partie de trompette, au lieu d'un conducteur en notes
-réelles, on utilisera un deuxième @code{transpose}
+@noindent
+Pour imprimer cette musique en fa -- et de ce fait produire une partie
+de cor au lieu d'un conducteur en notes réelles -- on utilisera un
+deuxième @code{\transpose} :
 
 @example
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
+musiqueEnSiBemol = @{ e4 @dots{} @}
+\transpose f c' @{ \transpose c bes, \musiqueEnSiBemol @}
 @end example
 
+@noindent
+Pour plus d'information à ce sujet, consultez
+@ref{Instruments transpositeurs}.
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
 
 @seealso
-Référence du programme : @rinternals{TransposedMusic}.
+Manuel de notation :
+@ref{Octaves relatives},
+@ref{Instruments transpositeurs},
+@ref{Inversion},
+@ref{Transformations modales},
+@ref{Rétrogradation}.
 
-Exemples : @rlsr{Pitches}.
+Morceaux choisis :
+@rlsrnamed{Pitches, Hauteurs}.
 
+Référence des propriété internes :
+@rinternals{TransposedMusic}.
 
-@knownissues
+@funindex \transpose
+@funindex transpose
+@funindex \chordmode
+@funindex chordmode
+@funindex \relative
+@funindex relative
 
+@knownissues
 Si vous voulez utiliser en même temps @code{\transpose} et
 @code{\relative}, vous devez mettre @code{\transpose} en dehors de
 @code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
 musique apparaissant dans un @code{\transpose}.
 
-@node Displaying pitches
-@subsection Displaying pitches
+La fonction @code{\transpose} ne permet pas d'imprimer des altérations
+triples ; elle les remplacera par un « équivalent enharmonique »
+-- par exemple ré bémol au lieu de mi triple bémol.
 
-@menu
-* Clef::                        
-* Key signature::               
-* Ottava brackets::             
-* Instrument transpositions::   
-* Automatic accidentals::       
-* Ambitus::                     
-@end menu
 
-@node Clef
-@unnumberedsubsubsec Clef
+@node Inversion
+@unnumberedsubsubsec Inversion
+@translationof Inversion
 
-@funindex \clef
+@cindex inversion
+
+@funindex \inversion
+
+Une expression musicale peut s'inverser et être transposée à l'aide de
+l'instruction
+
+@example
+\inversion @var{hauteur-pivot} @var{hauteur-arrivée} @var{expression_musicale}
+@end example
 
-La clé indique quelles lignes de la portée correspondent à telles
-hauteurs.  Elle est réglée par la commande @code{\clef}.
+L'@code{@var{expression_musicale}} sera alors inversée, intervalle par
+intervalle, puis transposée de telle sorte que
+@code{@var{hauteur-pivot}} devienne @code{@var{hauteur-arrivée}}.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
+@lilypond[verbatim,quote]
+music = \relative { c' d e f }
+\new Staff {
+  \music
+  \inversion d' d' \music
+  \inversion d' ees' \music
+}
 @end lilypond
 
-@cindex clé de sol
-@cindex clé de fa
-@cindex clé d'ut
+@warning{Le motif à inverser doit être exprimé en hauteur absolue, à
+moins d'avoir été préalablement inclus explicitement dans un bloc
+@code{@bs{}relative}.}
 
-Les clés prises en charge sont
-
-@multitable @columnfractions .33 .66
-@headitem Clef @tab Position
-@item @code{treble}, violin, G, G2 @tab Clé de sol 2e ligne
-@item @code{alto, C} @tab Clé d'ut 3e ligne
-@item @code{tenor} @tab Clé d'ut 4e ligne
-@item @code{bass, F} @tab Clé de fa 4e ligne
-@item @code{french} @tab Clé de sol 1e ligne
-@item @code{soprano} @tab Clé d'ut 1e ligne
-@item @code{mezzosoprano} @tab Clé d'ut 2e ligne
-@item @code{baritone} @tab Clé d'ut 5e ligne
-@item @code{varbaritone} @tab Clé de fa 3e ligne
-@item @code{subbass} @tab Clé de fa 5e ligne
-@item @code{percussion} @tab Clé de percussion
-@item @code{tab} @tab Clé de tablature
-@end multitable
+@seealso
+Manuel de notation :
+@ref{Transformations modales},
+@ref{Rétrogradation},
+@ref{Transposition}.
 
-En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
-transposée à l'octave respectivement inférieure ou supérieure, et
-@code{_15} ou @code{^15} la transpose de deux octaves.  L'argument
-@var{clefname} doit être mis entre guillemets lorsqu'il contient un
-caractère @qq{souligné} ou des chiffres.  Par exemple,
 
+@node Rétrogradation
+@unnumberedsubsubsec Rétrogradation
+@translationof Retrograde
 
-@cindex choral tenor clef
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\clef "G_8" c4
-@end lilypond
+@cindex rétrograde, transformation
+@cindex transformation rétrograde
 
+@funindex \retrograde
+@funindex retrograde
 
-@commonprop
+Une expression musicale peut se renverser et se présenter sous forme
+rétrograde :
 
-La commande @code{\clef "treble_8"} équivaut à définir @code{clefGlyph},
-@code{clefPosition} --- qui contrôle la position verticale de la clé ---
-@code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
-lorsque l'une de ces propriétés est changée.  Les exemples suivant font
-apparaître des possibilités de réglage manuel de ces propriétés.
+@lilypond[verbatim,quote]
+music = \relative { c'8. ees16( fis8. a16 b8.) gis16 f8. d16 }
 
-@lilypond[quote,ragged-right,verbatim]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
+\new Staff {
+  \music
+  \retrograde \music
 }
 @end lilypond
 
+@knownissues
+Une liaison de prolongation à l'intérieur d'un bloc @code{\retrograde}
+sera de fait rompue, ce qui générera un message d'avertissement.
+Des liaisons de prolongation seront toutefois générées automatiquement
+dès lors qu'est activé le @ref{Découpage automatique des notes}.
 
 @seealso
-Dans ce manuel : @ref{Grace notes}.
+Manuel de notation :
+@ref{Inversion},
+@ref{Transformations modales},
+@ref{Transposition}.
 
-Référence du programme : @rinternals{Clef}.
 
+@node Transformations modales
+@unnumberedsubsubsec Transformations modales
+@translationof Modal transformations
 
-@node Key signature
-@unnumberedsubsubsec Key signature
+@cindex modales, transformations
 
-@cindex armure
-@funindex \key
+Dans une composition basée sur une gamme, un même motif est transformé à
+plusieurs reprises et selon des schémas différents.  Il peut être
+@notation{transposé} pour partir de différents points de la gamme ou
+bien être @notation{inversé} à partir d'une note pivot dans la gamme.
+Il peut aussi être renversé pour produire une rétrogradation.
 
-L'armure indique la tonalité dans laquelle la pièce doit être jouée.
-Elle comprend un ensemble d'altérations (dièses ou bémols) à la clé,
-c'est-à-dire au début de la portée.
+@warning{Toute note qui ne ferait pas partie de la gamme en question ne
+sera pas transformée.}
 
-On définit ou modifie l'armure avec la commande @code{\key}
+
+@subsubsubheading Transposition modale
+@c VO Modal transposition
+
+@cindex modale, transposition
+
+@funindex \modalTranspose
+@funindex modalTranspose
+
+Un motif peut se transposer selon une gamme donnée :
 
 @example
-@code{\key} @var{hauteur} @var{mode}
+\modalTranspose @var{hauteur-départ} @var{hauteur-arrivée} @var{gamme} @var{motif}
 @end example
 
-@funindex \minor
-@funindex \major
-@funindex \minor
-@funindex \ionian
-@funindex \locrian
-@funindex \aeolian
-@funindex \mixolydian
-@funindex \lydian
-@funindex \phrygian
-@funindex \dorian
-@cindex modes anciens
+Les notes de @var{motif} seront décalées à l'intérieur de la @var{gamme}
+selon leur degré, déterminé par l'intervalle entre @var{hauteur-départ}
+et @var{hauteur-arrivée} :
+
+@lilypond[verbatim,quote]
+diatonicScale = \relative { c' d e f g a b }
+motif = \relative { c'8 d e f g a b c }
 
-Ici, @var{mode} doit être @code{\major} ou @code{\minor} afin d'avoir
-respectivement @var{hauteur}-majeur ou @var{hauteur}-mineur.  Vous pouvez
-aussi avoir recours aux modes anciens que sont @code{\ionian},
-@code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
-@code{\phrygian}, et @code{\dorian}.
+\new Staff {
+  \motif
+  \modalTranspose c f \diatonicScale \motif
+  \modalTranspose c b, \diatonicScale \motif
+}
+@end lilypond
 
-Cette commande fixe la propriété de contexte @code{Staff.keySignature}.
-Des armures inhabituelles peuvent être spécifiées en modifiant
-directement cette propriété.
+Il est ainsi possible de déterminer une gamme ascendante, quels qu'en soient
+l'amplitude et les différents intervalles :
 
-Les nouveaux utilisateurs s'embrouillent souvent dans les altérations et
-les armures, car des notes naturelles prennent ou non un bécarre selon
-l'armure.  Pour plus d'informations, voir @ref{Accidentals} ou
-@rlearning{Accidentals and key signatures}.
+@lilypond[verbatim,quote]
+pentatonicScale = \relative { ges aes bes des ees }
+motif = \relative { ees'8 des ges,4 <ges' bes,> <ges bes,> }
 
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\key g \major
-f1
-fis
+\new Staff {
+  \motif
+  \modalTranspose ges ees' \pentatonicScale \motif
+}
 @end lilypond
 
+L'utilisation de @code{\modalTranspose} avec une gamme chromatique
+produit les mêmes effets qu'un @code{\transpose}, à ceci près que les
+notes seront alors prédéterminées :
 
-@commonprop
-
-Un bécarre est imprimé pour annuler toute altération précédente.  Ceci
-peut être supprimé en réglant la propriété
-@code{Staff.printKeyCancellation}.
+@lilypond[verbatim,quote]
+chromaticScale = \relative { c' cis d dis e f fis g gis a ais b }
+motif = \relative { c'8 d e f g a b c }
 
-@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-\set Staff.printKeyCancellation = ##f
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
+\new Staff {
+  \motif
+  \transpose c f \motif
+  \modalTranspose c f \chromaticScale \motif
+}
 @end lilypond
 
 
-@seealso
-Référence du programme : @rinternals{KeyCancellation},
-@rinternals{KeySignature}.
+@subsubsubheading Inversion modale
+@c VO Modal inversion
 
+@cindex modale, inversion
 
-@node Ottava brackets
-@unnumberedsubsubsec Ottava brackets
+@funindex \modalInversion
+@funindex modalInversion
 
-Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
-transposition spécifique d'une octave pour la portée en cours.  C'est
-la fonction @code{ottava} qui s'en charge.
+Un motif peut s'inverser selon une certaine gamme et à partir d'un pivot
+déterminé, puis transposé, le tout en une seule opération :
 
-@cindex ottava
-@cindex 15ma
-@cindex octaviation
+@example
+\modalInversion @var{hauteur-pivot} @var{hauteur-arrivée} @var{gamme} @var{motif}
+@end example
+
+Les notes de @var{motif} se retrouvent au même degré par rapport à
+@var{hauteur-pivot} dans la @var{gamme}, toutefois dans le sens opposé,
+puis décalées dans cette même @var{gamme} de l'intervalle séparant
+@var{hauteur-départ} et @var{hauteur-arrivée}.
 
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c''' {
-  a2 b
-  \ottava #1
-  a b
-  \ottava #0
-  a b
+Il est donc possible de simplement inverser à partir d'une des notes de
+la gamme en donnant la même valeur à @var{hauteur-départ} et
+@var{hauteur-arrivée} :
+
+@lilypond[verbatim,quote]
+octatonicScale = \relative { ees' f fis gis a b c d }
+motif = \relative { c'8. ees16 fis8. a16 b8. gis16 f8. d16 }
+
+\new Staff {
+  \motif
+  \modalInversion fis' fis' \octatonicScale \motif
 }
 @end lilypond
 
-La fonction @code{ottava} peut aussi prendre en argument les
-valeurs -1@tie{}(pour 8va bassa), 2@tie{}(pour 15ma --- 2 octaves) ou
--2@tie{}(pour 15ma bassa).   En interne, cette fonction détermine les
-propriétés @code{ottavation} (p.ex. en @code{"8va"} ou @code{"8vb"})
-et @code{centralCPosition}.  Vous pouvez modifier le texte d'une marque
-d'octaviation en définissant @code{ottavation} après avoir fait appel
-à @code{ottava} :
+Pour permuter deux notes de la gamme, il suffit donc d'inverser à partir
+de l'une des notes et de transposer d'un degré de la gamme.  Les deux
+notes spécifiées peuvent s'interpréter comme étant les bornes du pivot.
 
-@lilypond[quote,ragged-right,verbatim]
-{
-  \ottava #1
-  \set Staff.ottavation = #"8"
-  c'''
+@lilypond[verbatim,quote]
+scale = \relative { c' g' }
+motive = \relative { c' c g' c, }
+
+\new Staff {
+  \motive
+  \modalInversion c' g' \scale \motive
 }
 @end lilypond
 
+L'opération conjointe d'une inversion et d'une rétrogradation produit
+une rétrogradation inversée :
+
+@lilypond[verbatim,quote]
+octatonicScale = \relative { ees' f fis gis a b c d }
+motif = \relative { c'8. ees16 fis8. a16 b8. gis16 f8. d16 }
+
+\new Staff {
+  \motif
+  \retrograde \modalInversion c' c' \octatonicScale \motif
+}
+@end lilypond
 
 @seealso
-Référence du programme : @rinternals{OttavaBracket}.
+Manuel de notation :
+@ref{Inversion},
+@ref{Rétrogradation},
+@ref{Transposition}.
 
 
-@knownissues
+@node Gravure des hauteurs
+@subsection Gravure des hauteurs
+@translationof Displaying pitches
 
-@code{ottava} gère difficilement les changements de clé qui
-pourraient intervenir alors qu'elle est effective.
+Nous allons voir dans cette partie comment influer sur la gravure des
+hauteurs.
 
+@menu
+* Clefs::
+* Armure::
+* Marques d'octaviation::
+* Instruments transpositeurs::
+* Altérations accidentelles automatiques::
+* Ambitus::
+@end menu
 
-@node Instrument transpositions
-@unnumberedsubsubsec Instrument transpositions
 
-@cindex transposition, MIDI
-@cindex transposition, instrument
+@node Clefs
+@unnumberedsubsubsec Clefs
+@translationof Clef
 
-Vous pouvez spécifier la tonalité d'un instrument transpositeur, ce
-qui est le cas pour de nombreux instruments à vent comme la clarinette
-(si bémol, la ou mi bémol), le cor (fa), ou la trompette (si bémol,
-ut, ré ou mi bémol).
+@cindex clé de sol
+@cindex sol, clef de
+@cindex clé de fa
+@cindex fa, clef de
+@cindex clé d'ut
+@cindex ut, clef d'
+@cindex clés anciennes
+@cindex anciennes, clefs
 
-Cette transposition s'indique après le mot-clé @code{\transposition}.
+@funindex \clef
+@funindex clef
 
-@example
-\transposition bes   %% clarinette en si bémol
-@end example
+La clef indique quelles lignes de la portée correspondent à quelles
+hauteurs.  En l'absence de commande explicite, LilyPond utilise
+par défaut la clef de sol.
 
-@noindent
-Cette commande détermine la propriété @code{instrumentTransposition},
-dont la valeur sera utilisée pour le fichier MIDI et en cas de
-citation.  Elle n'affecte en rien la manière dont les notes seront
-imprimées sur la portée.  Référez-vous à la section @ref{Transpose}
-pour obtenir un autre résultat.
+@lilypond[verbatim,quote,relative=1,ragged-right]
+c2 c
+@end lilypond
 
-La hauteur donnée en argument à @code{\transposition} doit
-correspondre à la note entendue lorsqu'un @code{do} écrit sur la
-portée est joué par l'instrument transpositeur.  Par exemple, lorsque
-vous saisissez une partition en notes réelles, toutes les voix
-devraient être en ut ; pour les instruments transpositeurs, il faudra
-procéder de cette manière : 
+La clef se modifie à l'aide de la commande @code{\clef} suivie d'un nom
+approprié.  Pour chacun des exemples suivants est indiquée la position
+du do médium.
 
-@example
-clarinet = @{
-  \transposition c'
-  ...
-@}
-saxophone = @{
-  \transposition c'
-  ...
-@}
-@end example
+@lilypond[verbatim,quote,relative=1]
+\clef treble
+c2 c
+\clef alto
+c2 c
+\clef tenor
+c2 c
+\clef bass
+c2 c
+@end lilypond
 
-Lorsque vous entrez de la musique à partir d'une partie transposée,
-utilisez la commande @code{\transposition}.  Si l'on prend l'exemple
-des parties de cor, leur tonalité change souvent au cours d'un morceau ;
-en recopiant cette partie, utilisez @code{\transposition} ainsi :
+Les différents noms possibles sont répertoriés à l'annexe
+@ref{Styles de clef}.
 
-@example
-\transposition d'
-c'4^"en ré"
-...
-\transposition g'
-c'4^"en sol"
-...
-@end example
+Des clefs spéciales, telles que celles rencontrées en musique ancienne,
+sont abordées dans @ref{Clefs anciennes} et @ref{Clefs grégoriennes}.
+La musique requérant des clefs de tablature est traitée dans
+@ref{Tablatures par défaut} et @ref{Tablatures personnalisées}.
 
-@node Automatic accidentals
-@unnumberedsubsubsec Automatic accidentals
-@cindex Altérations accidentelles automatiques
+@cindex Clef de citation
+@cindex Citation et clefs
 
-Une fonction a été créée pour regrouper les règles suivant lesquelles
-s'impriment les altérations.  Elle s'invoque de la manière suivante :
+Les citations peuvent demander une modification de clef à l'aide des
+commandes @code{\cueClef} et @code{\cueDuringWithClef} -- voir
+@ref{Mise en forme d'une citation}.
 
-@funindex set-accidental-style
-@example
-#(set-accidental-style 'REGLE)
-@end example
+@cindex transposition et clef
+@cindex clef et transposition
+@cindex octave et clef
+@cindex octaviation optionnelle
+@cindex opotionnelle, octaviation
+@cindex chorale, clef de ténor
+@cindex ténor, clef
 
-@c TODO: check the context stuff below
-@c -does it *really* work?
-@c -the default contexts as specified in
-@c  scm/music-function.scm seem to be different -vv
+En ajoutant @code{_8} ou @code{^8} au nom de la clef, celle-ci est
+transposée à l'octave respectivement inférieure ou supérieure, et
+@code{_15} ou @code{^15} la transpose de deux octaves.  D'autres nombres
+entiers peuvent être utilisés selon les besoins.  L'argument
+@var{clefname} doit être mis entre guillemets lorsqu'il contient des
+caractères supplémentaires.  Par exemple,
 
-Cette fonction prend pour argument le nom de la règle d'altération,
-auquel peut s'ajouter, comme argument facultatif, le contexte
-devant être affecté :
+@lilypond[verbatim,quote,relative=1]
+\clef treble
+c2 c
+\clef "treble_8"
+c2 c
+\clef "bass^15"
+c2 c
+\clef "alto_2"
+c2 c
+\clef "G_8"
+c2 c
+\clef "F^5"
+c2 c
+@end lilypond
 
-@example
-#(set-accidental-style 'REGLE #('CONTEXTE#))
-@end example
+Une indication d'octaviation optionnelle s'obtient en entourant
+l'argument numérique par des parenthèses ou des crochets :
 
-Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ; 
-cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu 
-et place.
+@lilypond[verbatim,quote,relative=1]
+\clef "treble_(8)"
+c2 c
+\clef "bass^[15]"
+c2 c
+@end lilypond
 
-Les régles d'altération suivantes sont possibles :
+Les hauteurs seront affichées comme si l'argument numérique
+n'avait pas été encadré de parenthèses ou crochets.
+
+Lorsqu'un changement de clef intervient en même temps qu'un saut de
+ligne, la nouvelle clef est imprimée à la fois en fin de ligne et au
+début de la suivante.  Vous pouvez toujours supprimer cette « clef de
+précaution ».
+
+@lilypond[verbatim,quote,relative=1]
+\clef treble { c2 c } \break
+\clef bass { c2 c } \break
+\clef alto
+  \set Staff.explicitClefVisibility = #end-of-line-invisible
+  { c2 c } \break
+  \unset Staff.explicitClefVisibility
+\clef bass { c2 c } \break
+@end lilypond
 
-@table @code
-@item default
-C'est la règle d'impression par défaut, qui se rapporte à l'usage 
-en vigueur au XVIIIème siècle : les altérations accidentelles sont
-valables tout une mesure, et uniquement à leur propre octave.
+Lorsqu'une clef a déjà été imprimée et qu'aucune autre clef n'a depuis
+été imprimée, LilyPond ignorera toute réitération de la commande
+@code{\clef}.  Forcer la réimpression de la clef s'obtient à l'aide de
+la commande @code{\set Staff.forceClef = ##t}.
+
+@lilypond[verbatim,quote,relative=1]
+  \clef treble
+  c1
+  \clef treble
+  c1
+  \set Staff.forceClef = ##t
+  c1
+  \clef treble
+  c1
+@end lilypond
 
+Le symbole imprimé lors d'un changement de clef est plus petit que la
+clef initiale.  La taille peut toutefois être ajustée.
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+@lilypond[verbatim,quote,relative=1]
+  \clef "treble"
+  c1
+  \clef "bass"
+  c1
+  \clef "treble"
+  c1
+  \override Staff.Clef.full-size-change = ##t
+  \clef "bass"
+  c1
+  \clef "treble"
+  c1
+  \revert Staff.Clef.full-size-change
+  \clef "bass"
+  c1
+  \clef "treble"
+  c1
+@end lilypond
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{tweaking-clef-properties.ly}
+
+@seealso
+Manuel de notation :
+@ref{Notations anciennes},
+@ref{Clefs anciennes},
+@ref{Clefs grégoriennes},
+@ref{Mise en forme d'une citation},
+@ref{Tablatures par défaut},
+@ref{Tablatures personnalisées}.
+
+Fichiers d'initialisation :
+@file{scm/parser-clef.scm}.
+
+Morceaux choisis:
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Clef_engraver},
+@rinternals{Clef},
+@rinternals{ClefModifier},
+@rinternals{clef-interface}.
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              %#(set-accidental-style 'default) 
-       \musicA }
-       \context Staff = "down"{
-              %#(set-accidental-style 'default)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+@knownissues
+L'indicateur d'octaviation attaché à la clef est un objet graphique en
+lui même.  Par voie de conséquence, tout @code{\override} affectant
+l'objet @code{Clef} devra être manuellement répercuté sur l'objet
+@code{ClefModifier}.
+
+@lilypond[fragment,quote,relative=1]
+\new Staff \with {
+  \override Clef.color = #blue
+  \override ClefModifier.color = #red
 }
+
+\clef "treble_8" c4
 @end lilypond
 
-@item voice
-En principe, LilyPond se souvient de toutes les altérations présentes sur la
-portée (contexte Staff).  Avec cette règle, cependant, les altérations
-sont indépendantes pour chacune des voix. 
 
+@node Armure
+@unnumberedsubsubsec Armure
+@translationof Key signature
+
+@cindex armure
+
+@funindex \key
+@funindex key
+
+@c duplicated in Key signature and in Accidentals
+@warning{Les nouveaux utilisateurs sont parfois déroutés par la gestion
+des altérations et de l'armure.  Pour LilyPond, une hauteur n'est que du
+matériau brut ; l'armure et la clef ne feront que déterminer
+comment ce matériau sera retranscrit.  Un simple @code{c} signifie
+tout bonnement « do naturel » quelles que soient l'armure et la
+clef en question.  Pour plus d'information, reportez-vous au chapitre
+@rlearning{Hauteurs et armure}.}
+
+L'armure indique la tonalité dans laquelle la pièce doit être jouée.
+Elle comprend un ensemble d'altérations (dièses ou bémols) à la clef,
+c'est-à-dire au début de la portée.  Elle peut varier en cours de
+morceau.
+
+On définit ou modifie l'armure avec la commande @code{\key} :
+
+@example
+\key @var{hauteur} @var{mode}
+@end example
+
+@funindex \major
+@funindex major
+@funindex \minor
+@funindex minor
+@funindex \ionian
+@funindex ionian
+@funindex \locrian
+@funindex locrian
+@funindex \aeolian
+@funindex aeolian
+@funindex \mixolydian
+@funindex mixolydian
+@funindex \lydian
+@funindex lydian
+@funindex \phrygian
+@funindex phrygian
+@funindex \dorian
+@funindex dorian
+
+@cindex modes anciens
+@cindex modes
+@cindex majeur
+@cindex mineur
+@cindex ionien
+@cindex locrien
+@cindex éolien
+@cindex mixolydien
+@cindex lydien
+@cindex phrygien
+@cindex dorien
+
+@noindent
+Ici, @code{@var{mode}} doit être @code{\major} ou @code{\minor} afin
+d'avoir respectivement @var{hauteur}-majeur ou @var{hauteur}-mineur.
+Vous pouvez aussi avoir recours aux modes anciens que sont
+@code{\ionian}, @code{\locrian}, @code{\aeolian}, @code{\mixolydian},
+@code{\lydian}, @code{\phrygian} et @code{\dorian}.
+
+@lilypond[verbatim,quote,relative=2]
+\key g \major
+fis1
+f
+fis
+@end lilypond
+
+Rien n'empèche de définir d'autres modes, en listant l'altération
+de chacun des degrés de la gamme en partant du do.
+
+@lilypond[verbatim,quote]
+freygish = #`((0 . ,NATURAL) (1 . ,FLAT) (2 . ,NATURAL)
+    (3 . ,NATURAL) (4 . ,NATURAL) (5 . ,FLAT) (6 . ,FLAT))
+
+\relative {
+  \key c \freygish c'4 des e f
+  \bar "||" \key d \freygish d es fis g
+}
+@end lilypond
+
+Les altérations à la clef peuvent s'imprimer à des octaves
+différents de leur position traditionnelle ou à plusieurs octaves,
+à l'aide des propriétés @code{flat-positions} et
+@code{sharp-positions} de l'objet @code{KeySignature}.  Les
+entrées fourniees à ces propriétés définissent l'amplitude des
+positions sur la portée où les altérations seront imprimées.  Dans
+le cas où l'entrée est constituée d'une position unique, les
+altérations seront placées à l'intérieur de l'octave finissant à
+cette position sur la portée.
+
+@lilypond[verbatim, quote,relative=0]
+\override Staff.KeySignature.flat-positions = #'((-5 . 5))
+\override Staff.KeyCancellation.flat-positions = #'((-5 . 5))
+\clef bass \key es \major es g bes d
+\clef treble \bar "||" \key es \major es g bes d
+
+\override Staff.KeySignature.sharp-positions = #'(2)
+\bar "||" \key b \major b fis b2
+@end lilypond
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{preventing-natural-signs-from-being-printed-when-the-key-signature-changes.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{non-traditional-key-signatures.ly}
+
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{church mode,mode d'église},
+@rglos{scordatura}.
+
+Manuel d'initiation :
+@rlearning{Hauteurs et armure}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{KeyChangeEvent},
+@rinternals{Key_engraver},
+@rinternals{Key_performer},
+@rinternals{KeyCancellation},
+@rinternals{KeySignature},
+@rinternals{key-signature-interface}.
+
+
+@node Marques d'octaviation
+@unnumberedsubsubsec Marques d'octaviation
+@translationof Ottava brackets
+
+@cindex ottava
+@cindex 15ma
+@cindex 8va
+@cindex 8ve
+@cindex octaviation
+
+@funindex set-octavation
+@funindex \ottava
+@funindex ottava
+
+Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
+transposition spécifique d'une octave pour la portée en cours.  C'est
+la fonction @code{ottava} qui s'en charge.
+
+@lilypond[verbatim,quote,relative=2]
+a2 b
+\ottava #-2
+a2 b
+\ottava #-1
+a2 b
+\ottava #0
+a2 b
+\ottava #1
+a2 b
+\ottava #2
+a2 b
+@end lilypond
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{ottava-text.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-an-ottava-marking-to-a-single-voice.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{modifying-the-ottava-spanner-slope.ly}
+
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{octavation,octaviation}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Ottava_spanner_engraver},
+@rinternals{OttavaBracket},
+@rinternals{ottava-bracket-interface}.
+
+
+@node Instruments transpositeurs
+@unnumberedsubsubsec Instruments transpositeurs
+@translationof Instrument transpositions
+
+@cindex transposition et MIDI
+@cindex MIDI et transposition
+@cindex transposition, instrument
+
+@funindex \transposition
+@funindex transposition
+
+Lorsque l'on saisit une partition d'ensemble incluant des instruments
+transpositeurs, certaines parties peuvent être dans une autre tonalité
+que la @notation{tonalité de concert}.  Il faudra en pareil cas indiquer
+la tonalité spécifique de ces @notation{instruments transpositeurs},
+sous peine de fichier MIDI erroné et de citations incorrectes.  Pour
+plus de détails sur les citations, consultez le chapitre
+@ref{Citation d'autres voix}.
+
+@example
+\transposition @var{hauteur}
+@end example
+
+La hauteur donnée en argument à @code{\transposition} doit
+correspondre à la note entendue lorsqu'un @code{do} écrit sur la
+portée est joué par l'instrument transpositeur.  Cette hauteur doit être
+mentionnée en @notation{mode absolu}.  Par exemple, lorsque
+vous saisissez une partition en notes réelles, toutes les voix
+devraient être en ut ; si un instrument joue un ton au dessus, il
+faudra lui ajouter un @w{@code{\transposition d'}}.  La commande
+@code{\transposition} s'utilise @strong{si et seulement si} les notes à
+saisir @strong{ne sont pas} dans la tonalité de concert.
+
+Voici un fragment pour violon et clarinette en si bémol (@emph{B-flat})
+pour lequel les parties respectives ont été recopiées à partir du
+conducteur.  Les deux instruments sont à l'unisson.
+
+@lilypond[verbatim,quote]
+\new GrandStaff <<
+  \new Staff = "violin" {
+    \relative c'' {
+      \set Staff.instrumentName = #"Vln"
+      \set Staff.midiInstrument = #"violin"
+      % not strictly necessary, but a good reminder
+      \transposition c'
+
+      \key c \major
+      g4( c8) r c r c4
+    }
+  }
+  \new Staff = "clarinet" {
+    \relative c'' {
+      \set Staff.instrumentName = \markup { Cl (B\flat) }
+      \set Staff.midiInstrument = #"clarinet"
+      \transposition bes
+
+      \key d \major
+      a4( d8) r d r d4
+    }
+  }
+>>
+@end lilypond
+
+La @code{\transposition} peut évoluer au cours d'un morceau.  Un
+clarinettiste peut être amené à jongler avec une clarinette en la et
+une autre en si bémol.
+
+@lilypond[verbatim,quote,]
+flute = \relative c'' {
+  \key f \major
+  \cueDuring #"clarinet" #DOWN {
+    R1 _\markup\tiny "clarinet"
+    c4 f e d
+    R1 _\markup\tiny "clarinet"
+  }
+}
+clarinet = \relative c'' {
+  \key aes \major
+  \transposition a
+  aes4 bes c des
+  R1^\markup { muta in B\flat }
+  \key g \major
+  \transposition bes
+  d2 g,
+}
+\addQuote "clarinet" \clarinet
+<<
+  \new Staff \with { instrumentName = #"Flute" }
+    \flute
+  \new Staff \with { instrumentName = #"Cl (A)" }
+    \clarinet
+>>
+@end lilypond
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{concert pitch,tonalité de concert},
+@rglosnamed{transposing instrument,instrument transpositeur}.
+
+Manuel de notation :
+@ref{Citation d'autres voix},
+@ref{Transposition}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+
+@node Altérations accidentelles automatiques
+@unnumberedsubsubsec Altérations accidentelles automatiques
+@translationof Automatic accidentals
+
+@cindex altération, style
+@cindex altération, style par défaut
+@cindex accidentelles, altérations
+@cindex accidentelles automatiques
+@cindex automatiques, altérations accidentelles
+@cindex style d'accidentelle
+
+@funindex \accidentalStyle
+@funindex voice
+@funindex default
+
+LilyPond dispose d'une fonction chargée de regrouper les règles suivant
+lesquelles s'impriment les altérations.  Elle s'invoque de la manière
+suivante :
 
 @example
- \new Staff <<
-        #(set-accidental-style 'voice)
-       @{ @dots{} @}
-       >>
+\new Staff <<
+  \accidentalStyle voice
+  @{ @dots{} @}
+>>
 @end example
 
-De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
-ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
-il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
+La règle de gestion des altérations s'applique par défaut au contexte
+@code{Staff} en cours, exception faite des styles @code{piano} et
+@code{piano-cautionary} comme nous allons le voir.  Cette fonction
+accepte un éventuel argument supplémentaire chargé de spécifier
+le champ d'action de la règle à suivre.  À titre d'exemple, il faudra
+utiliser, pour que toutes les portées d'un même système -- contexte
+@code{StaffGroup} -- soient soumises à la même règle :
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+@example
+\accidentalStyle StaffGroup.voice
+@end example
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+Nous vous présentons ci-après les différentes règles d'altération prises
+en charge.  Pour les besoins de la démonstration, nous partirons de
+l'exemple suivant :
+
+@lilypond[verbatim,quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle default
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle default
+      \musicB
+    }
+  >>
+}
+@end lilypond
+
+Notez bien que pour appliquer le même style aux deux portées, seules les
+dernières lignes de cet exemple nous intéressent.
+
+@example
+\new PianoStaff @{
+  <<
+    \context Staff = "haut" @{
+      %%% voici la ligne à modifier en conséquence :
+      \accidentalStyle Score.default
+      \musicA
+    @}
+    \context Staff = "bas" @{
+      \musicB
+    @}
+  >>
+@}
+@end example
+
+
+@c don't use verbatim in this table.
+@table @code
+@item default
+
+@cindex @emph{default}, style d'altérations
+@cindex altérations, style @emph{default}
+
+@funindex default
+
+C'est la règle d'impression par défaut, qui se rapporte à l'usage
+en vigueur au XVIIIe siècle : les altérations accidentelles sont
+valables tout une mesure, et uniquement à leur propre octave.  C'est la
+raison pour laquelle il n'y a pas de bécarre avant le @notation{si} de
+la deuxième mesure, ni avant le dernier @notation{do}.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle default
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle default
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-La règle @code{voice} n'est à envisager que dans le cas de voix devant
-être lues par des musiciens différents.  S'il s'agit d'un
-@qq{conducteur}, ou d'une portée destinée à un seul musicien, il vaut
-mieux utiliser @code{modern} ou @code{modern-cautionary}. 
+@item voice
+
+@cindex @emph{voice}, style d'altérations
+@cindex altérations, style @emph{voice}
+@cindex altérations, style @emph{modern}
+@cindex @emph{modern}, style d'altération
+@cindex altérations, style @emph{modern-cautionary}
+@cindex @emph{modern-cautionary}, style d'altération
+
+@funindex voice
+
+En principe, LilyPond se souvient de toutes les altérations présentes
+sur la portée (contexte @code{Staff}).  Avec cette règle, cependant, les
+altérations sont indépendantes pour chacune des voix tout en obéissant
+à la règle @code{default}.
+
+Les altérations d'une voix sont de fait ignorées dans les autres
+voix, ce qui peut donner lieu à un résultat malencontreux.  Dans
+l'exemple suivant, il est difficile de dire si le deuxième @notation{la}
+est dièse ou naturel.  La règle @code{voice} n'est donc à envisager que
+dans le cas de voix devant être lues par des musiciens différents.  S'il
+s'agit d'un « conducteur », ou d'une portée destinée à un seul
+musicien, il vaut mieux utiliser @code{modern} ou
+@code{modern-cautionary}.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle voice
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle voice
+      \musicB
+    }
+  >>
+}
+@end lilypond
 
 @item modern
-@funindex modern style accidentals
-Cette règle est la plus courante au XXème siècle.  Les altérations
-accidentelles sont imprimées comme avec le style @code{default}, mais
-lorsqu'une note non-altérée apparaît à une octave différente, ou bien
+
+@cindex altération, style @emph{modern}
+@cindex @emph{modern}, style d'altération
+
+@funindex modern
+
+Cette règle est la plus courante au XXe siècle.  Certains bécarres ne
+sont pas imprimés, comme il était d'usage lorsqu'une note diésée suit
+cette même note flanquée d'un double dièse, ou bien un bémol un double
+bémol.  Le style @code{modern} suit la même règle que le style
+@code{default}, avec deux additions afin de lever les ambiguïtés :
+lorsqu'une note non altérée apparaît à une octave différente, ou bien
 dans la mesure suivante, des bécarres de précaution sont ajoutés.  Dans
 l'exemple suivant, notez ainsi les deux bécarres dans la deuxième mesure
-de la main droite. 
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+de la main droite.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle modern
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle modern
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-@item @code{modern-cautionary}
+@item modern-cautionary
+
+@cindex altération, style @emph{modern cautionary}
+@cindex @emph{modern cautionary}, style d'altération
+@cindex altération de précaution, style @emph{modern}
+@cindex @emph{modern}, style d'altération de précaution
+
 @funindex modern-cautionary
-Cette règle est équivalente à @code{modern}, mais les bécarres de
-précaution sont imprimés de façon particulière : soit plus petits, soit
-(par défaut) entre parenthèses.  Il est possible de le définir au moyen
-de la propriété @code{cautionary-style} pour l'objet
-@rinternals{AccidentalSuggestion}. 
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+Cette règle est équivalente à @code{modern}, mais les bécarres de
+précaution (absents dans la règle @code{default}) sont imprimés de façon
+particulière : soit plus petit, soit (par défaut) entre parenthèses
+-- il est possible de le définir au moyen de la propriété
+@code{cautionary-style} de l'objet @code{AccidentalSuggestion}.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle modern-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle modern-cautionary
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-@funindex modern-voice
 @item modern-voice
+
+@cindex @emph{modern}, style d'altération
+@cindex style d'altération @emph{modern}
+@cindex altérations multivoix
+@cindex style d'altération @emph{modern accidental}
+@cindex voix multiples et altérations
+@cindex multivoix, altérations
+
+@funindex modern-voice
+
 Cette règle sert aux altérations dans de la musique polyphonique destinée
 autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble
 des voix.  Les altérations sont imprimées voix par voix, mais les autres
-voix, dans le même contexte @rinternals{Staff}, en @emph{tiennent
-compte} cette fois. 
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+voix d'un même contexte @code{Staff} en @emph{tiennent compte}
+cette fois.  C'est pourquoi le @notation{la} de la dernière mesure est
+affublé d'un bécarre bien qu'il y en ait déjà eu un dans la mesure
+précédente, et que le @notation{ré} de la main gauche en ait un alors
+que le dièse qu'il avait auparavant concernait la main droite.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle modern-voice
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle modern-voice
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-@funindex modern-voice-cautionary
 @item modern-voice-cautionary
-Cette régle est similaire à la précédente, mais les altérations de précaution
-(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
-particulière.  On retrouve donc toutes les altérations qu'imprimerait
-@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+@cindex altération de précaution style @emph{modern voice}
+@cindex @emph{modern voice}, style d'altération de précaution
+
+@funindex modern-voice-cautionary
+
+Cette règle est similaire à la précédente, mais les altérations de
+précaution (celles que n'aurait pas ajoutées @code{voice}), sont
+imprimées de façon particulière.  On retrouve donc toutes les
+altérations qu'imprimerait @code{default}, mais certaines sont
+considérées comme étant « de précaution ».
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle modern-voice-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle modern-voice-cautionary
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
 @item piano
-@funindex piano accidentals
-Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas
-de devoir la spécifier pour chaque portée individuelle au sein du
-contexte GrandStaff. 
 
-@example
-\new GrandStaff @{ <<
-  \new Staff = "up" @{ <<
-    #(set-accidental-style 'piano)
-    @{ @dots{} @}
-  >> @}
-  \new Staff = "down"@{ <<
-    #(set-accidental-style 'piano)
-  @{ @dots{} @}
-  >> @}
->> @}
-@end example
+@cindex @emph{piano}, style d'altérations
+@cindex altérations style @emph{piano}
+@cindex piano et altérations
 
-Cette règle est communément employée pour les partitions de piano au
-XXème siècle.  Très similaire à @code{modern} de par son comportement,
-elle s'en distingue en ce que les altérations tiennent compte des autre
-portées du contexte @rinternals{GrandStaff} ou @rinternals{PianoStaff}.
+@funindex piano
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+Cette règle est communément employée pour les partitions de piano au
+XXe siècle.  Très similaire à @code{modern} de par son comportement,
+elle s'en distingue en ce que les altérations tiennent compte des autres
+portées du contexte @code{GrandStaff} ou @code{PianoStaff}.
+
+Cette règle s'applique par défaut dans un @code{GrandStaff} et dans un
+@code{PianoStaff}.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle piano
+      \musicA
+    }
+    \context Staff = "down" {
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
 @item piano-cautionary
-@funindex #(set-accidental-style 'piano-cautionary)
-Identique à @code{#(set-accidental-style 'piano)}, mais les altérations
-de précaution sont imprimées différemment.
 
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+@cindex @emph{piano cautionary}, style d'altérations
+@cindex altérations style @emph{piano cautionary}
+@cindex piano et altérations
+
+@funindex piano-cautionary
+
+Identique au style @code{piano}, mais les altérations de précaution sont
+imprimées différemment.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle piano-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-@item no-reset
-@funindex no-reset accidental style
-C'est la même règle que @code{default}, mais l'effet des altérations
-accidentelles ne cesse jamais, même dans les mesures suivantes.
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+@item neo-modern
+
+@cindex @emph{neo-modern}, style d'altérations
+@cindex altérations, style @emph{neo-modern}
+
+@funindex neo-modern
+
+Cette règle suit les pratiques de la musique contemporaine : les
+altérations accidentelles apparaissent comme dans le style
+@code{modern}, à ceci près qu'elles sont répétées dans la même mesure --
+sauf si elles concernent deux notes consécutives.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle neo-modern
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle neo-modern
+      \musicB
+    }
+  >>
+}
+@end lilypond
 
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'no-reset) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'no-reset)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+@item neo-modern-cautionary
+
+@cindex @emph{neo-modern-cautionary}, style d'altérations
+@cindex style d'altération @emph{neo-modern-cautionary}
+
+@funindex neo-modern-cautionary
+
+Identique au style @code{neo-modern}, mais les altérations de précaution
+sont imprimées différemment.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle neo-modern-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle neo-modern-cautionary
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-@item forget
-Tout le contraire de @code{no-reset} : l'effet des altérations cesse aussitôt,
-et de ce fait, toutes les altérations, quelque soit leur place dans la
-mesure, sont imprimées en fonction de l'éventuelle armure.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'forget) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'forget)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
+@item neo-modern-voice
+
+@cindex @emph{neo-modern-voice}, style d'altération
+@cindex style d'altération @emph{neo-modern-voice}
+@cindex altérations multivoix
+@cindex voix multiples et altérations
+@cindex multivoix, altérations
+
+@funindex neo-modern-voice
+
+Cette règle sert aux altérations dans de la musique polyphonique destinée
+autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble
+des voix.  Les altérations sont imprimées voix par voix comme avec le style
+@code{neo-modern} mais les autres voix dans le même contexte @code{Staff}
+en tiennent aussi compte.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle neo-modern-voice
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle neo-modern-voice
+      \musicB
+    }
+  >>
 }
 @end lilypond
-@end table
 
+@item neo-modern-voice-cautionary
+
+@funindex neo-modern-voice-cautionary
+
+Cette règle est identique à @code{neo-modern-voice}, mais les
+altérations de précaution sont imprimées soit entre parenthèses (par
+défaut), soit en plus petit.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-@seealso
-Référence du programme : @rinternals{Accidental_engraver},
-@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et
-@rinternals{AccidentalPlacement}. 
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle neo-modern-voice-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle neo-modern-voice-cautionary
+      \musicB
+    }
+  >>
+}
+@end lilypond
 
-@knownissues
+@item dodecaphonic
+
+@cindex @emph{dodecaphonic}, style d'altérations
+@cindex altération, style @emph{dodecaphonic}
+
+@funindex dodecaphonic
+
+Cette règle reproduit ce que certains compositeurs du début du XXe
+siècle ont introduit dans leur désir d'abolir la distinction entre les
+notes naturelles ou non.  Ainsi, @strong{chaque} note est affublée d'une
+altération, même si elle est naturelle.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
 
-Les notes simultanées sont considérées comme des évènements séquentiels.
-Ce qui implique que, dans un accord, les altérations accidentelles seront 
-imprimées comme si les notes de l'accord apparaissaient une par une, en
-fonction de l'ordre dans lequels elles ont été saisies -- ce qui peut
-poser problème lorsqu'au sein d'un accord certaines altérations
-dépendent les unes des autres.  
-Ce problème est à résoudre manuellement, en insérant des @code{!} et des
-@code{?} après les notes concernées.
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
 
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle dodecaphonic
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle dodecaphonic
+      \musicB
+    }
+  >>
+}
+@end lilypond
 
-@node Ambitus
-@unnumberedsubsubsec Ambitus
-@cindex ambitus
 
-L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
-partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
-est capable d'atteindre.  Souvent, cet @emph{ambitus} est imprimé au début des
-partitions vocales, afin que les exécutants puissent voir au premier
-coup d'œil s'ils sont en mesure de tenir la partie en question.
+@item dodecaphonic-no-repeat
 
-Pour exprimer l'@emph{ambitus} d'une pièce, on indique avant la clé deux notes
-représentant la hauteur la plus basse et la plus haute.  Pour imprimer
-cet @emph{ambitus}, il faut ajouter le graveur @rinternals{Ambitus_engraver}
-au contexte @rinternals{Voice}.  Ainsi,
+@cindex @emph{dodecaphonic}, style d'altération
+@cindex @emph{dodecaphonic}, style néomoderne
 
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
+@funindex dodecaphonic-no-repeat
 
-@noindent
-aura pour résultat
+Comme dans le cas du style @code{dodecaphonic}, chaque note est par
+défaut affublée d'une altération.  Celle-ci sera toutefois omise lorsque
+la même hauteur est immédiatement répétée dans la même portée.
 
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
   }
 }
 
-\relative \new Staff {
-  as'' c e2 cis,2
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle dodecaphonic-no-repeat
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle dodecaphonic-no-repeat
+      \musicB
+    }
+  >>
 }
 @end lilypond
 
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
-graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
-plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
-alors celui de toutes les voix cumulées, non d'une seule des voix
-actives.
 
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
+@item dodecaphonic-first
+
+@cindex dodecaphonic, style d'altération
+@cindex dodecaphonic, style néo-moderne
+
+@funindex dodecaphonic-first
+
+Comme dans le cas du style @code{dodecaphonic}, chaque note est par
+défaut affublée d'une altération.  Cette altération n'apparaîtra que
+pour la première occurrence dans la mesure et seront répétés en cas
+d'octave différente.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
 }
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
   }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle dodecaphonic-first
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle dodecaphonic-first
+      \musicB
+    }
+  >>
+}
+@end lilypond
+
+
+@item teaching
+
+@cindex @emph{teaching}, style d'altérations
+@cindex altérations, style @emph{teaching}
+
+@funindex teaching
+
+Cette règle est à usage pédagogique : l'impression d'une simple
+gamme fera apparaître une altération de précaution pour toute note
+altérée.  Les altérations accidentelles sont imprimées selon le style
+@code{modern}, et une altération de précaution est ajoutée pour chaque
+dièse ou bémol à la clef -- sauf dans le cas de notes consécutives.
+
+@lilypond[quote,staffsize=18]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
   }
->>
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \key fis \minor
+      \accidentalStyle teaching
+      \musicA
+    }
+    \context Staff = "down" {
+      \key fis \minor
+      \accidentalStyle teaching
+      \musicB
+    }
+  >>
+}
 @end lilypond
 
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
+@item no-reset
 
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
+@cindex altération, style @emph{no reset}
+@cindex @emph{no reset}, style d'altérations
 
-@noindent
-Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors le système de mise en
-forme n'aurait pas attribué d'espace supplémentaire pour l'objet
-déplacé.
+@funindex no-reset
+
+C'est la même règle que @code{default}, mais l'effet des altérations
+accidentelles ne cesse jamais, même dans les mesures suivantes.
 
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle no-reset
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle no-reset
+      \musicB
+    }
+  >>
+}
+@end lilypond
+
+@item forget
+
+@cindex @emph{forget}, style d'altérations
+@cindex altérations, style @emph{forget}
+
+@funindex forget
+
+Tout le contraire de @code{no-reset} : l'effet des altérations
+cesse aussitôt ; toutes les altérations, quelque soit leur place
+dans la mesure, sont de ce fait imprimées en fonction de l'éventuelle
+armure.
+
+@lilypond[quote]
+musicA = {
+  <<
+    \relative {
+      cis''8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative {
+      <fis a cis>8[ <fis a cis>
+      \change Staff = up
+      cis' cis
+      \change Staff = down
+      <fis, a> <fis a>]
+      \showStaffSwitch
+      \change Staff = up
+      dis'4 |
+      \change Staff = down
+      <fis, a cis>4 gis <f a d>2 |
+    }
+  }
+}
+
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle forget
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle forget
+      \musicB
+    }
+  >>
+}
+@end lilypond
+@end table
 
 @seealso
-Référence du programme : @rinternals{Ambitus},
-@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
-@rinternals{AmbitusAccidental}.
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Accidental},
+@rinternals{Accidental_engraver},
+@rinternals{GrandStaff} et
+@rinternals{PianoStaff},
+@rinternals{Staff},
+@rinternals{AccidentalSuggestion},
+@rinternals{AccidentalPlacement}.
+@rinternals{accidental-suggestion-interface}.
 
-Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
 
+@cindex altérations et notes simultanées
+@cindex notes simultanées et altérations
+@cindex altérations et accords
+@cindex accords et altérations
 
 @knownissues
+Les notes simultanées sont considérées comme des évènements séquentiels.
+Ceci implique que, dans un accord, les altérations accidentelles
+seront imprimées comme si les notes de l'accord apparaissaient l'une
+après l'autre, en fonction de l'ordre dans lequel elles ont été saisies
+-- ce qui peut poser problème lorsqu'au sein d'un accord certaines
+altérations dépendent les unes des autres.
+Ce problème est à résoudre manuellement, en insérant des @code{!}
+et des @code{?} après les notes concernées, tel @samp{<f! fis!>}.
+
+L'absence d'altération de précaution est déterminée par l'examen de la
+mesure précédente.  Néanmoins, lorsqu'un bloc @code{\alternative} suit
+une section @code{\repeat volta N}, la logique voudrait que
+l'on regarde la dernière mesure @emph{jouée} plutôt que la dernière
+@emph{imprimée}.  Dans l'exemple qui suit, vous conviendrez que le do de
+la seconde alternative ne nécessite pas son bécarre.
+
+@lilypond[quote]
+{
+  \accidentalStyle modern
+  \time 2/4
+  \repeat volta 2 {
+    c'2
+  }
+  \alternative {
+     cis'
+     c'
+  }
+}
+@end lilypond
 
-LilyPond ne gère pas les collisions entre plusieurs @emph{ambitus}
+L'astuce suivante, qui définit temporairement le recours au style
+@code{forget}, permet d'obtenir quelque chose de présentable.
+
+@lilypond[verbatim,quote]
+forget = #(define-music-function (music) (ly:music?) #{
+  \accidentalStyle forget
+  #music
+  \accidentalStyle modern
+#})
+{
+  \accidentalStyle modern
+  \time 2/4
+  \repeat volta 2 {
+    c'2
+  }
+  \alternative {
+     cis'
+     \forget c'
+  }
+}
+@end lilypond
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@translationof Ambitus
+
+@cindex ambitus
+@cindex tessiture
+@cindex amplitude
+
+L'@notation{ambitus} est l'amplitude des hauteurs d'une voix donnée dans
+une partition.  Ce terme peut aussi désigner la tessiture qu'un
+instrument est capable d'atteindre.  Souvent, cet ambitus est imprimé au
+début des partitions vocales, afin que les exécutants puissent voir au
+premier coup d'œil s'ils sont en mesure de tenir la partie en question.
+
+Pour exprimer l'ambitus d'une pièce, on indique avant la clef deux têtes
+de note représentant la hauteur la plus basse et la plus haute.  Les
+éventuelles altérations accidentelles seront automatiquement ajoutées.
+
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Ambitus_engraver"
+  }
+}
+
+\relative {
+  aes' c e2
+  cis,1
+}
+@end lilypond
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-ambitus-per-voice.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{ambitus-with-multiple-voices.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-the-ambitus-gap.ly}
+
+@seealso
+Glossaire musicologique :
+@rglos{ambitus}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Ambitus_engraver},
+@rinternals{Voice},
+@rinternals{Staff},
+@rinternals{Ambitus},
+@rinternals{AmbitusAccidental},
+@rinternals{AmbitusLine},
+@rinternals{AmbitusNoteHead},
+@rinternals{ambitus-interface}.
+
+@knownissues
+LilyPond ne gère pas les collisions entre plusieurs ambitus
 présents sur une même portée.
 
 
-@node Note heads
-@subsection Note heads
+@node Têtes de note
+@subsection Têtes de note
+@translationof Note heads
+
+Nous allons voir dans ce chapitre comment modifier l'aspect des têtes de
+note.
 
 @menu
-* Special note heads::          
-* Easy notation note heads::    
-* Shape note heads::            
-* Improvisation::               
+* Têtes de note spécifiques::
+* Têtes de note avec nom de note::
+* Têtes de note à forme variable::
+* Improvisation::
 @end menu
 
-@node Special note heads
-@unnumberedsubsubsec Special note heads
+
+@node Têtes de note spécifiques
+@unnumberedsubsubsec Têtes de note spécifiques
+@translationof Special note heads
 
 @cindex têtes de note, spéciales
+@cindex croix, tête de note
+@cindex losange, tête de note
+@cindex parlato, tête de note
+@cindex harmonique, tête de note
+@cindex guitare, tête de note
+@cindex styles, tête de note
+
+@funindex cross
+
+L'apparence des têtes de note peut évoluer au cours de la partition :
+
+@lilypond[verbatim,quote,relative=2]
+c4 b
+\override NoteHead.style = #'cross
+c4 b
+\revert NoteHead.style
+a b
+\override NoteHead.style = #'harmonic
+a b
+\revert NoteHead.style
+c4 d e f
+@end lilypond
+
+Pour une liste exhaustive des styles de tête de note, consultez
+@ref{Styles de tête de note}.
 
 Certains instruments utilisent des têtes de note différentes à des
-fins spécifiques --- des croix pour le @emph{parlato} des chanteurs ou les
-notes étouffées des guitares ; des losanges pour les harmoniques des
-cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
-losange ; pour les autres styles de tête, il vous faudra jouer avec la
-propriété @code{NoteHead}.
+fins spécifiques -- des croix (style @code{cross}) pour le
+@emph{parlato} des chanteurs ou les notes étouffées des guitares :
 
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
+@lilypond[verbatim,quote,relative=2]
+c4 b
+\xNotesOn
+ a b c4 b
+\xNotesOff
 c4 d
-\override NoteHead #'style = #'cross
-e f
-\revert NoteHead #'style
-e d <c f\harmonic> <d a'\harmonic>
 @end lilypond
 
-@noindent
-Pour une liste exhaustive des styles de tête de note, consultez 
-@ref{Note head styles}.
+Cette commande opère aussi bien sur des notes isolées qu'au sein d'un
+accord, dans une portée traditionnelle ou dans un contexte de
+tablature :
+
+@lilypond[verbatim,quote,relative=2]
+c4 b
+\xNote { e f }
+c b < g \xNote c f > b
+@end lilypond
+
+Vous pouvez utiliser, en lieu et place de @code{\xNote},
+@code{\xNotesOn} et @code{\xNotesOff}, les commandes
+@code{\deadNote}, @code{\deadNotesOn} et @code{\deadNotesOff}.
+
+Il existe un raccourci pour les notes en losange :
+
+@lilypond[verbatim,quote,relative=2]
+<c f\harmonic>2 <d a'\harmonic>4 <c g'\harmonic> f\harmonic
+@end lilypond
 
+@predefined
+@code{\harmonic},
+@code{\xNotesOn},
+@code{\xNotesOff},
+@code{\xNote}.
+@endpredefined
 
 @seealso
-Référence du programme : @rinternals{NoteHead}.
+Manuel de notation :
+@ref{Styles de tête de note},
+@ref{Notes en accords},
+@ref{Indication des harmoniques et notes étouffées}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{note-event},
+@rinternals{Note_heads_engraver},
+@rinternals{Ledger_line_engraver},
+@rinternals{NoteHead}.
+@rinternals{LedgerLineSpanner},
+@rinternals{note-head-interface},
+@rinternals{ledger-line-spanner-interface}.
 
 
-@node Easy notation note heads
-@unnumberedsubsubsec Easy notation note heads
+@node Têtes de note avec nom de note
+@unnumberedsubsubsec Têtes de note avec nom de note
+@translationof Easy notation note heads
 
 @cindex tête de note, apprentissage
 @cindex notation facile
 @cindex Hal Leonard
+@cindex @emph{easy play}, têtes de note
 
-Les notes @qq{easy play} comportent le nom de la note à l'intérieur de
-la tête.  On l'utilise dans des partitions pour débutants.
+@funindex \easyHeadsOn
+@funindex easyHeadsOn
+@funindex \easyHeadsOff
+@funindex easyHeadsOff
 
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
+Les notes « easy play » comportent le nom de la note à l'intérieur de
+la tête.  On l'utilise dans des partitions pour débutants.  L'impression
+doit être de plus grande taille, afin que les lettres soient lisibles.
+Voir à ce propos @ref{Définition de la taille de portée}.
+
+@lilypond[verbatim,quote]
+#(set-global-staff-size 26)
+\relative c' {
   \easyHeadsOn
-  c'2 e'4 f' | g'1
+  c2 e4 f
+  g1
+  \easyHeadsOff
+  c,1
+}
 @end lilypond
 
-La commande @code{\easyHeadsOn} remplace tous les réglages de l'objet
-@rinternals{NoteHead}.  L'impression doit être de plus grande
-taille, afin que les lettres soient lisibles.  Voir à ce propos
-@ref{Setting the staff size}.
-
-
 @predefined
-@funindex \easyHeadsOn
-@code{\easyHeadsOn}.
+@code{\easyHeadsOn},
+@code{\easyHeadsOff}.
 @endpredefined
 
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{numbers-as-easy-note-heads.ly}
+
+@seealso
+Manuel de notation :
+@ref{Définition de la taille de portée}.
 
-@node Shape note heads
-@unnumberedsubsubsec Shape note heads
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{note-event},
+@rinternals{Note_heads_engraver},
+@rinternals{NoteHead},
+@rinternals{note-head-interface}.
+
+
+@node Têtes de note à forme variable
+@unnumberedsubsubsec Têtes de note à forme variable
+@translationof Shape note heads
 
 @cindex tête de note, allure
+@cindex tête de note, Aiken
+@cindex tête de note, harpe sacrée
+@cindex notes profilées
+@cindex Aiken, tête de note
+@cindex harpe sacrée, tête de note
+@cindex Funk, tête de note
+@cindex tête de note, Funk
+@cindex tête de note, Harmonica Sacra
+@cindex Harmonica Sacra, tête de note
+@cindex Christian Harmony, tête de note
+@cindex tête de note, Christian Harmony
+@cindex Walker shape, tête de note
+@cindex tête de note, Walker
+
+@funindex \key
+@funindex key
+@funindex \aikenHeads
+@funindex aikenHeads
+@funindex \aikenHeadsMinor
+@funindex aikenHeadsMinor
+@funindex \sacredHarpHeads
+@funindex sacredHarpHeads
+@funindex \sacredHarpHeadsMinor
+@funindex sacredHarpHeadsMinor
+@funindex \southernHarmonyHeads
+@funindex southernHarmonyHeads
+@funindex \southernHarmonyHeadsMinor
+@funindex southernHarmonyHeadsMinor
+@funindex \funkHeads
+@funindex funkHeads
+@funindex \walkerHeads
+@funindex walkerHeads
+@funindex \funkHeadsMinor
+@funindex funkHeadsMinor
+@funindex \walkerHeadsMinor
+@funindex walkerHeadsMinor
 
 En notation profilée, le profil d'une tête de note correspond à la
 fonction harmonique de cette note dans la gamme.  Ce style de notation
 était très en vogue dans les recueils de chansons américains du XIXe
-siècle. 
-
-Des notes profilées sont produites après activation de
-@code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
+siècle.  Voici comment procéder :
 
-@lilypond[verbatim,relative=1,fragment]
-  \aikenHeads
-  c8 d4 e8 a2 g1
-  \sacredHarpHeads
-  c8 d4. e8 a2 g1
+@lilypond[verbatim,quote,relative=2]
+\aikenHeads
+c, d e f g2 a b1 c \break
+\sacredHarpHeads
+c,4 d e f g2 a b1 c \break
+\southernHarmonyHeads
+c,4 d e f g2 a b1 c \break
+\funkHeads
+c,4 d e f g2 a b1 c \break
+\walkerHeads
+c,4 d e f g2 a b1 c \break
 @end lilypond
 
 Les profils sont déterminés par la hauteur dans la gamme, le premier
-degré étant défini par la commande @code{\key}. 
+degré étant défini par la commande @code{\key}.  Pour une tonalité
+mineure, les degrés sont déterminés par rapport au relatif majeur :
 
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
+@lilypond[verbatim,quote,relative=2]
+\key a \minor
+\aikenHeads
+a b c d e2 f g1 a \break
+\aikenHeadsMinor
+a,4 b c d e2 f g1 a \break
+\sacredHarpHeadsMinor
+a,2 b c d \break
+\southernHarmonyHeadsMinor
+a2 b c d \break
+\funkHeadsMinor
+a2 b c d \break
+\walkerHeadsMinor
+a2 b c d \break
+@end lilypond
 
-Les notes profilées sont mises en œuvre par la propriété
-@code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
-de symboles.  Le n-ième élément indique le style à utiliser pour le
-n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
+@predefined
+@code{\aikenHeads},
+@code{\aikenHeadsMinor},
+@code{\funkHeads},
+@code{\funkHeadsMinor},
+@code{\sacredHarpHeads}.
+@code{\sacredHarpHeadsMinor},
+@code{\southernHarmonyHeads},
+@code{\southernHarmonyHeadsMinor},
+@code{\walkerHeads},
+@code{\walkerHeadsMinor}.
+@endpredefined
 
-@lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = #'#(cross triangle fa #f mensural xcircle diamond)
-  c8 d4. e8 a2 g1
-@end lilypond
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{applying-note-head-styles-depending-on-the-step-of-the-scale.ly}
+
+Pour une liste exhaustive des styles de tête de note, consultez
+@ref{Styles de tête de note}.
+
+@seealso
+Manuel de notation :
+@ref{Styles de tête de note}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{note-event},
+@rinternals{Note_heads_engraver},
+@rinternals{NoteHead},
+@rinternals{note-head-interface}.
 
 
 @node Improvisation
 @unnumberedsubsubsec Improvisation
+@translationof Improvisation
 
-L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
-allongée (@emph{slash}).  Ces têtes de notes sont créées  par
-l'adjonction du graveur @rinternals{Pitch_squash_engraver} au
-contexte @rinternals{Voice}, de telle sorte que la commande
-
-@example
-\set squashedPosition = #0
-\override NoteHead #'style = #'slash
-@end example
+@cindex improvisation
+@cindex notes penchées
+@cindex tête de note et improvisation
+@cindex tête de note allongée
 
-@noindent
-active les notes penchées.
+@funindex \improvisationOn
+@funindex improvisationOn
+@funindex \improvisationOff
+@funindex improvisationOff
 
-Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
-@code{\improvisationOff} pour cette séquence, comme l'illustre
-l'exemple ci dessous.
+L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
+allongée (@emph{slash}).  L'interprète jouera alors les notes qu'il
+veut, en respectant toutefois le rythme affiché. Ces têtes de notes sont
+créées ainsi :
 
-@lilypond[verbatim,ragged-right,quote]
+@lilypond[verbatim,quote,relative=2]
 \new Voice \with {
-  \consists Pitch_squash_engraver
-} \transpose c c' {
-  e8 e g a a16(bes)(a8) g \improvisationOn
-  e8
-  ~e2~e8 f4 fis8
-  ~fis2 \improvisationOff a16(bes) a8 g e
+  \consists "Pitch_squash_engraver"
+} {
+  e8 e g a a16( bes) a8 g
+  \improvisationOn
+  e8 ~
+  2 ~ 8 f4 f8 ~
+  2
+  \improvisationOff
+  a16( bes) a8 g e
 }
 @end lilypond
+
+@predefined
+@code{\improvisationOn},
+@code{\improvisationOff}.
+@endpredefined
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Pitch_squash_engraver},
+@rinternals{Voice},
+@rinternals{RhythmicStaff}.