From ea3d03fb902ef532803450a96625580ab5b5502b Mon Sep 17 00:00:00 2001
From: Francisco Vila <francisco.vila@hispalinux.es>
Date: Sun, 8 Jan 2012 19:24:47 +0100
Subject: [PATCH] Doc-es: update Fretted, Repeats, Staff; mark updated file.

This fully updates the Spanish notation manual.
---
 Documentation/es/changes.tely                 |   2 +-
 .../es/notation/fretted-strings.itely         |  12 +-
 Documentation/es/notation/repeats.itely       |  18 +-
 Documentation/es/notation/staff.itely         | 301 ++++++++++--------
 4 files changed, 190 insertions(+), 143 deletions(-)

diff --git a/Documentation/es/changes.tely b/Documentation/es/changes.tely
index 7815d24894..596597fa27 100644
--- a/Documentation/es/changes.tely
+++ b/Documentation/es/changes.tely
@@ -1,6 +1,6 @@
 \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: c0922cccef8da774f9f208614c9f6b92cfdc6e3f
+    Translation of GIT committish: 6646c71a5309b40a4594db67b5426c6f3786f372
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
diff --git a/Documentation/es/notation/fretted-strings.itely b/Documentation/es/notation/fretted-strings.itely
index ea6e39d65c..82b3e85f77 100644
--- a/Documentation/es/notation/fretted-strings.itely
+++ b/Documentation/es/notation/fretted-strings.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 
 @ignore
-    Translation of GIT committish: 0d0a674ba7bfa052e277861427c0a2d7a6d2cdde
+    Translation of GIT committish: 4269f54b663421ca2c5c2c57baa5d9c49709d6d2
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -268,6 +268,8 @@ es 0.
 @end lilypond
 
 @funindex \tabChordRepetition
+@cindex acordes, repetición de
+@cindex repetición con @code{q}
 
 Las construcciones de acorde se pueden repetir mediante el símbolo de
 repetición de acordes @code{q}.  Para utilizar esta posibilidad en
@@ -408,7 +410,6 @@ otro armónico debe estar calculado por parte de LilyPond.  Se puede
 conseguir esto indicando el traste en que debe rozar la cuerda el dedo
 de la mano que pisa.
 
