Rerun scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / fr / notation / pitches.itely

diff --git a/Documentation/fr/notation/pitches.itely b/Documentation/fr/notation/pitches.itely
index d47e4a1265f9f5d299a07fe140d575af005bf17c..1ab654a7250c76349087c2d6915525230e5bd7cc 100644 (file)
--- a/Documentation/fr/notation/pitches.itely
+++ b/Documentation/fr/notation/pitches.itely
@@ -1,12 +1,14 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+

 @ignore
 @ignore

-    Translation of GIT committish: a6b100669bfc3847b3a03029d6a46ee9b1609e73
+    Translation of GIT committish: f199e875f7a7beb0afd17eae2038819baab767ff

 
     When revising a translation, copy the HEAD committish of the
 
     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
 
 @end ignore
 

-@c \version "2.12.0"
+@c \version "2.17.6"

 
 @c Translators: Frédéric Chiasson
 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
 
 @c Translators: Frédéric Chiasson
 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude


@@ -17,15 +19,15 @@
 
 @lilypondfile[quote]{pitches-headword.ly}
 
 
 @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
 
 @menu

-* Écriture des hauteurs de note::             
-* Modification de plusieurs hauteurs::   
-* Gravure des hauteurs::          
-* Têtes de note::                  
+* Écriture des hauteurs de note::
+* Modification de plusieurs hauteurs::
+* Gravure des hauteurs::
+* Têtes de note::

 @end menu
 
 
 @end menu
 
 


@@ -33,18 +35,19 @@ et les options de gravure.
 @subsection Écriture des hauteurs de note
 @translationof Writing pitches
 
 @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
 fichier source au clavier de l'ordinateur.
 
 @menu

-* Hauteurs avec octave absolue::       
-* Octaves relatives::       
-* Altérations::                 
-* Noms de note dans d'autres langues::  
+* Hauteurs avec octave absolue::
+* Octaves relatives::
+* Altérations::
+* Nom des notes dans d'autres langues::

 @end menu
 
 @end menu
 

+

 @node Hauteurs avec octave absolue
 @unnumberedsubsubsec Hauteurs avec octave absolue
 @translationof Absolute octave entry
 @node Hauteurs avec octave absolue
 @unnumberedsubsubsec Hauteurs avec octave absolue
 @translationof Absolute octave entry


@@ -55,41 +58,48 @@ fichier source au clavier de l'ordinateur.
 @cindex absolues, octaves
 @cindex octaves absolues
 
 @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
 
 @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 ,
 
 
 @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
 
 @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{Octaves relatives}.
+@seealso
+Glossaire musicologique :
+@rglosnamed{Pitch names,Noms des notes}.
+
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.

 
 
 @node Octaves relatives
 
 
 @node Octaves relatives


@@ -98,138 +108,230 @@ note à graver ; cette méthode demande moins d'indications d'octave
 
 @cindex relatif
 @cindex indication d'octave relative
 
 @cindex relatif
 @cindex indication d'octave relative

-@funindex \relative
+@cindex octave relative, indication

 
 

-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.
+@funindex \relative
+@funindex relative

 
 

