lilypond-book robustness: ensure EOL at the end of @verbatim

[lilypond.git] / Documentation / es / user / vocal.itely

diff --git a/Documentation/es/user/vocal.itely b/Documentation/es/user/vocal.itely
index fd543f53a5b6be5953d3ecc9bd4b68edbd5f3090..d2b1032b1fca5beda978acfb9129199e5294d022 100644 (file)
--- a/Documentation/es/user/vocal.itely
+++ b/Documentation/es/user/vocal.itely
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore

-    Translation of GIT committish: 7f5cef855d798bc0bc9d415c13a1e3d2bd84cd87
+    Translation of GIT committish: d4f58bb3ad4e7fe1967a6b48f25e3addffc8aa14

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 

-@c \version "2.11.61"
+@c \version "2.12.0"

 
 
 @node Vocal music
 
 
 @node Vocal music


@@ -30,7 +30,7 @@ de que la letra se alinea con las notas de su melodía correspondiente.
 @node Common notation for vocal music
 @subsection Common notation for vocal music
 
 @node Common notation for vocal music
 @subsection Common notation for vocal music
 

-Esta sección trata sobre asuntos relacinados con la música vocal en
+Esta sección trata sobre asuntos relacionados con la música vocal en

 general y con ciertos estilos concretos de música vocal.
 
 
 general y con ciertos estilos concretos de música vocal.
 
 


@@ -38,8 +38,8 @@ general y con ciertos estilos concretos de música vocal.
 * References for vocal music and lyrics::
 * Opera::
 * Song books::
 * References for vocal music and lyrics::
 * Opera::
 * Song books::

-* Chants::

 * Spoken music::
 * Spoken music::

+* Chants::

 * Ancient vocal music::
 @end menu
 
 * Ancient vocal music::
 @end menu
 


@@ -97,12 +97,13 @@ Continuará...
 @unnumberedsubsubsec Song books
 
 @c TODO
 @unnumberedsubsubsec Song books
 
 @c TODO

-Continuaará...
+Continuará...

 
 @snippets
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {simple-lead-sheet.ly}
 
 
 @snippets
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {simple-lead-sheet.ly}
 

+

 @seealso
 Referencia de la notación:
 @ref{Chord notation}.
 @seealso
 Referencia de la notación:
 @ref{Chord notation}.


@@ -144,8 +145,8 @@ Continuará...
 @c Add "Printing both the ancient and the modern clef in vocal music" snippet,
 @c and "Transcription of Ancient music with incipit" snippet. -vv
 
 @c Add "Printing both the ancient and the modern clef in vocal music" snippet,
 @c and "Transcription of Ancient music with incipit" snippet. -vv
 

-@seealso

 
 

+@seealso

 Referencia de la notación:
 @ref{Ancient notation}.
 
 Referencia de la notación:
 @ref{Ancient notation}.
 


@@ -171,6 +172,15 @@ Referencia de la notación:
 @cindex espacios, en la letra
 @cindex comillas, en la letra
 
 @cindex espacios, en la letra
 @cindex comillas, en la letra
 

+@c FIXME: this section is to be rewritten.
+Dado que los archivos de entrada de LilyPond son de texto, existe al
+menos un asunto que tener en cuenta al trabajar con música vocal: los
+textos de las canciones se deben interpretar como texto, no como
+notas.  Por ejemplo, la entrada@tie{}@code{d} debe interpretarse como
+una sílaba de una sola letra, no como la nota@tie{}Re.  Por tanto se
+hace necesario utilizar un modo especial para la letra, ya sea
+explícitamente o mediante el uso de métodos abreviados.
+

 La letra de las canciones se introduce en un modo de entrada especial
 que se inicia mediante la palabra clave @code{\lyricmode}, o bien
 mediante @code{\addlyrics} ó @code{\lyricsto}.  En este modo puede
 La letra de las canciones se introduce en un modo de entrada especial
 que se inicia mediante la palabra clave @code{\lyricmode}, o bien
 mediante @code{\addlyrics} ó @code{\lyricsto}.  En este modo puede


