X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fnotation%2Frepeats.itely;h=f2f8e2b49fe67fa762bd300d57187cf91da5a157;hb=4051d4410364b9984faa181659a3bfe2763a9736;hp=ed8f7774c7f417792e18f681f009ff27b53edc19;hpb=17efd24bdbf7ed1c5a352ef28eb3c1ccaec2512b;p=lilypond.git

diff --git a/Documentation/es/notation/repeats.itely b/Documentation/es/notation/repeats.itely
index ed8f7774c7..f2f8e2b49f 100644
--- a/Documentation/es/notation/repeats.itely
+++ b/Documentation/es/notation/repeats.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
+    Translation of GIT committish: c4a960d0461ee5ecd87cd46692ec11682b8969b0
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.19.21"
 
 @node Repeticiones
 @section Repeticiones
@@ -21,23 +21,24 @@ siguientes tipos de repetición:
 
 @table @code
 @item volta (primera y segunda vez)
-La repetición de la música no se imprime de forma desarrollada, sino
-que se indica encerrándola entre barras de repetición.  Si el salto de
-la repetición se encuentra al comienzo de una pieza, la barra de
-repetición sólo se imprime al final del fragmento.  Se imprimen una
-serie de finales alternativos (volte) de izquierda a derecha indicados
-mediante corchetes.  Ésta es la notación estándar para las
-repeticiones con finales alternativos.
+La repetición de la música no se imprime de forma desarrollada,
+sino que se indica encerrándola entre barras de repetición.  Si el
+salto de la repetición se encuentra al comienzo de una pieza, la
+barra de repetición sólo se imprime al final del fragmento.  Se
+imprimen una serie de finales alternativos (volte) de izquierda a
+derecha indicados mediante corchetes.  Ésta es la notación
+estándar para las repeticiones con finales alternativos.
 
 @item unfold (desplegada)
-Las música repetida se escribe y se interpreta completamente tantas
-veces como especifique el valor @var{número_de_repeticiones}.  Es útil
-cuando se está escribiendo música repetitiva.
+Las música repetida se escribe y se interpreta completamente
+tantas veces como especifique el valor
+@code{@var{número_de_repeticiones}}.  Es útil cuando se está
+escribiendo música repetitiva.
 
 @item percent (porcentaje)
-Hacer repeticiones de compases o parte de ellos.  Tienen un aspecto
-semejante a un signo de porcentaje.  Las repeticiones de porcentaje se
-deben declarar dentro de un contexto @code{Voice}.
+Hacer repeticiones de compases o parte de ellos.  Tienen un
+aspecto semejante a un signo de porcentaje.  Las repeticiones de
+porcentaje se deben declarar dentro de un contexto @code{Voice}.
 
 @item tremolo (trémolo)
 Hacer barras de trémolo.
@@ -54,11 +55,12 @@ Hacer barras de trémolo.
 @subsection Repeticiones largas
 @translationof Long repeats
 
-Esta sección trata sobre la forma de introducir repeticiones largas,
-normalmente de varios compases.  Las repeticiones adoptan dos formas:
-repeticiones encerradas entre signos de repetición, o repeticiones
-explícitas, que se usan para escribir música repetitiva.  También se
-pueden controlar manualmente los signos de repetición.
+Esta sección trata sobre la forma de introducir repeticiones
+largas, normalmente de varios compases.  Las repeticiones adoptan
+dos formas: repeticiones encerradas entre signos de repetición, o
+repeticiones explícitas, que se usan para escribir música
+repetitiva.  También se pueden controlar manualmente los signos de
+repetición.
 
 @menu
 * Repeticiones normales::
@@ -83,95 +85,272 @@ pueden controlar manualmente los signos de repetición.
 @unnumberedsubsubsec Repeticiones normales
 @translationof Normal repeats
 
-La sintaxis de una repetición simple es
+La sintaxis de una repetición normal es
 
 @example
-\repeat @var{variante} @var{número_de_repeticiones} @var{cuerpo_de_la_repetición}
+\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
 @end example
 
-donde @var{cuerpo_de_la_repetición} es una expresión musical.  Los
-finales alternativos se pueden obtener utilizando @code{\alternative}.
-Para delimitar los finales alternativos, el grupo de alternativas se
-debe incluir dentro de un par de llaves.  Si existen más repeticiones
-que finales alternativos, las primeras repeticiones recibirán la
-primera alternativa.
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Una repetición simple sin finales alternativos:
 
