X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Fvocal.itely;h=d2b1032b1fca5beda978acfb9129199e5294d022;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=015e4a1cad127ea0adad3d91460182508e5b1c2a;hpb=b27ec0128137224ec5918867be733d0da9e2e4a3;p=lilypond.git

diff --git a/Documentation/es/user/vocal.itely b/Documentation/es/user/vocal.itely
index 015e4a1cad..d2b1032b1f 100644
--- a/Documentation/es/user/vocal.itely
+++ b/Documentation/es/user/vocal.itely
@@ -1,128 +1,170 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 2ac76a5b0a5572cb259f22751764acfe431bfff2
+    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
 
-@c \version "2.11.51"
+@c \version "2.12.0"
 
 
 @node Vocal music
 @section Vocal music
 
-Puesto que los archivos de entrada de LilyPond son de texto, hay un
-par de cuestiones dignas de consideración cuando se trabaja con música
-vocal:
+@c TODO: inspirational headword
+
+Esta sección explica cómo tipografiar música vocal, y cómo asegurarse
+de que la letra se alinea con las notas de su melodía correspondiente.
+
+@menu
+* Common notation for vocal music::
+* Entering lyrics::
+* Aligning lyrics to a melody::
+* Specific uses of lyrics::
+* Stanzas::
+@end menu
+
+
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+Esta sección trata sobre asuntos relacionados con la música vocal en
+general y con ciertos estilos concretos de música vocal.
+
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Spoken music::
+* Chants::
+* Ancient vocal music::
+@end menu
+
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@c TODO: split this section in two parts? -vv
+
+Pueden surgir varias cuestiones al tipografiar música vocal.  Algunas
+se discuten en esta sección, pero otras están tratadas en otros
+lugares del manual:
 
 @itemize
 @item
-Los textos de las canciones se deben introducir como texto, no como
-notas.  Por ejemplo, la entrada@tie{}@code{d} se debe interpretar como
-una sílaba de una sola letra, no como la nota@tie{}Re.
+Casi todos los estilos de música vocal utilizan texto escrito como
+letra.  Hay una introducción a esta notación en @rlearning{Setting
+simple songs}.
+
+@item
+La música vocal probablemente requiere el uso del modo de marcado o
+@code{markup}, ya sea para la letra o para otros elementos de texto
+(nombres de los personajes, etc.).  Esta sintaxis está descrita en
+@ref{Text markup introduction}.
+
+@item
+Las hojas guía de acordes o @emph{Lead sheets} se pueden imprimir
+combinando partes vocales y el @q{modo de acordes}; esta sintaxis se
+explica en @ref{Chord notation}.
+
+@item
+Los @q{ambitus} o indicaciones de tesitura vocal se pueden añadir al
+principio de los pentagramas vocales, como se explica en
+@ref{Ambitus}.
 
 @item
-Los textos de las canciones se deben alinear con las notas respectivas
-de la melodía.
+Las partes vocales se pueden imprimir utilizando las claves
+tradicionales, como se muestra en @ref{Clef}.
+
+@item
+Está contemplada la música vocal en estilo de notación antiguo, como
+se explica en @ref{Ancient notation}.
 @end itemize
 
-Existen varias formas diferentes de definir la letra; comenzaremos
-examinando el método más simple, y poco a poco iremos aumentando la
-complejidad.
 
-@menu
-* Common notation for vocals::  
-* Aligning lyrics to a melody::  
-* Placement of lyrics::         
-* Stanzas::                     
-@end menu
+@node Opera
+@unnumberedsubsubsec Opera
 
+@c TODO
+Continuará...
 
-@snippets
+@c add characters names snippet -vv
 
-Las comprobaciones que aseguran que las indicaciones textuales y las
-letras se encuentran dentro de los márgenes es una tarea computacional
-relativamente grande.  Para acelerar el procesado, lilypond no realiza
-estos cálculos por defecto; para activarlos, utilice
+@node Song books
+@unnumberedsubsubsec Song books
 
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
+@c TODO
+Continuará...
 
-Para hacer que la letra evite las líneas divisorias también, utilice
+@snippets
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{simple-lead-sheet.ly}
 
-@example
-\layout @{
-  \context @{
-    \Lyrics
-      \consists "Bar_engraver"
-      \consists "Separating_line_group_engraver"
-      \override BarLine #'transparent = ##t
-  @}
-@}
-@end example
 
-@node Common notation for vocals
-@subsection Common notation for vocals
+@seealso
+Referencia de la notación:
+@ref{Chord notation}.
 