@@ -284,6 +294,8 @@ código ASCII por encima del 127, o una combinación de dos caracteres
 consistente en la combinación de una barra invertida seguida por
 @code{`}, @code{'}, @code{"} ó @code{^}.
 
 consistente en la combinación de una barra invertida seguida por
 @code{`}, @code{'}, @code{"} ó @code{^}.
 

+@c " to balance double quotes for not-so-bright context-sensitive editors
+

 Para definir identificadores que contengan letra, se debe usar la
 función @code{lyricmode}.
 
 Para definir identificadores que contengan letra, se debe usar la
 función @code{lyricmode}.
 


@@ -303,11 +315,15 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 
 
 @seealso
 
 
 @seealso

+Referencia de la notación:
+@ref{Fonts}.

 
 

-Referencia de funcionamiento interno: @rinternals{LyricText},
+Referencia de funcionamiento interno:
+@rinternals{LyricText},

 @rinternals{LyricSpace}.
 
 
 @rinternals{LyricSpace}.
 
 

+@c FIXME: this title has to be changed (possible confusion with LM) -vv

 @node Setting simple songs
 @unnumberedsubsubsec Setting simple songs
 
 @node Setting simple songs
 @unnumberedsubsubsec Setting simple songs
 


@@ -353,7 +369,7 @@ Para definir identificadores que contengan texto, se debe usar la
 función @code{\lyricmode}.  Si embargo no tendrá que escribir las
 duraciones, si añade @code{\addlyrics} o @code{\lyricsto} en el
 momento de invocar el identificador.
 función @code{\lyricmode}.  Si embargo no tendrá que escribir las
 duraciones, si añade @code{\addlyrics} o @code{\lyricsto} en el
 momento de invocar el identificador.

- 
+

 @example
 verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 \score @{
 @example
 verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 \score @{


@@ -367,7 +383,7 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
  >>
 @}
 @end example
  >>
 @}
 @end example

- 
+

 Para arreglos distintos o más complejos, la mejor forma es preparar
 previamente la jerarquía de pautas y textos, p.ej.:
 @example
 Para arreglos distintos o más complejos, la mejor forma es preparar
 previamente la jerarquía de pautas y textos, p.ej.:
 @example


@@ -378,18 +394,18 @@ previamente la jerarquía de pautas y textos, p.ej.:
   \new Voice = "tenor" @{ @emph{música} @}
 >>
 @end example
   \new Voice = "tenor" @{ @emph{música} @}
 >>
 @end example

- 
+

 y después combinar las melodías y líneas de texto correspondientes:
 y después combinar las melodías y líneas de texto correspondientes:

- 
+

 @example
 \context Lyrics = textoSoprano \lyricsto "soprano"
 @emph{el texto}
 @end example
 @example
 \context Lyrics = textoSoprano \lyricsto "soprano"
 @emph{el texto}
 @end example

- 
+

 @noindent
 
 El código de entrada definitivo sería algo como
 @noindent
 
 El código de entrada definitivo sería algo como

- 
+

 @example
 <<\new ChoirStaff << @emph{prepare la música} >>
  \lyricsto "soprano" @emph{etc}
 @example
 <<\new ChoirStaff << @emph{prepare la música} >>
  \lyricsto "soprano" @emph{etc}


@@ -397,12 +413,15 @@ El código de entrada definitivo sería algo como
 @emph{etc}
 >>
 @end example
 @emph{etc}
 >>
 @end example

- 
+
+

 @seealso
 @seealso

- 

 @c TODO: document \new Staff << Voice \lyricsto >> bug
 Referencia de funcionamiento interno:
 @c TODO: document \new Staff << Voice \lyricsto >> bug
 Referencia de funcionamiento interno:

-@rinternals{LyricCombineMusic}, @rinternals{Lyrics}.
+@rinternals{LyricCombineMusic},
+@rinternals{Lyrics}.
+
+

 
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody


@@ -411,6 +430,11 @@ Referencia de funcionamiento interno:
 @funindex \addlyrics
 @funindex \lyricsto
 
 @funindex \addlyrics
 @funindex \lyricsto
 

+La alineación del texto con las melodías se puede hacer
+automáticamente, pero si especificamos las duraciones de las sílabas
+también puede hacerse de forma manual.  La alineación y el
+tipografiado de la letra se preparan con la ayuda de saltos o
+@i{skips}, guiones y líneas extensoras.

 
 La letra se imprime a través de su interpretación dentro del contexto
 llamado @rinternals{Lyrics}.
 
 La letra se imprime a través de su interpretación dentro del contexto
 llamado @rinternals{Lyrics}.


@@ -432,14 +456,21 @@ o especificando la duración de cada sílaba explícitamente, utilizando
 @code{\lyricmode}
 @end itemize
 
 @code{\lyricmode}
 @end itemize
 

+El contexto @code{Voice} que contiene la melodía con la que se está
+alineando la letra no debe haber @qq{muerto}, o se perderá la letra
+después de ese punto.  Esto puede ocurrir si existen períodos en los
+que dicha voz no tiene nada que hacer.  Para ver métodos de mantener
+vivos los contextos, consulte @ref{Keeping contexts alive}.
+
+

 @menu
 @menu

-* Automatic syllable durations::  
-* Manual syllable durations::   
-* Multiple syllables to one note::  
-* Multiple notes to one syllable::  
-* Skipping notes::              
-* Extenders and hyphens::       
-* Lyrics and repeats::          
+* Automatic syllable durations::
+* Manual syllable durations::
+* Multiple syllables to one note::
+* Multiple notes to one syllable::
+* Skipping notes::
+* Extenders and hyphens::
+* Lyrics and repeats::

 @end menu
 
 @node Automatic syllable durations
 @end menu
 
 @node Automatic syllable durations


@@ -473,8 +504,14 @@ letra.
     \time 2/4
     c4 b8. a16 g4. f8 e4 d c2
   }
     \time 2/4
     c4 b8. a16 g4. f8 e4 d c2
   }