+@lilypond[verbatim,quote]
+\relative {
+  \repeat volta 2 { c''4 d e f }
+  c2 d
+  \repeat volta 2 { d4 e f g }
+}
+@end lilypond
 
-Repeticiones normales sin finales alternativos:
+De forma predeterminada no se imprimen las dobles barras de
+apertura de repetición en el primer compás completo.  Sin embargo
+es posible imprimirlas usando @code{\bar ".|:"} antes de la
+primera nota.
 
-@lilypond[verbatim,quote,relative=2]
-\repeat volta 2 { c4 d e f }
-c2 d
-\repeat volta 2 { d4 e f g }
+@lilypond[verbatim,fragment,quote]
+\relative {
+  \repeat volta 2 { \bar ".|:" c''4 d e f }
+  c2 d
+  \repeat volta 2 { d4 e f g }
+}
 @end lilypond
 
-Repeticiones normales con primera y segunda vez:
+Los finales alternativos (casillas de primera y segunda vez) se
+pueden generar utilizando @code{\alternative}.  Cada grupo de
+alternativas debe, a su vez, estar encerrado entre llaves curvas.
+
+@example
+\repeat volta @var{número_de_repeticiones} @var{expresión_musical}
+\alternative @{
+  @{ @var{expresión_musical} @}
+@}
+@end example
+
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Si existen más repeticiones que finales alternativos, se asigna el
+primer final alternativo a las repeticiones más antiguas.
 
-@lilypond[verbatim,quote,relative=2]
-\repeat volta 4 { c4 d e f }
-\alternative {
-  { d2 e }
-  { f2 g }
+Repetición única con primera y segunda vez:
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat volta 2 { c''4 d e f | }
+  \alternative {
+    { c2 e | }
+    { f2 g | }
+  }
+  c1
 }
-c1
 @end lilypond
 
+Varias repeticiones con primera y segunda vez:
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat volta 4 { c''4 d e f | }
+  \alternative {
+    { c2 e | }
+    { f2 g | }
+  }
+  c1
+}
+@end lilypond
+
+Más de una repetición con más de un final alternativo:
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat volta 3 { c''4 d e f | }
+  \alternative {
+    { c2 e | }
+    { f2 g | }
+    { a2 g | }
+  }
+  c1
+}
+@end lilypond
+
+@warning{Si hay dos o más alternativas, no debe aparecer nada
+entre la llave de cierre de una y la de apertura de la otra dentro
+de un bloque @code{@bs{}alternative}, pues en caso contrario no
+obtendremos el número de finales esperado.}
+
+@warning{Si incluimos @code{@bs{}relative} dentro de un
+@code{@bs{}repeat} sin instanciar el contexto @code{Voice}
+explícitamente, aparecerán pentagramas adicionales no deseados.
+Véase @rprogram{Aparece un pentagrama de más}.}
 
 @cindex repetición con anacrusa
 @cindex anacrusa en repeticiones
 @funindex \partial
+@cindex comprobación de compás con repeticiones
+@cindex repetición con comprobaciones de compás
+
+Si una repetición sin casillas de primera y segunda vez comienza
+en medio de un compás, normalmente termina en el lugar
+correspondiente en mitad de otro compás posterior (de tal forma
+que los dos suman un compás completo).  En este caso, los símbolos
+de repetición no son @q{verdaderas} líneas divisorias, por lo que
+no deben escribirse en este sitio comprobaciones de compás ni
+instrucciones @code{\partial}:
+
+@lilypond[verbatim,quote,relative=1]
+c'4 e g
+\repeat volta 4 {
+  e4 |
+  c2 e |
+  g4 g g
+}
+  g4 |
+  a2 a |
+  g1 |
+@end lilypond
 
-Las repeticiones con anacrusa se pueden introducir de dos formas:
+Si una repetición que no tiene casillas de primera y segunda vez
+comienza con un compás parcial, entonces se aplica el mismo
+principio, excepto que se requiere una instrucción @code{\partial}
+al comienzo del compás:
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote,relative=1]
 \partial 4
