]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/pitches.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / fr / user / pitches.itely
index c320b6cbc052d2d9dc0d7714edccaebdfcebb91b..52227dd13a2d68ed3393252b57e87101cb7609c1 100644 (file)
@@ -1,12 +1,12 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+    Translation of GIT committish: a6b100669bfc3847b3a03029d6a46ee9b1609e73
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c \version "2.11.38"
+@c \version "2.12.0"
 
 @c Translators: Frédéric Chiasson
 @c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
@@ -24,31 +24,36 @@ et les options de gravure.
 * Writing pitches::             
 * Changing multiple pitches::   
 * Displaying pitches::          
-* Note heads::
+* Note heads::                  
 @end menu
 
 
 @node Writing pitches
 @subsection Writing pitches
 
-Cette section
+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
+fichier source au clavier de l'ordinateur.
 
 @menu
-* Normal pitches::              
+* Absolute octave entry::       
+* Relative octave entry::       
 * Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
 * Note names in other languages::  
 @end menu
 
-@node Normal pitches
-@unnumberedsubsubsec Normal pitches
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
 
 @cindex noms de note
 @cindex hauteurs
+@cindex absolues, hauteurs
+@cindex absolues, octaves
+@cindex octaves absolues
 
 La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
-notation anglaise, en utilisant les lettres @code{a} à @code{g}.
+notation batave, en utilisant les lettres @code{a} à @code{g}.
 Une gamme ascendante de do majeur s'écrit
 
 @lilypond[quote,fragment,verbatim,ragged-right]
@@ -81,7 +86,91 @@ c, c,, e, g d,, d, d c
 
 Il existe une autre méthode pour préciser à quelle octave se situe la
 note à graver ; cette méthode demande moins d'indications d'octave