+
+% not recommended: left aligns syllables

   \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
   \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }

+
+% wrong: durations needed

   \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
   \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }

+
+%correct

   \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
 >>
 @end lilypond
   \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
 >>
 @end lilypond


@@ -506,7 +543,7 @@ El texto también se puede introducir sin @code{\addlyrics} ni
 @code{\lyricsto}.  En este caso, las sílabas se escriben como notas
 (pero con las alturas sustituidas por texto) y la duración de cada
 sílaba se debe escribir explícitamente.  Por ejemplo:
 @code{\lyricsto}.  En este caso, las sílabas se escriben como notas
 (pero con las alturas sustituidas por texto) y la duración de cada
 sílaba se debe escribir explícitamente.  Por ejemplo:

- 
+

 @example
 play2 the4 game2.
 sink2 or4 swim2.
 @example
 play2 the4 game2.
 sink2 or4 swim2.


@@ -514,7 +551,7 @@ sink2 or4 swim2.
 
 La alineación respecto de una melodía se puede especificar con la
 propiedad @code{associatedVoice},
 
 La alineación respecto de una melodía se puede especificar con la
 propiedad @code{associatedVoice},

- 
+

 @example
 \set associatedVoice = #"lala"
 @end example
 @example
 \set associatedVoice = #"lala"
 @end example


@@ -523,7 +560,7 @@ propiedad @code{associatedVoice},
 El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
 un contexto de @rinternals{Voice}.  Sin este ajuste, las líneas de
 extensión no se formatearán correctamente.
 El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
 un contexto de @rinternals{Voice}.  Sin este ajuste, las líneas de
 extensión no se formatearán correctamente.

- 
+

 Presentamos a continuación un ejemplo que muestra el uso de las
 duraciones manuales de las sílabas del texto:
 
 Presentamos a continuación un ejemplo que muestra el uso de las
 duraciones manuales de las sílabas del texto:
 


@@ -538,15 +575,18 @@ duraciones manuales de las sílabas del texto:
  } >>
 @end lilypond
 
  } >>
 @end lilypond
 

+

 @seealso
 @seealso