+On spécifie les octaves en ajoutant @code{'} ou @code{,} aux
+noms de hauteur.  En recopiant de la musique, on a vite fait de mettre
+une note à la mauvaise octave ; ce genre d'erreur est difficile à
+retrouver.  Le mode d'écriture en octave 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.

 
 @example
 
 @example

-\relative @var{hauteur_de_référence} @var{musicexpr}
+\relative @var{hauteur_de_référence} @var{expression_musicale}

 @end example
 
 @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 :

 
 

-@example
-\relative @var{musicexpr}
-@end example
+@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.

 
 

-@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.
+@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

 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
 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.
+première note de @var{expression_musicale}.  Nous vous recommandons de
+faire référence à un do (@code{c}).

 
 

-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
+@end itemize
+
+Voici le mode @code{\relative} en action.
+
+@lilypond[verbatim,quote]
+\relative c {
+  \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.
 
 }
 @end lilypond
 
 On utilise les signes de changement d'octave pour les intervalles
 dépassant la quarte.
 

-@lilypond[quote,ragged-right,fragment,verbatim]
+@lilypond[verbatim,quote]

 \relative c'' {
 \relative c'' {

-  c g c f, c' a, e''
+  c g c f,
+  c' a, e'' c
+}
+@end lilypond
+
+Bien que ne comportant aucun signe de changement d'octave, une séquence
+de notes peut tout à fait couvrir un intervalle important.
+
+@lilypond[verbatim,quote]
+\relative c {
+  c f b e
+  a d g c
+}
+@end lilypond
+
+Lorsque plusieurs blocs @code{\relative} sont imbriqués, c'est la
+dernière clause @code{\relative} qui est prise en compte.
+
+@lilypond[verbatim,quote]
+\relative c' {
+  c d e f
+  \relative c'' {
+    c d e f
+  }
+}
+@end lilypond
+
+@code{\relative} est sans effet sur un bloc @code{\chordmode}.
+
+@lilypond[verbatim,quote]
+\new Staff {
+  \relative c''' {
+    \chordmode { c1 }
+  }
+  \chordmode { c1 }
+}
+@end lilypond
+
+@code{\relative} n'est pas permis au sein d'un bloc @code{\chordmode}.
+
+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[verbatim,quote]
+\relative c' {
+  d e
+  \transpose f g {
+    d e
+    \relative c' {
+      d e
+    }
+  }

 }
 @end lilypond
 
 }
 @end lilypond
 

+@cindex accords et octave relative
+@cindex octave relative et accords
+

 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
 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.
+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[quote,ragged-right,fragment,verbatim]
+@lilypond[verbatim,quote]

 \relative c' {
 \relative c' {

-  c <c e g>
-  <c' e g>
-  <c, e' g>
+  c
+  <c e g>
+  <c' e g'>
+  <c, e, g''>
+}
+@end lilypond
+
+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'' {
+  c2 fis
+  c2 ges
+  b2 eisis
+  b2 feses

 }
 @end lilypond
 
 }
 @end lilypond
 

-La hauteur après @code{\relative} contient un nom de note.
+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}.

 
 

-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}.
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{RelativeOctaveMusic}.

 
 
 @node Altérations
 @unnumberedsubsubsec Altérations
 @translationof Accidentals
 
 
 
 @node Altérations
 @unnumberedsubsubsec Altérations
 @translationof Accidentals
 

-@cindex noms de note, hollandais
-@cindex noms de note, par défaut
-
-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.
+@cindex altération
+@cindex armure
+@cindex clef

 
 

-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
-@end lilypond
+@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{Altérations et armure}.}

 
 

-@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 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[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
+@lilypond[verbatim,quote,relative=2]
+ais1 aes aisis aeses

 @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
 @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
+bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note

 donnera une note bécarre.
 
 donnera une note bécarre.
 

-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+@lilypond[verbatim,quote,relative=2]

 a4 aes a2
 @end lilypond
 
 a4 aes a2
 @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{Altérations et armure}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
-@end lilypond
-
-

 @cindex quarts de ton
 @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
 
 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
 
 @lilypond[verbatim,quote,relative=2]
 ceseh1 ces ceh c cih cis cisih


@@ -237,186 +339,322 @@ ceseh1 ces ceh c cih cis cisih
 
 Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 
 
 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
 @cindex altération de précaution

-@funindex ?

 @cindex altération entre parenthèses
 @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
 @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.  Ces signes
+peuvent aussi être utilisés pour imprimer des bécarres.

 
 

-@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
 
 @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]
+cis1 ~ cis ~
+\break
+cis
+@end lilypond

 
 @snippets
 
 @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}
 
 {preventing-extra-naturals-from-being-automatically-added.ly}
 

-

 @seealso
 @seealso

-Référence du programme : @rinternals{LedgerLineSpanner},
-@rinternals{NoteHead}.
+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{Altérations et armure}.

 
 

-L'impression automatique des altérations peut être affinée de plusieurs
-manières.  Pour plus d'information, voir @ref{Altérations accidentelles automatiques}.
+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}.

 
 

-@knownissues
+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.
 
 
 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 Noms de note dans d'autres langues
-@unnumberedsubsubsec Noms de note dans d'autres langues
+@node Nom des notes dans d'autres langues
+@unnumberedsubsubsec Nom des notes dans d'autres langues

 @translationof Note names in other languages
 
 @translationof Note names in other languages
 

-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 :
+@cindex notes, noms selon la langue
+@cindex noms de note, langues
+@cindex langues, noms de note

 
 

-@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
+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 :
+
+@lilypond[quote,verbatim]
+\language "italiano"
+
+\relative do' {
+  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}
+  @tab do re mi fa sol la sib si
+@item @code{italiano}
+  @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}
+  @tab -s @tab -b @tab -ss/-x @tab -bb
+@item @code{italiano}
+  @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
 
 @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
 
 @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
 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 Modification de plusieurs hauteurs
 @subsection Modification de plusieurs hauteurs
 @translationof 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
 @menu

-* Vérifications d'octave::                
-* Transposition::                   
+* Vérifications d'octave::
+* Transposition::
+* Inversion::
+* Rétrogradation::
+* Transformations modales::

 @end menu
 
 @end menu
 

+

 @node Vérifications d'octave
 @unnumberedsubsubsec Vérifications d'octave
 @translationof Octave checks
 
 @cindex vérification d'octave
 @node Vérifications d'octave
 @unnumberedsubsubsec Vérifications d'octave
 @translationof Octave checks
 
 @cindex vérification d'octave

+@cindex octave, vérification
+@cindex contrôle des hauteurs

 
 

-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,
-
-@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'' {
+  c2 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
 
 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'' {
+  c2 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
-
-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.
+Dans les deux mesures qui suivent, les premier et troisième
+@code{\octaveCheck} échouent, mais le deuxième est concluant.

 
 

-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octaveCheck b
-  a
+@lilypond[verbatim,quote]
+\relative c'' {
+  c4 f g f
+
+  c4
+  \octaveCheck c'
+  f
+  \octaveCheck c'
+  g
+  \octaveCheck c'
+  f

 }
 @end lilypond
 
 }
 @end lilypond
 

+@seealso
+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{RelativeOctaveCheck}.
+

 
 @node Transposition
 @unnumberedsubsubsec Transposition
 
 @node Transposition
 @unnumberedsubsubsec Transposition


@@ -424,815 +662,1956 @@ résultat sur la partition.
 
 @cindex transposition
 @cindex transposition des hauteurs
 
 @cindex transposition
 @cindex transposition des hauteurs

+

 @funindex \transpose
 @funindex \transpose

+@funindex transpose

 
 Une expression musicale peut être transposée avec @code{\transpose}.
 
 Une expression musicale peut être transposée avec @code{\transpose}.

-Voici la syntaxe :
+En voici la syntaxe :
+

 @example
 @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
 
 @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
 
 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 c' {
+    \key d \major
+    d4 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.
 
 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 c' {
+    \key c \major
+    c4 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' { c d e f }

 \new Staff {
 \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
 }
 @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
 @example

-\transpose c bes @{ e4 @dots{} @}
+musiqueEnSiBemol = @{ e4 @dots{} @}
+\transpose c bes, \musiqueEnSiBemol

 @end example
 
 @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
 
 @example

-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
+musiqueEnSiBemol = @{ e4 @dots{} @}
+\transpose f c' @{ \transpose c bes, \musiqueEnSiBemol @}

 @end example
 
 @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
 
 @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}.
 
 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 Gravure des hauteurs
-@subsection Gravure des hauteurs
-@translationof 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
-* Clefs::                        
-* Armure::               
-* Marques d'octaviation::             
-* Instruments transpositeurs::   
-* Altérations accidentelles automatiques::       
-* Ambitus::                     
-@end menu

 
 

-@node Clefs
-@unnumberedsubsubsec Clefs
-@translationof Clef
+@node Inversion
+@unnumberedsubsubsec Inversion
+@translationof Inversion

 
 

-@funindex \clef
+@cindex inversion
+
+@funindex \inversion

 
 

-La clé indique quelles lignes de la portée correspondent à telles
-hauteurs.  Elle est réglée par la commande @code{\clef}.
+Une expression musicale peut s'inverser et être transposée à l'aide de
+l'instruction

 
 

-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
+@example
+\inversion @var{hauteur-pivot} @var{hauteur-arrivée} @var{expression_musicale}
+@end example
+
+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[verbatim,quote]
+music = \relative c' { c d e f }
+\new Staff {
+  \music
+  \inversion d' d' \music
+  \inversion d' ees' \music
+}

 @end lilypond
 
 @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' { c8. 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
 
 }
 @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
 
 @seealso

-Dans ce manuel : @ref{Notes d'ornement}.
+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 Armure
-@unnumberedsubsubsec Armure
-@translationof 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.}
+
+
+@subsubsubheading Transposition modale
+@c VO Modal transposition

 
 

-On définit ou modifie l'armure avec la commande @code{\key}
+@cindex modale, transposition
+
+@funindex \modalTranspose
+@funindex modalTranspose
+
+Un motif peut se transposer selon une gamme donnée :

 
 @example
 
 @example

-@code{\key} @var{hauteur} @var{mode}
+\modalTranspose @var{hauteur-départ} @var{hauteur-arrivée} @var{gamme} @var{motif}

 @end example
 
 @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' { c d e f g a b }
+motif = \relative c' { c8 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{Altérations} ou
-@rlearning{Altérations et armure}.
+@lilypond[verbatim,quote]
+pentatonicScale = \relative c' { ges aes bes des ees }
+motif = \relative c' { ees8 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
 
 @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
+@lilypond[verbatim,quote]
+chromaticScale = \relative c' { c cis d dis e f fis g gis a ais b }
+motif = \relative c' { c8 d e f g a b c }

 
 

-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[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
 
 
 @end lilypond
 
 

-@seealso
-Référence du programme : @rinternals{KeyCancellation},
-@rinternals{KeySignature}.
+@subsubsubheading Inversion modale
+@c VO Modal inversion

 
 

+@cindex modale, inversion

 
 

-@node Marques d'octaviation
-@unnumberedsubsubsec Marques d'octaviation
-@translationof 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}.
+
+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 c' { ees f fis gis a b c d }
+motif = \relative c' { c8. ees16 fis8. a16 b8. gis16 f8. d16 }

 
 

-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c''' {
-  a2 b
-  \ottava #1
-  a b
-  \ottava #0
-  a b
+\new Staff {
+  \motif
+  \modalInversion fis' fis' \octatonicScale \motif

 }
 @end lilypond
 
 }
 @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' { c g' }
+motive = \relative c' { c c g' c, }
+
+\new Staff {
+  \motive
+  \modalInversion c' g' \scale \motive

 }
 @end lilypond
 
 }
 @end lilypond
 