-(@code{'} ou @code{,}) --- voir @ref{Relative octaves}.
+(@code{'} ou @code{,}) --- voir @ref{Relative octave entry}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octave entry
+
+@cindex relatif
+@cindex indication d'octave relative
+@funindex \relative
+
+On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
+hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
+à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
+Le mode d'écriture \relative prévient ces erreurs dans la mesure où
+elles deviennent beaucoup plus évidentes : une seule erreur décale le
+reste de la pièce à une mauvaise octave.
+
+
+@example
+\relative @var{hauteur_de_référence} @var{musicexpr}
+@end example
+
+@noindent
+ou
+
+@example
+\relative @var{musicexpr}
+@end example
+
+@noindent
+@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
+définie.
+
+L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
+la manière suivante : si aucun signe de changement d'octave n'est
+utilisé, l'intervalle de base entre la note actuelle et la précédente
+sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
+tenir compte des altérations ; ainsi un @code{fisis} après un
+@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
+une quarte doublement augmentée demeure considérée comme un intervavlle
+plus petit qu'une quinte diminuée, bien que la quarte doublement
+augmentée soit de sept demi-tons et la quinte diminuée de seulement six
+demi-tons.
+
+Les signes de changement d'octave @code{'} et @code{,} peuvent être
+ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
+Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
+départ peut être spécifiée, et agira dès lors comme si elle précédait la
+première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
+spécifiée, le do central sert de point de départ.
+
+Voici le mode \relative en action.
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+On utilise les signes de changement d'octave pour les intervalles
+dépassant la quarte.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Si l'expression précédente est un accord, c'est la première note de
+l'accord qui détermine l'emplacement de la première note du prochain
+accord.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+La hauteur après @code{\relative} contient un nom de note.
+
+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}.
 
 
 @node Accidentals
@@ -130,19 +219,19 @@ d e fis g
 @end lilypond
 
 
-@snippets
-
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
-{preventing-extra-naturals-from-being-automatically-added.ly}
+@cindex quarts de ton
+@cindex demi-bémols, demi-dièses
 
-@seealso
+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 :
 
-Référence du programme : @rinternals{LedgerLineSpanner},
-@rinternals{NoteHead}.
+@lilypond[verbatim,quote,relative=2]
+ceseh1 ces ceh c cih cis cisih
+@end lilypond
 
+Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 
-@node Cautionary accidentals
-@unnumberedsubsubsec Cautionary accidentals
 
 @cindex altération, de précaution
 @cindex altération, entre parenthèses
@@ -164,28 +253,19 @@ cis cis cis! cis? c c? c! c
 @end lilypond
 
 
-@seealso
-
-L'impression automatique des altérations peut être affinée de plusieurs
-manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
-
+@snippets
 
-@node Micro tones
-@unnumberedsubsubsec Micro tones
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{preventing-extra-naturals-from-being-automatically-added.ly}
 
-@cindex quarts de ton
-@cindex demi-bémols, demi-dièses
 
-Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
-@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
-croissantes :
+@seealso
+Référence du programme : @rinternals{LedgerLineSpanner},
+@rinternals{NoteHead}.
 
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
+L'impression automatique des altérations peut être affinée de plusieurs
+manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
 
-Les micro-intervalles sont aussi exportés dans le fichier MIDI.
 
 @knownissues
 
@@ -194,6 +274,7 @@ demi (qui abaisse la hauteur trois quarts de ton), le symbole de
 LilyPond n'est donc conforme à aucun standard.
 
 
+
 @node Note names in other languages
 @unnumberedsubsubsec Note names in other languages
 
@@ -261,97 +342,12 @@ espanol.ly     do  re  mi  fa  sol la  sib si
 @subsection Changing multiple pitches
 
 @menu
-* Relative octaves::            
-* Octave check::                
+* Octave checks::                
 * Transpose::                   
 @end menu
 
-@node Relative octaves
-@unnumberedsubsubsec Relative octaves
-
-@cindex relatif
-@cindex indication d'octave relative
-@funindex \relative
-
-On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
-hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
-à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
-Le mode d'écriture \relative prévient ces erreurs dans la mesure où
-elles deviennent beaucoup plus évidentes : une seule erreur décale le
-reste de la pièce à une mauvaise octave.
-
-
-@example
-\relative @var{startpitch} @var{musicexpr}
-@end example
-
-@noindent
-ou
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
-définie.
-
-L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
-la manière suivante : si aucun signe de changement d'octave n'est
-utilisé, l'intervalle de base entre la note actuelle et la précédente
-sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
-tenir compte des altérations ; ainsi un @code{fisis} après un
-@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
-une quarte doublement augmentée demeure considérée comme un intervavlle
-plus petit qu'une quinte diminuée, bien que la quarte doublement
-augmentée soit de sept demi-tons et la quinte diminuée de seulement six
-demi-tons.
-
-Les signes de changement d'octave @code{'} et @code{,} peuvent être
-ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
-Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
-départ peut être spécifiée, et agira dès lors comme si elle précédait la
-première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
-spécifiée, le do central sert de point de départ.
-
-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-On utilise les signes de changement d'octave pour les intervalles
-dépassant la quarte.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Si l'expression précédente est un accord, c'est la première note de
-l'accord qui détermine l'emplacement de la première note du prochain
-accord.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-La hauteur après @code{\relative} contient un nom de note.
-
-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}.
-
-
-@node Octave check
-@unnumberedsubsubsec Octave check
+@node Octave checks
+@unnumberedsubsubsec Octave checks
 
 @cindex vérification d'octave
 
@@ -375,7 +371,7 @@ Il existe aussi une vérification d'octave qui ne produit pas de musique
 imprimée, ayant pour syntaxe
 
 @example
-\octave @var{hauteur}
+\octaveCheck @var{hauteur}
 @end example
 
 Cette commande vérifie que la @var{hauteur} considérée sans apostrophe
@@ -394,21 +390,21 @@ suivantes soient à nouveau à la bonne octave.
 @example
 \relative c' @{
   e
-  \octave a'
-  \octave b'
+  \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{\octave} réussit, et peut donc être enlevé sans changer le
+@code{\octaveCheck} réussit, et peut donc être enlevé sans changer le
 résultat sur la partition.
 
 @lilypond[quote,ragged-right,verbatim,fragment]
 \relative c' {
   e
