From be54478988ddd7460808c7b3b0d4ed361fe8bd2d Mon Sep 17 00:00:00 2001
From: John Mandereau <john.mandereau@gmail.com>
Date: Tue, 10 Jun 2008 23:28:09 +0200
Subject: [PATCH] Maintain translated docs

- add headwords in NR1,

- fix broken cross-references (which implies renaming some sections),

- reword some introduction sentences in French docs.
---
 Documentation/de/user/editorial.itely         |  2 +
 Documentation/de/user/expressive.itely        |  2 +
 Documentation/de/user/introduction.itely      |  6 +--
 Documentation/de/user/pitches.itely           |  2 +
 Documentation/de/user/repeats.itely           |  3 ++
 Documentation/de/user/rhythms.itely           |  2 +
 Documentation/de/user/simultaneous.itely      |  2 +
 Documentation/de/user/staff.itely             |  2 +-
 Documentation/es/user/introduction.itely      |  6 +--
 Documentation/es/user/non-music.itely         |  2 +-
 .../es/user/notation-appendices.itely         |  2 +-
 Documentation/es/user/repeats.itely           |  2 +-
 Documentation/es/user/rhythms.itely           |  2 +-
 Documentation/es/user/staff.itely             |  4 +-
 Documentation/es/user/text.itely              | 38 ++++++------------
 Documentation/fr/user/editorial.itely         |  3 +-
 Documentation/fr/user/expressive.itely        |  2 +
 Documentation/fr/user/introduction.itely      | 14 +++----
 Documentation/fr/user/repeats.itely           | 10 +++--
 Documentation/fr/user/rhythms.itely           |  4 +-
 Documentation/fr/user/simultaneous.itely      |  2 +
 Documentation/fr/user/staff.itely             |  9 ++++-
 Documentation/fr/user/text.itely              | 40 ++++++-------------
 Documentation/fr/user/tutorial.itely          |  2 +-
 24 files changed, 82 insertions(+), 81 deletions(-)

diff --git a/Documentation/de/user/editorial.itely b/Documentation/de/user/editorial.itely
index ba8ffed136..36f4eedddc 100644
--- a/Documentation/de/user/editorial.itely
+++ b/Documentation/de/user/editorial.itely
@@ -11,6 +11,8 @@
 @node Editorial annotations
 @section Editorial annotations
 
+@lilypondfile[quote]{editorial-headword.ly}
+
 @menu
 * Inside the staff::            
 * Outside the staff::           
diff --git a/Documentation/de/user/expressive.itely b/Documentation/de/user/expressive.itely
index 33f9ee7c74..0d76654472 100644
--- a/Documentation/de/user/expressive.itely
+++ b/Documentation/de/user/expressive.itely
@@ -11,6 +11,8 @@
 @node Expressive marks
 @section Expressive marks
 
+@lilypondfile[quote]{expressive-headword.ly}
+
 @menu
 * Attached to notes::           
 * Curves::                      
diff --git a/Documentation/de/user/introduction.itely b/Documentation/de/user/introduction.itely
index 69ad600c64..175b2bddca 100644
--- a/Documentation/de/user/introduction.itely
+++ b/Documentation/de/user/introduction.itely
@@ -19,7 +19,7 @@
 * What symbols to engrave?::    
 * Music representation::        
 * Example applications::        
-* About this manual::           
+* About the documentation::     
 @end menu
 
 
@@ -721,8 +721,8 @@ es sehr einfach, Noten und Text zu kombinieren.
 
 
 
-@node About this manual
-@section About this manual
+@node About the documentation
+@section About the documentation
 
 Es gibt zwei Handbücher zu LilyPond: das @emph{Benutzerhandbuch} (dieses 
 Dokument) und das @emph{Handbuch über die Programmbenutzung}.
