]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/repeats.itely
Merge remote-tracking branch 'origin/translation'
[lilypond.git] / Documentation / fr / notation / repeats.itely
index c4cbd67e643061ee0230bff82a563de3fe5290f1..2854b175c513a8cbaa83492b30c4158598c3dfc3 100644 (file)
@@ -1,12 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
 @ignore
-    Translation of GIT committish: e98b2d804c2a136edfa28adc894bb584f676c884
+    Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
 
     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.17.11"
 
 @c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @c Translators: Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 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
 
 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 :
 
 @table @code
 @item volta
 
 @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
+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
 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
@@ -36,7 +38,7 @@ s'agit de la notation courante des reprises avec fins alternatives.
 @item unfold
 La musique répétée est développée dans la partition autant de fois
 qu'indiqué.  Ceci est particulièrement utile pour de la musique
 @item unfold
 La musique répétée est développée dans la partition autant de fois
 qu'indiqué.  Ceci est particulièrement utile pour de la musique
-répétitive. 
+répétitive.
 
 @item percent
 Des barres obliques ou signes de pourcentage indiquent la répétition
 
 @item percent
 Des barres obliques ou signes de pourcentage indiquent la répétition
@@ -48,24 +50,25 @@ Ce type permet de réaliser des trémolos sous forme de liens de croches.
 @end table
 
 @menu
 @end table
 
 @menu
-* Répétition d'un long passage::  
-* Autres types de répétition::  
+* Répétition d'un long passage::
+* Autres types de répétition::
 @end menu
 
 @end menu
 
+
 @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 --
 c'est-à-dire plusieurs mesures.  Ces répétitions peuvent prendre deux
 @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 --
 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 : 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
 contrôlés manuellement.
 
 @menu
-* Répétitions courantes::       
-* Indications de reprise manuelles::  
-* Répétitions explicites::      
+* Répétitions courantes::
+* Indications de reprise manuelles::
+* Répétitions explicites::
 @end menu
 
 @cindex volta
 @end menu
 
 @cindex volta
@@ -75,6 +78,7 @@ contrôlés manuellement.
 @cindex reprise courante
 @cindex reprise avec alternative
 @cindex fin alternative
 @cindex reprise courante
 @cindex reprise avec alternative
 @cindex fin alternative
+@cindex alternative, reprise
 
 @funindex \repeat
 @funindex \alternative
 
 @funindex \repeat
 @funindex \alternative
@@ -85,22 +89,16 @@ contrôlés manuellement.
 @unnumberedsubsubsec Répétitions courantes
 @translationof Normal repeats
 
 @unnumberedsubsubsec Répétitions courantes
 @translationof Normal repeats
 
-On peut indiquer une répétition de la façon suivante :
+On peut indiquer une répétition de la façon suivante :
 
 @example
 \repeat volta @var{nombre_de_fois} @var{expression_musicale}
 @end example
 
 @noindent
 
 @example
 \repeat volta @var{nombre_de_fois} @var{expression_musicale}
 @end example
 
 @noindent
-où @var{expression_musicale} représente ce qui doît être répété.  On
-peut ajouter une fin alternative à l'aide de la commande
-@code{\alternative}.  Chaque @var{alternative} étant une expression
-musicale en elle-même, il faudra les regrouper par des accolades.  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. 
+où @code{@var{expression_musicale}} représente ce qui doît être répété.
 
 
-Les reprises courantes s'indiquent comme ceci :
+Les reprises courantes, sans alternative, s'indiquent comme ceci :
 
 @lilypond[verbatim,quote,relative=2]
 \repeat volta 2 { c4 d e f }
 
 @lilypond[verbatim,quote,relative=2]
 \repeat volta 2 { c4 d e f }
@@ -108,21 +106,53 @@ c2 d
 \repeat volta 2 { d4 e f g }
 @end lilypond
 
 \repeat volta 2 { d4 e f g }
 @end lilypond
 
