Merge branch 'master' into lilypond/translation

[lilypond.git] / Documentation / es / notation / staff.itely

diff --git a/Documentation/es/notation/staff.itely b/Documentation/es/notation/staff.itely
index b80d1d979ca728efaebb1999b48116afb117eedb..fa2c18086fe5266a9e9ed8c14edd8e0b0e29da00 100644 (file)
--- a/Documentation/es/notation/staff.itely
+++ b/Documentation/es/notation/staff.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore

-    Translation of GIT committish: 36dd3392bcc0462f7d8af5f5a8bf24c544e43cda
+    Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5

 
     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
 
 
     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.14.0"

 
 @node Notación de los pentagramas
 @section Notación de los pentagramas
 
 @node Notación de los pentagramas
 @section Notación de los pentagramas


@@ -241,10 +241,10 @@ más detalles, consulte @ref{Definir contextos nuevos}.
 
 @snippets
 
 
 @snippets
 

-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]

 {use-square-bracket-at-the-start-of-a-staff-group.ly}
 
 {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»
 {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
 
 @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
 {mensurstriche-layout-bar-lines-between-the-staves.ly}
 
 @seealso


@@ -320,7 +320,7 @@ Para ver más detalles, consulte @ref{Definir contextos nuevos}.
 
 @snippets
 
 
 @snippets
 

-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]

 {nesting-staves.ly}
 
 
 {nesting-staves.ly}
 
 


@@ -527,7 +527,7 @@ e4 d c2
 
 @snippets
 
 
 @snippets
 

-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]

 {making-some-staff-lines-thicker-than-the-others.ly}
 
 
 {making-some-staff-lines-thicker-than-the-others.ly}
 
 


@@ -688,7 +688,7 @@ sobre @code{\RemoveEmptyStaves}, consulte @ref{Ocultar pentagramas}.
 
 @snippets
 
 
 @snippets
 

-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]

 {vertically-aligning-ossias-and-lyrics.ly}
 
 
 {vertically-aligning-ossias-and-lyrics.ly}
 
 


@@ -803,7 +803,7 @@ los pentagramas vacíos en contextos de música antigua como
 
 @snippets
 
 
 @snippets
 

-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]

 {removing-the-first-empty-line.ly}
 
 
 {removing-the-first-empty-line.ly}
 
 


@@ -874,8 +874,9 @@ 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
 @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} y
-@code{PianoStaff}.  El valor de @code{instrumentName} se usa para el
+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.
 
 primer pentagrama, y el valor de @code{shortInstrumentName} se usa
 para todos los pentagramas siguientes.
 


@@ -954,7 +955,7 @@ consulte @ref{Variables de \paper para desplazamientos y sangrados}.
 @cindex nombres de instrumento, añadir a otros contextos
 
 Para añadir nombres de instrumento a otros contextos (como
 @cindex nombres de instrumento, añadir a otros contextos
 
 Para añadir nombres de instrumento a otros contextos (como

-@code{GrandStaff}, @code{ChoirStaff} o @code{StaffGroup}), debemos
+@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}.
 
 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}.
 


@@ -1036,9 +1037,9 @@ Referencia de funcionamiento interno:
 @unnumberedsubsubsec Citar otras voces
 @translationof Quoting other voices
 
 @unnumberedsubsubsec Citar otras voces
 @translationof Quoting other voices
 

-@cindex guías
+@cindex guía, voces

 @cindex citar otras voces
 @cindex citar otras voces

-@cindex fragmentos
+@cindex fragmentos, citar

 @cindex notas guía
 
 @funindex \addQuote
 @cindex notas guía
 
 @funindex \addQuote


@@ -1048,116 +1049,132 @@ Referencia de funcionamiento interno:
 @funindex \transposition
 @funindex transposition
 
 @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
 
 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
 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]
 
 @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
 
 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
 }
 @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
+multicompás, se produce una situación de polifonía, lo que no suele

 ser deseable:
 
 @lilypond[verbatim,quote]
 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
 
 }
 @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]
 
 @lilypond[verbatim,quote]

-clarinet = \relative c'' {
+clarinetNotes = \relative c'' {

   \transposition bes
   \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}.

 
 

-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 "clarinet" { \clarinetNotes }

 
 

-@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
 
 }
 @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 note-event
 @cindex articulation-event
 @cindex dynamic-event
 @cindex rest-event

+@cindex slur-event
+@cindex crescendo-event

 
 @funindex quotedEventTypes
 @funindex quotedCueEventTypes
 
 
 @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:
 
 @seealso
 Referencia de la notación:


@@ -1168,26 +1185,24 @@ Fragmentos de código:
 @rlsr{Staff notation}.
 
 Referencia de funcionamiento interno:
 @rlsr{Staff notation}.
 
 Referencia de funcionamiento interno:

+@rinternals{Music classes},

 @rinternals{QuoteMusic},
 @rinternals{Voice}.
 
 @rinternals{QuoteMusic},
 @rinternals{Voice}.
 

+Archivos de inicio:
+@file{scm/define-event-classes.scm}.

 
 

-@knownissues

 
 

+@knownissues

 Sólo el contenido de la primera voz de una instrucción
 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.
 
 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
 
 @node Formateo de las notas guía
 @unnumberedsubsubsec Formateo de las notas guía


@@ -1199,64 +1214,136 @@ se escribía completamente en minúsculas: @code{\addquote}.
 @cindex guía, notas, formato de
 @cindex fragmentos
 @cindex citar otras voces
 @cindex guía, notas, formato de
 @cindex fragmentos
 @cindex citar otras voces

