X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Fchords.itely;h=2f127b387d5a6e37aefcde14a9792b6ae4b10af0;hb=958e95822083954cad00e0a598eb9f12ceba67b9;hp=7ecc9e5720aa0e7707150aa5c22ebe93251890f4;hpb=3c6c00c08ff31f57ec8d88450b4e4e7917bc4f3e;p=lilypond.git

diff --git a/Documentation/fr/notation/chords.itely b/Documentation/fr/notation/chords.itely
index 7ecc9e5720..2f127b387d 100644
--- a/Documentation/fr/notation/chords.itely
+++ b/Documentation/fr/notation/chords.itely
@@ -1,23 +1,28 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 3f4496001441e0b1b27d7bc5395c4520f4f2088c
+    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.13.48"
+@c \version "2.19.21"
 
-@c Translators: Valentin Villenave
+@c Translators: Valentin Villenave,Jean-Charles Malahieude
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @node Notation des accords
 @section Notation des accords
 @translationof Chord notation
 
-@untranslated
+@lilypondfile[quote]{chords-headword.ly}
+
+Les accords se saisissent soit comme des notes normales, soit à l'aide
+d'un mode dédié, et seront rendus selon l'une des diverses nomenclatures
+occidentales.  Les accords peuvent aussi se présenter sous forme
+nominale, ou bien en basse figurée.
 
 @menu
 * Mode accords::
@@ -25,213 +30,379 @@
 * Basse chiffrée::
 @end menu
 
+
 @node Mode accords
 @subsection Mode accords
 @translationof Chord mode
 
-@untranslated
+@cindex chordmode
+@cindex accords, mode
+
+Le mode accords permet de saisir des accords en indiquant leur structure
+plutôt que les notes qui les composent.
 
 @menu
 * Généralités sur le mode accords::
 * Accords courants::
-* Extensions et altération d'accords::
+* Extension et altération d'accords::
 @end menu
 
-@c This material comes from 'Entering chord names' -FV
+
 @node Généralités sur le mode accords
 @unnumberedsubsubsec Généralités sur le mode accords
 @translationof Chord mode overview
 
-@cindex accords, chiffrage jazz
+@cindex accords, noms
+@cindex accords, chiffrage
 
-LilyPond permet de désigner les accords par leur chiffrage jazz.
-S'il est possible d'entrer un accord sous sa forme musicale, avec
-@code{<@dots{}>}, on peut aussi le saisir par son nom.  Le logiciel
-traite les accords comme des ensembles de hauteurs, donc les accords
-peuvent être transposés.
+Un accord peut se saisir en tant que musique simultanée, comme nous
+l'avons vu à la rubrique @ref{Notes en accords}.
 
-@lilypond[quote,ragged-right,verbatim]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
+LilyPond dispose aussi d'un @qq{mode accords} au sein duquel sera
+considérée la structure des accords, tels qu'ils se présentent dans les
+traditions occidentales, plutôt que les différentes hauteurs qui les
+composent.  Ce mode est tout à fait adapté pour ceux qui sont plus
+habitués aux accords nommés.  Pour plus d'information quant aux
+différentes façons de libeller votre code, voir @ref{Modes de saisie}.
 
-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c1 g a g c }
 @end lilypond
 
-Cet exemple montre également que les jeux d'instructions qui permettent
-à LilyPond d'imprimer des accords ne cherchent pas à se montrer
-intelligents.  Ici, le dernier accord n'est pas interprété comme étant
-renversé.
+Tout accord saisi dans ce mode dédié constitue un élément musical à
+part entière ; il pourra donc par exemple être transposé comme
+n'importe quel ensemble de hauteurs simultanées.  @code{\chordmode}
+travaille en absolu ; une instruction @code{\relative} restera sans
+effet au sein d'un bloc @code{chordmode}.  Notez toutefois que les
+hauteurs absolues sont une octave plus haut en @code{\chordmode} qu'en
+mode notes traditionnel.
+
+Mode notes et mode accords peuvent tout à fait cohabiter dans une
+séquence musicale :
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+<c e g>2 <g b d>
+\chordmode { c2 f }
+<c e g>2 <g' b d>
+\chordmode { f2 g }
+@end lilypond
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Notes en accords},
+@ref{Modes de saisie}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
 
-Notez bien que la valeur rythmique des accords doit être indiquée
-@emph{à l'extérieur} des symboles @code{<>}.
+@knownissues
+Les raccourcis d'articulation ou d'ornementation ne sont pas disponibles
+en mode accord -- voir @ref{Articulations et ornements}.
 
-@example
-<c e g>2
-@end example
 
-@c This material comes from 'Chords mode' -FV
 @node Accords courants
 @unnumberedsubsubsec Accords courants
 @translationof Common chords
 
+@cindex triades
+@cindex septième
+@cindex fondamentale
+@cindex accords, modificateur
+@cindex qualité d'accord
+
 Dans le mode accords, introduit par la commande @code{\chordmode}, les
-accords ne sont indiqués que par leur note fondamentale.
+accords ne sont indiqués que par leur note fondamentale, à laquelle on
+peut adjoindre une durée.
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2 f4 g }
+@end lilypond
+
+On peut cependant obtenir des accords différents -- mineur, augmenté ou
+diminué -- en utilisant le caractère deux points (@code{:}).
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2:m f4:aug g:dim }
+@end lilypond
+
+Les accords de septième sont aisément stipulables :
 
 @lilypond[quote,ragged-right,verbatim]
-\chordmode { es4. d8 c2 }
+\chordmode { c1:7 c:m7 c:maj7 c:dim7 c:aug7 }
 @end lilypond
 
-@cindex saisir des accords
-@cindex mode accords
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex m
 