+Referencia de la notación:
+@ref{Keeping contexts alive}.

 
 

-Referencia de funcionamiento interno: @rinternals{Lyrics}.
+Referencia de funcionamiento interno:
+@rinternals{Lyrics}.

 
 
 @node Multiple syllables to one note
 @unnumberedsubsubsec Multiple syllables to one note
 
 
 
 @node Multiple syllables to one note
 @unnumberedsubsubsec Multiple syllables to one note
 

-

 @funindex _
 @cindex ligaduras, en el texto
 
 @funindex _
 @cindex ligaduras, en el texto
 


@@ -566,8 +606,8 @@ DejaVuLGC) que incluya este glifo.}.
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 
 \addlyrics { pu- ro~y~ho- nes- to }
 @end lilypond
 

-@seealso

 
 

+@seealso

 Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 @c Here come the section which used to be "Melismata"
 Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 @c Here come the section which used to be "Melismata"


@@ -588,10 +628,24 @@ melismas, o melismata.
 @c this method seems to be the simplest; therefore
 @c it might be better to present it first - vv
 
 @c this method seems to be the simplest; therefore
 @c it might be better to present it first - vv
 

-Puede definir los melismas completamente dentro de la letra,
-escribiendo un guión bajo @code{_} para cada nota que forma parte del
-melisma.
+Podemos definir los melismas completamente dentro de la letra,
+escribiendo un guión bajo @code{_} por cada nota que se quiere añadir
+al melisma.
+
+@c FIXME: clarify: __ is used to crate a lyric extender,
+@c _ is used to add a note to a melisma, so both __ and _ are needed.

 
 

+@c verbose! --FV
+@c duplicated: TODO fix
+Además, podemos hacer que se imprima una línea extensora para indicar
+el melisma en la partitura, escribiendo un doble guión bajo junto a la
+primera sílaba del melisma. Este ejemplo presenta los tres elementos
+que se usan con este fin (todos ellos circundados por espacios):
+guiones dobles para separar las sílabas de una palabra, guiones bajos
+para añadir notas al melisma, y un doble guión bajo para poner una
+línea extensora.
+
+@c wrong: extender line only on last syllable of a word. Change example

 @lilypond[relative=1,verbatim,fragment,quote]
 { \set melismaBusyProperties = #'()
  c d( e) f f( e) e e  }
 @lilypond[relative=1,verbatim,fragment,quote]
 { \set melismaBusyProperties = #'()
  c d( e) f f( e) e e  }


@@ -599,9 +653,9 @@ melisma.
  { Ky -- _ _ ri __ _ _ _  e }
 @end lilypond
 
  { Ky -- _ _ ri __ _ _ _  e }
 @end lilypond
 

-En este caso, también puede tener ligaduras de unión y de expresión en
-la melodía, si establece @code{melismaBusyProperties}, como se hizo en
-el ejemplo anterior.
+En este caso también podemos tener ligaduras de unión y de expresión
+en la melodía, si establecemos @code{melismaBusyProperties}, como se
+hizo en el ejemplo anterior.

 
 Sin embargo la instrucción @code{\lyricsto} también puede detectar los
 melismas automáticamente: sólo pone una sílaba debajo de un grupo de
 
 Sin embargo la instrucción @code{\lyricsto} también puede detectar los
 melismas automáticamente: sólo pone una sílaba debajo de un grupo de


@@ -630,8 +684,7 @@ Además, las notas se consideran un melisma si están unidas manualmente
 mediante una barra, y el barrado automático (véase @ref{Setting
 automatic beam behavior}) está desactivado.
 
 mediante una barra, y el barrado automático (véase @ref{Setting
 automatic beam behavior}) está desactivado.
 

-@c TODO: there might be some more relevant place for 
-@c the following link (?)
+@c FIXME: this now links to LM -vv

 
 @cindex SATB
 @cindex coral, partitura
 
 @cindex SATB
 @cindex coral, partitura


@@ -641,16 +694,16 @@ sección @rlearning{Vocal ensembles}.
 
 
 @predefined
 
 
 @predefined

