]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/editorial.itely
Merge branch 'master' of /home/jcharles/GIT/Lily/. into translation
[lilypond.git] / Documentation / fr / notation / editorial.itely
index 480abb373b46899e6742145237e9ad36e9a44843..1e53df13d9c77d795092e95572c472c4f4882400 100644 (file)
@@ -1,17 +1,19 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
 @ignore
-    Translation of GIT committish: ca543ea73189a1e53af94973dad0b8a5042c130c
+    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
 
     When revising a translation, copy the HEAD committish of the
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.19.21"
 
 @c Translators: Jean-Charles Malahieude
 
 
 @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}
 @translationof Editorial annotations
 
 @lilypondfile[quote]{editorial-headword.ly}
@@ -20,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
 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
 
 
 @end menu
 
 
@@ -33,47 +35,135 @@ Nous allons voir ici comment mettre en exergue certains éléments à
 l'intérieur même de la portée.
 
 @menu
 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
 
 @end menu
 
+
 @node Indication de la taille de fonte musicale
 @unnumberedsubsubsec Indication de la taille de fonte musicale
 @translationof Selecting notation font size
 
 @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
 @cindex notes, taille
 @cindex taille des notes
 @cindex têtes de note
 
 @funindex fontSize
 @funindex font-size
+@funindex magnification->font-size
 @funindex magstep
 @funindex magstep
-@funindex \huge
-@funindex \large
-@funindex \normalsize
-@funindex \small
-@funindex \tiny
+@funindex magnifyMusic
 @funindex \teeny
 @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 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.
 
 
-Le plus sûr moyen de régler la taille de la police, quelque 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.
+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 :
 
 
-@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}.}
+@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=1]
+% 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
 
 @lilypond[verbatim,quote,relative=2]
 \huge
 
 @lilypond[verbatim,quote,relative=2]
 \huge
@@ -90,25 +180,110 @@ c4.-> d8---3
 c4.-> d8---3
 @end lilypond
 
 c4.-> d8---3
 @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.
+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)}.
+
+
+@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=2]
+\time 3/4
+d4---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
+
+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,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-\set fontSize = #3
+% the default font-size for NoteHead is 0
+% the default font-size for Fingering is -5
+c4-3
+
+\set fontSize = -3
+% the effective font size for NoteHead is now -3
+% the effective font size for Fingering is now -8
+c4-3
+
+\override Fingering.font-size = 0
+% the effective font size for Fingering is now -3
+c4-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=2]
+\teeny
 c4.-> d8---3
 c4.-> d8---3
-\override NoteHead #'font-size = #-4
+\tiny
+c4.-> d8---3
+\small
 c4.-> d8---3
 c4.-> d8---3
-\override Script #'font-size = #2
+\normalsize
 c4.-> d8---3
 c4.-> d8---3
-\override Stem #'font-size = #-5
+\large
+c4.-> d8---3
+\huge
 c4.-> d8---3
 @end lilypond
 
 c4.-> d8---3
 @end lilypond
 
@@ -118,19 +293,15 @@ c4.-> d8---3
 @funindex font-interface
 @funindex font-size
 
 @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
 
 
 @predefined
+@code{\magnifyMusic},
 @code{\teeny},
 @code{\tiny},
 @code{\small},
 @code{\teeny},
 @code{\tiny},
 @code{\small},
@@ -139,14 +310,45 @@ l'interface de rendu @code{font-interface}.
 @code{\huge}.
 @endpredefined
 
 @code{\huge}.
 @endpredefined
 
-
 @seealso
 @seealso
+Manuel de notation :
+@ref{Sélection de la fonte et de la taille},
+@ref{Définition de la taille de portée},
+@ref{Mise en forme d'une citation},
+@ref{Portées d'ossia}.
+
+Fichiers d'initialisation :
+@file{ly/music-functions-init.ly},
+@file{ly/property-init.ly}.
+
 Morceaux choisis :
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{font-interface}.
 
 
 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
 
 @node Doigtés
 @unnumberedsubsubsec Doigtés
@@ -158,7 +360,7 @@ Référence des propriétés internes :
 @funindex \finger
 @funindex finger
 
 @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]
 @var{note}-@var{chiffre_du_doigt}
 
 @lilypond[verbatim,quote,relative=2]
@@ -170,7 +372,7 @@ textuelle (commande @code{\markup}) de doigté
 (commande @code{\finger}).
 
 @lilypond[verbatim,quote,relative=2]
 (commande @code{\finger}).
 
 @lilypond[verbatim,quote,relative=2]
-c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
+c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
 @end lilypond
 
 @cindex pouce, doigté
 @end lilypond
 
 @cindex pouce, doigté
@@ -196,27 +398,26 @@ en les indiquant après chaque hauteur de note.
 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 @end lilypond
 
 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 @end lilypond
 
-L'indication des doigtés peut se apparaître au-dessus ou en-dessous de
+Les indications de doigtés peuvent se placer au-dessus ou en dessous de
 la portée -- voir @ref{Direction et positionnement} à ce sujet.
 
 @snippets
 
 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}
 
 {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}
 
 {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}
 
 {avoiding-collisions-with-chord-fingerings.ly}
 