+L'opération conjointe d'une inversion et d'une rétrogradation produit
+une rétrogradation inversée :

 
 

-@seealso
-Référence du programme : @rinternals{OttavaBracket}.
+@lilypond[verbatim,quote]
+octatonicScale = \relative c' { ees f fis gis a b c d }
+motif = \relative c' { c8. ees16 fis8. a16 b8. gis16 f8. d16 }

 
 

+\new Staff {
+  \motif
+  \retrograde \modalInversion c' c' \octatonicScale \motif
+}
+@end lilypond

 
 

-@knownissues
+@seealso
+Manuel de notation :
+@ref{Inversion},
+@ref{Rétrogradation},
+@ref{Transposition}.

 
 

-@code{ottava} gère difficilement les changements de clé qui
-pourraient intervenir alors qu'elle est effective.

 
 

+@node Gravure des hauteurs
+@subsection Gravure des hauteurs
+@translationof Displaying pitches

 
 

-@node Instruments transpositeurs
-@unnumberedsubsubsec Instruments transpositeurs
-@translationof Instrument transpositions
+Nous allons voir dans cette partie comment influer sur la gravure des
+hauteurs.

 
 

-@cindex transposition, MIDI
-@cindex transposition, instrument
+@menu
+* Clefs::
+* Armure::
+* Marques d'octaviation::
+* Instruments transpositeurs::
+* Altérations accidentelles automatiques::
+* Ambitus::
+@end menu
+
+
+@node Clefs
+@unnumberedsubsubsec Clefs
+@translationof Clef
+
+@cindex clé de sol
+@cindex clé de fa
+@cindex clé d'ut
+@cindex clés anciennes

 
 

