Doc-es: update Notation/Changing.

diff --git a/Documentation/es/notation/changing-defaults.itely b/Documentation/es/notation/changing-defaults.itely
index 8e102bf6559fc3de85dbca4a6f96ca1045875d87..d878e9c414693142607dd9d70359f1e5597a5017 100644 (file)
--- a/Documentation/es/notation/changing-defaults.itely
+++ b/Documentation/es/notation/changing-defaults.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore

-Translation of GIT committish: 28add695953862ef4a87f9fbeadd1d02dc299244
+Translation of GIT committish: 4299c96f609f79426a181ffed107d17fa6e1fdbd

 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'


@@ -1541,7 +1541,6 @@ Archivos instalados:
 @end menu
 
 
 @end menu
 
 

-

 @node Navegar por la referencia del programa
 @subsection Navegar por la referencia del programa
 @translationof Navigating the program reference
 @node Navegar por la referencia del programa
 @subsection Navegar por la referencia del programa
 @translationof Navigating the program reference


@@ -1772,31 +1771,28 @@ unos junto a otros.
 
 Aumentando el valor de @code{padding}, podemos alejar la cifra de
 digitación de la cabeza de la nota.  La siguiente orden inserta un
 
 Aumentando el valor de @code{padding}, podemos alejar la cifra de
 digitación de la cabeza de la nota.  La siguiente orden inserta un

-espacio en blanco de 3 espacios de pentagrama entre la nota y la
-digitación:
+espacio en blanco de tres @qq{espacios de pentagrama} entre la
+nota y la digitación:
+

 @example
 \once \override Voice.Fingering.padding = #3
 @end example
 
 @example
 \once \override Voice.Fingering.padding = #3
 @end example
 

-Al insertar esta instrucción antes de que se haya creado el objeto
-Fingering, es decir, antes del @code{c2}, llegamos al siguiente
-resultado:
+Al insertar este relleno antes de que se haya creado el objeto de
+digitación, llegamos al siguiente resultado:

 
 

-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,fragment,verbatim]

 \once \override Voice.Fingering.padding = #3
 \once \override Voice.Fingering.padding = #3

-c-2
-\stemUp
-f
+c''-2

 @end lilypond
 
 @end lilypond
 

-En este caso, el contexto de este truco es @code{Voice}.  Este
-hecho se puede deducir también a partir de la referencia del
-programa, ya que la página dedicada al añadido
-@rinternals{Fingering_engraver} dice
+En este caso, el contexto de este truco es @code{Voice}.  Véase el
+apartado dedicado al añadido @rinternals{Fingering_engraver}, que
+dice:

 
 @quotation
 
 @quotation

-El grabador Fingering_engraver es parte de los contextos: @dots{}
-@rinternals{Voice}
+El grabador Fingering_engraver forma parte de los contextos:
+@dots{}  @rinternals{Voice}

 @end quotation
 
 
 @end quotation
 
 


@@ -1808,13 +1804,20 @@ Se hace necesario presentar una panorámica de las diversas
 convenciones de nomenclatura:
 
 @itemize
 convenciones de nomenclatura:
 
 @itemize

-@item funciones de Scheme: minúsculas-con-guiones (incluso nombres de una sola palabra)
-@item funciones de Scheme: ly:más-estilo-de-scheme
+@item funciones de Scheme: minúsculas-con-guiones (lo que incluye a los nombres de una sola palabra)
+
+@item funciones de Scheme específicas de LilyPond: ly:más-estilo-de-scheme
+

 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme
 @item eventos, clases y propiedades musicales: como-las-funciones-de-scheme

+

 @item interfaces de Grobs: estilo-scheme
 @item interfaces de Grobs: estilo-scheme

+

 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)
 @item propiedades de backend: estilo-scheme (¡pero X e Y en mayúsculas!)

+

 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello
 @item contextos (y ExpresionesMusicales y grobs): Mayúsculas o MayúsculasDeCamello

+

 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello
 @item propiedades de contexto: minúsculasSeguidoDeMayúsculasDeCamello

+

 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
 @end itemize
 
 @item grabadores: Mayúsculas_seguido_de_minúsculas_y_con_barras_bajas
 @end itemize
 


@@ -1822,6 +1825,7 @@ convenciones de nomenclatura:
 Preguntas aún sin respuesta
 @itemize
 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?
 Preguntas aún sin respuesta
 @itemize
 @item ¿Cuáles de aquéllas son convenciones y cuáles son reglas?

