]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/repeats.itely
Docs: run convert-ly for 2.14.0.
[lilypond.git] / Documentation / fr / notation / repeats.itely
index db5b8853a286d56d331ffbeb2c3aeb8df445bbe1..236f6d70fdb030f6133583230453c3c53d866829 100644 (file)
@@ -1,32 +1,35 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+    Translation of GIT committish: 057106293b07b74b00553fe4dc3dfac5c1f3b682
 
     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
 
-@c \version "2.12.0"
+@c \version "2.14.0"
 
-@c Translators: Valentin Villenave
+@c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
-@node Repeats
-@section Repeats
+@node Répétitions et reprises
+@section Répétitions et reprises
+@translationof Repeats
 
 @lilypondfile[quote]{repeats-headword.ly}
 
 @cindex reprises
 @cindex répétitions
+
 La répétition est une notion essentielle en musique, et il existe de
 nombreuses façons de mettre en œuvre et noter ce concept.  LilyPond
-prend en charge les types de répétition suivants :
+prend en charge les types de répétition suivants@tie{}:
 
 @table @code
 @item volta
-Le passage répété n'est pas développé , mais il est encadré par des
-barres de reprises, et peut se terminer par plusieurs fins
-alternatives --- ou @emph{volte} --- imprimées de gauche à droite sous
+Le passage répété n'est pas développé, mais il est encadré par des
+barres de reprise et peut se terminer par plusieurs fins
+alternatives -- ou @emph{volte} -- imprimées de gauche à droite sous
 des crochets.  Lorsque la répétition commence au début de la pièce,
 aucune barre de reprise n'est gravée au début de la partition.  Il
 s'agit de la notation courante des reprises avec fins alternatives.
@@ -38,177 +41,270 @@ répétitive.
 
 @item percent
 Des barres obliques ou signes de pourcentage indiquent la répétition
-de temps ou de mesures, imprimés sous la forme de signes de
-pourcentage.
+de temps ou de mesures.
 
 @item tremolo
 Ce type permet de réaliser des trémolos sous forme de liens de croches.
+
 @end table
 
 @menu
-* Long repeats::             
-* Other repeats::               
+* Répétition d'un long passage::
+* Autres types de répétition::
 @end menu
 
-@node Long repeats
-@subsection Long repeats
+@node Répétition d'un long passage
+@subsection Répétition d'un long passage
+@translationof Long repeats
 
-Cette section présente la syntaxe des répétitions longues ---
+Cette section présente la syntaxe des répétitions longues --
 c'est-à-dire plusieurs mesures.  Ces répétitions peuvent prendre deux
-formes : encadrées par des barres de reprises, ou bien développées
-dans la partition.  Les barres et autres signe de reprise peuvent être
+formes@tie{}: encadrées par des barres de reprises, ou bien développées
+dans la partition.  Les barres et autres signes de reprise peuvent être
 contrôlés manuellement.
 
 @menu
-* Repeat types::                
-* Repeat syntax::               
-* Manual repeat commands::      
+* Répétitions courantes::
+* Indications de reprise manuelles::
+* Répétitions explicites::
 @end menu
 
-@cindex barres de reprise
-@cindex reprise
-@cindex répétition avec barres de reprise
 @cindex volta
-@cindex fois, pre
+@cindex fois, première
 @cindex première fois
 @cindex seconde fois
+@cindex reprise courante
+@cindex reprise avec alternative
+@cindex fin alternative
+@cindex alternative, reprise
+
 @funindex \repeat
+@funindex \alternative
+@funindex \partial
 
 
-@node Repeat types
-@unnumberedsubsubsec Repeat types
+@node Répétitions courantes
+@unnumberedsubsubsec Répétitions courantes
+@translationof Normal repeats
 
-On peut indiquer des répétitions des façons suivantes :
+On peut indiquer une répétition de la façon suivante@tie{}:
 
-@table @code
-@item bar
-baz
-@end table
-
-@node Repeat syntax
-@unnumberedsubsubsec Repeat syntax
+@example
+\repeat volta @var{nombre_de_fois} @var{expression_musicale}
+@end example
 
-@cindex volta
+@noindent
+où @code{@var{expression_musicale}} représente ce qui doît être répété.
 
-Tous les différents types de reprise se spécifient dans
-LilyPond avec une même construction syntaxique, qui est :
+Les reprises courantes, sans alternative, s'indiquent comme ceci@tie{}:
 
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f }
+c2 d
+\repeat volta 2 { d4 e f g }
+@end lilypond
 