-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).
+@funindex \clef
+@funindex clef
+
+La clef indique quelles lignes de la portée correspondent à quelles
+hauteurs.  Elle peut changer au fil du morceau, comme dans l'exemple
+suivant qui indique le do médium dans différentes clefs :
+
+@lilypond[verbatim,quote,relative=1]
+\clef treble
+c2 c
+\clef alto
+c2 c
+\clef tenor
+c2 c
+\clef bass
+c2 c
+@end lilypond

 
 

-Cette transposition s'indique après le mot-clé @code{\transposition}.
+LilyPond met à votre disposition d'autres clefs :
+
+@lilypond[verbatim,quote,relative=1]
+\clef french
+c2 c
+\clef soprano
+c2 c
+\clef mezzosoprano
+c2 c
+\clef baritone
+c2 c
+
+\break
+
+\clef varbaritone
+c2 c
+\clef subbass
+c2 c
+\clef percussion
+c2 c
+
+\break
+
+\clef G   % synonym for treble
+c2 c
+\clef F   % synonym for bass
+c2 c
+\clef C   % synonym for alto
+c2 c
+@end lilypond
+
+@cindex transposition et clef
+@cindex clef et transposition
+@cindex octave et clef
+@cindex chorale, clef de ténor
+@cindex ténor, clef
+
+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,
+
+@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
+
+Il existe d'autres clefs, destinées à un usage particulier.  Voir à ce
+sujet @ref{Notations anciennes}, @ref{Clefs anciennes},
+@ref{Clefs grégoriennes}, @ref{Tablatures par défaut} et
+@ref{Tablatures personnalisées}.  La nécessité de recourir à d'autres
+clefs dans le cas où la partition comprend des petites notes est abordée
+au chapitre @ref{Mise en forme d'une citation} -- voir les fonctions
+@code{\cueClef} et @code{\cueDuringWithClef}.
+
+@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}.
+
+Morceaux choisis:
+@rlsrnamed{Pitches,Hauteurs}.
+
+Référence des propriétés internes :
+@rinternals{Clef_engraver},
+@rinternals{Clef},
+@rinternals{OctavateEight},
+@rinternals{clef-interface}.
+
+
+@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{Altérations 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
 
 @example

-\transposition bes   %% clarinette en si bémol
+\key @var{hauteur} @var{mode}

 @end example
 
 @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
 @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{Transposition}
-pour obtenir un autre résultat.
+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
+
+@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{Altérations 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-cancellation-interface},
+@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}
+
+@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
 
 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