-On peut cependant obtenir des accords différents, en utilisant le
-caractère deux points (@code{:}).
+Voici les différents modificateurs d'accord de trois sons ou de
+septième.  Par défaut, la septième ajoutée sera mineure ; la
+septième de dominante est donc l'accord de septième de base.  Toutes les
+altérations sont relatives à la septième de dominante.  Une table
+étendue des modificateurs et de leur utilisation est à l'annexe
+@ref{Modificateurs d'accord usuels}.
+
+@c @table @code
+@multitable @columnfractions .2 .4 .3
+
+@item
+@b{Modificateur}
+@tab
+@b{Action}
+@tab
+@b{Exemple}
+
+@item
+Néant
+@tab
+Action par défaut ; produit une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \omit Staff.TimeSignature
+  c1
+}
+@end lilypond
 
-@lilypond[quote,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
+@item
+m, m7
+@tab
+Accord mineur.  Ce modificateur abaisse la tierce, et la septième s'il y
+en a une.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \omit Staff.TimeSignature
+  c1:m c:m7
+}
 @end lilypond
 
-Le nombre accolé à la note fondamentale est considéré comme chiffrage
-jazz de l'accord, qui est de ce fait construit par un empilement de
-tierces. Notez l'exception que constitue @code{c:13} dans lequel la
-onzième est délibérément omise.
+@item
+dim, dim7
+@tab
+Accord diminué.  Ce modificateur minorise la tierce, diminue la quinte et
+la septième s'il y en a.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \omit Staff.TimeSignature
+  c1:dim c:dim7
+}
+@end lilypond
 
-@lilypond[quote,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@item
+aug
+@tab
+Accord augmenté.  Ce modificateur augmente la quinte.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \omit Staff.TimeSignature
+  c1:aug
+}
+@end lilypond
+
+@item
+maj, maj7
+@tab
+Accord de septième majeure. Ce modificateur majorise la septième.  Le
+@code{7} à la suite du est @code{maj} facultatif.  Ce modificateur ne
+sert pas à créer une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+  \omit Staff.TimeSignature
+  c1:maj c:maj7
+}
 @end lilypond
 
-@cindex note fondamentale
-@cindex notes ajoutées
-@cindex accords incomplets
+@end multitable
 
