]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' into lilypond/translation
authorJohn Mandereau <john.mandereau@gmail.com>
Sat, 26 Jul 2008 16:56:38 +0000 (18:56 +0200)
committerJohn Mandereau <john.mandereau@gmail.com>
Sat, 26 Jul 2008 16:56:38 +0000 (18:56 +0200)
* master: (39 commits)
  Final (?) update.
  Update from Francisco.
  GDP: NR 4 Reintegrate section from LM
  brown paper bag typo.
  add snippet links.
  Reinstate commented-out parts.
  Update for NR 1.6
  Update from Jonathan.
  Layout nitpicks for notime fragment option.
  Typo.
  Another pass on expressive.itely
  Work around 'make web-clean' madness
  Disable docs compilation in input/manual
  Add maximumFretStretch to list of properties read by Fretboard_engraver
  Added music examples to common chords table
  Update fret diagrams in fretted-strings.itely
  Correct tablatureFormat definition.
  LSR: Update.
  Change references to fret diagrams in changing-defaults.itely
  Rewrite fret diagrams portion of fretted-strings.itely
  ...

Documentation/es/user/introduction.itely
Documentation/es/user/simultaneous.itely
Documentation/es/user/tutorial.itely

index 819b29307260eb38658602d9135a94b5af6599cb..ef6fe95ccc78e6443bf8305622a0f8fb6d227410 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 23542761090f167ad42dbff7ef11d44a9c1374ac
+    Translation of GIT committish: f6b77b196db5d80b891e133e58659095134424de
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -9,9 +9,24 @@
 
 @c \version "2.11.51"
 
+@c Translation status: post-GDP
+
 @node Introduction
 @chapter Introduction
 
+En este capítulo se presentan al lector LilyPond y su documentación.
+
+@menu
+* Background::
+* About the documentation::
+@end menu
+
+@node Background
+@section Background
+
+Esta sección se ocupa de las metas principales y la arquitectura de
+LilyPond.
+
 
 @menu
 * Engraving::                   
 * What symbols to engrave?::    
 * Music representation::        
 * Example applications::        
-* About the documentation::     
 @end menu
 
 
 @node Engraving
-@section Engraving
-
-El arte de la tipografía musical se conoce como @emph{grabado (en plancha)}.  El
-término deriva del proceso tradicional de la impresión musical.  Hace sólo unas
-décadas, la música impresa se hacía estampando la música
-sobre planchas de zinc o estaño de forma invertida como en un espejo.  Después la plancha se
-entintaba y las depresiones causadas por los cortes y estampados retenían
-la tinta.  Al presionar una hoja de papel sobre la plancha, se formaba una imagen.  El
-estampado y cortado se hacía completamente a mano.  Cualquier corrección era
-muy fastidiosa de realizar, si es que era posible hacerla siquiera, así que el grabado tenía que quedar
-perfecto a la primera.  El grabado era una habilidad altamente especializada; un artesano necesitaba
-unos cinco años de preparación antes de poder ostentar el título de
-maestro grabador, y se necesitaban otros cinco años de experiencia para
-ser un auténtico experto.
-
-Hoy en día, toda la música impresa nueva se produce con ordenadores.  Esto
-tiene unas ventajas evidentes: las copias son más baratas de producir y el trabajo editorial
-se puede repartir por correo electrónico.  Desgraciadamente la penetrante utilización de
-ordenadores también ha hecho disminuir la calidad gráfica de las partituras.
-Las impresiones de ordenador tienen un aspecto insulso y mecánico, lo que hace que sea desagradable tocar a partir de ellas.
+@unnumberedsubsec Engraving
+
+El arte de la tipografía musical se conoce como @emph{grabado (en
+plancha)}.  El término deriva del proceso tradicional de la impresión
+musical.  Hace sólo unas décadas, la música impresa se hacía
+estampando la música sobre planchas de zinc o estaño de forma
+invertida como en un espejo.  Después la plancha se entintaba y las
+depresiones causadas por los cortes y estampados retenían la tinta.
+Al presionar una hoja de papel sobre la plancha, se formaba una
+imagen.  El estampado y cortado se hacía completamente a mano.
+Cualquier corrección era muy fastidiosa de realizar, si es que era
+posible hacerla siquiera, así que el grabado tenía que quedar perfecto
+a la primera.  El grabado era una habilidad altamente especializada;
+un artesano necesitaba unos cinco años de preparación antes de poder
+ostentar el título de maestro grabador, y se necesitaban otros cinco
+años de experiencia para ser un auténtico experto.
+
+Hoy en día, toda la música impresa nueva se produce con ordenadores.
+Esto tiene unas ventajas evidentes: las copias son más baratas de
+producir y el trabajo editorial se puede repartir por correo
+electrónico.  Desgraciadamente la penetrante utilización de
+ordenadores también ha hecho disminuir la calidad gráfica de las
+partituras.  Las impresiones de ordenador tienen un aspecto insulso y
+mecánico, lo que hace que sea desagradable tocar a partir de ellas.
 
 @c introduce illustrating aspects of engraving, font...
 Las imágenes siguientes ilustran la diferencia entre el grabado
-tradicional y la salida típica de ordenador, y la tercera imagen muestra cómo
-LilyPond imita el aspecto tradicional.  La imagen de la izquierda presenta el dibujo escaneado
-de un símbolo de bemol sacado de una edición publicada en el año 2000.  La del centro
-es un símbolo procedente de una edición de B@"{a}renreiter grabada a mano de la
-misma música.  La de la izquierda ilustra los típicos puntos débiles de la impresión por
-ordenador: las líneas del pentagrama son muy delgadas, el peso del símbolo del bemol es también demasiado ligero
-como las líneas del pentagrama, y tiene una apariencia rectilínea con esquinas afiladas.  En
-contraste, el bemol de B@"{a}renreiter tiene una apariencia redonda, pesada, casi
-voluptuosa.  Nuestro símbolo del bemol se diseñó según éste, entre otros.
-Es de forma redondeada y su peso está en armonía con el grosor de
-nuestras líneas de pentagrama, que son asimismo mucho más gruesas que las de la
-edición por ordenador.
+tradicional y la salida típica de ordenador, y la tercera imagen
+muestra cómo LilyPond imita el aspecto tradicional.  La imagen de la
+izquierda presenta el dibujo escaneado de un símbolo de bemol sacado
+de una edición publicada en el año 2000.  La del centro es un símbolo
+procedente de una edición de B@"{a}renreiter grabada a mano de la
+misma música.  La de la izquierda ilustra los típicos puntos débiles
+de la impresión por ordenador: las líneas del pentagrama son muy
+delgadas, el peso del símbolo del bemol es también demasiado ligero
+como las líneas del pentagrama, y tiene una apariencia rectilínea con
+esquinas afiladas.  En contraste, el bemol de Bärenreiter tiene una
+apariencia redonda, pesada, casi voluptuosa.  Nuestro símbolo del
+bemol se diseñó según éste, entre otros.  Es de forma redondeada y su
+peso está en armonía con el grosor de nuestras líneas de pentagrama,
+que son asimismo mucho más gruesas que las de la edición por
+ordenador.
 
 @multitable @columnfractions .125 .25 .25 .25 .125
 @item @tab
@@ -108,11 +129,13 @@ Tipografía Feta de LilyPond (2003)
 @cindex equilibrio
 
 @c introduce illustrating aspects of engraving, spacing...
-Tratándose del espaciado, la distribución del espacio debe reflejar las duraciones
-que hay entre las notas.  Sin embargo muchas partituras modernas se atañen a las duraciones
-con precisión matemática, lo que lleva a unos resultados bastante pobres.  En el siguiente
-ejemplo se muestra un ejemplo dos veces: una utilizando espaciado matemáticamente
-exacto, y otra con ciertas correcciones.  ¿Puede adivinar cuál es cuál?
+Tratándose del espaciado, la distribución del espacio debe reflejar
+las duraciones que hay entre las notas.  Sin embargo muchas partituras
+modernas se atañen a las duraciones con precisión matemática, lo que
+lleva a unos resultados bastante pobres.  En el siguiente ejemplo se
+muestra un ejemplo dos veces: una utilizando espaciado matemáticamente
+exacto, y otra con ciertas correcciones.  ¿Puede adivinar cuál es
+cuál?
 
 @cindex espaciado óptico
 @c file spacing-optical.