+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
 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 : 
+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

 
 

-@example
-clarinet = @{
-  \transposition c'
-  ...
-@}
-saxophone = @{
-  \transposition c'
-  ...
-@}
-@end example
+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.

 
 

-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 :
+@lilypond[verbatim,quote,relative=2]
+\set Staff.instrumentName = #"Cl (A)"
+\key a \major
+\transposition a
+c d e f
+\textLengthOn
+<>^\markup { Switch to B\flat clarinet }
+R1
+
+\key bes \major
+\transposition bes
+c2 g
+@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}.

 
 

-@example
-\transposition d'
-c'4^"en ré"
-...
-\transposition g'
-c'4^"en sol"
-...
-@end example

 
 @node Altérations accidentelles automatiques
 @unnumberedsubsubsec Altérations accidentelles automatiques
 @translationof Automatic accidentals
 
 @node Altérations accidentelles automatiques
 @unnumberedsubsubsec Altérations accidentelles automatiques
 @translationof Automatic accidentals

-@cindex Altérations accidentelles automatiques

 
 

-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 :
+@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 :

 
 

-@funindex set-accidental-style

 @example
 @example

-#(set-accidental-style 'REGLE)
+\new Staff <<
+  \accidentalStyle voice
+  @{ @dots{} @}
+>>

 @end example
 
 @end example
 

-@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
-
-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é :
+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 :

 
 @example
 
 @example

-#(set-accidental-style 'REGLE #('CONTEXTE#))
+\accidentalStyle StaffGroup.voice

 @end example
 
 @end example
 

-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.
+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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}

 
 

-Les régles d'altération suivantes sont possibles :
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
 @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.

 
 

+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}

 
 

-@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 |  } }}
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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 'default) 
-       \musicA }
-       \context Staff = "down"{
-              %#(set-accidental-style 'default)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle default
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle default
+      \musicB
+    }
+  >>

 }
 @end lilypond
 
 @item voice
 }
 @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. 