-e |
-\repeat volta 4 { c2 d | e2 f | }
-\alternative {
-  { g4 g g e }
-  { a4 a a a | b2. }
+\repeat volta 4 {
+  e'4 |
+  c2 e |
+  g4 g g
 }
+  g4 |
+  a2 a |
+  g1 |
 @end lilypond
 
-@noindent
-o bien
+@cindex repeticiones, con ligaduras
+@cindex primera y segunda vez, con ligaduras
+@cindex ligaduras, en repeticiones
+@cindex ligaduras, en primera y segunda vez
+@funindex \repeatTie
 
-@lilypond[verbatim,quote,relative=2]
-\partial 4
-\repeat volta 4 { e4 | c2 d | e2 f | }
-\alternative {
-  { \partial 4*3 g4 g g }
-  { a4 a a a | b2. }
+Se pueden añadir ligaduras de unión al segundo final:
+
+@lilypond[verbatim,quote]
+\relative {
+  c''1
+  \repeat volta 2 { c4 d e f~ }
+  \alternative {
+    { f2 d }
+    { f2\repeatTie f, }
+  }
 }
 @end lilypond
 
+@funindex \inStaffSegno
+@cindex repeticiones, con segno
+@cindex segno, con repeticiones
 
-@cindex repeticiones con ligaduras
-@cindex primera y segunda vez con ligaduras
-@cindex ligaduras en las repeticiones
-@cindex ligaduras en primera y segunda vez
-@funindex \repeatTie
+La instrucción @code{\inStaffSegno} se puede utilizar para generar
+una barra de compás combinada que incorpora el símbolo del segno
+junto con la barra de repetición, cuando se usa con la instrucción
+@code{\repeat volta}.  Se selecciona automáticamente el tipo
+correcto de línea divisoria de repetición, ya sea de comienzo o
+fin de repeticion, o de doble repetición.  Observe que la
+indicación @qq{D.S.} correspondiente se debe añadir manualmente.
 
+Salida de una repetición:
 
-Se pueden añadir ligaduras de unión al segundo final:
+@lilypond[verbatim,quote]
+\relative {
+  e'1
+  \inStaffSegno
+  f2 g a b
+  c1_"D.S." \bar "|."
+}
+@end lilypond
+
+Al comienzo de una repetición:
 
-@lilypond[verbatim,quote,relative=2]
-c1
-\repeat volta 2 { c4 d e f ~ }
-\alternative {
-  { f2 d }
-  { f2\repeatTie f, }
+@lilypond[verbatim,quote]
+\relative {
+  e'1
+  \repeat volta 2 {
+    \inStaffSegno  % start repeat
+    f2 g a b
+  }
+  c1_"D.S." \bar "|."
 }
 @end lilypond
 
-@snippets
+Al final de una repetición:
+
+@lilypond[verbatim,quote]
+\relative {
+  e'1
+  \repeat volta 2 {
+    f2 g a b
+    \inStaffSegno  % end repeat
+  }
+  f2 g a b
+  c1_"D.S." \bar "|."
+}
+@end lilypond
+
+Entre dos repeticiones:
+
+@lilypond[verbatim,quote]
+\relative {
+  e'1
+  \repeat volta 2 {
+    f2 g a b
+  }
+  \inStaffSegno  % double repeat
+  \repeat volta 2 {
+    f2 g a b
+  }
+  c1_"D.S." \bar "|."
+}
+@end lilypond
+
+Se pueden obtener símbolos de línea divisoria alternativos
+mediante el establecimiento (en el contexto Score) de las
+propiedades @code{segnoType}, @code{startRepeatSegnoType},
+@code{endRepeatSegnoType} o @code{doubleRepeatSegnoType} al tipo
+de línea requerido.  Los tipos de línea divisoria alternativos
+deben seleccionarse a partir de los tipos predefinidos o de tipos
+definidos anteriormente con la instrucción @code{\defineBarLine}
+(véase @ref{Barras de compás}).
+
+@lilypond[verbatim,quote]
+\defineBarLine ":|.S[" #'(":|." "S[" "")
+\defineBarLine "]" #'("]" "" "")
+\relative {
+  e'1
+  \repeat volta 2 {
+    f2 g a b
+    \once \set Score.endRepeatSegnoType = ":|.S["
+    \inStaffSegno
+  }
+  f2 g \bar "]" a b
+  c1_"D.S." \bar "|."
+}
+@end lilypond
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {shortening-volta-brackets.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {adding-volta-brackets-to-additional-staves.ly}
 
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{setting-the-double-repeat-default-for-volte.ly}
+
+@cindex repeticiones, letras y números de compás
+@cindex repeticiones, números de compás de primera y segunda vez
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{alternative-bar-numbering.ly}
 
 @seealso
 Glosario musical:
@@ -180,7 +359,12 @@ Glosario musical:
 
 Referencia de la notación:
 @ref{Barras de compás},
-@ref{Modificar los complementos (plug-ins) de contexto}.
+@ref{Modificar los complementos (plug-ins) de contexto},
+@ref{Modificación de ligaduras de unión y de expresión},
+@ref{Gestión del tiempo}.
+
+Archivos instalados:
+@file{ly/engraver-init.ly}.
 
 Fragmentos de código:
 @rlsr{Repeats}.
@@ -191,9 +375,7 @@ Referencia de funcionamiento interno:
 @rinternals{VoltaRepeatedMusic},
 @rinternals{UnfoldedRepeatedMusic}.
 
-
 @knownissues
-
 @cindex repetición ambigua
 @cindex anidada, repetición
 @cindex repetición anidada
@@ -202,8 +384,42 @@ Referencia de funcionamiento interno:
 @cindex números de compás y repeticiones
 @cindex tiempo, repeticiones y contador de
 @cindex compás, repeticiones y números de
-@cindex repetición y ligadura de expresión
+@cindex repeticiones y ligadura de expresión
 @cindex ligaduras de expresión y repeticiones
+@cindex glissandi y repeticiones
+@cindex repeticiones y glissandi
+
+Las ligaduras de expresión que abarcan desde un bloque
+@code{\repeat} hasta un bloque @code{\alternative} sólo funcionan
+para la casilla de primera vez.  La apariencia visual de una
+ligadura de expresión que se continúa introduciéndose en otras
+casillas de repetición puede simularse con @code{\repeatTie} si la
+ligadura se extiende hasta una sola nota dentro de la casilla de
+repetición, aunque este método no funciona en @code{TabStaff}.
+Otros métodos que pueden venir bien para indicar ligaduras que se
+continúan por encima de varias notas en las casillas de
+repetición, y que también funcionan en contextos de tablatura
+@code{TabStaff}, están explicados en
+@ref{Modificación de ligaduras de unión y de expresión}.
+
+Asimismo, no es posible hacer que las ligaduras de expresión se
+replieguen desde el final de una alternativa hasta el comienzo de
+la repetición.
+
+Los glissandos que se extienden desde un bloque @code{\repeat}
+hasta un bloque @code{\alternative} solamente funcionan para la
+casilla de primera vez.  Se puede indicar la apariencia visual de
+un glissando que se continúa hasta el interior de otras casillas
+de repetición mediante la codificación de un glissando que empieza
+en una nota de adorno oculta.  Para ver un ejemplo, consulte
+@qq{Extender los glissandos sobre las repeticiones} bajo el
+epígrafe Fragmentos de código seleccionados, en @ref{Glissando}.
+
+Si una repetición que comienza con un compás incompleto tiene un
+bloque @code{\alternative} que contiene modificaciones a la
+propiedad @code{measureLength}, la utilización de
+@code{\unfoldRepeats} dará lugar a líneas divisorias erróneamente
+colocadas y advertencias de comprobación de compás.
 
 Una repetición anidada como
 
@@ -220,14 +436,6 @@ es ambigua porque no está claro a qué @code{\repeat} pertenece la
 interna.  Para más claridad, se recomienda usar llaves en tales
 situaciones.
 
-La información del contador de tiempo no se recuerda al comienzo de
-una alternativa, por ello después de una repetición la información de
-la cuenta de tiempo se debe reajustar manualmente; por ejemplo,
-estableciendo el valor de @code{Score.measurePosition} o introduciendo
-@code{\partial}.  De forma similar, las ligaduras de expresión tampoco
-se repiten.
-
-
 
 @node Marcas de repetición manual
 @unnumberedsubsubsec Marcas de repetición manual
@@ -246,54 +454,59 @@ se repiten.
 @funindex repeatCommands
 @funindex start-repeat
 
-@warning{Estos métodos sólo se utilizan para realizar construcciones
-de repetición poco usuales, y pueden tener un comportamiento distinto
-al esperado.  En casi todas las situaciones, se deben crear las
-repeticiones utilizando la instrucción estándar @code{\\repeat} o
-imprimiendo las barras de compás correspondientes.  Para ver más
-información, consulte @ref{Barras de compás}.}
+@warning{Estos métodos sólo se utilizan para realizar
+construcciones de repetición poco usuales, y pueden tener un
+comportamiento distinto al esperado.  En casi todas las
+situaciones, se deben crear las repeticiones utilizando la
+instrucción estándar @code{@bs{}repeat} o imprimiendo las barras
+de compás correspondientes.  Para ver más información, consulte
+@ref{Barras de compás}.}
 
 Se puede usar la propiedad @code{repeatCommands} para controlar la
-disposición de las repeticiones.  Su valor es una lista de Scheme de
-comandos de repetición.
+disposición de las repeticiones.  Su valor es una lista de Scheme
+de instrucciones de repetición.
 
 @table @code
 @item start-repeat
-Imprimir una barra de compás @code{|:}
+Imprimir una barra de compás @code{.|:}
 
-@lilypond[verbatim,quote,relative=2]
-c1
-\set Score.repeatCommands = #'(start-repeat)
-d4 e f g
-c1
+@lilypond[verbatim,quote]
+\relative {
+  c''1
+  \set Score.repeatCommands = #'(start-repeat)
+  d4 e f g
+  c1
+}
 @end lilypond
 
 En la práctica habitual del grabado no se imprimen signos de
 repetición al principio de la pieza.
 
-
 @item @code{end-repeat}
-Imprimir una barra de compás @code{:|}
+Imprimir una barra de compás @code{:|.}
 
-@lilypond[verbatim,quote,relative=2]
-c1
-d4 e f g
-\set Score.repeatCommands = #'(end-repeat)
-c1
+@lilypond[verbatim,quote]
+\relative {
+  c''1
+  d4 e f g
+  \set Score.repeatCommands = #'(end-repeat)
+  c1
+}
 @end lilypond
 
+@item (volta @var{number}) @dots{} (volta #f)
+Crear una nueva casilla de repetición con el número que se
+especifica.  El corchete de vez se debe terminar de forma
+explícita, pues en caso contrario no se imprime.
 
-@item (volta @var{number}) ... (volta #f)
-Crear una nueva casilla de repetición con el número que se especifica.
-El corchete de vez se debe terminar de forma explícita, pues en caso
-contrario no se imprimirá.
-
-@lilypond[verbatim,quote,relative=2]
-f4 g a b
-\set Score.repeatCommands = #'((volta "2"))
-g4 a g a
-\set Score.repeatCommands = #'((volta #f))
-c1
+@lilypond[verbatim,quote]
+\relative {
+  f''4 g a b
+  \set Score.repeatCommands = #'((volta "2"))
+  g4 a g a
+  \set Score.repeatCommands = #'((volta #f))
+  c1
+}
 @end lilypond
 
 @end table
@@ -301,30 +514,33 @@ c1
 Se pueden producir varias instrucciones de repetición en el mismo
 punto:
 
-@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))
+@lilypond[verbatim,quote]
+\relative {
+  f''4 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 corchete de casilla de repetición con texto
 @cindex texto en casilla de repetición
 
-Se puede incluir texto dentro de la casilla de primera y segunda vez.
-El texto puede ser un número o números, o un elemento de marcado,
-véase @ref{Formatear el texto}.  La forma más fácil de usar texto de
-marcado es definir el marcado previamente, y luego incluirlo dentro de
-una lista de Scheme.
+Se puede incluir texto dentro de la casilla de primera y segunda
+vez.  El texto puede ser un número o números, o un elemento de
+marcado, véase @ref{Formatear el texto}.  La forma más fácil de
+usar texto de marcado es definir el marcado previamente, y luego
+incluirlo dentro de una lista de 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)
+\relative {
+  c''1
+  \set Score.repeatCommands =
+    #(list(list 'volta voltaAdLib) 'start-repeat)
   c4 b d e
   \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
   f1
@@ -332,11 +548,6 @@ voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
 }
 @end lilypond
 
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{printing-a-repeat-sign-at-the-beginning-of-a-piece.ly}
-
 
 @seealso
 Referencia de la notación:
@@ -357,50 +568,127 @@ Referencia de funcionamiento interno:
 @translationof Written-out repeats
 
 @cindex explícitas, repeticiones
-@cindex repetitiva, música
 @cindex repeticiones explícitas
-@cindex repetición desplegada
-@cindex desplegar música
+@cindex repeticiones desplegadas
+@cindex repeticiones alternativas
+@cindex primera y segunda vez, repeticiones
+@cindex repeticiones con primera y segunda vez
 @cindex desplegar repetición
-@cindex repetición desplegada con finales alternativos
+@cindex repeticiones desplegadas con finales alternativos
 @cindex música desplegada con finales alternativos
 @cindex alternativos, finales, en repeticiones explícitas
 @funindex unfold
 
-Mediante la utilización de la instrucción @code{unfold} se pueden usar
-las repeticiones para simplificar la escritura desplegada de música
-repetitiva.  La sintaxis es:
+Mediante la utilización de la instrucción @code{unfold} se pueden
+usar las repeticiones para simplificar la escritura desplegada de
+música repetitiva.  La sintaxis es:
 
 @example
 \repeat unfold @var{número_de_repeticiones} @var{expresión_musical}
 @end example
 
-donde @var{expresión_musical} es una expresión musical y
-@var{número_de_repeticiones} es el número de veces que
-@var{expresión_musical} se repite.
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical y
+@code{@var{número_de_repeticiones}} es el número de veces que
+@code{@var{expresión_musical}} se repite.
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat unfold 2 { c''4 d e f }
+  c1
+}
+@end lilypond
+
+En ciertos casos, especialmente dentro de un contexto
+@code{\relative}, la función @code{\repeat unfold} no es
+exactamente igual que escribir la expresión musical varias
+veces. P. ej.:
+
+@example
+\repeat unfold 2 @{ a'4 b c @}
+@end example
+
+no equivale a
+
+@example
+a'4 b c | a'4 b c
+@end example
+
+Se pueden hacer repeticiones desplegadas con finales alternativos.
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat unfold 2 { c''4 d e f }
+  \alternative {
+    { c2 g' }
+    { c,2 b }
+  }
+  c1
+}
+@end lilypond
 
-@lilypond[verbatim,quote,relative=2]
-c1
-\repeat unfold 2 { c4 d e f }
-c1
+Si hay más repeticiones que finales alternativos, el primer final
+alternativo se aplica las veces necesarias hasta que las
+alternativas restantes completan el número total de repeticiones.
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat unfold 4 { c''4 d e f }
+  \alternative {
+    { c2 g' }
+    { c,2 b }
+    { e2 d }
+   }
+  c1
+}
 @end lilypond
 
-Se pueden hacer repeticiones desplegadas con finales alternativos.  Si
-hay más repeticiones que finales alternativos, el primer final
-alternativo se aplica a las primeras repeticiones.
+Si existen más finales alternativos que repeticiones, se aplican
+solo los primeros finales alternativos.  Las alternativas
+restantes se ignoran y no se imprimen.
 
-@lilypond[verbatim,quote,relative=2]
-c1
-\repeat unfold 2 { g4 f e d }
+@lilypond[verbatim,quote]
+\relative {
+  \repeat unfold 2 { c''4 d e f }
   \alternative {
-    { cis2 g' }
-    { cis,2 b }
+    { c2 g' }
+    { c,2 b }
+    { e2 d }
   }
-c1
+  c1
+}
 @end lilypond
 
+Es posible también anidar varias funciones @code{unfold} (con
+finales alternativos o sin ellos).
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat unfold 2 {
+    \repeat unfold 2 { c''4 d e f }
+    \alternative {
+      { c2 g' }
+      { c,2 b }
+    }
+  }
+  c1
+}
+@end lilypond
+
+Las construcciones de acorde se pueden repetir mediante el símbolo
+de repetición de acordes @code{q}.  Véase @ref{Repetición de
+acordes}.
+
+@warning{Si pone @code{@bs{}relative} dentro de un bloque
+@code{@bs{}repeat} sin instanciar explícitamente el contexto
+@code{Voice}, aparecerán pentagramas no deseados.  Véase
+@rprogram{Aparece un pentagrama de más}.}
 
 @seealso
+Referencia de la notación:
+@ref{Repetición de acordes}.
+
+Snippets:
 Fragmentos de código:
 @rlsr{Repeats}.
 
@@ -414,9 +702,9 @@ Referencia de funcionamiento interno:
 @translationof Short repeats
 
 Esta sección trata de cómo introducir repeticiones cortas.  Las
-repeticiones cortas adoptan dos formas básicas: repeticiones desde una
-sola nota hasta dos compases representadas por barras inclinadas o
-símbolos de porcentaje, y trémolos.
+repeticiones cortas pueden adoptar dos formas: barras inclinadas o
+signos de porcentaje si estamos representando repeticiones de una
+sola nota, un compás o dos compases, y trémolos en caso contrario.
 
 @menu
 * Repeticiones de compás o parte de ellos::
@@ -435,36 +723,71 @@ símbolos de porcentaje, y trémolos.
 @funindex \repeat percent
 @funindex percent
 
-Están contempladas las repeticiones de patrones cortos de notas.  La
-música se imprime una sola vez, y el patrón se sustituye por un
-símbolo especial.  Los patrones que son más cortos de un compás se
-sustituyen por barras inclinadas, y los patrones de uno o dos compases
-se sustituyen por símbolos de tipo porcentaje.  La sintaxis es:
+Los patrones cortos que se repiten se imprimen una sola vez, y el
+patrón repetido se sustituye por un símbolo especial.
+
+La sintaxis es:
 
 @example
-@code{\repeat percent @var{número} @var{expresión_musical}}
+\repeat percent @var{número} @var{expresión_musical}
 @end example
 
-donde @var{expresión_musical} es una expresión musical.
+@noindent
+donde @code{@var{expresión_musical}} es una expresión musical.
+
+Los patrones más cortos que un compás se sustituyen por barras
+inclinadas.
 
-@lilypond[verbatim,quote,relative=2]
-\repeat percent 4 { c4 }
-\repeat percent 2 { b4 a g f }
-\repeat percent 2 { c2 es | f4 fis g c | }
+@lilypond[verbatim,quote]
+\relative c'' {
+  \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 2 { c2 }
+}
+@end lilypond
+
+Los patrones de repetición de uno o dos compases se sustituyen por
+signos parecidos al símbolo de porcentaje.
+
+@lilypond[verbatim,quote]
+\relative c'' {
+  \repeat percent 2 { c4 d e f }
+  \repeat percent 2 { c2 d }
+  \repeat percent 2 { c1 }
+}
+@end lilypond
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat percent 3 { c''4 d e f | c2 g' }
+}
+@end lilypond
+
+Los patrones más cortos que un compás pero que contienen
+duraciones mezcladas utilizan un símbolo de porcentaje doble.
+
+@lilypond[verbatim,quote]
+\relative {
+  \repeat percent 4 { c''8. <d f>16 }
+  \repeat percent 2 { \tuplet 3/2 { r8 c d } e4 }
+}
 @end lilypond
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {percent-repeat-counter.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {percent-repeat-count-visibility.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {isolated-percent-repeats.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{percent repeat},
@@ -475,25 +798,39 @@ Fragmentos de código:
 
 Referencia de funcionamiento interno:
 @rinternals{RepeatSlash},
+@rinternals{RepeatSlashEvent},
+@rinternals{DoubleRepeatSlash},
 @rinternals{PercentRepeat},
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic},
+@rinternals{Percent_repeat_engraver},
+@rinternals{DoublePercentEvent},
 @rinternals{DoublePercentRepeat},
 @rinternals{DoublePercentRepeatCounter},
-@rinternals{PercentRepeatCounter},
-@rinternals{PercentRepeatedMusic}.
-
+@rinternals{Double_percent_repeat_engraver},
+@rinternals{Slash_repeat_engraver}.
 
 @knownissues
+Las repeticiones de porcentaje no contienen nada más aparte del
+propio signo de porcentaje; especialmente, los cambios de
+indicación de compás no se repiten.
+
+@lilypond[quote,verbatim,relative=2]
+\repeat percent 3 { \time 5/4 c2. 2 \time 4/4 2 2 }
+@end lilypond
 
-Sólo están contempladas tres clases de repeticiones del tipo
-porcentaje: una barra inclinada única que representa un solo pulso
-(sin que importe la duración de las notas repetidas); una sola barra
-inclinada con puntos que representa un compás completo; y dos barras
-con puntos que cruzan a una línea divisoria y que representa dos
-compases completos.  No están contempladas ni varias barras inclinadas
-que representan repeticiones de un pulso consistentes en semicorcheas
-o figuras menores, ni dos barras con puntos que representan
-repeticiones de un solo pulso consistentes en notas de duraciones
-variables.
+@noindent
+Cualquier cambio de compás o instrucción @code{\partial} se tiene
+que producir en pasajes paralelos @emph{fuera} de la repetición de
+porcentaje, p. ej. en una pista especial para la gestión del
+compás.
+
+@lilypond[quote,verbatim,relative=2]
+<<
+  \repeat percent 3 { c2. 2 2 2 }
+  \repeat unfold 3 { \time 5/4 s4*5 \time 4/4 s1 }
+>>
+@end lilypond
 
 
 @node Repeticiones de trémolo
@@ -506,70 +843,70 @@ variables.
 @funindex \repeat tremolo
 @funindex tremolo
 
-Los trémolos pueden adoptar dos formas: alternancia entre dos acordes
-o dos notas, y repetición rápida de una sola nota o acorde.  Los
-trémolos que consisten en una alternancia se indican por medio de la
-adición de barras entre las notas o acordes que se alternan, mientras
-que los trémolos que consisten en la repetición rápida de una sola
-nota se indican mediante la adición de barras cruzadas a una nota
-única.
+Los trémolos pueden adoptar dos formas: alternancia entre dos
+acordes o dos notas, y repetición rápida de una sola nota o
+acorde.  Los trémolos que consisten en una alternancia se indican
+por medio de la adición de barras entre las notas o acordes que se
+alternan, mientras que los trémolos que consisten en la repetición
+rápida de una sola nota se indican mediante la adición de barras
+cruzadas a una nota única.
 
-Para colocar marcas de trémolo entre las notas, use @code{\repeat} con
-el estilo @code{tremolo} (trémolo):
+Para colocar marcas de trémolo entre las notas, use @code{\repeat}
+con el estilo @code{tremolo} (trémolo):
 
-@lilypond[quote,verbatim,relative=2]
-\repeat tremolo 8 { c16 d }
-\repeat tremolo 6 { c16 d }
-\repeat tremolo 2 { c16 d }
+@lilypond[quote,verbatim]
+\relative c'' {
+  \repeat tremolo 8 { c16 d }
+  \repeat tremolo 6 { c16 d }
+  \repeat tremolo 2 { c16 d }
+}
 @end lilypond
 
 La sintaxis de @code{\repeat tremolo} espera que se escriban
 exactamente dos notas dentro de las llaves, y el número de
-repeticiones debe corresponderse con un valor que se pueda expresar
-con figuras normales o con puntillo.  Así, @code{\repeat tremolo 7} es
-válido y produce una nota con doble puntillo, pero @code{\repeat
-tremolo 9} no es válido.
+repeticiones debe corresponderse con un valor que se pueda
+expresar con figuras normales o con puntillo.  Así, @code{\repeat
+tremolo 7} es válido y produce una nota con doble puntillo, pero
+@code{\repeat tremolo 9} no es válido.
 
-La duración del trémolo es igual a la duración de la expresión entre
-llaves, multiplicada por el número de repeticiones: @code{\repeat
-tremolo 8 @{ c16 d16 @}} da como resultado un trémolo de redonda,
-escrito como dos redondas unidas por barras de trémolo.
+La duración del trémolo es igual a la duración de la expresión
+entre llaves, multiplicada por el número de repeticiones:
+@code{\repeat tremolo 8 @{ c16 d16 @}} da como resultado un
+trémolo de redonda, escrito como dos redondas unidas por barras de
+trémolo.
 
-Existen dos maneras de colocar marcas de trémolo sobre una única nota.
-Incluso aquí se puede utilizar la sintaxis @code{\repeat tremolo}, en
-cuyo caso la nota no debe ir encerrada entre llaves:
+Existen dos maneras de colocar marcas de trémolo sobre una única
+nota.  Incluso aquí se puede utilizar la sintaxis @code{\repeat
+tremolo}, en cuyo caso la nota no debe ir encerrada entre llaves:
 
 @lilypond[quote,verbatim,ragged-right]
 \repeat tremolo 4 c'16
 @end lilypond
 
 @cindex trémolo, indicaciones de
-@funindex tremoloFlags
 @funindex :
 
-El mismo resultado se puede obtener escribiendo
-@q{@code{:}[@var{número}]} después de la nota.  El número indica la
-duración de la subdivisión, y debe ser 8 como mínimo.  Un valor de 8
-para @var{número} produce una línea que atraviesa la plica de la nota.
-Si se omite la longitud, se utiliza el último valor (almacenado en
-@code{tremoloFlags})
+El mismo resultado se puede obtener escribiendo @code{:@var{N}}
+después de la nota, donde @code{@var{N}} indica la duración de la
+subdivisión (debe ser 8 como mínimo).  Si @code{@var{N}} es 8, se
+añade una barra de corchea a la plica de la nota.  Si
+@code{@var{N}} se omite, se utiliza el último valor:
 
-@lilypond[quote,verbatim,relative=2]
-c2:8 c:32
-c: c:
+@lilypond[quote,verbatim]
+\relative {
+  c''2:8 c:32
+  c: c:
+}
 @end lilypond
 
+@snippets
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{cross-staff-tremolos.ly}
 
 @seealso
 Fragmentos de código:
 @rlsr{Repeats}.
 
-
 @cindex trémolos de pentagrama cruzado
 @cindex pentagrama cruzado, trémolo de
-
-
-@knownissues
-
-Los trémolos de pentagrama cruzado no funcionan bien.
-