X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Ftutorial.itely;h=76aa4717f4800e49d9bf69f43894e2ba94263029;hb=5c14a087ca6cbd665fd631452b7b1283ba0387c3;hp=b0538699e316c0d065d95c1af628e3615df55d3a;hpb=9d9e2e5637e06d98245c3395b58207ec173e7e7d;p=lilypond.git

diff --git a/Documentation/es/user/tutorial.itely b/Documentation/es/user/tutorial.itely
index b0538699e3..76aa4717f4 100644
--- a/Documentation/es/user/tutorial.itely
+++ b/Documentation/es/user/tutorial.itely
@@ -1,33 +1,33 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
-    Translation of GIT committish: 1599b9171f39a1000e38104deae93e9df08276be
+    Translation of GIT committish: bc494bf964f01a1327bc7c6e3c70d0cb8d897ecb
 
     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.38"
+@c \version "2.11.61"
 
 @ignore
 Tutorial guidelines:  (different from policy.txt!)
 - unless you have a really good reason, use either
-    @lilypond[verbatim,quote,ragged-right]
+    @lilypond[verbatim,quote]
   or
-    @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+    @lilypond[verbatim,quote,relative=2]
 
-  Don't use any other relative=X commands (make it a non-fragment
-  example), and don't use fragment without relative=2.
+  Don't use any other relative=X commands.
 
 - use "aes" and "ees" instead of "as" and "es".  I know it's not
   correct Dutch naming, but let's not confuse people with this
   until we get to the Basic notation chapter.
 
-- Add "Music Glossary: @rglos{foo}" to the _top_ of the relevant
+- Add "Music Glossary: @rglos{foo}" to the *top* of the relevant
   portions of the tutorial.
 
 @end ignore
 
+@c Translation status: post-GDP
 
 @node Tutorial
 @chapter Tutorial
@@ -39,11 +39,11 @@ bella, que contenga notación musical usual.
 
 
 @menu
-* First steps::                 
-* Single staff notation::       
-* Multiple notes at once::      
-* Songs::                       
-* Final touches::               
+* First steps::
+* Single staff notation::
+* Multiple notes at once::
+* Songs::
+* Final touches::
 @end menu
 
 
@@ -53,16 +53,21 @@ bella, que contenga notación musical usual.
 Esta sección le ofrece una introducción básica al trabajo con LilyPond.
 
 @menu
-* Compiling a file::            
-* Simple notation::             
-* Working on text files::       
-* How to read the manual::      
+* Compiling a file::
+* Simple notation::
+* Working on input files::
+* How to read the manual::
 @end menu
 
 
 @node Compiling a file
 @subsection Compiling a file
 
+@cindex compilación
+@cindex ejemplo inicial
+@cindex inicial, ejemplo
+@cindex mayúsculas, sensible a
+
 @qq{Compilación} es una palabra que significa procesar un texto de
 entrada en formato de LilyPond para producir un archivo que se puede
 imprimir y (de manera opcional) un archivo MIDI que se puede
@@ -82,7 +87,7 @@ la notación deseada.  Por ejemplo, si escribimos
 el resultado tiene este aspecto:
 
 @c  in this case we don't want verbatim
-@lilypond[quote,ragged-right]
+@lilypond[quote]
 {
   c' e' g' e'
 }
@@ -97,11 +102,9 @@ presente manual ¡pero no las omita en su propia música!  Para ver más
 información sobre la presentación de los ejemplos del manual, consulte
 @ref{How to read the manual}.}
 
-
-@cindex sensible a las mayúsculas
-Además la entrada de LilyPond es @strong{sensible a las mayúsculas}.
-@code{ @{ c d e @}} es una entrada válida; @code{@{ C D E @}}
-producirá un mensaje de error.
+Además, la entrada de LilyPond es @strong{sensible a las mayúsculas}.
+@code{ @{ c d e @}} es una entrada válida; @code{@{ C D E @}} produce
+un mensaje de error.
 
 @smallspace
 
@@ -109,6 +112,13 @@ producirá un mensaje de error.
 
 @cindex PDF, archivo
 @cindex ver la música
+@cindex editores de texto
+@cindex ejecutar LilyPond bajo MacOS X
+@cindex MacOS X, ejecutar LilyPond
+@cindex ejecutar LilyPond bajo Windows
+@cindex Windows, ejecutar LilyPond
+@cindex ejecutar LilyPond bajo UNIX
+@cindex UNIX, ejecutar LilyPond
 
 En esta sección vamos a explicar qué órdenes hay que ejecutar y cómo,
 para ver o imprimir el resultado.
@@ -117,7 +127,7 @@ Tenga en cuenta que están disponibles varios otros editores de texto
 con un mejor apoyo a la edición de texto de LilyPond.  Para ver más
 información, consulte @rprogram{Text editor support}.
 
-@warning{la primera vez que ejecute LilyPond, tardará un minuto o dos
+@warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
 porque todas las tipografías del sistema han de ser analizadas
 previamente.  ¡Después de esto, LilyPond será mucho más rápido!}
 
@@ -185,7 +195,7 @@ Verá algo parecido a:
 
 @example
 lilypond prueba.ly
-GNU LilyPond 2.12.0
+GNU LilyPond @version{}
 Procesando `prueba.ly'
 Analizando...
 Interpretando la música...
@@ -201,11 +211,14 @@ Convirtiendo a `prueba.pdf'...
 @node Simple notation
 @subsection Simple notation
 
+@cindex sencilla, notación
+@cindex notación sencilla
+
 LilyPond añadirá ciertos elementos de notación de manera automática.
 En el siguiente ejemplo hemos especificado solamente cuatro alturas,
 pero LilyPond ha añadido la clave, el compás y las duraciones.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 {
   c' e' g' e'
 }
@@ -218,8 +231,27 @@ automáticos son adecuados.
 
 @subheading Pitches
 
-Glosario musical: @rglos{pitch}, @rglos{interval},
-@rglos{scale}, @rglos{middle C}, @rglos{octave},
+@cindex alturas
+@cindex notas
+@cindex relativo, modo
+@cindex apóstrofo
+@cindex comilla simple
+@cindex coma
+@cindex alteraciones y modo relativo
+@cindex relativo, modo, alteraciones y
+
+@funindex \relative
+@funindex relative
+@funindex '
+@funindex ,
+
+
+Glosario musical:
+@rglos{pitch},
+@rglos{interval},
+@rglos{scale},
+@rglos{middle C},
+@rglos{octave},
 @rglos{accidental}.
 
 La manera más sencilla de introducir las notas es mediante la
@@ -232,39 +264,41 @@ el fragmento musical más elemental: una @notation{escala}, donde cada
 nota está comprendida dentro de tan sólo un espacio de pentagrama
 desde la nota anterior.
 
-@lilypond[verbatim,quote,ragged-right]
-\relative c' {  % set the starting point to middle C
+@lilypond[verbatim,quote]
+% set the starting point to middle C
+\relative c' {
   c d e f
   g a b c
 }
 @end lilypond
 
-La nota inicial es @rglos{middle C}.  Cada nota sucesiva se coloca lo
-más cerca posible de la nota previa (en otras palabras: la primera
-@samp{c} es el Do más cercano al Do central; a éste le sigue el Re más
-cercano a la nota previa, y así sucesivamente).  Podemos crear
-melodías con intervalos mayores, aún sin dejar de utilizar el modo
-relativo:
+La nota inicial es el @notation{Do central}.  Cada nota sucesiva se
+coloca lo más cerca posible de la nota previa (en otras palabras: la
+primera @samp{c} es el Do más cercano al Do central; a éste le sigue
+el Re más cercano a la nota previa, y así sucesivamente).  Podemos
+crear melodías con intervalos mayores, aún sin dejar de utilizar el
+modo relativo:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c' {
   d f a g
   c b f d
 }
 @end lilypond
 