-
-
-@example
- \new Staff <<
-        #(set-accidental-style '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.
-
-@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{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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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 'voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle voice
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle voice
+      \musicB
+    }
+  >>

 }
 @end lilypond
 
 }
 @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 modern

 
 

+@cindex altération, style @emph{modern}
+@cindex @emph{modern}, style d'altération

 
 

-@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
+@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
 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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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
 
 }
 @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
 @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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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
 
 }
 @end lilypond
 

-@funindex modern-voice

 @item 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
 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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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
 
 }
 @end lilypond
 

-@funindex modern-voice-cautionary

 @item 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

 
 

-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 |  } }}
+@funindex modern-voice-cautionary

 
 

-\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" }}}
+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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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 modern-voice-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle modern-voice-cautionary
+      \musicB
+    }
+  >>

 }
 @end lilypond
 
 @item piano
 }
 @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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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
 }
 @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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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 piano-cautionary
+      \musicA
+    }
+    \context Staff = "down" {
+      \musicB
+    }
+  >>
+}
+@end lilypond
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle neo-modern
+      \musicB
+    }
+  >>
+}
+@end lilypond
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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 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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
+
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      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 c' {
+      <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" {
+      \key fis \minor
+      \accidentalStyle teaching
+      \musicA
+    }
+    \context Staff = "down" {
+      \key fis \minor
+      \accidentalStyle teaching
+      \musicB
+    }
+  >>

 }
 @end lilypond
 
 @item no-reset
 }
 @end lilypond
 
 @item no-reset

-@funindex no-reset accidental style
+
+@cindex altération, style @emph{no reset}
+@cindex @emph{no reset}, style d'altérations
+
+@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.
 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 | } >> }

 
 

-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 |  } }}
+@lilypond[quote]
+musicA = {
+  <<
+    \relative c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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 'no-reset) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'no-reset)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+\new PianoStaff {
+  <<
+    \context Staff = "up" {
+      \accidentalStyle no-reset
+      \musicA
+    }
+    \context Staff = "down" {
+      \accidentalStyle no-reset
+      \musicB
+    }
+  >>

 }
 @end lilypond
 
 @item forget
 }
 @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" }}}
+
+@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 c' {
+      cis'8 fis, bes4 <a cis>8 f bis4 |
+      cis2. <c, g'>4 |
+    }
+    \\
+    \relative c' {
+      ais'2 cis, |
+      fis8 b a4 cis2 |
+    }
+  >>
+}
+
+musicB = {
+  \clef bass
+  \new Voice {
+    \voiceTwo \relative c' {
+      <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
 
 }
 @end lilypond
 @end table
 

-

 @seealso
 @seealso

-Référence du programme : @rinternals{Accidental_engraver},
-@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et
-@rinternals{AccidentalPlacement}. 
+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}.

 
 

-@knownissues

 
 

+@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.
 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.
+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
+
+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 (parser location 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
 
 
 @node Ambitus
 @unnumberedsubsubsec Ambitus
 @translationof 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.
+@cindex ambitus
+@cindex tessiture
+@cindex amplitude

 
 

-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,
+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.

 
 

-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
+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.

 
 

-@noindent
-aura pour résultat
-
-@lilypond[quote,ragged-right]
+@lilypond[verbatim,quote]

 \layout {
   \context {
 \layout {
   \context {

-    \Staff
-    \consists Ambitus_engraver
+    \Voice
+    \consists "Ambitus_engraver"

   }
 }
 
   }
 }
 

-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@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"
+\relative c'' {
+  aes c e2
+  cis,1

 }
 }

-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>

 @end lilypond
 
 @end lilypond
 

-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-ambitus-per-voice.ly}

 
 

-@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é.
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{ambitus-with-multiple-voices.ly}

 
 

+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-the-ambitus-gap.ly}

 
 @seealso
 
 @seealso

-Référence du programme : @rinternals{Ambitus},
-@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
-@rinternals{AmbitusAccidental}.
-
-Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
-
+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
 
 @knownissues

-
-LilyPond ne gère pas les collisions entre plusieurs @emph{ambitus}
+LilyPond ne gère pas les collisions entre plusieurs ambitus

 présents sur une même portée.
 
 
 présents sur une même portée.
 
 


