X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fnotation%2Fstaff.itely;h=deb2c4b0c5ebfb5b4b9f68062f770179240f1265;hb=058370efc7e9710f149d0f444328bb1fcd7bdec1;hp=f2e6a9a46d113a25c78ff340abe535400f8b6abf;hpb=7892f31ec676b0f292c2a8edb4147d9f180daffb;p=lilypond.git

diff --git a/Documentation/es/notation/staff.itely b/Documentation/es/notation/staff.itely
index f2e6a9a46d..deb2c4b0c5 100644
--- a/Documentation/es/notation/staff.itely
+++ b/Documentation/es/notation/staff.itely
@@ -1,19 +1,21 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: 8656e359d629aed6990bb8d8d3da8eac2d2c311e
+    Translation of GIT committish: 9b0c8394bbd8510cfc39c40342879703a4b3d2c1
 
     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.2"
 
 @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
@@ -69,7 +71,7 @@ y grupos de ellos.
 
 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}.
+Para ver más detalles, consulte @ref{Crear y referenciar contextos}.
 
 El contexto básico de pentagrama es @code{Staff}:
 
@@ -119,14 +121,13 @@ moderna de canto gregoriano.  No muestra líneas divisorias.
 Se pueden definir contextos nuevos de pentagrama único.  Para ver más
 detalles, consulte @ref{Definir contextos nuevos}.
 
-
 @seealso
 Glosario musical:
 @rglos{staff},
 @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},
@@ -240,11 +241,10 @@ 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 +253,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
@@ -319,11 +319,9 @@ 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,13 +339,14 @@ 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
+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}.
@@ -391,6 +390,7 @@ 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
@@ -411,126 +411,161 @@ 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}.
+@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 startStaff
+@funindex \stopStaff
+@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=2]
-\new Staff \with {
-  \override StaffSymbol #'line-count = #3
-}
-{ d4 d d d }
+\stopStaff f4 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=2]
+f4 d \stopStaff
+\override Staff.StaffSymbol.line-count = #2
+\startStaff g, e |
+
+f'4 d \stopStaff
+\revert Staff.StaffSymbol.line-count
+\startStaff g, e |
 @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
-}
-{ e4 d c b }
+@lilypond[verbatim,quote,relative=2]
+f4 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
 @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}.
 
-@lilypond[verbatim,quote,relative=1]
+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=2]
 \new Staff \with {
-  \override StaffSymbol #'ledger-line-thickness = #'(1 . 0.2)
+  \override StaffSymbol.thickness = #3
 }
-{ e4 d c b }
+{ f4 d g, e }
 @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,relative=2]
 \new Staff \with {
-  \override StaffSymbol #'staff-space = #1.5
+  \override StaffSymbol.thickness = #2
+  \override StaffSymbol.ledger-line-thickness = #'(0.5 . 0.4)
 }
-{ a4 b c d }
+{ f'4 a, a,, f }
 @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
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.ledger-positions = #'(-3 -2 -1 2 5 6)
+}
+{ f'4 a, a,, f }
+@end lilypond
 
-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):
+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,relative=2]
-c2 c
-\stopStaff
-\override Staff.StaffSymbol #'line-count = #2
-\startStaff
-b2 b
-\stopStaff
-\revert Staff.StaffSymbol #'line-count
-\startStaff
-a2 a
+\new Staff \with {
+  \override StaffSymbol.ledger-extra = #4
+}
+{ f'4 a, d, 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.
+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).
 
-@lilypond[verbatim,quote,relative=2]
-c4 b a2
+@lilypond[verbatim,quote,relative=1]
+\override Staff.StaffSymbol.line-positions = #'(-8 0 2 4)
+d4 e f g
 \stopStaff
-b4 c d2
 \startStaff
-e4 d c2
+\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.
 