+

 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
 @end itemize
 @end ignore
 @item ¿Cuáles son reglas del lenguaje subyacente, y cuáles son específicas de LilyPond?
 @end itemize
 @end ignore


@@ -2498,66 +2502,67 @@ de entrada.
 
 @funindex \set
 @funindex \override
 
 @funindex \set
 @funindex \override

-Tanto @code{\set} como @code{\override} manipulan propiedades
-asociadas a contextos.  En ambos casos las propiedades tienen en
-cuenta la jerarquía de contextos: las propiedades no establecidas en
-el propio contexto presentan los valores del contexto padre
-respectivo.

 
 

-El valor y la duración en el tiempo de las propiedades de contexto
+Tanto la instrucción @code{\set} como @code{\override} manipulan
+propiedades asociadas a contextos.  En ambos casos las propiedades
+siguen una@emph{jerarquía de contextos}: las propiedades que no se
+establecen dentro del contexto aún presentan los valores del
+contexto de su padre respectivo.
+
+El valor y la duración en el tiempo de una propiedad de contexto

 son dinámicos y están disponibles solamente cuando la música se
 está interpretando o @q{iterando}.  En el momento de la creación
 son dinámicos y están disponibles solamente cuando la música se
 está interpretando o @q{iterando}.  En el momento de la creación

-del contexto, se inicializan las propiedades a partir de la
-definición de contexto correspondiente y las posibles
-modificaciones de contexto.  Después de esto, cualquier cambio se
+del contexto, se inicializan las propiedades a partir de las
+definiciones correspondientes (así como otras posibles
+modificaciones) de dicho contexto.  Cualquier cambio posterior se

 obtiene a través de instrucciones de establecimiento de
 propiedades dentro de la propia música.
 
 obtiene a través de instrucciones de establecimiento de
 propiedades dentro de la propia música.
 

-Ahora bien, las definiciones de grob (objetos gráficos) son una
-clase especial de propiedades de contexto.  Dado que su
-estructura, mantenimiento y utilización es distinta de las
-propiedades de contexto ordinarias, se accede a ellas con un
-conjunto de instrucciones diferente, y se estudian por separado
-dentro de la documentación.
-
-A diferencia de las propiedades de contexto normales, las
-definiciones de grob están subdivididas en propiedades de grob.
-Un @qq{grob} (objeto gráfico) se crea normalmente por parte de un
+Las definiciones de grob (objetos gráficos) son una clase
+@emph{especial} de propiedades de contexto, pues su estructura y
+uso son distintos de las propiedades de contexto ordinarias.  A
+diferencia de las propiedades de los contextos normales, las
+definiciones de grob se subdividen en @emph{propiedades de grob}.
+
+Además, en contraste con las propiedades de contexto normales, las
+definiciones de grob tienen su propio conjunto de @q{utilidades de
+mantenimiento} de las propiedades individuales y, en su caso,
+sub-propiedades.  Esto supone que es posible definir las distintas
+partes dentro de diferentes contextos y aún tener la definición
+completa del grob en el momento de su creación, montada a partir
+de todas las piezas proporcionadas por el contexto actual y su
+ancestro o ancestros, conjuntamente.
+
+Un grob u objeto gráfico se crea normalmente por parte de un

 grabador en el momento de la interpretación de una expresión
 musical y recibe sus propiedades iniciales de la definición de
 grob en curso del contexto del grabador.  El grabador (u otras
 grabador en el momento de la interpretación de una expresión
 musical y recibe sus propiedades iniciales de la definición de
 grob en curso del contexto del grabador.  El grabador (u otras

-partes del @q{backend} de LilyPond) pueden después añadir o
-modificar propiedades del grob, pero ello no afecta a la
-definición de grob del contexto.
-
-Lo que conocemos como @q{propiedades de grob} en el contexto del
-trucaje a nivel de usuario son en realidad las propiedades de la
-definición de grob de un contexto.  A diferencia de las
-propiedades de contexto normales, las definiciones de grob
-mantienen la contabilidad necesaria para seguir la pista de sus
-partes, las propiedades de grob individuales (e incluso
-subpropiedades de éstos), de forma separada, de forma que es
-posible definir dichas partes dentro de contextos diferentes y
-hacer que la definición de grob en su conjunto, en el momento de
-la creación del grob, se monte a partir de las piezas
-proporcionadas en diferentes contextos entre el contexto actual y
-sus contextos padre.
-
-Las definiciones de grob se manipulan usando @code{\override} y
-@code{\revert} y tienen un nombre que empieza con una letra mayúscula
-(como @samp{NoteHead}) mientras que las propiedades de contexto
-ordinarias se manipulan utilizando @code{\set} y @code{\unset} y se
-nombran empezando en letra minúscula.
+partes del @q{backend} de LilyPond) pueden después modificar (o
+añadirse a) las propiedades iniciales del grob; sin embargo, ello
+no afecta a la definición de grob del contexto.
+
+Lo que LilyPond conoce como @q{propiedades de grob} en el contexto
+del trucaje a nivel de usuario son en realidad las propiedades de
+la definición de grob de un contexto.
+
+Se accede a las definiciones de grob con un conjunto de
+instrucciones diferente.  Se manipulan usando @code{\override} y
+@code{\revert} y tienen un nombre que empieza con una letra
+mayúscula (como @samp{NoteHead}) mientras que las propiedades de
+contexto ordinarias se manipulan utilizando @code{\set} y
+@code{\unset} y se nombran empezando en letra minúscula.

 
 @cindex tweak, relación con @code{\override}
 @funindex \tweak
 @funindex \overrideProperty
 
 @cindex tweak, relación con @code{\override}
 @funindex \tweak
 @funindex \overrideProperty

