X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fnotation%2Fstaff.itely;h=4480227fe30b373948e0808109ace58d57c54199;hb=1e91837aab755f7ee690f074da684638eb16cf82;hp=4cbbca703da002f025a9c5d0e8f99607dae31bdd;hpb=b1e781ba69cb9ddf783d05e3e3a0f433106c935e;p=lilypond.git

diff --git a/Documentation/es/notation/staff.itely b/Documentation/es/notation/staff.itely
index 4cbbca703d..4480227fe3 100644
--- a/Documentation/es/notation/staff.itely
+++ b/Documentation/es/notation/staff.itely
@@ -1,23 +1,25 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: 8656e359d629aed6990bb8d8d3da8eac2d2c311e
+    Translation of GIT committish: 041cb33a404a829a8cdeeaebce17e45f613f10d8
 
     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.13.36"
+@c \version "2.19.21"
 
 @node Notación de los pentagramas
 @section Notación de los pentagramas
 @translationof Staff notation
 
-@lilypondfile[quote]{staff-headword.ly}
+@c The line width is a bit of a hack to allow space for the
+@c  instrument names.
+@lilypondfile[quote,ragged-right,line-width=14.5\cm,staffsize=16]{staff-headword.ly}
 
 Esta sección explica cómo influir sobre la apariencia de los
-pentagramas, cómo imprimir partituras con más de un pentagrama y cómo
-añadir indicaciones de tempo y notas guía a los pentagramas.
+pentagramas, cómo imprimir partituras con más de un pentagrama y
+cómo añadir indicaciones de tempo y notas guía a los pentagramas.
 
 @menu
 * Impresión de los pentagramas::
@@ -30,8 +32,8 @@ añadir indicaciones de tempo y notas guía a los pentagramas.
 @subsection Impresión de los pentagramas
 @translationof Displaying staves
 
-Esta sección describe los distintos métodos de creación de pentagramas
-y grupos de ellos.
+Esta sección describe los distintos métodos de creación de
+pentagramas y grupos de ellos.
 
 @menu
 * Crear instancias de pentagramas nuevos::
@@ -59,7 +61,6 @@ y grupos de ellos.
 @cindex tablatura, pauta de
 
 @funindex \drummode
-@funindex drummode
 @funindex DrumStaff
 @funindex RhythmicStaff
 @funindex TabStaff
@@ -67,22 +68,23 @@ y grupos de ellos.
 @funindex VaticanaStaff
 @funindex GregorianTranscriptionStaff
 
-Las @notation{pautas} y los @notation{pentagramas} o pautas de cinco
-líneas se crean con las instrucciones @code{\new} o @code{\context}.
-Para ver más detalles, consulte @ref{Crear contextos}.
+Las @notation{pautas} y los @notation{pentagramas} o pautas de
+cinco líneas se crean con las instrucciones @code{\new} o
+@code{\context}.  Para ver más detalles, consulte @ref{Crear y
+referenciar contextos}.
 
 El contexto básico de pentagrama es @code{Staff}:
 
-@lilypond[verbatim,quote,relative=2]
-\new Staff { c4 d e f }
+@lilypond[verbatim,quote]
+\new Staff \relative { c''4 d e f }
 @end lilypond
 
-El contexto @code{DrumStaff} crea una pauta de cinco líneas preparada
-para un conjunto de batería típico.  Cada instrumento se presenta con
-un símbolo distinto.  Los instrumentos se escriben en el modo de
-percusión que sigue a una instrucción @code{\drummode}, con cada
-instrumento identificado por un nombre.  Para ver más detalles,
-consulte @ref{Pautas de percusión}.
+El contexto @code{DrumStaff} crea una pauta de cinco líneas
+preparada para un conjunto de batería típico.  Cada instrumento se
+presenta con un símbolo distinto.  Los instrumentos se escriben en
+el modo de percusión que sigue a una instrucción @code{\drummode},
+con cada instrumento identificado por un nombre.  Para ver más
+detalles, consulte @ref{Pautas de percusión}.
 
 @lilypond[verbatim,quote]
 \new DrumStaff {
@@ -90,35 +92,36 @@ consulte @ref{Pautas de percusión}.
 }
 @end lilypond
 
-@code{RhythmicStaff} crea una pauta de una sola línea que sólo muestra
-las duraciones de la entrada.  Se preservan las duraciones reales.
-Para ver más detalles, consulte @ref{Mostrar los ritmos de la melodía}.
+@code{RhythmicStaff} crea una pauta de una sola línea que sólo
+muestra las duraciones de la entrada.  Se preservan las duraciones
+reales.  Para ver más detalles, consulte
+@ref{Mostrar los ritmos de la melodía}.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new RhythmicStaff { c4 d e f }
 @end lilypond
 
-@code{TabStaff} crea una tablatura con seis cuerdas en la afinación
-estándar de guitarra.  Para ver más detalles, consulte @ref{Tablaturas predeterminadas}.
+@code{TabStaff} crea una tablatura con seis cuerdas en la
+afinación estándar de guitarra.  Para ver más detalles, consulte
+@ref{Tablaturas predeterminadas}.
 
-@lilypond[verbatim,quote,relative=2]
-\new TabStaff { c4 d e f }
+@lilypond[verbatim,quote]
+\new TabStaff \relative { c''4 d e f }
 @end lilypond
 
-Existen dos contextos de pauta específicos para la notación de música
-antigua: @code{MensuralStaff} y @code{VaticanaStaff}.  Se describen en
-@ref{Contextos predefinidos}.
+Existen dos contextos de pauta específicos para la notación de
+música antigua: @code{MensuralStaff} y @code{VaticanaStaff}.  Se
+describen en @ref{Contextos predefinidos}.
 
 @code{GregorianTranscriptionStaff} crea una pauta para la notación
 moderna de canto gregoriano.  No muestra líneas divisorias.
 
-@lilypond[verbatim,quote,relative=2]
-\new GregorianTranscriptionStaff { c4 d e f e d }
+@lilypond[verbatim,quote]
+\new GregorianTranscriptionStaff \relative { c''4 d e f e d }
 @end lilypond
 
-Se pueden definir contextos nuevos de pentagrama único.  Para ver más
-detalles, consulte @ref{Definir contextos nuevos}.
-
+Se pueden definir contextos nuevos de pentagrama único.  Para ver
+más detalles, consulte @ref{Definir contextos nuevos}.
 
 @seealso
 Glosario musical:
@@ -126,7 +129,7 @@ Glosario musical:
 @rglos{staves}.
 
 Referencia de la notación:
-@ref{Crear contextos},
+@ref{Crear y referenciar contextos},
 @ref{Pautas de percusión},
 @ref{Mostrar los ritmos de la melodía},
 @ref{Tablaturas predeterminadas},
@@ -170,61 +173,63 @@ Referencia de funcionamiento interno:
 @cindex sistema
 
 Existen varios contextos para agrupar pentagramas individuales
-formando sistemas.  Cada contexto de agrupación establece el estilo
-del delimitador de comienzo del sistema y el comportamiento de las
-barras de compás.
+formando sistemas.  Cada contexto de agrupación establece el
+estilo del delimitador de comienzo del sistema y el comportamiento
+de las barras de compás.
 
 Si no se especifica ningún contexto, se usan las propiedades
-predeterminadas: el grupo comienza con una línea vertical y las barras
-de compás no están conectadas.
+predeterminadas: el grupo comienza con una línea vertical y las
+barras de compás no están conectadas.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 <<
-  \new Staff { c1 c }
-  \new Staff { c1 c }
+  \new Staff \relative { c''1 c }
+  \new Staff \relative { c''1 c }
 >>
 @end lilypond
 
-En el contexto @code{StaffGroup}, el grupo se inicia con un corchete y
-las barras de compás se dibujan atravesando todos los pentagramas.
+En el contexto @code{StaffGroup}, el grupo se inicia con un
+corchete y las barras de compás se dibujan atravesando todos los
+pentagramas.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new StaffGroup <<
-  \new Staff { c1 c }
-  \new Staff { c1 c }
+  \new Staff \relative { c''1 c }
+  \new Staff \relative { c''1 c }
 >>
 @end lilypond
 
-En un @code{ChoirStaff} (sistema de coro), el grupo se inicia con un
-corchete, pero las barras de compás no están conectadas.
+En un @code{ChoirStaff} (sistema de coro), el grupo se inicia con
+un corchete, pero las barras de compás no están conectadas.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new ChoirStaff <<
-  \new Staff { c1 c }
-  \new Staff { c1 c }
+  \new Staff \relative { c''1 c }
+  \new Staff \relative { c''1 c }
 >>
 @end lilypond
 
