X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Feditorial.itely;h=61d33e7a8eef3917c5e8e8dc91f4e20a4b3108d7;hb=09ef86c87175cc6c1071eedb022ed1d01a93bcaf;hp=2a9c2df667e803e764519f8c5272eada948ed0c5;hpb=3dd9b13331489a191d0e901245cc98476e5fcac1;p=lilypond.git

diff --git a/Documentation/fr/notation/editorial.itely b/Documentation/fr/notation/editorial.itely
index 2a9c2df667..61d33e7a8e 100644
--- a/Documentation/fr/notation/editorial.itely
+++ b/Documentation/fr/notation/editorial.itely
@@ -1,18 +1,19 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
-    Translation of GIT committish: ca543ea73189a1e53af94973dad0b8a5042c130c
+   Translation of GIT committish: 16d46fb0995cc6d078617ada1e8fea7879dffe07
 
-    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..
+   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.12.0"
+@c \version "2.19.21"
 
 @c Translators: Jean-Charles Malahieude
 
-@node Notation éditoriale
-@section Notation éditoriale
+@node Annotations éditoriales
+@section Annotations éditoriales
 @translationof Editorial annotations
 
 @lilypondfile[quote]{editorial-headword.ly}
@@ -21,8 +22,8 @@ Ce chapitre traite de la manière de modifier l'apparence des notes dans
 un but pédagogique ou d'analyse.
 
 @menu
-* Dans la portée::            
-* Hors de la portée::           
+* Dans la portée::
+* Hors de la portée::
 @end menu
 
 
@@ -34,83 +35,247 @@ Nous allons voir ici comment mettre en exergue certains éléments à
 l'intérieur même de la portée.
 
 @menu
-* Indication de la taille de fonte musicale::  
-* Doigtés::      
-* Dictée à trous::                
-* Coloration d'objets::            
-* Parenthèses::                 
-* Hampes::                       
+* Indication de la taille de fonte musicale::
+* Doigtés::
+* Dictée à trous::
+* Coloration d'objets::
+* Parenthèses::
+* Hampes::
 @end menu
 
+
 @node Indication de la taille de fonte musicale
 @unnumberedsubsubsec Indication de la taille de fonte musicale
 @translationof Selecting notation font size
 
-@cindex selection de la taille (notation)
+@cindex sélection de la taille (notation)
 @cindex notes, taille
 @cindex taille des notes
 @cindex têtes de note
 
 @funindex fontSize
 @funindex font-size
+@funindex magnification->font-size
 @funindex magstep
-@funindex \huge
-@funindex \large
-@funindex \normalsize
-@funindex \small
-@funindex \tiny
+@funindex magnifyMusic
 @funindex \teeny
-@funindex huge
-@funindex large
-@funindex normalsize
-@funindex small
-@funindex tiny
+@funindex \tiny
+@funindex \small
+@funindex \normalsize
+@funindex \large
+@funindex \huge
 @funindex teeny