@@ -1240,41 +2619,105 @@ présents sur une même portée.
 @subsection Têtes de note
 @translationof Note heads
 
 @subsection Têtes de note
 @translationof Note heads
 

+Nous allons voir dans ce chapitre comment modifier l'aspect des têtes de
+note.
+

 @menu
 @menu

-* Têtes de note spécifiques::          
-* Têtes de note avec nom de note::    
-* Têtes de note à forme variable::            
-* Improvisation::               
+* Têtes de note spécifiques::
+* Têtes de note avec nom de note::
+* Têtes de note à forme variable::
+* Improvisation::

 @end menu
 
 @end menu
 

+

 @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
 @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
 
 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
 c4 d

-\override NoteHead #'style = #'cross
-e f
-\revert NoteHead #'style
-e d <c f\harmonic> <d a'\harmonic>

 @end lilypond
 
 @end lilypond
 

-@noindent
-Pour une liste exhaustive des styles de tête de note, consultez 
-@ref{Styles de tête de note}.
+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 qui indiquent les
+harmoniques des cordes :
+
+@lilypond[verbatim,quote,relative=2]
+<c f\harmonic>2 <d a'\harmonic>4 <c g'\harmonic>
+@end lilypond
+
+@predefined
+@code{\harmonic},
+@code{\xNotesOn},
+@code{\xNotesOff},
+@code{\xNote}.
+@endpredefined

 
 @seealso
 
 @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 Têtes de note avec nom de note
 
 
 @node Têtes de note avec nom de note


@@ -1284,25 +2727,50 @@ Référence du programme : @rinternals{NoteHead}.
 @cindex tête de note, apprentissage
 @cindex notation facile
 @cindex Hal Leonard
 @cindex tête de note, apprentissage
 @cindex notation facile
 @cindex Hal Leonard

+@cindex @emph{easy play}, têtes de note
+
+@funindex \easyHeadsOn
+@funindex easyHeadsOn
+@funindex \easyHeadsOff
+@funindex easyHeadsOff

 
 

-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.
+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[quote,ragged-right,verbatim,fragment,staffsize=26]
+@lilypond[verbatim,quote]
+#(set-global-staff-size 26)
+\relative c' {

   \easyHeadsOn
   \easyHeadsOn

-  c'2 e'4 f' | g'1
+  c2 e4 f
+  g1
+  \easyHeadsOff
+  c,1
+}

 @end lilypond
 
 @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
+@predefined
+@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}.
 
 @ref{Définition de la taille de portée}.
 

+Morceaux choisis :
+@rlsrnamed{Pitches,Hauteurs}.

 
 

-@predefined
-@funindex \easyHeadsOn
-@code{\easyHeadsOn}.
-@endpredefined
+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
 
 
 @node Têtes de note à forme variable


@@ -1310,69 +2778,166 @@ taille, afin que les lettres soient lisibles.  Voir à ce propos
 @translationof Shape note heads
 
 @cindex tête de note, allure
 @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
 
 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
 @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
 
 
 
 @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
+@cindex improvisation
+@cindex notes penchées
+@cindex tête de note et improvisation
+@cindex tête de note allongée

 
 

-@example
-\set squashedPosition = #0
-\override NoteHead #'style = #'slash
-@end example
+@funindex \improvisationOn
+@funindex improvisationOn
+@funindex \improvisationOff
+@funindex improvisationOff

 
 

-@noindent
-active les notes penchées.
-
-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 {
 \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 ~
+  e2 ~ e8 f4 f8 ~
+  f2
+  \improvisationOff
+  a16( bes) a8 g e

 }
 @end lilypond
 }
 @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}.
+
+
+@c  LocalWords:  lilypondfile subsection translationof seealso funindex
+@c  LocalWords:  unnumberedsubsubsec rglosnamed rlsrnamed itemize quote
+@c  LocalWords:  rinternals rlearning snippets texidoc doctitle
+@c  LocalWords:  ragged-right knownissues quotation multitable headitem
+@c  LocalWords:  noindent Staff.instrumentName Staff.midiInstrument
+@c  LocalWords:  accidentalStyle PianoStaff GrandStaff predefined