-
+@funindex \melisma

 @code{\melisma},
 @code{\melisma},

-@code{\melismaEnd}

 @funindex \melismaEnd
 @funindex \melismaEnd

-@funindex \melisma
+@code{\melismaEnd}.
+@endpredefined
+

 
 @seealso
 
 @seealso

+@c @lsr{vocal,lyric@/-combine.ly}.

 
 

-@comment  Referencia de funcionamiento interno:
-@comment  @rinternals{Melisma_translator}.

 
 @knownissues
 
 
 @knownissues
 


@@ -681,7 +734,8 @@ Por ejemplo,
 @unnumberedsubsubsec Extenders and hyphens
 
 @cindex melisma
 @unnumberedsubsubsec Extenders and hyphens
 
 @cindex melisma

-@cindex extender
+@cindex extensora, línea
+@cindex línea de extensión

 
 @c leave this as samp. -gp
 Los melismas se indican mediante una línea horizontal centrada entre
 
 @c leave this as samp. -gp
 Los melismas se indican mediante una línea horizontal centrada entre


@@ -689,6 +743,13 @@ una sílaba y la siguiente.  Esta línea recibe el nombre de línea de
 extensión, y se escribe como @samp{ __ } (fíjese en los espacios antes
 y después de los dos guiones bajos).
 
 extensión, y se escribe como @samp{ __ } (fíjese en los espacios antes
 y después de los dos guiones bajos).
 

+@warning{Los melismas se indican en la partitura con líneas
+extensoras, que se escriben con un doble guión bajo; pero también se
+pueden introducir melismas cortos mediante saltos de notas
+individuales, que se escriben como caracteres de guión bajo sueltos;
+de forma predeterminada éstos no producen la impresión de una línea de
+extensión.}
+

 @cindex guiones
 
 @c leave this as samp. -gp
 @cindex guiones
 
 @c leave this as samp. -gp


@@ -703,10 +764,11 @@ guiones.  Se puede controlar si esto ocurre o no, mediante la
 @code{minimum-length} (umbral por debajo del cual se suprimen los
 guiones).
 
 @code{minimum-length} (umbral por debajo del cual se suprimen los
 guiones).
 

-@seealso

 
 

-Referencia de funcionamiento interno: @rinternals{LyricExtender},
-@rinternals{LyricHyphen}
+@seealso
+Referencia de funcionamiento interno:
+@rinternals{LyricExtender},
+@rinternals{LyricHyphen}.

 
 
 @node Lyrics and repeats
 
 
 @node Lyrics and repeats


@@ -725,10 +787,10 @@ formas ligeramente distintas.  Tales variantes pueden aún captarse
 mediante @code{\lyricsto}.
 
 @menu
 mediante @code{\lyricsto}.
 
 @menu

-* Divisi lyrics::               
-* Lyrics independent of notes::                    
-* Spacing out syllables::       
-* Centering lyrics between staves::  
+* Divisi lyrics::
+* Lyrics independent of notes::
+* Spacing out syllables::
+* Centering lyrics between staves::

 @end menu
 
 
 @end menu
 
 


@@ -805,6 +867,17 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
 >>
 @end lilypond
 

+Sólo se recomienda este método si la música que está en el contexto
+@code{Devnull} no contiene melismas.  Los melismas están definidos por
+el contexto @code{Voice}.  La conexión de la letra a un contexto
+@code{Devnull} hace que se pierdan los enlaces entre la voz y las
+sílabas, y también la información relativa a los melismas.  Por tanto,
+si enlazamos la letra a un contexto @code{Devnull}, los melismas
+implícitos se ignoran.
+
+@c Conclusion: do not use devnull for lyrics -FV
+
+@c this clarifies http://code.google.com/p/lilypond/issues/detail?id=248

 
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
 
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables


@@ -849,6 +922,49 @@ completa, establezca la propiedad dentro del @q{layout} o disposición.
 }
 @end lilypond
 
 }
 @end lilypond
 