+@funindex tiny
+@funindex small
+@funindex normalsize
+@funindex large
+@funindex huge
+
+@warning{@*
+Pour les tailles de police textuelle, voir
+@ref{Sélection de la fonte et de la taille}.@*
+Pour la taille des portées, voir
+@ref{Définition de la taille de portée}.@*
+Pour les petites notes, voir
+@ref{Mise en forme d'une citation}.@*
+Pour les variantes, voir @ref{Portées d'ossia}.}
+
+Le plus sûr moyen de régler la taille des éléments de notation sans
+modifier la taille de la portée consiste à utiliser la commande
+@code{\magnifyMusic} :
+
+@c Grieg Piano Concerto (mvt.1 cadenza)
+@lilypond[verbatim,quote]
+\new Staff <<
+  \new Voice \relative {
+    \voiceOne
+    <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+  }
+  \new Voice \relative {
+    \voiceTwo
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      r32 c'' a c a c a c r c a c a c a c
+      r c a c a c a c a c a c a c a c
+    }
+  }
+>>
+@end lilypond
+
+La présence d'un @code{\override} dans cet exemple permet de
+contourner une bogue -- voir « Problèmes connus et avertissements » en
+fin de section.
+
+Dans le cas de fusion d'une tête de note normale avec une autre de
+taille inférieure, la taille de la petite note peut nécessiter une
+réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} --
+de telle sorte que les hampes et altérations s'alignent correctement :
+
+@c Chopin Prelude op.28 no.8
+@lilypond[verbatim,quote]
+\new Staff <<
+  \key fis \minor
+  \mergeDifferentlyDottedOn
+  \new Voice \relative {
+    \voiceOne
+    \magnifyMusic 0.63 {
+      \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+      \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
+      \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
+      \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
+      \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
+    }
+  }
+  \new Voice \relative {
+    \voiceTwo
+    cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
+  }
+>>
+@end lilypond
+
+La commande @code{\magnifyMusic} n'est pas conçue pour gérer les
+citations, notes d'ornement ou portées d'ossia -- des moyens
+spécifiques sont déjà disponibles en la matière.  Elle est par contre
+tout à fait adaptée dans le cas d'un instrument particulier disposant de
+sa propre portée là où des notes d'ornement seraient inappropriées,
+comme pour une pseudo-cadence ou les exemples ci-dessus.  L'attribution
+d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un
+contexte @code{CueVoice}.
+
+@warning{La commande @code{@bs{}magnifyMusic} n'est pas censée
+intervenir en complément d'une modification de la taille de portée --
+voir @ref{Définition de la taille de portée}.}
+
+
+@subsubsubheading Redimmensionnement individuel d'objets de rendu
+@c VO Resizing individual layout objects
+
+L'ajustement de la propriété @code{font-size} à l'aide des commandes
+@code{\tweak} ou @code{\override} permet de retailler un objet de rendu
+particulier :
+
+@lilypond[quote,verbatim]
+\relative {
+  % resize a note head
+  <f' \tweak font-size -4 b e>-5
+  % resize a fingering
+  bes-\tweak font-size 0 -3
+  % resize an accidental
+  \once \override Accidental.font-size = -4 bes!-^
+  % resize an articulation
+  \once \override Script.font-size = 4 bes!-^
+}
+@end lilypond
+
+La valeur par défaut de @code{font-size} est mentionnée, pour chaque
+objet de rendu, dans la référence des propriétés internes.  La propriété
+@code{font-size} ne peut intervenir que pour les objets qui utilisent
+des polices, autrement dit ceux qui disposent de l'interface de rendu
+@code{font-interface}.  L'abence de @code{font-size} dans la liste des
+« réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir
+@rinternals{All layout objects} @emph{(Tous les objets de rendu)}.
 
 
-Le plus sûr moyen de régler la taille de la police, quel que soit le
-contexte, consiste à définir la propriété @code{fontSize}.
-Ceci ne modifiera en rien la taille des différents symboles tels que
-ligatures ou liaisons.
-
-@warning{En matière de taille des éléments textuels, référez-vous au
-chapitre @ref{Sélection de la fonte et de la taille}.}
-
-@lilypond[verbatim,quote,relative=2]
-\huge
-c4.-> d8---3
-\large
-c4.-> d8---3
-\normalsize
-c4.-> d8---3
-\small
-c4.-> d8---3
-\tiny
-c4.-> d8---3
-\teeny
-c4.-> d8---3
+@subsubsubheading La propriété @code{fontSize}
+@c VO Understanding the @code{fontSize} property
+
+La propriété @code{fontSize} d'un contexte a pour effet de définir la
+taille proportionnelle de tout élément de notation basé sur un
+glyphe dans ce contexte :
+
+@lilypond[verbatim,quote]
+\relative {
+  \time 3/4
+  d''4---5 c8( b a g) |
+  \set fontSize = -6
+  e'4-- c!8-4( b a g) |
+  \set fontSize = 0
+  fis4---3 e8( d) fis4 |
+  g2.
+}
 @end lilypond
 
-En interne, la propriété @code{fontSize} d'un contexte aura pour effet
-de définir la propriété @code{font-size} pour tous les objets de
-rendu.  La valeur de @code{font-size} est un entier représentant la
-taille proportionnellement à la hauteur standard de la portée en
-cours.  Chaque incrément correspond à une augmentation d'environ
-12@tie{}% de la taille de la police. Un pas de six aboutit exactement
-au doublement de la taille.  La fonction Scheme @code{magstep}
-convertit le nombre affecté à @code{font-size} en facteur d'échelle.
-Vous pouvez aussi définir directement la propriété @code{font-size} de
-manière à n'affecter seulement que certains objets de rendu.
-
-@lilypond[verbatim,quote,relative=2]
-\set fontSize = #3
-c4.-> d8---3
-\override NoteHead #'font-size = #-4
-c4.-> d8---3
-\override Script #'font-size = #2
-c4.-> d8---3
-\override Stem #'font-size = #-5
-c4.-> d8---3
+La valeur de @code{fontSize} est un nombre indiquant la taille
+relative par rapport à la hauteur standard de la portée en cours.
+La valeur par défaut de @code{fontSize} est de 0.  Un pas de six
+aboutit exactement au doublement de la taille ; un pas de moins
+six la réduit de moitié.  Chaque incrément correspond à une
+augmentation d'environ 12 % de la taille de la police.
+
+La fonction Scheme @code{magnification->font-size} permet de
+s'affranchir de l'échelle logarithmique peu intuitive des unités
+de la propriété @code{font-size}.  Ainsi, l'ajustement à 75 % de
+la notation musicale par rapport à la taille de la portée peut se
+libeller :
+
+@example
+\set fontSize = #(magnification->font-size 0.75)
+@end example
+
+La fonction Scheme @code{magstep} quant à elle effectue
+l'inverse : elle convertit le nombre affecté à @code{font-size} en
+facteur d'échelle.
+
+La propriété @code{fontSize} affecte uniquement les éléments de
+notation reposant sur des glyphes, tels les têtes de note,
+altérations, scripts, etc.  Elle n'aura aucun effet sur la taille
+de la portée, la hauteur des hampes ou la longueur des ligatures
+ni sur l'espacement horizontal.  L'échelonnement des hampes,
+ligature et espacement horizontal, couplé à la taille de la
+notation (sans modification de la taille de la portée), s'obtient
+à l'aide de la commande @code{\magnifyMusic} comme nous venons de
+le voir.  La modification de l'ensemble, y compris la taille de
+portée, est abordé dans @ref{Définition de la taille de portée}.
+
+Dès lors que la @strong{propriété de contexte} @code{fontSize} est
+définie, sa valeur est ajoutée individuellement à la valeur de la
+@strong{propriété de @emph{grob}} @code{font-size} des objets de
+rendu.  Ceci peut être source de confusion lorsque des propriétés
+@code{font-size} individuelles sont réglées alors que
+@code{fontSize} est déjà fixé :
+
+@lilypond[verbatim,quote,fragment]
+% the default font-size for NoteHead is 0
+% the default font-size for Fingering is -5
+c''4-3
+
+\set fontSize = -3
+% the effective font size for NoteHead is now -3
+% the effective font size for Fingering is now -8
+c''4-3
+
+\override Fingering.font-size = 0
+% the effective font size for Fingering is now -3
+c''4-3
+@end lilypond
+
+LilyPond dispose d'un certain nombre de raccourcis :
+
+@multitable @columnfractions .2 .4 .4
+@item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative}
+@item @code{\teeny}      @tab @code{\set fontSize = -3} @tab 71 %
+@item @code{\tiny}       @tab @code{\set fontSize = -2} @tab 79 %
+@item @code{\small}      @tab @code{\set fontSize = -1} @tab 89 %
+@item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 %
+@item @code{\large}      @tab @code{\set fontSize = 1} @tab 112 %
+@item @code{\huge}       @tab @code{\set fontSize = 2} @tab 126 %
+@end multitable
+
+@lilypond[verbatim,quote]
+\relative c'' {
+  \teeny
+  c4.-> d8---3
+  \tiny
+  c4.-> d8---3
+  \small
+  c4.-> d8---3
+  \normalsize
+  c4.-> d8---3
+  \large
+  c4.-> d8---3
+  \huge
+  c4.-> d8---3
+}
 @end lilypond
 
 @cindex standard, taille des notes