-
 @seealso
 Manuel de notation :
 @seealso
 Manuel de notation :
-@ref{Direction et positionnement}
+@ref{Direction et positionnement}.
 
 Morceaux choisis :
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations, Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{FingeringEvent},
 
 Référence des propriétés internes :
 @rinternals{FingeringEvent},
@@ -233,6 +434,8 @@ Référence des propriétés internes :
 @cindex masquées, notes
 @cindex invisibles, notes
 @cindex transparentes, notes
 @cindex masquées, notes
 @cindex invisibles, notes
 @cindex transparentes, notes
+@cindex note invisible
+@cindex note masquée
 
 @funindex \hideNotes
 @funindex hideNotes
 
 @funindex \hideNotes
 @funindex hideNotes
@@ -254,22 +457,22 @@ b
 c
 @end lilypond
 
 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]
 Les objets de notation attachés à une note invisible ne seront pas
 masqués pour autant.
 
 @lilypond[verbatim,quote,relative=2]
-c4( d)
+e8(\p f g a)--
 \hideNotes
 \hideNotes
-e4(\p f)--
+e8(\p f g a)--
 @end lilypond
 
 @end lilypond
 
-
 @predefined
 @code{\hideNotes},
 @code{\unHideNotes}.
 @endpredefined
 
 @predefined
 @code{\hideNotes},
 @code{\unHideNotes}.
 @endpredefined
 
-
 @seealso
 Manuel d'initiation :
 @rlearning{Visibilité et couleur des objets}.
 @seealso
 Manuel d'initiation :
 @rlearning{Visibilité et couleur des objets}.
@@ -280,7 +483,7 @@ Manuel de notation :
 @ref{Masquage de portées}.
 
 Morceaux choisis :
 @ref{Masquage de portées}.
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Note_spacing_engraver},
 
 Référence des propriétés internes :
 @rinternals{Note_spacing_engraver},
@@ -307,45 +510,45 @@ Référence des propriétés internes :
 @funindex x11-color
 
 Des objets peuvent être colorisés individuellement.  Une listes des
 @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]
 @ref{Liste des couleurs}.
 
 @lilypond[verbatim,quote,relative=2]
-\override NoteHead #'color = #red
+\override NoteHead.color = #red
 c4 c
 c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
+\override NoteHead.color = #(x11-color 'LimeGreen)
 d
 d
-\override Stem #'color = #blue
+\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
 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]
 
 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)
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
 }
 
 gis8 a
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
 }
 
 gis8 a
-\override Beam #'color = #(x11-color "medium turquoise")
+\override Beam.color = #(x11-color "medium turquoise")
 gis a
 gis a
-\override Accidental #'color = #(x11-color 'DarkRed)
+\override Accidental.color = #(x11-color 'DarkRed)
 gis a
 gis a
-\override NoteHead #'color = #(x11-color "LimeGreen")
+\override NoteHead.color = #(x11-color "LimeGreen")
 gis a
 % this is deliberate nonsense; note that the stems remain black
 gis a
 % this is deliberate nonsense; note that the stems remain black
-\override Stem #'color = #(x11-color 'Boggle)
+\override Stem.color = #(x11-color 'Boggle)
 b2 cis
 @end lilypond
 
 b2 cis
 @end lilypond
 
@@ -359,31 +562,30 @@ b2 cis
 
 Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
 les composantes de la couleur exacte au format rouge-vert-bleu
 
 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]
 
 @lilypond[verbatim,quote,relative=2]
-\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
 }
 
 \set Staff.instrumentName = \markup {
   \with-color #(x11-color 'navy) "Clarinet"
 }
 
-\override Stem #'color = #(rgb-color 0 0 0)
+\override Stem.color = #(rgb-color 0 0 0)
 gis8 a
 gis8 a
-\override Stem #'color = #(rgb-color 1 1 1)
+\override Stem.color = #(rgb-color 1 1 1)
 gis8 a
 gis8 a
-\override Stem #'color = #(rgb-color 0 0 0.5)
+\override Stem.color = #(rgb-color 0 0 0.5)
 gis4 a
 @end lilypond
 
 gis4 a
 @end lilypond
 
-
 @seealso
 Manuel de notation :
 @ref{Liste des couleurs},
 @seealso
 Manuel de notation :
 @ref{Liste des couleurs},