-Des accords encore plus complexes peuvent être élaborés en plusieurs
-étapes séparées.  Ainsi, on peut enrichir l'accord par des notes
-ajoutées, que l'on indique après le chiffrage principal et que l'on
-sépare par des points@tie{}:
+@seealso
+Manuel de notation :
+@ref{Extension et altération d'accords},
+@ref{Modificateurs d'accord usuels}.
 
-@lilypond[quote,verbatim]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+@knownissues
+Un accord ne devrait comporter qu'un seul modificateur de qualité.  La
+présence de plusieurs modificateurs ne déclenchera ni avertissement, ni
+erreur, mais le résultat pourrait être surprenant.  Un accord qui n'est
+pas constructible à l'aide d'un unique modificateur devra faire l'objet
+d'une altération de ses composantes, comme indiqué à la rubrique
+@ref{Extension et altération d'accords}.
+
+
+@node Extension et altération d'accords
+@unnumberedsubsubsec Extension et altération d'accords
+@translationof Extended and altered chords
+
+Le mode accords permet d'élaborer des accords complexes.  Ainsi, on peut
+enrichir l'accord par des notes ajoutées, enlever certaines notes,
+augmenter ou diminuer certains intervalles, ajouter la note de basse ou
+créer un renversement.
+
+Le premier nombre qui suit le caractère deux-points (@code{:}) permet de
+déterminer l'étendue d'un accord.  L'accord sera construit par ajout à
+la fondamentale, d'autant de tierces consécutives que nécessaire pour
+atteindre le nombre spécifié.  N'oubliez pas que la septième ajoutée à
+un accord est minorée par défaut.  Lorsque le dernier degré ne
+correspond pas à une tierce -- la sixte par exemple -- les tierces
+seront empilées jusqu'à celle directement inférieure au degré mentionné,
+qui sera alors ajouté pour conclure l'accord.  L'étendue maximale
+autorisée est la treizième ; toute étendue plus élevée sera
+interprétée comme un accord de treizième.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1:2 c:3 c:4 c:5
+  c1:6 c:7 c:8 c:9
+  c1:10 c:11 c:12 c:13
+  c1:14
+}
 @end lilypond
 
-On peut augmenter ou diminuer certains intervalles au moyen des
-signes @code{-} ou @code{+}@tie{}:
+@noindent
+Notez bien que @code{c:5} et @code{c} produisent tous deux une triade de
+do majeur.
+
+Dans la mesure où un accord de treizième majeure ne sonne pas très bien
+avec la onzième, la onzième est automatiquement enlevée, sauf à l'avoir
+explicitement spécifiée.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+  c1:13 c:13.11 c:m13
+}
+@end lilypond
+
+@cindex additions à un accord
+@cindex accord, additions
+
+On peut enrichir l'accord par des notes ajoutées, que l'on indique après
+le chiffrage principal et que l'on sépare par des points, sans oublier
+que si l'on y ajoute une septième, celle-ci sera minorée et non majeure.
 
 @lilypond[quote,verbatim]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+\chordmode {
+  c1:5.6 c:3.7.8 c:3.6.13
+}
 @end lilypond
 
-On peut aussi enlever certaines notes de l'accord, en les spécifiant
-après un signe @code{^} -- les notes ajoutées doivent être indiquées
-@emph{avant} les notes à enlever.
+Les notes ajoutées peuvent monter aussi haut que de besoin.
 
 @lilypond[quote,verbatim]
-\chordmode { c^3 c:7^5 c:9^3.5 }
+\chordmode {
+  c4:5.15 c:5.20 c:5.25 c:5.30
+}
 @end lilypond
 
-Voici les différents chiffrages disponibles, en plus des nombres que
-nous venons de voir@tie{}:
+@cindex accord, altération d'un degré
 
-@table @code
-@item m
-Accord mineur.  Ce chiffrage minorise la tierce, et la septième s'il y
-en a une.
+On peut augmenter ou diminuer certains intervalles au moyen des
+signes @code{-} ou @code{+} au degré considéré.  L'altération de l'un
+des degrés automatiquement inclus dans la structure de base d'un accord
+s'effectue de la même manière.
 
-@item dim
-Accord diminué.  Ce chiffrage minorise la tierce, diminue la quinte et
-la septième s'il y en a.
+@lilypond[quote,verbatim]
+\chordmode {
+  c1:7+ c:5+.3- c:3-.5-.7-
+}
+@end lilypond
 
-@item aug
-Accord augmenté.  Ce chiffrage augmente la quinte.
+@cindex accord, suppression d'un degré
 
-@item maj
-Accord de septième majeure. Ce chiffrage majorise la septième s'il y
-en a une (dans le cas d'un accord parfait, ce chiffrage est facultatif).
+@funindex ^
 
-@item sus
-Accord de suspension. Ce chiffrage supprime la tierce, et y ajoute,
-suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
-quarte.
-@end table
+Après avoir ajouté des notes à un accord, on peut aussi en enlever
+certaines, en les spécifiant derrière un signe @code{^} -- les séparer
+par un point lorsqu'il y en a plus d'une.
 
-Il est bien sûr possible de mélanger ces chiffrages avec des notes
-ajoutées.
 @lilypond[quote,verbatim]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+\chordmode {
+  c1^3 c:7^5 c:9^3 c:9^3.5 c:13.11^3.7
+}
 @end lilypond
 
-@cindex chiffrages des accords
-@funindex aug
-@funindex dim
-@funindex maj
 @funindex sus
-@funindex m
 
-Dans la mesure où un accord de treizième majeure ne sonne pas très bien
-avec la onzième, la onzième est enlevée automatiquement, à moins que
-vous ne le spécifiez explicitement.
+L'ajout du modificateur @code{sus} permet de créer un accord de
+suspension.  Ceci aura pour effet de supprimer la tierce et y ajouter,
+suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
+quarte.  @code{sus} est équivalent à @code{^3} ; @code{sus4} est
+équivalent à @code{.4^3}.
 
 @lilypond[quote,ragged-right,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
+\chordmode {
+  c1:sus c:sus2 c:sus4 c:5.4^3
+}
 @end lilypond
 
 @funindex /
+@cindex accord, inversion
+@cindex accord, spécifier la basse
+@cindex basse d'un accord
 
 Les accords peuvent être renversés ou combinés avec une note étrangère à
-la basse, au moyen de @code{@var{accord}/}@var{note}
+la basse, au moyen de @code{@var{accord}/}@var{hauteur}.
+
 @lilypond[quote,ragged-right,verbatim]
-\chordmode { c1 c/g c/f }
+\chordmode {
+  c'1 c'/e c'/f
+}
 @end lilypond
+
 @funindex /+
 
 Si la note de basse précisée appartient à l'accord, la doublure
 supérieure sera supprimée.  Pour l'éviter, utilisez la syntaxe
-@code{/+}@var{note}.
+@code{/+}@var{hauteur}.
 
 @lilypond[quote,ragged-right,verbatim]
-\chordmode { c1 c/+g c/+f }
+\chordmode {
+  c'1 c'/g c'/+e
+}
 @end lilypond
 
-Le mode accords est semblable à @code{\lyricmode} ou autre, c'est-à-dire
-que la plupart des commandes sont encore disponibles@tie{}; ainsi,
-@code{r} ou @code{\skip} peuvent servir à insérer des silences ou des
-silences invisibles.  De plus, les propriétés des objets peuvent être
-ajustées ou modifiées.
+Une table étendue des modificateurs et de leur utilisation est à
+l'annexe @ref{Modificateurs d'accord usuels}.
 
-@knownissues
+@seealso
+Manuel de notation :
+@ref{Modificateurs d'accord usuels}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
 
+@knownissues
 Aucun nom de note ne peut être indiqué deux fois dans un accord.  Ainsi,
 dans l'accord suivant, seule la quinte augmentée est prise en compte,
-car elle est indiquée en dernier@tie{}:
+parce qu'elle est indiquée en dernier :
 
-@cindex agrégats
 @lilypond[quote,ragged-right,verbatim]
-\chordmode { c:5.5-.5+ }
+\chordmode { c1:5.5-.5+ }
 @end lilypond
 
-@node Extensions et altération d'accords
-@unnumberedsubsubsec Extensions et altération d'accords
-@translationof Extended and altered chords
-
-@untranslated
 
 @node Gravure des accords
 @subsection Gravure des accords
 @translationof Displaying chords
 
-@untranslated
+Les accords peuvent se présenter aussi bien sous forme nominative que
+comme un empilement de notes sur une portée.
 
 @menu
 * Impression des noms d'accord::
 * Personnalisation des noms d'accord::
 @end menu
 
+
 @node Impression des noms d'accord
 @unnumberedsubsubsec Impression des noms d'accord
 @translationof Printing chord names
@@ -239,164 +410,294 @@ car elle est indiquée en dernier@tie{}:
 @cindex chiffrages d'accords
 @cindex accords
 
-Les chiffrages d'accords sont liés au contexte
-@rinternals{ChordNames}.  Les accords peuvent être saisis soit au
-moyen de la notation indiquée ci-dessus, soit directement avec les
-symboles @code{<} et @code{>}.
+Les chiffrages d'accords sont liés au contexte @code{ChordNames} :
 
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  \chordmode {
+    c2 f4. g8
+  }
 }
-<<
-  \new ChordNames \harmonies
-  \new Staff \harmonies
->>
 @end lilypond
 
-Vous pouvez faire ressortir les chiffrages d'accords en assignant la
-valeur vrai à la propriété @code{chordChanges} dans le contexte
-@rinternals{ChordNames}.  De cette façon, les chiffrages ne sont
-imprimés qu'aux changements d'accord ou en début de ligne.
+Les accords peuvent être saisis soit en tant que hauteurs simultanées,
+soit au moyen du mode accords.  Le chiffrage affiché sera identique quel
+que soit le mode de saisie, à moins qu'il n'y ait inversion ou ajout de
+la basse.
 
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
+@lilypond[verbatim,quote]
+chordmusic = \relative {
+  <c' e g>2 <f bes c>
+  <f c' e g>1
+  \chordmode {
+    c2 f:sus4 c1:/f
+  }
 }
 <<
   \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
+    \chordmusic
+  }
+  {
+    \chordmusic
+  }
 >>
 @end lilypond
 
-Les exemples précédents montrent des chiffrages placés au-dessus de la
-portée, mais ce n'est pas obligatoire@tie{}: les accords peuvent également
-être imprimés séparément -- auquel cas vous aurez peut-être besoin
-d'ajouter le @rinternals{Volta_engraver} et le
-@rinternals{Bar_engraver} afin que les éventuelles barres de reprises
-s'affichent correctement.
+@cindex no chord, symbole
+@cindex N.C., symbole
+@cindex accords, No Chord
 
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-extent = #'(-2 . 2)
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
+L'apparition de silences dans un contexte @code{ChordNames} déclenchera
+l'impression d'un @emph{markup} @code{noChordSymbol}.
+
+@lilypond[verbatim, quote, relative=1]
+<<
+  \new ChordNames \chordmode {
+    c1
+    r1
+    g1
+    c1
+  }
+  \chordmode {
+    c1
+    r1
+    g1
+    c1
+  }
+>>
+@end lilypond
+
+@funindex \chords
+
+@code{\chords @{ @dots{} @}} est un raccourci de
+@code{\new ChordNames @{ \chordmode @{ @dots{} @} @}}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c2 f4.:m g8:maj7
 }