@@ -173,107 +196,119 @@ music = {
 @cindex ritmos regulares
 @cindex espaciado regular
 
-Cada uno de los dos compases de este fragmento tiene solamente notas de duración constante.
-El espaciado debería reflejarlo.  Desgraciadamente el ojo
-nos engaña un poco; no solamente percibe la distancia entre las
-cabezas de las notas, sino que tiene también en cuenta la distancia entre
-las plicas.  Como resultado, las notas de una combinación plica arriba/@/plica abajo
-se tendrían que separar más, y las notas de una combinación
-plica abajo/@/plica arriba deberían juntarse, todo ello
-dependiendo de las posiciones combinadas de las notas.  Los dos
-compases de arriba están impresos con esta corrección y los de abajo
-sin ella, formando grupos de notas pegadas con plica abajo/@/plica arriba.
+Cada uno de los dos compases de este fragmento tiene solamente notas
+de duración constante.  El espaciado debería reflejarlo.
+Desgraciadamente el ojo nos engaña un poco; no solamente percibe la
+distancia entre las cabezas de las notas, sino que tiene también en
+cuenta la distancia entre las plicas.  Como resultado, las notas de
+una combinación plica arriba/@/plica abajo se tendrían que separar
+más, y las notas de una combinación plica abajo/@/plica arriba
+deberían juntarse, todo ello dependiendo de las posiciones combinadas
+de las notas.  Los dos compases de arriba están impresos con esta
+corrección y los de abajo sin ella, formando grupos de notas pegadas
+con plica abajo/@/plica arriba.
 
 @cindex tipografía
 
-Los músicos están normalmente más concentrados en tocar que en estudiar
-el aspecto de una partitura, y por ello las pequeñeces sobre los detalles
-tipográficos pueden parecer académicas.  Pero no lo son.  En las partituras más largas con
-ritmos monótonos, las correcciones de espaciado llevan a sutiles variaciones en
-la disposición de cada una de las líneas dándoles una especie de firma visual distintiva.
-Sin esta firma, todas las líneas parecerían iguales, y se convertirían en
+Los músicos están normalmente más concentrados en tocar que en
+estudiar el aspecto de una partitura, y por ello las pequeñeces sobre
+los detalles tipográficos pueden parecer académicas.  Pero no lo son.
+En las partituras más largas con ritmos monótonos, las correcciones de
+espaciado llevan a sutiles variaciones en la disposición de cada una
+de las líneas dándoles una especie de firma visual distintiva.  Sin
+esta firma, todas las líneas parecerían iguales, y se convertirían en
 un laberinto.  Si un músico aparta la mirada o tiene un lapsus de
 concentración, las líneas podrían perder su lugar sobre el papel.
 
-De forma similar, la fuerza visual de unos símbolos pesados sobre gruesas líneas de pentagrama
-se sostiene mejor cuando el lector se aleja del papel, por
-ejemplo cuando está sobre un atril.  Una distribución cuidadosa del espacio
-blanco permite disponer la música muy apretada sin que los símbolos se toquen unos a otros.
-El resultado reduce a un mínimo las vueltas de página, lo que es
-una gran ventaja.
-
-Ésta es una característica normal del arte tipográfico.  La disposición de la página tiene que ser
-bonita, no sólo por sí misma, sino sobre todo porque así ayuda al lector en su tarea.
-Para los materiales destinados a la interpretación, como las partituras, esto es
-de una importancia doble: los músicos tienen una capacidad de concentración limitada.
-Cuanta menos atención necesiten para el acto de leer, más se pueden dedicar
-al acto de tocar la música.  Dicho de otra forma: una mejor tipografía se traduce
-en una mejor interpretación.
-
-Estos ejemplos demuestran que la tipografía musical es un arte
-sutil y complejo, y que su elaboración requiere una experiencia considerable,
-que los músicos no suelen tener.  LilyPond representa nuestro
-esfuerzo para llevar la excelencia visual de la música grabada a mano
-a la era de la informática, y ponerla a disposición de los músicos normales.  Hemos
-ido afinando nuestros algoritmos, diseños de tipografía y preferencias del programa
-para producir una impresión cuya calidad se equipara con la de las viejas ediciones
-que tanto nos gusta contemplar y de las que tanto nos gusta tocar.
+De forma similar, la fuerza visual de unos símbolos pesados sobre
+gruesas líneas de pentagrama se sostiene mejor cuando el lector se
+aleja del papel, por ejemplo cuando está sobre un atril.  Una
+distribución cuidadosa del espacio blanco permite disponer la música
+muy apretada sin que los símbolos se toquen unos a otros.  El
+resultado reduce a un mínimo las vueltas de página, lo que es una gran
+ventaja.
+
+Ésta es una característica normal del arte tipográfico.  La
+disposición de la página tiene que ser bonita, no sólo por sí misma,
+sino sobre todo porque así ayuda al lector en su tarea.  Para los
+materiales destinados a la interpretación, como las partituras, esto
+es de una importancia doble: los músicos tienen una capacidad de
+concentración limitada.  Cuanta menos atención necesiten para el acto
+de leer, más se pueden dedicar al acto de tocar la música.  Dicho de
+otra forma: una mejor tipografía se traduce en una mejor
+interpretación.
+
+Estos ejemplos demuestran que la tipografía musical es un arte sutil y
+complejo, y que su elaboración requiere una experiencia considerable,
+que los músicos no suelen tener.  LilyPond representa nuestro esfuerzo
+para llevar la excelencia visual de la música grabada a mano a la era
+de la informática, y ponerla a disposición de los músicos normales.
+Hemos ido afinando nuestros algoritmos, diseños de tipografía y
+preferencias del programa para producir una impresión cuya calidad se
+equipara con la de las viejas ediciones que tanto nos gusta contemplar
+y de las que tanto nos gusta tocar.
 
 
 @node Automated engraving
-@section Automated engraving
-
-¿Cómo nos las arreglamos para implementar la tipografía? Si un artesano
-necesita más de diez años para convertirse en un auténtico maestro ¿cómo vamos
-a poder nosotros, simples «hackers», escribir
-un programa que les quite el trabajo?
-
-La respuesta es: ¡no podemos!  Puesto que la tipografía se fundamenta en el juicio humano
-sobre la apariencia, nunca se puede sustituir completamente a las personas.
-Sin embargo, se puede automatizar gran parte del trabajo más duro y repetitivo.
-Si LilyPond resuelve la mayoría de las situaciones comunes de forma correcta,
-esto ya será una tremenda mejoría sobre los programas existentes.
-El resto de los casos se podrán afinar a mano.  Con el transcurso
-de los años, el software se puede refinar para que haga un mayor número
-de cosas de forma automática, de tal forma que los ajustes manuales tienden a ser
+@unnumberedsubsec Automated engraving
+
+¿Cómo nos las arreglamos para implementar la tipografía? Si un
+artesano necesita más de diez años para convertirse en un auténtico
+maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un
+programa que les quite el trabajo?
+
+La respuesta es: no podemos.  Puesto que la tipografía se fundamenta
+en el juicio humano sobre la apariencia, nunca se puede sustituir
+completamente a las personas.  Sin embargo, se puede automatizar gran
+parte del trabajo más duro y repetitivo.  Si LilyPond resuelve la
+mayoría de las situaciones comunes de forma correcta, esto ya será una
+tremenda mejoría sobre los programas existentes.  El resto de los
+casos se podrán afinar a mano.  Con el transcurso de los años, el
+software se puede refinar para que haga un mayor número de cosas de
+forma automática, de tal forma que los ajustes manuales tienden a ser
 cada vez menos necesarios.
 
-Cuando empezamos, escribimos el programa LilyPond completamente en el lenguaje C++;
-la funcionalidad del programa quedaba como esculpida en piedra por los desarrolladores.
-Este esquema resultó no ser muy satisfactorio por una serie de motivos:
+Cuando empezamos, escribimos el programa LilyPond completamente en el
+lenguaje C++; la funcionalidad del programa quedaba como esculpida en
+piedra por los desarrolladores.  Este esquema resultó no ser muy
+satisfactorio por una serie de motivos:
 
 @itemize
 @item Cuando LilyPond comete fallos,
-los usuarios tienen la necesidad de superar las decisiones de formateo.  Por
-ello el usuario debe tener acceso
-al motor de formateo.  De aquí que no podamos dejar establecidas las reglas y valores
-durante la compilación, sino que los usuarios deben poder
-acceder a ellos durante la ejecución del programa.
+los usuarios tienen la necesidad de superar las decisiones de
+formateo.  Por ello el usuario debe tener acceso al motor de formateo.
+De aquí que no podamos dejar establecidas las reglas y valores durante
+la compilación, sino que los usuarios deben poder acceder a ellos
+durante la ejecución del programa.
 
 @item El grabado de música es cosa de juicio visual y por ello es cuestión de gustos.
-A pesar de saber tanto como creemos saber, los usuarios pueden no estar de acuerdo
-con nuestras decisiones personales. Por tanto la definición del estilo tipográfico
-también debe estar al alcance del usuario.
+A pesar de saber tanto como creemos saber, los usuarios pueden no
+estar de acuerdo con nuestras decisiones personales. Por tanto la
+definición del estilo tipográfico también debe estar al alcance del
+usuario.
 
 @item Por último, estamos continuamente refinando los algoritmos de formateo y por
-tanto necesitamos un enfoque flexible para las reglas.  El lenguaje C++ fuerza un
-cierto método para agrupar las reglas que no encaja bien con la manera de funcionar
-de la notación musical.
+tanto necesitamos un enfoque flexible para las reglas.  El lenguaje
+C++ fuerza un cierto método para agrupar las reglas que no encaja bien
+con la manera de funcionar de la notación musical.
 @end itemize
 
-Estos problemas se han solucionado integrando un intérprete del lenguaje
-Scheme y reescribiendo parte del código de LilyPond en Scheme.
-La actual arquitectura de formateo se construye alrededor del concepto de objetos
-gráficos, descrita por variables y funciones de Scheme.  Esta arquitectura puede
-tratar al mismo tiempo con las reglas de formateo, el estilo tipográfico
-y las decisiones de formateo individuales.  El usuario tiene acceso directo a la
-mayor parte de estos controles.
-
-Las variables de Scheme controlan las decisiones de formateo.  Por ejemplo, muchos
-objetos gráficos tienen una variable de dirección que codifica la elección entre
-arriba y abajo (o izquierda y derecha). Aquí puede ver dos acordes con acentos y
-signos de arpegio.  En el primer acorde los objetos gráficos tienen todas sus
-direcciones hacia abajo (o hacia la izquierda).  El segundo acorde tiene todas las direcciones hacia arriba (o hacia la derecha).
+Estos problemas se han solucionado integrando un intérprete del
+lenguaje Scheme y reescribiendo parte del código de LilyPond en
+Scheme.  La actual arquitectura de formateo se construye alrededor del
+concepto de objetos gráficos, descrita por variables y funciones de
+Scheme.  Esta arquitectura puede tratar al mismo tiempo con las reglas
+de formateo, el estilo tipográfico y las decisiones de formateo
+individuales.  El usuario tiene acceso directo a la mayor parte de
+estos controles.
+
+Las variables de Scheme controlan las decisiones de formateo.  Por
+ejemplo, muchos objetos gráficos tienen una variable de dirección que
+codifica la elección entre arriba y abajo (o izquierda y
+derecha). Aquí puede ver dos acordes con acentos y signos de arpegio.
+En el primer acorde los objetos gráficos tienen todas sus direcciones
+hacia abajo (o hacia la izquierda).  El segundo acorde tiene todas las
+direcciones hacia arriba (o hacia la derecha).
 
 @lilypond[quote,ragged-right]
 \new Score \with {
@@ -287,11 +322,12 @@ direcciones hacia abajo (o hacia la izquierda).  El segundo acorde tiene todas l
 @end lilypond
 
 @noindent
-El proceso de formatear una partitura consiste en leer y escribir las variables
-de los objetos gráficos.  Ciertas variables tienen un valor predefinido.  Por
-ejemplo, el grosor de muchas líneas (una característica del estilo tipográfico)
-son variables con un valor preestablecido.  Podemos alterar este valor libremente
-dando así a nuestra partitura una impresión tipográfica distinta.
+El proceso de formatear una partitura consiste en leer y escribir las
+variables de los objetos gráficos.  Ciertas variables tienen un valor
+predefinido.  Por ejemplo, el grosor de muchas líneas (una
+característica del estilo tipográfico) son variables con un valor
+preestablecido.  Podemos alterar este valor libremente dando así a
+nuestra partitura una impresión tipográfica distinta.
 
 @lilypond[quote,ragged-right]
 fragment = {
@@ -312,11 +348,12 @@ fragment = {
 >>
 @end lilypond
 
-Las reglas de formateo también son variables que están predefinidas: cada objeto tiene
-unas variables que contienen procedimientos.  Estos procedimientos realizan el trabajo
-real de formateo y sustituyéndolos por otros podemos alterar el aspecto de los objetos.
-En el siguiente ejemplo, la regla que define cómo se dibuja la cabeza de una nota
-se altera durante el transcurso del fragmento musical.
+Las reglas de formateo también son variables que están predefinidas:
+cada objeto tiene unas variables que contienen procedimientos.  Estos
+procedimientos realizan el trabajo real de formateo y sustituyéndolos
+por otros podemos alterar el aspecto de los objetos.  En el siguiente
+ejemplo, la regla que define cómo se dibuja la cabeza de una nota se
+altera durante el transcurso del fragmento musical.
 
 @lilypond[quote,ragged-right]
 #(set-global-staff-size 30)
@@ -360,35 +397,39 @@ se altera durante el transcurso del fragmento musical.
 
 
 @node What symbols to engrave?
-@section What symbols to engrave?
+@unnumberedsubsec What symbols to engrave?
 
 @cindex grabado
 @cindex tipografía
 
-El proceso de formateo toma las decisiones sobre dónde colocar los símbolos.
-Sin embargo esto sólo se puede hacer una vez que se ha decidido @emph{qué} símbolos
-han de imprimirse, o dicho de otro modo: qué notación utilizar.
-
-La notación musical común es un sistema de registro de música que ha venido
-evolucionando desde hace mil años.  La forma que se usa en nuestros días data de
-los primeros tiempos del Renacimiento.  Aunque la forma básica (es decir: puntos
-sobre una pauta de cinco líneas) no ha cambiado, los detalles continúan evolucionando 
-para expresar todas las innovaciones de la notación contemporánea.
-Por tanto abarca unos quinientos años de música.  Sus aplicaciones se extienden sobre un
-amplio rango que abarca desde melodías monofónicas hasta monstruosos contrapuntos
-para gran orquesta.
-
-¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a que se encierre
-dentro de los límites de un programa de ordenador?  Nuestra solución es trocear el
-problema de la notación (por oposición al grabado, esto es, a la tipografía) en
-fragmentos digeribles y más fáciles de programar: cada tipo de símbolo se maneja por un
-módulo separado que recibe el nombre de «plug-in».  Cada «plug-in» es completamente modular
-e independiente, de forma que puede desarrollarse y mejorarse por separado.  Estos
-«plug-ins» se llaman @code{engraver}s (grabadores), por analogía con los artesanos que
+El proceso de formateo toma las decisiones sobre dónde colocar los
+símbolos.  Sin embargo esto sólo se puede hacer una vez que se ha
+decidido @emph{qué} símbolos han de imprimirse, o dicho de otro modo:
+qué notación utilizar.
+
+La notación musical común es un sistema de registro de música que ha
+venido evolucionando desde hace mil años.  La forma que se usa en
+nuestros días data de los primeros tiempos del Renacimiento.  Aunque
+la forma básica (es decir: puntos sobre una pauta de cinco líneas) no
+ha cambiado, los detalles continúan evolucionando para expresar todas
+las innovaciones de la notación contemporánea.  Por tanto abarca unos
+quinientos años de música.  Sus aplicaciones se extienden sobre un
+amplio rango que abarca desde melodías monofónicas hasta monstruosos
+contrapuntos para gran orquesta.
+
+¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a
+que se encierre dentro de los límites de un programa de ordenador?
+Nuestra solución es trocear el problema de la notación (por oposición
+al grabado, esto es, a la tipografía) en fragmentos digeribles y más
+fáciles de programar: cada tipo de símbolo se maneja por un módulo
+separado que recibe el nombre de «plug-in».  Cada «plug-in» es
+completamente modular e independiente, de forma que puede
+desarrollarse y mejorarse por separado.  Estos «plug-ins» se llaman
+@code{engraver}s (grabadores), por analogía con los artesanos que
 traducen las ideas musicales a símbolos gráficos.
 
-En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las cabezas
-de las notas, el @code{Note_heads_engraver}.
+En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las
+cabezas de las notas, el @code{Note_heads_engraver}.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -420,8 +461,8 @@ de las notas, el @code{Note_heads_engraver}.
 @end lilypond
 
 @noindent
-A continuación un @code{Staff_symbol_engraver} (grabador del pentagrama) añade las
-líneas de la pauta.
+A continuación un @code{Staff_symbol_engraver} (grabador del
+pentagrama) añade la pauta.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -452,8 +493,8 @@ líneas de la pauta.
 @end lilypond
 
 @noindent
-El @code{Clef_engraver} (grabador de la clave) define un punto de referencia
-para la altura de las notas en el pentagrama.
+El @code{Clef_engraver} (grabador de la clave) define un punto de
+referencia para el pentagrama.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -510,19 +551,21 @@ y el @code{Stem_engraver} (grabador de las plicas) añade las plicas.
 @end lilypond
 
 @noindent
-El @code{Stem_engraver} (grabador de plicas) recibe una notificación cuando llega
-una cabeza. Cada vez que se ve una cabeza (o más, si es un acorde), se crea un objeto
-plica y se conecta a la cabeza.  Añadiendo grabadores para las barras, ligaduras,
-acentos, alteraciones, líneas divisorias, indicación de compás y armadura conseguimos
-una notación completa.
+El @code{Stem_engraver} (grabador de plicas) recibe una notificación
+cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es
+un acorde), se crea un objeto plica y se conecta a la cabeza.
+Añadiendo grabadores para las barras, ligaduras, acentos,
+alteraciones, líneas divisorias, indicación de compás y armadura
+conseguimos una notación completa.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
 \score { \topVoice }
 @end lilypond
 
-Este sistema funciona bien para la música monofónica, pero ¿y con la polifonía?  En
-notación polifónica muchas voces pueden compartir el mismo pentagrama.
+Este sistema funciona bien para la música monofónica, pero ¿y con la
+polifonía?  En notación polifónica muchas voces pueden compartir el
+mismo pentagrama.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -542,7 +585,8 @@ es el contexto de notación de más alto nivel.
 
 @seealso
 
-Referencia de funcionamiento interno: @rinternals{Contexts}.
+Referencia de funcionamiento interno:
+@rinternals{Contexts}.
 
 @lilypond[quote,ragged-right]
 \include "engraver-example.ily"
@@ -555,7 +599,7 @@ Referencia de funcionamiento interno: @rinternals{Contexts}.
 @end lilypond
 
 @node Music representation
-@section Music representation
+@unnumberedsubsec Music representation
 
 Idealmente el formato de entrada para cualquier sistema de formateo de
 alto nivel es una descripción abstracta del contenido.  En este caso,
@@ -569,17 +613,23 @@ habremos quedado con el contenido musical propiamente dicho.  Nuestro
 programa sirve como definición formal de un documento musical.
 
 
-La sintaxis también es el interfaz de usuario de LilyPond, así que es fácil teclear
+La sintaxis también es el interfaz de usuario de LilyPond, así que es
+fácil teclear
 
 @example
-c'4 d'8
+@{
+  c'4 d'8
+@}
 @end example
 
 @noindent
-un Do1 (Do central) negra, y un Re1 (el Re por encima del Do central) corchea.
+un Do1 (Do central) negra, y un Re1 (el Re por encima del Do central)
+corchea.
 
-@lilypond[quote,fragment]
-c'4 d'8
+@lilypond[quote]
+{
+  c'4 d'8
+}
 @end lilypond
 
 A una escala microscópica, dicha sintaxis es fácil de utilizar.  A una
@@ -595,11 +645,14 @@ c4
 @end lilypond
 
 @noindent
-Los acordes se pueden construir encerrando las notas entre @code{<<} y @code{>>}
+Los acordes se pueden construir encerrando las notas entre @code{<<} y
+@code{>>}
 
 @c < > is not a music expression,
 @c so we use <<>> iso. <> to drive home the point of
 @c expressions.  Don't change this back --hwn.
+
+@c FIXME: change this.  I can explain it better.  -gp
 @example
 <<c4 d4 e4>>
 @end example
@@ -633,10 +686,11 @@ de nuevo con otra expresión simultánea (una blanca) usando <<,
 \new Voice { << g2 \\ { f4 <<c d e>> } >> }
 @end lilypond
 
-Las mencionadas estructuras recursivas se pueden especificar de forma nítida y formal dentro de una
-gramática independiente del contexto.  El código de análisis también se genera a partir de esta
-gramática.  En otras palabras, la sintaxis de LilyPond está definida
-de una forma clara y sin ambigüedades.
+Las mencionadas estructuras recursivas se pueden especificar de forma
+nítida y formal dentro de una gramática independiente del contexto.
+El código de análisis también se genera a partir de esta gramática.
+En otras palabras, la sintaxis de LilyPond está definida de una forma
+clara y sin ambigüedades.
 
 Los interfaces de usuario y la sintaxis son lo que la persona ve y con
 lo que trata principalmente.  En parte, son fruto de preferencias
@@ -652,19 +706,20 @@ fuente.
 
 
 @node Example applications
-@section Example applications
+@unnumberedsubsec Example applications
 
-Escribimos LilyPond como un experimento de cómo condensar el arte
-del grabado de música dentro de un programa de ordenador.  Gracias a todo este duro
-trabajo, el programa ahora se puede usar para hacer trabajos útiles.  La
-aplicación más sencilla es imprimir notas.
+Escribimos LilyPond como un experimento de cómo condensar el arte del
+grabado de música dentro de un programa de ordenador.  Gracias a todo
+este duro trabajo, el programa ahora se puede usar para hacer trabajos
+útiles.  La aplicación más sencilla es imprimir notas.
 
 @lilypond[quote,relative=1,fragment]
 \time 2/4 c4 c g'4 g a4 a g2
 @end lilypond
 
 @noindent
-Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de acordes (lead sheet).
+Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía
+de acordes (lead sheet).
 
 @lilypond[quote,ragged-right]
 <<
@@ -674,37 +729,56 @@ Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de acorde
 >>
 @end lilypond
 
-También se pueden imprimir notación polifónica y música para piano.  El ejemplo
-siguiente combina algunas otras construcciones exóticas.
+También se pueden imprimir notación polifónica y música para piano.
+El ejemplo siguiente combina algunas otras construcciones exóticas.
 
 @lilypondfile[quote,ragged-right]{screech-boink.ly}
 
 Todos los fragmentos mostrados se han escrito a mano, pero esto no es
-necesariamente así.  Puesto que el motor de formateo es casi completamente automático,
-puede servir como medio de salida para otros programas que manipulan
-música.  Por ejemplo, se puede usar también para convertir bases de datos de
-fragmentos musicales en imágenes con destino a páginas web y presentaciones
-multimedia.
+necesariamente así.  Puesto que el motor de formateo es casi
+completamente automático, puede servir como medio de salida para otros
+programas que manipulan música.  Por ejemplo, se puede usar también
+para convertir bases de datos de fragmentos musicales en imágenes con
+destino a páginas web y presentaciones multimedia.
 
-Este manual también es un ejemplo de aplicación: el formato de entrada es texto sencillo, y por ello
-se puede empotrar fácilmente dentro de otros formatos basados en texto, como
-@LaTeX{}, HTML, o en el caso concreto de este manual, Texinfo.  A través de un
-programa especial, los fragmentos de entrada se pueden sustituir por imágenes musicales
-dentro de los archivos de salida PDF o HTML resultantes.  Esto convierte la tarea de 
-mezclar música y texto dentro de los documentos, en algo muy sencillo.
+Este manual también es un ejemplo de aplicación: el formato de entrada
+es texto sencillo, y por ello se puede empotrar fácilmente dentro de
+otros formatos basados en texto, como @LaTeX{}, HTML, o en el caso
+concreto de este manual, Texinfo.  A través de un programa especial,
+los fragmentos de entrada se pueden sustituir por imágenes musicales
+dentro de los archivos de salida PDF o HTML resultantes.  Esto
+convierte la tarea de mezclar música y texto dentro de los documentos,
+en algo muy sencillo.
 
 
 
 @node About the documentation
 @section About the documentation
 
+Esta sección explica la distintas partes de la documentación.
+
+
+@c leave these lines wrapping around.  It's some texinfo 4.12 thing. -gp
+@menu
+* About the Learning Manual (LM)::  este manual es una introducción a LilyPond que porporciona explicaciones en profundidad sobre cómo crear notación.
+
+* About the Music Glossary (MG)::  este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
+
+* About the Notation Reference (NR)::  este manual es la porción más importante de la documentación.  Proporciona información detallada sobre la creación de notación.  Este libro da por supuesto que el lector ya conoce el material básico cubierto en el MA y que está familiarizado con los términos musicales ingleses presentados en el GM.
 
-Hay cuatro manuales de LilyPond: el @emph{Manual de aprendizaje}, la
-@emph{Referencia de la notación}, el manual de @emph{Utilización del
-programa} y la @emph{Referencia de funcionamiento interno}.
+* About the Application Usage (AU)::  trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
+
+* About the Snippet List (SL)::  es una colección de ejemplos breves de LilyPond.
+
+* About the Internals Reference (IR)::  este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
+
+* Other documentation::         existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
+
+@end menu
 
 
-@subheading Learning Manual (LM)
+@node About the Learning Manual (LM)
+@unnumberedsubsec About the Learning Manual (LM)
 
 Este libro explica cómo empezar a aprender LilyPond, así como algunos
 conceptos clave en términos sencillos.  Se recomienda leer estos
@@ -713,127 +787,143 @@ capítulos de forma secuencial.
 @itemize
 
 @item
-@ifhtml
-El
-@end ifhtml
-@emph{@ref{Tutorial}}
+@ref{Introduction}:
+explica los antecedentes y las metas generales de LilyPond.
+
+@item
+@ref{Tutorial}:
 da una amable introducción a la tipografía musical.  Los usuarios que
 se acercan por primera vez deben comenzar por aquí.
 
 @item
-@emph{@ref{Fundamental concepts}} explica algunos conceptos generales
-sobre el formato de los archivos de entrada de LilyPond.  Si no está
-seguro de dónde colocar una instrucción ¡lea este capítulo!
+@ref{Fundamental concepts}:
+explica algunos conceptos generales sobre el formato de los archivos
+de entrada de LilyPond.  Si no está seguro de dónde colocar una
+instrucción ¡lea este capítulo!
 
 @item
-@emph{@ref{Working on LilyPond projects}}
+@ref{Tweaking output}:
+muestra la manera de cambiar el grabado predeterminado que produce
+LilyPond.
+
+@item
+@ref{Working on LilyPond projects}:
 trata los usos prácticos de LilyPond y cómo evitar ciertos problemas
-bastante comunes.
+bastante comunes.  ¡Léalo antes de emprender proyectos grandes!
+
+
+@end itemize
+
+El MA contiene también apéndices que no forman parte de la lectura
+lineal recomendada.  Pueden ser útiles para una mirada posterior:
+
+@itemize
 
 @item
-@emph{@ref{Tweaking output}}
-muestra la manera de cambiar el grabado predeterminado que produce
-LilyPond.
+@ref{Templates}: muestra plantillas de piezas de LilyPond, listas para
+usar.  Tan sólo tiene que cortar y pegar una plantilla en uin archivo,
+excribir las notas, y ¡habrá terminado!
+
+@item
+@ref{Scheme tutorial}: presenta una breve introducción a Scheme, el
+lenguaje de programación que usan las funciones musicales.  Se trata
+de material para trucos avanzados; muchos usuarios jamás llegan
+siquiera a tocar el Scheme.
 
 @end itemize
 
 
-@subheading Notation Reference (NR)
+@node About the Music Glossary (MG)
+@unnumberedsubsec About the Music Glossary (MG)
+
+@cindex frase idiomática
+@cindex jerga
+@cindex terminología
+@cindex idomas extranjeros
+@cindex idiomas
+
+@ref{Top,Music glossary,,music-glossary}: explica términos musicales e
+incluye traducciones a varios idiomas.  Si no está familiarizado con
+la notación o la terminología musicales (especialmente si no es un
+anglófono nativo), es muy recomendable que consulte el glosario.
+
+
+@node About the Notation Reference (NR)
+@unnumberedsubsec About the Notation Reference (NR)
 
 Este libro explica todas las instrucciones de LilyPond que producen
 notación impresa.  Da por supuesto que el lector está familiarizado
 con los conceptos del manual de aprendizaje.
 
-@c  we need to completely rewrite this after GDP.  -gp
-@ignore
-@itemize @bullet
-
-@item
-@emph{@r ef{Basic notation}}
-trata ciertos temas agrupados según las construcciones de notación.  Esta sección proporciona
-detalles sobre notación básica que probablemente serán de utilidad en casi cualquier
-proyecto de notación.
-
-@item
-@emph{@r ef{Instrument-specific notation}}
-también trata los temas agrupados por construcciones de notación.  Esta sección proporciona
-detalles sobre notación especial que solamente será útil para ciertos
-grupos de instrumentos (o voces).
+@itemize
 
 @item
-@emph{@r ef{Advanced notation}}
-trata temas agrupados por construcciones de notación.  Esta sección proporciona
-detalles acerca de cierta notación complicada o poco usual.
+@ruser{Musical notation}:
+trata ciertos temas agrupados según las construcciones de notación.
+Esta sección proporciona detalles sobre notación básica que
+probablemente serán de utilidad en casi cualquier proyecto de
+notación.
 
 @item
-@emph{@r ef{Changing defaults}}
-explica cómo hacer un ajuste fino de la presentación.
+@ruser{Specialist notation}:
+también trata los temas agrupados por construcciones de notación.
+Esta sección proporciona detalles sobre notación especial que
+solamente será útil para ciertos grupos de instrumentos (o voces).
 
 @item
-@emph{@r ef{Non-musical notation}}
-trata la salida no musical como los títulos, piezas de varios movimientos,
-y sobre cómo elegir los instrumentos MIDI.
+@ruser{Input syntax}:
+trata de información general sobre los archivos de LilyPond y el
+control sobre la salida.
 
 @item
-@emph{@r ef{Spacing issues}}
+@ruser{Spacing issues}:
 trata asuntos que afectan a la salida global, como la elección del
 tamaño del papel o la especificación de los saltos de página.
 
 @item
-@emph{@r ef{Interfaces for programmers}}
-explica cómo crear funciones musicales.
-
-@end itemize
+@ruser{Changing defaults}:
+explica cómo hacer los ajustes que permitan a LilyPond producir
+exactamente la notación que desee.
 
+@item
+@ruser{Interfaces for programmers}:
+explica cómo crear funciones musicales con Scheme.
 
+@end itemize
 
-@subsubheading Appendices
+El manual de RN también contiene unos apéndices con útiles tablas de
+referencia.
 
-Este libro contiene unos útiles cuadros de referencia.
 
 @itemize
-@item
-@ifhtml
-La
-@end ifhtml
-@emph{@r ef{Literature list}}
-contiene un conjunto de libros de referencia muy útiles para aquellas personas que desean saber
-más sobre notación y grabado.
 
 @item
-El
-@emph{@r ef{Scheme tutorial}}
-presenta una breve introducción a Scheme, el lenguaje de programación
-que utilizan las funciones musicales.
+@ruser{Literature list}:
+contiene un conjunto de libros de referencia muy útiles para aquellas
+personas que desean saber más sobre notación y grabado.
 
 @item
-@emph{@r ef{Notation manual tables}}
-son un conjunto de tablas que relacionan los nombres de los acordes, instrumentos MIDI,
-nombres de los colores y la tipografía Feta.
+@ruser{Notation manual tables}:
+son un conjunto de tablas que relacionan los nombres de los acordes,
+instrumentos MIDI, nombres de los colores y la tipografía Feta.
 
 @item
-@emph{@r ef{Templates}}
-de piezas de LilyPond.  Sólo tiene que cortar y pegar una
-plantilla en un archivo de texto, escribir las notas y ¡ya está!
+@ruser{Cheat sheet}:
+es una manejable referencia de las instrucciones de LilyPond más
+comunes.
 
 @item
-La
-@emph{@r ef{Cheat sheet}}
-es una referencia manejable de las instrucciones de LilyPond más comunes.
+@ruser{LilyPond command index}:
+un úndice de todas las @code{\instrucciones} de LilyPond.
 
 @item
-El
-@emph{@r ef{LilyPond command index}}
-es un índice de todos los @code{\commands} de LilyPond.
-
-@item
-El
-@emph{@r ef{LilyPond index}}
-es un índice completo.
+@ruser{LilyPond index}:
+un índice completo.
 
 @end itemize
 
-@subheading Program usage
+@node About the Application Usage (AU)
+@unnumberedsubsec About the Application Usage (AU)
 
 Este libro explica la manera de ejecutar el programa y cómo integrar
 la notación de LilyPond con otros programas.
@@ -841,104 +931,100 @@ la notación de LilyPond con otros programas.
 @itemize
 
 @item
-@emph{@rprogram{Install}}
-explica cómo instalar LilyPond (incluyendo la compilación, si se desea).
+@rprogram{Install}:
+explica cómo instalar LilyPond (incluyendo la compilación, si se
+desea).
 
 @item
-@emph{@rprogram{Setup}}
-describe cómo debe configurar el sistema para una utilización óptima de LilyPond,
-como por ejemplo el uso de entornos especiales para determinados editores de texto.
+@rprogram{Setup}:
+describe cómo debe configurar el sistema para una utilización óptima
+de LilyPond, como por ejemplo el uso de entornos especiales para
+determinados editores de texto.
 
 @item
-@emph{@rprogram{Running LilyPond}}
+@rprogram{Running LilyPond}:
 trata sobre cómo ejecutar LilyPond y sus programas de apoyo.  Además,
-esta sección explica cómo actualizar las partituras a partir de versiones anteriores
-de LilyPond.
+esta sección explica cómo actualizar las partituras a partir de
+versiones anteriores de LilyPond.
 
 @item
-@emph{@rprogram{LilyPond-book}}
-da los detalles que se encuentran detrás de la creación de
-documentos con ejemplos de música insertados, como este mismo manual.
+@rprogram{LilyPond-book}:
+da los detalles que se encuentran detrás de la creación de documentos
+con ejemplos de música insertados, como este mismo manual.
 
 @item
-@emph{@rprogram{Converting from other formats}}
-explica cómo ejecutar los programas de conversión.  Estos programas vienen incluidos
-en el mismo paquete que el propio LilyPond, y convierten una amplia variedad de formatos de
-música al formato @code{.ly}.
+@rprogram{Converting from other formats}:
+explica cómo ejecutar los programas de conversión.  Estos programas
+vienen incluidos en el mismo paquete que el propio LilyPond, y
+convierten una amplia variedad de formatos de música al formato
+@code{.ly}.
 
 @end itemize
-@end ignore
 
+@node About the Snippet List (SL)
+@unnumberedsubsec About the Snippet List (SL)
 
-@subsubheading Other information
+@cindex snippets (fragmentos de código)
+@cindex LSR
 
-Existen otras fuentes de información que pueden resultar muy útiles.
+@c FIXME: check on kainhofer.
+@ref{Top,LilyPond Snippet List,,lilypond-snippets}:
+presenta un conjunto seleccionado de pfragmentos de código de LilyPond
+procedentes del @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de
+Fragmentos de Código} (LSR).  Se encuentra en el dominio público.
 
-@itemize
-@cindex frase idiomática
-@cindex jerga
-@cindex terminología
-@cindex idiomas extranjeros
-@cindex idioma
-@item
-@ifnottex
-El @ref{Top,Glosario de música,,music-glossary} explica los términos musicales e
-incluye traducciones a varios idiomas.  También se encuentra disponible en
-PDF.
-@end ifnottex
-@iftex
-El glosario explica los términos musicales, e incluye traducciones
-a varios idiomas.  Es un documento aparte, disponible en HTML
-y en PDF.
-@end iftex
-Si no está familiarizado con la notación o la terminología musicales
-(sobre todo si no es un anglófono nativo), le recomendamos que
-consulte el glosario.
+Observe que este documento no es un subconjunto exacto de LSR.  El LSR
+ejecuta una versión estable de LilyPond, por lo que cualquier
+fragmento de código que muestre posibilidades nuevas de una versión de
+desarrollo se tiene que añadir por separado.  Éstas se almacenan en
+@file{input/new/} dentro del árbol del código fuente de LilyPond.
 
-@cindex snippets (fragmentos de código)
-@cindex LSR
-@item
-Los
-@ifhtml
-@uref{source/input/lsr/collated-files.html,fragmentos de código (snippets)}
-@end ifhtml
-@ifnothtml
-fragmentos de código (snippets)
-@end ifnothtml
-son una enorme colección de pequeños ejemplos que ejemplifican toda clase de consejos, trucos
-y funcionalidades especiales de LilyPond.  La mayor parte de estos fragmentos de código también se pueden
-encontrar en el @uref{http://lsr.dsi.unimi.it/,Archivo de fragmentos de código (snippets)
-de LilyPond}.  Este sitio web también dispone de un manual de LilyPond en el que se pueden realizar búsquedas.
+La lista de fragmentos de código para cada una de las subsecciones del
+Manual de Referencia de la Notación (RN) también se encuentran
+enlazados desde la parte @strong{Véase también}.
 
 
+@node About the Internals Reference (IR)
+@unnumberedsubsec About the Internals Reference (IR)
+
+@c zzz
+
+@itemize
 @item
 La
 @iftex
-Referencia de funcionamiento interno
+Referencia de Funcionamiento Interno
 @end iftex
 @ifnottex
-@ref{Top,Referencia de funcionamiento interno,,lilypond-internals}
+@ref{Top,Internals Reference,,lilypond-internals}
 @end ifnottex
-es un conjunto de páginas HTML con una tupida red de enlaces cruzados, que documentan al detalle el
-meollo de todas y cada una de las clases, objetos y funciones de LilyPond.
-Se produce directamente a partir de las definiciones de formateo que se utilizan.
-
-Casi toda la funcionalidad de formateo que se emplea internamente, se encuentra
-disponible para el usuario de forma directa.  Por ejemplo, todas las variables que controlan
-los valores de grosor, distancias, etc., se pueden cambiar dentro de los archivos de entrada.
-Hay un enorme número de opciones de formateo, y todas ellas
-se describen en este documento.  Cada sección del manual de notación
-tiene una subsección @b{Véase también}, que hace referencia a la documentación
-generada.  En el documento HTML, estas subsecciones llevan enlaces que se pueden pulsar.
+es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
+que documentan al detalle el meollo de todas y cada una de las clases,
+objetos y funciones de LilyPond.  Se produce directamente a partir de
+las definiciones de formateo que se utilizan.
+
+Casi toda la funcionalidad de formateo que se emplea internamente, se
+encuentra disponible para el usuario de forma directa.  Por ejemplo,
+todas las variables que controlan los valores de grosor, distancias,
+etc., se pueden cambiar dentro de los archivos de entrada.  Hay un
+enorme número de opciones de formateo, y todas ellas se describen en
+este documento.  Cada sección del manual de notación tiene una
+subsección @b{Véase también}, que hace referencia a la documentación
+generada.  En el documento HTML, estas subsecciones llevan enlaces que
+se pueden seguir, pulsando sobre ellos.
 
 @end itemize
 
+@node Other documentation
+@unnumberedsubsec Other documentation
 
-Cuando ya sea un usuario con experiencia podrá usar el manual como referencia:
-hay un índice muy completo@footnote{Si está buscando algo
-y no lo encuentra en el manual, eso se considera un bug (fallo).
-En este caso le rogamos que envíe un informe de fallo.}, pero el documento también está
-disponible en
+Existen algunos otros lugares que pueden resultar muy valiosos.
+
+Cuando ya sea un usuario con experiencia podrá usar el manual como
+referencia: hay un índice muy completo@footnote{Si está buscando algo
+y no lo encuentra en el manual, eso se considera un @emph{bug}
+(fallo).  En este caso le rogamos que envíe un informe de fallo.},
+pero el documento también está disponible en
 @iftex
 una sola página HTML,
 @end iftex
@@ -953,17 +1039,20 @@ En todos los documentos HTML que tienen fragmentos de música
 incrustados, la entrada de LilyPond que se utilizó para producir dicha
 imagen se puede ver pulsando con el ratón sobre la imagen.
 
-La localización exacta de los archivos de documentación que hemos mencionado puede
-variar de un sistema a otro.  En ocasiones este manual hace referencia a
-archivos de inicialización y de ejemplo.  A lo largo del manual, nos referimos a
-archivos de entrada por su ruta relativa respecto de directorio de nivel más alto de los archivos de código fuente.  Por
-ejemplo, @file{input/@/lsr/@/dirname/@/bla@/.ly} puede referirse al archivo
-@file{lilypond@/2.x.y/@/input/@/lsr/@/dirname/@/bla@/.ly}.  En los paquetes binarios para
-la plataforma Unix, normalmente la documentación y los ejemplos se encuentran
-en algún lugar dentro de
-@file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización, como por
-ejemplo @file{scm/@/lily@/.scm}, o @file{ly/@/engraver@/-init@/.ly},
-se encuentran normalmente en el directorio @file{/usr/@/share/@/lilypond/}.
+La localización exacta de los archivos de documentación que hemos
+mencionado puede variar de un sistema a otro.  En ocasiones este
+manual hace referencia a archivos de inicialización y de ejemplo.  A
+lo largo del manual, nos referimos a archivos de entrada por su ruta
+relativa respecto de directorio de nivel más alto de los archivos de
+código fuente.  Por ejemplo, @file{input/@/lsr/@/carpeta/@/bla@/.ly}
+puede referirse al archivo
+@file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}.  En los
+paquetes binarios para la plataforma Unix, normalmente la
+documentación y los ejemplos se encuentran en algún lugar dentro de
+@file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
+como por ejemplo @file{scm/@/lily@/.scm}, o
+@file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
+directorio @file{/usr/@/share/@/lilypond/}.
 
 @cindex ajustar la salida
 @cindex variables
@@ -974,8 +1063,7 @@ se encuentran normalmente en el directorio @file{/usr/@/share/@/lilypond/}.
 @cindex extender lilypond
 @cindex índice
 
-Por último, este y el resto de los manuales están disponibles en línea tanto como archivos
-PDF como HTML en el sitio web, que encontrará en
-@uref{http://@/www@/.lilypond@/.org/}.
-
+Por último, este y el resto de los manuales están disponibles en línea
+tanto como archivos PDF como en HTML en el sitio web, que encontrará
+en @uref{http://@/www@/.lilypond@/.org/}.
 
index 62486cb4820d832e6fcd7586e93d107ed5bcb5f3..d68b9c1bc6e7279ff473b9d8fa68dcea95d09af9 100644 (file)
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: f5faa0ee5b0bcad6a22d4e7f7267b0f542b8a7a5
+    Translation of GIT committish: 855e78dbe64b0a48a03cea88cde16c15d1af85b0
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -8,6 +8,8 @@
 
 @c \version "2.11.51"
 
+@c Translation status: post-GDP
+
 @node Simultaneous notes
 @section Simultaneous notes
 
@@ -29,7 +31,6 @@ Esta sección trata de la notas simultáneas dentro de la misma voz.
 
 @menu
 * Chorded notes::
-* Parallel notes::
 * Clusters::
 @end menu
 
@@ -67,33 +68,6 @@ Referencia de la notación:
 Fragmentos de código:
 @rlsr{Simultaneous notes}.
 
-@node Parallel notes
-@unnumberedsubsubsec Parallel notes
-
-Se pueden combinar pasajes musicales en un solo contexto de voz,
-formando así acordes si los dos pasajes tienen las mismas nuraciones
-en todas las notas.  Para conseguirlo, enciérrelos dentro de una
-construcción de música simultánea:
-
-@lilypond[quote,relative=2,verbatim]
-\new Voice <<
-  { e4 f8 d e16 f g8 d4 }
-  { c4 d8 b c16 d e8 b4 }
->>
-@end lilypond
-
-@seealso
-
-Manual de aprendizaje:
-@rlearning{Voices contain music}.
-
-Fragmentos de código:
-@rlsr{Simultaneous notes}.
-
-@knownissues
-
-Este método produce barras extrañas y advertencias si las notas de los
-dos pasajes no tienen las mismas duraciones.
 
 @node Clusters
 @unnumberedsubsubsec Clusters
@@ -139,15 +113,161 @@ separación entre ellos.
 @node Multiple voices
 @subsection Multiple voices
 
-Esta sección trata las notas simultáneas en varias voces o varios pentagramas.
+Esta sección trata las notas simultáneas en varias voces o varios
+pentagramas.
 
 @menu
-* Collision resolution::
+* Single-staff polyphony::
 * Voice styles::
+* Collision resolution::
 * Automatic part combining::
 * Writing music in parallel::
 @end menu
 
+@node Single-staff polyphony
+@unnumberedsubsubsec Single-staff polyphony
+
+Para tipografiar fragmentos de música que discurre en paralelo y con
+las mismas duraciones, se pueden combinar en un solo contexto de voz,
+formando así acordes.  Para conseguirlo, incorpórelas dentro de una
+construcción de música simultánea:
+
+@lilypond[quote,relative=2,verbatim]
+\new Voice <<
+  { e4 f8 d e16 f g8 d4 }
+  { c4 d8 b c16 d e8 b4 }
+>>
+@end lilypond
+
+Este método conduce a barrados extraños y advertencias si los
+fragmentos de música no tienen las mismas duraciones exactas.  Para
+componer tipográficamente varias voces verdaderamente independientes
+dentro de un único pentagrama se utiliza la construcción
+@code{<<@{...@} \\ @{...@}>>}, en que las dos (o más) voces se
+encuentran separadas por dobles barras invertidas.
+
+@lilypond[quote,relative=3,verbatim]
+<<
+  { r8 r16 g e8. f16 g8[ c,] f e16 d }
+  \\
+  { d16 c d8~ d16 b c8~ c16 b c8~ c16 b8. }
+>>
+@end lilypond
+
+Las plicas de las voces primera y tercera se dirigen hacia arriba, y
+las de las voces segunda y cuarta se dirigen hacia abajo; las cabezas
+de las notas en las voces tercera y cuarta se desplazan
+horizontalmente, y los silencios se mueven de manera que eviten las
+colisiones.  En el ejemplo siguiente, la voz intermedia tiene las
+plicas hacia arriba, por lo que la introducimos en tercer lugar, de
+forma que se convierte en la voz número tres que tiene las plicas
+hacia arriba tal y como era nuestro propósito.
+
+@lilypond[quote,relative=3,verbatim]
+<<
+  { r8 g g  g g f16 es f8 d }
+  \\
+  { es,8 r es r d r d r }
+  \\
+  { d'8 s c s bes s a s }
+>>
+@end lilypond
+
+A menudo se utilizan silencios espaciadores para evitar la aparición
+de un número excesivo de silencios, como se ha podido ver en el
+ejemplo anterior.
+
+El método que acabamos de presentar crea dos voces nuevas cuando se
+encuentra la construcción @code{<<@{...@} \\ @{...@}>>} en el código
+de entrada; para añadir de forma temporal una sola voz adicional a una
+voz ya existente, es necesario instanciar dicha voz de forma
+explícita.  Para este propósito, se pueden utilizar las instrucciones
+desde @code{\voiceOne} (voz uno) hasta @code{\voiceFour} (voz cuatro)
+y @code{\oneVoice} (una voz única):
+
+@example
+<< @{ \voiceOne ... @} \new Voice @{ \voiceTwo ... @} >> \oneVoice
+@end example
+
+Esta construcción es más apropiada para mantener en todo momento el
+control de las voces, por ejemplo para facilitar una asignación
+coherente de la letra al contexto de voz adecuado.
+
+@predefined
+
+@funindex \voiceOne
+@code{\voiceOne},
+@funindex \voiceTwo
+@code{\voiceTwo},
+@funindex \voiceThree
+@code{\voiceThree},
+@funindex \voiceFour
+@code{\voiceFour},
+@funindex \oneVoice
+@code{\oneVoice}.
+
+@seealso
+
+Manual de aprendizaje:
+@rlearning{Voices contain music},
+@rlearning{Explicitly instantiating voices}.
+
+Referencia de la notación:
+@ref{Percussion staves}.
+
+Fragmentos de código:
+@rlsr{Simultaneous notes}.
+
+@node Voice styles
+@unnumberedsubsubsec Voice styles
+
+@cindex voice styles
+@cindex styles, voice
+@cindex coloring voices
+
+Se pueden aplicar colores y formas distintos a las voces para permitir
+identificarlas fácilmente:
+
+@lilypond[quote,relative=2,verbatim]
+<<
+  { \voiceOneStyle d4 c2 b4 }
+  \\
+  { \voiceTwoStyle e,2 e }
+  \\
+  { \voiceThreeStyle b2. c4 }
+  \\
+  { \voiceFourStyle g'2 g }
+>>
+@end lilypond
+
+Para recuperar la presentación normal se utiliza la instrucción
+@code{\voiceNeutralstyle}.
+
+@predefined
+
+@funindex \voiceOneStyle
+@code{\voiceOneStyle},
+@funindex \voiceTwoStyle
+@code{\voiceTwoStyle},
+@funindex \voiceThreeStyle
+@code{\voiceThreeStyle},
+@funindex \voiceFourStyle
+@code{\voiceFourStyle},
+@funindex \voiceNeutralStyle
+@code{\voiceNeutralStyle}.
+
+@seealso
+
+
+Manual de aprendizaje:
+@rlearning{I'm hearing Voices},
+@rlearning{Other sources of information}.
+
+Fragmentos de código:
+@rlsr{Simultaneous notes}.
+
+
+
 @node Collision resolution
 @unnumberedsubsubsec Collision resolution
 
@@ -279,16 +399,6 @@ Sólo se combinan las notas si tienen la plica en direcciones opuestas
 @funindex \mergeDifferentlyHeadedOff
 @code{\mergeDifferentlyHeadedOff}.
 
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
 
 @funindex \shiftOn
 @code{\shiftOn},
@@ -337,59 +447,10 @@ la blanca.
 No está claro en qué circunstancias se pueden combinar cabezas de nota
 distintas que tienen también distinto puntillo.
 
-No están contemplados los racimos (clusters) donde la misma nota se
-presenta con diferentes alteraciones accidentales dentro del mismo
-acorde.  En este caso se recomienda usar la transcripción enarmónica,
-o usar la notación especial de racimos (véase @ref{Clusters}).
-
-@node Voice styles
-@unnumberedsubsubsec Voice styles
-
-@cindex voice styles
-@cindex styles, voice
-@cindex coloring voices
-
-Se pueden aplicar colores y formas distintos a las voces para permitir
-identificarlas fácilmente:
-
-@lilypond[quote,relative=2,verbatim]
-<<
-  {
-    a1
-    \voiceOneStyle
-    f2 g
-    \voiceNeutralStyle
-    a1
-  } \\ {
-    f1
-    \voiceTwoStyle
-    f4 f2 e4
-    \voiceNeutralStyle
-    f1
-  }
->>
-@end lilypond
-
-@predefined
-
-@funindex \voiceOneStyle
-@code{\voiceOneStyle},
-@funindex \voiceTwoStyle
-@code{\voiceTwoStyle},
-@funindex \voiceThreeStyle
-@code{\voiceThreeStyle},
-@funindex \voiceFourStyle
-@code{\voiceFourStyle},
-@funindex \voiceNeutralStyle
-@code{\voiceNeutralStyle}.
-
-@seealso
-
-Manual de aprendizaje:
-@rlearning{I'm hearing Voices}.
-
-Fragmentos de código:
-@rlsr{Simultaneous notes}.
+No están contemplados los acordes en que la misma nota se presenta con
+diferentes alteraciones accidentales dentro del mismo.  En este caso
+se recomienda usar la transcripción enarmónica, o usar la notación
+especial de racimos (véase @ref{Clusters}).
 
 @node Automatic part combining
 @unnumberedsubsubsec Automatic part combining
@@ -473,30 +534,11 @@ Una sección @code{\relative} que se encuentra fuera de
 
 @snippets
 
-Las partes se pueden combinar sin imprimir ningún texto:
-
-@lilypond[quote,verbatim]
-\new Staff <<
-  \set Staff.printPartCombineTexts = ##f
-  \partcombine
-    \relative g' { g a( b) r }
-    \relative g' { g r4 r f }
->>
-@end lilypond
-
-Es posible modificar los textos que se imprimen:
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{combining-two-parts-on-the-same-staff.ly}
 
-@c KEEP LY
-@lilypond[quote,verbatim]
-\new Staff <<
-  \set Score.soloText = #"ellas"
-  \set Score.soloIIText = #"ellos"
-  \set Score.aDueText = #"todos"
-  \partcombine
-    \relative g' { g4 g r r a2 g }
-    \relative g' { r4 r a( b) a2 g }
->>
-@end lilypond
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-partcombine-texts.ly}
 
 @seealso
 
@@ -551,18 +593,21 @@ la música.
 los compases deben tener la misma longitud.}
 
 @lilypond[quote,verbatim]
-\parallelMusic #'(voiceA voiceB) {
+\parallelMusic #'(voiceA voiceB voiceC) {
   % Bar 1
-  r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c'' e''] |
-  c'2                               c'2                         |
+  r8 g'16 c'' e'' g' c'' e'' r8 g'16 c'' e'' g' c'' e'' |
+  r16 e'8.~   e'4            r16 e'8.~   e'4            |
+  c'2                        c'2                        |
 
   % Bar 2
-  r8 a'16[ d''] f''[ a' d'' f''] r8 a'16[ d''] f''[ a' d'' f''] |
-  c'2                               c'2                         |
+  r8 a'16 d'' f'' a' d'' f'' r8 a'16 d'' f'' a' d'' f'' |
+  r16 d'8.~   d'4            r16 d'8.~   d'4            |
+  c'2                        c'2                        |
+
 }
 \new StaffGroup <<
-  \new Staff  \voiceA
-  \new Staff  \voiceB
+  \new Staff << \voiceA \\ \voiceB >>
+  \new Staff { \clef bass \voiceC }
 >>
 @end lilypond
 
@@ -574,18 +619,21 @@ entrada (dicho de otra manera, las notas relativas de @code{vozA}
 ignoran a las notas que hay en @code{vozB}.
 
 @lilypond[quote,verbatim]
-\parallelMusic #'(voiceA voiceB) {
+\parallelMusic #'(voiceA voiceB voiceC) {
   % Bar 1
   r8 g16 c e g, c e r8 g,16 c e g, c e  |
+  r16 e8.~ e4       r16 e8.~  e4        |
   c2                c                   |
 
   % Bar 2
   r8 a,16 d f a, d f r8 a,16 d f a, d f |
+  r16 d8.~  d4       r16 d8.~  d4       |
   c2                 c                  |
+
  }
 \new StaffGroup <<
-  \new Staff \relative c'' \voiceA
-  \new Staff \relative c'  \voiceB
+  \new Staff << \relative c'' \voiceA \\ \relative c' \voiceB >>
+  \new Staff \relative c' { \clef bass \voiceC }
 >>
 @end lilypond
 
@@ -643,4 +691,3 @@ Manual de aprendizaje:
 
 Fragmentos de código:
 @rlsr{Simultaneous notes}.
-
index 2f6aa3bd3435f2c1dfb9237a3492e25971587fd0..01a6614920fa81c041c13b7900376ef7e4d2d616 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond-learning.tely
 @ignore
-    Translation of GIT committish: e007b6bd3b3328581df4998247fd92d9d66ce07c
+    Translation of GIT committish: cdc64521eae526d00440d0ac9bb5e64fdae97727
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -12,9 +12,9 @@
 @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.
@@ -28,6 +28,7 @@ Tutorial guidelines:  (different from policy.txt!)
 
 @end ignore
 
+@c Translation status: post-GDP
 
 @node Tutorial
 @chapter Tutorial
@@ -39,11 +40,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
 
 
@@ -82,7 +83,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'
 }