+@noindent
 No es necesario que la primera nota de la melodía comience exactamente
 en aquella que especifica la altura de inicio.  En el ejemplo
 anterior, la primera nota (@code{d}) es el Re más cercano al Do
 central.
 
 Añadiendo (o eliminando) comillas simples @code{'} o comas @code{,} de
-la instrucción @code{\relative c' @{}, podemos cambiar la octava de
-inicio:
+la instrucción @w{@code{\relative c' @{}}, podemos cambiar la octava
+de inicio:
 
-@c KEEP LY
-@lilypond[verbatim,quote,ragged-right]
-\relative c'' {  % Una octava por encima del Do central
+@lilypond[verbatim,quote]
+% one octave above middle C
+\relative c'' {
   e c a c
 }
 @end lilypond
@@ -279,15 +313,14 @@ tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está
 por encima del Si, mientras que La, Sol o Fa se entenderán situados
 por debajo.
 
-@c KEEP LY
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
-  b c  % el Do está un espacio por encima: es el Do agudo
-  b d  % el Re está 2 por encima ó 5 por debajo: es el Re agudo
-  b e  % el Mi está 3 por encima ó 4 por debajo: es el Mi agudo
-  b a  % el La está 6 por arriba ó 1 por debajo: es el La grave
-  b g  % el Sol está 5 por encima ó 2 por debajo: es el Sol grave
-  b f  % el Fa está 4 por encima ó 3 por debajo: es el Fa grave
+  b c  % c is 1 staff space up, so is the c above
+  b d  % d is 2 up or 5 down, so is the d above
+  b e  % e is 3 up or 4 down, so is the e above
+  b a  % a is 6 up or 1 down, so is the a below
+  b g  % g is 5 up or 2 down, so is the g below
+  b f  % f is 4 up or 3 down, so is the f below
 }
 @end lilypond
 
@@ -299,11 +332,11 @@ de una nota situada en cualquier otro lugar del mismo.
 
 Para añadir intervalos mayores de tres espacios de pentagrama, podemos
 elevar la @notation{octava} añadiendo una comilla simple @code{'} (o
-apóstrofe) a continuación del nombre de la nota.  También podemos
+apóstrofo) a continuación del nombre de la nota.  También podemos
 bajar la octava escribiendo una coma @code{,} a continuación del
 nombre de la nota.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   a a, c' f,
   g g'' a,, f'
@@ -315,25 +348,41 @@ nombre de la nota.
 Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos
 varias @code{''} ó @code{,,} (pero tenga cuidado de utilizar dos
 comillas simples @code{''} ¡y no una comilla doble @code{"}@tie{}!)
-El valor inicial de @code{\relative c'} también puede modificarse de
-esta forma.
+El valor inicial de @w{@code{\relative c'}} también puede modificarse
+de esta forma.
+@c " - keeps quotes in order for context-sensitive editor -td
 
 @subheading Durations (rhythms)
 
-Glosario musical: @rglos{beam}, @rglos{duration}, @rglos{whole note},
-@rglos{half note}, @rglos{quarter note}, @rglos{dotted note}.
+@cindex duraciones de las notas
+@cindex notas, duraciones de
+@cindex ritmos
+@cindex redonda
+@cindex blanca
+@cindex negra
+@cindex figura con puntillo
+@cindex puntillo
+@cindex notación de las duraciones
+
+Glosario musical:
+@rglos{beam},
+@rglos{duration},
+@rglos{whole note},
+@rglos{half note},
+@rglos{quarter note},
+@rglos{dotted note}.
 
 La @notation{duración} de una nota se especifica mediante un número
-después del nombre de la nota.  @code{1} significa @rglos{redonda},
-@code{2} significa @rglos{blanca}, @code{4} significa @rglos{negra} y
-así sucesivamente.  Las @notation{barras de corchea} se añaden
-automáticamente.
+después del nombre de la nota.  @code{1} significa @notation{redonda},
+@code{2} significa @notation{blanca}, @code{4} significa
+@notation{negra} y así sucesivamente.  Las @notation{barras de
+corchea} se añaden automáticamente.
 
 Si no especifica una duración, se utiliza la duración previa para la
 nota siguiente.  La figura por omisión de la primera nota es una
 negra.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   a1
   a2 a4 a8 a
@@ -341,12 +390,11 @@ negra.
 }
 @end lilypond
 
-Para crear notas con puntillo (véase @rglos{dotted note}), añada un
-punto @samp{.} al número de la duración.  La duración de una nota con
-puntillo se debe especificar de forma explícita (es decir: mediante un
-número).
+Para crear @notation{notas con puntillo}, añada un punto @code{.} al
+número de la duración.  La duración de una nota con puntillo se debe
+especificar de forma explícita (es decir: mediante un número).
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   a a a4. a8
   a8. a16 a a8. a8 a4.
@@ -356,12 +404,16 @@ número).
 
 @subheading Rests
 
-Glosario musical: @rglos{rest}.
+@cindex silencio
+@cindex notación de los silencios
 
-Un @notation{rest} se introduce igual que si fuera una nota con el
-nombre @code{r}:
+Glosario musical:
+@rglos{rest}.
 
-@lilypond[verbatim,quote,ragged-right]
+Un @notation{silencio} se introduce igual que si fuera una nota con el
+nombre @code{r}@tie{}:
+
+@lilypond[verbatim,quote]
 \relative c'' {
   a r r2
   r8 a r4 r4. r8
@@ -371,12 +423,18 @@ nombre @code{r}:
 
 @subheading Time signature
 
-Glosario musical: @rglos{time signature}.
+@cindex compás, indicación de
+
+@funindex \time
+@funindex time
+
+Glosario musical:
+@rglos{time signature}.
 
 La @notation{indicación de compás} se puede establecer con la orden
 @code{\time} :
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   \time 3/4
   a4 a a
@@ -390,12 +448,26 @@ La @notation{indicación de compás} se puede establecer con la orden
 
 @subheading Clef
 
-Glosario musical: @rglos{clef}.
+@cindex clave
+@cindex sol, clave de
+@cindex do en tercera, clave de
+@cindex do en cuarta, clave de
+@cindex fa, clave de
+@cindex treble
+@cindex alto
+@cindex tenor
+@cindex bass
+
+@funindex \clef
+@funindex clef
+
+Glosario musical:
+@rglos{clef}.
 
 La @notation{clave} se puede establecer utilizando la orden
 @code{\clef} :
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c' {
   \clef treble
   c1
@@ -414,7 +486,7 @@ La @notation{clave} se puede establecer utilizando la orden
 He aquí un pequeño ejemplo que muestra todos los elementos anteriores
 juntos:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c, {
   \time 3/4
   \clef bass
@@ -425,36 +497,52 @@ juntos:
 
 
 @seealso
-Referencia de la notación: @ruser{Writing pitches},
-@ruser{Writing rhythms}, @ruser{Writing rests},
-@ruser{Time signature}, @ruser{Clef}.
+Referencia de la notación:
+@ruser{Writing pitches},
+@ruser{Writing rhythms},
+@ruser{Writing rests},
+@ruser{Time signature},
+@ruser{Clef}.
 
 
-@node Working on text files
-@subsection Working on text files
+@node Working on input files
+@subsection Working on input files
+
+@cindex llaves
+@cindex comentarios
+@cindex línea, comentario de
+@cindex comentario de línea
+@cindex bloque, comentario de
+@cindex mayúsculas, sensible a
+@cindex espacios, insensible a
+@cindex expresiones
+
+@funindex { ... }
+@funindex %
+@funindex %@{ ... %@}
 
 Los archivos de entrada de LilyPond son como los archivos fuente de
 muchos lenguajes de programación corrientes.  Son sensibles a las
 mayúsculas e insensibles al número de espacios Las expresiones se
 forman con llaves @{ @} y los comentarios se denotan por un signo de
-porcentaje (@code{%}) o por @code{%@{ ... %@}}.
+porcentaje (@code{%}) o por @w{@code{%@{ ... %@}}}.
 
 Si la frase anterior no tiene sentido para usted ¡no se preocupe! A
 continuación explicaremos el significado de todos estos términos:
 
 @itemize
 
-@cindex Sensible a las mayúsculas
-@item @strong{Sensible a las mayúsculas}:
-tiene importancia el hecho de que introduzca una letra en minúsculas
-(p.ej. @code{a, b, s, t}) o en mayúsculas (p.ej.  @code{A, B, S, T}).
-Las notas son minúsculas: @code{@{ c d e @}} es una entrada válida;
-@code{@{ C D E @}} produciría un mensaje de error.
+@item
+@strong{Sensible a las mayúsculas}: tiene importancia el hecho de que
+introduzca una letra en minúsculas (p.ej. @w{@code{a, b, s, t}}) o en
+mayúsculas (p.ej.  @w{@code{A, B, S, T}}).  Las notas son minúsculas:
+@w{@code{@{ c d e @}}} es una entrada válida; @w{@code{@{ C D E @}}}
+produciría un mensaje de error.
 
-@item @strong{Insensible al número de espacios}:
-no importa cuántos espacios (o saltos de línea) añada.  @code{@{ c d e
-@}} significa lo mismo que @code{@{ c @tie{} @tie{} @tie{} d e @}} y
-que
+@item
+@strong{Insensible al número de espacios}: no importa cuántos espacios
+(o saltos de línea) añada.  @w{@code{@{ c d e @}}} significa lo mismo
+que @w{@code{@{ c @tie{}} @tie{} @tie{} d e @}} y que
 
 @example
 @{ c                        d
@@ -482,7 +570,7 @@ de un espacio a no ser que se encuentren al comienzo o al final de una
 línea, para evitar cualquier ambigüedad.
 
 Una instrucción de LilyPond seguida de una expresión simple entre
-llaves (como por ejemplo @code{\relative @{ @}}) también es una
+llaves (como por ejemplo @w{@code{\relative @{ @}}}) también es una
 expresión musical unitaria.
 
 @cindex comentarios
@@ -517,11 +605,11 @@ fragmento muestra algunos posibles usos para los comentarios:
   c4 c g' g a a g2
 
 %@{
-    Esta línea y las notas que aparecen más abajo
-    se ignoran, por estar dentro de un
-    comentario de bloque.
+  Esta línea y las notas que aparecen más abajo
+  se ignoran, por estar dentro de un
+  comentario de bloque.
 
-    g g f f e e d d c2
+  f f e e d d c2
 %@}
 @end example
 
@@ -531,18 +619,22 @@ fragmento muestra algunos posibles usos para los comentarios:
 @node How to read the manual
 @subsection How to read the manual
 
-Como vimos en @ref{Working on text files}, la entrada de LilyPond debe
-estar rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}.
-Durante el resto del presente manual, la mayor parte de los ejemplos
-omitirán las llaves.  Para reproducir los ejemplos, deberá copiar y
-pegar la entrada que se muestra, pero @strong{deberá} escribir
-@code{\relative c'' @{ @}}, de la siguiente forma:
-
-Si está leyendo la documentación HTML y quiere ver el código de LilyPond exacto
-que se utilizó para crear el ejemplo, sencillamente haga clic
-sobre la imagen.  Si no está leyendo la versión en HTML, podría
-copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir
-@code{\relative c'' @{ @}} de la siguiente manera:
+@cindex cómo leer el manual
+@cindex manual, lectura del
+@cindex leer el manual
+@cindex ejemplos, pulsar
+@cindex pulsar sobre los ejemplos
+@cindex consejos para construir archivos
+@cindex plantillas
+@cindex construir archivos, consejos
+@cindex archivos, consejos para construir
+
+Como ya vimos en @ref{Working on input files}, el código de entrada de
+LilyPond debe estar rodeado de llaves @{ @} o de @w{@code{\relative
+c'' @{ ... @}}}.  Durante el resto del presente manual, la mayor parte
+de los ejemplos omitirán las llaves.  Para reproducir los ejemplos,
+deberá copiar y pegar la entrada que se muestra, pero @strong{deberá}
+escribir el @w{@code{\relative c'' @{ @}}}, de la siguiente forma:
 
 @example
 \relative c'' @{
@@ -552,29 +644,28 @@ copiar y pegar la entrada que se muestra, pero @strong{deberá} añadir
 
 ¿Por qué omitir las llaves? Casi todos los ejemplos del presente
 manual se pueden insertar en medio de un fragmento mayor de música.
-Para estos ejemplos no tiene ningún sentido añadir @code{\relative c''
-@{ @}} (¡no debería poner un @code{\relative} dentro de otro
-@code{\relative}!); si hubiésemos incluido @code{\relative c'' @{ @}}
+Para estos ejemplos no tiene ningún sentido añadir @w{@code{\relative
+c'' @{ @}}} (¡no debería poner un @code{\relative} dentro de otro
+@code{\relative}!); si hubiésemos incluido @w{@code{\relative c'' @{ @}}}
 rodeando a cada uno de los ejemplos, usted no podría copiar un ejemplo
 pequeño procedente de la documentación y pegarlo dentro de su propia
 pieza.  La mayoría querrá insertar el código dentro de una pieza más
-grande, por eso hemos formateado el manual de esta forma.
+grande, por eso hemos formateado el manual de esta manera.
 
 
 
 @subheading Clickable examples
 
-Muchas personas aprenden a utilizar programas probando y enredando con ellos.
-Esto también puede hacerse con LilyPond.  Si hace clic sobre una imagen
-en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond
-que se utilizó para generar esa imagen.
-Pruébelo sobre esta imagen:
+Muchas personas aprenden a utilizar programas probando y enredando con
+ellos.  Esto también puede hacerse con LilyPond.  Si hace clic sobre
+una imagen en la versión en HTML de este manual, podrá ver la entrada
+exacta de LilyPond que se utilizó para generar esa imagen.  Pruébelo
+sobre esta imagen:
 
 @c no verbatim here
-@c KEEP LY
-@lilypond[quote,ragged-right]
+@lilypond[quote]
 \relative c'' {
-  c-\markup { \bold \huge { Haga clic aquí.  } }
+  c-\markup { \bold \huge { Click here.  } }
 }
 @end lilypond
 
@@ -588,8 +679,8 @@ para sus experimentos. Para poder ver exactamente el mismo resultado
 
 
 Podrá encontrar más consejos y trucos para la construcción de archivos
-de entrada en @ref{Suggestions for writing LilyPond files}; pero
-podría ser mejor leer primero el resto del presente manual.
+de entrada en @ref{Suggestions for writing LilyPond files}; pero quizá
+sea mejor leer primero el resto del tutorial.
 
 
 @node Single staff notation
@@ -599,12 +690,12 @@ Esta sección es una introducción a la notación corriente que se utiliza para
 o un pentagrama.
 
 @menu
-* Accidentals and key signatures::  
-* Ties and slurs::              
-* Articulation and dynamics::   
-* Adding text::                 
-* Automatic and manual beams::  
-* Advanced rhythmic commands::  
+* Accidentals and key signatures::
+* Ties and slurs::
+* Articulation and dynamics::
+* Adding text::
+* Automatic and manual beams::
+* Advanced rhythmic commands::
 @end menu
 
 
@@ -613,67 +704,123 @@ o un pentagrama.
 
 @subheading Accidentals
 
-Una nota @rglos{sharp} se hace añadiendo @samp{is} al
-nombre, y una nota @rglos{flat} añadiendo @samp{es}.  Como
-ha podido adivinar, un @rglos{double sharp} o @rglos{double flat} se hace
-añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis
-derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas
-como el alemán y el holandés.  Para utilizar otros nombres para las alteraciones accidentales, vea
-@ruser{Note names in other languages}.}
+@cindex accidentales, alteraciones
+@cindex alteraciones
+@cindex alteraciones y armaduras
+@cindex sostenido
+@cindex doble sostenido
+@cindex sostenido, doble
+@cindex bemol
+@cindex doble bemol
+@cindex bemol, doble
+
+@funindex es
+@funindex is
+@funindex eses
+@funindex isis
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+Glosario musical:
+@rglos{sharp},
+@rglos{flat},
+@rglos{double sharp},
+@rglos{double flat},
+@rglos{accidental}.
+
+Una nota con @notation{sostenido} se hace añadiendo @code{is} al
+nombre, y una nota @notation{bemol} añadiendo @code{es}.  Como ha
+podido adivinar, un @notation{doble sostenido} o @notation{doble
+bemol} se hace añadiendo @code{isis} o @code{eses}.  Esta sintaxis se
+deriva de las convenciones para da nombre a las notas de las lenguas
+nórdicas y germánicas como el alemán y el holandés.  Para utilizar
+otros nombres para las @notation{alteraciones accidentales}, véase
+@ruser{Note names in other languages}.
+
+@lilypond[verbatim,quote,relative=2]
 cis1 ees fisis, aeses
 @end lilypond
 
 @cindex tonalidad, armadura de la, establecer
 @subheading Key signatures
 
-La armadura de la tonalidad se establece mediante la instrucción @code{\key} seguido de
-una nota y @code{\major} o @code{\minor}.
+@cindex tonalidad, armadura de
+@cindex armadura
+@cindex mayor
+@cindex menor
+@cindex alteraciones y armadura
+@cindex contenido frente a presentación
+@cindex presentación frente a contenido
+
+@funindex \key
+@funindex key
+@funindex \major
+@funindex major
+@funindex \minor
+@funindex minor
+
+Glosario musical:
+@rglos{key signature},
+@rglos{major},
+@rglos{minor}.
+
+La @notation{armadura de la tonalidad} se establece mediante la
+instrucción @code{\key} seguido de una nota y @code{\major} o
+@code{\minor}.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \key d \major
 a1
 \key c \minor
 a
 @end lilypond
 
-@sp 1
+@smallspace
 
 @subheading Warning: key signatures and pitches
 
-Para determinar si hay que imprimir una alteración accidental, LilyPond examina las
-notas y la armadura de la tonalidad.  La armadura solamente afecta a las
-alteraciones @emph{impresas}, ¡no a las propias notas!  Ésta es una
-funcionalidad que frecuentemente confunde a los que se inician con el programa, por ello permítanos explicarla
-en detalle.
+Glosario musical:
+@rglos{accidental},
+@rglos{key signature},
+@rglos{pitch},
+@rglos{flat},
+@rglos{natural},
+@rglos{sharp},
+@rglos{transposition}.
+
+Para determinar si hay que imprimir una @notation{alteración
+accidental}, LilyPond examina las notas y la @notation{armadura de la
+tonalidad}.  La armadura solamente afecta a las alteraciones
+@emph{impresas}, ¡no a las propias notas!  Esta funcionalidad suele
+confundir a los que están empezando con el programa, por ello
+permítanos explicarla en detalle.
 
 LilyPond hace una clara distinción entre el contenido musical y la
-presentación.  La alteración (bemol, becuadro o sostenido) de una nota es parte de
-la altura, y por tanto es contenido musical.  Si una alteración (un
-signo @emph{impreso} de bemol, becuadro o sostenido) se imprime o no delante de la
-nota correspondiente, es una cuestión de presentación.  La presentación es algo que
-sigue unas reglas, así que las alteraciones accidentales se imprimen automáticamente según
-dichas reglas.  Las alturas de las notas en su música son obras de arte, por tanto no se
-añadirán automáticamente, y usted deberá introducir aquello que quiera oír.
-
-En el siguiente ejemplo
-
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+presentación.  La alteración (@notation{bemol}, @notation{becuadro} o
+@notation{sostenido}) de una nota es parte de la altura, y por tanto
+es contenido musical.  Si una alteración (un signo @emph{impreso} de
+bemol, becuadro o sostenido) se imprime o no delante de la nota
+correspondiente, es una cuestión de presentación.  La presentación es
+algo que sigue unas reglas, así que las alteraciones accidentales se
+imprimen automáticamente según dichas reglas.  Las alturas de las
+notas en su música son obras de arte, por tanto no se añadirán
+automáticamente, y usted deberá introducir aquello que quiera oír.
+
+En el siguiente ejemplo:
+
+@lilypond[verbatim,quote,relative=2]
 \key d \major
 d cis fis
 @end lilypond
 
 @noindent
-ninguna nota lleva una alteración impresa, pero de todas formas usted debe añadir la @samp{is} a
-@code{cis} y a @code{fis}.
+ninguna nota lleva una alteración impresa, pero de todas formas usted
+debe añadir el @code{is} a @code{cis} y a @code{fis}.
 
-El texto @samp{e} no significa @qq{imprimir una bolita negra en la
+El texto @code{e} no significa @qq{imprimir una bolita negra en la
 primera línea del pentagrama.}  Más bien significa: @qq{hay una nota
 Mi natural.}  En la tonalidad de La bemol mayor, @emph{lleva} una
 alteración accidental:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \key aes \major
 e
 @end lilypond
@@ -700,7 +847,15 @@ Glosario musical:
 @node Ties and slurs
 @subsection Ties and slurs
 
-@cindex ligaduras de unión
+@cindex ligadura de unión
+@cindex ligadura de expresión
+@cindex ligadura de fraseo
+@cindex fraseo, ligadura de
+
+@funindex ~
+@funindex ( ... )
+@funindex \( ... \)
+
 @subheading Ties
 
 Glosario musical:
@@ -709,12 +864,11 @@ Glosario musical:
 Una @notation{tie} se crea adjuntando un carácter de tilde curva @code{~}
 a la primera nota ligada:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 g4~ g c2~
 c4 ~ c8 a8 ~ a2
 @end lilypond
 
-@cindex ligaduras de expresión
 @subheading Slurs
 
 Glosario musical:
@@ -724,12 +878,10 @@ Una @notation{slur} es una curva que se traza abarcando varias notas.
 Las notas inicial y final se marcan mediante @code{(} y @code{)}
 respectivamente.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 d4( c16) cis( d e c cis d) e( d4)
 @end lilypond
 
-@cindex fraseo, ligaduras de
-@cindex ligaduras de fraseo
 @subheading Phrasing slurs
 
 Glosario musical:
@@ -742,7 +894,7 @@ haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, pero
 no es posible tener legatos simultáneos o ligaduras de expresión
 simultáneas.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a8(\( ais b c) cis2 b'2 a4 cis,\)
 @end lilypond
 
@@ -764,7 +916,7 @@ indican la @notation{articulación} de las notas, y se pueden utilizar
 sobre grupos mayores de notas.  Las ligaduras de unión y de expresión
 se pueden anidar unas dentro de otras.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
@@ -779,31 +931,36 @@ Referencia de la notación:
 @node Articulation and dynamics
 @subsection Articulation and dynamics
 
+@subheading Articulations
+
 @cindex articulación
-@cindex acentos
+@cindex acento
 @cindex staccato
-@subheading Articulations
 
 Glosario musical:
 @rglos{articulation}.
 
 Las @notation{articulaciones} más corrientes se pueden añadir a las
-notas utilizando un guión @samp{-} seguido de un carácter único:
+notas utilizando un guión @code{-} seguido de un carácter único:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c-. c-- c-> c-^ c-+ c-_
 @end lilypond
 
-@cindex digitaciones
 @subheading Fingerings
 
+@cindex digitaciones
+
+@funindex ^
+@funindex _
+
 Glosario musical:
 @rglos{fingering}.
 
-De manera similar, las indicaciones de digitación se pueden añadir a
-una nota utilizando un guión (@code{-}) seguido del dígito deseado:
+De manera similar, las @notation{digitaciones} se pueden añadir a una
+nota utilizando un guión (@code{-}) seguido del dígito deseado:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c-3 e-5 b-2 a-1
 @end lilypond
 
@@ -813,12 +970,30 @@ automática, pero puede especificar una dirección mediante @code{^}
 articulaciones sobre la misma nota.  Sin embargo, casi siempre es
 mejor dejar que LilyPond determine la dirección de las articulaciones.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c_-^1 d^. f^4_2-> e^-_+
 @end lilypond
 
 @subheading Dynamics
 
+@cindex dinámica, indicaciones de
+@cindex matices
+@cindex decrescendo
+@cindex crescendo
+
+@funindex \f
+@funindex \ff
+@funindex \mp
+@funindex \p
+@funindex \mf
+@funindex \pp
+@funindex \<
+@funindex <
+@funindex \>
+@funindex >
+@funindex \!
+@funindex !
+
 Glosario musical:
 @rglos{dynamics},
 @rglos{crescendo},
@@ -827,20 +1002,16 @@ Glosario musical:
 Las expresiones de @notation{matiz} o signos dinámicos se hacen
 añadiendo las marcas (con una barra invertida) a la nota:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c\ff c\mf c\p c\pp
 @end lilypond
 
-@cindex expresiones dinámicas
-@cindex decrescendo
-@cindex crescendo
-
 Los @notation{crescendi} y @notation{decrescendi} comienzan con las
 órdenes @code{\<} y @code{\>}.  La siguiente indicación de matiz, como
 por ejemplo @code{\f}, dará por terminado el (de)crescendo, o bien se
 puede usar la instrucción @code{\!}:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
@@ -855,15 +1026,22 @@ Referencia de la notación:
 @node Adding text
 @subsection Adding text
 
+@cindex texto, añadir
+@cindex añadir texto
+@cindex marcado
+
+@funindex \markup
+@funindex markup
+
 Es posible añadir texto a la partitura:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c1^"espr" a_"legato"
 @end lilypond
 
 Se puede aplicar un formateo adicional mediante la instrucción @code{\markup}:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c1^\markup{ \bold espr}
 a1_\markup{
   \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
@@ -880,14 +1058,27 @@ Referencia de la notación:
 @node Automatic and manual beams
 @subsection Automatic and manual beams
 
+@cindex barras de corchea
+@cindex barrado
+@cindex automáticas, barras
+@cindex manuales, barras
+@cindex barras automáticas
+@cindex barras manuales
+
+@funindex [ ... ]
+@funindex [
+@funindex ]
+@funindex \autoBeamOff
+@funindex autoBeamOff
+@funindex \autoBeamOn
+@funindex autoBeamOn
+
 Glosario musical:
 @rglos{beam}.
 
-@cindex barras, establecimiento manual
-
 Todas las @notation{barras} de las figuras se dibujan automáticamente:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a8 ais d ees r d c16 b a8
 @end lilypond
 
@@ -896,10 +1087,21 @@ Si no le gustan las barras automáticas, pueden forzarse manualmente.
 Marque la primera nota que comprende la barra con @code{[} y la última
 con @code{]}.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
+Si quiere desactivar completamente el barrado automático o para una
+sección extensa de música, utilice la instrucción @code{\autoBeamOff}
+para apagarlo y @code{\autoBeamOn} para activarlo de nuevo.
+
+@lilypond[verbatim,quote,relative=2]
+\autoBeamOff
+a8 c b4 d8. c16 b4
+\autoBeamOn
+a8 c b4 d8. c16 b4
+@end lilypond
+
 @seealso
 
 Referencia de la notación:
@@ -910,9 +1112,13 @@ Referencia de la notación:
 @node Advanced rhythmic commands
 @subsection Advanced rhythmic commands
 
+@subheading Partial measure
+
 @cindex anacrusa
 @cindex compás parcial
-@subheading Partial measure
+
+@funindex \partial
+@funindex partial
 
 Glosario musical:
 @rglos{anacrusis}.
@@ -921,14 +1127,18 @@ Una @notation{anacrusa} se introduce con la palabra clave
 @code{\partial}.  Va seguida de una duración: @code{\partial 4} es una
 anacrusa de negra y @code{\partial 8} de corchea.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \partial 8
 f8 c2 d
 @end lilypond
 
+@subheading Tuplets
+
 @cindex grupos especiales
 @cindex tresillos
-@subheading Tuplets
+
+@funindex \times
+@funindex times
 
 Glosario musical:
 @rglos{note value},
@@ -940,17 +1150,25 @@ de música.  La duración del fragmento de música se multiplica por la
 fracción.  Los tresillos hacen que las notas ocupen 2/3 de su duración
 expresa, por tanto un @notation{tresillo} lleva una fracción de 2/3:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \times 2/3 { f8 g a }
 \times 2/3 { c r c }
 \times 2/3 { f,8 g16[ a g a] }
 \times 2/3 { d4 a8 }
 @end lilypond
 
+@subheading Grace notes
+
 @cindex notas de adorno
 @cindex acciaccatura
 @cindex appoggiatura
-@subheading Grace notes
+
+@funindex \grace
+@funindex grace
+@funindex \acciaccatura
+@funindex acciaccatura
+@funindex \appoggiatura
+@funindex acciaccatura
 
 Glosario musical:
 @rglos{grace notes},
@@ -962,7 +1180,7 @@ Las @notation{notas de adorno} se crean con la instrucción
 expresión musical por la palabra clave @code{\appoggiatura} o
 @code{\acciaccatura}
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2 \grace { a32[ b] } c2
 c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
@@ -989,22 +1207,27 @@ La palabra @qq{polifonía} en LilyPond se refiere al hecho de tener más
 de una voz en el mismo pentagrama.
 
 @menu
-* Music expressions explained::  
-* Multiple staves::             
-* Staff groups::                
-* Combining notes into chords::  
-* Single staff polyphony::      
+* Music expressions explained::
+* Multiple staves::
+* Staff groups::
+* Combining notes into chords::
+* Single staff polyphony::
 @end menu
 
 
 @node Music expressions explained
 @subsection Music expressions explained
 
+@cindex musical, expresión
+@cindex expresión musical
+@cindex compuesta, expresión musical
+@cindex musical, expresión, compuesta
+
 En los archivos de entrada de LilyPond, la música se representa
 mediante @emph{expresiones musicales}.  Una sola nota es una expresión
 musical:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a4
 @end lilypond
 
@@ -1012,7 +1235,7 @@ Al encerrar un grupo de notas dentro de llaves creamos una
 @emph{expresión musical compuesta}.  Aquí hemos creado una expresión
 musical compuesta con dos notas:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 { a4 g4 }
 @end lilypond
 
@@ -1021,12 +1244,10 @@ de llaves, eso significa que se encuentran en secuencia (es decir,
 cada una sigue a la anterior).  El resultado es otra expresión
 musical:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 { { a4 g } f g }
 @end lilypond
 
-@cindex expresión
-@cindex expresión musical
 @subheading Analogy: mathematical expressions
 
 Este mecanismo es semejante a las fórmulas matemáticas: una fórmula
@@ -1056,6 +1277,21 @@ hace necesario para músicas complejas como las partituras polifónicas.
 
 @subheading Simultaneous music expressions: multiple staves
 
+@cindex varios pentagramas
+@cindex pentagramas, varios
+@cindex polifonía
+@cindex combinar expresiones en paralelo
+@cindex paralelas, expresiones
+@cindex expresiones paralelas
+@cindex relativo, modo, música simultánea y
+@cindex relativo, modo, expresiones paralelas y
+@cindex simultánea, música, modo relativo y
+@cindex paralelas, expresiones, modo relativo y
+
+@funindex <<
+@funindex >>
+@funindex << ... >>
+
 Glosario musical:
 @rglos{polyphony}.
 
@@ -1069,7 +1305,7 @@ musical @q{simultánea} se forma encerrando las expresiones dentro de
 una de las cuales contiene dos notas diferentes) se combinan de forma
 simultánea:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
     { a4 g }
@@ -1097,7 +1333,7 @@ examina la primera expresión.  Si ésta consiste en una sola nota, hay
 un solo pentagrama; si hay una expresión simultánea, hay más de un
 pentagrama.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   c2 <<c e>>
   << { e f } { c <<b d>> } >>
@@ -1107,6 +1343,22 @@ pentagrama.
 @node Multiple staves
 @subsection Multiple staves
 
+@cindex varios pentagramas
+@cindex pentagramas, varios
+@cindex contexto
+@cindex contexto de notación
+@cindex notación, contexto de
+
+@funindex \new Staff
+@funindex new Staff
+@funindex Staff
+@funindex \new
+@funindex new
+@funindex Score
+@funindex Voice
+@funindex Lyrics
+@funindex ChordNames
+
 Como ya hemos visto en @ref{Music expressions explained}, los
 archivos de entrada para LilyPond se construyen a base de expresiones
 musicales.  Si la partitura comienza con expresiones musicales
@@ -1119,7 +1371,7 @@ constituye un pentagrama se marca escribiendo @code{\new Staff} antes
 de él.  Estos elementos @code{Staff} se combinan después en paralelo
 con @code{<<} y @code{>>}:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
     \new Staff { \clef treble c }
@@ -1152,7 +1404,7 @@ Este comportamiento predeterminado diferente es a causa de que las
 partituras con instrumentos transpositores son más comunes que las
 partituras polirrítmicas.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
     \new Staff { \clef treble \key d \major \time 3/4 c }
@@ -1164,9 +1416,16 @@ partituras polirrítmicas.
 @node Staff groups
 @subsection Staff groups
 
-@cindex piano staff
-@cindex choir staff
-@cindex grand staff
+@cindex sistema de piano
+@cindex piano, sistema de
+@cindex sistema de coro
+@cindex coro, sistema de
+@cindex grupo de pentagramas
+@cindex pentagramas, grupo de
+
+@funindex PianoStaff
+@funindex GrandStaff
+@funindex ChoirStaff
 
 Glosario musical:
 @rglos{brace}.
@@ -1186,7 +1445,7 @@ completa se coloca dentro de un @code{PianoStaff}:
 
 He aquí un pequeño ejemplo:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   \new PianoStaff <<
     \new Staff { \time 2/4 c4 e g g, }
@@ -1205,7 +1464,7 @@ de las líneas divisorias.
 @seealso
 
 Referencia de la notación:
-@ruser{Keyboard instruments},
+@ruser{Keyboard and other multi-staff instruments},
 @ruser{Displaying staves}.
 
 
@@ -1213,6 +1472,11 @@ Referencia de la notación:
 @subsection Combining notes into chords
 
 @cindex acordes
+@cindex duraciones de notas en acordes
+
+@funindex <
+@funindex >
+@funindex < ... >
 
 Glosario musical:
 @rglos{chord}.
@@ -1226,7 +1490,7 @@ tener la misma duración, y que la duración se escribe después del
 ángulo de cierre.
 
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 r4 <c e g>4 <c f a>2
 @end lilypond
 
@@ -1237,7 +1501,7 @@ adjuntar también a un acorde, y todo debe ir @emph{por fuera} de los
 con acordes.  Tan sólo debe recordar que se escriben por fuera de los
 ángulos.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 r4 <c e g>8[ <c f a>]~ <c f a>2
 r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
 @end lilypond
@@ -1248,7 +1512,15 @@ r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
 
 @cindex polifonía
 @cindex varias voces
-@cindex voces, más (en un solo pentagrama)
+@cindex voces, más, en un solo pentagrama
+@cindex único, polifonía en pentagrama
+@cindex separador, silencio
+@cindex silencio separador
+
+@funindex << ... \\ ... >>
+@funindex <<
+@funindex \\
+@funindex >>
 
 Cuando distintas líneas melódicas se combinan sobre un solo
 pentagrama, se imprimen como voces polifónicas; cada voz lleva sus
@@ -1257,10 +1529,10 @@ las plicas hacia arriba mientras que la voz inferior las tiene hacia
 abajo.
 
 La introducción de estas partes se hace escribiendo cada voz en forma
-de secuencia (con @code{@{...@}}) y combinando éstas de forma
+de secuencia (con @w{@code{@{...@}}}) y combinando éstas de forma
 simultánea, separando las voces con @code{\\}
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { r4 g4 f2 f4 }
@@ -1273,7 +1545,7 @@ impresos.  Son muy útiles para rellenar voces que temporalmente no
 están cantando.  He aquí el mismo ejemplo con un silencio separador
 (@code{s}) en vez de un silencio normal (@code{r}):
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { s4 g4 f2 f4 }
@@ -1283,7 +1555,7 @@ están cantando.  He aquí el mismo ejemplo con un silencio separador
 @noindent
 Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <<
   \new Staff <<
     { a4 g2 f4~ f4 } \\
@@ -1299,7 +1571,8 @@ Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
 
 @seealso
 
-Referencia de la notación: @ruser{Simultaneous notes}.
+Referencia de la notación:
+@ruser{Simultaneous notes}.
 
 
 @node Songs
@@ -1309,9 +1582,9 @@ En esta sección presentamos cómo elaborar música vocal y hojas de
 canción sencillas.
 
 @menu
-* Setting simple songs::        
-* Aligning lyrics to a melody::  
-* Lyrics to multiple staves::   
+* Setting simple songs::
+* Aligning lyrics to a melody::
+* Lyrics to multiple staves::
 @end menu
 
 
@@ -1321,13 +1594,16 @@ canción sencillas.
 @cindex letra
 @cindex canciones
 
+@funindex \addlyrics
+@funindex addlyrics
+
 Glosario musical:
 @rglos{lyrics}.
 
 Presentamos a continuación el inicio de la melodía de una canción
 infantil, @qq{Girls and boys come out to play}:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   \key g \major
   \time 6/8
@@ -1339,7 +1615,7 @@ La @notation{letra} se puede asignar a esas notas, combinando ambas
 con la palabra clave @code{\addlyrics}.  La letra se escribe separando
 cada sílaba mediante un espacio.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \major
@@ -1353,30 +1629,34 @@ cada sílaba mediante un espacio.
 @end lilypond
 
 Observe las llaves rodeando tanto la música como la letra, y los
-ángulos dobles @code{<< ... >>} alrededor del fragmento entero para
-expresar que la música y la letra han de suceder al mismo tiempo.
+ángulos dobles @w{@code{<< ... >>}} alrededor del fragmento entero
+para expresar que la música y la letra han de suceder al mismo tiempo.
 
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
-Glosario musical:
-@rglos{melisma},
-@rglos{extender line}.
-
 @cindex melisma
 @cindex línea de extensión
 @cindex guión
 @cindex guión bajo
+@cindex letra, alineación de
+@cindex alineación de la letra
+@cindex letra, palabras polisílabas
+@cindex palabras polisílabas en la letra
 
-La siguiente línea de la canción infantil es @q{The moon doth shine as
-bright as day}.  A continuación vamos a ampliarla:
+Glosario musical:
+@rglos{melisma},
+@rglos{extender line}.
 
-@lilypond[verbatim,quote,ragged-right]
+La siguiente línea de la canción infantil es @notation{The moon doth
+shine as bright as day}.  A continuación vamos a ampliarla:
+
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \major
     \time 6/8
-    d4 b8 c4 a8 d4 b8 g4 
+    d4 b8 c4 a8 d4 b8 g4
     g8 a4 b8 c b a d4 b8 g4.
   }
   \addlyrics {
@@ -1393,43 +1673,60 @@ canta sobre más de una nota.  Existen varias formas de hacer que una
 sílaba recaiga sobre varias notas, siendo la más sencilla escribir una
 ligadura de expresión sobre ellas (véase @ref{Ties and slurs}):
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \major
     \time 6/8
-    d4 b8 c4 a8 d4 b8 g4 
-    g8 a4 b8 c([ b)] a d4 b8 g4.
+    d4 b8 c4 a8 d4 b8 g4
+    g8 a4 b8 c( b) a d4 b8 g4.
   }
   \addlyrics {
     Girls and boys come out to play,
     The moon doth shine as bright as day;
   }
->> 
+>>
 @end lilypond
 
-Aquí hemos usado además el barrado manual (los corchetes rectos
-@code{[ ]} ) para producir el barrado que corresponde a la letra por
-convención (véase @ref{Automatic and manual beams}).
+Ahora la letra se alinea correctamente con las notas, pero el barrado
+automático de las notas que corresponden a @notation{shine as} no
+parece correcto.  Podemos remediarlo insertando instrucciones de
+barrado manual para sobreescribir el barrado automático; para ver más
+detalles consulte @ref{Automatic and manual beams}.
+
+@lilypond[verbatim,quote]
+<<
+  \relative c'' {
+    \key g \major
+    \time 6/8
+    d4 b8 c4 a8 d4 b8 g4
+    g8 a4 b8 c([ b]) a d4 b8 g4.
+  }
+  \addlyrics {
+    Girls and boys come out to play,
+    The moon doth shine as bright as day;
+  }
+>>
+@end lilypond
 
 Como alternativa a la utilización de ligaduras de expresión, los
 melismas se pueden indicar solamente en la letra utilizando un guión
 bajo, @code{_}, para cada nota que queremos incluir dentro del
 melisma:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \major
     \time 6/8
-    d4 b8 c4 a8 d4 b8 g4 
+    d4 b8 c4 a8 d4 b8 g4
     g8 a4 b8 c[ b] a d4 b8 g4.
   }
   \addlyrics {
     Girls and boys come out to play,
     The moon doth shine _ as bright as day;
   }
->> 
+>>
 @end lilypond
 
 Si una sílaba se extiende sobre varias notas o una sola nota muy
@@ -1437,18 +1734,18 @@ larga, normalmente se traza una @notation{línea extensora} desde la
 sílaba que se extiende y por debajo de todas las notas que
 corresponden a dicha sílaba.  Se escribe como dos guiones bajos
 @code{__}.  He aquí un ejemplo extraído de los primeros tres compases
-del Lamento de Dido, de Dido y Eneas de Purcell:
+del @notation{Lamento de Dido}, de @notation{Dido y Eneas} de Purcell:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \minor
     \time 3/2
-    g2 a bes bes( a) 
+    g2 a bes bes( a)
     b c4.( bes8 a4. g8 fis4.) g8 fis1
   }
   \addlyrics {
-    When I am laid, 
+    When I am laid,
     am laid __ in earth,
   }
 >>
@@ -1465,17 +1762,17 @@ las notas.
 
 @c no ragged-right here because otherwise the hyphens get lost,
 @c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote]
+@lilypond[verbatim,quote,noragged-right]
 <<
   \relative c' {
     \key g \major
     \time 3/4
     \partial 4
-    d4 g4 g a8( b) g4 g4 
+    d4 g4 g a8( b) g4 g4
     b8( c) d4 d e4 c2
   }
   \addlyrics {
-    A -- way in a __ man -- ger, 
+    A -- way in a __ man -- ger,
     no __ crib for a bed, __
   }
 >>
@@ -1485,14 +1782,14 @@ Algunos textos (especialmente los que están en italiano o en español)
 requieren lo contrario: colocar más de una sílaba a una única nota.
 Esto se consigue enlazando las sílabas entre sí mediante un guión bajo
 simple @code{_} (sin ningún espacio), o bien encerrándolas entre
-corchetes.  Aquí aparece un ejemplo procedente del @qq{Barbero de
-Sevilla} de Rossini, donde la sílaba @q{al} se canta sobre la misma
-nota que @q{go} de la palabra @q{Largo} en el aria de Fígaro @q{Largo
-al factotum}:
+corchetes.  Aquí aparece un ejemplo procedente del @notation{Barbero
+de Sevilla} de Rossini, donde la sílaba @notation{al} se canta sobre
+la misma nota que la sílaba @notation{go} de la palabra @q{Largo} en
+el aria de Fígaro @notation{Largo al factotum}:
 
 @c no ragged-right here because otherwise the hyphens get lost,
 @c but the example is long enough to avoid looking strange.
-@lilypond[verbatim,quote]
+@lilypond[verbatim,quote,noragged-right]
 <<
   \relative c' {
     \clef bass
@@ -1517,26 +1814,29 @@ Referencia de la notación:
 @node Lyrics to multiple staves
 @subsection Lyrics to multiple staves
 
+@cindex letra y varios pentagramas
+@cindex varios pentagramas y letra
+
 La solución sencilla que utiliza @code{\addlyrics} se puede usar para
 poner letra a más de un pentagrama.  Aquí aparece un ejemplo sacado
-del @qq{Judas Macabeo} de Haendel:
+del @notation{Judas Macabeo} de Haendel:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 <<
-  {
-    \time 6/8
-    \partial 8
-  }
   \relative c'' {
     \key f \major
-    c8 c([ bes)] a a([ g)] f f'4. b, c4.~ c4
+    \time 6/8
+    \partial 8
+    c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
   }
   \addlyrics {
     Let flee -- cy flocks the hills a -- dorn, __
   }
   \relative c' {
     \key f \major
-    r8 r4. r4 c8 a'([ g)] f f([ e)] d e([ d)] c bes'4
+    \time 6/8
+    \partial 8
+    r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
   }
   \addlyrics {
     Let flee -- cy flocks the hills a -- dorn,
@@ -1544,9 +1844,9 @@ del @qq{Judas Macabeo} de Haendel:
 >>
 @end lilypond
 
-@noindent
-pero cualquier partitura de una complejidad mayor que la de este
-sencillo ejemplo se hace mejor separando la letra de la estructura de
+
+Cualquier partitura de una complejidad mayor que la de este sencillo
+ejemplo se hace mejor separando la letra de la estructura de
 pentagramas mediante variables (expresiones con nombre).  Éstas se
 tratan en @ref{Organizing pieces with variables}.
 
@@ -1563,17 +1863,27 @@ toques finales a piezas sencillas, y ofrece una introducción al resto
 del manual.
 
 @menu
-* Organizing pieces with variables::  
-* Version number::              
-* Adding titles::               
-* Absolute note names::         
-* After the tutorial::          
+* Organizing pieces with variables::
+* Version number::
+* Adding titles::
+* Absolute note names::
+* After the tutorial::
 @end menu
 
 
 @node Organizing pieces with variables
 @subsection Organizing pieces with variables
 
+@cindex variables
+@cindex variables, definir
+@cindex identificadores
+@cindex macros
+@cindex assignación de variables
+@cindex uso de las variables
+@cindex variables, uso de
+@cindex variables, caracteres permitidos en
+@cindex caracteres permitidos en variables
+
 Cuando los elementos que hemos discutido anteriormente se combinan
 para producir archivos mayores, las expresiones musicales se hacen
 enormes.  En música polifónica con muchos pentagramas, los archivos de
@@ -1590,16 +1900,20 @@ musicaConNombre = @{ @dots{} @}
 
 El contenido de la expresión musical @code{musicaConNombre} se puede usar
 posteriormente colocando una barra invertida delante del nombre
-(@code{\musicaConNombre}, igual que una orden normal de LilyPond). 
+(@code{\musicaConNombre}, igual que una orden normal de LilyPond).
 
-@lilypond[verbatim,quote,ragged-right]
-violin = \new Staff { \relative c'' {
-  a4 b c b
-}}
-cello = \new Staff { \relative c {
-  \clef bass
-  e2 d
-}}
+@lilypond[verbatim,quote]
+violin = \new Staff {
+  \relative c'' {
+    a4 b c b
+  }
+}
+cello = \new Staff {
+  \relative c {
+    \clef bass
+    e2 d
+  }
+}
 {
   <<
     \violin
@@ -1608,6 +1922,7 @@ cello = \new Staff { \relative c {
 }
 @end lilypond
 
+
 @noindent
 El nombre de una variable debe consistir enteramente en caracteres
 alfabéticos, es decir sin números, guiones ni guiones bajos.
@@ -1642,17 +1957,30 @@ lugares.  El siguiente ejemplo utiliza las variables anteriores:
 
 @example
 \paper @{
-  \papelAcinco
-  line-width = \ancho
+  \aFivePaper
+  line-width = \width
+@}
+@{
+  c4^\name
 @}
-@{ c4^\nombre @}
 @end example
 
 
 @node Version number
 @subsection Version number
 
-@cindex indicación de la versión
+@cindex versión
+@cindex versión, indicación de
+@cindex versión, número de
+@cindex actualizaciones
+@cindex futuras, actualizaciones
+@cindex actualizar archivos
+@cindex archivos, actualización de
+
+@funindex \version
+@funindex version
+@funindex convert-ly
+
 La indicación @code{\version} deja registrado para qué versión de
 LilyPond se escribió el archivo:
 
@@ -1666,7 +1994,7 @@ LilyPond.
 
 Estas anotaciones hacen menos problemáticas las subsiguientes
 actualizaciones de LilyPond.  Los cambios en la sintaxis se tratan
-mediante un programa especial, @file{convert-ly}, y utiliza
+mediante un programa especial, @command{convert-ly}, y utiliza
 @code{\version} para determinar qué reglas hay que aplicar.  Para ver
 más detalles, consulte @rprogram{Updating files with convert-ly}).
 
@@ -1674,10 +2002,17 @@ más detalles, consulte @rprogram{Updating files with convert-ly}).
 @node Adding titles
 @subsection Adding titles
 
+@cindex título
+@cindex cabeceras
+@cindex bloque de cabeceras
+
+@funindex \header
+@funindex header
+
 La información sobre el título, autor, número de Opus y similares se
 escriben en el bloque @code{\header}.  Éste se encuentra fuera de la
 expresión musical principal; el bloque @code{\header} normalmente se
-sitúa por debajo del @ref{Version number}.
+sitúa por debajo del número de versión.
 
 @example
 \version @w{"@version{}"}
@@ -1700,6 +2035,13 @@ en @ruser{Creating titles}.
 @node Absolute note names
 @subsection Absolute note names
 
+@cindex notas, nombres de
+@cindex notas, nombres absolutos de
+@cindex absoluto, modo
+@cindex absolutos, valores de altura
+@cindex alturas, valores absolutos de
+@cindex absolutos, nombres de nota
+
 Hasta el momento siempre hemos utilizado @code{\relative} para definir
 las alturas.  Ésta es la forma más sencilla de escribir la mayor parte
 de la música, pero existe otra forma de definir las alturas: el modo
@@ -1711,7 +2053,7 @@ una @code{b} significará siempre la nota inmediatamente por debajo del
 Do central, y una @code{g,} significará siempre la nota que se coloca
 en la primera línea del pentagrama en clave de Fa.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 {
   \clef bass
   c' b g, g,
@@ -1721,7 +2063,7 @@ en la primera línea del pentagrama en clave de Fa.
 
 He aquí una escala que abarca cuatro octavas:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 {
   \clef bass
   c, d, e, f,
@@ -1737,10 +2079,10 @@ He aquí una escala que abarca cuatro octavas:
 @end lilypond
 
 Como puede ver, escribir una melodía en clave de Sol implica escribir
-gran cantidad de apóstrofes @q{'} .  Consideremos este fragmento de
+gran cantidad de apóstrofos @q{'} .  Consideremos este fragmento de
 Mozart:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 {
   \key a \major
   \time 6/8
@@ -1749,11 +2091,11 @@ Mozart:
 }
 @end lilypond
 
-Todos estos apóstrofes hacen casi ilegible el código de entrada y será
+Todos estos apóstrofos hacen casi ilegible el código de entrada y será
 origen de numerosos errores.  Con @code{\relative}, el ejemplo
 anterior es mucho más fácil de leer:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   \key a \major
   \time 6/8
@@ -1791,3 +2133,16 @@ da por sentado que está familiarizado con la entrada de LilyPond.
 Puede saltarse estos capítulos ahora y volver a ellos cuando haya
 adquirido más experiencia.
 
+En este tutorial y en el resto del Manual de aprendizaje, existe un
+apartado @strong{Véase también} al final de cada una de las secciones,
+que contiene referencias cruzadas a otras secciones: no siga estas
+referencias durante la primera lectura; cuando haya leído el Manual de
+aprendizaje completo, quizá desee releer ciertas secciones y seguir
+las referencias cruzadas para obtener más información.
+
+Si no lo ha hecho aún, le @emph{rogamos} que lea @ref{About the
+documentation}.  Existe una gran cantidad de información sobre
+LilyPond, de manera que los recién llegados con frecuencia no saben
+exactamente dónde deben buscar la ayuda.  Si emplea cinco minutos en
+leer cuidadosamente esta sección ¡se ahorrará horas de frustración
+buscando en el sitio equivocado!