+@end lilypond
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  \chordmode {
+    c2 f4.:m g8:maj7
+  }
 }
 @end lilypond
 
-Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
-pour le jazz (cf. @ressay{Références bibliographiques}).  Il s'agit
-d'une notation anglo-saxonne@tie{}; cependant vous pouvez indiquer vos
-chiffrages en notation française au moyen de la commande
-@code{\frenchChords} (voir plus bas).
+@snippets
 
-Il est possible de créer votre propre modèle de chiffrages en
-réglant les propriétés suivantes@tie{}:
+@c Keep index entries with following snippet
+@cindex accords, suppression des répétitions
+@funindex chordChanges
 
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-C'est la liste des accords mis en forme de manière particulière.
-
-Cette liste d'exceptions s'indique de la façon suivante.
-On commence par créer une expression musicale telle que
-@example
-@code{chExceptionMusic} = @{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-puis on la transforme en liste d'exceptions au moyen du code
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Pour qu'elles soient effectives, on ajoute ces exceptions aux exceptions
-par défaut définies dans @file{ly/chord-modifier-init.ly}@tie{}:
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{showing-chords-at-changes.ly}
 
-@cindex exceptions, chiffrage d'accords
-@cindex chiffrage d'accords, exceptions
-@cindex accords chiffrés, exceptions
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
-{chord-name-exceptions.ly}
+@c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+@c {adding-bar-lines-to-chordnames-context.ly}
 
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Cette propriété définit l'objet employé pour indiquer une septième
-majeure.  Les options prédéfinies sont @code{whiteTriangleMarkup}
-(triangle blanc) et @code{blackTriangleMarkup} (triangle noir).
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{simple-lead-sheet.ly}
 
-@funindex chordNameSeparator
-@item chordNameSeparator
-Les différents termes d'un chiffrage jazz (par exemple les notes de
-l'accord et la basse) sont habituellement séparés par une barre oblique.
-La propriété @code{chordNameSeparator} permet d'indiquer un autre
-séparateur, par exemple
-@lilypond[quote,ragged-right,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Saisie de musique en parallèle}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :
+@rinternals{ChordNames},
+@rinternals{ChordName},
+@rinternals{Chord_name_engraver},
+@rinternals{Volta_engraver},
+@rinternals{Bar_engraver}.
+
+@knownissues
+Un accord contenant un renversement ou dont la basse est changée ne sera
+pas chiffré correctement s'il est saisi en tant que musique simultanée.
+
+
+@node Personnalisation des noms d'accord
+@unnumberedsubsubsec Personnalisation des noms d'accord
+@translationof Customizing chord names
+
+@cindex accord, personnalisation du chiffrage
+@cindex chiffrage d'accords, personnalisation
+
+Il existe plus d'un système de chiffrage d'accords.  Le nom des accords
+varie selon les traditions musicales, et plusieurs symboles représentent
+un même accord.  LilyPond vous permet de créer votre propre nomenclature
+d'accords, tant au niveau des noms que des symboles qui les
+représenteront.
+
+@cindex jazz, accords
+@cindex accords jazz
+
+Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
+pour le jazz (cf. @ressay{Références bibliographiques}).Il est possible
+de créer votre propre modèle de chiffrages à l'aide des différentes
+propriétés mentionnées ci-dessous.  LilyPond dispose d'un système
+alternatif de chiffrage jazz qui a été élaboré grâce à ces même
+propriétés.  Les deux notations, Ignatzek et alternative, sont illustrés
+à l'annexe @ref{Table des noms d'accord}.
+
+@c TODO --  Change this so we don't have a non-verbatim example.
+@c  Make short example in docs, then move longer example to
+@c  appendix, where the length of the snippet won't matter.
+
+En plus des différents systèmes de nommage, le nom de la fondamentale
+varie selon la langue utilisée.  Les instructions @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} et @code{\frenchChords}
+permettent de définir la langue, comme vous pouvez le constater :
+
+@lilypondfile[ragged-right]
+{chord-names-languages.ly}
+
+@funindex chordNameLowercaseMinor
+Nombre de carnets de chant allemands indiquent un accord mineur par
+l'emploi de caractères en minuscule, sans le suffixe @code{m}.  Cette
+fonctionnalité est gérée par la propriété
+@code{chordNameLowercaseMinor} :
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  \set chordNameLowercaseMinor = ##t
+  c2 d:m e:m f
 }
 @end lilypond
 