-Las instrucciones especiales @code{\tweak} y @code{\overrideProperty}
-cambian las propiedades de grob pasando por encima de las propiedades
-de contexto completamente.  En su lugar, atrapan a los grobs tan
-pronto se crean, y después establecen propiedades sobre ellos
-directamente cuando se originan a partir de un evento musical trucado
-o son de un tipo en particular, respectivamente.
+
+Las instrucciones @code{\tweak} y @code{\overrideProperty} cambian
+las propiedades de grob pasando por encima de las propiedades de
+contexto completamente.  En su lugar, atrapan a los grobs tan
+pronto se crean, y establecen propiedades sobre ellos directamente
+con @code{\tweak} cuando se originan a partir de un evento musical
+o, en el caso de @code{\overrideProperty}, para una sobreescritura
+específica.

 
 @node Modificación de las listas-A
 @subsection Modificación de las listas-A
 
 @node Modificación de las listas-A
 @subsection Modificación de las listas-A


@@ -2702,7 +2707,6 @@ como listas-A.}
 * Rotación de objetos::
 @end menu
 
 * Rotación de objetos::
 @end menu
 

-

 @node Modos de entrada
 @subsection Modos de entrada
 @translationof Input modes
 @node Modos de entrada
 @subsection Modos de entrada
 @translationof Input modes


@@ -2760,10 +2764,12 @@ Para crear diagramas de trastes, escriba las notas o acordes en el
 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
 véase @ref{Tablaturas predeterminadas}.
 
 modo de notas e imprímalos dentro de un contexto @code{TabStaff},
 véase @ref{Tablaturas predeterminadas}.
 

-Para crear diagramas de trastes encima de un pentagrama,
-escríbalos como elementos de marcado encima de las notas
-utilizando la instrucción @code{\fret-diagram}, véase @ref{Marcas
-de diagramas de trastes}.
+Para crear diagramas de trastes encima de un pentagrama, podemos
+elegir entre dos posibilidades.  Se puede usar el contexto
+@code{FretBoards} (véase @ref{Diagramas de traste automáticos}) o
+se pueden introducir como elementos de marcado encima de las notas
+utilizando la instrucción @code{\fret-diagram}, véase
+@ref{Marcas de diagramas de trastes}.

 
 @subsubsubheading Modo de letra
 
 
 @subsubsubheading Modo de letra
 


@@ -2780,14 +2786,15 @@ letra que viene a continuación con la música precedente.
 @subsubsubheading Modo de marcado
 
 Se activa con la instrucción @code{\markup}, y hace que la entrada
 @subsubsubheading Modo de marcado
 
 Se activa con la instrucción @code{\markup}, y hace que la entrada

-se interprete con la sintaxis del marcado, véase @ref{Text markup
-commands}.
+se interprete con la sintaxis del marcado, véase
+@ref{Text markup commands}.

 
 @subsubsubheading Modo de notas
 
 Es el modo predeterminado o se puede activar con la instrucción
 
 @subsubsubheading Modo de notas
 
 Es el modo predeterminado o se puede activar con la instrucción

-@code{\notemode}.  La entrada se interpreta como alturas, duraciones,
-marcado, etc. y se imprime como notación musical sobre un pentagrama.
+@code{\notemode}.  La entrada se interpreta como alturas,
+duraciones, marcado, etc. y se imprime como notación musical sobre
+un pentagrama.

 
 Normalmente no es necesario especificar el modo de notas de forma
 explícita, pero puede ser útil hacerlo en ciertas situaciones, por
 
 Normalmente no es necesario especificar el modo de notas de forma
 explícita, pero puede ser útil hacerlo en ciertas situaciones, por