@@ -99,9 +100,9 @@ información sobre la presentación de los ejemplos del manual, consulte
 
 
 @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
 
@@ -117,7 +118,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 +186,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...
@@ -205,7 +206,7 @@ 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'
 }
@@ -236,37 +237,38 @@ 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]
+@lilypond[verbatim,quote]
 \relative c' {  % set the starting point to middle C
   c d e f
   g a b c
 }
 @end lilypond
 
-La nota inicial es @notation{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:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {  % one octave above middle C
   e c a c
 }
@@ -282,7 +284,7 @@ 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.
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   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
@@ -305,7 +307,7 @@ apóstrofe) 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'
@@ -317,8 +319,9 @@ 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)
 
@@ -340,7 +343,7 @@ 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
@@ -352,7 +355,7 @@ 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.
@@ -368,7 +371,7 @@ Glosario musical:
 Un @notation{silencio} se introduce igual que si fuera una nota con el
 nombre @code{r}@tie{}:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   a r r2
   r8 a r4 r4. r8
@@ -384,7 +387,7 @@ Glosario musical:
 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
@@ -404,7 +407,7 @@ Glosario musical:
 La @notation{clave} se puede establecer utilizando la orden
 @code{\clef} :
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 \relative c' {
   \clef treble
   c1
@@ -423,7 +426,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
@@ -449,7 +452,7 @@ 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:
@@ -457,16 +460,17 @@ 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
@@ -494,7 +498,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
@@ -529,11 +533,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
 