+Lorsqu'aucun des systèmes prédéfinis ne vous permet de représenter
+l'accord voulu, les propriétés suivantes vous permettront de le
+construire.
+
+@table @code
+
 @funindex chordRootNamer
+
 @item chordRootNamer
 Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
 est exprimée par une lettre capitale, parfois suivie d'une altération,
 correspondant à la notation anglo-saxonne de la musique.  Cette
 propriété a pour valeur la fonction qui transforme la hauteur de la note
-foncdamentale en nom de note@tie{}; c'est donc en assignant une nouvelle
+fondamentale en nom de note ; c'est donc en assignant une nouvelle
 fonction à cette propriété que l'on peut produire des noms de note
-spéciaux, adaptés par exemple aux systèmes de notation d'autres pays.
+spéciaux adaptés par exemple aux systèmes de notation d'autres pays.
+
+@funindex majorSevenSymbol
+
+@item majorSevenSymbol
+Cette propriété définit l'objet ajouté au @code{chordRootNamer} pour
+indiquer une septième majeure.  Les options prédéfinies sont
+@code{whiteTriangleMarkup} (triangle blanc) et
+@code{blackTriangleMarkup} (triangle noir).
+
+@funindex additionalPitchPrefix
+
+@item additionalPitchPrefix
+Lorsqu'un chiffrage contient des notes ajoutées, vous pouvez le préfixer
+d'une annotation.  LilyPond n'en ajoute pas par défaut, dans le but de
+ne pas trop surcharger la partition ; vous pouvez cependant les
+faire apparaître si elles sont visuellement efficaces.
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+  <c e g d'>    % add9
+  \set additionalPitchPrefix = #"add"
+  <c e g d'>    % add9
+}
+@end lilypond
 
 @funindex chordNoteNamer
+
 @item chordNoteNamer
 Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
 les règles utilisées sont par défaut celles définies par la propriété
-@code{chordRootNamer} ci-dessus.  Cependant, la propriété @code{chordNoteNamer}
-permet de régler cet élément indépendamment, par exemple pour imprimer la basse
-en caractères minuscules.
+@code{chordRootNamer} ci-dessus.  Cependant, la propriété
+@code{chordNoteNamer} permet de régler cet élément indépendamment, par
+exemple pour imprimer la basse en caractères minuscules.
 
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-Le petit @code{m} qui indique un accord mineur est, dans la notation
-anglo-saxonne, attaché à la lettre de l'accord. Cependant il est
-possible d'ajouter un espace en assignant la valeur vrai à la propriété
-@code{chordPrefixSpacer}.  Cet espace sera omis si une altération est
-présente.
+@funindex chordNameSeparator
 
-@end table
+@item chordNameSeparator
+Les différents termes d'un chiffrage jazz (par exemple les notes de
+l'accord et la basse) sont habituellement légèrement espacés.  La
+propriété @code{chordNameSeparator} permet d'indiquer un autre
+séparateur.  Le séparateur entre un chiffrage et sa basse est géré par
+la propriété @code{slashChordSeparator}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:7.9- c:7.9-/g
+  \set chordNameSeparator = \markup { "/" }
+  \break
+  c4:7.9- c:7.9-/g
+}
+@end lilypond
 
-Les propriétés ci-dessus font l'objet de commandes prédéfinies
-adaptées aux notations de différents pays@tie{}: @code{\germanChords} et
-@code{\semiGermanChords} pour la notation allemande,
-@code{\italianChords} pour la notation italienne et enfin
-@code{\frenchChords} pour la notation française.
+@funindex slashChordSeparator
+
+@item slashChordSeparator
+La note basse d'un accord n'est pas forcément la fondamentale.  L'accord
+est alors @qq{renversé} -- certains diront @qq{barré} parce que son
+chiffrage est habituellement flanqué d'une barre oblique entre l'accord
+de base et sa basse.  La propriété @code{slashChordSeparator} permet de
+modifier ce séparateur -- par défaut la barre de fraction.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:7.9- c:7.9-/g
+  \set slashChordSeparator = \markup { " over " }
+  \break
+  c4:7.9- c:7.9-/g
+}
+@end lilypond
 
-@lilypondfile[ragged-right]{chord-names-languages.ly}
+@funindex chordNameExceptions
 