-
 @lilypond[verbatim,quote]
 fretHarmonics = {
   \harmonicByFret #5 d16\4
@@ -442,9 +443,7 @@ ratioHarmonics = {
 }
 @end lilypond
 
-
 @snippets
-
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {stem-and-beam-behavior-in-tablature.ly}
 
@@ -463,9 +462,10 @@ ratioHarmonics = {
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {chord-glissando-in-tablature.ly}
 
-
 @seealso
 Referencia de la notación:
+@ref{Repetición de acordes},
+@ref{Repeticiones explícitas},
 @ref{Plicas},
 @ref{Armónicos},
 @ref{Glissando}.
@@ -479,9 +479,7 @@ Referencia de funcionamiento interno:
 @rinternals{TabVoice},
 @rinternals{Beam}.
 
-
 @knownissues
-
 Los acordes no se tratan de una forma especial, y de aquí que el
 selector automático de la cuerda puede elegir fácilmente la misma
 cuerda para dos notas del acorde.
diff --git a/Documentation/es/notation/repeats.itely b/Documentation/es/notation/repeats.itely
index cb7829fe35..b28b11dfd5 100644
--- a/Documentation/es/notation/repeats.itely
+++ b/Documentation/es/notation/repeats.itely
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: f84eab93e732ed2b9aa50436202a28f34243c658
+    Translation of GIT committish: 4269f54b663421ca2c5c2c57baa5d9c49709d6d2
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -468,12 +468,13 @@ Referencia de funcionamiento interno:
 @translationof Written-out repeats
 
 @cindex explícitas, repeticiones
-@cindex repetitiva, música
 @cindex repeticiones explícitas
-@cindex repetición desplegada
-@cindex desplegar música
+@cindex repeticiones desplegadas
+@cindex repeticiones alternativas
+@cindex primera y segunda vez, repeticiones
+@cindex repeticiones con primera y segunda vez
 @cindex desplegar repetición
-@cindex repetición desplegada con finales alternativos
+@cindex repeticiones desplegadas con finales alternativos
 @cindex música desplegada con finales alternativos
 @cindex alternativos, finales, en repeticiones explícitas
 @funindex unfold
@@ -564,6 +565,9 @@ Es posible también anidar varias funciones
 c1
 @end lilypond
 
+Las construcciones de acorde se pueden repetir mediante el
+símbolo de repetición de acordes @code{q}.
+Véase @ref{Repetición de acordes}.
 
 @warning{Si pone @code{@bs{}relative} dentro de un bloque
 @code{@bs{}repeat} sin instanciar explícitamente el contexto
@@ -571,6 +575,10 @@ c1
 @rprogram{Aparece un pentagrama de más}.}
 
 @seealso
+Referencia de la notación:
+@ref{Repetición de acordes}.
+
+Snippets:
 Fragmentos de código:
 @rlsr{Repeats}.
 
diff --git a/Documentation/es/notation/staff.itely b/Documentation/es/notation/staff.itely
index fa2c18086f..0210e6b539 100644
--- a/Documentation/es/notation/staff.itely
+++ b/Documentation/es/notation/staff.itely
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @ignore
-    Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5
+    Translation of GIT committish: 03ad62f748d4acd73dfdd485e2a57d2550d0bc4a
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -411,126 +411,151 @@ pentagramas, y establecer secciones de ossia.
 @unnumberedsubsubsec El símbolo del pentagrama
 @translationof Staff symbol
 
-@cindex ajuste del símbolo del pentagrama
-@cindex dibujo del símbolo del pentagrama
-@cindex pentagrama, ajuste del símbolo del
-@cindex símbolo del pentagrama, dibujo del
-@cindex detener líneas de pentagrama
-@cindex iniciar líneas de pentagrama
-@cindex pentagrama, número de líneas
-@cindex pentagrama, grosor de las líneas
-@cindex líneas, número de, de la pauta
-@cindex grosor de líneas de pauta
-@cindex adicionales, establecer líneas
-@cindex ajuste de líneas adicionales
-@cindex espaciado de líneas adicionales
-@cindex número de líneas de pauta
-
-las líneas de un pentagrama pertenecen al grob @code{StaffSymbol}.  Se
-pueden modificar las propiedades de @code{StaffSymbol} para modificar
-la apariencia de una pauta, pero han de modificarse antes de que se
-produzca la creación de la misma.
-
-Se puede cambiar el número de líneas de la pauta.  La posición de la
-clave y del Do central pueden requerir una modificación para mantener
-la correspondencia con la nueva pauta.  Para ver una explicación,
-consulte la sección de fragmentos de código en @ref{Clave}.
+@cindex pentagrama, símbolo del
+@cindex pentagrama, detener e inicial líneas del
+@cindex pentagrama, mofidicar las líneas del
+@cindex adicionales, líneas
+@cindex adicionales internas, líneas
+@cindex adicionales, modificar líneas
+@cindex líneas del pentagrama
+@cindex líneas adicionales
+
+@funindex \startStaff
+@funindex startStaff
+@funindex \stopStaff
+@funindex stopStaff
+
+Se pueden usar las instrucciones @code{\stopStaff} y
+@code{\startStaff} para detener y (re)iniciar, respectivamente, la
+impresión de las líneas de la pauta en cualquier punto de la
+partitura.
 
 @lilypond[verbatim,quote,relative=2]
-\new Staff \with {
-  \override StaffSymbol #'line-count = #3
-}
-{ d4 d d d }
+\stopStaff f4 d \startStaff g, e
+f'4 d \stopStaff g, e
+f'4 d \startStaff g, e
+@end lilypond
+
+@predefined
+@code{\startStaff},
+@code{\stopStaff}.
+@endpredefined
+
+Las líneas de la pauta pertenecen al grob @code{StaffSymbol}
+(incluidas las líneas adicionales) y se pueden modificar usando las
+propiedades de @code{StaffSymbol}, pero esas modificaciones deben
+hacerse antes de que el pentagrama se (re)inicie.
+
+Se puede cambiar el número de líneas de la pauta:
+
+@lilypond[verbatim,quote,relative=2]
+f4 d \stopStaff
+\override Staff.StaffSymbol #'line-count = #2
+\startStaff g, e |
+
+f'4 d \stopStaff
+\revert Staff.StaffSymbol #'line-count
+\startStaff g, e |
 @end lilypond
 
-Se puede modificar el grosor de las líneas de la pauta.  El grosor de
-las líneas adicionales y las plicas también resultan afectados, pues
-dependen del grosor de las líneas de la pauta.
+La posición de cada una de las líneas de la pauta también puede
+cambiarse.  Los valores que se utilizan son @emph{medios} espacios de
+pentagrama y la posición nueva es relativa a tercera línea normal del
+pentagrama.  Se imprime una sola línea de pauta por cada valor que se
+introduce, de manera que el número de líneas así como su posición en
+la pauta pueden cambiarse con una sola operación de sobreescritura.
+
+@lilypond[verbatim,quote,relative=2]
+f4 d \stopStaff
+\override Staff.StaffSymbol #'line-positions = #'(1 3 5 -1 -3)
+\startStaff g, e |
+f'4 d \stopStaff
+\override Staff.StaffSymbol #'line-positions = #'(8 6.5 -6 -8 -0.5)
+\startStaff g, e
+@end lilypond
 
-@lilypond[verbatim,quote,relative=1]
+Puede ser necesario un ajuste de la posición de la clave y del Do
+central para que se correspondan a las líneas nuevas.  Véase
+@ref{Clave}.
+
+Puede cambiarse el grosor de las líneas de la pauta.  También resultan
+afectadas, de forma predeterminada, las líneas adicionales y no la
+plica de las figuras.
+
+@lilypond[verbatim,quote,relative=2]
 \new Staff \with {
   \override StaffSymbol #'thickness = #3
 }
-{ e4 d c b }
+{ f4 d g, e }
 @end lilypond
 
-El grosor de las líneas adicionales se puede fijar de forma
-independiente al de las líneas de la pauta.  En el ejemplo, los dos
-números son factores que multiplican el grosor de las líneas del
-pentagrama y su espaciado.  Las dos contribuciones se suman para dar
-el grosor de las líneas adicionales.
+Sin embargo, es posible fijar el grosor de las líneas adicionales de
+forma independiente del de las líneas de la pauta.  Los dos valores
+requeridos multiplican el grosor de la línea de la pauta con el
+espaciado de las líneas y después se suman para obtener el grosor de
+las líneas adicionales.
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote,relative=2]
 \new Staff \with {
-  \override StaffSymbol #'ledger-line-thickness = #'(1 . 0.2)
+  \override StaffSymbol #'thickness = #2
+  \override StaffSymbol #'ledger-line-thickness = #'(0.5 . 0.4)
 }
-{ e4 d c b }
+{ f'4 a, a,, f }
 @end lilypond
 
-Se puede cambiar la distancia entre las líneas de la pauta.  Este
-ajuste afecta también al espaciado de las líneas adicionales.
+Pueden alterarse las posiciones verticales de las líneas adicionales:
 
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote,relative=2]
 \new Staff \with {
-  \override StaffSymbol #'staff-space = #1.5
+  \override StaffSymbol #'ledger-positions = #'(-3 -2 -1 2 5 6)
 }
-{ a4 b c d }
+{ f'4 a, a,, f }
 @end lilypond
 
-Hay más detalles sobre las propiedades de @code{StaffSymbol} en
-@rinternals{staff-symbol-interface}.
-
-@cindex detener el pentagrama
-@cindex iniciar el pentagrama
-@cindex pentagrama, iniciar
-@cindex pentagrama, detener
-
-@funindex \startStaff
-@funindex startStaff
-@funindex \stopStaff
-@funindex stopStaff
-
-Se pueden colocar modificaciones a las propiedades de una pauta en el
-medio de una partitura, entre @code{\stopStaff} (detener pauta) y
-@code{\startStaff} (iniciar pauta):
+Puede hacerse que las líneas adicionales añadidas aparezcan por encima
+o por debajo de la cabeza de las figuras, dependiendo de la posición
+actual relativa a otras cabezas de figura que tienen asimismo sus
+propias líneas adicionales.
 
 @lilypond[verbatim,quote,relative=2]
-c2 c
-\stopStaff
-\override Staff.StaffSymbol #'line-count = #2
-\startStaff
-b2 b
-\stopStaff
-\revert Staff.StaffSymbol #'line-count
-\startStaff
-a2 a
+\new Staff \with {
+  \override StaffSymbol #'ledger-extra = #4
+}
+{ f'4 a, d, f, }
 @end lilypond
 
-@noindent
-En general, se pueden usar @code{\startStaff} y @code{\stopStaff} para
-detener o iniciar un pentagrama en mitad de una partitura.
-
-@lilypond[verbatim,quote,relative=2]
-c4 b a2
+También puede hacerse que las líneas adicionales aparezcan dentro del
+pentagrama allí donde se requieren líneas de pauta personalizadas.  El
+ejemplo muestra la posición predeterminada de las líneas adicionales
+cuando el valor de posición explícito @code{legder-position} se ha
+fijado o no.  La instrucción @code{stopStaff} se necesita en el
+ejemplo para revertir la instrucción de sobreescritura
+@code{\override} para todo el @code{StaffSymbol} (el símbolo de
+pauta).
+
+@lilypond[fragment,quote,relative=1]
+\override Staff.StaffSymbol #'line-positions =   #'(-8 0 2 4)
+d4 e f g
 \stopStaff
-b4 c d2
 \startStaff
-e4 d c2
+\override Staff.StaffSymbol #'ledger-positions = #'(-8 -6 (-4 -2) 0)
+d4 e f g
 @end lilypond
 
+Puede alterarse la distancia entre líneas de la pauta.  Esto afecta
+también al espaciado de las líneas adicionales.
 
-@predefined
-@code{\startStaff},
-@code{\stopStaff}.
-@endpredefined
-
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+  \override StaffSymbol #'staff-space = #1.5
+}
+{ f'4 d, g, e, }
+@end lilypond
 
 @snippets
-
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {making-some-staff-lines-thicker-than-the-others.ly}
 
-
 @seealso
 Glosario musical:
 @rglos{line},
@@ -881,21 +906,27 @@ primer pentagrama, y el valor de @code{shortInstrumentName} se usa
 para todos los pentagramas siguientes.
 
 @lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"Violin "
-\set Staff.shortInstrumentName = #"Vln "
-c4.. g'16 c4.. g'16
-\break
-c1
+\new Staff \with {
+  instrumentName = #"Violin "
+  shortInstrumentName = #"Vln. "
+}
+{ c4.. g'16 c4.. g'16 \break | c1 }
 @end lilypond
 
-También podemos usar el modo de marcado para construir nombres de
+@cindex instrumentos, nombres complejos de
+
+También podemos usar @code{\markup} para construir nombres de
 instrumento más complicados:
 
 @lilypond[verbatim,quote,relative=2]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c4 c,16 d e f g2
+\new Staff \with {
+  instrumentName = \markup {
+    \column { "Clarinetti"
+      \line { "in B" \smaller \flat }
+    }
+  }
+}
+{ c4 c,16 d e f g2 }
 @end lilypond
 
 @cindex instrument names, centering
@@ -907,17 +938,17 @@ se debe utilizar @code{\center-column}:
 
 @lilypond[verbatim,quote,indent=1.5\cm,relative=2]
 <<
-  \new Staff {
-    \set Staff.instrumentName = #"Flute"
-    f2 g4 f
+  \new Staff \with {
+    instrumentName = #"Flute"
   }
-  \new Staff {
-    \set Staff.instrumentName = \markup \center-column {
-      Clarinet
+  { f2 g4 f }
+  \new Staff \with {
+    instrumentName = \markup {
+      \center-column { "Clarinet" }
       \line { "in B" \smaller \flat }
     }
-    c4 b c2
   }
+  { c4 b c2 }
 >>
 @end lilypond
 
@@ -931,25 +962,31 @@ valores del sangrado, @code{indent}, y del sangrado corto,
 consulte @ref{Variables de \paper para desplazamientos y sangrados}.
 
 @lilypond[verbatim,quote,ragged-right]
+\relative c'' {
+  <<
+    \new Staff \with {
+      instrumentName = #"Alto Flute in G"
+      shortInstrumentName = #"Flt."
+    }
+    {
+      f2 g4 f \break
+      g4 f g2
+    }
+    \new Staff \with {
+      instrumentName = #"Clarinet"
+      shortInstrumentName = #"Clar."
+    }
+    {
+      c,4 b c2 \break
+      c2 b4 c
+    }
+  >>
+}
+
 \layout {
   indent = 3.0\cm
   short-indent = 1.5\cm
 }
-
-\relative c'' <<
-  \new Staff {
-    \set Staff.instrumentName = #"Alto Flute in G"
-    \set Staff.shortInstrumentName = #"Fl."
-    f2 g4 f \break
-    g4 f g2
-  }
-  \new Staff {
-    \set Staff.instrumentName = #"Clarinet"
-    \set Staff.shortInstrumentName = #"Clar."
-    c,4 b c2 \break
-    c2 b4 c
-  }
->>
 @end lilypond
 
 @cindex nombres de instrumento, añadir a otros contextos
@@ -961,19 +998,23 @@ contexto. Para ver más detalles, consulte @ref{Modificar los complementos (plug
 
 @cindex nombres de instrumento, cambiar
 
-Los nombres de instrumento se pueden cambiar en mitad de una pieza;
-sin embargo, recuerde que el @code{instrumentName} no se imprime en
-mitad de la pieza, ya que sólo aparece en el primer pentagrama:
+El nombre de instrumento corto @code{shortInstrumentName} se puede
+cambiar en mitad de una pieza; sin embargo, sólo el primer
+@code{instrumentName} se imprime y el resto de ellos se ignoran:
 
 @lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"First"
-\set Staff.shortInstrumentName = #"one"
-c1 c c c \break
-c1 c c c \break
-\set Staff.instrumentName = #"Second"
-\set Staff.shortInstrumentName = #"two"
-c1 c c c \break
-c1 c c c \break
+\new Staff \with {
+  instrumentName = #"Flute"
+  shortInstrumentName = #"Flt."
+}
+{
+  c1 c c c \break
+  c1 c c c \break
+  \set Staff.instrumentName = #"Clarinet"
+  \set Staff.shortInstrumentName = #"Clt."
+  c1 c c c \break
+  c1 c c c \break
+}
 @end lilypond
 
 @cindex instrumento, cambio de
-- 
2.39.2