-@menu
-* References for vocal music::  
-* Setting simple songs::        
-* Entering lyrics::             
-* Working with lyrics and variables::  
-@end menu
 
-@node References for vocal music
-@subsubsection References for vocal music
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+
+@cindex parlato
+@cindex Sprechgesang
 
 @c TODO Add @refs
 
-@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
-realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
-@ref{Special note heads}.
+Los efectos como el @q{parlato} o el @q{Sprechgesang} requieren de los
+intérpretes que hablen sin altura determinada pero con su ritmo; su
+notación se realiza mediante cabezas de nota en forma de aspas, como
+se muestra en @ref{Special note heads}.
 
+@c TODO add "marking-notes-on-spoken-parts" snippet -vv
+@c add "showing the rhythm of a melody" snip
+@c add "one staff-line notation"
+@c add "improvisation" ref
+@c add "lyrics independents of notes" ref
 
-@node Setting simple songs
-@subsubsection Setting simple songs
 
-@cindex \addlyrics
+@node Chants
+@unnumberedsubsubsec Chants
 
-La manera más fácil de poner letra a una melodía es añadir
+@c TODO Add text from lsr and -user
+Continuará...
 
-@example
-\addlyrics @{ @var{la letra} @}
-@end example
 
-@noindent
-a la melodía.  He aquí un ejemplo:
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
 
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative c' { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
+@c TODO
+Continuará...
 
-Se pueden añadir más versos mediante la adición de más secciones
-@code{\addlyrics}
+@c Add "Printing both the ancient and the modern clef in vocal music" snippet,
+@c and "Transcription of Ancient music with incipit" snippet. -vv
 
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative c' { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
-
-La instrucción @code{\addlyrics} no puede manejar situaciones de
-polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
-@code{\lyricmode}, tal y como se explicará en @ref{Entering lyrics}.
 
+@seealso
+Referencia de la notación:
+@ref{Ancient notation}.
 
 
 @node Entering lyrics
-@subsubsection Entering lyrics
+@subsection Entering lyrics
+
+@c TODO add one sentence here. -vv
+
+@menu
+* Lyrics explained::
+* Setting simple songs::
+* Working with lyrics and variables::
+@end menu
+
+
+@node Lyrics explained
+@unnumberedsubsubsec Lyrics explained
 
 @cindex letra
 @funindex \lyricmode
@@ -130,6 +172,15 @@ polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
 @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
@@ -243,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{^}.
 
+@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}.
 
@@ -262,12 +315,53 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 
 
 @seealso
+Referencia de la notación:
+@ref{Fonts}.
 
-Referencia de funcionamiento interno: @rinternals{LyricText},
+Referencia de funcionamiento interno:
+@rinternals{LyricText},
 @rinternals{LyricSpace}.
 
+
+@c FIXME: this title has to be changed (possible confusion with LM) -vv
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+La manera más fácil de poner letra a una melodía es añadir
+
+@example
+\addlyrics @{ @var{la letra} @}
+@end example
+
+@noindent
+a la melodía.  He aquí un ejemplo:
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative c' { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+Se pueden añadir más versos mediante la adición de más secciones
+@code{\addlyrics}
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative c' { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+La instrucción @code{\addlyrics} no puede manejar situaciones de
+polifonía.  Para estos casos tendrá que usar @code{\lyricsto} y
+@code{\lyricmode}, tal y como se explicará en @ref{Lyrics explained}.
+
+
 @node Working with lyrics and variables
-@subsubsection Working with lyrics and variables
+@unnumberedsubsubsec Working with lyrics and variables
 
 @cindex letra, identificadores de
 
@@ -275,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.
- 
+
 @example
 verseOne = \lyricmode @{ Joy to the world the Lord is come @}
 \score @{
@@ -289,7 +383,7 @@ verseOne = \lyricmode @{ Joy to the world the Lord is come @}
  >>
 @}
 @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
@@ -300,18 +394,18 @@ previamente la jerarquía de pautas y textos, p.ej.:
   \new Voice = "tenor" @{ @emph{música} @}
 >>
 @end example
- 
+
 y después combinar las melodías y líneas de texto correspondientes:
- 
+
 @example
 \context Lyrics = textoSoprano \lyricsto "soprano"
 @emph{el texto}
 @end example
- 
+
 @noindent
 
 El código de entrada definitivo sería algo como