-@cindex Banter
-@cindex jazz, chiffrages d'accords
-@cindex accords jazz, chiffrage
-LilyPond intègre également deux autres modèles de chiffrages@tie{}: une
-notation Jazz alternative, et un modèle systématique appelé système
-Banter.  Pour la mise en œuvre de ces modèles, voir
-@ref{Table des noms d'accord}.
+@item chordNameExceptions
+Cette propriété recense, sous forme de paire, les accords mis en forme
+de manière particulière.  Le premier élément de chacune des paires
+répertorie les différentes hauteurs qui constituent l'accord.  Le second
+élément est un @emph{markup} qui sera ajouté au @code{chordRootNamer}
+lors de l'impression du chiffrage.
+
+@funindex minorChordModifier
+
+@item minorChordModifier
+Les accords mineurs sont habituellement identifiés par un @code{m} après
+leur fondamentale.  Certaines nomenclatures ont cependant adopté un
+autre suffixe, comme le signe moins.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+  c4:min f:min7
+  \set minorChordModifier = \markup { "-" }
+  \break
+  c4:min f:min7
+}
+@end lilypond
 
+@funindex chordPrefixSpacer
+
+@item chordPrefixSpacer
+Le modificateur pour accord mineur, géré par la propriété
+@code{minorChordModifier}, est en principe accolé la fondamentale.  Vous
+pouvez cependant l'espacer de la fondamentale à l'aide de la propriété
+@code{chordPrefixSpacer}.  Notez bien que cet espacement sera réduit à
+néant si la fondamentale est altérée.
+
+@end table
 
 @predefined
+@funindex symboles de septième majeure
+@code{\whiteTriangleMarkup},
+@code{\blackTriangleMarkup},
 @funindex \germanChords
 @code{\germanChords},
 @funindex \semiGermanChords
@@ -408,34 +709,71 @@ Banter.  Pour la mise en œuvre de ces modèles, voir
 @endpredefined
 
 
+@snippets
+
+@cindex exceptions, chiffrage d'accords
+@cindex chiffrage d'accords, exceptions
+@cindex accords chiffrés, exceptions
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-exceptions.ly}
+
+@c TODO - tweak snippet to use \blackTriangleMarkup as well
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-major7.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-bar-lines-to-chordnames-context.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{volta-below-chords.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-chord-separator.ly}
+
 @seealso
-Morceaux choisis :
-@rlsrnamed{Chords,Accords}.
+Manuel de notation :
+@ref{Table des noms d'accord},
+@ref{Modificateurs d'accord usuels}.
 
-Fichiers internes :
+Essai sur la gravure musicale automatisée :
+@ressay{Références bibliographiques}.
+
+Fichiers d'initialisation :
 @file{scm/chords-ignatzek.scm},
-@file{scm/chord-entry.scm}.
+@file{scm/chord-entry.scm},
+@file{ly/chord-modifier-init.ly}.
 
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
 
 @knownissues
-
 Les chiffrages d'accords ne sont déterminés que par la succession des
 hauteurs de notes.  En d'autres termes, les accords inversés ne sont pas
 reconnus, ni les notes ajoutées à la basse.  C'est pourquoi les accords
 saisis au moyen de la syntaxe @code{<@dots{}>} peuvent produire des
 chiffrages étranges.
 
-@node Personnalisation des noms d'accord
-@unnumberedsubsubsec Personnalisation des noms d'accord
-@translationof Customizing chord names
+@lilypond[quote,ragged-right,verbatim]
+myChords = \relative c' {
+  \chordmode { c1 c/g c/f }
+  <c e g>1 <g c e> <f c' e g>
+}
+<<
+  \new ChordNames { \myChords }
+  \new Staff { \myChords }
+>>
+@end lilypond
 
-@untranslated
 
 @node Basse chiffrée
 @subsection Basse chiffrée
 @translationof Figured bass
 
-@untranslated
+@c Line width hack because of instrument names
+@lilypondfile[quote,staffsize=18,line-width=14.5\cm]
+{figured-bass-headword.ly}
+
+LilyPond permet de générer des parties de continuo.
 
 @menu
 * Introduction à la basse chiffrée::
@@ -443,7 +781,7 @@ chiffrages étranges.
 * Gravure de la basse chiffrée::
 @end menu
 
-@c This material comes from 'Figured bass', needs redistribution by translator --FV
+
 @node Introduction à la basse chiffrée
 @unnumberedsubsubsec Introduction à la basse chiffrée
 @translationof Introduction to figured bass
@@ -472,194 +810,353 @@ LilyPond gère la basse chiffrée.
 @lilypond[quote,ragged-right,verbatim]
 <<
   \new Voice { \clef bass dis4 c d ais g fis}
-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
+  \new FiguredBass {
+    \figuremode {
+      < 6 >4 < 7\+ >8 < 6+ [_!] >
+      < 6 >4 <6 5 [3+] >
+      < _ >4 < 6 5/>4
+    }
   }
 >>
 @end lilypond
 
 La gestion de la basse chiffrée se décompose en deux parties.  Dans un
 premier temps, le mode @code{\figuremode} permet de saisir les accords
-sous forme chiffrée.  Le contexte @rinternals{FiguredBass} s'occupera
-ensuite de gérer les objets @rinternals{BassFigure}.
+sous forme chiffrée.  Le contexte @code{FiguredBass} s'occupera ensuite
+de gérer les objets @code{BassFigure}.  La basse chiffrée pourra être
+attachée à un contexte @code{Staff}.
+
+L'expression @code{\figures@{ @dots{} @}} constitue une raccourci à
+@code{\new FiguredBass @{ \figuremode @{ @dots{} @} @}}.
+
+Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
+des accords, elle est beaucoup plus simpliste.  Le mode
+@code{\figuremode} ne fait que stocker des chiffres que le contexte
+@code{FiguredBass} se chargera d'imprimer tels quels.  En aucune manière
+ils ne sont transformés en son, et ils ne sont pas rendus dans un
+fichier MIDI.
+
+@ignore
+En interne, ce code produit des étiquettes de texte que vous
+pouvez formater à votre convenance grâce aux propriétés des
+étiquettes.  Par exemple, l'espacement vertical des chiffrages est
+déterminé par la propriété @code{baseline-skip}.
+@end ignore
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{figured bass, basse chifrée}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+
+@node Saisie de la basse chiffrée
+@unnumberedsubsubsec Saisie de la basse chiffrée
+@translationof Entering figured bass
+
+@code{\figuremode} permet de faire la relation entre ce qui est saisi et
+le mode de chiffrage.  De plus amples informations quant aux différents
+modes sont regroupées à la rubrique @ref{Modes de saisie}.
 
 En mode de saisie, un chiffrage est délimité par @code{<} et
-@code{>}.  La  durée est indiquée après le @code{>}@tie{}:
+@code{>}.  La  durée est indiquée après le @code{>} :
+
+@lilypond[verbatim,quote,ragged-right]
+\new FiguredBass {
+  \figuremode {
+    <6 4>2
+  }
+}
+@end lilypond
 
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right]
-\new FiguredBass
-\figuremode { <4 6> }
+Une altération -- y compris un bécarre -- peut s'attacher à un
+chiffre :
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <7! 6+ 4-> <5++> <3-->
+}
 @end lilypond
 