diff --git a/Documentation/de/user/pitches.itely b/Documentation/de/user/pitches.itely
index 773134a020..ebdf216f84 100644
--- a/Documentation/de/user/pitches.itely
+++ b/Documentation/de/user/pitches.itely
@@ -11,6 +11,8 @@
 @node Pitches
 @section Pitches
 
+@lilypondfile[quote]{pitches-headword.ly}
+
 This section discusses how to specify the pitch of notes.
 
 @menu
diff --git a/Documentation/de/user/repeats.itely b/Documentation/de/user/repeats.itely
index f729427b20..e4ae2e0106 100644
--- a/Documentation/de/user/repeats.itely
+++ b/Documentation/de/user/repeats.itely
@@ -11,6 +11,9 @@
 @node Repeats
 @section Repeats
 
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{repeats-headword.ly}
+
 Wiederholung ist ein zentrales Konzept in der Musik, und es gibt eine 
 ganze Vielzahl von Notationsmöglichkeiten für Wiederholungen.
 
diff --git a/Documentation/de/user/rhythms.itely b/Documentation/de/user/rhythms.itely
index 1564a67a2b..54f1c56d0d 100644
--- a/Documentation/de/user/rhythms.itely
+++ b/Documentation/de/user/rhythms.itely
@@ -11,6 +11,8 @@
 @node Rhythms
 @section Rhythms
 
+@lilypondfile[quote]{rhythms-headword.ly}
+
 This section discusses rhythms, durations, and bars.
 
 @menu
diff --git a/Documentation/de/user/simultaneous.itely b/Documentation/de/user/simultaneous.itely
index c3e8ff2ed5..40dff76e80 100644
--- a/Documentation/de/user/simultaneous.itely
+++ b/Documentation/de/user/simultaneous.itely
@@ -11,6 +11,8 @@
 @node Simultaneous notes
 @section Simultaneous notes
 
+@lilypondfile[quote]{simultaneous-headword.ly}
+
 Polyphonie bedeutet in der musikalischen Terminologie das
 Vorhandensein von mehr als einer (eigenständigen) Stimme 
 in einem Stück. Für LilyPond bedeutet es aber das Vorhandensein 
diff --git a/Documentation/de/user/staff.itely b/Documentation/de/user/staff.itely
index 9a089f8aa1..3e7b1d6f6e 100644
--- a/Documentation/de/user/staff.itely
+++ b/Documentation/de/user/staff.itely
@@ -11,7 +11,7 @@
 @node Staff notation
 @section Staff notation
 
-staff = singular, staves = plural
+@lilypondfile[quote]{staff-headword.ly}
 
 @menu
 * Displaying staves::           
diff --git a/Documentation/es/user/introduction.itely b/Documentation/es/user/introduction.itely
index b79815f855..cd0b57a035 100644
--- a/Documentation/es/user/introduction.itely
+++ b/Documentation/es/user/introduction.itely
@@ -19,7 +19,7 @@
 * What symbols to engrave?::    
 * Music representation::        
 * Example applications::        
-* About this manual::           
+* About the documentation::     
 @end menu
 
 
@@ -695,8 +695,8 @@ mezclar música y texto dentro de los documentos, en algo muy sencillo.
 
 
 
-@node About this manual
-@section About this manual
+@node About the documentation
+@section About the documentation
 
 
 Hay cuatro manuales de LilyPond: el @emph{Manual de aprendizaje}, la
diff --git a/Documentation/es/user/non-music.itely b/Documentation/es/user/non-music.itely
index 616ee5d705..9f4d0c67fc 100644
--- a/Documentation/es/user/non-music.itely
+++ b/Documentation/es/user/non-music.itely
@@ -116,7 +116,7 @@ Cartel de propósito general en el pie de página, centrado al final de la últi
 
 A continuación presentamos una demostración de todos los campos que
 están disponibles.  Fíjese en que puede utilizar en la cabecera
