+@node Bar lines
+@subsection Bar lines
+
+@cindex Bar lines
+@funindex \bar
+@cindex measure lines
+@cindex repeat bars
+
+
+Les barres de mesures délimitent les mesures, mais peuvent aussi
+indiquer une reprise. En principe, elles sont insérées
+automatiquement, et les changements de ligne ne peuvent se faire qu'au
+niveau de ces barres.
+
+Il est possible de forcer l'affichage d'une barre de mesure spéciale,
+avec la commande @code{\bar} :
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+c4 \bar "|:" c4
+@end lilypond
+
+
+Les styles de barres de mesure disponibles sont :
+
+@lilypondfile[ragged-right,quote]{bar-lines.ly}
+
+
+En plus de cela, on peut demander @code{"||:"}, qui équivaut à
+@code{"|:"}, mais donnera, en cas de changement de ligne, une double
+barre à la fin de la première ligne, et une barre de reprise au début
+de la suivante.
+
+
+Il est possible d'autoriser un changement de ligne même s'il n'y a pas
+de barre de mesure visible, en utilisant :
+
+@example
+\bar ""
+@end example
+
+@noindent
+
+
+Ceci insérera une barre de mesure invisible, et permettra de changer
+de ligne à cet endroit. Le nombre de mesures augmente en ce cas.
+
+
+Dans une partition écrite sur plusieurs portées, la commande
+@code{\bar} placée sur une portée s'appliquera automatiquement à
+toutes les portées. Les barres de mesure que l'on obtient alors sont
+d'un seul tenant sur les portées d'un @code{StaffGroup}, d'un
+@code{PianoStaff}, ou d'un @code{ChoirStaff}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+ \new StaffGroup <<
+ \new Staff {
+ e'4 d'
+ \bar "||"
+ f' e'
+ }
+ \new Staff { \clef bass c4 g e g }
+ >>
+ \new Staff { \clef bass c2 c2 }
+>>
+@end lilypond
+
+
+@commonprop
+
+@funindex whichBar
+@funindex repeatCommands
+@funindex defaultBarType
+
+
+La commande @code{\bar }@var{bartype} sert de raccourci pour
+@code{\set Timing.whichBar = }@var{bartype}. Dès que l'on définit
+@code{whichBar}, une barre de mesure sera créée suivant le style
+défini.
+
+
+Dès que la propriétée @code{whichBar} est définie, une barre de mesure
+est créée. À chaque début de mesure elle est définie en tant que
+@code{Timing.defaultBarType}. Les définitions telles que
+@code{repeatCommands} peuvent servir à remplacer les barres de mesure
+par défaut.
+
+Nous vous invitons à utiliser @code{\repeat} pour indiquer les
+reprises. Voyez à ce sujet @ref{Repeats}.
+
+
+@seealso
+
+Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
+
+Référence du programme : @internalsref{BarLine} (faisant partie du
+contexte @internalsref{Staff}), @internalsref{SpanBar} (sur plusieurs
+portées).
+
+D'autres exemples : @inputfileref{input/@/test,bar@/-lines@/.ly},
+
+
+@node Unmetered music
+@subsection Unmetered music
+
+@cindex cadenza
+@funindex \cadenzaOn
+@funindex \cadenzaOff
+
+
+Les barres de mesure et les chiffres de mesure sont calculés
+automatiquement, ce qui n'est pas souhaitable dans la musique non
+mesurée --- les cadences, par exemple. Les commandes @code{\cadenzaOn}
+and @code{\cadenzaOff} permettent de désactiver et de rétablir la
+métrique automatique.
+
+@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
+c4 d e d
+\cadenzaOn
+c4 c d8 d d f4 g4.
+\cadenzaOff
+\bar "|"
+d4 e d c
+@end lilypond
+
+
+@refbugs
+
+
+LilyPond ne change de ligne ou de page qu'au niveau des barres de
+mesure. Si votre musique non mesurée dure plus d'une ligne, il vous
+faudra insérer des barres de mesure invisibles, pour indiquer à quels
+endroit un changement de ligne peut intervenir.
+
+@example
+\bar ""
+@end example
+
+@noindent
+
+
+@node System start delimiters
+@subsection System start delimiters
+
+@cindex start of system
+@cindex Staff, multiple
+@cindex bracket, vertical
+@cindex brace, vertical
+@cindex grand staff
+@cindex staff group
+@cindex staff, choir
+
+
+De nombreuses partitions sont écrites sur plus d'une portée. Ces
+portées peuvent être regroupées de quatre manières différentes.
+
+@itemize @bullet
+@item Le groupe de portées est attaché par une accolade sur la gauche,
+et les barres de mesure sont d'un seul tenant. Il s'agit du contexte
+@internalsref{GrandStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new GrandStaff
+\relative <<
+ \new Staff { c1 c }
+ \new Staff { c c }
+>>
+@end lilypond
+
+@item Le groupe de portées est attaché par un crochet, et les barres
+de mesure sont d'un seul tenant. Il s'agit du contexte
+@internalsref{StaffGroup}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new StaffGroup
+\relative <<
+ \new Staff { c1 c }
+ \new Staff { c c }
+>>
+@end lilypond
+
+
+
+@item Le groupe de portées est attaché par un crochet, mais les barres
+de mesure sont séparées d'une portée à l'autre. Il s'agit du contexte
+@internalsref{ChoirStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new ChoirStaff
+\relative <<
+ \new Staff { c1 c }
+ \new Staff { c c }
+>>
+@end lilypond
+
+@item Les portées du groupe ne sont pas attachées (à part par une
+simple ligne verticale). Les barres de mesure sont détachées. Il
+s'agit de l'assemblage par défaut.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative <<
+ \new Staff { c1 c }
+ \new Staff { c c }
+>>
+@end lilypond
+@end itemize
+
+
+@seealso
+
+
+Pour les barres de mesure au début de chaque système, voir
+@internalsref{SystemStartBar}, @internalsref{SystemStartBrace}, et
+@internalsref{SystemStartBracket}. Dans chaque contexte, seul l'un de
+ces styles est utilisé, et c'est la propriété
+@internalsref{systemStartDelimiter} qui détermine lequel.
+
+
+@node Staff symbol
+@subsection Staff symbol
+
+@cindex adjusting staff symbol
+
+Les notes, les symboles dynamiques, etc. sont regroupés dans un
+assemblage de lignes horizontales, que l'on nomme la portée (en
+anglais qq{staff}}, et @qq{staves} au pluriel). Dans LilyPond, ces lignes
+sont dessinées au moyen d'un objet de mise en forme à part entière,
+nommé @code{staff symbol}.
+
+
+L'aspect du @code{staff symbol} peut être modifié selon différentes
+propriétés, telles que le nombre de lignes, leur épaisseur, ou leur
+éloignement. Vous en trouverez des exemples dans
+@inputfileref{input/@/test,staff@/-lines@/.ly}
+et
+@inputfileref{input/@/test,staff@/-size@/.ly}.
+
+
+De plus, les portées peuvent commencer et s'arrêter où l'on veut,
+grâce aux commandes @code{\startStaff} et @code{\stopStaff}.
+
+@lilypond[verbatim,relative=2,fragment]
+b4 b
+\override Staff.StaffSymbol #'line-count = 2
+\stopStaff \startStaff
+b b
+\revert Staff.StaffSymbol #'line-count
+\stopStaff \startStaff
+b b
+@end lilypond
+
+
+Cette manière de procéder peut être utilisée pour introduire des
+@qq{ossias} dans des partitions à nombre de portées variable,
+comme sur l'exemple suivant :
+
+@cindex ossia
+
+@lilypondfile{ossia.ly}
+
+@cindex staff lines, setting number of
+@cindex staff lines, setting thickness of
+@cindex thickness of staff lines, setting
+@cindex number of staff lines, setting
+
+@seealso
+
+Référence du programme : @internalsref{StaffSymbol}.
+
+D'autres exemples : @inputfileref{input/@/test,staff@/-lines@/.ly},
+@inputfileref{input/@/test@/,ossia.ly},
+@inputfileref{input/@/test,staff@/-size@/.ly},
+@lsr{staff,staff-line-positions.ly}
+
+@node Writing music in parallel
+@subsection Writing music in parallel
+
+@cindex Writing music in parallel
+@cindex Interleaved music
+
+On peut écrire plusieurs voix de façon entremêlée :
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+ r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c'' e''] |
+ c'2 c'2 |
+ r8 a'16[ d''] f''[ a' d'' f''] r8 a'16[ d''] f''[ a' d'' f''] |
+ c'2 c'2 |
+}
+\new StaffGroup <<
+ \new Staff \new Voice \voiceA
+ \new Staff \new Voice \voiceB
+>>
+@end lilypond
+
+
+
+@node Connecting notes
+@section Connecting notes
+De la notation qui affecte des groupes de notes.
+
+@menu
+* Ties::
+* Slurs::
+* Phrasing slurs::
+* Laissez vibrer ties::
+* Automatic beams::
+* Manual beams::
+* Grace notes::
+@end menu
+
+
+@node Ties
+@subsection Ties
+
+@cindex tie
+@funindex ~
+
+Une liaison de tenue (ou de prolongation) relie deux notes adjacentes
+de même hauteur. Dans les faits, une liaison de tenue prolonge la
+durée d'une note, et ne doit donc pas être confondue avec les liaisons
+d'articulation ou de phrasé. Une liaison de tenue est indiquée au
+moyen du symbole appelé tilde @samp{~}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+e' ~ e' <c' e' g'> ~ <c' e' g'>
+@end lilypond
+
+
+Quand une liaison de tenue se trouve entre deux accords, toutes les
+notes de même hauteur entre ces deux accords seront reliées. S'il n'y
+en a aucune, aucune liaison ne sera créée. Il est également possible
+de lier partiellement deux accords, en mettant la liaison à
+l'intérieur des accords.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+<c~ e g~ b> <c e g b>
+@end lilypond
+
+
+Une liaison de tenue est un moyen parmi d'autres de prolonger la durée
+d'une note, tout comme les notes pointées. L'exemple suivant montre
+deux manières de noter exactement la même idée :
+
+
+@lilypond[quote,fragment,ragged-right]
+\time 3/4 c'2. c'2 ~ c'4
+@end lilypond
+
+@noindent
+
+Les liaisons de tenues sont utilisées soit quant la note dépasse de la
+mesure, ou quand les points ne suffisent pas à rendre le bon rythme.
+Lorsque l'on utilise ces liaisons, les valeurs rythmiques les plus
+longues doivent s'aligner sur les subidivisions de la mesure, comme
+ici :
+
+@lilypond[fragment,quote,ragged-right]
+\relative {
+ r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
+}
+@end lilypond
+
+
+Lorsque l'on doit lier de nombreuses notes sur plusieurs mesures, il
+devient plus facile d'avoir recours à la division automatique des
+notes (voir @ref{Automatic note splitting}). Ce procédé divise
+automatiquement les notes trop longues, et les lie par-delà les barres
+de mesure.
+
+@funindex \repeatTie
+
+
+Lorsque l'indication @q{2.} d'une reprise commence sur une note liée, la
+liaison doit être répétée. C'est à cela que sert la commande
+@code{\repeatTie}.
+
+@lilypond[fragment,quote,ragged-right,relative=2]
+r <c e g>\repeatTie
+@end lilypond
+
+@cindex repeating ties
+@cindex volta brackets and ties
+
+@commonprop
+
+
+Les liaisons de tenues servent parfois à rendre un accord arpégé. Dans
+ce cas, les notes liées ne sont pas toutes l'une contre l'autre. Il
+faut alors définir comme vraie (@q{t} pour @q{true}) la propriété
+@code{tieWaitForNote}. Cette même méthode peut servir, par exemple, à
+lier un trémolo à un accord :
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+\set tieWaitForNote = ##t
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat "tremolo" 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
+@end lilypond
+
+
+@refcommands
+
+
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
+
+
+@seealso
+
+Dans ce même manuel : @ref{Automatic note splitting}.
+
+Référence du programme : @internalsref{Tie}.
+
+
+
+@refbugs
+
+
+Un changement de portée, lorsqu'une liaison de tenue est active, ne
+peut produire une liaison oblique.
+
+Il n'est pas vraiment possible de changer de clé ou d'octave écrite
+pendant une liaison de tenue. Dans ces cas-là, il peut être plus
+judicieux d'utiliser un legato.
+
+@node Slurs
+@subsection Slurs
+
+@cindex Slurs
+
+
+Une liaison d'articulation indique que les notes doivent être
+jouées liées, ou @emph{legato}. Ces liaisons s'indiquent au moyen de
+parenthèses.
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+f( g a) a8 b( a4 g2 f4)
+<c e>2( <b d>2)
+@end lilypond
+
+
+Il est possible d'indiquer l'orientation de la liaison, avec
+@code{\slur@emph{DIR}}, @code{@emph{DIR}} pouvant être soit @code{Up}
+pour une liaison vers le haut, @code{Down} pour une liaison vers le
+bas, ou encore @code{Neutral} pour laisser LilyPond décider.
+
+
+Cependant, il existe un raccourci pratique pour obliger les
+liaisons à s'orienter dans tel ou tel sens. Il suffit pour cela
+d'ajouter @code{_} ou @code{^} avant d'ouvrir une parenthèse. Ainsi,
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_( c) c^( c)
+@end lilypond
+
+
+Une seule liaison d'articulation peut être imprimée à la fois.
+S'il est nécessaire d'imprimer une liaison plus longue, englobant
+des liaisons plus courtes, il faudra utiliser des @ref{Phrasing slurs}.
+
+
+@commonprop
+
+
+Certains auteurs utilisent deux liaisons lorsqu'ils veulent
+lier des accords. Dans LilyPond, il faut pour cela définir comme
+vraie (@q{true}) la propriété @code{doubleSlurs} :
+
+@lilypond[verbatim,ragged-right,relative,fragment,quote]
+\set doubleSlurs = ##t
+<c e>4 ( <d f> <c e> <d f> )
+@end lilypond
+
+
+@refcommands
+
+@funindex \slurUp
+@code{\slurUp},
+@funindex \slurDown
+@code{\slurDown},
+@funindex \slurNeutral
+@code{\slurNeutral},
+@funindex \slurDashed
+@code{\slurDashed},
+@funindex \slurDotted
+@code{\slurDotted},
+@funindex \slurSolid
+@code{\slurSolid}.
+
+@seealso
+
+Référence du programme : @seeinternals{Slur}.
+
+
+@node Phrasing slurs
+@subsection Phrasing slurs
+
+@cindex phrasing slurs
+@cindex phrasing marks
+
+
+Les liaisons de phrasé relient plusieurs notes et délimitent une
+phrase musicale. On indique leut point de départ et d'arrivée avec
+@code{\(} et @code{\)} respectivement.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+\time 6/4 c'\( d( e) f( e) d\)
+@end lilypond
+
+
+D'un point de vue typographique, rien ne distingue une liaison de
+phrasé d'une liaison d'articulation. Cependant, LilyPond les
+considère comme des objets différents. Une commande @code{\slurUp}
+n'affectera donc pas une liaison de phrasé : il faut plutôt utiliser
+@code{\phrasingSlurUp}, @code{\phrasingSlurDown} ou
+@code{\phrasingSlurNeutral}.
+
+
+Il n'est pas possible d'avoir plusieurs liaisons de phrasé en même temps.
+
+@refcommands
+
+@funindex \phrasingSlurUp
+@code{\phrasingSlurUp},
+@funindex \phrasingSlurDown
+@code{\phrasingSlurDown},
+@funindex \phrasingSlurNeutral
+@code{\phrasingSlurNeutral}.
+
+
+@seealso
+
+Référence du programme : @internalsref{PhrasingSlur}.
+
+
+@node Laissez vibrer ties
+@subsection Laissez vibrer ties
+@cindex Laissez vibrer
+@cindex Ties, laissez vibrer
+
+
+Les liaisons @qq{Laissez vibrer} (L.V.) sont utilisées pour
+le piano, la harpe, et certains instruments de percussion. Elles
+indiquent à l'instrumentiste de laisser sonner la note au lieu de
+l'étouffer. Cet effet s'obtient avec la commande
+@code{\laissezVibrer}.
+
+@lilypond[fragment,ragged-right,verbatim,relative=1]
+<c f g>\laissezVibrer
+@end lilypond
+
+@seealso
+
+Référence du programme :
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+D'autres exemples :
+@lsr{connecting,laissez-vibrer-ties.ly}
+
+@node Automatic beams
+@subsection Automatic beams
+
+
+LilyPond décide automatiquement de la manière de grouper les notes et
+d'imprimer les ligatures
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
+@end lilypond
+
+Lorsque ces décisions ne sont pas satisfaisantes, il est
+possible de préciser quels groupements l'ont veut, ou même de définir
+des séquences de groupements en lieu et place des groupements
+par défaut. Voir @ref{Setting automatic beam behavior}
+pour plus de détails.
+
+
+La commande @code{\noBeam} peut servir à empêcher des notes
+individuelles d'être rattachées aux autres.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c\noBeam c c
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Beam}.
+
+
+@node Manual beams
+@subsection Manual beams
+
+@cindex beams, manual
+@funindex ]
+@funindex [
+
+
+Dans certaines situations, il peut s'avérer nécessaire de
+supplanter l'algorithme de groupement automatique des notes, par
+exemple pour prolonger une ligature par-dessus un silence ou une barre
+de mesure. Le début et la fin de la ligature sont alors indiqués par
+@code{[} et @code{]}.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+ r4 r8[ g' a r8] r8 g[ | a] r8
+}
+@end lilypond
+
+
+@commonprop
+
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
+
+
+En principe, les sous-groupements à l'intérieur d'un groupe de notes
+sont déterminés automatiquement. Cependant, les propriétés
+@code{stemLeftBeamCount} et @code{stemRightBeamCount} peuvent
+servir à contourner ce comportement. Lorsque l'une ou l'autre de
+ces propriétés est définie, elle ne s'applique qu'une seule fois,
+après quoi sa définition est effacée.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+ f8[ r16
+ f g a]
+ f8[ r16
+ \set stemLeftBeamCount = #1
+ f g a]
+}
+@end lilypond
+
+
+La propriété @code{subdivideBeams} sert à grouper les double-croches
+ou les valeurs plus brèves pulsation par pulsation, la pulsation
+étant définie par la propriété @code{beatLength}.
+
+@lilypond[fragment,quote,relative=2,verbatim]
+c16[ c c c c c c c]
+\set subdivideBeams = ##t
+c16[ c c c c c c c]
+\set Score.beatLength = #(ly:make-moment 1 8)
+c16[ c c c c c c c]
+@end lilypond
+@funindex subdivideBeams
+
+@noindent
+Pour plus d'information sur @code{make-moment}, voir
+@ref{Time administration}.
+
+
+Lorsqu'une ligature entre des notes franchit une barre de mesure,
+le retour à la ligne est en principe interdit à cet endroit.
+Ce comportement peut être changé en définissant @code{breakable}.
+
+@funindex breakable
+@cindex beams and line breaks
+@cindex beams, kneed
+@cindex kneed beams
+@cindex auto-knee-gap
+
+
+@refbugs
+
+
+LilyPond insère automatiquement des ligatures d'orientation double
+(certaines notes vers le haut, d'autres vers le bas) lorsqu'il
+détecte un espace important entre des têtes de notes. Ce
+comportement peut être changé en paramétrant l'objet.
+
+
+Les ligatures d'orientation double à cheval sur deux portées
+ne peuvent être employées lorsque l'une des portées est invisible.
+Voir @ref{Hiding staves}.
+
+
+Les ligatures peuvent entrer en collision avec des symboles entourant
+les notes, contrairement aux textes ou aux altérations.
+
+
+@node Grace notes
+@subsection Grace notes
+
+@funindex \grace
+@cindex ornaments
+@cindex grace notes
+@cindex appoggiatura
+@cindex acciaccatura
+
+
+Les petites notes sont des ornements entièrement écrits. Les plus
+courantes sont les accacciatures, qui doivent se jouer très vite,
+et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
+et liée. L'appoggiature est une petite note non barrée, qui vole
+une fraction de la durée de la note réelle qui la suit.
+
+Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
+et @code{\appoggiatura}, comme le montre l'exemple suivant :
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+b4 \acciaccatura d8 c4 \appoggiatura e8 d4
+\acciaccatura { g16[ f] } e4
+@end lilypond
+
+
+Ce sont là deux formes spéciales de la commande @code{\grace}, qui
+prend en charge toutes les petites notes. Si on la fait suivre
+d'une expression musicale, un groupe de petites notes sera créé,
+sans impact sur le reste de la métrique.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+c4 \grace c16 c4
+\grace { c16[ d16] } c2 c4
+@end lilypond
+
+@noindent
+Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la
+commande @code{\grace} n'entame pas de liaison.
+
+La durée des petites notes est interprétée par le programme en
+fonction d'une deuxième commande @code{\grace} indiquant la durée
+sous forme de deux nombres rationnels : le premier indique le rythme
+réel, le second indique le rythme des petites notes. Reprenons
+l'exemple ci-dessus en y ajoutant ces couples de nombres :
+
+@lilypond[quote,ragged-right]
+<<
+ \relative c''{
+ c4 \grace c16 c4 \grace {
+ c16[ d16] } c2 c4
+ }
+ \new Lyrics \lyricmode {
+ \override LyricText #'font-family = #'typewriter
+
+ \markup { (0,0) } 4
+ \grace { \markup {
+ ( \fraction 1 4 , \fraction -1 16 ) } 16 }
+ \markup { (\fraction 1 4 , 0 ) } 4
+ \grace {
+ \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
+ \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
+ }
+ \markup { ( \fraction 2 4 , 0 ) }
+ }
+>>
+@end lilypond
+
+
+Les petites notes se placent de façon synchrone entre les différentes
+portées. Dans l'exemple suivant, il y a deux petites double-croches
+pour chaque petite croche.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \grace { c16[ d e f] } e4 }
+ \new Staff { c4 \grace { g8[ b] } c4 } >>
+@end lilypond
+
+@funindex \afterGrace
+
+
+La commande @code{\afterGrace} sert à placer une petite note après
+une note réelle --- et non @emph{avant} comme d'ordinaire.
+Cette commande requiert deux arguments : la note réelle, et la ou les
+petites notes qui suivent.
+
+@lilypond[ragged-right, verbatim,relative=2,fragment]
+c1 \afterGrace d1 { c16[ d] } c4
+@end lilypond
+
+
+Les petites notes se placent alors à 3/4 de la durée de la note
+réelle. Cet espacement peut être changé en définissant
+@code{afterGraceFraction} ; ainsi,
+
+@example
+afterGraceFraction = #(cons 7 8)
+@end example
+
+@noindent
+placera la petite note à 7/8 de la note réelle.
+
+On peut obtenir le même effet manuellement, de la façon suivante :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+ << { d1^\trill_( }
+ { s2 \grace { c16[ d] } } >>
+ c4)
+}
+@end lilypond
+
+@noindent
+
+Le silence invisible peut être plus ou moins long (ici c'est une
+blanche) afin d'ajuster l'espace entre la note réelle et les petites
+notes.
+
+Tout ce qui est introduit par @code{\grace} obéit à des règles
+typographiqes particulières, notamment pour règler l'orientation
+et la taille des objets. De ce fait, toute subtilité de mise en
+forme devra être indiquée @emph{à l'intérieur} de la section
+introduite par @code{\grace} :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+ \acciaccatura {
+ \stemDown
+ f16->
+ \stemNeutral
+ }
+ g4
+}
+@end lilypond
+
+@noindent
+Tous les réglages ajoutés doivent également être désactivés dans cette
+même section.
+
+Il est possible de changer la mise en forme de toutes les petites
+notes dans un morceau, au moyen de la fonction
+@code{add-grace-property}. Ici, par exemple, l'on ôte la définition
+de l'orientation des objets @code{Stem} pour toutes les petites notes,
+afin que les hampes ne soient pas toujours orientées vers le haut.
+
+@example
+\new Staff @{
+ #(add-grace-property 'Voice 'Stem 'direction '())
+ @dots{}
+@}
+@end example
+
+@noindent
+Il est par ailleurs possible de chager les variables
+@code{startGraceMusic}, @code{stopGraceMusic},
+@code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
+@code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
+Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
+
+@noindent
+Le trait que l'on trouve sur les hampes des accacciatures peut
+s'appliquer dans d'autres situations en définissant
+@code{\override Stem #'stroke-style = #"grace"}.
+
+
+@commonprop
+
+
+Il est possible de forcer un espacement fluctuant des notes d'agrément.
+
+@lilypond[relative=2,ragged-right]
+<<
+ \override Score.SpacingSpanner #'strict-grace-spacing = ##t
+ \new Staff {
+ c'4
+ \afterGrace
+ c'4
+ { c'16[ c'8 c'16] }
+ c'4
+ }
+ \new Staff {
+ c'16[ c'16 c'16 c'16]
+ c'16[ c'16 c'16 c'16]
+ c'4
+ }
+>>
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{GraceMusic}.
+
+
+@refbugs
+
+Une partition commençant par une section @code{\grace} doit faire
+intervenir la commande @code{\new Voice}, sans quoi la note réelle et
+la petite note se retrouveront sur des portées différentes.
+
+
+La synchronisation des petites notes se fait de façon parfois
+surprenante, car les autres objets de la portée --- barres de mesure,
+armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
+mélez des portées comprenant des petites notes et d'autres sans :
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+ \new Staff { c4 \bar "|:" d4 } >>
+@end lilypond
+
+@noindent
+Il est possible de remédier à cela en insérant des silences invisibles
+correspondant aux durées des petites notes sur les autres portées ---
+les silences invisibles peuvent également être considérés comme des
+petites notes, s'ils suivent la commande @code{grace}.
+
+@example
+\new Staff @{ c4 \bar "|:" \grace s16 d4 @}
+@end example
+
+
+Les sections de petites notes ne doivent être utilisées que dans des
+expressions musicales linéaires ; il n'est pas possible d'enchâsser
+ni de juxtaposer des sections de petites notes, faute de quoi le
+traitement du code peut échouer ou produire des erreurs.
+
+
+@node Expressive marks
+@section Expressive marks
+
+
+Les indications d'expression permettent aux interprètes de faire en
+sorte que la musique soit plus qu'un assemblage de notes et de rythmes.
+
+
+@menu
+* Articulations::
+* Fingering instructions::
+* Dynamics::
+* Breath marks::
+* Trills::
+* Glissando::
+* Arpeggio::
+* Falls and doits::
+@end menu
+
+
+@node Articulations
+@subsection Articulations
+
+@cindex Articulations
+@cindex scripts
+@cindex ornaments
+
+
+Différents symboles peuvent être ajoutés au-dessus ou au-dessous des
+notes pour indiquer des ponctuations ou des modes de jeu différents.
+On les ajoute à chaque note au moyen d'un tiret suivi du caractère
+correspondant à l'articulation désirée. En voici une démonstration :
+
+@lilypondfile[quote,ragged-right]{script-abbreviations.ly}
+
+
+Il est possible de changer la signification de ces raccourcis : voir
+@file{ly/@/script@/-init@/.ly} pour quelques exemples.
+
+
+Même si LilyPond place automatiquement ces symboles, il est
+possible de l'obliger à les placer en-dessus ou en-dessous de la note,
+tout comme d'autres objets, en utilisant respectivement dans le code
+@code{_} et @code{^}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c''4^^ c''4_^
+@end lilypond
+
+
+On peut ajouter d'autres symboles, avec la syntaxe
+@var{note}@code{\}@var{symbole}. Là encore, on peut les forcer
+en bas ou en haut, avec @code{^} and @code{_}. Ainsi :
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\fermata c^\fermata c_\fermata
+@end lilypond
+
+@cindex accent
+@cindex marcato
+@cindex staccatissimo
+@cindex espressivo
+@cindex fermata
+@cindex stopped
+@cindex staccato
+@cindex portato
+@cindex tenuto
+@cindex upbow
+@cindex downbow
+@cindex foot marks
+@cindex organ pedal marks
+@cindex turn
+@cindex open
+@cindex flageolet
+@cindex reverseturn
+@cindex trill
+@cindex prall
+@cindex mordent
+@cindex prallprall
+@cindex prallmordent
+@cindex prall, up
+@cindex prall, down
+@cindex mordent
+@cindex thumb marking
+@cindex segno
+@cindex coda
+@cindex varcoda
+
+
+Voici la liste exhaustive de tous les symboles possibles :
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+@commonprop
+
+Les symboles s'ordonnent verticalement suivant la propriété
+@code{script-priority}. Plus le nombre qui la définit est faible, plus
+le symbole se rapprochera de la note. Dans l'exemple suivant, l'objet
+@internalsref{TextScript} --- le dièse --- a d'abord la propriété la
+plus basse, et il est donc placé plus près de la note ; ensuite c'est
+l'objet @internalsref{Script} qui a la propriété la plus basse,
+et il se place alors sous le dièse. Lorsque deux objets ont la même
+propriété, c'est l'ordre dans lequel ils sont indiqués qui détermine
+lequel sera placé en premier.
+
+@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
+\once \override TextScript #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+
+\once \override Script #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Script}.
+
+
+@refbugs
+
+
+Ces symboles sont présents sur la partition imprimée, mais
+n'ont pas d'effet sur le rendu sonore de la musique en MIDI.
+
+
+@node Fingering instructions
+@subsection Fingering instructions
+
+@cindex fingering
+@cindex finger change
+
+
+Les doigtés peuvent être indiqués comme suit :
+@example
+@var{note}-@var{chiffre_du_doigt}
+@end example
+Pour les substitutions de doigts, on a recours à une indication
+textuelle (commande @code{\markup}) de doigté
+(commande @code{\finger} :
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+c4-1 c-2 c-3 c-4
+c^\markup { \finger "2 - 3" }
+@end lilypond
+
+
+La commande @{\thumb} peut être utilisée pour indiquer, par exemple
+dans une partition de violoncelle, si une note doit être jouée
+avec le pouce (@q{thumb} en anglais) :
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+<a_\thumb a'-3>8 <b_\thumb b'-3>
+@end lilypond
+
+
+Les doigtés des accords peuvent être saisis note par note,
+en les indiquant après chaque hauteur de note :
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+< c-1 e-2 g-3 b-5 >4
+@end lilypond
+
+
+@commonprop
+
+On peut contrôler précisément les doigtés des accords en réglant
+la propriété @code{fingeringOrientations} :
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+\set fingeringOrientations = #'(left down)
+<c-1 es-2 g-4 bes-5 > 4
+\set fingeringOrientations = #'(up right down)
+<c-1 es-2 g-4 bes-5 > 4
+@end lilypond
+
+
+Cette propriété permet également, dans de la musique monophonique,
+d'indiquer des doigtés très proches des têtes de notes.
+
+@lilypond[verbatim,ragged-right,quote,fragment]
+\set fingeringOrientations = #'(right)
+<es'-2>4
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Fingering}.
+
+D'autres exemples : @lsr{expressive,fingering-chords.ly}.
+
+
+@node Dynamics
+@subsection Dynamics
+
+@cindex Dynamics
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
+
+
+À chaque nuance absolue correspond une commande, qui peut être
+indiquée après une note : @code{c4\ff} par exemple.
+Les commandes de nuances disponibles sont
+@code{\ppppp}, @code{\pppp}, @code{\ppp},
+@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f},
+@code{\ff}, @code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf},
+@code{\sff}, @code{\sp}, @code{\spp}, @code{\sfz}, et @code{\rfz}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
+c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
+@end lilypond
+
+@funindex \<
+@funindex \>
+@funindex \!
+
+
+Un crescendo est délimité par @code{\<} et @code{\!}, ou peut se
+terminer par une commande de nuance. Au lieu de @code{\<}
+ou @code{\>}, on peut aussi utiliser @code{\cr} et @code{\decr}.
+Ces indications sont attachées aux notes ; aussi si l'on veut
+faire se succéder plusieurs nuances pendant une note tenue, il faudra
+avoir recours à des silences invisibles :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\< c\! d\> e\!
+<< f1 { s4 s4\< s4\! \> s4\! } >>
+@end lilypond
+
+@noindent
+
+En principe, un crescendo --- s'il est imprimé sous forme graphique --
+commence au bord gauche de la note de départ, et se termine au
+bord droit de la note d'arrivée. Cependant, si la note d'arrivée
+est sur un premier temps, le crescendo s'arrêtera au niveau de la
+barre de mesure qui la précède. Ce comportement peut être annulé
+en définissant comme fausse (lettre @q{f}) la propriété
+@code{hairpinToBarline} :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set hairpinToBarline = ##f
+c4\< c2. c4\!
+@end lilypond
+
+@c VERIF sens de soufflet
+On peut avoir recours à l'indication @code{\espressivo} pour
+indiquer un @qq{soufflet} --- crescendo puis decrescendo --- sur
+une seule note.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c2 b4 a g1\espressivo
+@end lilypond
+
+
+Cependant, ces deux indications graphiques peuvent se trouver
+très comprimées. Pour les rallonger, on peut modifier la propriété
+@code{minimum-length} dans @internalsref{Voice}.@internalsref{Hairpin}
+--- @internalsref{Voice} étant le contexte, et @internalsref{Hairpin}
+l'objet affecté. Par exemple :
+
+@example
+\override Voice.Hairpin #'minimum-length = #5
+@end example
+
+@cindex al niente
+@cindex niente, al
+
+
+Des crescendos ou decrescendos @qq{al niente} peuvent être indiqués
+de manière graphique, en définissant comme vraie (lettre @q{t}) la
+propriété @code{circled-tip}, ce qui affiche un cercle à leur
+extrémité.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
+@cindex crescendo
+@cindex decrescendo
+@cindex diminuendo
+
+
+Au lieu d'une notation graphique des crescendos, on peu utiliser
+une notation textuelle comme @emph{cresc.} :
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\setTextCresc
+c\< d e f\!
+\setHairpinCresc
+e\> d c b\!
+\setTextDecresc
+c\> d e f\!
+\setTextDim
+e\> d c b\!
+@end lilypond
+
+
+On peut même ajouter ses propres indications textuelles :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\set crescendoText = \markup { \italic "cresc. poco" }
+\set crescendoSpanner = #'dashed-line
+a'2\< a a a\!\mf
+@end lilypond
+
+
+Pour créer des indications de nuances qui restent alignées
+avec les nuances habituelles, voir @ref{New dynamic marks}.
+
+Le positionnement vertical des nuances est géré par
+@internalsref{DynamicLineSpanner}.
+
+@commonprop
+
+
+Des nuances différentes situées --- ou commençant --- sur une même
+note seront alignées verticalement. Pour aligner des nuances qui ne
+se situeraient pas sur une même note, il est possible d'augmenter
+la propriété @code{staff-padding}.
+
+@example
+\override DynamicLineSpanner #'staff-padding = #4
+@end example
+
+
+Cette propriété peut aussi servir à régler des problèmes de
+collisions entre des nuances et d'autres objets.
+
+
+Les crescendos ou decrescendos qui aboutissent sur la première note
+d'une nouvelle ligne ne sont imprimés que jusqu'à la fin de la ligne
+précédente. Ce comportement peut être outrepassé en définissant :
+
+@example
+\override Score.Hairpin #'after-line-breaking = ##t
+@end example
+
+
+Les crescendos et decrescendos indiqués textuellement --- tels que
+@emph{cresc.} ou @emph{dim.} --- sont suivis de pointillés qui montrent
+leur étendue. On peut empêcher l'impression de ces pointillés avec :
+
+@example
+\override DynamicTextSpanner #'dash-period = #-1.0
+@end example
+
+
+@refcommands
+
+@funindex \dynamicUp
+@code{\dynamicUp},
+@funindex \dynamicDown
+@code{\dynamicDown},
+@funindex \dynamicNeutral
+@code{\dynamicNeutral}.
+
+
+@seealso
+
+Référence du programme : @internalsref{DynamicText}, @internalsref{Hairpin}.
+
+Le placement vertical de ces éléments graphiques est géré par le
+@internalsref{DynamicLineSpanner}.
+
+
+@node Breath marks
+@subsection Breath marks
+
+
+Les indications de respiration sont indiquées par la commande @code{\breathe}.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c'4 \breathe d4
+@end lilypond
+
+
+@commonprop
+
+
+On peut choisir le glyphe imprimé par cette commande, en
+modifiant la propriété @code{text} relative à l'objet
+@code{BreathingSign} pour lui affecter n'importe quelle indication.
+Par exemple :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+c'4
+\override BreathingSign #'text
+ = #(make-musicglyph-markup "scripts.rvarcomma")
+\breathe
+d4
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{BreathingSign}.
+
+D'autres exemples : @inputfileref{input/@/regression,breathing@/-sign@/.ly}.
+
+
+@node Trills
+@subsection Trills
+
+Les trilles brefs s'indiquent comme n'importe quelle ponctuation :
+voir @ref{Articulations}.
+
+
+Les trilles plus longs sont délimités par @code{\startTrillSpan} et
+@code{\stopTrillSpan} :
+
+@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
+\new Voice {
+ << { c1 \startTrillSpan }
+ { s2. \grace { d16[\stopTrillSpan e] } } >>
+ c4 }
+@end lilypond
+
+@cindex Pitched trills
+
+
+Les trilles qui font intervenir une hauteur précise peuvent être
+indiqués par la commande @code{pitchedTrill}.
+
+@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
+\pitchedTrill c4\startTrillSpan fis
+f\stopTrillSpan
+@end lilypond
+
+
+La premier argument est la note réelle ; le second est une
+hauteur qui sera imprimée entre parenthèses et sans hampe.
+
+
+@refcommands
+
+@code{\startTrillSpan},
+@funindex \startTrillSpan
+@code{\stopTrillSpan}.
+@funindex \stopTrillSpan
+
+
+@seealso
+
+Référence du programme : @internalsref{TrillSpanner}.
+
+
+@node Glissando
+@subsection Glissando
+
+@cindex Glissando
+@funindex \glissando
+
+
+Un glissando relie une hauteur à une autre en passant par chaque
+hauteur intermédiaire. Il est indiqué graphiquement, par une ligne ou
+des vaguelettes entre ces deux notes. On l'obtient en accolant la
+commande @code{\glissando} à la première note.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+c2\glissando c'
+\override Glissando #'style = #'zigzag
+c2\glissando c,
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Glissando}.
+
+D'autres exemples : @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}.
+
+
+@refbugs
+
+
+Il n'est pas possible d'imprimer un texte (tel que @emph{gliss.})
+sur la ligne de glissando.
+
+@node Arpeggio
+@subsection Arpeggio
+
+@cindex Arpeggio
+@cindex broken chord
+@funindex \arpeggio
+
+
+On peut indiquer qu'un accord doit être arpégé en lui accolant la
+commande @code{\arpeggio} :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+<c e g c>\arpeggio
+@end lilypond
+
+
+Pour spécifier qu'un autre accord doit être joué plaqué et non
+arpégé, on peut remplacer ce signe par un crochet :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\arpeggioBracket
+<c' e g c>\arpeggio
+@end lilypond
+
+
+Le sens de l'arpège est parfois indiqué, par une flèche suivant la
+vaguelette :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new Voice {
+ \arpeggioUp
+ <c e g c>\arpeggio
+ \arpeggioDown
+ <c e g c>\arpeggio
+}
+@end lilypond
+
+
+@commonprop
+
+Quand un arpège se lit sur plusieurs portées, il est possible
+d'indiquer l'arpège sur chacune des portées, puis de relier la
+ligne de vaguelettes en définissant comme vraie la propriété
+@code{connectArpeggios}, par exemple dans le contexte
+@internalsref{PianoStaff} :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+ \set PianoStaff.connectArpeggios = ##t
+ \new Staff { <c' e g c>\arpeggio }
+ \new Staff { \clef bass <c,, e g>\arpeggio }
+>>
+@end lilypond
+
+
+@refcommands
+
+@code{\arpeggio},
+@funindex \arpeggioUp
+@code{\arpeggioUp},
+@funindex \arpeggioDown
+@code{\arpeggioDown},
+@funindex \arpeggioNeutral
+@code{\arpeggioNeutral},
+@funindex \arpeggioBracket
+@code{\arpeggioBracket}.
+
+
+@seealso
+
+Dans ce même manuel : @ref{Ties}, pour d'autres notations des
+arpèges.
+
+Référence du programme : @internalsref{Arpeggio}.
+
+
+@refbugs
+
+Il est impossible de mêler au même moment, dans un contexte
+@internalsref{PianoStaff}, des lignes d'arpèges
+connectées et d'autres non connectées.
+
+@node Falls and doits
+@subsection Falls and doits
+
+
+Des indications de désinence peuvent être obtenues au moyen de la
+commande @code{\bendAfter} :
+
+@lilypond[fragment,ragged-right,relative=2]
+\override Score.SpacingSpanner #'shortest-duration-space = #3.0
+c4-\bendAfter #+5
+c4-\bendAfter #-3
+@end lilypond
+
+
+@node Repeats
+@section Repeats
+
+
+Une des notions essentielles, dans la musique, est le fait que des
+éléments soient joués plusieurs fois. Il existe de nombreuses façons
+de noter ces reprises.
+
+@menu
+* Repeat types::
+* Repeat syntax::
+* Repeats and MIDI::
+* Manual repeat commands::
+* Tremolo repeats::
+* Tremolo subdivisions::
+* Measure repeats::
+@end menu
+
+
+@node Repeat types
+@subsection Repeat types
+
+@cindex repeats
+@funindex \repeat
+
+On peut indiquer des répétitions de toutes les façons suivantes :
+
+@table @code
+@item unfold
+La musique qui doit être répétée sera entièrement imprimée (et jouée).
+Ceci est particulièrement utile dans de la musique répétitive. Cette
+reprise est la seule à être prise en compte dans le rendu MIDI.
+
+@item volta
+Le passage répété ne sera pas écrit explicitement, mais il sera
+encadré sur la partition par des barres de reprises, et peut
+se terminer par plusieurs fins alternatives, imprimées de gauche
+à droite sous des crochets. Il s'agit là de la notation courante
+des reprises avec des fins alternatives. Ces dernières, par défaut,
+ne seront pas jouées dans le rendu MIDI.
+
+@item tremolo
+Pour réaliser des trémolos. Ceux-ci, par défaut, ne seront pas
+joués dans le rendu MIDI.
+
+@item percent
+Pour répéter des temps ou des mesures, sous forme de signes de
+pourcentage. Ceux-ci, par défaut, ne seront pas joués dans le rendu
+MIDI. Les répétitions indiquées par ces symboles doivent être
+déclarées dans un contexte @code{Voice}.
+
+@end table
+
+
+@node Repeat syntax
+@subsection Repeat syntax
+
+@cindex volta
+@cindex prima volta
+@cindex seconda volta
+
+Tous les différents types de reprises se spécifient dans
+LilyPond avec une même construction syntaxique, qui est :
+
+
+@example
+\repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{fragment_à_répéter}
+@end example
+
+On peut ajouter, pour indiquer une fin alternative :
+@funindex \alternative
+@example
+\alternative @{
+ @var{alternative1}
+ @var{alternative2}
+ @var{alternative3}
+ @dots{}
+@}
+@end example
+
+@noindent
+chaque @var{alternative} étant une expression musicale. Si l'on donne
+trop peu d'alternatives en regard du nombre de fois où le passage doit
+être rejoué, la première alternative sera jouée plusieurs fois.
+
+
+Les reprises courantes s'indiquent comme ceci :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 { c4 d e f }
+\repeat volta 2 { f e d c }
+@end lilypond
+
+
+Et avec des fins alternatives :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f}
+\alternative { {d2 d} {f f,} }
+@end lilypond
+
+
+Dans l'exemple qui suit, la première fin proposée n'occupe pas une
+mesure complète --- il lui manque un temps. Le quatrième temps
+manquant se trouve au début de la seconde fin, qui compte donc
+un temps en trop --- tout à fait indépendamment du fait que la mélodie
+commence par une anacrouse, comme l'indique la commande @code{\partial}
+au début de l'exemple.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+ \partial 4
+ \repeat volta 4 { e | c2 d2 | e2 f2 | }
+ \alternative { { g4 g g } { a | a a a a | b2. } }
+}
+@end lilypond
+
+@funindex \repeatTie
+Des liaisons de tenue peuvent être ajoutées à toute alternative :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f ~ }
+\alternative { {f2 d} {f\repeatTie f,} }
+@end lilypond
+
+
+On peut raccourcir les crochets indiquant les fins alternatives,
+en définissant la propriété @code{voltaSpannerDuration}. Dans
+l'exemple suivant, le crochet ne se prolonge que sur une mesure
+à 3/4.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c''{
+ \time 3/4
+ c c c
+ \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
+ \repeat "volta" 5 { d d d }
+ \alternative { { e e e f f f }
+ { g g g } }
+}
+@end lilypond
+
+
+@seealso
+
+D'autres exemples :
+
+Les crochets précédant une reprise s'impriment d'ordinaire
+seulement au-dessus de la portée du haut. On peut ajuster cela
+en définissant la propriété @code{voltaOnThisStaff} : voir
+@lsr{repeats,volta@/-multi@/-staff@/.ly}
+
+@refbugs
+
+@cindex repeat, ambiguous
+
+Des reprises enchassées telles que
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+présentent une ambiquïté, dans la mesure où l'on ne sait à quelle
+section @code{\repeat} attribuer la section @code{\alternative}.
+Pour résoudre cette ambiguïté, il convient de toujours insérer
+la commande @code{\alternative} à l'intérieur de la section @code{\repeat}.
+Il est préférable, dans une telle situation,
+d'utiliser des accolades pour plus de clarté.
+
+
+Lorsqu'une alternative commence, les informations de métrique sont
+perdues, il faut donc les rappeler après une reprise, par exemple
+en définissant @code{Score.measurePosition} ou en invoquant la commande
+@code{\partial}. De même, aucune liaison (de tenue ou autre)
+n'est répétée.
+
+Les crochets qui indiquent les alternatives ne sont pas alignés
+verticalement.
+
+
+@node Repeats and MIDI
+@subsection Repeats and MIDI
+
+@cindex expanding repeats
+@funindex \unfoldRepeats
+
+Au prix de quelques réglages, les reprises de toutes sortes peuvent
+être rendues dans le fichier MIDI. Il suffit pour cela d'avoir
+recours à la fonction @code{\unfoldRepeats}, qui rend toutes les
+reprises explicites --- comme celles du type @code{unfold}.
+
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+ \repeat tremolo 8 {c'32 e' }
+ \repeat percent 2 { c''8 d'' }
+ \repeat volta 2 {c'4 d' e' f'}
+ \alternative {
+ { g' a' a' g' }
+ {f' e' d' c' }
+ }
+}
+\bar "|."
+@end lilypond
+
+
+Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour
+le rendu MIDI, il faut établir deux blocs @code{\score} : un pour le
+MIDI, avec des reprises explicites, et l'autre pour la partition, avec
+des reprises notées sous forme de barres de reprises, de trémolos ou
+de symboles de pourcentage. Par exemple
+
+@example
+\score @{
+ @var{..musique..}
+ \layout @{ .. @}
+@}
+\score @{
+ \unfoldRepeats @var{..musique..}
+ \midi @{ .. @}
+@}
+@end example
+
+
+@node Manual repeat commands
+@subsection Manual repeat commands
+
+@funindex repeatCommands
+
+
+La propriété @code{repeatCommands} sert à contrôler la mise en forme
+des reprises. On la définit par une suite de commandes
+Scheme contrôlant les reprises.
+
+@table @asis
+@item @code{start-repeat}
+Pour imprimer une barre de reprise @code{|:}
+
+@item @code{end-repeat}
+Pour imprimer une barre de reprise @code{:|}
+
+@item @code{(volta @var{texte})}
+Pour imprimer un crochet indiquant une alternative. Le texte
+@var{texte} mentionné dans le crochet peut être n'importe quelle
+chaîne de caractères, ou une indication musicale
+--- voir @ref{Text markup}.
+Attention cependant à changer la police : la police employée par défaut
+pour les chiffres ne contient aucun caractère alphabétique.
+
+@item @code{(volta #f)}
+
+Pour terminer un crochet indiquant une alternative.
+@end table
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c4
+ \set Score.repeatCommands = #'((volta "93") end-repeat)
+c4 c4
+ \set Score.repeatCommands = #'((volta #f))
+c4 c4
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic},
+@internalsref{UnfoldedRepeatedMusic}, et
+@internalsref{FoldedRepeatedMusic}.