-@example
-\repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{expression_à_répéter}
-@end example
+On peut ajouter une fin alternative à l'aide de la commande
+@code{\alternative}.  Chaque @code{@var{alternative}} est une expression
+musicale en elle-même@tie{}; il faudra donc les regrouper par des
+accolades.
 
-On peut ajouter, pour indiquer une fin alternative :
-@funindex \alternative
 @example
+\repeat volta @var{nombre_de_fois} @var{expression_musicale}
 \alternative @{
- @var{alternative1}
- @var{alternative2}
- @var{alternative3}
- @dots{}
+  @{ @var{expression_musicale} @}
 @}
 @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.
-
+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 :
+Voici une simple reprise avec une fin alternative :
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+}
 c1
-\repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
 @end lilypond
 
-Et avec des fins alternatives :
+Et une répétition avec plusieurs alternatives :
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 3 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+  { a2 g | }
+}
 c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
 @end lilypond
 
-Il est possible de créer des répétitions avec une levée.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 e |
-  \repeat volta 4 { c2 d2 | e2 f2 | }
-  \alternative { { g4 g g e } { a a a a | b2. } }
+@warning{Lorsqu'il y a plus d'une alternative, prenez garde à ce
+qu'aucun caractère n'apparaisse entre l'accolade fermant une alternative
+et l'accolade ouvrant la suivante, au risque de ne pas obtenir le nombre
+voulu d'alternatives.}
+
+@warning{Une clause @code{@bs{}relative} ne doît jamais se trouver à
+l'intérieur d'une section @code{@bs{}repeat}@tie{}: vous aurez
+immanquablement des portées parasites.  Voir
+@rprogram{Apparition d'une portée supplémentaire}.}
+
+@cindex reprise avec levée
+@cindex levée dans une reprise
+@cindex anacrouse et reprise
+@cindex reprise et anacrouse
+
+@funindex \partial
+
+Lorsqu'une reprise sans fins alternatives débute au milieu d'une mesure,
+elle devrait se terminer aussi au milieu d'une mesure, de telle sorte
+que les mesures soient complètes.  En pareil cas, les indications de
+reprise ne constituent pas des barres de mesure à proprement
+parler@tie{}; il n'est donc pas nécessaire de faire appel à la commande
+@code{\partial} ou à des contrôles d'intégrité de mesure.
+
+@lilypond[verbatim,quote,relative=1]
+% no \partial here
+c4 e g  % no bar check here
+% no \partial here
+\repeat volta 4 {
+  e4 |
+  c2 e |
+  % no \partial here
+  g4 g g  % no bar check here
 }
+% no \partial here
+g4 |
+a2 a |
+g1 |
 @end lilypond
 
-@noindent
-ou
+Il est possible de créer des reprises en début de morceau avec une
+levée.  Le cas est similaire à ce que nous venons de voir.  Toutefois,
+l'utilisation d'un @code{\partial} est ici nécessaire pour respecter
+cette entâme.
+
+@lilypond[verbatim,quote,relative=1]
+\partial 4  % required
+\repeat volta 4 {
+  e4 |
+  c2 e |
+  % no \partial here
+  g4 g g  % no bar check here
+}
+% no \partial here
+g4 |
+a2 a |
+g1 |
+@end lilypond
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 
-  \repeat volta 4 { e | c2 d2 | e2 f2 | }
-  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+Lorsqu'une reprise débute par une mesure incomplète et a des fins
+alternatives, il est indispensable d'ajuster manuellement la propriété
+@code{Timing.measureLength} selon les préceptes suivants@tie{}:
+
+@itemize
+@item
+au début de chacune des mesures incomplètes du bloc @code{\alternative},
+ce qui est le cas en principe pour chaque fin d'alternative sauf --
+la plupart du temps -- pour la dernière.
+
+@item
+au début de chaque alternative à l'exception de la première.
+@end itemize
+
+@lilypond[verbatim,quote,relative=1]
+\partial 4
+\repeat volta 2 { e4 | c2 e | }
+\alternative {
+  {
+    f2 d |
+    \set Timing.measureLength = #(ly:make-moment 3 4)
+    g4 g g  % optional bar check is allowed here
+  }
+  {
+    \set Timing.measureLength = #(ly:make-moment 4 4)
+    a2 a |
+  }
 }
+g1 |
 @end lilypond
 
+La propriété @code{measureLength} est abordée plus en détail au chapitre
+@ref{Gestion du temps}.
 
+@cindex reprise et liaison de prolongation
+@cindex alternative et liaison de prolongation
+@cindex liaison de prolongationt et reprise
+@cindex liaison de prolongation et alternative
 
 @funindex \repeatTie
-Des liaisons de tenue peuvent être ajoutées à toute alternative :
 
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+Des liaisons de tenue peuvent être ajoutées à toute alternative@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
 c1
-\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
+\repeat volta 2 { c4 d e f ~ }
+\alternative {
+  { f2 d }
+  { f2\repeatTie f, }
+}
 @end lilypond
 
+@snippets
 
-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.
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{shortening-volta-brackets.ly}
 
-@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
-
-Si l'on souhaite à la fois terminer une ligne par une double barre et
-débuter la ligne suivante avec une section reprise, on peut utiliser
-@example
-@dots{} \bar "||:" \break
-\repeat volta 2 @{ @dots{}
-@end example
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{adding-volta-brackets-to-additional-staves.ly}
 
-Consultez @ref{Bar lines} pour plus d'informations.
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{setting-the-double-repeat-default-for-volte.ly}
 
 
 @seealso
-Program reference: @rinternals{VoltaBracket},
-@rinternals{RepeatedMusic},
-@rinternals{VoltaRepeatedMusic}, et
-@rinternals{UnfoldedRepeatedMusic}.
+Glossaire musicologique :
+@rglosnamed{repeat,répétition},
+@rglos{volta}.
 
+Manuel de notation :
+@ref{Barres de mesure},
+@ref{Modification des greffons de contexte},
+@ref{Gestion du temps}.
 
-Exemples
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
 
-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éplaçant le
-graveur @code{Volta_engraver} vers les contextes de portée
-(@code{Staff}) qui doivent comporter ces crochets ;
-voir @ref{Modifying context plug-ins}, et @rlsr{Repeats}.
+Référence des propriétés internes :
+@rinternals{VoltaBracket},
+@rinternals{RepeatedMusic},
+@rinternals{VoltaRepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
 
 
 @knownissues
 
 @cindex reprises ambigües
+@cindex reprises imbriquées
+@cindex imbrication de reprises
+@cindex numéro de mesure et reprises
+@cindex reprise et liaison
+@cindex liaison et reprise
+
+L'extension d'une liaison à partir d'un bloc @code{\repeat} sur un bloc
+@code{\alternative} n'est possible que pour la première alternative.
+Selon le même principe, une liaison ne saurait partir de la fin d'une
+alternative pour se terminer au début de la reprise.
+
+Le développement, à l'aide de la commande @code{\unfoldRepeats}, d'une
+répétition qui commence sur une mesure incomplète et contient un bloc
+@code{alternative} avec modification de la propriété
+@code{measureLength} entraînera des messages d'erreur concernant le
+placement des barres de mesure.
 
 Des reprises imbriquées telles que
 
@@ -226,181 +322,387 @@ résoudre cette ambiguïté, il convient de toujours insérer la commande
 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 Indications de reprise manuelles
+@unnumberedsubsubsec Indications de reprise manuelles
+@translationof Manual repeat marks
 
-@node Manual repeat commands
-@unnumberedsubsubsec Manual repeat commands
+@cindex reprise manuelle
 
 @funindex repeatCommands
+@funindex start-repeat
+
+@warning{Les méthodes présentées dans les lignes qui suivent ne
+devraient servir à indiquer que des constructions de répétition
+inhabituelles.  En règle générale, il vaut mieux recourrir à la fonction
+@code{@bs{}repeat} pour créer une reprise ou bien insérer la barre de
+mesure adéquate.   Pour plus d'information, voir le chapitre
+@ref{Barres de mesure}.}
 
 La propriété @code{repeatCommands} sert à contrôler la mise en forme des
 reprises.  On la définit par une suite de commandes de reprise Scheme.
 
-@table @asis
-@item @code{start-repeat}
+@table @code
+@item start-repeat
 Pour imprimer une barre de reprise @code{|:}
 
-@item @code{end-repeat}
+@lilypond[verbatim,quote,relative=2]
+c1
+\set Score.repeatCommands = #'(start-repeat)
+d4 e f g
+c1
+@end lilypond
+
+Traditionnellement, on n'imprime pas de signe de reprise en début de
+morceau.
+
+@item end-repeat
 Pour imprimer une barre de reprise @code{:|}
 
-@item @code{(volta @var{texte})}
-Pour imprimer un crochet indiquant une alternative.  L'argument
-@var{texte} mentionné dans le crochet peut être n'importe quelle chaîne
-de caractères ou indication textuelle --- voir @ref{Formatting text}.
-Attention cependant à changer la police, car la police employée par
-défaut pour les chiffres ne contient aucun caractère alphabétique.
+@lilypond[verbatim,quote,relative=2]
+c1
+d4 e f g
+\set Score.repeatCommands = #'(end-repeat)
+c1
+@end lilypond
+
+@item (volta @var{nombre}) @dots{} (volta #f)
+Pour obtenir un crochet indiquant le numéro de l'alternative.  Pour que
+le crochet s'imprime effectivement, il faut spécifier explicitement
+l'endroit où il doît se terminer.
+
+@lilypond[verbatim,quote,relative=2]
+f4 g a b
+\set Score.repeatCommands = #'((volta "2"))
+g4 a g a
+\set Score.repeatCommands = #'((volta #f))
+c1
+@end lilypond
 
-@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
+Plusieurs commande de reprise peuvent intervenir au même moment@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+f4 g a b
+\set Score.repeatCommands = #'((volta "2, 5") end-repeat)
+g4 a g a
+c1
+\set Score.repeatCommands = #'((volta #f) (volta "95") end-repeat)
+b1
+\set Score.repeatCommands = #'((volta #f))
+@end lilypond
+
+@cindex alternative et texte
+@cindex texte et alternative
+
+Le crochet indiquant une alternative peut contenir aussi du texte.  Il
+peut s'agir d'un ou plusieurs nombres ou bien d'une indication textuelle
+(@emph{markup}) -- voir @ref{Mise en forme du texte}.  Le plus simple,
+dans le cas d'une indication textuelle, est de tout d'abord définir ce
+@code{markup}, puis de l'inclure dans une liste Scheme.
+
+@lilypond[verbatim,quote]
+voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
+\relative c'' {
+  c1
+  \set Score.repeatCommands = #(list(list 'volta voltaAdLib) 'start-repeat)
+  c4 b d e
+  \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
+  f1
   \set Score.repeatCommands = #'((volta #f))
-c4 c4
+}
 @end lilypond
 
 
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
+
+
 @seealso
-Référence du programme : @rinternals{VoltaBracket},
+Manuel de notation :
+@ref{Barres de mesure},
+@ref{Mise en forme du texte}.
+
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
+
+Référence des propriétés internes :
+@rinternals{VoltaBracket},
 @rinternals{RepeatedMusic},
-@rinternals{VoltaRepeatedMusic}, et
-@rinternals{UnfoldedRepeatedMusic}.
+@rinternals{VoltaRepeatedMusic}.
 
 
-@node Other repeats
-@subsection Other repeats
+@node Répétitions explicites
+@unnumberedsubsubsec Répétitions explicites
+@translationof Written-out repeats
 
-@menu
-* Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
-@end menu
+@cindex musique répétitive
+@cindex reprise, expansion
+@cindex expansion de reprise
 
-@node Tremolo repeats
-@unnumberedsubsubsec Tremolo repeats
+@funindex \repeat unfold
+@funindex unfold
 
-@cindex ligatures de trémolo
-@cindex trémolo, ligatures de
+Adjoindre à la commande @code{\repeat} l'opion @code{unfold} permet de
+s'affranchir de ressaisir de la musique répétitive.  En voici la
+syntaxe@tie{}:
 
-On peut placer une notation de trémolo entre deux notes, avec la
-commande @code{\repeat} suivie du style trémolo :
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
+@example
+\repeat unfold @var{nombre_de_fois} @var{expression_musicale}
+@end example
+
+@noindent
+Le contenu de @var{expression_musicale} sera donc expansé autant de fois
+que stipulé par @var{nombre_de_fois}.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+c1
+@end lilypond
+
+Une répétition expansée peut aussi avoir une fin alternative@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { g4 f e d }
+\alternative {
+  { c2 g' }
+  { cis,2 b }
 }
+c1
+@end lilypond
+
+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.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 4 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+ }
+c1
 @end lilypond
 
+S'il y a par contre plus d'alternatives que de répétitions, les
+alternatives superflues seront tout simplement ignorées et ne seront pas
+imprimées.
 
-On peut aussi indiquer un trémolo sur une seule note, qu'il faudra
-alors laisser sans accolades.
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+}
+c1
+@end lilypond
 
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
+Vous pouvez imbriquer plusieurs fonctions @code{unfold}, qu'elles
+comportent ou non des fins alternatives@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 {
+  \repeat unfold 2 { c4 d e f }
+  \alternative {
+    { c2 g' }
+    { c,2 b }
+  }
+}
+c1
 @end lilypond
 
 
-La subdivision des trémolos aboutit à un résultat semblable : voir
-@ref{Tremolo subdivisions}.
+@warning{L'insertion d'un @code{@bs{}relative} dans une section
+@code{@bs{}repeat} sans déclaration explicite du contexte @code{Voice}
+génèrera une portée supplémentaire -- voir
+@rprogram{Apparition d'une portée supplémentaire}.}
 
 
 @seealso
-Dans ce manuel : @ref{Tremolo subdivisions}, @ref{Repeats}.
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
 
-Référence du programme : @rinternals{Beam}, @rinternals{StemTremolo}.
+Référence des propriétés internes :
+@rinternals{RepeatedMusic},
+@rinternals{UnfoldedRepeatedMusic}.
 
 
-@node Tremolo subdivisions
-@unnumberedsubsubsec Tremolo subdivisions
+@node Autres types de répétition
+@subsection Autres types de répétition
+@translationof Short repeats
 
-@cindex trémolo, indication de
-@funindex tremoloFlags
+Nous abordons ici les reprises de courte durée.  Il en existe deux
+formes, à savoir la répétition d'une même note sur quelques mesures --
+représentée par une barre oblique ou le signe pourcent -- et les
+trémolos.
 
-Un trémolo peut être indiqué sur une seule note, en la faisant suivre
-de deux points et d'un nombre :
+@menu
+* Répétitions de mesure::
+* Répétitions en trémolo::
+@end menu
+
+@node Répétitions de mesure
+@unnumberedsubsubsec Répétitions de mesure
+@translationof Percent repeats
 
-@code{note:}[@var{nombre}]. 
+@cindex pourcent, répétition
+@cindex mesure, répétition de
+@cindex répétition, pourcent
+@cindex répétition de mesure
+@cindex répétition courte
 
-Le nombre en question correspond à la valeur de la subdivision ;
-il doit être au moins de 8, auquel cas la hampe sera barrée par un 
-seul trait de ligature.  Si ce nombre est omis, la dernière valeur ---
-telle que mémorisée dans @code{tremoloFlags} --- sera utilisée.
+@funindex \repeat percent
+@funindex percent
 
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
+Le style de @qq{reprise en pourcent} sert à répéter une séquence de
+notes.  Elle sera imprimée une fois, puis remplacée par un symbole
+spécial.
+
+En voici la syntaxe@tie{}:
+
+@example
+\repeat percent @var{nombre} @var{expression_musicale}
+@end example
+
+
+Les séquences inférieures à une mesure sont remplacées par une barre
+oblique.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c8 d }
+\repeat percent 4 { c4 }
+\repeat percent 2 { c2 }
 @end lilypond
 
+Les séquences d'une ou deux mesures sont remplacées par un
+symbole qui ressemble au symbole de pourcentage.
 
-@knownissues
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 3 { c4 d e f }
+\repeat percent 4 { c2 d }
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 3 { c4 d e f | c2 g' }
+@end lilypond
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{percent-repeat-counter.ly}
 
-Les trémolos entrés de cette manière ne sont pas rendus dans
-le fichier MIDI.
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{percent-repeat-count-visibility.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{isolated-percent-repeats.ly}
 
 
 @seealso
-Dans ce manuel : @ref{Tremolo repeats}.
+Glossaire musicologique :
+@rglos{percent repeat},
+@rglos{simile}.
+
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
+
+Référence des propriétés internes :
+@rinternals{RepeatSlash},
+@rinternals{PercentRepeat},
+@rinternals{DoublePercentRepeat},
+@rinternals{DoublePercentRepeatCounter},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic}.
 
-Référence du programme : @rinternals{StemTremolo}.
 
+@knownissues
 
-@node Measure repeats
-@unnumberedsubsubsec Measure repeats
+LilyPond ne dispose que de trois signes différents pour indiquer une
+répétition @qq{en pourcent}@tie{}: une simple barre oblique qui
+représente un seul temps quelle que soit la durée des notes
+répétées@tie{}; une barre oblique simple entourée de points qui
+représente une mesure entière@tie{}; une double barre oblique entourée
+de points et placée sur la barre de mesure pour indiquer une répétition
+de deux mesures.
 
-@cindex percent repeats
-@cindex measure repeats
+@node Répétitions en trémolo
+@unnumberedsubsubsec Répétitions en trémolo
+@translationof Tremolo repeats
 
-Le style de @qq{reprise en pourcent} sert à répéter une séquence de
-notes.  Elle sera imprimée une fois, puis remplacée par un symbole
-spécial.  Les séquences d'une ou deux mesures sont remplacées par un
-symbole qui ressemble au symbole de pourcentage, tandis que les
-séquences inférieures à une mesure sont remplacées par une barre
-oblique.  Toutes ces répétitions doivent être déclarées dans un contexte
-@code{Voice}.
+@cindex trémolo
+@cindex trémolo, ligatures de
 
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
+@funindex \repeat tremolo
+@funindex tremolo
+
+Il y a deux formes de trémolo@tie{}: la répétition alernative de deux
+notes ou accords, et la répétition rapide d'une seule note ou d'un
+accord.  Lorsqu'il est constitué d'une alternance répétitive, le trémolo
+s'indique en ajoutant des barres de ligature entre les deux notes ou
+accords concernés.  Lorsqu'il s'agit d'une répétition rapide, des barres
+de ligature penchées sont ajoutées à la note en question.
+
+On peut placer une notation de trémolo entre deux notes, avec la
+commande @code{\repeat} suivie du style trémolo@tie{}:
+
+@lilypond[quote,verbatim,relative=2]
+\repeat tremolo 8 { c16 d }
+\repeat tremolo 6 { c16 d }
+\repeat tremolo 2 { c16 d }
 @end lilypond
 
-Les répétitions de plus de 2 mesures sont surmontées d'un compteur,
-si l'on assigne @emph{vrai} (lettre @q{t}) à la propriété
-@code{countPercentRepeats}.
+La syntaxe de @code{\repeat tremolo} requiert espressément deux notes
+encadrées par des accolades, et le nombre de répétitions exprimé en
+durée d'une note (pointée ou non).  Ainsi, dans l'exemple ci-dessus,
+@code{\repeat@tie{}tremolo@tie{}7} est valide car correspond à une note
+doublement pointée, à l'inverse de @code{\repeat@tie{}tremolo@tie{}9}.
 
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat percent 4 { c1 }
-}
+La durée d'un trémolo est égale à la durée de l'expression entre
+accolades multipliée par le nombre de fois à répéter@tie{}:
+@code{\repeat@tie{}tremolo@tie{}8@tie{}@{@tie{}c16@tie{}d16@tie{}@}}
+correspond donc à la valeur d'une ronde, et sera représenté par deux
+rondes séparées par des barres de trémolo.
+
+On peut indiquer de la même manière un trémolo sur une seule note, qu'il
+faudra alors laisser sans accolades@tie{}:
+
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
 @end lilypond
 
-Des symboles de pourcentage isolés peuvent aussi être obtenus, au
-moyen d'un silence multi-mesures dont on modifie l'aspect :
 
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
+@cindex trémolo, indication de
+
+@funindex tremoloFlags
+@funindex :
+
+Le même résultat s'obtient en faisant suivre la note considérée
+de deux points et d'un nombre (@w{@code{note:@var{nombre}}}).
+Le nombre en question correspond à la valeur de la subdivision@tie{};
+il doit être au moins de 8, auquel cas la hampe sera barrée par un
+seul trait de ligature.  Si ce nombre est omis, la dernière valeur --
+telle que mémorisée dans @code{tremoloFlags} -- sera utilisée.
+
+@lilypond[quote,verbatim,relative=2]
+c2:8 c:32
+c: c:
 @end lilypond
 
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{cross-staff-tremolos.ly}
+
 
 @seealso
-Référence du programme : @rinternals{RepeatSlash},
-@rinternals{PercentRepeat}, @rinternals{DoublePercentRepeat},
-@rinternals{DoublePercentRepeatCounter},
-@rinternals{PercentRepeatCounter},
-@rinternals{PercentRepeatedMusic}.
+Morceaux choisis :
+@rlsrnamed{Repeats,Répétitions}.
+
+@cindex tremolo, cross-staff
+@cindex cross-staff tremolo