-  \octave b
+  \octaveCheck b
   a
 }
 @end lilypond
@@ -440,7 +436,7 @@ majeur avec
 @end example
 
 Regardons maintenant une partie écrite pour violon --- un instrument en
-ut).  Si cette partie doit être jouée par une clarinette en la (écrite à
+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.
 
@@ -465,9 +461,10 @@ mus = { \key d \major cis d fis g }
 
 On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
 pour un instrument transpositeur.  Normalement, les hauteurs dans
-LilyPond sont écrites en ut, i.e. 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
+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 
 @example
 \transpose c bes @{ e4 @dots{} @}
 @end example
@@ -482,7 +479,6 @@ réelles, on utilisera un deuxième @code{transpose}
 
 
 @seealso
-
 Référence du programme : @rinternals{TransposedMusic}.
 
 Exemples : @rlsr{Pitches}.
@@ -503,6 +499,8 @@ musique apparaissant dans un @code{\transpose}.
 * Key signature::               
 * Ottava brackets::             
 * Instrument transpositions::   
+* Automatic accidentals::       
+* Ambitus::                     
 @end menu
 
 @node Clef
@@ -583,7 +581,6 @@ apparaître des possibilités de réglage manuel de ces propriétés.
 
 
 @seealso
-
 Dans ce manuel : @ref{Grace notes}.
 
 Référence du programme : @rinternals{Clef}.
@@ -602,7 +599,7 @@ c'est-à-dire au début de la portée.
 On définit ou modifie l'armure avec la commande @code{\key}
 
 @example
-@code{\key} @var{hauteur} @var{type}
+@code{\key} @var{hauteur} @var{mode}
 @end example
 
 @funindex \minor
@@ -617,8 +614,8 @@ On définit ou modifie l'armure avec la commande @code{\key}
 @funindex \dorian
 @cindex modes anciens
 
-Ici, @var{type} doit être @code{\major} ou @code{\minor} afin d'avoir
-respectivement @var{hauteur}-major ou @var{hauteur}-minor.  Vous pouvez
+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}.
@@ -659,7 +656,6 @@ a bes c d
 
 
 @seealso
-
 Référence du programme : @rinternals{KeyCancellation},
 @rinternals{KeySignature}.
 
@@ -669,7 +665,7 @@ Référence du programme : @rinternals{KeyCancellation},
 
 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{set-octavation} qui s'en charge.
+la fonction @code{ottava} qui s'en charge.
 
 @cindex ottava
 @cindex 15ma
@@ -678,24 +674,24 @@ la fonction @code{set-octavation} qui s'en charge.
 @lilypond[quote,ragged-right,verbatim,fragment]
 \relative c''' {
   a2 b
-  #(set-octavation 1)
+  \ottava #1
   a b
-  #(set-octavation 0)
+  \ottava #0
   a b
 }
 @end lilypond
 
-La fonction @code{set-octavation} peut aussi prendre en argument les
+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{set-octavation} :
+à @code{ottava} :
 
 @lilypond[quote,ragged-right,verbatim]
 {
-  #(set-octavation 1)
+  \ottava #1
   \set Staff.ottavation = #"8"
   c'''
 }
@@ -703,13 +699,12 @@ d'octaviation en définissant @code{ottavation} après avoir fait appel
 
 
 @seealso
-
 Référence du programme : @rinternals{OttavaBracket}.
 
 
 @knownissues
 
-@code{set-octavation} gère difficilement les changements de clé qui
+@code{ottava} gère difficilement les changements de clé qui
 pourraient intervenir alors qu'elle est effective.
 
 
@@ -769,6 +764,462 @@ c'4^"en sol"
 ...
 @end example
 