-@ref{La commande d'affinage (@emph{tweak})}.
+@ref{La commande d'affinage (tweak)}.
 
 Morceaux choisis :
 
 Morceaux choisis :
-@rlsr{Editorial annotations}.
-
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 @cindex x11, couleur
 @cindex couleur, notes d'un accord
 
 @cindex x11, couleur
 @cindex couleur, notes d'un accord
@@ -398,14 +600,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
 
 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
 
 
 @node Parenthèses
@@ -415,6 +616,7 @@ Pour plus de détails, consultez
 @cindex fantômes, notes
 @cindex notes fantômes
 @cindex parenthèses, notes entre
 @cindex fantômes, notes
 @cindex notes fantômes
 @cindex parenthèses, notes entre
+@cindex crochets, notes entre
 
 @funindex \parenthesize
 @funindex parenthesize
 
 @funindex \parenthesize
 @funindex parenthesize
@@ -422,7 +624,7 @@ Pour plus de détails, consultez
 Des objets peuvent être mis entre parenthèses en saisissant
 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
 préfixe un accord, chaque note le composant se présentera entre
 Des objets peuvent être mis entre parenthèses en saisissant
 @code{\parenthesize} juste avant l'événement musical.  Si l'instruction
 préfixe un accord, chaque note le composant se présentera entre
-parenethèses.  Vous pouvez aussi mettre individuellement entre
+parenthèses.  Vous pouvez aussi mettre individuellement entre
 parenthèses les notes d'un accord.
 
 @lilypond[verbatim,quote,relative=2]
 parenthèses les notes d'un accord.
 
 @lilypond[verbatim,quote,relative=2]
@@ -433,26 +635,23 @@ c2 <c \parenthesize e g>
 
 Les objets autres que des notes peuvent aussi être entre parenthèses.
 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
 
 Les objets autres que des notes peuvent aussi être entre parenthèses.
 En ce qui concerne les articulations, l'instruction @code{\parenthesize}
-doît cependant être précédée d'un tiret.
+doit cependant être précédée d'un tiret.
 
 @lilypond[verbatim,quote,relative=2]
 c2-\parenthesize -. d
 c2 \parenthesize r
 @end lilypond
 
 
 @lilypond[verbatim,quote,relative=2]
 c2-\parenthesize -. d
 c2 \parenthesize r
 @end lilypond
 
-
 @seealso
 Morceaux choisis :
 @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}.
 
 
 Référence des propriétés internes :
 @rinternals{Parenthesis_engraver},
 @rinternals{ParenthesesItem},
 @rinternals{parentheses-interface}.
 
-
 @knownissues
 @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.
 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.
@@ -466,6 +665,10 @@ attendrait une seule paire de parenthèses encadrant tout l'accord.
 @cindex hampes invisibles
 @cindex visibilité des hampes
 @cindex masquage des hampes
 @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 \stemUp
 @funindex stemUp
@@ -473,38 +676,34 @@ attendrait une seule paire de parenthèses encadrant tout l'accord.
 @funindex stemDown
 @funindex \stemNeutral
 @funindex stemNeutral
 @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.
 
 
 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.
 
 @ref{Direction et positionnement} à ce sujet.
 
-
 @predefined
 @code{\stemUp},
 @code{\stemDown},
 @code{\stemNeutral}.
 @endpredefined
 
 @predefined
 @code{\stemUp},
 @code{\stemDown},
 @code{\stemNeutral}.
 @endpredefined
 
-
 @snippets
 
 @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}
 
 {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 :
 
 @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},
 
 Référence des propriétés internes :
 @rinternals{Stem_engraver},
@@ -520,11 +719,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
 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
 
 @end menu
 
+
 @node Info-bulle
 @unnumberedsubsubsec Info-bulle
 @translationof Balloon help
 @node Info-bulle
 @unnumberedsubsubsec Info-bulle
 @translationof Balloon help
@@ -544,8 +744,8 @@ la portée par des éléments qui lui seront externes.
 @funindex balloonLengthOff
 
 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 @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
 
 En voici un exemple :
 @c KEEP LY
@@ -560,21 +760,21 @@ En voici un exemple :
 }
 @end lilypond
 
 }
 @end lilypond
 
-
 Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
 @code{balloonText}.  @code{balloonGrobText} prend en argument
 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.
+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]
 \new Voice \with { \consists "Balloon_engraver" }
 {
 
 @c KEEP LY
 @lilypond[verbatim,quote,relative=2]
 \new Voice \with { \consists "Balloon_engraver" }
 {
-  \balloonLengthOff
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
   a8
   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
@@ -584,16 +784,14 @@ gérer ainsi :
 }
 @end lilypond
 
 }
 @end lilypond
 
-
 @predefined
 @code{\balloonLengthOn},
 @code{\balloonLengthOff}.
 @endpredefined
 
 @predefined
 @code{\balloonLengthOn},
 @code{\balloonLengthOff}.
 @endpredefined
 
