]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/fretted-strings.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / fr / user / fretted-strings.itely
index ec1247bcb28dcee293d26ceb9cf667e27b86e2f5..efd072c0a6bf561020201d9b41fbe15bbc036bd7 100644 (file)
@@ -1,21 +1,30 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: bdf8540b74167817eab96ed3d13b35477217f9fe
+    Translation of GIT committish: 3f880f886831b8c72c9e944b3872458c30c6c839
 
     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.51"
+@c \version "2.12.0"
 
-@c Translators: Valentin Villenave
-@c Translation checkers: Jean-Charles Malahieude, John Mandereau
+@c Translators: Matthieu Jacquot
+@c Translation checkers: Jean-Charles Malahieude
 
 @node Fretted string instruments
 @section Fretted string instruments
 
-@untranslated
+@lilypondfile[quote]{fretted-headword.ly}
+
+Cette section traite de différents aspects de la notation propre aux
+instruments à cordes frettées. 
+
+@cindex tablature
+@cindex guitare, tablature pour 
+@cindex banjo, tablature pour 
+@cindex tablature pour guitare
+@cindex tablature pour banjo
 
 @menu
 * Common notation for fretted strings::
 @node Common notation for fretted strings
 @subsection Common notation for fretted strings
 
-@untranslated
+Vue d'ensemble de la notation pour les instruments à cordes frettées.
 
 @menu
 * References for fretted strings::
 * String number indications::
 * Default tablatures::
 * Custom tablatures::
-* Fret diagrams::
-* Right hand fingerings::
+* Fret diagram markups::
+* Predefined fret diagrams::
+* Automatic fret diagrams::
+* Right-hand fingerings::
 @end menu
 
 @node References for fretted strings
-@subsubsection References for fretted strings
+@unnumberedsubsubsec References for fretted strings
+
+La musique pour instruments à cordes frettées est généralement notée sur
+une seule portée, en notation traditionnelle ou en tablature, les deux
+étant parfois combinées.  Il est aussi courant en musique populaire
+d'utiliser des diagrammes d'accord au-dessus de la portée
+traditionnelle.  La guitare et le banjo sont des instruments
+transpositeurs, sonnant une octave au-dessous de ce qui est écrit.  Les
+partitions pour ces instruments utilisent donc la clé de sol ottava
+bassa @code{"treble_8"}.  Vous pourrez trouver ailleurs dans la
+documentation d'autres éléments aussi utilisés par les instruments à
+cordes frettées :
+
+@itemize
+@item Les doigtés s'obtiennent comme indiqué au chapitre 
+@ref{Fingering instructions}. 
+
+@item En plus des @notation{Laissez vibrer}, les liaisons peuvent
+intervenir sur des accords arpégés ou des trémolos.  Reportez-vous au
+chapitre @ref{Ties}. 
+
+@item Des indications quant au support polyphonique se trouvent au
+chapitre @ref{Collision resolution}.
+
+@item La notation des sons harmoniques se trouve à la section @ref{Harmonics}.
+
+@end itemize
+
+
+@seealso
+Manuel de notation :
+@ref{Fingering instructions},
+@ref{Ties},
+@ref{Collision resolution},
+@ref{Instrument names},
+@ref{Writing music in parallel},
+@ref{Arpeggio},
+@ref{List of articulations},
+@ref{Clef}.
 
-@untranslated
 
 @node String number indications
-@subsubsection String number indications
+@unnumberedsubsubsec String number indications
 
 @cindex cordes numérotées
 @cindex numéro de corde
+@cindex numéros de corde et doigtés
+@cindex doigtés et numéros de corde
 
-On peut ajouter aux accords les numéros de cordes, en les indiquant avec
-@code{\}@var{number} :
+Une corde sur laquelle une note doit être jouée peut être indiquée 
+en attachant @code{\@var{numéro}} à cette note prise dans une
+construction de type accord @code{<>}. 
 