+@node Automatic accidentals
+@unnumberedsubsubsec 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 :
+
+@funindex set-accidental-style
+@example
+#(set-accidental-style 'REGLE)
+@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é :
+
+@example
+#(set-accidental-style 'REGLE #('CONTEXTE#))
+@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.
+
+Les régles d'altération suivantes sont possibles :
+
+@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.
+
+
+@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 'default) 
+       \musicA }
+       \context Staff = "down"{
+              %#(set-accidental-style 'default)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+}
+@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 | } >> }
+
+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 'voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+}
+@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
+@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
+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 | } >> }
+
+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 'modern) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
+}
+@end lilypond
+
+@item @code{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 | } >> }
+
+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 'modern-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
+}
+@end lilypond
+
+@funindex modern-voice
+@item modern-voice
+Cette règle sert aux altérations dans de la musique polyphonique destinée
+autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble
+des voix.  Les altérations sont imprimées voix par voix, mais les autres
+voix, dans le même contexte @rinternals{Staff}, en @emph{tiennent
+compte} cette fois. 
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+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 'modern-voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
+}
+@end lilypond
+
+@funindex modern-voice-cautionary
+@item modern-voice-cautionary
+Cette régle est similaire à la précédente, mais les altérations de précaution
+(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
+particulière.  On retrouve donc toutes les altérations qu'imprimerait
+@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+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 'modern-voice-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
+}
+@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
+
+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}.
+
+@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 'piano) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
+}
+@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 | } >> }
+
+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 'piano-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
+}
+@end lilypond
+
+@item no-reset
+@funindex no-reset accidental style
+C'est la même règle que @code{default}, mais l'effet des altérations
+accidentelles ne cesse jamais, même dans les mesures suivantes.
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+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 'no-reset) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'no-reset)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+}
+@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" }}}
+}
+@end lilypond
+@end table
+
+
+@seealso
+Référence du programme : @rinternals{Accidental_engraver},
+@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et
+@rinternals{AccidentalPlacement}. 
+
+
+@knownissues
+
+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.
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
+partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
+est capable d'atteindre.  Souvent, cet @emph{ambitus} est imprimé au début des
+partitions vocales, afin que les exécutants puissent voir au premier
+coup d'œil s'ils sont en mesure de tenir la partie en question.
+
+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,
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+@noindent
+aura pour résultat
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \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"
+}
+<<
+  \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
+
+@noindent
+Cet exemple met en œuvre une fonctionnalité avancée :
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@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é.
+
+
+@seealso
+Référence du programme : @rinternals{Ambitus},
+@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
+@rinternals{AmbitusAccidental}.
+
+Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
+
+
+@knownissues
+
+LilyPond ne gère pas les collisions entre plusieurs @emph{ambitus}
+présents sur une même portée.
+
+
 @node Note heads
 @subsection Note heads
 
@@ -785,7 +1236,7 @@ c'4^"en sol"
 @cindex têtes de note, spéciales
 
 Certains instruments utilisent des têtes de note différentes à des
-fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
+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
@@ -805,7 +1256,6 @@ Pour une liste exhaustive des styles de tête de note, consultez
 
 
 @seealso
-
 Référence du programme : @rinternals{NoteHead}.
 
 
@@ -816,7 +1266,7 @@ Référence du programme : @rinternals{NoteHead}.
 @cindex notation facile
 @cindex Hal Leonard
 
-Les notes @q{easy play} comportent le nom de la note à l'intérieur de
+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.
 
 @lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
@@ -829,10 +1279,11 @@ La commande @code{\easyHeadsOn} remplace tous les réglages de l'objet
 taille, afin que les lettres soient lisibles.  Voir à ce propos
 @ref{Setting the staff size}.
 
-@predefined
 
+@predefined
 @funindex \easyHeadsOn
-@code{\easyHeadsOn}
+@code{\easyHeadsOn}.
+@endpredefined
 
 
 @node Shape note heads
@@ -869,7 +1320,7 @@ 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 :
 
 @lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
+  \set shapeNoteStyles  = #'#(cross triangle fa #f mensural xcircle diamond)
   c8 d4. e8 a2 g1
 @end lilypond