@@ -544,12 +548,11 @@ fragmento muestra algunos posibles usos para los comentarios:
 @subsection How to read the manual
 
 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:
+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'' @{
@@ -559,9 +562,9 @@ muestra, pero @strong{deberá} escribir el
 
 ¿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
@@ -578,7 +581,7 @@ exacta de LilyPond que se utilizó para generar esa imagen.  Pruébelo
 sobre esta imagen:
 
 @c no verbatim here
-@lilypond[quote,ragged-right]
+@lilypond[quote]
 \relative c'' {
   c-\markup { \bold \huge { Click here.  } }
 }
@@ -635,7 +638,7 @@ 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,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 cis1 ees fisis, aeses
 @end lilypond
 
@@ -651,7 +654,7 @@ 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
@@ -691,7 +694,7 @@ automáticamente, y usted deberá introducir aquello que quiera oír.
 
 En el siguiente ejemplo:
 
-@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \key d \major
 d cis fis
 @end lilypond
@@ -705,7 +708,7 @@ 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
@@ -741,7 +744,7 @@ 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
@@ -756,7 +759,7 @@ 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
 
@@ -774,7 +777,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
 
@@ -796,7 +799,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
 
@@ -822,7 +825,7 @@ Glosario musical:
 Las @notation{articulaciones} más corrientes se pueden añadir a las
 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
 
@@ -835,7 +838,7 @@ Glosario musical:
 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
 
@@ -845,7 +848,7 @@ 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
 
@@ -859,7 +862,7 @@ 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
 
@@ -872,7 +875,7 @@ Los @notation{crescendi} y @notation{decrescendi} comienzan con las
 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
 
@@ -889,13 +892,13 @@ Referencia de la notación:
 
 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
@@ -919,7 +922,7 @@ Glosario musical:
 
 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
 
@@ -928,10 +931,23 @@ 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.
+@c It will usually be necessary to manually beam music
+@c with lyrics.
+
+@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:
@@ -953,7 +969,7 @@ 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
@@ -972,7 +988,7 @@ 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] }
@@ -994,7 +1010,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
@@ -1021,11 +1037,11 @@ 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
 
 
@@ -1036,7 +1052,7 @@ 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
 