+@c @snippets
+@c This snippet has been renamed to "lyrics-alignment.ly"
+@c update as soon as lsr/is updated -vv
+@c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@c {lyrics-alignment.ly}
+
+@c TODO: move to LSR -vv
+@snippets
+
+La comprobación que asegura que las inscripciones de texto y la letra
+de las canciones se mantienen dentro de los márgenes, es una tarea
+computacional relativamente costosa.  Para acelerar el procesado,
+LilyPond no hace tales cálculos de forma predeterminada; para
+habilitarlos, utilice
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+Para hacer también que las sílabas de la letra eviten las barras de compás, use
+
+@example
+\layout @{
+  \context @{
+    \Lyrics
+      \consists "Bar_engraver"
+      \consists "Separating_line_group_engraver"
+      \override BarLine #'transparent = ##t
+  @}
+@}
+@end example
+
+@c TODO Create and add lsr example of lyricMelismaAlignment
+@c It's used like this to center-align all lyric syllables,
+@c even when notes are tied. -td
+
+@ignore
+\layout
+{
+     \context { \Score lyricMelismaAlignment = #0 }
+}
+@end ignore
+

 
 @node Centering lyrics between staves
 @unnumberedsubsubsec Centering lyrics between staves
 
 @node Centering lyrics between staves
 @unnumberedsubsubsec Centering lyrics between staves


@@ -861,17 +977,17 @@ Continuará...
 @subsection Stanzas
 
 @menu
 @subsection Stanzas
 
 @menu

-* Adding stanza numbers ::      
-* Adding dynamics marks to stanzas::  
-* Adding singers' names to stanzas::  
-* Stanzas with different rhythms::  
-* Printing stanzas at the end::  
-* Printing stanzas at the end in multiple columns::  
+* Adding stanza numbers::
+* Adding dynamics marks to stanzas::
+* Adding singers' names to stanzas::
+* Stanzas with different rhythms::
+* Printing stanzas at the end::
+* Printing stanzas at the end in multiple columns::

 @end menu
 
 
 @end menu
 
 

-@node Adding stanza numbers 
-@unnumberedsubsubsec Adding stanza numbers 
+@node Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers

 
 @cindex verso, número de
 
 
 @cindex verso, número de
 


@@ -882,10 +998,10 @@ Los números de los versos se pueden añadir estableciendo
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set stanza = "1. "
+  \set stanza = #"1. "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set stanza = "2. "
+  \set stanza = #"2. "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
   Oh, ché -- ri, je t'aime
 }
 @end lilypond


@@ -893,6 +1009,37 @@ Los números de los versos se pueden añadir estableciendo
 @noindent
 Estos números aparecerán inmediatamente antes de la primera sílaba.
 
 @noindent
 Estos números aparecerán inmediatamente antes de la primera sílaba.
 