- 
+
 @example
 <<\new ChoirStaff << @emph{prepare la música} >>
  \lyricsto "soprano" @emph{etc}
@@ -319,12 +413,14 @@ El código de entrada definitivo sería algo como
 @emph{etc}
 >>
 @end example
- 
+
+
 @seealso
- 
 @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
@@ -334,6 +430,11 @@ Referencia de funcionamiento interno:
 @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}.
@@ -355,18 +456,25 @@ o especificando la duración de cada sílaba explícitamente, utilizando
 @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
-* 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
-@subsubsection Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
 
 @cindex duraciones automáticas de las sílabas
 @cindex letra y melodías
@@ -396,8 +504,14 @@ letra.
     \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 }
+
+% wrong: durations needed
   \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
@@ -423,13 +537,13 @@ es lo mismo que
 @end example
 
 @node Manual syllable durations
-@subsubsection Manual syllable durations
+@unnumberedsubsubsec Manual syllable durations
 
 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:
- 
+
 @example
 play2 the4 game2.
 sink2 or4 swim2.
@@ -437,7 +551,7 @@ sink2 or4 swim2.
 
 La alineación respecto de una melodía se puede especificar con la
 propiedad @code{associatedVoice},
- 
+
 @example
 \set associatedVoice = #"lala"
 @end example
@@ -446,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.
- 
+
 Presentamos a continuación un ejemplo que muestra el uso de las
 duraciones manuales de las sílabas del texto:
 
@@ -461,14 +575,17 @@ duraciones manuales de las sílabas del texto:
  } >>
 @end lilypond
 
+
 @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
-@subsubsection Multiple syllables to one note
-
+@unnumberedsubsubsec Multiple syllables to one note
 
 @funindex _
 @cindex ligaduras, en el texto
@@ -489,8 +606,8 @@ DejaVuLGC) que incluya este glifo.}.
 \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"
@@ -498,7 +615,7 @@ Referencia de funcionamiento interno: @rinternals{LyricCombineMusic}.
 
 
 @node Multiple notes to one syllable
-@subsubsection Multiple notes to one syllable
+@unnumberedsubsubsec Multiple notes to one syllable
 
 @cindex melisma
 @cindex melismata
@@ -511,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
 
-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  }
@@ -522,9 +653,9 @@ melisma.
  { 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
@@ -553,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.
 
-@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
@@ -564,16 +694,16 @@ sección @rlearning{Vocal ensembles}.
 
 
 @predefined
-
+@funindex \melisma
 @code{\melisma},
-@code{\melismaEnd}
 @funindex \melismaEnd
-@funindex \melisma
+@code{\melismaEnd}.
+@endpredefined
+
 
 @seealso
+@c @lsr{vocal,lyric@/-combine.ly}.
 
-@comment  Referencia de funcionamiento interno:
-@comment  @rinternals{Melisma_translator}.
 
 @knownissues
 
@@ -581,15 +711,31 @@ Los melismas no se detectan automáticamente, y las líneas de extensión
 se deben insertar a mano.
 
 @node Skipping notes
-@subsubsection Skipping notes
+@unnumberedsubsubsec Skipping notes
+
+Se puede conseguir que una línea de letra progrese más lentamente que
+la melodía, mediante la inserción de desplazamientos o @code{\skip}s
+en la letra.  Por cada @code{\skip}, el texto se retrasa en una nota.
+La instrucción @code{\skip} debe ir seguida de una duración válida,
+pero esta duración se ignora cuando se usa @code{\skip} en las letras.
+
+Por ejemplo,
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c' { c c g' }
+\addlyrics {
+  twin -- \skip 4
+  kle
+}
+@end lilypond
 
-@untranslated
 
 @node Extenders and hyphens
-@subsubsection Extenders and hyphens
+@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
@@ -597,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).
 
+@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
@@ -611,35 +764,38 @@ guiones.  Se puede controlar si esto ocurre o no, mediante la
 @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
-@subsubsection Lyrics and repeats
+@unnumberedsubsubsec Lyrics and repeats
+
+@c TODO New section.  Add text
+Continuará...
 
-@untranslated
+@node Specific uses of lyrics
+@subsection Specific uses of lyrics
 
-@node Placement of lyrics
-@subsection Placement of lyrics
+@c FIXME This whole section is to be reorganized. -vv
 
 A menudo se aplican a una melodía distintos versos de una canción de
 formas ligeramente distintas.  Tales variantes pueden aún captarse
 mediante @code{\lyricsto}.
 
 @menu