@@ -119,19 +284,15 @@ c4.-> d8---3
 @funindex font-interface
 @funindex font-size
 
-Pour changer la taille des symboles musicaux (police Feta), LilyPond met
-à l'échelle la fonte dont la taille est la plus proche de la taille
-voulue -- cf. @ref{Définition de la taille de portée}.  La taille
-standard (pour laquelle @w{@code{font-size = #0}}) dépend de la hauteur
-de la portée.  À une portée de 20 points correspond une police de 10 
-points. 
-
-La propriété @code{font-size} ne peut intervenir que pour les objets
-qui utilisent des polices, autrement dit ceux qui disposent de
-l'interface de rendu @code{font-interface}.
+Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
+dont la taille est la plus proche de la taille voulue.  La taille
+standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
+de la portée.  À une portée de 20 points correspond une police de
+11 points.
 
 
 @predefined
+@code{\magnifyMusic},
 @code{\teeny},
 @code{\tiny},
 @code{\small},
@@ -140,14 +301,45 @@ l'interface de rendu @code{font-interface}.
 @code{\huge}.
 @endpredefined
 
-
 @seealso
+Manuel de notation :
+@ref{Définition de la taille de portée},
+@ref{Mise en forme d'une citation},
+@ref{Portées d'ossia},
+@ref{Sélection de la fonte et de la taille}.
+
+Fichiers d'initialisation :
+@file{ly/music-functions-init.ly},
+@file{ly/property-init.ly}.
+
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{font-interface}.
 
+@c The two issues mentioned below:
+@c http://code.google.com/p/lilypond/issues/detail?id=3987
+@c http://code.google.com/p/lilypond/issues/detail?id=3990
+@knownissues
+Deux bogues actuellement répertoriés font obstacle à un espacement
+horizontal correct avec @code{\magnifyMusic}.  La seule façon de les
+contourner n'est cependant pas garantie dans toutes les situations.
+Dans l'exemple suivant, il vous faudra adapter la valeur de la variable
+@var{mag}.  Vous pourriez aussi tenter de supprimer une ou les deux
+commandes @code{\newSpacingSection}, ou les commandes @code{\override}
+et @code{\revert} :
+
+@example
+\magnifyMusic @var{mag} @{
+  \newSpacingSection
+  \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
+  [@var{musique}]
+  \newSpacingSection
+  \revert Score.SpacingSpanner.spacing-increment
+@}
+@end example
+
 
 @node Doigtés
 @unnumberedsubsubsec Doigtés
@@ -157,34 +349,33 @@ Référence des propriétés internes :
 @cindex substitution de doigt
 
 @funindex \finger
-@funindex finger
 
-Les doigtés peuvent être indiqués comme suit :
+Les doigtés peuvent être indiqués comme suit :
 @var{note}-@var{chiffre_du_doigt}
 
-@lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f-4 e-3
+@lilypond[verbatim,quote]
+\relative { c''4-1 d-2 f-4 e-3 }
 @end lilypond
 
 Pour les substitutions de doigts, on a recours à une indication
-textuelle (commande @code{\markup}) de doigté
-(commande @code{\finger}).
+textuelle (commande @code{\markup}) de doigté (commande @code{\finger}).
 
-@lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
+@lilypond[verbatim,quote]
+\relative {
+  c''4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
+}
 @end lilypond
 
 @cindex pouce, doigté
 
 @funindex \thumb
-@funindex thumb
 
 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 dans une partition de violoncelle, si une note doit être jouée avec le
 pouce (@emph{thumb} en anglais).
 
-@lilypond[verbatim,quote,relative=2]
-<a_\thumb a'-3>2 <b_\thumb b'-3>
+@lilypond[verbatim,quote]
+\relative { <a'_\thumb a'-3>2 <b_\thumb b'-3> }
 @end lilypond
 
 @cindex doigtés des accords
@@ -193,8 +384,10 @@ pouce (@emph{thumb} en anglais).
 Les doigtés des accords peuvent être saisis note par note,
 en les indiquant après chaque hauteur de note.
 
-@lilypond[verbatim,quote,relative=2]
-<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
+@lilypond[verbatim,quote]
+\relative {
+  <c''-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
+}
 @end lilypond
 
 Les indications de doigtés peuvent se placer au-dessus ou en dessous de
@@ -202,22 +395,21 @@ la portée -- voir @ref{Direction et positionnement} à ce sujet.
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {controlling-the-placement-of-chord-fingerings.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {avoiding-collisions-with-chord-fingerings.ly}
 
-
 @seealso
 Manuel de notation :
-@ref{Direction et positionnement}
+@ref{Direction et positionnement}.
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations, Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{FingeringEvent},
@@ -234,54 +426,58 @@ Référence des propriétés internes :
 @cindex masquées, notes
 @cindex invisibles, notes
 @cindex transparentes, notes
+@cindex note invisible
+@cindex note masquée
 
 @funindex \hideNotes
-@funindex hideNotes
 @funindex \unHideNotes
-@funindex unHideNotes
 
 Les notes masquées -- ou invisibles ou encore transparentes -- sont
 utiles dans le cadre d'exercices de théorie ou de composition.
 
-@lilypond[verbatim,quote,relative=2]
-c4 d
-\hideNotes
-e4 f
-\unHideNotes
-g a
-\hideNotes
-b
-\unHideNotes
-c
+@lilypond[verbatim,quote]
+\relative {
+  c''4 d
+  \hideNotes
+  e4 f
+  \unHideNotes
+  g a
+  \hideNotes
+  b
+  \unHideNotes
+  c
+}
 @end lilypond
 
+Têtes de note, hampes, crochets et silences sont invisibles.  Une
+ligature sera invisible si elle démarre sur une note invisible.
 Les objets de notation attachés à une note invisible ne seront pas
 masqués pour autant.
 
-@lilypond[verbatim,quote,relative=2]
-c4( d)
-\hideNotes
-e4(\p f)--
+@lilypond[verbatim,quote]
+\relative c'' {
+  e8(\p f g a)--
+  \hideNotes
+  e8(\p f g a)--
+}
 @end lilypond
 
-
 @predefined
 @code{\hideNotes},
 @code{\unHideNotes}.
 @endpredefined
 
-
 @seealso
 Manuel d'initiation :
 @rlearning{Visibilité et couleur des objets}.
 
 Manuel de notation :
+@ref{Masquage de portées},
 @ref{Silences invisibles},
-@ref{Visibilité des objets},
-@ref{Masquage de portées}.
+@ref{Visibilité des objets}.
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Note_spacing_engraver},
@@ -304,50 +500,51 @@ Référence des propriétés internes :
 
 @funindex color
 @funindex \with-color
-@funindex with-color
 @funindex x11-color
 
 Des objets peuvent être colorisés individuellement.  Une listes des
-noms des couleurs disponibles se trouvent à l'annexe 
+noms des couleurs disponibles se trouvent à l'annexe
 @ref{Liste des couleurs}.
 
-@lilypond[verbatim,quote,relative=2]
-\override NoteHead #'color = #red
-c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
-d
-\override Stem #'color = #blue
-e
+@lilypond[verbatim,quote,fragment]
+\override NoteHead.color = #red
+c''4 c''
+\override NoteHead.color = #(x11-color 'LimeGreen)
+d''
+\override Stem.color = #blue
+e''
 @end lilypond
 
 L'intégralité de la palette des couleurs définies pour X11 est
 accessible par la fonction Scheme @code{x11-color}.  Cette fonction
-prend en argument une expression symbolique de la forme @var{'TaraTata}
-ou bien une chaîne de caractères comme @var{"TaraTata"}.  La première
-formulation est à la fois plus rapide à écrire et aussi plus efficace.
-Néanmoins, la deuxième forme permet d'accéder aux noms composés des
-couleurs de X11. 
+prend en argument une expression symbolique de la forme
+@code{@var{'TaraTata}} ou bien une chaîne de caractères comme
+@code{@var{"TaraTata"}}.  La première formulation est à la fois plus
+rapide à écrire et aussi plus efficace.  Néanmoins, la deuxième forme
+permet d'accéder aux noms composés des couleurs de X11.
 
 Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
 elle revient à la couleur par défaut, le noir.  Le problème ressort de
 façon évidente au vu de la partition finale.
 
-@lilypond[verbatim,quote,relative=2]
-\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-\set Staff.instrumentName = \markup {
-  \with-color #(x11-color 'navy) "Clarinet"
-}
+@lilypond[verbatim,quote]
+\relative c'' {
+  \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
 
-gis8 a
-\override Beam #'color = #(x11-color "medium turquoise")
-gis a
-\override Accidental #'color = #(x11-color 'DarkRed)
-gis a
-\override NoteHead #'color = #(x11-color "LimeGreen")
-gis a
-% this is deliberate nonsense; note that the stems remain black
-\override Stem #'color = #(x11-color 'Boggle)
-b2 cis
+  gis8 a
+  \override Beam.color = #(x11-color "medium turquoise")
+  gis a
+  \override Accidental.color = #(x11-color 'DarkRed)
+  gis a
+  \override NoteHead.color = #(x11-color "LimeGreen")
+  gis a
+  % this is deliberate nonsense; note that the stems remain black
+  \override Stem.color = #(x11-color 'Boggle)
+  b2 cis
+}
 @end lilypond
 
 @cindex rgb-color
@@ -360,31 +557,32 @@ b2 cis
 
 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
 les composantes de la couleur exacte au format rouge-vert-bleu
-(@emph{RGB}).
+(@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
+l'exemple suivant correspond à 128).
 
-@lilypond[verbatim,quote,relative=2]
-\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-\set Staff.instrumentName = \markup {
-  \with-color #(x11-color 'navy) "Clarinet"
-}
+@lilypond[verbatim,quote]
+\relative c'' {
+  \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
 
-\override Stem #'color = #(rgb-color 0 0 0)
-gis8 a
-\override Stem #'color = #(rgb-color 1 1 1)
-gis8 a
-\override Stem #'color = #(rgb-color 0 0 0.5)
-gis4 a
+  \override Stem.color = #(rgb-color 0 0 0)
+  gis8 a
+  \override Stem.color = #(rgb-color 1 1 1)
+  gis8 a
+  \override Stem.color = #(rgb-color 0 0 0.5)
+  gis4 a
+}
 @end lilypond
 
-
 @seealso
 Manuel de notation :
-@ref{Liste des couleurs},
-@ref{La commande d'affinage (@emph{tweak})}.
+@ref{La commande d'affinage (tweak)},
+@ref{Liste des couleurs}.
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
-
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 @cindex x11, couleur
 @cindex couleur, notes d'un accord
@@ -399,14 +597,13 @@ normale ayant un nom similaire.
 
 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 internet.  Aussi nous vous recommandons, dans le cadre d'une
-présentation multimedia, d'utiliser des couleurs de base @code{#blue},
-@code{#green}, @code{#red} -- bleu, vert, rouge.
+présentation multimédia, d'utiliser des couleurs de base @code{blue},
+@code{green}, @code{red} -- bleu, vert, rouge.
 
-
-Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
-@code{\override}.  Si besoin est, utilisez @code{\tweak}.  
-Pour plus de détails, consultez 
-@ref{La commande d'affinage (@emph{tweak})}.
+Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
+d'un accord avec @code{\override}.  Si besoin est, utilisez
+@code{\tweak} ou @code{\single\override} devant la note en question.
+Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
 
 
 @node Parenthèses
@@ -416,9 +613,9 @@ Pour plus de détails, consultez
 @cindex fantômes, notes
 @cindex notes fantômes
 @cindex parenthèses, notes entre
+@cindex crochets, notes entre
 
 @funindex \parenthesize
-@funindex parenthesize
 
 Des objets peuvent être mis entre parenthèses en saisissant
 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
@@ -426,34 +623,35 @@ préfixe un accord, chaque note le composant se présentera entre
 parenthèses.  Vous pouvez aussi mettre individuellement entre
 parenthèses les notes d'un accord.
 
-@lilypond[verbatim,quote,relative=2]
-c2 \parenthesize d
-c2 \parenthesize <c e g>
-c2 <c \parenthesize e g>
+@lilypond[verbatim,quote]
+\relative {
+  c''2 \parenthesize d
+  c2 \parenthesize <c e g>
+  c2 <c \parenthesize e g>
+}
 @end lilypond
 
 Les objets autres que des notes peuvent aussi être entre parenthèses.
 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
 doit cependant être précédée d'un tiret.
 
-@lilypond[verbatim,quote,relative=2]
-c2-\parenthesize -. d
-c2 \parenthesize r
+@lilypond[verbatim,quote]
+\relative {
+  c''2-\parenthesize -. d
+  c2 \parenthesize r
+}
 @end lilypond
 
-
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Parenthesis_engraver},
 @rinternals{ParenthesesItem},
 @rinternals{parentheses-interface}.
 
-
 @knownissues
-
 Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
 individuellement à chacune des notes le composant, alors qu'on
 attendrait une seule paire de parenthèses encadrant tout l'accord.
@@ -467,45 +665,42 @@ attendrait une seule paire de parenthèses encadrant tout l'accord.
 @cindex hampes invisibles
 @cindex visibilité des hampes
 @cindex masquage des hampes
+@cindex hampe, orientation
+@cindex hampe montante
+@cindex hampe descendante
+@cindex hampe neutre
 
 @funindex \stemUp
-@funindex stemUp
 @funindex \stemDown
-@funindex stemDown
 @funindex \stemNeutral
-@funindex stemNeutral
-@cindex stem, direction
-@cindex stem, up
-@cindex stem, down
-@cindex stem, neutral
 
 Dès qu'une note est rencontrée, un objet @code{Stem} se crée
 automatiquement.  Pour les rondes et les silences, ils sont aussi
 créés, mais en mode invisible.
 
-La direction des hampes peut être définie manuellement -- voir 
+L'orientation des hampes peut être définie manuellement -- voir
 @ref{Direction et positionnement} à ce sujet.
 
-
 @predefined
 @code{\stemUp},
 @code{\stemDown},
 @code{\stemNeutral}.
 @endpredefined
 
-
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
 
 @seealso
 Manuel de notation :
 @ref{Direction et positionnement}.
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Stem_engraver},
@@ -521,11 +716,12 @@ Nous allons nous intéresser ici à souligner des éléments inscrits dans
 la portée par des éléments qui lui seront externes.
 
 @menu
-* Info-bulle::                
-* Quadrillage temporel::                  
-* Crochets d'analyse::           
+* Info-bulle::
+* Quadrillage temporel::
+* Crochets d'analyse::
 @end menu
 
+
 @node Info-bulle
 @unnumberedsubsubsec Info-bulle
 @translationof Balloon help
@@ -540,19 +736,17 @@ la portée par des éléments qui lui seront externes.
 @funindex balloonGrobText
 @funindex balloonText
 @funindex \balloonLengthOn
-@funindex balloonLengthOn
 @funindex \balloonLengthOff
-@funindex balloonLengthOff
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
-bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la 
-notation. 
+bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
+notation.
 
 En voici un exemple :
 @c KEEP LY
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new Voice \with { \consists "Balloon_engraver" }
-{
+\relative c'' {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -561,21 +755,21 @@ En voici un exemple :
 }
 @end lilypond
 
-
 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
-@code{balloonText}.  @code{balloonGrobText} prend en argument
-l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
-comme une simple articulation.  Les autres arguments sont le décalage
-et le texte de la bulle.
+@code{balloonText}.  @code{balloonGrobText} prend en argument l'objet
+graphique à agrémenter et s'utilise comme @code{\once \override}.
+@code{balloonText}, quant à lui, s'utilise comme une simple articulation
+et fonctionne comme @code{\tweak} pour attacher du texte à l'une des
+notes d'un accord.  Les autres arguments sont le décalage et le texte de
+la bulle.
 
-Les info-bulles ont une influence sur les espacements, que l'on peut
-gérer ainsi :
+Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
+peut toutefois le gérer ainsi :
 
 @c KEEP LY
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new Voice \with { \consists "Balloon_engraver" }
-{
-  \balloonLengthOff
+\relative c'' {
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -585,16 +779,14 @@ gérer ainsi :
 }
 @end lilypond
 
-
 @predefined
 @code{\balloonLengthOn},
 @code{\balloonLengthOff}.
 @endpredefined
 
-
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Balloon_engraver},
@@ -606,8 +798,8 @@ Référence des propriétés internes :
 @unnumberedsubsubsec Quadrillage temporel
 @translationof Grid lines
 
-@cindex cadrillage temporel
-@cindex temporel, cadrillage
+@cindex quadrillage temporel
+@cindex temporel, quadrillage
 
 @funindex Grid_point_engraver
 @funindex Grid_line_span_engraver
@@ -617,12 +809,12 @@ Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.
 
 LilyPond a recours à deux graveurs distincts afin d'afficher le
-cadrillage :  le @code{Grid_point_engraver} se charge de 
-déterminer l'envergure du crochet, alors que le
-@code{Grid_line_span_engraver} se consacrera au tracé des lignes.  
-Les lignes sont par défaut centrées horizontalement sous les notes et
-alignées sur la gauche des têtes.  La propriété @code{gridInterval}
-spécifie quant à elle l'espace de temps entre chaque ligne.
+quadrillage :  le @code{Grid_point_engraver} se charge de déterminer
+l'envergure du crochet, alors que le @code{Grid_line_span_engraver} se
+consacrera au tracé des lignes.  Les lignes sont par défaut centrées
+horizontalement sous les notes et alignées sur la gauche des têtes.  La
+propriété @code{gridInterval} spécifie quant à elle l'espace de temps
+entre chaque ligne.
 
 @c KEEP LY
 @lilypond[verbatim,quote]
@@ -630,7 +822,7 @@ spécifie quant à elle l'espace de temps entre chaque ligne.
   \context {
     \Staff
     \consists "Grid_point_engraver" %% active les guides
-    gridInterval = #(ly:make-moment 1 4)
+    gridInterval = #(ly:make-moment 1/4)
   }
   \context {
     \Score
@@ -641,11 +833,11 @@ spécifie quant à elle l'espace de temps entre chaque ligne.
 
 \score {
   \new ChoirStaff <<
-    \new Staff \relative c'' {
+    \new Staff \relative {
       \stemUp
-      c'4. d8 e8 f g4
+      c''4. d8 e8 f g4
     }
-    \new Staff \relative c {
+    \new Staff \relative {
     %% centre les lignes guides verticalement
       \clef bass
       \stemDown
@@ -657,13 +849,12 @@ spécifie quant à elle l'espace de temps entre chaque ligne.
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {grid-lines--changing-their-appearance.ly}
 
-
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Grid_line_span_engraver},
@@ -682,15 +873,14 @@ Référence des propriétés internes :
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
+@cindex musicologie, crochets d'analyse
 
 @funindex Horizontal_bracket_engraver
 @funindex \startGroup
-@funindex startGroup
 @funindex \stopGroup
-@funindex stopGroup
 
 On utilise des crochets en analyse musicale, pour indiquer la
-structure d'une pièce. 
+structure d'une pièce.
 
 @lilypond[verbatim,quote]
 \layout {
@@ -699,13 +889,13 @@ structure d'une pièce.
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c2\startGroup
+\relative {
+  c''2\startGroup
   d\stopGroup
 }
 @end lilypond
 
-Les crochets d'analyses sont susceptibles d'être imbriqués :
+Les crochets d'analyses sont susceptibles d'être imbriqués :
 
 @lilypond[verbatim,quote]
 \layout {
@@ -714,22 +904,20 @@ Les crochets d'analyses sont susceptibles d'être imbriqués :
     \consists "Horizontal_bracket_engraver"
   }
 }
-\relative c'' {
-  c4\startGroup\startGroup
+\relative {
+  c''4\startGroup\startGroup
   d4\stopGroup
   e4\startGroup
   d4\stopGroup\stopGroup
 }
 @end lilypond
 
-
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Horizontal_bracket_engraver},
 @rinternals{HorizontalBracket},
 @rinternals{horizontal-bracket-interface},
 @rinternals{Staff}.
-