-@predefined
-@code{\startStaff},
-@code{\stopStaff}.
-@endpredefined
-
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol.staff-space = #1.5
+}
+{ f'4 d, g, e, }
+@end lilypond
 
 @snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {making-some-staff-lines-thicker-than-the-others.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{line},
@@ -590,7 +625,7 @@ 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'' {
+\new Staff = "main" \relative c'' {
   c4 b d c
   <<
     { c4 b d c }
@@ -599,8 +634,8 @@ cuando se necesitan sólo algunos pentagramas de ossia.
       \remove "Time_signature_engraver"
       alignAboveContext = #"main"
       fontSize = #-3
-      \override StaffSymbol #'staff-space = #(magstep -3)
-      \override StaffSymbol #'thickness = #(magstep -3)
+      \override StaffSymbol.staff-space = #(magstep -3)
+      \override StaffSymbol.thickness = #(magstep -3)
       firstClef = ##f
     }
     { e4 d f e }
@@ -619,12 +654,12 @@ en ejemplo siguiente.
 
 @lilypond[verbatim,quote,ragged-right]
 <<
-  \new Staff = ossia \with {
+  \new Staff = "ossia" \with {
     \remove "Time_signature_engraver"
-    \override Clef #'transparent = ##t
+    \hide Clef
     fontSize = #-3
-    \override StaffSymbol #'staff-space = #(magstep -3)
-    \override StaffSymbol #'thickness = #(magstep -3)
+    \override StaffSymbol.staff-space = #(magstep -3)
+    \override StaffSymbol.thickness = #(magstep -3)
   }
   { \stopStaff s1*6 }
 
@@ -632,7 +667,7 @@ en ejemplo siguiente.
     c4 b c2
     <<
       { e4 f e2 }
-      \context Staff = ossia {
+      \context Staff = "ossia" {
         \startStaff e4 g8 f e2 \stopStaff
       }
     >>
@@ -640,7 +675,7 @@ en ejemplo siguiente.
     c4 b c2
     <<
       { g4 a g2 }
-      \context Staff = ossia {
+      \context Staff = "ossia" {
         \startStaff g4 e8 f g2 \stopStaff
       }
     >>
@@ -657,12 +692,12 @@ sobre @code{\RemoveEmptyStaves}, 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
+    \hide Clef
     fontSize = #-3
-    \override StaffSymbol #'staff-space = #(magstep -3)
-    \override StaffSymbol #'thickness = #(magstep -3)
+    \override StaffSymbol.staff-space = #(magstep -3)
+    \override StaffSymbol.thickness = #(magstep -3)
   } \relative c'' {
     R1*3
     c4 e8 d c2
@@ -680,7 +715,7 @@ sobre @code{\RemoveEmptyStaves}, consulte @ref{Ocultar pentagramas}.
 \layout {
   \context {
     \Staff \RemoveEmptyStaves
-    \override VerticalAxisGroup #'remove-first = ##t
+    \override VerticalAxisGroup.remove-first = ##t
   }
 }
 @end lilypond
@@ -688,10 +723,9 @@ sobre @code{\RemoveEmptyStaves}, consulte @ref{Ocultar pentagramas}.
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {vertically-aligning-ossias-and-lyrics.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{ossia},
@@ -802,11 +836,9 @@ los pentagramas vacíos en contextos de música antigua como
 
 
 @snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {removing-the-first-empty-line.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{Frenched staff}.
@@ -833,9 +865,7 @@ 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,
@@ -843,14 +873,15 @@ 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
 @ref{Cambiar los valores por omisión de los contextos}.
 
+
 @node Escritura de las particellas
 @subsection Escritura de las particellas
 @translationof Writing parts
@@ -881,21 +912,27 @@ 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
+\new Staff \with {
+  instrumentName = #"Violin "
+  shortInstrumentName = #"Vln. "
+}
+{ c4.. 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
+\new Staff \with {
+  instrumentName = \markup {
+    \column { "Clarinetti"
+      \line { "in B" \smaller \flat }
+    }
+  }
+}
+{ c4 c,16 d e f g2 }
 @end lilypond
 
 @cindex instrument names, centering
@@ -907,17 +944,17 @@ se debe utilizar @code{\center-column}:
 
 @lilypond[verbatim,quote,indent=1.5\cm,relative=2]
 <<
-  \new Staff {
-    \set Staff.instrumentName = #"Flute"
-    f2 g4 f
+  \new Staff \with {
+    instrumentName = #"Flute"
   }
-  \new Staff {
-    \set Staff.instrumentName = \markup \center-column {
-      Clarinet
+  { f2 g4 f }
+  \new Staff \with {
+    instrumentName = \markup {
+      \center-column { "Clarinet" }
       \line { "in B" \smaller \flat }
     }
-    c4 b c2
   }
+  { c4 b c2 }
 >>
 @end lilypond
 
@@ -928,28 +965,34 @@ 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}.
+consulte @ref{Variables de paper para desplazamientos y sangrados,,Variables de @code{@bs{}paper} para desplazamientos y sangrados}.
 
 @lilypond[verbatim,quote,ragged-right]
+\relative c'' {
+  <<
+    \new Staff \with {
+      instrumentName = #"Alto Flute in G"
+      shortInstrumentName = #"Flt."
+    }
+    {
+      f2 g4 f \break
+      g4 f g2
+    }
+    \new Staff \with {
+      instrumentName = #"Clarinet"
+      shortInstrumentName = #"Clar."
+    }
+    {
+      c,4 b c2 \break
+      c2 b4 c
+    }
+  >>
+}
+
 \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
-    g4 f g2
-  }
-  \new Staff {
-    \set Staff.instrumentName = #"Clarinet"
-    \set Staff.shortInstrumentName = #"Clar."
-    c,4 b c2 \break
-    c2 b4 c
-  }
->>
 @end lilypond
 
 @cindex nombres de instrumento, añadir a otros contextos
@@ -961,19 +1004,23 @@ contexto. Para ver más detalles, consulte @ref{Modificar los complementos (plug
 
 @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:
+El nombre de instrumento corto @code{shortInstrumentName} se puede
+cambiar en mitad de una pieza; sin embargo, sólo el primer
+@code{instrumentName} se imprime y el resto de ellos se ignoran:
 
 @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
+\new Staff \with {
+  instrumentName = #"Flute"
+  shortInstrumentName = #"Flt."
+}
+{
+  c1 c c c \break
+  c1 c c c \break
+  \set Staff.instrumentName = #"Clarinet"
+  \set Staff.shortInstrumentName = #"Clt."
+  c1 c c c \break
+  c1 c c c \break
+}
 @end lilypond
 
 @cindex instrumento, cambio de
@@ -1014,14 +1061,13 @@ musical para declarar el cambio de instrumento:
   R1*16
   \instrumentSwitch "contrabassoon"
   c,,2 g \break
-  c,1 ~ | c1
+  c,1 ~ | 1
 }
 @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,9 +1083,9 @@ 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
@@ -1049,40 +1095,37 @@ Referencia de funcionamiento interno:
 @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:
-
-@example
-flute = \relative c'' @{
-  a4 gis g gis
-@}
-\addQuote "flute" @{ \flute @}
-@end example
+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.
 
 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
+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, 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:
+musical que indica la duración de la cita.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
+fluteNotes = \relative c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
 }
-\addQuote "flute" { \flute }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { s2 }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"flute" { s1 }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
@@ -1092,103 +1135,119 @@ 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 c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
 }
-\addQuote "flute" { \flute }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { c4 b }
+oboeNotes = \relative c'' {
+  c4 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}.
+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'' {
+clarinetNotes = \relative c'' {
   \transposition bes
-  a4 gis g gis
+  \key d \major
+  b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
 }
-\addQuote "clarinet" { \clarinet }
 
-\relative c' {
-  c4 cis \quoteDuring #"clarinet" { s2 }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"clarinet" { 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}.
+\addQuote "clarinet" { \clarinetNotes }
 
-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.
 
-@lilypond[verbatim,quote]
-clarinet = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
-}
-\addQuote "clarinet" { \clarinet }
-
-\relative c' {
-  \set Score.quotedEventTypes = #'(note-event rest-event tie-event)
-  c4 cis \quoteDuring #"clarinet" { s2 }
+\score {
+  <<
+    \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{quoting-another-voice-with-transposition.ly}
-
 @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 c'' {
+  a2 g2 |
+  b4\<^"quoted" r8 ais a4\f( c->)
+ }
+
+oboeNotes = \relative c'' {
+  c2. 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
+@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.
 
-En anteriores versiones LilyPond (antes de la 2.11), @code{addQuote}
-se escribía completamente en minúsculas: @code{\addquote}.
-
 
 @node Formateo de las notas guía
 @unnumberedsubsubsec Formateo de las notas guía
@@ -1200,64 +1259,136 @@ 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 cueClef
+@funindex \cueDuringWithClef
+@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=1]
+R1
+<<
+  { e2\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=1]
+\clef "bass"
+R1
+<<
+  { e2\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=1]
+\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 c'' {
+  r2. c4 | d8 c d e fis2 | g2 d |
 }
-\addQuote "oboe" { \oboe }
 
-\new Voice \relative c'' {
-  \cueDuring #"oboe" #UP { R1 }
+oboeNotes = \relative c'' {
+  R1
+  \new CueVoice { \set instrumentCueName = "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.
 
+@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'' {
+oboeNotes = \relative c'' {
   r2 r8 d16(\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,81 +1399,63 @@ 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.
+El nombre del instrumento que está tocando se puede imprimir si se
+ajusta la propiedad @code{instrumentCueName} dentro de un contexto
+@code{CueVoice} provisional.  La colocación y estilo del
+@code{instrumentCueName} viene controlado a través del objeto
+@code{InstrumentSwitch}, véase @ref{Nombres de instrumentos}. 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'' {
+fluteNotes = \relative c'' {
   r2. c4 d8 c d e fis2 g2 d2
 }
-bassoon = \relative c {
+
+bassoonNotes = \relative c {
   \clef bass
   R1
   \clef treble
-  s1*0^\markup { \tiny "flute" }
+  \new CueVoice { \set instrumentCueName = "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 clabe 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'' {
+fluteNotes = \relative c'' {
   r2. c4 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
+  \new CueVoice { \set instrumentCueName = "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
 
@@ -1359,13 +1472,14 @@ Esto es útil para toma citas de un instrumento que está en un registro
 completamente diferente.
 
 @lilypond[verbatim,quote]
-piccolo = \relative c''' {
+piccoloNotes = \relative c''' {
   \clef "treble^8"
   R1
   c8 c c e g2
   c4 g g2
 }
-bassClarinet = \relative c' {
+
+bassClarinetNotes = \relative c' {
   \key d \major
   \transposition bes,
   d4 r a r
@@ -1373,41 +1487,76 @@ 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
+@funindex killCues
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
+
+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}.
 
-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.
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}
 
-@lilypond[verbatim,relative=2]
-\time 12/8
-\key ees \major
-g4 ees8 f4 g8
-\stemDown
-<<
-  { d4. bes4 c8 }
-  \new CueVoice
-  { g'4. f4 ees8 }
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \tag #'part {
+    \clef treble
+    \new CueVoice { \set instrumentCueName = "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 +1567,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.