+@c TODO Create and add snippet to show how two lines of a
+@c stanza can be grouped together, along these lines:
+@c (might need improving a bit) -td
+
+@ignore
+leftbrace = \markup { \override #'(font-encoding . fetaBraces) \lookup
+#"brace105" }
+
+stanzaOneOne = {
+  \set stanza = \markup { "1. " \leftbrace }
+  \lyricmode { Child, you're mine and I love you.
+    Lend thine ear to what I say.
+
+  }
+}
+
+stanzaOneThree =  {
+%  \set stanza = \markup { "   "}
+  \lyricmode { Child, I have no great -- er joy
+    Than to have you walk in truth.
+
+  }
+}
+
+\new Voice {
+  \repeat volta 2 { c'8 c' c' c' c' c' c'4
+                    c'8 c' c' c' c' c' c'4   }
+}  \addlyrics { \stanzaOneOne }
+   \addlyrics { \stanzaOneThree }
+
+@end ignore

 
 @node Adding dynamics marks to stanzas
 @unnumberedsubsubsec Adding dynamics marks to stanzas
 
 @node Adding dynamics marks to stanzas
 @unnumberedsubsubsec Adding dynamics marks to stanzas


@@ -928,7 +1075,6 @@ text = {
 @cindex cantante, nombre del
 @cindex nombre del cantante
 
 @cindex cantante, nombre del
 @cindex nombre del cantante
 

-

 También se pueden poner los nombres de los cantantes.  Se imprimen al
 comienzo de la línea, igual que los nombres de instrumento.  Se crean
 estableciendo un valor para @code{vocalName}.  Se puede definir una
 También se pueden poner los nombres de los cantantes.  Se imprimen al
 comienzo de la línea, igual que los nombres de instrumento.  Se crean
 estableciendo un valor para @code{vocalName}.  Se puede definir una


@@ -938,10 +1084,10 @@ versión abreviada como @code{shortVocalName}.
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {

-  \set vocalName = "Bert "
+  \set vocalName = #"Bert "

   Hi, my name is Bert.
 } \addlyrics {
   Hi, my name is Bert.
 } \addlyrics {

-  \set vocalName = "Ernie "
+  \set vocalName = #"Ernie "

   Oh, ché -- ri, je t'aime
 }
 @end lilypond
   Oh, ché -- ri, je t'aime
 }
 @end lilypond


@@ -957,13 +1103,7 @@ pero varias sílabas en otro.  Una solución es hacer que la voz más
 rápida ignore el melisma.  Esto se consigue estableciendo
 @code{ignoreMelismata} en el contexto Lyrics.
 
 rápida ignore el melisma.  Esto se consigue estableciendo
 @code{ignoreMelismata} en el contexto Lyrics.
 

-Hay un aspecto delicado: el valor de @code{ignoreMelismata} se debe
-establecer una sílaba @emph{antes} de la sílaba no melismática del
-texto, tal y como se muestra a continuación:
-
-@c  TODO: breaks compile

 @lilypond[verbatim,ragged-right,quote]
 @lilypond[verbatim,ragged-right,quote]

-%{

 <<
   \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f
 <<
   \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f


@@ -976,31 +1116,21 @@ texto, tal y como se muestra a continuación:
     more slow -- ly
   }
   \new Lyrics \lyricsto "lahlah" {
     more slow -- ly
   }
   \new Lyrics \lyricsto "lahlah" {

-    \set ignoreMelismata = ##t % se aplica al "fas"
-    go fas -- ter
+    go
+    \set ignoreMelismata = ##t
+    fas -- ter

     \unset ignoreMelismata
     still
   }
 >>
     \unset ignoreMelismata
     still
   }
 >>

-%}

 @end lilypond
 
 @end lilypond
 

+@knownissues
+A diferencia de casi todas las instrucciones @code{\set}, @code{\set
+ignoreMelismata} no funciona si va precedido de @code{\once}.  Es
+necesario utilizar @code{\set} y @code{\unset} para delimitar la letra
+en que se quieren ignorar los melismas.

 
 

-El @code{ignoreMelismata} se aplica a la sílaba @q{fas}, por ello se
-debe introducir antes de @q{go}.
-
-La inversa también es posible: hacer que una línea de letra sea más
-lenta que la normal.  Esto se puede conseguir insertando @code{\skip}s
-(desplazamientos) dentro de la letra.  Para cada @code{\skip}, el
-texto se retrasará una nota más.  Por ejemplo,
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c' { c c g' }
-\addlyrics {
-  twin -- \skip 4
-  kle
-}
-@end lilypond

 
 @subsubheading Switching to an alternative melody
 
 
 @subsubheading Switching to an alternative melody
 


@@ -1066,8 +1196,11 @@ consigue con
 Aquí, @code{alternative} es el nombre del contexto de @code{Voice} que
 contiene el tresillo.
 
 Aquí, @code{alternative} es el nombre del contexto de @code{Voice} que
 contiene el tresillo.
 