-
 @seealso
 Morceaux choisis :
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Balloon_engraver},
 
 Référence des propriétés internes :
 @rinternals{Balloon_engraver},
@@ -605,10 +803,8 @@ Référence des propriétés internes :
 @unnumberedsubsubsec Quadrillage temporel
 @translationof Grid lines
 
 @unnumberedsubsubsec Quadrillage temporel
 @translationof Grid lines
 
-@cindex grid lines
-@cindex lines, grid
-@cindex vertical lines between staves
-@cindex lines, vertical between staves
+@cindex quadrillage temporel
+@cindex temporel, quadrillage
 
 @funindex Grid_point_engraver
 @funindex Grid_line_span_engraver
 
 @funindex Grid_point_engraver
 @funindex Grid_line_span_engraver
@@ -617,13 +813,13 @@ Référence des propriétés internes :
 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.
 
 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 les notes.
 
-The @code{Grid_point_engraver} must be used to create the end
-points of the lines, while the @code{Grid_line_span_engraver} must
-be used to actually draw the lines.  By default this centers grid
-lines horizontally below and to the left side of each note head.
-Grid lines extend from the middle lines of each staff.  The
-@code{gridInterval} must specify the duration between the grid
-lines.
+LilyPond a recours à deux graveurs distincts afin d'afficher le
+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]
 
 @c KEEP LY
 @lilypond[verbatim,quote]
@@ -631,7 +827,7 @@ lines.
   \context {
     \Staff
     \consists "Grid_point_engraver" %% active les guides
   \context {
     \Staff
     \consists "Grid_point_engraver" %% active les guides
-    gridInterval = #(ly:make-moment 1 4)
+    gridInterval = #(ly:make-moment 1/4)
   }
   \context {
     \Score
   }
   \context {
     \Score
@@ -642,11 +838,11 @@ lines.
 
 \score {
   \new ChoirStaff <<
 
 \score {
   \new ChoirStaff <<
-    \new Staff \relative c'' {
+    \new Staff \relative {
       \stemUp
       \stemUp
-      c'4. d8 e8 f g4
+      c'''4. d8 e8 f g4
     }
     }
-    \new Staff \relative {
+    \new Staff \relative {
     %% centre les lignes guides verticalement
       \clef bass
       \stemDown
     %% centre les lignes guides verticalement
       \clef bass
       \stemDown
@@ -658,13 +854,12 @@ lines.
 
 @snippets
 
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {grid-lines--changing-their-appearance.ly}
 
 {grid-lines--changing-their-appearance.ly}
 
-
 @seealso
 Morceaux choisis :
 @seealso
 Morceaux choisis :
-@rlsr{Editorial annotations}.
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
 
 Référence des propriétés internes :
 @rinternals{Grid_line_span_engraver},
 
 Référence des propriétés internes :
 @rinternals{Grid_line_span_engraver},
@@ -678,34 +873,57 @@ Référence des propriétés internes :
 @node Crochets d'analyse
 @unnumberedsubsubsec Crochets d'analyse
 @translationof Analysis brackets
 @node Crochets d'analyse
 @unnumberedsubsubsec Crochets d'analyse
 @translationof Analysis brackets
+
 @cindex crochets
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
 
 @cindex crochets
 @cindex crochets de phrasé
 @cindex analyse musicologique
 @cindex crochet de regroupement de notes
 
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
+
 On utilise des crochets en analyse musicale, pour indiquer la
 On utilise des crochets en analyse musicale, pour indiquer la
-structure d'une pièce.  LilyPond permet d'utiliser une forme
-simplifiée de crochets horizontaux imbriqués, dans la mesure où le
-contexte @rinternals{Staff} comporte le graveur
-@rinternals{Horizontal_bracket_engraver}.  Un crochet s'ouvre avec
-@code{\startGroup}, et se ferme avec @code{\stopGroup}.
+structure d'une pièce.
 
 
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\stopGroup
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Horizontal_bracket_engraver"
   }
   }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
+}
+\relative {
+  c''2\startGroup
+  d\stopGroup
+}
 @end lilypond
 
 @end lilypond
 
+Les crochets d'analyses sont susceptibles d'être imbriqués :
 
 
-@seealso
-Référence du programme : @rinternals{HorizontalBracket}.
+@lilypond[verbatim,quote]
+\layout {
+  \context {
+    \Voice
+    \consists "Horizontal_bracket_engraver"
+  }
+}
+\relative {
+  c''4\startGroup\startGroup
+  d4\stopGroup
+  e4\startGroup
+  d4\stopGroup\stopGroup
+}
+@end lilypond
 
 
+@seealso
+Morceaux choisis :
+@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}.