-cualquier instrucción de marcado de texto (Véase @ref{Text markup}).
+cualquier instrucción de marcado de texto (Véase @ref{Formatting text}).
 
 @lilypond[quote,verbatim,line-width=11.0\cm]
 \paper {
diff --git a/Documentation/es/user/notation-appendices.itely b/Documentation/es/user/notation-appendices.itely
index 06248d28c3..058490f592 100644
--- a/Documentation/es/user/notation-appendices.itely
+++ b/Documentation/es/user/notation-appendices.itely
@@ -199,7 +199,7 @@ donde N es un número entre 0 y 100.
 
 Los símbolos siguientes están disponibles en la tipografía Emmentaler y es posible acceder a ellos
 directamente utilizando elementos de marcado textual como @code{g^\markup @{
-\musicglyph #"scripts.segno" @}}, véase @ref{Text markup}.
+\musicglyph #"scripts.segno" @}}, véase @ref{Formatting text}.
 
 @lilypondfile[noindent]{font-table.ly}
 
diff --git a/Documentation/es/user/repeats.itely b/Documentation/es/user/repeats.itely
index 36e85530bb..9c5d68e89e 100644
--- a/Documentation/es/user/repeats.itely
+++ b/Documentation/es/user/repeats.itely
@@ -271,7 +271,7 @@ Imprimir una barra de compás @code{:|}
 @item @code{(volta @var{texto})}
 Imprimir un corchete de volta que diga @var{texto} El texto se puede
 especificar como una cadena de texto o como un texto de marcado,
-consulte @ref{Text markup}.  No olvide cambiar la fuente tipográfica,
+consulte @ref{Formatting text}.  No olvide cambiar la fuente tipográfica,
 porque el tipo por defecto para los números no contiene caracteres
 alfabéticos;
 
diff --git a/Documentation/es/user/rhythms.itely b/Documentation/es/user/rhythms.itely
index 8e0071f8d8..32d9b2de35 100644
--- a/Documentation/es/user/rhythms.itely
+++ b/Documentation/es/user/rhythms.itely
@@ -688,7 +688,7 @@ R1*2 | R1*5 | R1*9
 @cindex calderón sobre silencios multicompás
 
 Se pueden añadir textos a los silencios multicompás utilizando la sintaxis
-@var{nota}-@code{marca} de @ref{Text markup}.
+@var{nota}-@code{marca} de @ref{Formatting text}.
 Hay una variable (@code{\fermataMarkup}) para añadir
 calderones
 
diff --git a/Documentation/es/user/staff.itely b/Documentation/es/user/staff.itely
index bd86029eef..9bba466c4f 100644
--- a/Documentation/es/user/staff.itely
+++ b/Documentation/es/user/staff.itely
@@ -11,7 +11,7 @@
 @node Staff notation
 @section Staff notation
 
-staff = singular, staves = plural
+@lilypondfile[quote]{staff-headword.ly}
 
 @menu
 * Displaying staves::           
@@ -260,7 +260,7 @@ c4^\markup {
 @end lilypond
 
 @noindent
-Consulte @ref{Text markup} para ver más detalles.
+Consulte @ref{Formatting text} para ver más detalles.
 
 
 @seealso
diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely
index 1eb8067f1a..7182cbfb0f 100644
--- a/Documentation/es/user/text.itely
+++ b/Documentation/es/user/text.itely
@@ -11,6 +11,8 @@
 @node Text
 @section Text
 
+@lilypondfile[quote]{text-headword.ly}
+
 Esta sección explica cómo incluir texto (con diversos estilos de formateo) en las
 partituras.
 
@@ -20,25 +22,10 @@ sencillamente
 inserte los caracteres directamente en el archivo de lilypond.  El archivo se debe
 guardar como UTF-8.  Para ver más información, consulte @ref{Text encoding}.
 
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
 @menu
 * Writing text::                
-* Text markup::                 
+* Formatting text::             
+* Fonts::                       
 @end menu
 
 
@@ -60,7 +47,7 @@ c'4^\markup { bla \bold bla }
 @cindex texto, elementos no vacíos de
 @cindex no vacíos, textos
 
-Es posible colocar cadenas de texto arbitrarias o @ref{Text markup},
+Es posible colocar cadenas de texto arbitrarias o @ref{Formatting text},
 encima o debajo de las notas utilizando una cadena @code{c^"texto"}.  Por omisión,
 estas indicaciones no influyen sobre el espaciado de las notas, pero si se utiliza la
 instrucción @code{\textLengthOn}, las anchuras se tendrán en cuenta
@@ -80,7 +67,7 @@ c'4^\markup { bla \bold bla }
 @end lilypond
 
 La instrucción @code{\markup} se describe con más detalle en
-@ref{Text markup}.
+@ref{Formatting text}.
 
 
 @predefined
@@ -104,7 +91,7 @@ dichos cálculos; para habilitarlo, utilice
 
 @seealso
 
-En este manual: @ref{Text markup}.
+En este manual: @ref{Formatting text}.
 
 Referencia del programa: @rinternals{TextScript}.
 
@@ -473,14 +460,13 @@ boxf = \markup{ \bracket { \dynamic f } }
 
 
 
-@node Text markup
-@subsection Text markup
+@node Formatting text
+@subsection Formatting text
 
 @menu
 * Text markup introduction::    
 * Nested scores::               
 * Page wrapping text::          
-* Font selection::              
 @end menu
 
 @node Text markup introduction
@@ -664,6 +650,7 @@ a una expresión de marcado.  Dicha partitura debe contener un bloque
 
 @node Page wrapping text
 @subsubsection Page wrapping text
+
 Dondequiera que se utilice @code{\markup} para escribir un bloque de texto que no se deba dividir,
 se puede usar @code{\markuplines} en el nivel superior del código para introducir líneas de texto
 que se pueden extender sobre varias páginas:
@@ -697,8 +684,9 @@ En este manual: @ref{Text markup list commands},
 @funindex \markuplines
 @code{\markuplines}
 
-@node Font selection
-@subsubsection Font selection
+
+@node Fonts
+@subsection Fonts
 
 @cindex fuente tipográfica, selección de la
 @cindex fuente tipográfica, ampliación
diff --git a/Documentation/fr/user/editorial.itely b/Documentation/fr/user/editorial.itely
index c2bff9d9b6..1ce030ddeb 100644
--- a/Documentation/fr/user/editorial.itely
+++ b/Documentation/fr/user/editorial.itely
@@ -13,8 +13,7 @@
 @node Editorial annotations
 @section Editorial annotations
 
-@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
-{editorial-headword.ly}
+@lilypondfile[quote]{editorial-headword.ly}
 
 @menu
 * Inside the staff::            
diff --git a/Documentation/fr/user/expressive.itely b/Documentation/fr/user/expressive.itely
index 25f6c668e6..48e3323e00 100644
--- a/Documentation/fr/user/expressive.itely
+++ b/Documentation/fr/user/expressive.itely
@@ -15,6 +15,8 @@
 @node Expressive marks
 @section Expressive marks
 
+@lilypondfile[quote]{expressive-headword.ly}
+
 @menu
 * Attached to notes::           
 * Curves::                      
diff --git a/Documentation/fr/user/introduction.itely b/Documentation/fr/user/introduction.itely
index b3fdc8487d..baafad9472 100644
--- a/Documentation/fr/user/introduction.itely
+++ b/Documentation/fr/user/introduction.itely
@@ -18,12 +18,12 @@
 
 
 @menu
-* Engraving::         
-* Automated engraving::
+* Engraving::                   
+* Automated engraving::         
 * What symbols to engrave?::    
-* Music representation::      
-* Example applications::
-* About this manual::
+* Music representation::        
+* Example applications::        
+* About the documentation::     
 @end menu
 
 
@@ -741,8 +741,8 @@ musique et du texte dans les documents.
 
 
 
-@node About this manual
-@section About this manual
+@node About the documentation
+@section About the documentation
 
 Deux manuels traitent de LilyPond : le @emph{manuel de l'utilisateur}
 --- que vous lisez actuellement --- et le @emph{manuel d'utilisation du
diff --git a/Documentation/fr/user/repeats.itely b/Documentation/fr/user/repeats.itely
index e42b1640fb..640e181dee 100644
--- a/Documentation/fr/user/repeats.itely
+++ b/Documentation/fr/user/repeats.itely
@@ -14,9 +14,11 @@
 @node Repeats
 @section Repeats
 
-Une des notions essentielles, dans la musique, est le fait que des
-éléments soient joués plusieurs fois. Il existe de nombreuses façons
-de noter ces reprises.
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{repeats-headword.ly}
+
+La répétition est une notion essentielle en musique, et il existe de
+nombreuses façons de mettre en œuvre et noter ce concept.
 
 @menu
 * Writing repeats::             
@@ -240,7 +242,7 @@ Pour imprimer une barre de reprise @code{:|}
 @item @code{(volta @var{texte})}
 Pour imprimer un crochet indiquant une alternative.  L'argument
 @var{texte} mentionné dans le crochet peut être n'importe quelle chaîne
-de caractères ou indication textuelle --- voir @ref{Text markup}.
+de caractères ou indication textuelle --- voir @ref{Formatting text}.
 Attention cependant à changer la police, car la police employée par
 défaut pour les chiffres ne contient aucun caractère alphabétique.
 
diff --git a/Documentation/fr/user/rhythms.itely b/Documentation/fr/user/rhythms.itely
index b8582a636d..bc89185bb7 100644
--- a/Documentation/fr/user/rhythms.itely
+++ b/Documentation/fr/user/rhythms.itely
@@ -14,6 +14,8 @@
 @node Rhythms
 @section Rhythms
 
+@lilypondfile[quote]{rhythms-headword.ly}
+
 This section discusses rhythms, durations, and bars.
 
 @menu
@@ -457,7 +459,7 @@ R1*2 | R1*5 | R1*9
 @cindex point d'orgue et silence multi-measures
 
 Vous pouvez aussi ajouter du texte à un silence multi-mesures en utilisant
-la syntaxe @var{note}-@code{markup} (cf. @ref{Text markup}).  La
+la syntaxe @var{note}-@code{markup} (cf. @ref{Formatting text}).  La
 variable @code{\fermataMarkup} permet d'ajouter un point d'orgue.
 
 @lilypond[quote,ragged-right,verbatim,fragment]
diff --git a/Documentation/fr/user/simultaneous.itely b/Documentation/fr/user/simultaneous.itely
index 588d3c0796..b6aef420d6 100644
--- a/Documentation/fr/user/simultaneous.itely
+++ b/Documentation/fr/user/simultaneous.itely
@@ -14,6 +14,8 @@
 @node Simultaneous notes
 @section Simultaneous notes
 
+@lilypondfile[quote]{simultaneous-headword.ly}
+
 La notion musicale de polyphonie fait référence au fait d'avoir plus
 d'une voix simultanément dans une pièce.  Dans LilyPond, la notion de
 polyphonie fait référence au fait d'avoir plus d'une voix sur la même
diff --git a/Documentation/fr/user/staff.itely b/Documentation/fr/user/staff.itely
index 1d08bbca78..b3094a786f 100644
--- a/Documentation/fr/user/staff.itely
+++ b/Documentation/fr/user/staff.itely
@@ -14,6 +14,13 @@
 @node Staff notation
 @section Staff notation
 
+@lilypondfile[quote]{staff-headword.ly}
+
+Cette section aborde les détails de gravure de la portée, la
+réalisation de partitions avec plusieurs portées et l'ajout
+d'indications globales d'exécution, présentes sur certaines portées
+seulement.
+
 @menu
 * Displaying staves::           
 * Writing parts::               
@@ -278,7 +285,7 @@ c4^\markup {
 @end lilypond
 
 @noindent
-Pour plus de détails, voir @ref{Text markup}.
+Pour plus de détails, voir @ref{Formatting text}.
 
 
 @seealso
diff --git a/Documentation/fr/user/text.itely b/Documentation/fr/user/text.itely
index 67b49fa684..51ec380c35 100644
--- a/Documentation/fr/user/text.itely
+++ b/Documentation/fr/user/text.itely
@@ -14,8 +14,10 @@
 @node Text
 @section Text
 
-Nous allons voir ici comment insérer du texte, selon différents
-formatages, dans vos partitions.
+@lilypondfile[quote]{text-headword.ly}
+
+Nous allons voir ici comment insérer dans une partition du texte, avec
+différentes possibilité de formatage.
 
 @cindex Texte, autres langues
 Pour écrire des accents et autres caractères spéciaux, il suffit de
@@ -23,25 +25,10 @@ les insérer directement dans votre fichier LilyPond.  Ce fichier devra
 être sauvegardé avec l'encodage UTF-8.  Pour plus d'informations, voir
 @ref{Text encoding}.
 
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-@lilypond[fragment,ragged-right,staffsize=16,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
 @menu
 * Writing text::                
-* Text markup::                 
+* Formatting text::             
+* Fonts::                       
 @end menu
 
 
@@ -69,7 +56,7 @@ c'4^\markup { bla \bold bla }
 @cindex ajout de texte
 
 Vous pouvez placer arbitrairement des chaînes de caractères, ou
-@ref{Text markup} en langage LilyPond, au dessus ou au dessous des
+@ref{Formatting text} en langage LilyPond, au dessus ou au dessous des
 notes en employant la syntaxe @code{c^"text"}.  Par défaut, ces
 indications n'affecteront en rien l'espacement des notes, sauf à
 utiliser la commande @code{\textLengthOn}.
@@ -89,7 +76,7 @@ c'4^\markup { bla \bold bla }
 @end lilypond
 
 La commande @code{\markup} est décrite plus en détails dans la section
-@ref{Text markup}.
+@ref{Formatting text}.
 
 
 @predefined
@@ -114,7 +101,7 @@ Vous pouvez cependant l'y forcer en définissant
 
 @seealso
 
-Dans ce manuel : @ref{Text markup}.
+Dans ce manuel : @ref{Formatting text}.
 
 Référence du programme : @rinternals{TextScript}.
 
@@ -496,14 +483,13 @@ boxf = \markup{ \bracket { \dynamic f } }
 
 
 
-@node Text markup
-@subsection Text markup
+@node Formatting text
+@subsection Formatting text
 
 @menu
 * Text markup introduction::    
 * Nested scores::               
 * Page wrapping text::          
-* Font selection::              
 @end menu
 
 @node Text markup introduction
@@ -740,8 +726,8 @@ Dans ce manuel : @ref{Text markup list commands},
 @code{\markuplines}
 
 
-@node Font selection
-@unnumberedsubsubsec Font selection
+@node Fonts
+@subsection Fonts
 
 @cindex sélection de polices
 @cindex grossissement des polices
diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely
index 3dc0e66958..b7a2ca5569 100644
--- a/Documentation/fr/user/tutorial.itely
+++ b/Documentation/fr/user/tutorial.itely
@@ -1597,4 +1597,4 @@ partition.  La source exacte utilisée pour générer ce manuel s'affichera
 alors.
 
 Pour en savoir plus sur l'organisation de la suite de ce manuel,
-reportez-vous à @ref{About this manual}.
+reportez-vous à @ref{About the documentation}.
-- 
2.39.5