-Una vez más, la instrucción debe ir una sílaba antes de la cuenta,
-antes de @q{Ty} en este caso.
+@c FIXME: make this easier to understand -vv
+La instrucción debe ir una sílaba antes de la cuenta, antes de @q{Ty}
+en este caso.  En otras palabras, el cambio en la voz asociada
+associatedVoice se produce un paso más tarde de lo que se espera.
+Esto es así por razones técnicas, y no es un fallo del programa.

 
 @example
 \new Lyrics \lyricsto "lahlah" @{
 
 @example
 \new Lyrics \lyricsto "lahlah" @{


@@ -1091,7 +1224,7 @@ asignación de @code{lahlah} a @code{associatedVoice}.
 En ocasiones es conveniente tener un verso ajustado a la música, y el
 resto añadido en forma de estrofa al final de la pieza.  Esto se puede
 conseguir escribiendo los versos adicionales dentro de una sección
 En ocasiones es conveniente tener un verso ajustado a la música, y el
 resto añadido en forma de estrofa al final de la pieza.  Esto se puede
 conseguir escribiendo los versos adicionales dentro de una sección

-@code{\markup} fuera del bloque score principal de la partitura.
+@code{\markup} fuera del bloque Score principal de la partitura.

 Tenga en cuenta que existen dos formas distintas de forzar los saltos
 de línea al utilizar @code{\markup}.
 
 Tenga en cuenta que existen dos formas distintas de forzar los saltos
 de línea al utilizar @code{\markup}.
 


@@ -1102,7 +1235,7 @@ d d e d | c1 |
 }
 
 text = \lyricmode {
 }
 
 text = \lyricmode {

-\set stanza = "1." Ma- ry had a lit- tle lamb,
+\set stanza = #"1." Ma- ry had a lit- tle lamb,

 its fleece was white as snow.
 }
 
 its fleece was white as snow.
 }
 


@@ -1135,15 +1268,15 @@ its fleece was white as snow.
 Cuando una pieza tiene muchos versos, a menudo se imprimen en varias
 columnas a lo largo de toda la página. Con frecuencia un número de
 verso fuera del margen precede a cada verso. El ejemplo siguiente
 Cuando una pieza tiene muchos versos, a menudo se imprimen en varias
 columnas a lo largo de toda la página. Con frecuencia un número de
 verso fuera del margen precede a cada verso. El ejemplo siguiente

-muestra cómo producir dicha salida en Lilypond.
+muestra cómo producir dicha salida en LilyPond.

 
 @lilypond[ragged-right,quote,verbatim]
 melody = \relative c' {
   c c c c | d d d d
 }
 
 @lilypond[ragged-right,quote,verbatim]
 melody = \relative c' {
   c c c c | d d d d
 }

- 
+

 text = \lyricmode {
 text = \lyricmode {

-  \set stanza = "1." This is verse one.
+  \set stanza = #"1." This is verse one.

   It has two lines.
 }
 
   It has two lines.
 }
 


@@ -1156,8 +1289,8 @@ text = \lyricmode {
 
 \markup {
   \fill-line {
 
 \markup {
   \fill-line {

-    \hspace #0.1 % moves the column off the left margin; can be removed if
-        % space on the page is tight
+    \hspace #0.1 % moves the column off the left margin;
+        % can be removed if space on the page is tight

      \column {
       \line { \bold "2."
         \column {
      \column {
       \line { \bold "2."
         \column {


@@ -1173,9 +1306,9 @@ text = \lyricmode {
         }
       }
     }
         }
       }
     }

-    \hspace #0.1  % adds horizontal spacing between columns; if they are
-        % still too close, add more " " pairs until the result 
-        % looks good
+    \hspace #0.1  % adds horizontal spacing between columns;
+        % if they are still too close, add more " " pairs
+        % until the result looks good

      \column {
       \line { \bold "4."
         \column {
      \column {
       \line { \bold "4."
         \column {


@@ -1191,15 +1324,14 @@ text = \lyricmode {
         }
       }
     }
         }
       }
     }

-  \hspace #0.1 % gives some extra space on the right margin; can
-      % be removed if page space is tight
+  \hspace #0.1 % gives some extra space on the right margin;
+      % can be removed if page space is tight

   }
 }
 @end lilypond
 
 
 @seealso
   }
 }
 @end lilypond
 
 
 @seealso

-

 Referencia de funcionamiento interno:
 @rinternals{LyricText},
 @rinternals{StanzaNumber}.
 Referencia de funcionamiento interno:
 @rinternals{LyricText},
 @rinternals{StanzaNumber}.