-Les altérations s'obtiennent en ajoutant aux chiffres les caractères
-@code{-}, @code{!} ou @code{+}. Un signe plus s'obtient grâce à
-@code{\+}, et une quinte ou septième diminuée par @code{5/} ou
-@code{7/} respectivement.
+Vous pouvez stipuler un intervalle augmenté ou diminué :
 
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <6\+ 5/> <7/>
+}
 @end lilypond
 
-Le caractère @code{_} insère un espace, et l'on peut imprimer des
-crochets avec @code{[} et @code{]}.  Vous pouvez aussi ajouter des
-chaînes de caractères ou des étiquettes --- cf. @ref{Text markup commands}.
+Vous pouvez barrer un chiffre d'une oblique inversée, typiquement pour
+une @qq{petite sixte} :
 
-@example
-<[4 6] 8 [_! 12] > <5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <6> <6\\>
+}
 @end lilypond
 
+Vous pouvez insérer un espace ou ajouter des crochets :
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <[12 _!] 8 [6  4]>
+}
+@end lilypond
+
+Vous pouvez aussi ajouter des chaînes de caractères ou des étiquettes --
+cf. @ref{Commandes pour markup}.
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+  <\markup { \tiny \number 6 \super (1) } 5>
+}
+@end lilypond
+
+@c NOTE: We need to include notes any time we use extenders to
+@c avoid extraneous staff creation due to Staff.use... in
+@c \bassFigureExtendersOn
+
 Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
 prolongation.
 
-@lilypond[verbatim,relative=1]
+@lilypond[verbatim,quote,ragged-right]
 <<
-  \new Staff {
+  {
     \clef bass
-    c4 c c
+    e4 d c b,
+    e4 d c b,
   }
   \figures {
-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
+    \bassFigureExtendersOn
+    <6 4>4 <6 3> <7 3> <7 3>
+    \bassFigureExtendersOff
+    <6 4>4 <6 3> <7 3> <7 3>
   }
 >>
 @end lilypond
 
 @noindent
 En pareil cas, la ligne de prolongation masquera toujours le chiffre
-qu'elle rappelle dans le chiffrage suivant.
+qu'elle rappelle dans le chiffrage suivant à moins d'avoir été
+explicitement interrompue.
 
-Le contexte @code{FiguredBass} ne tient aucun compte de la ligne de
-basse.  Par conséquent, il vous faudra peut être insérer des chiffrages
-supplémentaires pour imprimer les prolongations, ou utiliser des
-@code{\!} pour les éviter, comme dans l'exemple suivant@tie{}:
-
-@lilypond[relative=1]
+@lilypond[verbatim,quote,ragged-right]
 <<
-  \new Voice
   \figures {
-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+    \bassFigureExtendersOn
+    <6 4>4 <6 4> <6\! 4\!> <6 4>
   }
   {
     \clef bass
-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+    d4 d c c
   }
 >>
 @end lilypond
 
-Lorsque vous utilisez des lignes de prolongation, les chiffres communs
-seront verticalement alignés.  Pour l'éviter, insérez un silence avec
-@code{r} afin de réinitialiser l'alignement.  Par exemple, saisissez
-
-@example
-  <4 6>8 r8
-@end example
+Voici, de manière synthétique, les différents modificateurs
+disponibles :
+
+@multitable @columnfractions .1 .5 .4
+
+@item
+@b{Modificateur}
+@tab
+@b{Utilisation}
+@tab
+@b{Exemple}
+
+@item
++, -, !
+@tab
+Altérations
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <7! 6+ 4-> <5++> <3-->
+}
+@end lilypond
 
-@noindent
-au lieu de
-@example
-  <4 6>4
-@end example
+@item
+\+, /
+@tab
+Augmentation ou diminution d'un degré
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <6\+ 5/> <7/>
+}
+@end lilypond
 
-On peut choisir d'impriemr les altérations et signes plus aussi bien
-avant qu'après les chiffres, en réglant les propriétés
-@code{figuredBassAlterationDirection} et
-@code{figuredBassPlusDirection}.
+@item
+\\
+@tab
+Petite sixte
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+  <6\\>
+}
+@end lilypond
 
-@lilypond
+@item
+\!
+@tab
+Terminaison d'une prolongation
+@tab
+@lilypond[line-width=4\cm]
+<<
   \figures {
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
+    \bassFigureExtendersOn
+    <6 4> <6 4> <6\! 4\!> <6 4>
+  }
+  {
+    \clef bass
+    d d c c
   }
+>>
 @end lilypond
 
-Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
-des accords, elle est beaucoup plus simpliste.  Le mode
-@code{\figuremode} ne fait que stocker des chiffres que le contexte
-@rinternals{FiguredBass} se chargera d'imprimer tels quels.  En
-aucune manière ils ne sont transformés en son, et ils ne sont pas
-rendus dans un fichier MIDI.
+@end multitable
 
-En interne, ce code produit des étiquettes de texte que vous
-pouvez formater à votre convenance grâce aux propriétés des
-étiquettes.  Par exemple, l'espacement vertical des chiffrages est
-déterminé par la propriété @code{baseline-skip}.
+@predefined
+@cindex basse chiffrée, lignes d'extension
+@code{\bassFigureExtendersOn},
+@code{\bassFigureExtendersOff}.
+@endpredefined
 
-On peut également ajouter une basse chiffrée directement à un contexte
-@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-the-positions-of-figured-bass-alterations.ly}
 
-@lilypond[ragged-right,quote]
-<<
-  \new Staff = someUniqueName
-  \relative c'' {
-    c4 c'8 r8 c,4 c'
-  }
+@seealso
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
 
-  %% send to existing Staff.
-  \context Staff = someUniqueName
-  \figuremode {
-    <4>4 <6 10>8 s8
+Référence des propriétés internes :
+@rinternals{BassFigure},
+@rinternals{BassFigureAlignment},
+@rinternals{BassFigureLine},
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},
+@rinternals{FiguredBass}.
+
+
+@node Gravure de la basse chiffrée
+@unnumberedsubsubsec Gravure de la basse chiffrée
+@translationof Displaying figured bass
+
+Une ligne de basse chiffrée s'imprime soit dans un contexte
+@code{FiguredBass}, soit dans la plupart des autres contextes du niveau
+de la portée.
 
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
+Le contexte @code{FiguredBass} ne tient aucun compte des notes qui
+apparaissent sur la portée.
+
+@lilypond[verbatim,ragged-right,quote]
+<<
+  \relative {
+    c''4 c'8 r8 c,4 c'
+  }
+  \new FiguredBass {
+    \figuremode {
+      <4>4 <10 6>8 s8
+      <6 4>4 <6 4>
+    }
   }
 >>
 @end lilypond
 
-@commonprop
+@noindent
+Il est impératif, dans cet exemple, d'instancier explicitement le
+contexte @code{FiguredBass} pour éviter l'apparition d'une portée
+supplémentaire vide.
 
-Par défaut, les chiffres sont imprimés au-dessus de la portée.  Pour les
-imprimer dessous, ajoutez
+On peut ajouter une basse chiffrée directement à un contexte
+@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.
 
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
+@lilypond[verbatim,ragged-right,quote]
+<<
+  \new Staff = "myStaff"
+  \figuremode {
+    <4>4 <10 6>8 s8
+    <6 4>4 <6 4>
+  }
+  %% Put notes on same Staff as figures
+  \context Staff = "myStaff"
+  {
+    \clef bass
+    c4 c'8 r8 c4 c'
+  }
+>>
+@end lilypond
 
-@knownissues
+La basse chiffrée attachée à un contexte @code{Staff} peut se
+positionner au-dessus ou en dessous de la portée.
 
-Si vous positionnez la basse chiffrée au dessus de la portée en ayant
-recours aux lignes d'extension et @code{implicitBassFigures}, les lignes
-peuvent se mélanger.  Préserver l'ordre des prolongateurs peut s'avérer
-impossible lorsque plusieurs chiffrages qui se chevauchent en possèdent.
-Ce problème peut être contourné en jouant sur l'empilement, avec la
-propriété @code{stacking-dir} de l'objet @code{BassFigureAlignment}.
+@lilypond[verbatim,ragged-right,quote]
+<<
+  \new Staff = "myStaff"
+  \figuremode {
+    <4>4 <10 6>8 s8
+    \bassFigureStaffAlignmentDown
+    <6 4>4 <6 4>
+  }
+  %% Put notes on same Staff as figures
+  \context Staff = "myStaff"
+  {
+    \clef bass
+    c4 c'8 r8 c4 c'
+  }
+>>
+@end lilypond
 
+@predefined
+@cindex basse chiffrée, alignement
+@code{\bassFigureStaffAlignmentDown},
+@code{\bassFigureStaffAlignmentUp},
+@code{\bassFigureStaffAlignmentNeutral}.
+@endpredefined
 
 @seealso
-Référence des pripriétés internes : les objets
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :
 @rinternals{BassFigure},
 @rinternals{BassFigureAlignment},
 @rinternals{BassFigureLine},
-@rinternals{BassFigureBracket} et
-@rinternals{BassFigureContinuation}, ainsi que le contexte
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},
 @rinternals{FiguredBass}.
 
+@knownissues
+Les lignes de prolongation seront correctes dès lors que notes et
+chiffrages adoptent des durées identiques.
 
-@node Saisie de la basse chiffrée
-@unnumberedsubsubsec Saisie de la basse chiffrée
-@translationof Entering figured bass
-
-@untranslated
-
-@node Gravure de la basse chiffrée
-@unnumberedsubsubsec Gravure de la basse chiffrée
-@translationof Displaying figured bass
-
-@untranslated
+@lilypond[verbatim,ragged-right,quote]
+<<
+  {
+    \clef bass
+    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+  }
+  \figures {
+    \bassFigureExtendersOn
+    % The extenders are correct here, with the same rhythm as the bass
+    \repeat unfold 4 { <6 4->16. <6 4->32 }
+    <5>8. r16 <6>8 <6\! 5->
+  }
+>>
+<<
+  {
+    \clef bass
+    \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+  }
+  \figures {
+    \bassFigureExtendersOn
+    % The extenders are incorrect here, even though the timing is the same
+    <6 4->4 <6 4->4
+    <5>8. r16 <6>8 <6\! 5->
+  }
+>>
+@end lilypond