-Et avec des fins alternatives :
+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 ; il faudra donc les regrouper par des accolades.
+
+@example
+\repeat volta @var{nombre_de_fois} @var{expression_musicale}
+\alternative @{
+  @{ @var{expression_musicale} @}
+@}
+@end example
+
+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.
+
+Voici une simple reprise avec une fin alternative :
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f | }
+\alternative {
+  { c2 e | }
+  { f2 g | }
+}
+c1
+@end lilypond
+
+Et une répétition avec plusieurs alternatives :
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
-\repeat volta 4 { c4 d e f }
+\repeat volta 3 { c4 d e f | }
 \alternative {
 \alternative {
-  { d2 e }
-  { f2 g }
+  { c2 e | }
+  { f2 g | }
+  { a2 g | }
 }
 c1
 @end lilypond
 
 }
 c1
 @end lilypond
 
-@warning{Une clause @code{@bs{}relative} ne doît jamais se trouver à
-l'intérieur d'une section @code{@bs{}repeat} : vous aurez
-immanquablement des portées parasites.  Voir 
-@rlearning{Apparition d'une portée supplémentaire}.}
+@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 doit jamais se trouver à
+l'intérieur d'une section @code{@bs{}repeat} : 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 reprise avec levée
 @cindex levée dans une reprise
@@ -131,38 +161,90 @@ immanquablement des portées parasites.  Voir
 
 @funindex \partial
 
 
 @funindex \partial
 
-Il est possible de créer des répétitions avec une levée.
+Lorsqu'une reprise sans fin alternative 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 ; 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
 
 
-@lilypond[verbatim,quote,relative=2]
-\partial 4
-e |
-\repeat volta 4 { c2 d | e2 f | }
-\alternative {
-  { g4 g g e }
-  { a4 a a a | b2. }
+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 entame.
+
+@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
 
 @end lilypond
 
-@noindent
-ou
+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 :
 
 
-@lilypond[verbatim,quote,relative=2]
+@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
 \partial 4
-\repeat volta 4 { e4 | c2 d | e2 f | }
+\repeat volta 2 { e4 | c2 e | }
 \alternative {
 \alternative {
-  { \partial 4*3 g4 g g }
-  { a4 a a a | b2. }
+  {
+    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
 
 @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 reprise et liaison de prolongation
 @cindex alternative et liaison de prolongation
-@cindex liaison de prolongationt et reprise
+@cindex liaison de prolongation et reprise
 @cindex liaison de prolongation et alternative
 
 @funindex \repeatTie
 
 @cindex liaison de prolongation et alternative
 
 @funindex \repeatTie
 
-Des liaisons de tenue peuvent être ajoutées à toute alternative :
+Des liaisons de tenue peuvent être ajoutées à toute alternative :
 
 @lilypond[verbatim,quote,relative=2]
 c1
 
 @lilypond[verbatim,quote,relative=2]
 c1
@@ -173,42 +255,156 @@ c1
 }
 @end lilypond
 
 }
 @end lilypond
 
-@snippets
+@cindex reprise et segno
+@cindex segno et reprise
+@funindex \inStaffSegno
+
+La commande @code{\inStaffSegno} permet de générer une barre de mesure
+composite par l'adjonction d'un symbole de @emph{segno} à une barre de
+reprise créée par une commande @code{\repeat volta}.  Qu'il s'agisse
+d'un début, d'une fin ou d'une double reprise, le type de barre est
+automatiquement sélectionné.  L'indication « D.S. » devra cependant être
 
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+En dehors de toute reprise :
+
+@lilypond[verbatim,quote,relative=1]
+e1
+\inStaffSegno
+f2 g a b
+c1_"D.S." \bar "|."
+@end lilypond
+
+Au début d'une reprise :
+
+@lilypond[verbatim,quote,relative=1]
+e1
+\repeat volta 2 {
+  \inStaffSegno  % start repeat
+  f2 g a b
+}
+c1_"D.S." \bar "|."
+@end lilypond
+
+En fin de reprise :
+
+@lilypond[verbatim,quote,relative=1]
+e1
+\repeat volta 2 {
+  f2 g a b
+  \inStaffSegno  % end repeat
+}
+f2 g a b
+c1_"D.S." \bar "|."
+@end lilypond
+
+Entre deux reprises :
+
+@lilypond[verbatim,quote,relative=1]
+e1
+\repeat volta 2 {
+  f2 g a b
+}
+\inStaffSegno  % double repeat
+\repeat volta 2 {
+  f2 g a b
+}
+c1_"D.S." \bar "|."
+@end lilypond
+
+Des symboles alternatifs de barre de mesure sont aussi accessibles, dans
+un contexte @code{Score}, à l'aide des propriétés @code{segnoType},
+@code{startRepeatSegnoType}, @code{endRepeatSegnoType} ou
+@code{doubleRepeatSegnoType} selon les besoins.  Ces types de barre
+alternative doivent être choisis parmi les types prédéfinis ou
+préalablement créés à l'aide d'une commande @code{\defineBarLine} --
+voir @ref{Barres de mesure}.
+
+@lilypond[verbatim,quote,relative=1]
+\defineBarLine ":|.S[" #'(":|." "S[" "")
+\defineBarLine "]" #'("]" "" "")
+e1
+\repeat volta 2 {
+  f2 g a b
+  \once \set Score.endRepeatSegnoType = ":|.S["
+  \inStaffSegno
+}
+f2 g \bar "]" a b
+c1_"D.S." \bar "|."
+@end lilypond
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {shortening-volta-brackets.ly}
 
 {shortening-volta-brackets.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {adding-volta-brackets-to-additional-staves.ly}
 
 {adding-volta-brackets-to-additional-staves.ly}
 
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{setting-the-double-repeat-default-for-volte.ly}
+
+@cindex reprises et numéros de mesure
+@cindex numéro de mesure et reprise
+@cindex mesure, numérotation et reprises
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{alternative-bar-numbering.ly}
 
 @seealso
 Glossaire musicologique :
 
 @seealso
 Glossaire musicologique :
-@rglos{repeat},
+@rglosnamed{repeat,répétition},
 @rglos{volta}.
 
 Manuel de notation :
 @ref{Barres de mesure},
 @rglos{volta}.
 
 Manuel de notation :
 @ref{Barres de mesure},
-@ref{Modification des greffons de contexte}.
+@ref{Modification des greffons de contexte},
+@ref{Modification des liaisons},
+@ref{Gestion du temps}.
 
 Morceaux choisis :
 
 Morceaux choisis :
-@rlsr{Repeats}.
+@rlsrnamed{Repeats,Répétitions}.
 
 
-Référence eds propriétés internes :
+Référence des propriétés internes :
 @rinternals{VoltaBracket},
 @rinternals{RepeatedMusic},
 @rinternals{VoltaRepeatedMusic},
 @rinternals{UnfoldedRepeatedMusic}.
 
 @rinternals{VoltaBracket},
 @rinternals{RepeatedMusic},
 @rinternals{VoltaRepeatedMusic},
 @rinternals{UnfoldedRepeatedMusic}.
 
-
 @knownissues
 @knownissues
-
 @cindex reprises ambigües
 @cindex reprises imbriquées
 @cindex imbrication de reprises
 @cindex numéro de mesure et reprises
 @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
+@cindex reprises et liaison
+@cindex liaison et reprises
+@cindex glissando et reprises
+@cindex reprises et glissando
+
+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.
+L'aspect visuel d'une liaison se continuant dans les autres
+alternatives, peut être simulée à l'aide de la commande
+@code{\repeatTie} lorsqu'elle s'arrête sur sa première note --
+méthode qui cependant ne fonctionne pas pour un @code{TabStaff}.
+D'autres moyens existent pour indiquer la prolongation d'une
+liaison sur des alternatives, y compris dans un @code{TabStaff},
+en suivant les préceptes donnés à la rubrique
+@ref{Modification des liaisons}.
+
+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.
+
+L'extension d'un glissando à partir d'un bloc @code{\repeat} sur
+un bloc @code{\alternative} n'est possible que pour la première
+alternative.  L'aspect visuel d'un glissando se continuant dans
+les autres alternatives peut être simulé à l'aide d'un glissando
+partant d'une note d'ornement supplémentaire et masquée.  Un
+exemple se trouve à la rubrique @ref{Glissando}.
+
+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
 
 
 Des reprises imbriquées telles que
 
@@ -226,12 +422,6 @@ 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é.
 
 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.
-
 
 @node Indications de reprise manuelles
 @unnumberedsubsubsec Indications de reprise manuelles
 
 @node Indications de reprise manuelles
 @unnumberedsubsubsec Indications de reprise manuelles
@@ -243,18 +433,18 @@ n'est répétée.
 @funindex start-repeat
 
 @warning{Les méthodes présentées dans les lignes qui suivent ne
 @funindex start-repeat
 
 @warning{Les méthodes présentées dans les lignes qui suivent ne
-devraient servir qu'à indiquer des constructions de répétitions
-inhabituelles.  En règle générale, il vaut mieux recourrir à la fonction
-@code{\\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}.} 
+devraient servir à indiquer que des constructions de répétition
+inhabituelles.  En règle générale, il vaut mieux recourir à 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 @code
 @item start-repeat
 
 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 @code
 @item start-repeat
-Pour imprimer une barre de reprise @code{|:}
+Pour imprimer une barre de reprise @code{.|:}
 
 @lilypond[verbatim,quote,relative=2]
 c1
 
 @lilypond[verbatim,quote,relative=2]
 c1
@@ -264,10 +454,10 @@ c1
 @end lilypond
 
 Traditionnellement, on n'imprime pas de signe de reprise en début de
 @end lilypond
 
 Traditionnellement, on n'imprime pas de signe de reprise en début de
-morceau. 
+morceau.
 
 @item end-repeat
 
 @item end-repeat
-Pour imprimer une barre de reprise @code{:|}
+Pour imprimer une barre de reprise @code{:|.}
 
 @lilypond[verbatim,quote,relative=2]
 c1
 
 @lilypond[verbatim,quote,relative=2]
 c1
@@ -276,10 +466,10 @@ d4 e f g
 c1
 @end lilypond
 
 c1
 @end lilypond
 
-@item (volta @var{nombre}) ... (volta #f)
+@item (volta @var{nombre}) @dots{} (volta #f)
 Pour obtenir un crochet indiquant le numéro de l'alternative.  Pour que
 Pour obtenir un crochet indiquant le numéro de l'alternative.  Pour que
-le crochet s'imprime effectivement, il faut specifier explicitement
-l'endroit où il doît se terminer.  
+le crochet s'imprime effectivement, il faut spécifier explicitement
+l'endroit où il doit se terminer.
 
 @lilypond[verbatim,quote,relative=2]
 f4 g a b
 
 @lilypond[verbatim,quote,relative=2]
 f4 g a b
@@ -291,7 +481,7 @@ c1
 
 @end table
 
 
 @end table
 
-Plusieurs commande de reprise peuvent intervenir au même moment :
+Plusieurs commandes de reprise peuvent intervenir au même moment :
 
 @lilypond[verbatim,quote,relative=2]
 f4 g a b
 
 @lilypond[verbatim,quote,relative=2]
 f4 g a b
@@ -310,13 +500,14 @@ 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
 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.
+@emph{markup}, puis de l'inclure dans une liste Scheme.
 
 @lilypond[verbatim,quote]
 voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 \relative c'' {
   c1
 
 @lilypond[verbatim,quote]
 voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 \relative c'' {
   c1
-  \set Score.repeatCommands = #(list(list 'volta voltaAdLib) 'start-repeat)
+  \set Score.repeatCommands =
+    #(list(list 'volta voltaAdLib) 'start-repeat)
   c4 b d e
   \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
   f1
   c4 b d e
   \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
   f1
@@ -324,22 +515,15 @@ voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 }
 @end lilypond
 
 }
 @end lilypond
 
-
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
-
-
 @seealso
 Manuel de notation :
 @ref{Barres de mesure},
 @ref{Mise en forme du texte}.
 
 Morceaux choisis :
 @seealso
 Manuel de notation :
 @ref{Barres de mesure},
 @ref{Mise en forme du texte}.
 
 Morceaux choisis :
-@rlsr{Repeats}.
+@rlsrnamed{Repeats,Répétitions}.
 
 
-Référence des propriétés internes : 
+Référence des propriétés internes :
 @rinternals{VoltaBracket},
 @rinternals{RepeatedMusic},
 @rinternals{VoltaRepeatedMusic}.
 @rinternals{VoltaBracket},
 @rinternals{RepeatedMusic},
 @rinternals{VoltaRepeatedMusic}.
@@ -357,8 +541,8 @@ Référence des propriétés internes :
 @funindex unfold
 
 Adjoindre à la commande @code{\repeat} l'opion @code{unfold} permet de
 @funindex unfold
 
 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 : 
+s'affranchir de ressaisir de la musique répétitive.  En voici la
+syntaxe :
 
 @example
 \repeat unfold @var{nombre_de_fois} @var{expression_musicale}
 
 @example
 \repeat unfold @var{nombre_de_fois} @var{expression_musicale}
@@ -369,30 +553,92 @@ Le contenu de @var{expression_musicale} sera donc expansé autant de fois
 que stipulé par @var{nombre_de_fois}.
 
 @lilypond[verbatim,quote,relative=2]
 que stipulé par @var{nombre_de_fois}.
 
 @lilypond[verbatim,quote,relative=2]
-c1
 \repeat unfold 2 { c4 d e f }
 c1
 @end lilypond
 
 \repeat unfold 2 { c4 d e f }
 c1
 @end lilypond
 
-Une répétition expansée peut aussi avoir une fin alternative.  Si
-l'on donne trop peu d'alternatives en regard du nombre de fois où le
+Dans certains cas, et tout particulièrement dans un contexte
+@code{\relative}, la fonction @code{\repeat unfold} ne revient pas à
+écrire littéralement la même expression musicale plusieurs fois.
+Ainsi :
+
+@example
+\repeat unfold 2 @{ a'4 b c @}
+@end example
+
+n'est pas équivalent à
+
+@example
+a'4 b c | a'4 b c
+@end example
+
+Une répétition expansée peut aussi avoir une fin alternative :
+
+@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
 passage doit être rejoué, la première alternative sera jouée plusieurs
-fois. 
+fois.
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
+\repeat unfold 4 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+ }
 c1
 c1
-\repeat unfold 2 { g4 f e d }
+@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.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 { c4 d e f }
+\alternative {
+  { c2 g' }
+  { c,2 b }
+  { e2 d }
+}
+c1
+@end lilypond
+
+Vous pouvez imbriquer plusieurs fonctions @code{unfold}, qu'elles
+comportent ou non des fins alternatives :
+
+@lilypond[verbatim,quote,relative=2]
+\repeat unfold 2 {
+  \repeat unfold 2 { c4 d e f }
   \alternative {
   \alternative {
-    { cis2 g' }
-    { cis,2 b }
+    { c2 g' }
+    { c,2 b }
   }
   }
+}
 c1
 @end lilypond
 
 c1
 @end lilypond
 
+Une construction en accord peut se répéter à l'aide du symbole @code{q}
+-- voir @ref{Répétition d'accords}.
+
+@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
 
 @seealso
+Manuel de notation :
+@ref{Répétition d'accords}.
+
 Morceaux choisis :
 Morceaux choisis :
-@rlsr{Repeats}.
+@rlsrnamed{Repeats,Répétitions}.
 
 Référence des propriétés internes :
 @rinternals{RepeatedMusic},
 
 Référence des propriétés internes :
 @rinternals{RepeatedMusic},
@@ -404,18 +650,19 @@ Référence des propriétés internes :
 @translationof Short repeats
 
 Nous abordons ici les reprises de courte durée.  Il en existe deux
 @translationof Short repeats
 
 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 -- 
+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
 représentée par une barre oblique ou le signe pourcent -- et les
-trémolos. 
+trémolos.
 
 @menu
 
 @menu
-* Répétitions de mesure::       
-* Répétitions en trémolo::       
+* Répétitions de mesure::
+* Répétitions en trémolo::
 @end menu
 
 @end menu
 
+
 @node Répétitions de mesure
 @unnumberedsubsubsec Répétitions de mesure
 @node Répétitions de mesure
 @unnumberedsubsubsec Répétitions de mesure
-@translationof Measure repeats
+@translationof Percent repeats
 
 @cindex pourcent, répétition
 @cindex mesure, répétition de
 
 @cindex pourcent, répétition
 @cindex mesure, répétition de
@@ -426,63 +673,83 @@ trémolos.
 @funindex \repeat percent
 @funindex percent
 
 @funindex \repeat percent
 @funindex percent
 
-Le style de @qq{reprise en pourcent} sert à répéter une séquence de
+Le style de « reprise en pourcent » sert à répéter une séquence de
 notes.  Elle sera imprimée une fois, puis remplacée par un symbole
 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.  
+spécial.
+
+En voici la syntaxe :
 
 @example
 
 @example
-@code{\repeat percent @var{nombre} @var{musicexpr}}
+\repeat percent @var{nombre} @var{expression_musicale}
 @end example
 
 @end example
 
-@noindent
-où @var{musicexpr} est l'expression musicale à répéter.
+Les séquences inférieures à une mesure sont remplacées par une barre
+oblique.
 
 @lilypond[verbatim,quote,relative=2]
 
 @lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c128 d e f }
+\repeat percent 4 { c64 d e f }
+\repeat percent 5 { c32 d e f }
+\repeat percent 4 { c16 d e f }
+\repeat percent 4 { c8 d }
 \repeat percent 4 { c4 }
 \repeat percent 4 { c4 }
-\repeat percent 2 { b4 a g f }
-\repeat percent 2 { c2 es | f4 fis g c | }
+\repeat percent 2 { c2 }
 @end lilypond
 
 @end lilypond
 
-@snippets
+Les séquences d'une ou deux mesures sont remplacées par un
+symbole qui ressemble au symbole de pourcentage.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 2 { c4 d e f }
+\repeat percent 2 { c2 d }
+\repeat percent 2 { c1 }
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 3 { c4 d e f | c2 g' }
+@end lilypond
+
+Les séquences inférieures à la mesure et qui contiennent des durées
+différentes sont remplacées par un double symbole de pourcentage.
+
+@lilypond[verbatim,quote,relative=2]
+\repeat percent 4 { c8. <d f>16 }
+\repeat percent 2 { \tuplet 3/2 { r8 c d } e4 }
+@end lilypond
 
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {percent-repeat-counter.ly}
 
 {percent-repeat-counter.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {percent-repeat-count-visibility.ly}
 
 {percent-repeat-count-visibility.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {isolated-percent-repeats.ly}
 
 {isolated-percent-repeats.ly}
 
-
 @seealso
 Glossaire musicologique :
 @rglos{percent repeat},
 @rglos{simile}.
 
 Morceaux choisis :
 @seealso
 Glossaire musicologique :
 @rglos{percent repeat},
 @rglos{simile}.
 
 Morceaux choisis :
-@rlsr{Repeats}.
+@rlsrnamed{Repeats,Répétitions}.
 
 Référence des propriétés internes :
 @rinternals{RepeatSlash},
 
 Référence des propriétés internes :
 @rinternals{RepeatSlash},
+@rinternals{RepeatSlashEvent},
+@rinternals{DoubleRepeatSlash},
 @rinternals{PercentRepeat},
 @rinternals{PercentRepeat},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic},
+@rinternals{Percent_repeat_engraver},
+@rinternals{DoublePercentEvent},
 @rinternals{DoublePercentRepeat},
 @rinternals{DoublePercentRepeatCounter},
 @rinternals{PercentRepeatCounter},
 @rinternals{PercentRepeatedMusic}.
 @rinternals{DoublePercentRepeat},
 @rinternals{DoublePercentRepeatCounter},
 @rinternals{PercentRepeatCounter},
 @rinternals{PercentRepeatedMusic}.
-
-
-@knownissues
-
-LilyPond ne dispose que de trois signes différents pour indiquer une
-répétition @qq{en pourcent} : une simple barre oblique qui représente un 
-seul temps quelle que soit la durée des notes répétées ; une barre
-oblique simple entourée de points qui représente une mesure entière ;
-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.  
+@rinternals{Double_percent_repeat_engraver},
+@rinternals{Slash_repeat_engraver}.
 
 
 @node Répétitions en trémolo
 
 
 @node Répétitions en trémolo
@@ -495,15 +762,15 @@ mesure pour indiquer une répétition de deux mesures.
 @funindex \repeat tremolo
 @funindex tremolo
 
 @funindex \repeat tremolo
 @funindex tremolo
 
-Il y a deux formes de trémolo : 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
+Il y a deux formes de trémolo : 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
 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ée à la note en question.
+de ligature penchées sont ajoutées à la note en question.
 
 On peut placer une notation de trémolo entre deux notes, avec la
 
 On peut placer une notation de trémolo entre deux notes, avec la
-commande @code{\repeat} suivie du style trémolo :
+commande @code{\repeat} suivie du style trémolo :
 
 @lilypond[quote,verbatim,relative=2]
 \repeat tremolo 8 { c16 d }
 
 @lilypond[quote,verbatim,relative=2]
 \repeat tremolo 8 { c16 d }
@@ -511,34 +778,34 @@ commande @code{\repeat} suivie du style trémolo :
 \repeat tremolo 2 { c16 d }
 @end lilypond
 
 \repeat tremolo 2 { c16 d }
 @end lilypond
 
-La syntaxe de @code{\repeat tremolo} requiert espressément deux notes
+La syntaxe de @code{\repeat tremolo} requiert expressé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,
 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,
-@w{@code{\repeat tremolo 7}} est valide car correspond à une note
-doublement pointée, à l'inverse de @code{\repeat tremolo 9}.
+@code{\repeat tremolo 7} est valide car correspond à une note
+doublement pointée, à l'inverse de @code{\repeat tremolo 9}.
 
 La durée d'un trémolo est égale à la durée de l'expression entre
 
 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 :
-@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.
+accolades multipliée par le nombre de fois à répéter :
+@code{\repeat tremolo 8 @{ c16 d16 @}} 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
 
 On peut indiquer de la même manière un trémolo sur une seule note, qu'il
-faudra alors laisser sans accolades :
+faudra alors laisser sans accolades :
 
 @lilypond[quote,verbatim,ragged-right]
 \repeat tremolo 4 c'16
 @end lilypond
 
 
 @lilypond[quote,verbatim,ragged-right]
 \repeat tremolo 4 c'16
 @end lilypond
 
-
 @cindex trémolo, indication de
 @cindex trémolo, indication de
+
 @funindex tremoloFlags
 @funindex :
 
 @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 ;
-il doit être au moins de 8, auquel cas la hampe sera barrée par un 
+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 ;
+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.
 
 seul trait de ligature.  Si ce nombre est omis, la dernière valeur --
 telle que mémorisée dans @code{tremoloFlags} -- sera utilisée.
 
@@ -548,20 +815,12 @@ c: c:
 @end lilypond
 
 @snippets
 @end lilypond
 
 @snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {cross-staff-tremolos.ly}
 
 {cross-staff-tremolos.ly}
 
-
 @seealso
 Morceaux choisis :
 @seealso
 Morceaux choisis :
-@rlsr{Repeats}.
+@rlsrnamed{Repeats,Répétitions}.
 
 @cindex tremolo, cross-staff
 @cindex cross-staff tremolo
 
 @cindex tremolo, cross-staff
 @cindex cross-staff tremolo
-
-@knownissues
-
-Les trémolos distribués sur plusieurs portées peuvent amener des
-résultat inespérés.
-