@@ -2815,6 +2822,7 @@ una dirección o colocación concreta.
 * La propiedad de dirección::
 @end menu
 
 * La propiedad de dirección::
 @end menu
 

+

 @node Indicadores de dirección de las articulaciones
 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
 @translationof Articulation direction indicators
 @node Indicadores de dirección de las articulaciones
 @unnumberedsubsubsec Indicadores de dirección de las articulaciones
 @translationof Articulation direction indicators


@@ -2856,6 +2864,7 @@ Estas indicaciones afectan sólo a la nota siguiente.
 }
 @end lilypond
 
 }
 @end lilypond
 

+

 @node La propiedad de dirección
 @unnumberedsubsubsec La propiedad de dirección
 @translationof The direction property
 @node La propiedad de dirección
 @unnumberedsubsubsec La propiedad de dirección
 @translationof The direction property


@@ -3632,15 +3641,25 @@ algunas combinaciones pueden incluso dar errores.  Son de
 aplicación las siguientes limitaciones:
 
 @itemize @bullet
 aplicación las siguientes limitaciones:
 
 @itemize @bullet

-@item Las líneas divisorias no se pueden imprimir al principio de la línea.
-@item No se puede imprimir el número de compás al principio de la primera
-línea a no ser que su valor establecido sea distinto de 1.
-@item Clave: véase más abajo
-@item Las repeticiones dobles de tipo porcentaje se imprimen completamente o
-se suprimen por completo.  Utilice begin-of line-invisible para
-imprimirlas y all-invisible para suprimirlas.
-@item Armadura: véase más abajo
-@item ClefModifier: véase más abajo
+@item
+Las líneas divisorias no se pueden imprimir al principio de la línea.
+
+@item
+No se puede imprimir el número de compás al principio de la
+@emph{primera} línea a no ser que su valor establecido sea
+distinto de @code{1}.
+
+@item Clave: véase la sección siguiente.
+
+@item
+Las repeticiones dobles de tipo porcentaje se imprimen todas
+siempre o bien no se imprimen nunca.  Utilice @code{begin-of
+line-invisible} para imprimirlas y @code{all-invisible} para
+suprimirlas.
+
+@item Armadura: véase la sección siguiente.
+
+@item ClefModifier: véase la sección siguiente.

 @end itemize
 
 
 @end itemize
 
 


@@ -4402,16 +4421,19 @@ Cualquiera de los glifos de la fuente tipográfica Feta se puede
 pasar a la instrucción de marcado @code{\musicglyph}: véase
 @ref{La tipografía Feta}.
 
 pasar a la instrucción de marcado @code{\musicglyph}: véase
 @ref{La tipografía Feta}.
 

-@c TODO Add inserting eps files or ref to later
+Se pueden insertar en línea tanto imágenes en formato @file{EPS}
+como instrucciones de Postscript usando las instrucciones de
+marcado @code{\epsfile} y @code{\postscript} respectivamente;
+véase @ref{Graphic}.

 
 

-@c TODO Add inserting Postscript or ref to later

 
 @seealso
 Referencia de la notación:
 @ref{Notación gráfica dentro de elementos de marcado},
 @ref{Formatear el texto},
 @ref{Text markup commands},
 
 @seealso
 Referencia de la notación:
 @ref{Notación gráfica dentro de elementos de marcado},
 @ref{Formatear el texto},
 @ref{Text markup commands},

-@ref{La tipografía Feta}.
+@ref{La tipografía Feta},
+@ref{Graphic}.

 
 
 @node Modificación de las formas
 
 
 @node Modificación de las formas


@@ -4856,6 +4878,10 @@ valor necesario, que se usa entonces por la primera función para
 obtener el valor real que se usa a continuación para el ajuste de
 precisión mucho más tardío durante el proceso de espaciado.
 
 obtener el valor real que se usa a continuación para el ajuste de
 precisión mucho más tardío durante el proceso de espaciado.
 

+@c TODO: The following example supposedly showing a collision no longer
+@c 'works' since 2.18.x. Another example of a collision is needed.
+@c Issue #3512
+

 @lilypond[verbatim,quote,ragged-right]
 #(define (square-line-circle-space grob)
 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))
 @lilypond[verbatim,quote,ragged-right]
 #(define (square-line-circle-space grob)
 (let* ((pitch (ly:event-property (ly:grob-property grob 'cause) 'pitch))