-@lilypond[relative,relative=1,ragged-right,fragment]
-<c\1 e\2 g\3>
+@warning{Les numéros de cordes @strong{doivent} être définis dans une
+construction de type accord même s'il n'y a qu'une seule note.}
+
+@lilypond[verbatim,quote,relative=0]
+\clef "treble_8"
+<c\5>4 <e\4> <g\3>2
+<c,\5 e\4 g\3>1
+@end lilypond
+
+Quand les indications de doigté et de numéro de corde sont 
+attachées à une même note, leur positionnement se fera en fonction 
+de l'ordre dans lequel ils apparaissent dans le code :
+
+
+@lilypond[verbatim,quote,relative=1]
+\clef "treble_8"
+<g\3-0>2
+<g-0\3>
 @end lilypond
 
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{controlling-the-placement-of-chord-fingerings.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
+
+
 @seealso
+Manuel de notation :
+@ref{Fingering instructions}.
+
+Morceaux choisis :
+@rlsr{Fretted strings}.
 
-Référence du programme : @rinternals{StringNumber}.
+Référence des propriétés internes :
+@rinternals{StringNumber},
+@rinternals{Fingering}.
 
-Exemples : @rlsr{Fretted strings}.
 
 @node Default tablatures
-@subsubsection Default tablatures
+@unnumberedsubsubsec Default tablatures
 
-@cindex tablatures de base
+@cindex tablatures, bases
+@cindex tablatures par défaut
+
+@funindex TabStaff
+@funindex TabVoice
 
 La notation en tablature est utilisée pour certains instruments à cordes
-pincées.  Les hauteurs n'y sont pas indisuées par des têtes de note,
+pincées.  Les hauteurs n'y sont pas indiquées par des têtes de note,
 mais par des chiffres qui indiquent sur quelle corde, et à quelle case
 chaque note doit être jouée.  Dans certaines limites, LilyPond vous
 permet d'écrire des tablatures.
 
 Chaque numéro de corde associé à une note doit être précédé d'une barre
-oblique inverse (ou @qq{antislash}). Ainsi, @code{c4\3} donnera un do
-noire à jouer sur la troisième corde.  Par défaut, la première corde est
-la plus aigüe, et les cordes suivent l'accord traditionnel d'une guitare
-à six cordes.  Les notes sont imprimées sous forme de tablature, dans
-les contextes @rinternals{TabStaff} et @rinternals{TabVoice}.
+oblique inverse (ou @qq{antislash}) suivi d'un nombre.  Par défaut, la
+première corde est 
+la plus aiguë, et les cordes suivent l'accordage traditionnel d'une
+guitare (à six cordes).  Les notes sont imprimées sous forme de
+tablature, dans les contextes @rinternals{TabStaff} et
+@rinternals{TabVoice}. 
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 \new TabStaff {
@@ -87,51 +174,75 @@ les contextes @rinternals{TabStaff} et @rinternals{TabVoice}.
 @end lilypond
 
 @funindex minimumFret
+
 @cindex cases
 
 Quand aucune corde n'est précisée, LilyPond choisit automatiquement la
-corde où la position est la moins élevée et qui donne un numéro de case
-supérieur à la valeur de la propriété @code{minimumFret}.  On peut
-régler cette propriété, selon qu'on désire une position plus ou moins
-haute.  La valeur par défaut de cette propriété est fixée à 0, ce qui
-correspond à la position la plus basse.
+corde pour laquelle la position est la moins élevée et qui donne un
+numéro de case supérieur ou égal à la valeur de la propriété
+@code{minimumFret}.  La valeur par défaut de cette propriété est fixée à
+0, ce qui correspond aux cordes à vide.
 
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
-  \key e \major
-  e16 fis gis a b4
-  \set TabStaff.minimumFret = #8
-  e16 fis gis a b4
+
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup <<
+   \new Staff \relative c {
+     \clef "treble_8"
+     c16 d e f g4
+     c,16 d e f g4
+   }
+   \new TabStaff \relative c {
+     c16 d e f g4
+     \set TabStaff.minimumFret = #5
+     c,16 d e f g4
+   }
+>>
+@end lilypond
+
+@cindex harmoniques, indication en tablature
+@cindex tablature et indication d'harmoniques
+@cindex glissando, indication en tablature
+@cindex tablature et glissando
+
+Les indications de sons harmoniques ainsi que les glissandi
+peuvent être ajoutés aux tablatures.
+
+
+@lilypond[fragment, verbatim, quote, relative=1]
+\new TabStaff {
+  \new TabVoice {
+    <c g'\harmonic> d\2\glissando e\2
+  }
 }
-  \new StaffGroup <<
-    \new Staff { \clef "G_8" \frag }
-    \new TabStaff { \frag }
-  >>
 @end lilypond
 
-@commonprop
 
-Pour obtenir des tablatures où les hampes seront dirigées vers le bas et
-les ligatures horizontales, réglez le contexte @code{TabStaff}
-comme suit :
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{stem-and-beam-behavior-in-tablature.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{polyphony-in-tablature.ly}
 
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
 
 @seealso
+Manuel de notation :
+@ref{Stems}.
+
+Morceaux choisis :
+@rlsr{Fretted strings}.
+
+Référence des propriétés internes :
+@rinternals{TabNoteHead},
+@rinternals{TabStaff},
+@rinternals{TabVoice},
+@rinternals{Beam}.
 
-Référence du programme : @rinternals{TabStaff}, @rinternals{TabVoice}.
 
 @knownissues
 
-Les accords ne subsissent ausun traitement particulier ; de ce fait, la
+Les accords ne subissent aucun traitement particulier ; de ce fait, la
 sélection automatique des cordes peut attribuer une même corde pour deux
 notes différentes de l'accord.
 
@@ -151,179 +262,936 @@ melodia = \partcombine { e4 g g g }{ e4 e e e }
 >>
 @end lilypond
 
+Le support des modes de jeu propres à la guitare se limite aux sons 
+harmoniques et aux glissandi.
+
 @node Custom tablatures
-@subsubsection Custom tablatures
+@unnumberedsubsubsec Custom tablatures
 
-@cindex tablatures, autres
+@cindex tablatures personnalisées
+@cindex banjo, tablature
+@cindex mandoline, tablature
+@cindex guitare basse, tablature
+@cindex tablature, accordages prédéfinis
+@cindex cordes frettés et accordages prédéfinis
+@cindex accordages prédéfinis et cordes frettées
 
-Vous pouvez bien sûr accorder vos cordes différemment.  Cet accord est
-enregistré dans la propriété @code{stringTunings}.  La valeur de cette
-propriété doit être indiquée sous forme d'une liste en langage Scheme,
-où chaque corde est représentée par un nombre entier qui indique sa
-hauteur à vide, comptée en demi-tons à partir du do central.  Cette
-propriété permet aussi à LilyPond de déterminer le nombre de cordes.
+@funindex StringTunings
 
-Dans l'exemple suivant, on a réglé @code{stringTunings} pour l'accord de
-la guitare basse, c'est-à-dire mi la ré sol.
+Sous LilyPond, la case correspondant à une note jouée sur une corde donnée 
+est calculée automatiquement.  Pour ce faire, l'accordage doit 
+être spécifié.  L'accordage des cordes est donné par la propriété
+@code{StringTunings}.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
+LilyPond possède des accordages prédéfinis pour banjo, mandoline, guitare 
+et guitare basse.  Lilypond calcule automatiquement la transposition
+correspondant à ces accordages.  L'exemple ci-dessous est pour guitare
+basse, il sonnera donc une octave en dessous de ce qui est écrit.
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+  \new Staff {
+    \clef "bass_8"
+    \relative c, {
+      c4 d e f
+    }
+  }
+  \new TabStaff {
+    \set TabStaff.stringTunings = #bass-tuning
+    \relative c, {
+      c4 d e f
+    }
   }
 >>
 @end lilypond
 
-Toutefois, LilyPond possède des jeux de cordes prédéfinis pour le banjo,
-la mandoline, la guitare et la guitare basse ; ainsi, l'accord précédent
-peut également s'indiquer par
+L'accordage par défaut est @code{guitar-tuning} ; il correspond à
+l'accordage standard d'une guitare : mi la ré sol si mi (EADGBE).
+D'autres accordages prédéfinis sont disponibles :
+@code{guitar-open-g-tuning}, @code{mandolin-tuning} et
+@code{banjo-open-g-tuning}.  Les accordages prédéfinis sont répertoriés 
+dans le fichier @code{scm/output-lib.scm}.
+
+L'accordage est constitué par une liste Scheme des hauteurs de notes
+correspondant aux cordes à vide, une note pour chaque corde, classée par
+numéro de corde de 1 à n, où la corde 1 est la plus haute dans la
+tablature et n la plus basse.  Cela revient généralement à classer les
+cordes de la plus aiguë à la plus grave, mais certains instruments
+(comme le ukulele) n'ont pas les cordes classées par hauteur. 
+
+Dans cette liste, la hauteur des notes est représentée par l'intervalle,
+exprimé en demi-tons,  du do central jusqu'à la note de la corde à vide.
+Elle doit donc être représentée par un nombre entier.  LilyPond calcule
+la note correspondant  à chaque corde en ajoutant cet intervalle au do
+central. 
+
+Lilypond calcule automatiquement le nombre de cordes à représenter dans
+la tablature (@code{TabStaff}) en comptant le nombre d'éléments définis
+dans le @code{stringTunings}.
+
+N'importe quel accordage peut donc être créé.  Par exemple, nous pouvons
+définir l'accordage d'un instrument à quatre cordes accordées do sol ré
+la, donc de la plus aiguë à la plus grave et en anglais :  
+@code{a''},  @code{d''},  @code{g'}, et @code{c'} : 
+
+
+@lilypond[quote,verbatim]
+mynotes = {
+    c'4 e' g' c'' |
+    e'' g'' b'' c'''
+}
 
-@example
-\set TabStaff.stringTunings = #bass-tuning
-@end example
+<<
+  \new Staff {
+    \clef treble
+    \mynotes
+  }
+  \new TabStaff {
+    \set TabStaff.stringTunings = #'(21 14 7 0)
+    \mynotes
+  }
+>>
+@end lilypond
 
-Le jeu par défaut est celui de la guitare : @code{guitar-tuning},
-c'est-à-dire le célèbre mi la ré sol si mi. D'autres jeux prédéfinis
-sont @code{guitar-open-g-tuning}, @code{mandolin-tuning} et
-@code{banjo-open-g-tuning}.
 
 @seealso
+Fichiers sources installés :
+@file{scm/output-lib.scm}.
 
-Vous trouverez une liste complète des jeux prédéfinis dans le fichier
-@file{scm/@/output@/-lib@/.scm}.
+Morceaux choisis :
+@rlsr{Fretted strings}.
 
-Référence du programme : @rinternals{Tab_note_heads_engraver}.
+Référence des propriétés internes :
+@rinternals{Tab_note_heads_engraver}.
 
-@knownissues
+@node Fret diagram markups
+@unnumberedsubsubsec Fret diagram markups
 
-Aucun effet spécial de guitare n'a été implémenté à ce jour.
+@cindex fret, diagrammes
+@cindex accord, diagrammes
+@cindex diagrammes de fret
+@cindex diagrammes d'accord pour instrument fretté
+@cindex fret, diagrammes personnalisés
+@cindex diagrammes personnalisés de fret
 
-@node Fret diagrams
-@subsubsection Fret diagrams
+On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
+note, en tant qu'objets @code{\markup}.  Ces objets contiennent toutes
+les informations du diagramme d'accord.  Il y a pour les définir trois
+interfaces "diagramme d'accord" (@emph{fret-diagram} en anglais) :
+@var{standard}, @var{terse} et @var{verbose}.
+Ces trois interfaces produiront des diagrammes similaires mais
+permettent des niveaux de personnalisation différents.  Des détails à
+propos des interfaces de type @code{\markup} 
+peuvent être trouvés dans @ref{Text markup commands}.
+
+Dans l'interface standard des diagrammes d'accords, on indiquera le
+numéro de corde et le numéro de case pour chaque point placé sur une corde.
+Les cordes à vide et étouffées peuvent aussi être indiquées.
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"
+    < d a d' f'> ^\markup
+      \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;"
+  }
+>>
+@end lilypond
 
-@cindex schémas d'accords
-@cindex schémas de barrés
+@cindex barré, indication de
+@cindex indication du barré
 
-On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
-note, en tant qu'objets @code{\markup}. Ces objets donnent toutes
-les informations sur le doigté et les éventuels barrés :
+Les indications de barrés peuvent aussi être ajoutées au diagramme
+d'accord dans l'interface standard :
 
-@lilypond[verbatim, ragged-right, quote]
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       f1 g
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < f, c f a c' f'>1 ^\markup
+      \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
+    < g, d g b d' g'> ^\markup
+      \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;"
+  }
+>>
+@end lilypond
+
+@cindex fret-diagram et markup
+@cindex markup et fret-diagram
+
+@funindex fret-diagram
+@funindex \fret-diagram
+
+La taille du diagramme d'accord ainsi que le nombre de cases
+représentées peuvent aussi être modifiés dans l'interface standard.
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       f1 g
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < f, c f a c' f'>1 ^\markup
+      \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
+    < g, b, d g b g'> ^\markup
+      \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;"
+  }
+>>
+@end lilypond
+
+Le nombre de cordes dans les diagrammes d'accord peut être modifié dans
+l'interface standard pour s'adapter à différents instruments tels que le
+banjo et le ukulele. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       a1
+     }
+  }
+  \context Staff {
+        %% A chord for ukelele
+    a'1 ^\markup \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
+  }
+>>
+@end lilypond
+
+Des indications de doigtés peuvent être ajoutées, et le positionnement
+de ces doigtés peut être modifié dans l'interface standard.
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"
+    < d a d' f'> ^\markup
+      \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;"
+  }
+>>
+@end lilypond
+
+La taille ainsi que la position des points peuvent être contrôlées dans
+l'interface standard. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"
+    < d a d' f'> ^\markup
+      \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;"
+  }
+>>
+@end lilypond
+
+@cindex fret-diagram-terse markup
+
+@funindex fret-diagram-terse
+@funindex \fret-diagram-terse
+
+Dans l'interface @code{fret-diagram-terse}, les numéros de cordes sont
+omis ; les numéros de cordes sont induits par la présence de
+points-virgules.  Il y a un point-virgule pour chaque corde du
+diagramme.  Le premier point-virgule correspondant au plus haut numéro
+de corde, le dernier à la première corde.  Les cordes étouffées, les
+cordes à vide ainsi que les numéros de case peuvent y être indiqués. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram-terse #"x;3;2;o;1;o;"
+    < d a d' f'> ^\markup
+      \fret-diagram-terse #"x;x;o;2;3;1;"
+  }
+>>
+@end lilypond
+
+Les indications de barré peuvent être inclus dans l'interface
+@code{fret-diagram-terse}. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       f1 g
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < f, c f a c' f'>1 ^\markup
+      \fret-diagram-terse #"1-(;3;3;2;1;1-);"
+    < g, d g b d' g'> ^\markup
+      \fret-diagram-terse #"3-(;5;5;4;3;3-);"
+  }
+>>
+@end lilypond
+
+Les indications de doigtés peuvent être inclus dans l'interface
+@code{fret-diagram-terse}. 
+
+@c Need to use override to enable fingerings to show this -- can we do so?
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \override Voice.TextScript
+      #'(fret-diagram-details finger-code) = #'below-string
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"
+    < d a d' f'> ^\markup
+      \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;"
+  }
+>>
+@end lilypond
+
+Les autres propriétés des diagrammes d'accord doivent être ajustées en
+utilisant la commande @code{\override} dans l'interface
+@code{fret-diagram-terse}. 
+
+@cindex fret-diagram-verbose markup
+
+@funindex fret-diagram-verbose
+@funindex \fret-diagram-verbose
+
+L'interface @code{fret-diagram-verbose} est au format d'une liste
+Scheme.  Chaque élément de la liste décrit un objet devant être placé
+dans le diagramme d'accord. 
+
+@lilypond[quote, verbatim]
+<<  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1 ^\markup
+      \fret-diagram-verbose #'(
+        (mute 6)
+        (place-fret 5 3)
+        (place-fret 4 2)
+        (open 3)
+        (place-fret 2 1)
+        (open 1)
+      )
+    < d a d' f'> ^\markup
+      \fret-diagram-verbose #'(
+        (mute 6)
+        (mute 5)
+        (open 4)
+        (place-fret 3 2)
+        (place-fret 2 3)
+        (place-fret 1 1)
+      )
+  }
+>>
+@end lilypond
+
+Les indications de doigté et de barré peuvent être décrits dans
+l'interface @code{fret-diagram-verbose}.  Particularité propre à
+l'interface @code{fret-diagram-verbose} : l'indication
+de capodastre dans le diagramme d'accord.  L'indication de capodastre
+est une petite ligne transversale aux cordes.  La case avec le
+capodastre est la case la plus basse du diagramme d'accord. 
+
+@c \override is necessary to make fingering visible
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       f1 g c
+     }
+  }
+  \context Staff {
+    \clef "treble_8"
+    \override Voice.TextScript
+      #'(fret-diagram-details finger-code) = #'below-string
+
+    < f, c f a c' f'>1 ^\markup
+      \fret-diagram-verbose #'(
+        (place-fret 6 1)
+        (place-fret 5 3)
+        (place-fret 4 3)
+        (place-fret 3 2)
+        (place-fret 2 1)
+        (place-fret 1 1)
+        (barre 6 1 1)
+      )
+    < g, b, d g b g'> ^\markup
+      \fret-diagram-verbose #'(
+        (place-fret 6 3 2)
+        (place-fret 5 2 1)
+        (open 4)
+        (open 3)
+        (open 2)
+        (place-fret 1 3 3)
+      )
+    < c e g c' e'> ^\markup
+      \fret-diagram-verbose #'(
+        (capo 3)
+        (mute 6)
+        (place-fret 4 5 1)
+        (place-fret 3 5 2)
+        (place-fret 2 5 3)
+      )
+   }
+>>
+@end lilypond
+
+Toutes les autres propriétés du diagramme d'accord doivent être
+indiquées en utilisant la commande @code{\override} lorsque l'on utilise
+l'interface @code{fret-diagram-verbose}. 
+
+@ignore
+The following example shows the three fret-diagram markup
+interfaces, along with examples of common tweaks.  For example,
+the size of the verbose fret diagram is reduced to 0.75, and the
+finger indications are specified to appear below the diagram.  The
+terse diagram includes tweaks to specify placement of finger code
+and color of dots.
+
+@lilypond[verbatim,ragged-right,quote]
 \new Voice {
-  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
-  d' d' d'
-  fis'^\markup \override #'(size . 0.75) {
+  \clef "treble_8"
+  d^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d d d
+  fis^\markup \override #'(size . 0.75) {
     \override #'(finger-code . below-string) {
       \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
-                               (place-fret 5 4 3) (place-fret 4 4 4)
-                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 5 4 3)
+                               (place-fret 4 4 4)
+                               (place-fret 3 3 2)
+                               (place-fret 2 2 1)
                                (place-fret 1 2 1))
     }
   }
-  fis' fis' fis'
-  c'^\markup \override #'(dot-radius . 0.35) {
+  fis fis fis
+  c^\markup \override #'(dot-radius . 0.35) {
     \override #'(finger-code . in-dot) {
       \override #'(dot-color . white) {
         \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
       }
     }
   }
-  c' c' c'
+  c c c
 }
 @end lilypond
+@end ignore
 
-Vous pouvez indiquer vos diagrammes de trois manières différentes :
-@qq{standard}, @qq{terse} ou @qq{verbeux}. Ces trois interfaces
-produisent des schémas similaires, mais demandent d'entrer plus ou moins
-d'informations.  Vous trouverez tout les détails dans
+@cindex diagrammes de fret personnalisés
+@cindex fret, diagrammes personnalisés
+@cindex diagrammes personnalisés de fret
+
+@funindex fret-diagram-interface
+
+La disposition graphique d'un diagramme d'accord peut être modifiée
+suivant les préférences de l'utilisateur grâce aux propriétés de
+l'interface @code{fret-diagram-interface}.  
+Des détails se trouvent dans @rinternals{fret-diagram-interface}.  Pour
+un diagramme d'accord, les propriétés de l'interface dépendent de
+@code{Voice.TextScript}. 
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{customizing-markup-fret-diagrams.ly}
+
+
+@seealso
+Manuel de notation :
 @ref{Text markup commands}.
 
-Par ailleurs, plusieurs propriétés permettent d'ajuster le graphisme
-à votre convenance. Vous en trouverez les détails dans
+Morceaux choisis :
+@rlsr{Fretted strings}.
+
+Référence des propriétés internes :
 @rinternals{fret-diagram-interface}.
 
-@seealso
 
-Exemples : @rlsr{Fretted strings}.
+@node Predefined fret diagrams
+@unnumberedsubsubsec Predefined fret diagrams
+
 
-@node Right hand fingerings
-@subsubsection Right hand fingerings
+@cindex fret, diagrammes
+@cindex accord, diagrammes
 
-Les doigtés de la main droite, dans les accords, peuvent être ajoutés au moyen
-de @code{@var{note}-\rightHandFinger @var{doigté}}
+@funindex FretBoards
+@funindex stringTunings
 
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+Les diagrammes d'accords peuvent être affichés en utilisant le contexte
+@code{FretBoards}.  Par défaut le contexte @code{FretBoards} affichera
+des diagrammes d'accords stockés dans une table de correspondance : 
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+\context FretBoards {
+  \chordmode {
+    c1 d
+  }
+}
 @end lilypond
 
-Pour plus de clarté, vous pouvez traduire ou abréger la commande
-@code{\rightHandFinger}, par exemple en @code{\doigtMainDroite} ou
-même @code{\MD} :
+Les diagrammes d'accord définis par défaut sont dans le fichier
+@code{predefined-guitar-fretboards.ly}.  Les diagrammes d'accords sont
+stockés en fonction des notes de l'accord ainsi que de l'accordage
+(@code{stringTunings}) utilisé.
+@code{predefined-guitar-fretboards.ly} contient les diagrammes d'accords
+prédéfinis uniquement pour l'accordage standard (@code{guitar-tuning}).
+Des diagrammes d'accords peuvent être définis pour d'autres instruments
+ou d'autres accordages en suivant les exemples du fichier 
+@code{predefined-guitar-fretboards.ly}.
+
+Les notes des accords peuvent être entrées aussi bien comme musique
+simultanée qu'en utilisant le mode accord (voir 
+@ref{Chord mode overview}).
+
+@lilypond[verbatim, ragged-right,quote]
+\include "predefined-guitar-fretboards.ly"
+\context FretBoards {
+  \chordmode {c1}
+  <c' e' g'>1
+}
+@end lilypond
 
-@example
-#(define MD rightHandFinger)
-@end example
+@cindex accord nommés et diagrammes de fret
+@cindex fret, diagrammes avec noms d'accord
+
+@funindex ChordNames
+@funindex chordmode
+@funindex \chordmode
 
-@cindex doigtés, main droite, guitare
-@cindex mains droite, doigtés guitare
+Il est courant d'afficher simultanément le nom des accords et les
+diagrammes d'accords correspondants. 
+Ceci s'obtient en mettant en parallèle un contexte @code{ChordNames} avec
+un contexte @code{FretBoards} et en affectant aux deux la même musique.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+  c1 f g
+}
 
-@commonprop
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
+@end lilypond
+
+@cindex transposition et diagramme de fret
+@cindex fret et transposition
+@cindex diagrammes de fret et transposition
+
+Les diagrammes d'accords prédéfinis sont transposables tant qu'il y a 
+un diagramme correspondant à l'accord transposé dans la base des
+diagrammes d'accords. 
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+  c1 f g
+}
+
+mychordlist = {
+  \mychords
+  \transpose c e { \mychords}
+}
+<<
+  \context ChordNames {
+    \mychordlist
+  }
+  \context FretBoards {
+    \mychordlist
+  }
+>>
+@end lilypond
 
-Pour contrôler plus précisément les doigtés de main droite, réglez la
-propriété @code{strokeFingerOrientations} :
+La table des diagrammes d'accord contient sept types d'accord (majeur,
+mineur, augmenté, diminué, septième de dominante, majeur sept, mineur
+sept) pour chacune des 17 fondamentales possibles.  Une liste complète
+des diagrammes d'accords prédéfinis se trouve dans @ref{Predefined 
+fretboard diagrams}.   S'il n'y a pas d'entrée dans la table pour un
+accord donné, le graveur @code{Fretboard_engraver} calculera le
+diagramme d'accord en utilisant la fonctionnalité automatique  décrite
+dans @ref{Automatic fret diagrams}.  
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+  c1 c:9
 }
+
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
 @end lilypond
 
-Les lettres utilisées dans ces doigtés sont définies par la propriété
-@code{digit-names}, mais on peut bien sûr les changer en utilisant une
-chaîne de caractères comme argument de @code{\rightHandFinger}.
+@cindex fret, ajout de diagrammes personnalisés
+@cindex diagrammes de fret personnalisés, ajout
+
+Des diagrammes d'accord peuvent être ajoutés à la table des diagrammes
+d'accord.  Pour ajouter un diagramme d'accord, il faut spécifier
+l'accord correspondant au diagramme, l'accord utilisé et la définition
+du diagramme.  Cette définition de diagramme peut être 
+aussi bien de type @var{terse} que @var{verbose}.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = #'#("x" "y" "z" "!" "@")
-  <c-\RH #5 >4
-  <c-\RH "@">4
+\storePredefinedDiagram \chordmode {c:9}
+                        #guitar-tuning
+                        #"x;3-2;2-1;3-3;3-4;x;"
+
+mychords = \chordmode{
+  c1 c:9
 }
+
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
 @end lilypond
 
+On peut enregistrer différents diagrammes pour un même accord  
+en les définissant à des octaves différentes.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+
+\storePredefinedDiagram \chordmode {c'}
+                        #guitar-tuning
+                        #(offset-fret 2 (chord-shape 'bes guitar-tuning))
+
+mychords = \chordmode{
+  c1 c'
+}
+
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
+@end lilypond
+
+@cindex cordes frettées, carrures d'accord
+@cindex accord, carrures pour cordes frettées
+
+@funindex \addChordShape
+@funindex add ChordShape
+@funindex storePredefinedDiagram
+@funindex \storePredefinedDiagram
+
+En plus des  diagrammes d'accord, LilyPond possède une liste interne de 
+carrures d'accord. 
+Les carrures d'accords sont des diagrammes d'accord qui peuvent être
+transposés le long du manche.  Les carrures d'accords peuvent être
+ajoutées à la liste interne et être ensuite utilisées pour définir des
+accords prédéfinis.  Puisqu'elles sont transposables le long du
+manche, les carrures d'accord ne contiennent généralement pas de corde
+à vide.  Tout comme les diagrammes d'accord, les carrures d'accord sont
+définies grâce aux interfaces @code{fret-diagram-terse} ou
+@code{fret-diagram-verbose}. 
+
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+
+% add a new chord shape
+
+\addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;"
+
+% add some new chords based on the power chord shape
+
+\storePredefinedDiagram \chordmode {f'}
+                        #guitar-tuning
+                        #(chord-shape 'powerf guitar-tuning) 
+\storePredefinedDiagram \chordmode {g'}
+                        #guitar-tuning
+                        #(offset-fret 2 (chord-shape 'powerf guitar-tuning))
+
+mychords = \chordmode{
+  f1 f' g g'
+}
+
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
+@end lilypond
+
+La disposition graphique d'un diagramme d'accord peut être modifiée
+suivant les préférences de l'utilisateur grâce aux propriétés de
+l'interface @code{fret-diagram-interface}. Pour plus d'information,
+consultez @rinternals{fret-diagram-interface}.  Pour un diagramme
+d'accord donné, les propriétés de l'interface dépendent de 
+@code{FretBoards.FretBoard}. 
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{customizing-fretboard-fret-diagrams.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{defining-predefined-fretboards-for-other-instruments.ly}
+
+
 @seealso
+Manuel de notation :
+@ref{Custom tablatures},
+@ref{Automatic fret diagrams},
+@ref{Chord mode overview},
+@ref{Predefined fretboard diagrams}.
 
-Référence du programme : @rinternals{StrokeFinger}
+Fichiers sources installés :
+@file{ly/predefined-guitar-fretboards.ly},
+@file{ly/predefined-guitar-ninth-fretboards.ly}.
 
-@node Guitar
-@subsection Guitar
+Morceaux choisis :
+@rlsr{Fretted strings}.
 
-@untranslated
+Référence des propriétés internes :
+@rinternals {fret-diagram-interface}.
 
-@menu
-* Guitar tablatures::
-* Indicating position and barring::
-@end menu
 
-@node Guitar tablatures
-@subsubsection Guitar tablatures
+@node Automatic fret diagrams
+@unnumberedsubsubsec Automatic fret diagrams
 
-@untranslated
+@cindex fret, diagrammes automatiques
+@cindex accord, diagrammes automatiques
+@cindex automatique, diagramme de fret
+@cindex automatique, diagramme d'accord
 
-@node Indicating position and barring
-@subsubsection Indicating position and barring
+Les diagrammes d'accord peuvent être créés automatiquement ; il suffit
+d'affecter les notes à un contexte @code{FretBoards}.  Si aucun
+diagramme prédéfini n'est disponible pour les notes entrées avec
+l'accordage actuel (@code{stringTunings}), les cordes et cases
+correspondant aux notes seront automatiquement calculées. 
 
-Les doigtés de la main droite, dans les accords, peuvent être ajoutés au moyen
-de @code{@var{note}-\rightHandFinger @var{doigté}}
+@lilypond[quote,ragged-right,verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       f1 g
+     }
+  }
+  \context FretBoards {
+    < f, c f a c' f'>1
+    < g,\6 b, d g b g'>
+  }
+  \context Staff {
+    \clef "treble_8"
+    < f, c f a c' f'>1
+    < g, b, d g b' g'>
+  }
+>>
+@end lilypond
+
+@funindex predefinedFretboardsOff
+@funindex \predefinedFretboardsOff
+@funindex predefinedFretboardsOn
+@funindex \predefinedFretboardsOn
+
+Dans la mesure où aucun diagramme prédéfini n'est chargé par défaut, le
+calcul automatique des diagrammes d'accord est le comportement par
+défaut. Dès que les diagrammes par défaut sont chargés, le calcul
+automatique peut être activé ou désactivé par des commandes 
+prédéfinies : 
+
+@lilypond[quote,ragged-right,verbatim]
+
+\storePredefinedDiagram <c e g c' e'>
+                        #guitar-tuning
+                        #"x;3-1-(;5-2;5-3;5-4;3-1-1);"
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 c c
+     }
+  }
+  \context FretBoards {
+    <c e g c' e'>1
+    \predefinedFretboardsOff
+    <c e g c' e'>
+    \predefinedFretboardsOn
+    <c e g c' e'>
+  }
+  \context Staff {
+    \clef "treble_8"
+    <c e g c' e'>1
+    <c e g c' e'>
+    <c e g c' e'>
+  }
+>>
+@end lilypond
+
+Parfois le calculateur se trouvera incapable de trouver un diagramme
+d'accord convenable.  On peut souvent y remédier en assignant les notes
+aux cordes.  Dans bien des cas, il suffit de placer manuellement une
+seule note pour que les autres soient alors placées de maniére
+appropriée par le contexte @code{FretBoards}. 
+
+@cindex fret, ajout de doigtés aux diagrammes
+@cindex doigtés, ajout à des diagrammes de fret
+
+Il est possible d'ajouter des indications de doigté aux diagrammes de
+fret. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       c1 d:m
+     }
+  }
+  \context FretBoards {
+    < c-3 e-2 g c'-1 e' > 1
+    < d a-2 d'-3 f'-1>
+  }
+  \context Staff {
+    \clef "treble_8"
+    < c e g c' e' > 1
+    < d a d' f'>
+  }
+>>
+@end lilypond
+
+La propriété @code{minimumFret} permet de définir la case minimale qui
+servira à calculer les cordes et les cases du contexte @code{FretBoard}. 
+
+@lilypond[quote, verbatim]
+<<
+  \context ChordNames {
+     \chordmode {
+       d1:m d:m
+     }
+  }
+  \context FretBoards {
+    < d a d' f'>
+    \set FretBoards.minimumFret = #5
+    < d a d' f'>
+  }
+  \context Staff {
+    \clef "treble_8"
+    < d a d' f'>
+    < d a d' f'>
+  }
+>>
+@end lilypond
+
+Les cordes et les cases du contexte @code{FretBoards} sont liées à la
+propriété @code{stringTunings}, qui a là même signification que dans le
+contexte @code{TabStaff}.  
+Voir @ref{Custom tablatures} pour plus d'information sur la propriété
+@code{stringTunings}. 
+
+La disposition graphique d'un diagramme d'accord peut être modifiée
+suivant les préférences de l'utilisateur au travers des propriétés de
+l'interface @rinternals{fret-diagram-interface}.  Pour un diagramme
+d'accord, les propriétés de l'interface dépendent de 
+@code{FretBoards.FretBoard}.
+
+
+@predefined
+@code{\predefinedFretboardsOff},
+@code{\predefinedFretboardsOn}.
+@endpredefined
+
+
+@seealso
+Manuel de notation :
+@ref{Custom tablatures}.
+
+Morceaux choisis :
+@rlsr{Fretted strings}.
+
+Référence des propriétés internes :
+@rinternals {fret-diagram-interface}.
 
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+
+@node Right-hand fingerings
+@unnumberedsubsubsec Right-hand fingerings
+
+@cindex cordes frettées, doigtés main droite
+@cindex doigtés main droite et cordes frettées
+@cindex main droite, doigtés pour cordes frettées
+
+@funindex rightHandFinger
+@funindex \rightHandFinger
+
+Les doigtés de main droite @var{p-i-m-a} doivent être entrés dans une
+construction de type accord @code{<>} même s'il n'y a qu'une seule note.
+
+@warning{Un trait d'union @strong{doit} suivre la note et une espace
+@strong{doit} précéder la fermeture de la construction par un @code{>}.}
+
+
+@lilypond[quote,verbatim,relative=0]
+\clef "treble_8"
+<c-\rightHandFinger #1 >4
+<e-\rightHandFinger #2 >
+<g-\rightHandFinger #3 >
+<c-\rightHandFinger #4 >
+<c,-\rightHandFinger #1 e-\rightHandFinger #2
+  g-\rightHandFinger #3 c-\rightHandFinger #4 >1
 @end lilypond
 
 Pour plus de clarté, vous pouvez traduire ou abréger la commande
@@ -334,59 +1202,120 @@ même @code{\MD} :
 #(define MD rightHandFinger)
 @end example
 
-@cindex doigtés, main droite, guitare
-@cindex mains droite, doigtés guitare
 
-@commonprop
+@snippets
 
-Pour contrôler plus précisément les doigtés de main droite, réglez la
-propriété @code{strokeFingerOrientations} :
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{placement-of-right-hand-fingerings.ly}
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-}
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{fingerings,-string-indications,-and-right-hand-fingerings.ly}
+
+
+@seealso
+Morceaux choisis :
+@rlsr{Fretted strings}.
+
+Référence des propriétés internes :
+@rinternals{StrokeFinger}.
+
+
+@node Guitar
+@subsection Guitar
+
+La plupart des aspects en matière de notation pour guitare sont traités
+dans la partie commune aux instruments frettés.  Il subsiste cependant
+quelques particularités que nous allons maintenant examiner.  Parfois
+l'utilisateur aimerait créer des documents de type recueil de chansons,
+où l'on ne trouve que des accords au-dessus des paroles.  Dans la mesure
+où LilyPond est un éditeur de partitions, il n'est pas l'outil optimal
+pour des documents sans partition.  Une meilleure alternative serait de
+recourrir à un traitement de texte, un éditeur de texte ou, pour les
+utilisateurs experimentés, un logiciel typographique tel que GuitarTex.
+
+@menu
+* Indicating position and barring::
+* Indicating harmonics and dampened notes::
+@end menu
+
+@node Indicating position and barring
+@unnumberedsubsubsec Indicating position and barring
+
+@cindex indication de la position et du barré pour cordes frettées
+@cindex cordes frettées, indication de la position et du barré
+
+Cet exemple montre comment indiquer les positions et les barrés :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
+\clef "treble_8"
+b16 d g b e
+\textSpannerDown
+\override TextSpanner #'(bound-details left text) = #"XII "
+  g16\startTextSpan
+  b16 e g e b g\stopTextSpan
+e16 b g d
 @end lilypond
 
-Les lettres utilisées dans ces doigtés sont définies par la propriété
-@code{digit-names}, mais on peut bien sûr les changer en utilisant une
-chaîne de caractères comme argument de @code{\rightHandFinger}.
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = #'#("x" "y" "z" "!" "@")
-  <c-\RH #5 >4
-  <c-\RH "@">4
+@seealso
+Manuel de notation :
+@ref{Text spanners}.
+
+Morceaux choisis :
+@rlsr{Fretted strings},
+@rlsr{Expressive marks}.
+
+
+@node Indicating harmonics and dampened notes
+@unnumberedsubsubsec Indicating harmonics and dampened notes
+
+@cindex cordes frettées, notes étouffées
+@cindex cordes frettées, harmoniques
+@cindex notes étouffées et cordes frettées
+@cindex harmoniques et cordes frettées
+
+Des têtes de note spéciales peuvent servir à indiquer les
+notes étouffées et les sons harmoniques.  Les sons harmoniques sont
+souvent détaillés grâce à des indications textuelles.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  \clef "treble_8"
+  \override Staff.NoteHead #'style = #'cross
+  g8 a b c b4
+  \override Staff.NoteHead #'style = #'harmonic-mixed
+  d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
 }
 @end lilypond
 
+
 @seealso
+Morceaux choisis :
+@rlsr{Fretted strings}.
+
+Manuel de notation :
+@ref{Special note heads},
+@ref{Note head styles}.
 
-Référence du programme : @rinternals{StrokeFinger}
 
 @node Banjo
 @subsection Banjo
 
-@untranslated
-
 @menu
 * Banjo tablatures::
 @end menu
 
 @node Banjo tablatures
-@subsubsection Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
 
-@cindex Tablatures de banjo
+@cindex banjo, tablatures
+@cindex tablatures pour banjo
 
 LilyPond permet d'écrire des tablatures de base pour le banjo à cinq
 cordes.  Pour ce faire, pensez à utiliser le format de tablature pour
-banjo, afin d'avoir le bon nombre de cordes et le bon accord :
+banjo, afin d'avoir le bon nombre de cordes et le bon accordage :
+
+@c due to crazy intervals of banjo music, absolute pitch is recommended
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 \new TabStaff <<
@@ -401,20 +1330,32 @@ banjo, afin d'avoir le bon nombre de cordes et le bon accord :
 >>
 @end lilypond
 
-LilyPond connaît un certain nombre de manières d'accorder un banjo :
-@code{banjo-c-tuning} (sol do sol si ré),
-@code{banjo-modal-tuning} (sol ré sol do ré),
-@code{banjo-open-d-tuning} (la ré fa-dièse la ré)
-et @code{banjo-open-dm-tuning} (la ré fa la ré).
+@cindex banjo, accordages
+@cindex accordages de banjo
+
+@funindex banjo-c-tuning
+@funindex banjo-modal-tuning
+@funindex banjo-open-d-tuning
+@funindex banjo-open-dm-tuning
+@funindex four-string-banjo
 
-Tous ces accords peuvent être convertis en accords pour banjo à quatre
-cordes, si l'on utilise la fonction @code{four-string-banjo} :
+LilyPond prend en charge un certain nombre d'accordages courants pour
+banjo : @code{banjo-c-tuning} sol,do,sol,si,ré (gCGBD),
+@code{banjo-modal-tuning} sol,ré,sol,do,ré (gDGCD), 
+@code{banjo-open-d-tuning} la,ré,fa#,la,ré (aDF#AD) et
+@code{banjo-open-dm-tuning} la,ré,fa,la,ré (aDFAD).
+
+Ces accordages peuvent être convertis pour banjo à quatre cordes au
+moyen de la fonction @code{four-string-banjo} :
 
 @example
 \set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
 @end example
 
+
 @seealso
+Morceaux choisis :
+@rlsr{Fretted strings}.
 
-Vous trouverez une liste complète des jeux de cordes prédéfinis pour le banjo
-dans le fichier @file{scm/@/output@/-lib@/.scm}.
+Les accordages prédéfinis du banjo sont contenus dans le fichier
+@file{scm/@/output@/-lib@/.scm}.