-* Divisi lyrics::               
-* Lyrics independent of notes::  
-* Chants::                      
-* Spacing out syllables::       
-* Centering lyrics between staves::  
+* Divisi lyrics::
+* Lyrics independent of notes::
+* Spacing out syllables::
+* Centering lyrics between staves::
 @end menu
 
 
 @node Divisi lyrics
-@subsubsection Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
 
 Puede presentar letras alternativas (o divisi) nombrando contextos de
 voz y aplicando la letra a los mencionados contextos específicos.
@@ -684,7 +840,7 @@ sección que se repite.
 
 
 @node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
 
 En cierta música vocal compleja, podría ser deseable colocar la letra
 de forma totalmente independiente de las notas.  La música que se
@@ -711,14 +867,20 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
-@node Chants
-@subsubsection Chants
+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.
 
-@untranslated
+@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
-@subsubsection Spacing out syllables
+@unnumberedsubsubsec Spacing out syllables
 
 @cindex Espaciado de la letra
 @cindex Letra, aumentar el espaciado
@@ -760,26 +922,72 @@ completa, establezca la propiedad dentro del @q{layout} o disposición.
 }
 @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
-@subsubsection Centering lyrics between staves
+@unnumberedsubsubsec Centering lyrics between staves
+
+@c TODO Add text from -user
+Continuará...
 
-@untranslated
 
 @node Stanzas
 @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
 
 
-@node Adding stanza numbers 
-@subsubsection Adding stanza numbers 
+@node Adding stanza numbers
+@unnumberedsubsubsec Adding stanza numbers
 
 @cindex verso, número de
 
@@ -790,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 {
-  \set stanza = "1. "
+  \set stanza = #"1. "
   Hi, my name is Bert.
 } \addlyrics {
-  \set stanza = "2. "
+  \set stanza = #"2. "
   Oh, ché -- ri, je t'aime
 }
 @end lilypond
@@ -801,9 +1009,40 @@ Los números de los versos se pueden añadir estableciendo
 @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
-@subsubsection Adding dynamics marks to stanzas
+@unnumberedsubsubsec Adding dynamics marks to stanzas
 
 Los versos que difieren en su sonoridad se pueden especificar
 escribiendo una indicación dinámica antes de cada verso.  En LilyPond,
@@ -831,12 +1070,11 @@ text = {
 
 
 @node Adding singers' names to stanzas
-@subsubsection Adding singers' names to stanzas
+@unnumberedsubsubsec Adding singers' names to stanzas
 
 @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
@@ -846,17 +1084,17 @@ versión abreviada como @code{shortVocalName}.
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
-  \set vocalName = "Bert "
+  \set vocalName = #"Bert "
   Hi, my name is Bert.
 } \addlyrics {
-  \set vocalName = "Ernie "
+  \set vocalName = #"Ernie "
   Oh, ché -- ri, je t'aime
 }
 @end lilypond
 
 
 @node Stanzas with different rhythms
-@subsubsection Stanzas with different rhythms
+@unnumberedsubsubsec Stanzas with different rhythms
 
 @subsubheading Ignoring melismata
 
@@ -865,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.
 
-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]
-%{
 <<
   \relative c' \new Voice = "lahlah" {
     \set Staff.autoBeaming = ##f
@@ -884,31 +1116,21 @@ texto, tal y como se muestra a continuación:
     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
   }
 >>
-%}
 @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
 
@@ -974,8 +1196,11 @@ consigue con
 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" @{
@@ -994,12 +1219,12 @@ asignación de @code{lahlah} a @code{associatedVoice}.
 
 
 @node Printing stanzas at the end
-@subsubsection Printing stanzas at the end
+@unnumberedsubsubsec Printing stanzas at the end
 
 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}.
 
@@ -1010,7 +1235,7 @@ d d e d | c1 |
 }
 
 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.
 }
 
@@ -1038,20 +1263,20 @@ its fleece was white as snow.
 
 
 @node Printing stanzas at the end in multiple columns
-@subsubsection Printing stanzas at the end in multiple columns
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns
 
 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
 }
- 
+
 text = \lyricmode {
-  \set stanza = "1." This is verse one.
+  \set stanza = #"1." This is verse one.
   It has two lines.
 }
 
@@ -1064,8 +1289,8 @@ text = \lyricmode {
 
 \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 {
@@ -1081,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 {
@@ -1099,16 +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
-
 Referencia de funcionamiento interno:
 @rinternals{LyricText},
 @rinternals{StanzaNumber}.
-