+@cindex voces, citar
+

 
 @funindex \cueDuring
 @funindex cueDuring
 
 @funindex \cueDuring
 @funindex cueDuring

+@funindex \cueClef
+@funindex cueClef
+@funindex \cueDuringWithClef
+@funindex cueDuringWithClef

 @funindex \quoteDuring
 @funindex quoteDuring
 
 @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
+imprimirá 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 de mayor complejidad 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
 
 @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
 
 @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]
 
 @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
+  s1*0^\markup { \tiny "flute" }
+  \cueDuring #"flute" #UP { R1 }

   g2 c,
 }
   g2 c,
 }

+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \oboeNotes
+}

 @end lilypond
 
 @noindent
 @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
 
 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.
 
 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]
 @lilypond[verbatim,quote]

-oboe = \relative c'' {
+oboeNotes = \relative c'' {

   r2 r8 d16(\f f e g f a)
   g8 g16 g g2.
 }
   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
 
 \new Voice \relative c'' {
   \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event


@@ -1269,13 +1356,15 @@ oboe = \relative c'' {
 
 Se pueden usar elementos de marcado para imprimir el nombre del
 instrumento citado.  También, si las notas guía requieren un cambio de
 
 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.
+clave, puede hacerse manualmente pero la clave original se debe
+restaurar al final de las notas guía.

 
 @lilypond[verbatim,quote]
 
 @lilypond[verbatim,quote]

-flute = \relative c'' {
+fluteNotes = \relative c'' {

   r2. c4 d8 c d e fis2 g2 d2
 }
   r2. c4 d8 c d e fis2 g2 d2
 }

-bassoon = \relative c {
+
+bassoonNotes = \relative c {

   \clef bass
   R1
   \clef treble
   \clef bass
   R1
   \clef treble


@@ -1284,64 +1373,41 @@ bassoon = \relative c {
   \clef bass
   g4. b8 d2
 }
   \clef bass
   g4. b8 d2
 }

-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }
+

 \new Staff {
 \new Staff {

-  \bassoon
+  \bassoonNotes

 }
 @end lilypond
 
 }
 @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]
 
 @lilypond[verbatim,quote]

-flute = \relative c'' {
+fluteNotes = \relative c'' {

   r2. c4 d8 c d e fis2 g2 d2
 }
   r2. c4 d8 c d e fis2 g2 d2
 }

-bassoon = \relative c {
+
+bassoonNotes = \relative c {

   \clef bass
   R1
   \clef bass
   R1

-  \tag #'part {
-    \clef treble
-    s1*0^\markup { \tiny "flute" }
-  }
-  \cueDuring #"flute" #UP { R1 }
-  \tag #'part \clef bass
+  s1*0^\markup { \tiny "flute" }
+  \cueDuringWithClef #"flute" #UP #"treble" { R1 }

   g4. b8 d2
 }
   g4. b8 d2
 }

-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }

 
 \new Staff {
 
 \new Staff {

-  \bassoon
+  \bassoonNotes

 }
 }

-\new StaffGroup <<
-  \new Staff {
-    \flute
-  }
-  \new Staff {
-    \removeWithTag #'part { \killCues { \bassoon } }
-  }
->>

 @end lilypond
 
 @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
 
 @funindex \transposedCueDuring
 @funindex transposedCueDuring
 


@@ -1358,13 +1424,14 @@ Esto es útil para toma citas de un instrumento que está en un registro
 completamente diferente.
 
 @lilypond[verbatim,quote]
 completamente diferente.
 
 @lilypond[verbatim,quote]

-piccolo = \relative c''' {
+piccoloNotes = \relative c''' {

   \clef "treble^8"
   R1
   c8 c c e g2
   c4 g g2
 }
   \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
   \key d \major
   \transposition bes,
   d4 r a r


@@ -1372,41 +1439,77 @@ bassClarinet = \relative c' {
   d4 r a r
 }
 
   d4 r a r
 }
 

-\addQuote "piccolo" { \piccolo }
+\addQuote "piccolo" { \piccoloNotes }

 
 <<
 
 <<

-  \new Staff \piccolo
-  \new Staff \bassClarinet
+  \new Staff \piccoloNotes
+  \new Staff \bassClarinetNotes

 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@cindex notas más pequeñas
-@cindex pequeñas, notas más
+@cindex removing cue notes
+@cindex cue notes, removing

 
 

-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.
+@funindex \killCues
+@funindex killCues
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition

 
 

-@lilypond[verbatim,relative=2]
-\time 12/8
-\key ees \major
-g4 ees8 f4 g8
-\stemDown
-<<
-  { d4. bes4 c8 }
-  \new CueVoice
-  { g'4. f4 ees8 }
+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,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  \tag #'part {
+    \clef treble
+    s1*0^\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
 
 @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:
 
 @seealso
 Referencia de la notación:

+@ref{Citar otras voces},

 @ref{Transposición de los instrumentos},
 @ref{Nombres de instrumentos},
 @ref{Transposición de los instrumentos},
 @ref{Nombres de instrumentos},

+@ref{Clave},

 @ref{Guías musicales},
 @ref{Uso de etiquetas}.
 
 @ref{Guías musicales},
 @ref{Uso de etiquetas}.
 


@@ -1422,4 +1525,6 @@ Referencia de funcionamiento interno:
 
 Pueden ocurrir colisiones con los silencios si se usa
 @code{\cueDuring}, entre los contextos de @code{Voice} y de
 
 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.