@@ -1044,7 +1060,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
 
@@ -1053,7 +1069,7 @@ 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
 
@@ -1101,7 +1117,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 }
@@ -1129,7 +1145,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>> } >>
@@ -1151,7 +1167,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 }
@@ -1184,7 +1200,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 }
@@ -1218,7 +1234,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, }
@@ -1258,7 +1274,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
 
@@ -1269,7 +1285,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
@@ -1289,10 +1305,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 }
@@ -1305,7 +1321,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 }
@@ -1315,7 +1331,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 } \\
@@ -1331,7 +1347,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
@@ -1341,9 +1358,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
 
 
@@ -1359,7 +1376,7 @@ Glosario musical:
 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
@@ -1371,7 +1388,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
@@ -1385,8 +1402,8 @@ 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
@@ -1400,10 +1417,10 @@ Glosario musical:
 @cindex guión
 @cindex guión bajo
 
-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:
+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,ragged-right]
+@lilypond[verbatim,quote]
 <<
   \relative c'' {
     \key g \major
@@ -1425,13 +1442,13 @@ 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.
+    g8 a4 b8 c( b) a d4 b8 g4.
   }
   \addlyrics {
     Girls and boys come out to play,
@@ -1440,16 +1457,33 @@ ligadura de expresión sobre ellas (véase @ref{Ties and slurs}):
 >> 
 @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
@@ -1469,9 +1503,9 @@ 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
@@ -1497,7 +1531,7 @@ 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
@@ -1517,14 +1551,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
@@ -1551,7 +1585,7 @@ Referencia de la notación:
 
 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]
 <<
@@ -1595,11 +1629,11 @@ 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
 
 
@@ -1624,7 +1658,7 @@ 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). 
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 violin = \new Staff { \relative c'' {
   a4 b c b
 }}
@@ -1743,7 +1777,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,
@@ -1753,7 +1787,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,
@@ -1772,7 +1806,7 @@ Como puede ver, escribir una melodía en clave de Sol implica escribir
 gran cantidad de apóstrofes @q{'} .  Consideremos este fragmento de
 Mozart:
 
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
 {
   \key a \major
   \time 6/8
@@ -1785,7 +1819,7 @@ Todos estos apóstrofes 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
@@ -1808,6 +1842,9 @@ archivos de LilyPond generados por ordenador.
 @node After the tutorial
 @subsection After the tutorial
 
+@c FIXME: rewrite slightly after the rest of the LM has been
+@c stabilized.  Translators, ignore this section for now.
+
 Después de terminar el tutorial, quizá debería probar a escribir una o
 dos piezas.  Comience con una de las plantillas del @ref{Templates} y
 añada algunas notas.  Si necesita un tipo de notación que no ha sido