-En un @code{GrandStaff} (sistema de piano), el grupo se inicia con una
-llave y las barras de compás se conectan entre los pentagramas.
+En un @code{GrandStaff} (sistema de piano), el grupo se inicia con
+una llave y las barras de compás se conectan entre los
+pentagramas.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new GrandStaff <<
-  \new Staff { c1 c }
-  \new Staff { c1 c }
+  \new Staff \relative { c''1 c }
+  \new Staff \relative { c''1 c }
 >>
 @end lilypond
 
 El @code{PianoStaff} (sistema de piano) es idéntico a
-@code{GrandStaff}, excepto que contempla directamente la impresión del
-nombre del instrumento.  Para ver más detalles, consulte
+@code{GrandStaff}, excepto que contempla directamente la impresión
+del nombre del instrumento.  Para ver más detalles, consulte
 @ref{Nombres de instrumentos}.
 
-@lilypond[verbatim,quote,relative=2]
-\new PianoStaff <<
-  \set PianoStaff.instrumentName = #"Piano"
-  \new Staff { c1 c }
-  \new Staff { c1 c }
+@lilypond[verbatim,quote]
+\new PianoStaff \with { instrumentName = #"Piano" }
+<<
+  \new Staff \relative { c''1 c }
+  \new Staff \relative { \clef bass c1 c }
 >>
 @end lilypond
 
@@ -236,15 +241,14 @@ siguientes valores: @code{SystemStartBar} (línea),
 @code{SystemStartSquare} (corchete en ángulo recto), pero se debe
 especificar explícitamente.
 
-Se pueden definir contextos nuevos de grupo de pentagramas.  Para ver
-más detalles, consulte @ref{Definir contextos nuevos}.
+Se pueden definir contextos nuevos de grupo de pentagramas.  Para
+ver más detalles, consulte @ref{Definir contextos nuevos}.
 
 @snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {use-square-bracket-at-the-start-of-a-staff-group.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {display-bracket-with-only-one-staff-in-a-system.ly}
 
 @cindex diseño «mensurstriche»
@@ -253,7 +257,7 @@ más detalles, consulte @ref{Definir contextos nuevos}.
 @cindex transcripción de música mensural
 @cindex mensural, música, transcripción de
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {mensurstriche-layout-bar-lines-between-the-staves.ly}
 
 @seealso
@@ -280,9 +284,6 @@ Referencia de funcionamiento interno:
 @rinternals{SystemStartBracket},
 @rinternals{SystemStartSquare}.
 
-@knownissues
-@code{PianoStaff} no acepta @code{ChordNames} de forma predeterminada.
-
 
 @node Grupos de pentagramas anidados
 @unnumberedsubsubsec Grupos de pentagramas anidados
@@ -296,34 +297,33 @@ Referencia de funcionamiento interno:
 @cindex llaves, anidado de
 
 Los contextos de grupos de pentagramas se pueden anidar hasta una
-profundidad arbitraria.  En este caso, cada contexto descendiente crea
-un corchete nuevo adyacente al corchete de su grupo padre.
+profundidad arbitraria.  En este caso, cada contexto descendiente
+crea un corchete nuevo adyacente al corchete de su grupo padre.
 
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote]
 \new StaffGroup <<
-  \new Staff { c2 c | c2 c }
+  \new Staff \relative { c''2 c | c2 c }
   \new StaffGroup <<
-    \new Staff { g2 g | g2 g }
+    \new Staff \relative { g'2 g | g2 g }
     \new StaffGroup \with {
       systemStartDelimiter = #'SystemStartSquare
     }
     <<
-      \new Staff { e2 e | e2 e }
-      \new Staff { c2 c | c2 c }
+      \new Staff \relative { e'2 e | e2 e }
+      \new Staff \relative { c'2 c | c2 c }
     >>
   >>
 >>
 @end lilypond
 
-Se pueden definir nuevos contextos de grupos de pentagramas anidados.
-Para ver más detalles, consulte @ref{Definir contextos nuevos}.
+Se pueden definir nuevos contextos de grupos de pentagramas
+anidados.  Para ver más detalles, consulte
+@ref{Definir contextos nuevos}.
 
 @snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {nesting-staves.ly}
 
-
 @seealso
 Referencia de la notación:
 @ref{Agrupar pentagramas},
@@ -341,16 +341,17 @@ Referencia de funcionamiento interno:
 @rinternals{SystemStartBracket},
 @rinternals{SystemStartSquare}.
 
+
 @node Separación de sistemas
 @unnumberedsubsubsec Separación de sistemas
 @translationof Separating systems
 
 @cindex separación de sistemas, marca de
 
-Si el número de sistemas por p´agina varía de una página a otra, es
-costumbre separar los sistemas colocando una marca separadora entre
-ellos.  De forma predeterminada, el separador de sistemas es nulo,
-pero se puede activar con una opción de @code{\paper}.
+Si el número de sistemas por página varía de una página a otra, es
+costumbre separar los sistemas colocando una marca separadora
+entre ellos.  De forma predeterminada, el separador de sistemas es
+nulo, pero se puede activar con una opción de @code{\paper}.
 
 @c \book is required here to display the system separator
 @c ragged-right is required as there are two systems
@@ -359,15 +360,15 @@ pero se puede activar con una opción de @code{\paper}.
   \score {
     \new StaffGroup <<
       \new Staff {
-        \relative c'' {
-          c4 c c c
+        \relative {
+          c''4 c c c
           \break
           c4 c c c
         }
       }
       \new Staff {
-        \relative c'' {
-          c4 c c c
+        \relative {
+          c''4 c c c
           \break
           c4 c c c
         }
@@ -391,14 +392,15 @@ Referencia de la notación:
 Fragmentos de código:
 @rlsr{Notación de los pentagramas}.
 
+
 @node Modificación de pentagramas sueltos
 @subsection Modificación de pentagramas sueltos
 @translationof Modifying single staves
 
 Esta sección explica cómo cambiar los atributos específicos de un
-pentagrama: por ejemplo, cambiar el número de líneas o el tamaño de la
-pauta.  También se describen los métodos para comenzar y terminar los
-pentagramas, y establecer secciones de ossia.
+pentagrama: por ejemplo, cambiar el número de líneas o el tamaño
+de la pauta.  También se describen los métodos para comenzar y
+terminar los pentagramas, y establecer secciones de ossia.
 
 @menu
 * El símbolo del pentagrama::
@@ -411,126 +413,171 @@ pentagramas, y establecer secciones de ossia.
 @unnumberedsubsubsec El símbolo del pentagrama
 @translationof Staff symbol
 
-@cindex ajuste del símbolo del pentagrama
-@cindex dibujo del símbolo del pentagrama
-@cindex pentagrama, ajuste del símbolo del
-@cindex símbolo del pentagrama, dibujo del
-@cindex detener líneas de pentagrama
-@cindex iniciar líneas de pentagrama
-@cindex pentagrama, número de líneas
-@cindex pentagrama, grosor de las líneas
-@cindex líneas, número de, de la pauta
-@cindex grosor de líneas de pauta
-@cindex adicionales, establecer líneas
-@cindex ajuste de líneas adicionales
-@cindex espaciado de líneas adicionales
-@cindex número de líneas de pauta
-
-las líneas de un pentagrama pertenecen al grob @code{StaffSymbol}.  Se
-pueden modificar las propiedades de @code{StaffSymbol} para modificar
-la apariencia de una pauta, pero han de modificarse antes de que se
-produzca la creación de la misma.
-
-Se puede cambiar el número de líneas de la pauta.  La posición de la
-clave y del Do central pueden requerir una modificación para mantener
-la correspondencia con la nueva pauta.  Para ver una explicación,
-consulte la sección de fragmentos de código en @ref{Clave}.
-
-@lilypond[verbatim,quote,relative=2]
-\new Staff \with {
-  \override StaffSymbol #'line-count = #3
+@cindex pentagrama, símbolo del
+@cindex pentagrama, detener e inicial líneas del
+@cindex pentagrama, mofidicar las líneas del
+@cindex adicionales, líneas
+@cindex adicionales internas, líneas
+@cindex adicionales, modificar líneas
+@cindex líneas del pentagrama
+@cindex líneas adicionales
+
+@funindex \startStaff
+@funindex \stopStaff
+
+Se pueden usar las instrucciones @code{\stopStaff} y
+@code{\startStaff} para detener y (re)iniciar, respectivamente, la
+impresión de las líneas de la pauta en cualquier punto de la
+partitura.
+
+@lilypond[verbatim,quote]
+\relative {
+  \stopStaff f''4 d \startStaff g, e
+  f'4 d \stopStaff g, e
+  f'4 d \startStaff g, e
+}
+@end lilypond
+
+@predefined
+@code{\startStaff},
+@code{\stopStaff}.
+@endpredefined
+
+Las líneas de la pauta pertenecen al grob @code{StaffSymbol}
+(incluidas las líneas adicionales) y se pueden modificar usando
+las propiedades de @code{StaffSymbol}, pero esas modificaciones
+deben hacerse antes de que el pentagrama se (re)inicie.
+
+Se puede cambiar el número de líneas de la pauta:
+
+@lilypond[verbatim,quote]
+\relative {
+  f''4 d \stopStaff
+  \override Staff.StaffSymbol.line-count = #2
+  \startStaff g, e |
+
+  f'4 d \stopStaff
+  \revert Staff.StaffSymbol.line-count
+  \startStaff g, e |
 }
-{ d4 d d d }
 @end lilypond
 
-Se puede modificar el grosor de las líneas de la pauta.  El grosor de
-las líneas adicionales y las plicas también resultan afectados, pues
-dependen del grosor de las líneas de la pauta.
+La posición de cada una de las líneas de la pauta también puede
+cambiarse.  Una lista de números fija la posición de cada línea.
+@code{0}@tie{}corresponde a la línea central normal, y las
+posiciones normales de las líneas son
+@code{(-4@tie{}-2@tie{}0@tie{}2@tie{}4)}.  Se imprime una sola
+línea de pauta por cada valor que se introduce, de manera que el
+número de líneas así como su posición en la pauta pueden cambiarse
+con una sola operación de sobreescritura.
 
-@lilypond[verbatim,quote,relative=1]
-\new Staff \with {
-  \override StaffSymbol #'thickness = #3
+@lilypond[verbatim,quote]
+\relative {
+  f''4 d \stopStaff
+  \override Staff.StaffSymbol.line-positions = #'(1 3 5 -1 -3)
+  \startStaff g, e |
+  f'4 d \stopStaff
+  \override Staff.StaffSymbol.line-positions = #'(8 6.5 -6 -8 -0.5)
+  \startStaff g, e |
 }
-{ e4 d c b }
 @end lilypond
 
-El grosor de las líneas adicionales se puede fijar de forma
-independiente al de las líneas de la pauta.  En el ejemplo, los dos
-números son factores que multiplican el grosor de las líneas del
-pentagrama y su espaciado.  Las dos contribuciones se suman para dar
-el grosor de las líneas adicionales.
+Para preservar las direcciones típicas de las plicas (hacia arriba
+para la mitad inferior del pentagra y hacia abajo para la mitad
+superior), debemos alinear la línea (o espacio) central de la
+pauta personalizada con la posición de la línea central normal
+(0).  Puede ser necesario un ajuste de la posición de la clave y
+del Do@tie{}central para que se correspondan a las líneas nuevas.
+Véase @ref{Clave}.
+
+Puede cambiarse el grosor de las líneas de la pauta.  También
+resultan afectadas, de forma predeterminada, las líneas
+adicionales y no la plica de las figuras.
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote]
 \new Staff \with {
-  \override StaffSymbol #'ledger-line-thickness = #'(1 . 0.2)
+  \override StaffSymbol.thickness = #3
+} \relative {
+  f''4 d g, e
 }
-{ e4 d c b }
 @end lilypond
 
-Se puede cambiar la distancia entre las líneas de la pauta.  Este
-ajuste afecta también al espaciado de las líneas adicionales.
+También es posible fijar el grosor de las líneas adicionales de
+forma independiente del de las líneas de la pauta.
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote]
 \new Staff \with {
-  \override StaffSymbol #'staff-space = #1.5
+  \override StaffSymbol.thickness = #2
+  \override StaffSymbol.ledger-line-thickness = #'(0.5 . 0.4)
+} \relative {
+  f'''4 a, a,, f
 }
-{ a4 b c d }
 @end lilypond
 
-Hay más detalles sobre las propiedades de @code{StaffSymbol} en
-@rinternals{staff-symbol-interface}.
+@noindent
+El primer valor se multiplica por el grosor de las líneas del
+pentagrama, el segundo por el ancho de un espacio del pentagrama,
+y después los dos valores se suman para obtener el grosor de las
+líneas adicionales.
 
-@cindex detener el pentagrama
-@cindex iniciar el pentagrama
-@cindex pentagrama, iniciar
-@cindex pentagrama, detener
+Se pueden alterar las posiciones de las líneas adicionales:
 
-@funindex \startStaff
-@funindex startStaff
-@funindex \stopStaff
-@funindex stopStaff
-
-Se pueden colocar modificaciones a las propiedades de una pauta en el
-medio de una partitura, entre @code{\stopStaff} (detener pauta) y
-@code{\startStaff} (iniciar pauta):
-
-@lilypond[verbatim,quote,relative=2]
-c2 c
-\stopStaff
-\override Staff.StaffSymbol #'line-count = #2
-\startStaff
-b2 b
-\stopStaff
-\revert Staff.StaffSymbol #'line-count
-\startStaff
-a2 a
+@lilypond[verbatim,quote]
+\new Staff \with {
+  \override StaffSymbol.ledger-positions = #'(-3 -2 -1 2 5 6)
+} \relative {
+  f'''4 a, a,, f
+}
 @end lilypond
 
-@noindent
-En general, se pueden usar @code{\startStaff} y @code{\stopStaff} para
-detener o iniciar un pentagrama en mitad de una partitura.
-
-@lilypond[verbatim,quote,relative=2]
-c4 b a2
-\stopStaff
-b4 c d2
-\startStaff
-e4 d c2
+Puede hacerse que las líneas adicionales añadidas aparezcan por
+encima o por debajo de la cabeza de las figuras, dependiendo de la
+posición actual relativa a otras cabezas de figura que tienen
+asimismo sus propias líneas adicionales.
+
+@lilypond[verbatim,quote]
+\new Staff \with {
+  \override StaffSymbol.ledger-extra = #4
+} \relative {
+  f'''4 a, d, f,
+}
 @end lilypond
 
+También puede hacerse que las líneas adicionales aparezcan dentro
+del pentagrama allí donde se requieren líneas de pauta
+personalizadas.  El ejemplo muestra la posición predeterminada de
+las líneas adicionales cuando el valor de posición explícito
+@code{ledger-position} se ha fijado o no.  La instrucción
+@code{\stopStaff} se necesita en el ejemplo para revertir la
+instrucción de sobreescritura @code{\override} para todo el
+@code{StaffSymbol} (el símbolo de pauta).
 
-@predefined
-@code{\startStaff},
-@code{\stopStaff}.
-@endpredefined
+@lilypond[verbatim,quote]
+\relative d' {
+  \override Staff.StaffSymbol.line-positions = #'(-8 0 2 4)
+  d4 e f g
+  \stopStaff
+  \startStaff
+  \override Staff.StaffSymbol.ledger-positions = #'(-8 -6 (-4 -2) 0)
+  d4 e f g
+}
+@end lilypond
 
+Puede alterarse la distancia entre líneas de la pauta.  Esto
+afecta también al espaciado de las líneas adicionales.
 
-@snippets
+@lilypond[verbatim,quote]
+\new Staff \with {
+  \override StaffSymbol.staff-space = #1.5
+} \relative {
+  f'''4 d, g, e,
+}
+@end lilypond
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {making-some-staff-lines-thicker-than-the-others.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{line},
@@ -559,16 +606,15 @@ Referencia de funcionamiento interno:
 @cindex escalado de pentagramas
 
 @funindex \startStaff
-@funindex startStaff
 @funindex \stopStaff
-@funindex stopStaff
 
 Los pentagramas @notation{Ossia} se pueden preparar mediante la
-creación de un pentagrama simultáneo nuevo en la posición adecuada:
+creación de un pentagrama simultáneo nuevo en la posición
+adecuada:
 
 @lilypond[verbatim,quote]
-\new Staff \relative c'' {
-  c4 b d c
+\new Staff \relative {
+  c''4 b d c
   <<
     { c4 b d c }
     \new Staff { e4 d f e }
@@ -578,29 +624,28 @@ creación de un pentagrama simultáneo nuevo en la posición adecuada:
 @end lilypond
 
 @noindent
-Sin embargo, el ejemplo anterior no es lo que normalmente se desea.
-Para crear pentagramas de ossia que estén encima del pentagrama
-original, que no tengan compás ni clave, y que tengan un tamaño menor
-de tipografía se deben usar varios trucos.  El Manual de aprendizaje
-describe una técnica específica para llegar a este objetivo, empezando
-por @rlearning{Anidado de expresiones musicales}.
+Sin embargo, el ejemplo anterior no es lo que normalmente se
+desea.  Para crear pentagramas de ossia que estén encima del
+pentagrama original, que no tengan compás ni clave, y que tengan
+un tamaño menor de tipografía se deben usar varios trucos.  El
+Manual de aprendizaje describe una técnica específica para llegar
+a este objetivo, empezando por @rlearning{Anidado de expresiones
+musicales}.
 
 El ejemplo siguiente utiliza la propiedad @code{alignAboveContext}
-para alinear el pentagrama de ossia.  Este método es muy conveniente
-cuando se necesitan sólo algunos pentagramas de ossia.
+para alinear el pentagrama de ossia.  Este método es muy
+conveniente cuando se necesitan sólo algunos pentagramas de ossia.
 
 @lilypond[verbatim,quote]
-\new Staff = main \relative c'' {
-  c4 b d c
+\new Staff = "main" \relative {
+  c''4 b d c
   <<
     { c4 b d c }
 
     \new Staff \with {
       \remove "Time_signature_engraver"
       alignAboveContext = #"main"
-      fontSize = #-3
-      \override StaffSymbol #'staff-space = #(magstep -3)
-      \override StaffSymbol #'thickness = #(magstep -3)
+      \magnifyStaff #2/3
       firstClef = ##f
     }
     { e4 d f e }
@@ -609,30 +654,28 @@ cuando se necesitan sólo algunos pentagramas de ossia.
 }
 @end lilypond
 
-Si se requieren muchos pentagramas de ossia aislados, puede ser más
-conveniente la creación de un contexto @code{Staff} vacío con un
-@emph{identificador de contexto} específico; después se pueden crear
-los pentagramas de ossia @emph{llamando} a este contexto y usando
-@code{\startStaff} y @code{\stopStaff} en los puntos deseados.  Las
-ventajas de este método son más patentes si la pieza es más larga que
-en ejemplo siguiente.
+Si se requieren muchos pentagramas de ossia aislados, puede ser
+más conveniente la creación de un contexto @code{Staff} vacío con
+un @emph{identificador de contexto} específico; después se pueden
+crear los pentagramas de ossia @emph{llamando} a este contexto y
+usando @code{\startStaff} y @code{\stopStaff} en los puntos
+deseados.  Las ventajas de este método son más patentes si la
+pieza es más larga que en ejemplo siguiente.
 
 @lilypond[verbatim,quote,ragged-right]
 <<
-  \new Staff = ossia \with {
+  \new Staff = "ossia" \with {
     \remove "Time_signature_engraver"
-    \override Clef #'transparent = ##t
-    fontSize = #-3
-    \override StaffSymbol #'staff-space = #(magstep -3)
-    \override StaffSymbol #'thickness = #(magstep -3)
+    \hide Clef
+    \magnifyStaff #2/3
   }
   { \stopStaff s1*6 }
 
-  \new Staff \relative c' {
-    c4 b c2
+  \new Staff \relative {
+    c'4 b c2
     <<
       { e4 f e2 }
-      \context Staff = ossia {
+      \context Staff = "ossia" {
         \startStaff e4 g8 f e2 \stopStaff
       }
     >>
@@ -640,7 +683,7 @@ en ejemplo siguiente.
     c4 b c2
     <<
       { g4 a g2 }
-      \context Staff = ossia {
+      \context Staff = "ossia" {
         \startStaff g4 e8 f g2 \stopStaff
       }
     >>
@@ -650,25 +693,25 @@ en ejemplo siguiente.
 @end lilypond
 
 Como alternativa, se puede usar la instrucción
-@code{\RemoveEmptyStaves} para crear pentagramas de ossia.  Este
-método es muy conveniente cuando los pentagramas de ossia aparecen
-inmediatamente después de un salto de línea. Para ver más información
-sobre @code{\RemoveEmptyStaves}, consulte @ref{Ocultar pentagramas}.
+@code{\RemoveAllEmptyStaves} para crear pentagramas de ossia.
+Este método es muy conveniente cuando los pentagramas de ossia
+aparecen inmediatamente después de un salto de línea. Para ver más
+información sobre @code{\RemoveAllEmptyStaves}, consulte
+@ref{Ocultar pentagramas}.
 
 @lilypond[verbatim,quote,ragged-right]
 <<
-  \new Staff = ossia \with {
+  \new Staff = "ossia" \with {
     \remove "Time_signature_engraver"
-    \override Clef #'transparent = ##t
-    fontSize = #-3
-    \override StaffSymbol #'staff-space = #(magstep -3)
-    \override StaffSymbol #'thickness = #(magstep -3)
-  } \relative c'' {
+    \hide Clef
+    \magnifyStaff #2/3
+    \RemoveAllEmptyStaves
+  } \relative {
     R1*3
-    c4 e8 d c2
+    c''4 e8 d c2
   }
-  \new Staff \relative c' {
-    c4 b c2
+  \new Staff \relative {
+    c'4 b c2
     e4 f e2
     g4 a g2 \break
     c4 b c2
@@ -676,22 +719,14 @@ sobre @code{\RemoveEmptyStaves}, consulte @ref{Ocultar pentagramas}.
     e4 d c2
   }
 >>
-
-\layout {
-  \context {
-    \Staff \RemoveEmptyStaves
-    \override VerticalAxisGroup #'remove-first = ##t
-  }
-}
 @end lilypond
 
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {vertically-aligning-ossias-and-lyrics.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{ossia},
@@ -726,10 +761,9 @@ Referencia de funcionamiento interno:
 @cindex vacío, pentagrama
 
 @funindex \RemoveEmptyStaves
-@funindex RemoveEmptyStaves
+@funindex \RemoveAllEmptyStaves
 @funindex Staff_symbol_engraver
 @funindex \stopStaff
-@funindex stopStaff
 
 Se pueden ocultar las líneas del pentagrama quitando el grabador
 @code{Staff_symbol_engraver} del contexto de @code{Staff}.  Como
@@ -739,30 +773,36 @@ alternativa se puede utilizar la instrucción @code{\stopStaff}.
 \new Staff \with {
   \remove "Staff_symbol_engraver"
 }
-\relative c''' { a8 f e16 d c b a2 }
+\relative { a''8 f e16 d c b a2 }
 @end lilypond
 
-Se pueden ocultar los pentagramas que están vacíos mediante la
-instrucción @code{\RemoveEmptyStaves} dentro del bloque @code{\layout}
-para el contexto @code{\Staff}.  En las partituras orquestales, este
-estilo se conoce como @q{partitura a la francesa}.  De forma
-predeterminada, esta instrucción oculta y elimina todos los
-pentagramas vacíos de la partitura excepto los del primer sistema.
 
-@warning{Un pentagrama se considera vacío cuando contiene solamente
-silencios, silencios multicompás, desplazamientos, silencios de
-separación o una combinación de estos elementos.}
+Se pueden ocultar los pentagramas vacíos (para hacer la que se
+conoce como @q{partitura a la francesa}) aplicando la instrucción
+@code{\RemoveEmptyStaves} sobre un contexto, lo cual se puede
+hacer globalmente (dentro del bloque @code{\layout}) así como para
+pautas específicas solamente (dentro de un bloque @code{\with}).
+Esta instrucción elimina todas las pautas vacías de la partitura
+excepto las del primer sistema.  Si queremos ocultar también las
+del primer sistema, usamos @code{\RemoveAllEmptyStaves}.  Los
+contextos que están contemplados son @code{Staff},
+@code{RhythmicStaff} y @code{VaticanaStaff}.
+
+@warning{Un pentagrama se considera vacío cuando contiene
+solamente silencios, silencios multicompás, desplazamientos,
+silencios de separación o una combinación de estos elementos.}
 
 @lilypond[verbatim,quote,ragged-right]
 \layout {
   \context {
-    \Staff \RemoveEmptyStaves
+    \Staff
+    \RemoveEmptyStaves
   }
 }
 
-\relative c' <<
+\relative <<
   \new Staff {
-    e4 f g a \break
+    e'4 f g a \break
     b1 \break
     a4 b c2
   }
@@ -777,36 +817,16 @@ separación o una combinación de estos elementos.}
 @cindex ossia
 
 @noindent
-También se puede usar @code{\RemoveEmptyStaves} en el contexto
-@code{\Staff} para crear secciones de ossia para un pentagrama.  Para
-ver más detalles, consulte @ref{Pentagramas de Ossia}.
-
-@cindex ocultar pentagramas de música antigua
-@cindex ocultar pentagramas rítmicos
-
-@funindex \RemoveEmptyStaves
-@funindex RemoveEmptyStaves
-
-Se puede usar la instrucción @code{\RemoveEmptyStaves} para ocultar
-los pentagramas vacíos en contextos de música antigua como
-@code{\VaticanaStaff}.  De forma similar, se puede usar
-@code{\RhythmicStaff \RemoveEmptyStaves} para ocultar los contextos
-@code{RhythmicStaff} vacíos.
+También se puede usar @code{\RemoveAllEmptyStaves} para crear
+secciones de ossia para un pentagrama.  Para ver más detalles,
+consulte @ref{Pentagramas de Ossia}.
 
 
 @predefined
-@code{\Staff \RemoveEmptyStaves},
-@code{\VaticanaStaff \RemoveEmptyStaves},
-@code{\RhythmicStaff \RemoveEmptyStaves}.
+@code{\RemoveEmptyStaves},
+@code{\RemoveAllEmptyStaves}.
 @endpredefined
 
-
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{removing-the-first-empty-line.ly}
-
-
 @seealso
 Glosario musical:
 @rglos{Frenched staff}.
@@ -833,31 +853,30 @@ Referencia de funcionamiento interno:
 @rinternals{VerticalAxisGroup},
 @rinternals{Staff_symbol_engraver}.
 
-
 @knownissues
-
 La eliminación del grabador @code{Staff_symbol_engraver} también
-oculta las barras de compás.  Si se fuerza la visibilidad de la barra
-de compás, pueden ocurrir errores de formato visual.  En este caso,
-utilice las siguientes sobreescrituras de valores en vez de quitar el
-grabador:
+oculta las barras de compás.  Si se fuerza la visibilidad de la
+barra de compás, pueden ocurrir errores de formato visual.  En
+este caso, utilice las siguientes sobreescrituras de valores en
+vez de quitar el grabador:
 
 @example
-\override StaffSymbol #'stencil = ##f
-\override NoteHead #'no-ledgers = ##t
+\omit StaffSymbol
+\override NoteHead.no-ledgers = ##t
 @end example
 
-Para ver los fallos y problemas conocidos, así como las advertencias
-asociadas con @code{\RemoveEmptyStaves}, consulte
+Para ver los fallos y problemas conocidos, así como las
+advertencias asociadas con @code{\RemoveEmptyStaves}, consulte
 @ref{Cambiar los valores por omisión de los contextos}.
 
+
 @node Escritura de las particellas
 @subsection Escritura de las particellas
 @translationof Writing parts
 
-Esta sección explica cómo insertar indicaciones de tempo y nombres de
-instrumento en una partitura.  También se describen métodos para citar
-otras voces y dar formato a las notas guía.
+Esta sección explica cómo insertar indicaciones de tempo y nombres
+de instrumento en una partitura.  También se describen métodos
+para citar otras voces y dar formato a las notas guía.
 
 @menu
 * Nombres de instrumentos::
@@ -874,154 +893,150 @@ otras voces y dar formato a las notas guía.
 @cindex instrumento, nombre abreviado
 
 Se pueden imprimir los nombres de los instrumentos en el lado
-izquierdo de los pentagramas dentro de los contextos
-@code{Staff}, @code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff}
-y @code{ChoirStaff}.  El valor de @code{instrumentName} se usa para el
-primer pentagrama, y el valor de @code{shortInstrumentName} se usa
-para todos los pentagramas siguientes.
-
-@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"Violin "
-\set Staff.shortInstrumentName = #"Vln "
-c4.. g'16 c4.. g'16
-\break
-c1
+izquierdo de los pentagramas dentro de los contextos @code{Staff},
+@code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff} y
+@code{ChoirStaff}.  El valor de @code{instrumentName} se usa para
+el primer pentagrama, y el valor de @code{shortInstrumentName} se
+usa para todos los pentagramas siguientes.
+
+@lilypond[verbatim,quote,ragged-right]
+\new Staff \with {
+  instrumentName = #"Violin "
+  shortInstrumentName = #"Vln. "
+} \relative {
+  c'4.. g'16 c4.. g'16 \break | c1 |
+}
 @end lilypond
 
-También podemos usar el modo de marcado para construir nombres de
+@cindex instrumentos, nombres complejos de
+
+También podemos usar @code{\markup} para construir nombres de
 instrumento más complicados:
 
-@lilypond[verbatim,quote,relative=2]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c4 c,16 d e f g2
+@lilypond[verbatim,quote]
+\new Staff \with {
+  instrumentName = \markup {
+    \column { "Clarinetti"
+      \line { "in B" \smaller \flat }
+    }
+  }
+} \relative {
+  c''4 c,16 d e f g2
+}
 @end lilypond
 
 @cindex instrument names, centering
 
-Cuando se agrupan dos o más contextos de pentagrama, los nombres de
-instrumento y los nombres cortos aparecen centrados de forma
-predeterminada.  Para centrar nombres de instrumento de varias líneas,
-se debe utilizar @code{\center-column}:
+Cuando se agrupan dos o más contextos de pentagrama, los nombres
+de instrumento y los nombres cortos aparecen centrados de forma
+predeterminada.  Para centrar nombres de instrumento de varias
+líneas, se debe utilizar @code{\center-column}:
 
-@lilypond[verbatim,quote,indent=1.5\cm,relative=2]
+@lilypond[verbatim,quote,indent=1.5\cm]
 <<
-  \new Staff {
-    \set Staff.instrumentName = #"Flute"
-    f2 g4 f
-  }
-  \new Staff {
-    \set Staff.instrumentName = \markup \center-column {
-      Clarinet
-      \line { "in B" \smaller \flat }
+  \new Staff \with {
+    instrumentName = #"Flute"
+  } \relative {
+    f''2 g4 f
+}
+  \new Staff \with {
+    instrumentName = \markup {
+      \center-column { "Clarinet"
+        \line { "in B" \smaller \flat }
+      }
     }
-    c4 b c2
-  }
+  } \relative { c''4 b c2 }
 >>
 @end lilypond
 
 @funindex indent
 @funindex short-indent
 
-Sin embargo, si los nombres de instrumento son más largos, éstos no se
-centran para un grupo de pentagramas a no ser que se aumenten los
-valores del sangrado, @code{indent}, y del sangrado corto,
-@code{short-indent}.  Para ver más detalles sobre estos ajustes,
-consulte @ref{Variables de \paper para desplazamientos y sangrados}.
+Sin embargo, si los nombres de instrumento son más largos, éstos
+no se centran para un grupo de pentagramas a no ser que se
+aumenten los valores del sangrado, @code{indent}, y del sangrado
+corto, @code{short-indent}.  Para ver más detalles sobre estos
+ajustes, consulte
+@ref{Variables de paper para desplazamientos y sangrados,,Variables de @code{@bs{}paper} para desplazamientos y sangrados}.
 
 @lilypond[verbatim,quote,ragged-right]
-\layout {
-  indent = 3.0\cm
-  short-indent = 1.5\cm
-}
-
-\relative c'' <<
-  \new Staff {
-    \set Staff.instrumentName = #"Alto Flute in G"
-    \set Staff.shortInstrumentName = #"Fl."
-    f2 g4 f \break
+<<
+  \new Staff \with {
+    instrumentName = #"Alto Flute in G"
+    shortInstrumentName = #"Flt."
+  } \relative {
+    f''2 g4 f \break
     g4 f g2
   }
-  \new Staff {
-    \set Staff.instrumentName = #"Clarinet"
-    \set Staff.shortInstrumentName = #"Clar."
-    c,4 b c2 \break
+  \new Staff \with {
+    instrumentName = #"Clarinet"
+    shortInstrumentName = #"Clar."
+  } \relative {
+    c''4 b c2 \break
     c2 b4 c
   }
 >>
+
+\layout {
+  indent = 3.0\cm
+  short-indent = 1.5\cm
+}
 @end lilypond
 
 @cindex nombres de instrumento, añadir a otros contextos
 
 Para añadir nombres de instrumento a otros contextos (como
-@code{ChordNames} o @code{FiguredBass}), debemos
-añadir el grabador @code{Instrument_name_engraver} a dicho
-contexto. Para ver más detalles, consulte @ref{Modificar los complementos (plug-ins) de contexto}.
+@code{ChordNames} o @code{FiguredBass}), debemos añadir el
+grabador @code{Instrument_name_engraver} a dicho contexto. Para
+ver más detalles, consulte @ref{Modificar los complementos
+(plug-ins) de contexto}.
 
 @cindex nombres de instrumento, cambiar
 
-Los nombres de instrumento se pueden cambiar en mitad de una pieza;
-sin embargo, recuerde que el @code{instrumentName} no se imprime en
-mitad de la pieza, ya que sólo aparece en el primer pentagrama:
-
-@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"First"
-\set Staff.shortInstrumentName = #"one"
-c1 c c c \break
-c1 c c c \break
-\set Staff.instrumentName = #"Second"
-\set Staff.shortInstrumentName = #"two"
-c1 c c c \break
-c1 c c c \break
-@end lilypond
+El nombre de instrumento corto @code{shortInstrumentName} se puede
+cambiar en mitad de una pieza, igual que otros ajustes que pueden
+ser necesarios para el instrumento nuevo; sin embargo, sólo el
+primer @code{instrumentName} se imprime y el resto de ellos se
+ignoran:
 
-@cindex instrumento, cambio de
-@cindex cambio de instrumento
+@lilypond[verbatim,quote,ragged-right]
+prepPiccolo = <>^\markup \italic { muta in Piccolo }
 
-@funindex \addInstrumentDefinition
-@funindex addInstrumentDefinition
-@funindex \instrumentSwitch
-@funindex instrumentSwitch
+prepFlute = <>^\markup \italic { muta in Flauto }
 
-Si se necesita un @emph{cambio} de instrumento, se debe usar
-@code{\addInstrumentDefinition} en combinación con
-@code{\instrumentSwitch} para crear una lista detallada de los cambios
-necesarios para el intercambio.  La instrucción
-@code{\addInstrumentDefinition} tiene dos argumentos: una cadena
-identificativa, y una lista asociativa de propiedades de contexto y
-los valores que el instrumento va a usar.  Se debe situar en el ámbito
-del nivel más alto.  @code{\instrumentSwitch} se usa en la expresión
-musical para declarar el cambio de instrumento:
+setPiccolo = {
+  <>^\markup \bold { Piccolo }
+  \transposition c''
+}
 
-@lilypond[verbatim,quote,ragged-right]
-\addInstrumentDefinition #"contrabassoon"
-  #`((instrumentTransposition . ,(ly:make-pitch -1 0 0))
-     (shortInstrumentName . "Cbsn.")
-     (clefGlyph . "clefs.F")
-     (middleCPosition . 6)
-     (clefPosition . 2)
-     (instrumentCueName . ,(make-bold-markup "cbsn."))
-     (midiInstrument . "bassoon"))
+setFlute = {
+  <>^\markup \bold { Flute }
+  \transposition c'
+}
 
 \new Staff \with {
-  instrumentName = #"Bassoon"
+  instrumentName = #"Flute"
+  shortInstrumentName = #"Flt."
 }
-\relative c' {
-  \clef tenor
-  \compressFullBarRests
-  c2 g'
-  R1*16
-  \instrumentSwitch "contrabassoon"
-  c,,2 g \break
-  c,1 ~ | c1
+\relative {
+  g'1 g g g \break
+  g1 g \prepPiccolo R R \break
+  \set Staff.instrumentName = #"Piccolo"
+  \set Staff.shortInstrumentName = #"Picc."
+  \setPiccolo
+  g1 g g g \break
+  g1 g \prepFlute R R \break
+  \set Staff.instrumentName = #"Flute"
+  \set Staff.shortInstrumentName = #"Flt."
+  \setFlute
+  g1 g g g
 }
 @end lilypond
 
 
 @seealso
 Referencia de la notación:
-@ref{Variables de \paper para desplazamientos y sangrados},
+@ref{Variables de paper para desplazamientos y sangrados,,Variables de @code{@bs{}paper} para desplazamientos y sangrados},
 @ref{Modificar los complementos (plug-ins) de contexto}.
 
 Fragmentos de código:
@@ -1037,157 +1052,201 @@ Referencia de funcionamiento interno:
 @unnumberedsubsubsec Citar otras voces
 @translationof Quoting other voices
 
-@cindex guías
+@cindex guía, voces
 @cindex citar otras voces
-@cindex fragmentos
+@cindex fragmentos, citar
 @cindex notas guía
 
 @funindex \addQuote
-@funindex addQuote
 @funindex \quoteDuring
-@funindex quoteDuring
 @funindex \transposition
-@funindex transposition
 
-Es muy frecuente que una voz duplique música de otra voz.  Por
-ejemplo, los violines primero y segundo pueden tocar las mismas notas
-durante un pasaje musical.  En LilyPond esto se hace dejando que una
-voz @emph{cite} a la otra, sin tener que volverla a introducir.
+Es muy frecuente que una voz use las mismas notas que otra voz.
+Por ejemplo, los violines primero y segundo tocando la misma frase
+durante un determinado pasaje musical.  Esto se hace dejando que
+una voz @emph{cite} a la otra, sin tener que volver a introducir
+la música para la segunda voz.
 
-Antes de que una voz pueda citarse, se debe usar la instrucción
-@code{\addQuote} para iniciar el fragmento citado.  Esta instrucción
-se debe usar en el ámbito del nivel más alto.  El primer argumento es
-una cadena identificativa, y el segundo es una expresión musical:
+La instrucción @code{\addQuote}, utilizada en el ámbito del nivel
+sintáctico superior, define un flujo de música desde el que es
+posible citar fragmentos.
 
-@example
-flute = \relative c'' @{
-  a4 gis g gis
-@}
-\addQuote "flute" @{ \flute @}
-@end example
-
-La instrucción @code{\quoteDuring} se usa para indicar el punto en que
-comienza la cita.  va seguido por dos argumentos: el nombre de la voz
-citada, tal y como se definió con @code{\addQuote}, y una expresión
-musical que indica la duración de la cita, normalmente silencios de
-separación o silencios multicompás.  La música correspondiente
-(incluidas todas las articulaciones,
-matices, elementos de marcado, etc.) de la
-voz citada se inserta dentro de la expresión musical:
+La instrucción @code{\quoteDuring} se usa para indicar el punto en
+que comienza la cita.  Va seguida por dos argumentos: el nombre de
+la voz citada, tal y como se definió con @code{\addQuote}, y una
+expresión musical que indica la duración de la cita.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
+fluteNotes = \relative {
+  a'4 gis g gis | b4^"quoted" r8 ais\p a4( f)
 }
-\addQuote "flute" { \flute }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { s2 }
+oboeNotes = \relative {
+  c''4 cis c b \quoteDuring #"flute" { s1 }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
-Si la expresión musical que se usa para @code{\quoteDuring} contiene
-cualquier cosa que no sea un silencio de separación o un silencio
-multicompás, ase produce una situación de polifonía, lo que no suele
-ser deseable:
+Si la expresión musical que se usa para @code{\quoteDuring}
+contiene cualquier cosa que no sea un silencio de separación o un
+silencio multicompás, se produce una situación de polifonía, lo
+que no suele ser deseable:
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  a4 gis g gis
+fluteNotes = \relative {
+  a'4 gis g gis | b4^"quoted" r8 ais\p a4( f)
 }
-\addQuote "flute" { \flute }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { c4 b }
+oboeNotes = \relative {
+  c''4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
-Las citas reconocen los ajustes de transposición de los instrumentos
-tanto para la fuente como para los instrumentos de destino si se
-utiliza la instrucción @code{\transposition}.  Para ver más detalles
-sobre @code{\transposition}, consulte @ref{Transposición de los instrumentos}.
+Si una instrucción @code{\unfoldRepeats} dentro de una expresión
+musical se necesita imprimir al usar @code{\quoteDuring}, entonces
+debe contener también su propia instrucción @code{\unfoldRepeats};
 
 @lilypond[verbatim,quote]
-clarinet = \relative c'' {
-  \transposition bes
-  a4 gis g gis
+fluteNotes = \relative {
+  \repeat volta 2 { a'4 gis g gis }
 }
-\addQuote "clarinet" { \clarinet }
 
-\relative c' {
-  c4 cis \quoteDuring #"clarinet" { s2 }
+oboeNotesDW = \relative {
+  \repeat volta 2 \quoteDuring #"incorrect" { s1 }
 }
-@end lilypond
 
-Es posible etiquetar las citas con nombres exclusivos para poder
-procesarlas de diferentes maneras.  Para ver más detalles sobre este
-procedimiento, consulte @ref{Uso de etiquetas}.
+oboeNotesW = \relative {
+  \repeat volta 2 \quoteDuring #"correct" { s1 }
+}
+
+
+\addQuote "incorrect" { \fluteNotes }
 
-También es posible ajustar qué objetos de la voz original se citan
-mediante la modificación de la propiedad @code{quotedEventTypes}.  De
-forma predeterminada, su valor es @code{#'(StreamEvent)}, lo que
-significa que todo se cita.  Su establecimiento a,
-p.ej. @code{#'(note-event rest-event tie-event)} provoca que LilyPond
-cite solamente las notas, silencios y ligaduras de unión, pero no las
-articulaciones, los elementos de marcado ni los matices dinámicos.
+\addQuote "correct" { \unfoldRepeats \fluteNotes }
+
+\score {
+  \unfoldRepeats
+  <<
+    \new Staff \with { instrumentName = "Flute" }
+    \fluteNotes
+    \new Staff \with { instrumentName = "Oboe (incorrect)" }
+    \oboeNotesDW
+    \new Staff \with { instrumentName = "Oboe (correct)" }
+    \oboeNotesW
+  >>
+}
+@end lilypond
+
+La instrucción @code{\quoteDuring} usa los ajustes de
+@code{\transposition} tanto de la parte citada como de la que
+cita, para producir notas que tienen la misma altura de sonido en
+la parte que cita y en las de la parte citada.
 
 @lilypond[verbatim,quote]
-clarinet = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
+clarinetNotes = \relative c'' {
+  \transposition bes
+  \key d \major
+  b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
 }
-\addQuote "clarinet" { \clarinet }
 
-\relative c' {
-  \set Score.quotedEventTypes = #'(note-event rest-event tie-event)
-  c4 cis \quoteDuring #"clarinet" { s2 }
+oboeNotes = \relative {
+  c''4 cis c b \quoteDuring #"clarinet" { s1 }
 }
-@end lilypond
 
-@snippets
+\addQuote "clarinet" { \clarinetNotes }
+
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{quoting-another-voice-with-transposition.ly}
+\score {
+  <<
+    \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+}
+@end lilypond
 
 @cindex note-event
 @cindex articulation-event
 @cindex dynamic-event
 @cindex rest-event
+@cindex slur-event
+@cindex crescendo-event
 
 @funindex quotedEventTypes
 @funindex quotedCueEventTypes
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{quoting-another-voice.ly}
+De forma predeterminada, la música citada incluye todas las
+articulaciones, matices dinámicos, elementos de marcado, etc. de
+la expresión citada.  Es posible elegir cuáles de estos objetos de
+la música que se cita se imprimen, mediante la propiedad de
+contexto @code{quotedEventTypes}.
 
+@lilypond[verbatim,quote]
+fluteNotes = \relative {
+  a'2 g2 |
+  b4\<^"quoted" r8 ais a4\f( c->)
+ }
+
+oboeNotes = \relative {
+  c''2. b4 |
+  \quoteDuring #"flute" { s1 }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \set Score.quotedEventTypes = #'(note-event articulation-event
+                                     crescendo-event rest-event
+                                     slur-event dynamic-event)
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+ }
+@end lilypond
+
+Las citas también se pueden etiquetar, véase @ref{Uso de etiquetas}.
 
 @seealso
 Referencia de la notación:
 @ref{Transposición de los instrumentos},
 @ref{Uso de etiquetas}.
 
+Archivos de inicio:
+@file{scm/define-event-classes.scm}.
+
 Fragmentos de código:
 @rlsr{Staff notation}.
 
 Referencia de funcionamiento interno:
+@rinternals{Music classes},
 @rinternals{QuoteMusic},
 @rinternals{Voice}.
 
-
 @knownissues
-
 Sólo el contenido de la primera voz de una instrucción
-@code{\addQuote} se tiene en cuenta para la cita, de manera que la
-música no puede contener enunciados @code{\new} ni @code{\context
-Voice} que cambiarían a una voz distinta.
-
-La cita de notas de adorno no es funcional e incluso puede hacer que
-LilyPond termine de forma abrupta.
-
-La cita de unos tresillos dentro de otros puede dar como resultado una
-notación de pobre calidad.
-
-En anteriores versiones LilyPond (antes de la 2.11), @code{addQuote}
-se escribía completamente en minúsculas: @code{\addquote}.
+@code{\addQuote} se tiene en cuenta para la cita, de manera que si
+la expresión musical contiene enunciados @code{\new} o
+@code{\context Voice}, sus contenidos no serían citados.  La cita
+de notas de adorno no está contemplada y puede hacer que LilyPond
+termine de forma abrupta; la cita de unos tresillos dentro de
+otros puede dar como resultado una notación de pobre calidad.
 
 
 @node Formateo de las notas guía
@@ -1200,64 +1259,140 @@ se escribía completamente en minúsculas: @code{\addquote}.
 @cindex guía, notas, formato de
 @cindex fragmentos
 @cindex citar otras voces
+@cindex voces, citar
+
 
 @funindex \cueDuring
-@funindex cueDuring
+@funindex \cueClef
+@funindex \cueDuringWithClef
 @funindex \quoteDuring
-@funindex quoteDuring
 
-La sección anterior explica la forma de crear citas.  La instrucción
-@code{\cueDuring} es una forma más especializada de
-@code{\quoteDuring}, que es especialmente útil para insertar notas
-guía en una particella.  La sintaxis es como sigue:
+@cindex notas pequeñas
+@cindex pequeñas, notas
+@cindex CueVoice
+
+La manera más sencilla de dar formato a las notas guía es crear
+explícitamente un contexto @code{CueVoice} dentro de la parte.
+
+@lilypond[verbatim]
+\relative {
+  R1
+  <<
+    { e'2\rest r4. e8 }
+    \new CueVoice {
+      \stemUp d'8^"flute" c d e fis2
+    }
+  >>
+  d,4 r a r
+}
+@end lilypond
+
+La instrucción @code{\cueClef} puede usarse también con un
+contexto @code{CueVoice} explícito si se requiere un cambio de
+clave, e imprime una clave del tamaño adecuado para las notas
+guía.  Después puede utilizarse la instrucción
+@code{\cueClefUnset} para volver a la clave original, de nuevo con
+un signo de clave del tamaño adecuado.
+
+@lilypond[verbatim,noragged-right]
+\relative {
+  \clef "bass"
+  R1
+  <<
+    { e'2\rest r4. \cueClefUnset e,8 }
+    \new CueVoice {
+      \cueClef "treble" \stemUp d''8^"flute" c d e fis2
+    }
+  >>
+  d,,4 r a r
+}
+@end lilypond
+
+Las instrucciones @code{\cueClef} y @code{\cueClefUnset} se pueden
+usar también sin un @code{CueVoice} si es necesario.
+
+@lilypond[verbatim,noragged-right]
+\relative {
+  \clef "bass"
+  R1
+  \cueClef "treble"
+  d''8^"flute" c d e fis2
+  \cueClefUnset
+  d,,4 r a r
+}
+@end lilypond
+
+En casos de colocación más compleja de notas guía, por ejemplo con
+transposición o insertando notas guía procedentes de más de una
+fuente, pueden usarse las instrucciones @code{\cueDuring} o
+@code{\cueDuringWithClef}.  Son una forma más especializada de
+@code{\quoteDuring}, véase @ref{Citar otras voces} en la sección
+anterior.
+
+La sintaxis es:
 
 @example
-\cueDuring #@var{nombre_de_la_parte} #@var{voz} @var{música}
+\cueDuring #@var{nombre_de_la_cita} #@var{dirección} #@var{música}
 @end example
 
-Esta instrucción copia sólo las notas y los silencios de los compases
-correspondientes a partir de @code{@var{nombre_de_la_parte}} dentro de
-un contexto @code{CueVoice} de voz guía.  La voz guía @code{CueVoice}
-se crea implícitamente, y se produce simultáneamente con
-@code{@var{música}}, lo que crea una situación polifónica.  El
-argumento @code{@var{voz}} determina si la notación de las notas guía
-debe ser como primera o como segunda voz; @code{UP} (arriba)
-corresponde a la primera voz, y @code{DOWN} (abajo) corresponde a la
-segunda.
+y
+
+@example
+\cueDuringWithClef #@var{nombre_de_la_cita} #@var{dirección} #@var{clave} #@var{música}
+@end example
+
+La música procedente de los compases correspondientes del elemento
+@code{@var{nombre_de_la_cita}} se añade como un contexto
+@code{CueVoice} y ocurre simultáneamente con la
+@code{@var{música}}, lo que produce una situación polifónica.  La
+@code{@var{dirección}} toma un argumento @code{UP} (arriba) o
+@code{DOWN} (abajo), y corresponde a las voces primera y segunda,
+respectivamente, determinando cómo se imprimen las notas guía en
+relación a la otra voz.
 
 @lilypond[verbatim,quote]
-oboe = \relative c'' {
-  r2 r8 d16(\f f e g f a)
-  g8 g16 g g2.
+fluteNotes = \relative {
+  r2. c''4 | d8 c d e fis2 | g2 d |
 }
-\addQuote "oboe" { \oboe }
 
-\new Voice \relative c'' {
-  \cueDuring #"oboe" #UP { R1 }
+oboeNotes = \relative c'' {
+  R1
+  <>^\markup \tiny { flute }
+  \cueDuring #"flute" #UP { R1 }
   g2 c,
 }
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \oboeNotes
+}
 @end lilypond
 
 @noindent
-En el ejemplo anterior, el contexto @code{Voice} se tuvo que declarar
-explícitamente, pues en caso contrario toda la expresión musical
-habría pertenecido al contexto @code{CueVoice}.
+
 
 Es posible ajustar qué aspectos de la música se citan con
 @code{\cueDuring} estableciendo el valor de la propiedad
 @code{quotedCueEventTypes}.  Su valor por omisión es
-@code{#'(note-event rest-event tie-event beam-event
+@code{'(note-event rest-event tie-event beam-event
 tuplet-span-event)}, lo que significa que solamente las notas,
-silencios, ligaduras de unión, barras y grupos especiales se citan,
-pero no las articulaciones, marcas dinámicas, elementos de marcado,
-etc.
+silencios, ligaduras de unión, barras y grupos especiales se
+citan, pero no las articulaciones, marcas dinámicas, elementos de
+marcado, etc.
+
+@warning{Cuando un contexto @code{Voice} da comienzo con
+@code{\cueDuring}, como en el ejemplo siguiente, el contexto
+@code{Voice} se debe declarar explícitamente, pues en caso
+contrario toda la expresión musical pertenecería al contexto
+@code{CueVoice}.}
 
 @lilypond[verbatim,quote]
-oboe = \relative c'' {
-  r2 r8 d16(\f f e g f a)
+oboeNotes = \relative {
+  r2 r8 d''16(\f f e g f a)
   g8 g16 g g2.
 }
-\addQuote "oboe" { \oboe }
+\addQuote "oboe" { \oboeNotes }
 
 \new Voice \relative c'' {
   \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
@@ -1268,104 +1403,84 @@ oboe = \relative c'' {
 }
 @end lilypond
 
-Se pueden usar elementos de marcado para imprimir el nombre del
-instrumento citado.  También, si las notas guía requieren un cambio de
-clave, la clave original se debe restaurar al final de las notas guía.
+Se pueden usar elementos de marcado para mostrar el nombre del
+instrumento citado.  Si las notas guía requieren un cambio de
+clave, puede hacerse manualmente pero la clave original se debe
+restaurar al final de las notas guía.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  r2. c4 d8 c d e fis2 g2 d2
+fluteNotes = \relative {
+  r2. c''4 d8 c d e fis2 g2 d2
 }
-bassoon = \relative c {
+
+bassoonNotes = \relative c {
   \clef bass
   R1
   \clef treble
-  s1*0^\markup { \tiny "flute" }
+  <>^\markup \tiny { flute }
   \cueDuring #"flute" #UP { R1 }
   \clef bass
   g4. b8 d2
 }
-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }
+
 \new Staff {
-  \bassoon
+  \bassoonNotes
 }
 @end lilypond
 
-@cindex quitar notas guía
-@cindex notas guía, quitar
-
-@funindex \killCues
-@funindex killCues
-
-La instrucción @code{\killCues} quita las notas guía de una expresión
-musical, de manera que la misma expresión musical se puede usar para
-producir la particella instrumental con notas guía y la partitura.  La
-instrucción @code{\killCues} elimina solo las notas y eventos que
-fueron citados por parte de @code{\cueDuring}.  Otros elementos de
-marcado asociados con las citas, como los cambios de clave y una
-etiqueta que identifique el instrumento fuente, se pueden etiquetar
-para su inclusión selectiva dentro de la partitura; véase
-@ref{Uso de etiquetas}.
+De forma alternativa, puede usarse la función
+@code{\cueDuringWithClef} en su lugar.  Esta instrucción admite un
+argumento adicional para especificar el cambio de clave que se
+necesita imprimir para las notas guía, pero después imprime
+automáticamente la clave original una vez que ha finalizado la
+serie de notas guía.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  r2. c4 d8 c d e fis2 g2 d2
+fluteNotes = \relative {
+  r2. c''4 d8 c d e fis2 g2 d2
 }
-bassoon = \relative c {
+
+bassoonNotes = \relative c {
   \clef bass
   R1
-  \tag #'part {
-    \clef treble
-    s1*0^\markup { \tiny "flute" }
-  }
-  \cueDuring #"flute" #UP { R1 }
-  \tag #'part \clef bass
+  <>^\markup { \tiny "flute" }
+  \cueDuringWithClef #"flute" #UP #"treble" { R1 }
   g4. b8 d2
 }
-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }
 
 \new Staff {
-  \bassoon
+  \bassoonNotes
 }
-\new StaffGroup <<
-  \new Staff {
-    \flute
-  }
-  \new Staff {
-    \removeWithTag #'part { \killCues { \bassoon } }
-  }
->>
 @end lilypond
 
-De forma alternativa, los cambios de clave y las etiquetas de
-instrumentos se pueden recoger dentro de una definición de instrumento
-para su uso repetido, utilizando la instrucción
-@code{\addInstrumentDefinition} descrita en
-@ref{Nombres de instrumentos}.
-
 @funindex \transposedCueDuring
-@funindex transposedCueDuring
 
 Como @code{\quoteDuring}, @code{\cueDuring} tiene en cuenta las
 transposiciones instrumentales.  Las notas guía se producen en las
-alturas en que se escribirían para el instrumento que recibe la cita,
-para así producir las alturas de sonido del instrumento original.
+alturas en que se escribirían para el instrumento que recibe la
+cita, para así producir las alturas de sonido del instrumento
+original.
 
 Para transportar las notas guía de forma diferente, use
 @code{\transposedCueDuring}.  Esta instrucción acepta un argumento
-adicional para especificar (en modo absoluto) la altura impresa con
-que queremos representar el sonido de un Do central de concierto.
-Esto es útil para toma citas de un instrumento que está en un registro
-completamente diferente.
+adicional para especificar (en modo absoluto) la altura impresa
+con que queremos representar el sonido de un Do central de
+concierto.  Esto es útil para extraer citas de un instrumento que
+está en un registro completamente diferente.
 
 @lilypond[verbatim,quote]
-piccolo = \relative c''' {
+piccoloNotes = \relative {
   \clef "treble^8"
   R1
-  c8 c c e g2
+  c'''8 c c e g2
   c4 g g2
 }
-bassClarinet = \relative c' {
+
+bassClarinetNotes = \relative c' {
   \key d \major
   \transposition bes,
   d4 r a r
@@ -1373,41 +1488,74 @@ bassClarinet = \relative c' {
   d4 r a r
 }
 
-\addQuote "piccolo" { \piccolo }
+\addQuote "piccolo" { \piccoloNotes }
 
 <<
-  \new Staff \piccolo
-  \new Staff \bassClarinet
+  \new Staff \piccoloNotes
+  \new Staff \bassClarinetNotes
 >>
 @end lilypond
 
-@cindex notas más pequeñas
-@cindex pequeñas, notas más
+@cindex removing cue notes
+@cindex cue notes, removing
+
+@funindex \killCues
 
-Se puede crear un contexto de @code{CueVoice} explícitamente si se
-necesitan notas de un tamaño menor, por ejemplo para establecer una
-secuencia alternativa de notas más apropiada para una voz más aguda o
-más grave.
+La instrucción @code{\killCues} elimina las notas guía de una
+expresión musical, de forma que la misma expresión musical pueda
+utilizarse para producir la particella instrumental (con notas
+guía) y la partitura de conjunto.  La instrucción @code{\killCues}
+elimina solamente las notas y eventos que se han citado mediante
+@code{\cueDuring}.  Otros elementos de marcado asociados con las
+guías, como los cambios de clave o una etiqueta identificativa del
+instrumento fuente, pueden marcarse para su inclusión selectiva
+dentro de la partitura; véase @ref{Uso de etiquetas}.
 
-@lilypond[verbatim,relative=2]
-\time 12/8
-\key ees \major
-g4 ees8 f4 g8
-\stemDown
-<<
-  { d4. bes4 c8 }
-  \new CueVoice
-  { g'4. f4 ees8 }
+@lilypond[verbatim,quote]
+fluteNotes = \relative {
+  r2. c''4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \tag #'part {
+    \clef treble
+    <>^\markup \tiny { flute }
+  }
+  \cueDuring #"flute" #UP { R1 }
+  \tag #'part \clef bass
+  g4. b8 d2
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \bassoonNotes
+}
+
+\new StaffGroup <<
+  \new Staff {
+    \fluteNotes
+  }
+  \new Staff {
+    \removeWithTag #'part { \killCues { \bassoonNotes } }
+  }
 >>
-\stemUp
-d2. d2.
 @end lilypond
 
+Como alternativa, los cambios de clave y los letreros de
+instrumento se pueden recolectar dentro de una definición de
+instrumento para su uso repetido, utilizando
+@code{\addInstrumentDefinition} que se descibe en @ref{Nombres de
+instrumentos}.
 
 @seealso
 Referencia de la notación:
+@ref{Citar otras voces},
 @ref{Transposición de los instrumentos},
 @ref{Nombres de instrumentos},
+@ref{Clave},
 @ref{Guías musicales},
 @ref{Uso de etiquetas}.
 
@@ -1418,9 +1566,9 @@ Referencia de funcionamiento interno:
 @rinternals{CueVoice},
 @rinternals{Voice}.
 
-
 @knownissues
-
 Pueden ocurrir colisiones con los silencios si se usa
 @code{\cueDuring}, entre los contextos de @code{Voice} y de
-@code{CueVoice}.
+@code{CueVoice}.  Al usar @code{\cueDuringWithClef} o
+@code{\transposedCueDuring} el argumento adicional requerido para
+cada caso debe ir después de la cita y de la dirección.