From 0676de388a138fa0260d614d5afeeb94e25fb5b9 Mon Sep 17 00:00:00 2001
From: John Mandereau <john.mandereau@gmail.com>
Date: Thu, 8 May 2008 13:59:43 +0200
Subject: [PATCH] Fix a truckload of docs cross-references using the new script

---
 Documentation/de/user/ancient.itely           |  2 +-
 Documentation/de/user/expressive.itely        |  7 ++
 Documentation/de/user/fretted-strings.itely   | 20 +++---
 Documentation/de/user/fundamental.itely       |  6 +-
 Documentation/de/user/introduction.itely      | 28 ++++----
 Documentation/de/user/keyboards.itely         |  2 +-
 .../de/user/notation-appendices.itely         | 72 ++++++++++++++++---
 Documentation/de/user/pitches.itely           | 46 ++++++++++++
 Documentation/de/user/repeats.itely           |  2 +-
 Documentation/de/user/rhythms.itely           |  6 ++
 Documentation/de/user/simultaneous.itely      |  2 +-
 Documentation/de/user/tutorial.itely          |  4 +-
 Documentation/de/user/tweaks.itely            |  6 +-
 Documentation/de/user/working.itely           | 20 +++---
 Documentation/es/user/ancient.itely           |  2 +-
 Documentation/es/user/changing-defaults.itely |  4 +-
 Documentation/es/user/editorial.itely         |  2 +-
 Documentation/es/user/fretted-strings.itely   |  2 +-
 Documentation/es/user/fundamental.itely       |  4 +-
 Documentation/es/user/keyboards.itely         | 21 +++---
 .../es/user/notation-appendices.itely         | 14 ++--
 Documentation/es/user/percussion.itely        |  2 +-
 Documentation/es/user/pitches.itely           |  2 +-
 Documentation/es/user/specialist.itely        |  3 +
 Documentation/es/user/templates.itely         |  2 +-
 Documentation/es/user/text.itely              | 12 ++--
 Documentation/es/user/tutorial.itely          | 14 ++--
 Documentation/es/user/tweaks.itely            |  2 +-
 Documentation/es/user/vocal.itely             |  6 +-
 Documentation/es/user/working.itely           |  4 +-
 Documentation/fr/user/ancient.itely           |  2 +-
 Documentation/fr/user/changing-defaults.itely |  4 +-
 Documentation/fr/user/fretted-strings.itely   |  4 +-
 Documentation/fr/user/fundamental.itely       |  8 +--
 Documentation/fr/user/introduction.itely      | 22 +++---
 Documentation/fr/user/keyboards.itely         |  4 +-
 .../fr/user/notation-appendices.itely         | 17 ++---
 Documentation/fr/user/simultaneous.itely      |  2 +-
 Documentation/fr/user/text.itely              | 12 ++--
 Documentation/fr/user/tutorial.itely          | 30 ++++----
 Documentation/fr/user/tweaks.itely            |  6 +-
 Documentation/fr/user/vocal.itely             |  6 +-
 Documentation/fr/user/working.itely           | 22 +++---
 Documentation/user/keyboards.itely            |  4 +-
 Documentation/user/rhythms.itely              |  4 +-
 Documentation/user/spacing.itely              | 10 +--
 46 files changed, 289 insertions(+), 187 deletions(-)

diff --git a/Documentation/de/user/ancient.itely b/Documentation/de/user/ancient.itely
index cf7e3a2e01..ad7b0f2e3d 100644
--- a/Documentation/de/user/ancient.itely
+++ b/Documentation/de/user/ancient.itely
@@ -2092,7 +2092,7 @@ gesetzt, verminderte Quinten und Septimen mit @code{5/} und @code{7/}.
 
 Pausen können mit @code{_} notiert werden. Klammern werden mit @code{[}
 und @code{]} gesetzt. Text kann auch eingefügt werden nach den Regeln im 
-Abschnitt @ref{Overview of text markup commands}.
+Abschnitt @ref{Text markup commands}.
 
 @example
 < [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
diff --git a/Documentation/de/user/expressive.itely b/Documentation/de/user/expressive.itely
index a7e8afc12c..ec6f9efcde 100644
--- a/Documentation/de/user/expressive.itely
+++ b/Documentation/de/user/expressive.itely
@@ -25,6 +25,7 @@
 @menu
 * Articulations::               
 * Dynamics::                    
+* New dynamic marks::           
 @end menu
 
 @node Articulations
@@ -299,6 +300,12 @@ Vertikale Positionierung der Symbole wird von der Eigenschaft
 @internalsref{DynamicLineSpanner} verwaltet.
 
 
+@node New dynamic marks
+@subsubsection New dynamic marks
+
+UNTRANSLATED NODE: IGNORE ME
+
+
 @node Curves
 @subsection Curves
 
diff --git a/Documentation/de/user/fretted-strings.itely b/Documentation/de/user/fretted-strings.itely
index 58c9b103fe..f63579dc28 100644
--- a/Documentation/de/user/fretted-strings.itely
+++ b/Documentation/de/user/fretted-strings.itely
@@ -270,15 +270,15 @@ erwünschte Akkordtabulatur, wie das folgende Beispiel zeigt:
 }
 @end lilypond
 
-Es gibt drei Modi für die Abbildung der Tabulatur: den Standardmodus, 
-einen ausführlichen Modus und einen knappen Modus. Die unterschiedlichen 
-Modi werden angewählt, indem an den Befehl @code{fret-diagram} die Begriffe
-@code{-standard}, @code{-verbose} bzw. @code{-terse} angehängt werden.
-Die Modi produzieren gleichwertige Ausgaben, haben aber unterschiedliche 
-Informationen im Beschriftungsbefehl. Details über die 
-Beschriftungsbefehle finden sich im Abschnitt 
- @ref{Overview of text markup commands}. Alle drei Modi werden im obigen 
- Beispiel gezeigt.
+Es gibt drei Modi für die Abbildung der Tabulatur: den Standardmodus,
+einen ausführlichen Modus und einen knappen Modus. Die
+unterschiedlichen Modi werden angewählt, indem an den Befehl
+@code{fret-diagram} die Begriffe @code{-standard}, @code{-verbose}
+bzw. @code{-terse} angehängt werden.  Die Modi produzieren
+gleichwertige Ausgaben, haben aber unterschiedliche Informationen im
+Beschriftungsbefehl. Details über die Beschriftungsbefehle finden sich
+im Abschnitt @ref{Text markup commands}. Alle drei Modi werden im
+obigen Beispiel gezeigt.
 
 Einige graphische Eigenschaften können verändert werden. Genaueres zur 
 Schnittstelle für die Griffsymboleigenschaften findet sich unter 
@@ -369,7 +369,7 @@ zu signalisieren, dass der Gitarrist eine Note oder einen Akkord spielen
 soll, indem seine Finger die Saiten nur berühren, anstatt sie vollständig 
 herunterzudrücken. Damit werden schlagzeugartige Geräusche erreicht, 
 die aber noch die ursprüngliche Tonhöhe ahnen lassen. Diese Spielart 
-wird mit Kreuz-Notenköpfen notiert, wie im Abschnitt @ref{Special noteheads}
+wird mit Kreuz-Notenköpfen notiert, wie im Abschnitt @ref{Special note heads}
 gezeigt.
 
 
diff --git a/Documentation/de/user/fundamental.itely b/Documentation/de/user/fundamental.itely
index 14e4e6c3d7..f2ba1c1c50 100644
--- a/Documentation/de/user/fundamental.itely
+++ b/Documentation/de/user/fundamental.itely
@@ -135,7 +135,7 @@ vorkommt. Die Namen sind frei wählbar, die Variable kann genauso
 gut  @code{melodie}, @code{GLOBAL},
 @code{rechteHandklavier}, oder @code{foofoobarbaz} heißen. Für mehr
 Information siehe
-@ruser{Saving typing with identifiers and functions}.
+@ref{Saving typing with variables and functions}.
 
 Eine komplette Definition des Eingabeformats findet sich
 im Kapitel @ruser{File structure}.
@@ -155,7 +155,7 @@ UNTRANSLATED NODE: IGNORE ME
 @node Score is a (single) compound musical expression
 @subsection Score is a (single) compound musical expression
 
-Im vorigen Kapitel, @ruser{How LilyPond files work}, 
+Im vorigen Kapitel, @ref{How LilyPond files work}, 
 wurde die allgemeine Struktur einer LilyPond-Quelldatei 
 beschrieben. Aber anscheinend haben wir die wichtigste 
 Frage ausgelassen, nämlich wie man herausfindet, was nach 
@@ -172,7 +172,7 @@ von einem einzelnen musikalischen Ausdruck.}
 
 @noindent
 Vielleicht wollen Sie noch einmal 
-@ruser{Music expressions explained} überfliegen. In diesem
+@ref{Music expressions explained} überfliegen. In diesem
 Kapitel wurde gezeigt, wie sich große musikalische Ausdrücke 
 aus kleinen Teilen zusammensetzen. Noten können zu Akkorden 
 verbunden werden usw. Jetzt gehen wir aber in die andere Richtung 
diff --git a/Documentation/de/user/introduction.itely b/Documentation/de/user/introduction.itely
index e9575498bb..84f0c99aab 100644
--- a/Documentation/de/user/introduction.itely
+++ b/Documentation/de/user/introduction.itely
@@ -751,7 +751,7 @@ stellt eine einfache Einführung in den Musiksatz dar. Neulinge sollten hiermit
 beginnen.
 
 @item
-@emph{@ref{Putting it all together}},
+@emph{@ref{Fundamental concepts}},
 erklärt generelle Konzepte des LilyPond-Dateiformates. Wenn Sie sich nicht 
 sicher sind, wohin ein Befehl gesetzt werden soll, lesen Sie hier nach.
 
@@ -776,36 +776,32 @@ Grundkonzeption des Programmes im Handbuch zum Lernen bekannt gemacht hat.
 @itemize @bullet
 
 @item
-@emph{@ref{Basic notation}},
+@emph{@ruser{Musical notation}},
 erklärt alles über die grundlegenden Notationskonstruktionen. Dieses Kapitel 
-ist für fast jedes Notationsprojekt  nützlich.
+ist für fast jedes Notationsprojekt nützlich.
 
 @item
-@emph{@ref{Instrument-specific notation}},
+@emph{@ruser{Specialist notation}},
 erklärt spezifische Schwierigkeiten, die sich bei bestimmten Notationstypen 
 ergeben. Dieses Kapitel ist nur in entsprechenden Fällen bestimmter Instrumente 
 oder bei Gesang zu konsultieren.
 
 @item
-@emph{@ref{Advanced notation}},
-erklärt komplizierte oder unübliche Anwendungen nach Notationsgegenstand geordnet.
-
-@item
-@emph{@ref{Changing defaults}},
+@emph{@ruser{Changing defaults}},
 erklärt, wie des Layout getrimmt werden kann.
 
 @item
-@emph{@ref{Non-musical notation}},
+@emph{@ruser{Non-musical notation}},
 zeigt alles, was nicht direkt mit den Noten zu tun hat wie Titel, mehrere Sätze oder 
 wie man ein MIDI-Instrument auswählt.
 
 @item
-@emph{@ref{Spacing issues}},
+@emph{@ruser{Spacing issues}},
 befasst sich mit globalen Fragen wie der Definition von Papierformaten 
 oder wie man Seitenumbrüche definiert.
 
 @item
-@emph{@ref{Interfaces for programmers}},
+@emph{@ruser{Interfaces for programmers}},
 demonstriert die Erstellung von musikalischen Funktionen.
 
 @end itemize
@@ -820,7 +816,7 @@ In diesem Buch werden nützliche Referenztabellen gezeigt.
 @ifhtml
 Die
 @end ifhtml
-@emph{@ref{Literature list}},
+@emph{@ruser{Literature list}},
 enthält einige wichtige Quellen für alle, die mehr über Notation und 
 den Notensatz erfahren wollen.
 
@@ -831,7 +827,7 @@ stellt eine kurze Einleitung in die Scheme-Sprache dar, mit dem
 die musikalischen Funktionen gebildet werden.
 
 @item
-@emph{@ref{Notation manual tables}},
+@emph{@ruser{Notation manual tables}},
 sind Tabellen, in denen Akkordbezeichnungen, MIDI-Instrumente, 
 Farbbezeichnungen und die Zeichen der Feta-Schriftart gesammelt sind.
 
@@ -842,12 +838,12 @@ ein und schreiben Sie noch die Noten dazu. Das ist alles!
 
 @item
 Die
-@emph{@ref{Cheat sheet}},
+@emph{@ruser{Cheat sheet}},
 zeigt die wichtigsten LilyPond-Befehle.
 
 @item
 Der
-@emph{@ref{LilyPond command index}},
+@emph{@ruser{LilyPond command index}},
 listet alle Befehle auf, die mit @code{\} anfangen.
 
 @item
diff --git a/Documentation/de/user/keyboards.itely b/Documentation/de/user/keyboards.itely
index 36fff71350..fd38d73776 100644
--- a/Documentation/de/user/keyboards.itely
+++ b/Documentation/de/user/keyboards.itely
@@ -149,7 +149,7 @@ wird die Richtung auch über Pausen hinweg im Voraus bestimmt.
 
 @seealso
 
-Im Handbuch: @ref{Manual staff switches}.
+Im Handbuch: @rlearning{Single staff}.
 
 Programmreferenz: @internalsref{AutoChangeMusic}.
  
diff --git a/Documentation/de/user/notation-appendices.itely b/Documentation/de/user/notation-appendices.itely
index 26d4615903..915a85f137 100644
--- a/Documentation/de/user/notation-appendices.itely
+++ b/Documentation/de/user/notation-appendices.itely
@@ -18,6 +18,13 @@
 * List of colors::              
 * The Feta font::               
 * Note head styles::            
+* Text markup commands::        
+* Text markup list commands::   
+* List of articulations::       
+* All context properties::      
+* Layout properties::           
+* Identifiers::                 
+* Scheme functions::            
 @end menu
 
 @node Chord name chart
@@ -199,7 +206,7 @@ Die folgenden Symbole sind als Emmentaler-Schriftart verfügbar; auf sie
 kann direkt zugegriffen werden, indem man die übliche Textbeschriftung 
 benutzt. @code{\musicglyph} greift direkt auf die Notationsschriftart 
 zu (bspw. @code{g^\markup @{
-\musicglyph #"scripts.segno" @}}). Siehe auch @ref{Text markup}.
+\musicglyph #"scripts.segno" @}}). Siehe auch @ref{Formatting text}.
 
 @lilypondfile[noindent]{font-table.ly}
 
@@ -215,16 +222,63 @@ Folgende Stile können zur Darstellung der Notenköpfe verwendet werden:
 
 @lilypondfile[noindent]{note-head-style.ly}
 
-@ignore
-@n ode All context properties
-@a ppendixsec All context properties
+@include markup-commands.tely
 
-@i nclude context-properties.tely
+@include markup-list-commands.tely
 
+@node List of articulations
+@appendixsec List of articulations
 
-@n ode Layout properties
-@ap pendixsec Layout properties
+@cindex Akzent
+@cindex Marcato
+@cindex Staccatissimo
+@cindex Espressivo
+@cindex Fermate
+@cindex Gedämpft
+@cindex Staccato
+@cindex Portato
+@cindex Tenuto
+@cindex Aufstrich
+@cindex Abstrich
+@cindex Fußbezeichnung
+@cindex Orgelpedalbezeichnung
+@cindex Triller
+@cindex Offen
+@cindex Flageolet
+@cindex Praller
+@cindex Mordent
+@cindex Doppelpraller
+@cindex Prallermordent
+@cindex Fingersatz
+@cindex Daumenbezeichnung
+@cindex Segno
+@cindex Coda
+@cindex Varcoda
 
-@in clude layout-properties.tely
+Hier ist eine Liste, die alle möglichen Zeichen darstellt:
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+@node All context properties
+@appendixsec All context properties
+
+@include context-properties.tely
+
+
+@node Layout properties
+@appendixsec Layout properties
+
+@include layout-properties.tely
+
+
+@node Identifiers
+@appendixsec Identifiers
+
+@include identifiers.tely
+
+
+@node Scheme functions
+@appendixsec Scheme functions
+
+@include scheme-functions.tely
 
-@end ignore
diff --git a/Documentation/de/user/pitches.itely b/Documentation/de/user/pitches.itely
index ba6bf2faa3..bb12574320 100644
--- a/Documentation/de/user/pitches.itely
+++ b/Documentation/de/user/pitches.itely
@@ -17,6 +17,7 @@ This section discusses how to specify the pitch of notes.
 * Writing pitches::             
 * Changing multiple pitches::   
 * Displaying pitches::          
+* Note heads::                  
 @end menu
 
 
@@ -540,6 +541,8 @@ innerhalb von @code{\transpose} befinden.
 * Key signature::               
 * Ottava brackets::             
 * Instrument transpositions::   
+* Automatic accidentals::       
+* Ambitus::                     
 @end menu
 
 @node Clef
@@ -740,3 +743,46 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
+
+@node Automatic accidentals
+@unnumberedsubsubsec Automatic accidentals
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Note heads
+@subsection Note heads
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu
+* Special note heads::          
+* Easy notation note heads::    
+* Shape note heads::            
+* Improvisation::               
+@end menu
+
+@node Special note heads
+@unnumberedsubsubsec Special note heads
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Easy notation note heads
+@unnumberedsubsubsec Easy notation note heads
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Shape note heads
+@unnumberedsubsubsec Shape note heads
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Improvisation
+@unnumberedsubsubsec Improvisation
+
+UNTRANSLATED NODE: IGNORE ME
diff --git a/Documentation/de/user/repeats.itely b/Documentation/de/user/repeats.itely
index 5eb6faf016..63549e5e97 100644
--- a/Documentation/de/user/repeats.itely
+++ b/Documentation/de/user/repeats.itely
@@ -236,7 +236,7 @@ Setzt eine @code{:|} Taktlinie.
 @item @code{(volta @var{text})}
 Setzt eine Volta-Klammer mit der Beschriftung @var{text}: Der Text 
 kann definiert werden als Textstring oder formatierter Text, siehe 
-Abschnitt @ref{Text markup}. Es darf nicht vergessen werden, die 
+Abschnitt @ref{Formatting text}. Es darf nicht vergessen werden, die 
 Schriftart zu verändern, weil die Standardschriftart für die Nummern 
 keine Buchstaben enthält.
 
diff --git a/Documentation/de/user/rhythms.itely b/Documentation/de/user/rhythms.itely
index 00a5afb8c0..0a61ccbcbc 100644
--- a/Documentation/de/user/rhythms.itely
+++ b/Documentation/de/user/rhythms.itely
@@ -655,6 +655,7 @@ Programmreferenz: @internalsref{Completion_heads_engraver}.
 * Automatic beams::             
 * Manual beams::                
 * Feathered beams::             
+* Setting automatic beam behavior::  
 @end menu
 
 @node Automatic beams
@@ -778,6 +779,11 @@ Balken vermeiden nicht andere Objekte, wie etwa Text und Versetzungszeichen.
 
 UNTRANSLATED NODE: IGNORE ME
 
+@node Setting automatic beam behavior
+@unnumberedsubsubsec Setting automatic beam behavior
+
+UNTRANSLATED NODE: IGNORE ME
+
 
 @node Bars
 @subsection Bars
diff --git a/Documentation/de/user/simultaneous.itely b/Documentation/de/user/simultaneous.itely
index 5dc94d016e..969a83dcd1 100644
--- a/Documentation/de/user/simultaneous.itely
+++ b/Documentation/de/user/simultaneous.itely
@@ -45,7 +45,7 @@ einfachen Noten.
 <c e g>4 <c>8
 @end lilypond
 
-Siehe @ref{Chord names} für mehr Information.
+Siehe @ref{Chord notation} für mehr Information.
 
 
 @node Clusters
diff --git a/Documentation/de/user/tutorial.itely b/Documentation/de/user/tutorial.itely
index 838177ac67..b72ead7ab2 100644
--- a/Documentation/de/user/tutorial.itely
+++ b/Documentation/de/user/tutorial.itely
@@ -947,7 +947,7 @@ also hat eine Triole 2/3 als Bruch:
 @cindex Vorhalt
 @subheading Grace notes
 
-Glossar: @rglos{grace notes}, @rglos{acciacccatura},
+Glossar: @rglos{grace notes}, @rglos{acciaccatura},
 @rglos{appoggiatura}.
 
 Verzierungen werden mit dem Befehl @code{\grace}
@@ -1217,7 +1217,7 @@ oder auch zwischen System gesetzt werden.
 
 @seealso
 
-Benutzerhandbuch: @ruser{Piano music}, 
+Benutzerhandbuch: @ruser{Keyboard instruments},
 @ruser{Displaying staves}.
 
 
diff --git a/Documentation/de/user/tweaks.itely b/Documentation/de/user/tweaks.itely
index 004900045c..f899f4cbe3 100644
--- a/Documentation/de/user/tweaks.itely
+++ b/Documentation/de/user/tweaks.itely
@@ -167,13 +167,13 @@ c4^"piu mosso" d e f
 
 @seealso
 
-@ruser{The \override command}, @ruser{Common tweaks}.
+@ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
 @section Fixing overlapping notation
 
-Im Kapitel @ruser{Moving objects} wurde gezeigt, wie man Texte 
+Im Kapitel @ref{Moving objects} wurde gezeigt, wie man Texte 
 (@code{TextScript}-Objekte) verschiebt. Mit der gleichen 
 Technik können auch andere Objektklassen verschoben werden, 
 @code{TextScript} muss dann nur durch den Namen des Objektes 
@@ -482,7 +482,7 @@ werden kann, indem man Befehle wie
 @code{\override TextScript #'extra-offset = ( 1 . -1)} benutzt. Aber 
 noch mehr Einfluss auf die Formatierung kann durch den Einsatz von 
 Scheme genommen werden. Eine vollständige Erklärung findet sich in der 
- @ruser{Scheme tutorial} und den
+ @ref{Scheme tutorial} und den
 @ruser{Interfaces for programmers}.
 
 Scheme kann benutzt werden, um einfach nur Befehle zu @qq{überschreiben} 
diff --git a/Documentation/de/user/working.itely b/Documentation/de/user/working.itely
index 04e6c8e8d2..04fde42241 100644
--- a/Documentation/de/user/working.itely
+++ b/Documentation/de/user/working.itely
@@ -119,9 +119,9 @@ ersparen Sie sich viele Probleme, wenn Sie ihre Musik
 eines Tages umarrangieren wollen.
 
 @item @strong{Trennen Sie Einstellungen} von den eigentlichen 
-Noten. Siehe auch @ruser{Saving typing with identifiers and functions} 
+Noten. Siehe auch @ref{Saving typing with variables and functions} 
 und
-@ruser{Style sheets}.
+@ref{Style sheets}.
 
 @end itemize
 
@@ -182,7 +182,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Trennen Sie Einstellungen von den Noten}.  Diese 
-Empfehlung wurde schon im Abschnitt @ruser{General suggestions} gegeben, 
+Empfehlung wurde schon im Abschnitt @ref{General suggestions} gegeben, 
 aber für große Projekte ist es unumgänglich. Muss z. B. die 
 Definition für @code{fdannp} verändert werden, so braucht 
 man es nur einmal vorzunehmen und die Noten in der Geigenstimme, 
@@ -298,9 +298,9 @@ padText =
 
 Die Benutzung von Variablen hilft auch, viele Schreibarbeit zu 
 vermeiden, wenn die Eingabesyntax von LilyPond sich verändert 
-(siehe auch @ruser{Updating old files}). Wenn nur eine einzige 
+(siehe auch @ref{Updating old files}). Wenn nur eine einzige 
 Definition (etwa @code{\dolce}) für alle Dateien verwendet wird 
-(vgl. @ruser{Style sheets}), muss nur diese einzige Definition 
+(vgl. @ref{Style sheets}), muss nur diese einzige Definition 
 verändert werden, wenn sich die Syntax ändert. Alle Verwendungen 
 des Befehles beziehen sich dann auf die neue Definition.
 
@@ -308,14 +308,14 @@ des Befehles beziehen sich dann auf die neue Definition.
 @subsection Style sheets
 
 Die Ausgabe, die LilyPond erstellt, kann sehr stark modifiziert 
-werden, siehe @ruser{Tweaking output} für Einzelheiten. Aber wie 
+werden, siehe @ref{Tweaking output} für Einzelheiten. Aber wie 
 kann man diese Änderungen auf eine ganze Serie von Dateien 
 anwenden? Oder die Einstellungen von den Noten trennen? Das 
 Verfahren ist ziemlich einfach.
 
 Hier ist ein Beispiel. Es ist nicht schlimm, wenn Sie nicht auf 
 Anhieb die Abschnitte mit den ganzen @code{#()} verstehen. Das 
-wird im Kapitel @ruser{Advanced tweaks with Scheme} erklärt.
+wird im Kapitel @ref{Advanced tweaks with Scheme} erklärt.
 
 @lilypond[quote,verbatim,ragged-right]
 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@@ -336,7 +336,7 @@ tempoMark = #(define-music-function (parser location markp) (string?)
 @end lilypond
 
 Es treten einige Probleme mit überlappenden Symbolen auf. Sie 
-werden beseitigt mit den Tricks aus dem Kapitel @ruser{Moving objects}.
+werden beseitigt mit den Tricks aus dem Kapitel @ref{Moving objects}.
 Aber auch die @code{mpdolce} und @code{tempoMark}-Definitionen 
 können verbessert werden. Sie produzieren das Ergebnis, das 
 gewünscht ist, aber es wäre schön, sie auch in anderen Stücken 
@@ -664,7 +664,7 @@ Bassstimme wieder hineinzunehmen, bis Sie die problematische
 Zeile finden.
 
 Eine andere nützliche Technik zur Problemlösung ist es, 
-@ruser{Minimal examples} zu konstruieren.
+@ref{Minimal examples} zu konstruieren.
 
 
 @node Minimal examples
@@ -840,7 +840,7 @@ Und mit LilyPond übersetzt:
 
 Tiefer gehende Information darüber, wie Stimmauszüge und Partituren 
 erstellt werden, finden sich im Notationshandbuch, siehe 
-@ruser{Orchestral music}.
+@ref{Scores and parts}.
 
 Das Setzen der Variablen, die das Verhalten von LilyPond beeinflussen 
 (@q{properties}), wird im Kapitel
diff --git a/Documentation/es/user/ancient.itely b/Documentation/es/user/ancient.itely
index 9a278a2688..16ab26fbb1 100644
--- a/Documentation/es/user/ancient.itely
+++ b/Documentation/es/user/ancient.itely
@@ -2062,7 +2062,7 @@ quintas y séptimas disminuidas se pueden obtener con @code{5/} y @code{7/}.
 
 Se pueden insertar espacios mediante el uso de @code{_}.  Los corchetes se
 escriben con @code{[} y @code{]}. También puede incluir cadenas de
-texto y elementos de marcado textuales, consulte @ref{Overview of text markup commands}.
+texto y elementos de marcado textuales, consulte @ref{Text markup commands}.
 
 @example
 < [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
diff --git a/Documentation/es/user/changing-defaults.itely b/Documentation/es/user/changing-defaults.itely
index 2f8ab8d409..da8993e8ea 100644
--- a/Documentation/es/user/changing-defaults.itely
+++ b/Documentation/es/user/changing-defaults.itely
@@ -488,7 +488,7 @@ En el segundo pentagrama no hay indicación de compás ni clave.  Ésta es
 una forma un poco fuerte de hacer desaparecer objetos, porque afectará
 al pentagrama completo.  Este método también influye en el espaciado, lo que podría ser
 deseable o no.  Un método más
-sofisticado de borrar objetos se muestra en @rlearning{Common tweaks}.
+sofisticado de borrar objetos se muestra en @rlearning{Further tweaking}.
 
 El ejemplo siguiente muestra una aplicación práctica.  Las líneas divisorias y las indicaciones
 de compás están normalmente sincronizadas en toda la partitura.  Esto se hace
@@ -1162,7 +1162,7 @@ sí se pueden modificar.
 
 Hemos estado hablando de @emph{el} objeto @code{Fingering}, pero realmente esto no significa
 mucho.  El archivo de inicialización (véase
-@rlearning{Default files})
+@ref{File structure})
 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
 
 @example
diff --git a/Documentation/es/user/editorial.itely b/Documentation/es/user/editorial.itely
index ea3c74b523..fbdb3eb9b5 100644
--- a/Documentation/es/user/editorial.itely
+++ b/Documentation/es/user/editorial.itely
@@ -49,7 +49,7 @@ de notación.  Esto no cambia el tamaño de los símbolos variables, como
 las barras de corchea o las ligaduras.
 
 @warning{Para los tamaños de tipografía del @strong{texto}, consulte
-@ref{Common markup commands}.}
+@ref{Text markup list commands}.}
 
 @lilypond[quote,fragment,relative=2,verbatim,ragged-right]
 \huge
diff --git a/Documentation/es/user/fretted-strings.itely b/Documentation/es/user/fretted-strings.itely
index f633b4acb6..cfab53a48a 100644
--- a/Documentation/es/user/fretted-strings.itely
+++ b/Documentation/es/user/fretted-strings.itely
@@ -263,7 +263,7 @@ ejemplo siguiente
 Existen tres interfaces distintos para el marcado de los diagramas de trastes: estándar, escueto
 y prolijo.  Los tres interfaces producen unos elementos de marcado equivalentes, pero tienen
 cantidades variables de información en la cadena de marcado.  Se pueden encontrar
-más detalles sobre los interfaces de marcado en @ref{Overview of text markup commands}.
+más detalles sobre los interfaces de marcado en @ref{Text markup commands}.
 
 Puede establecer un cierto número de propiedades gráficas según su elección.
 Se pueden encontrar más detalles sobre el interface de las propiedades de los diagramas de trastes en
diff --git a/Documentation/es/user/fundamental.itely b/Documentation/es/user/fundamental.itely
index bea56c9c9b..953ebad933 100644
--- a/Documentation/es/user/fundamental.itely
+++ b/Documentation/es/user/fundamental.itely
@@ -193,7 +193,7 @@ consulte @ruser{File structure}.
 @cindex expresión musical compuesta
 @cindex música, expresión compuesta de
 
-En la sección anterior, @ruser{How LilyPond files work} hemos podido
+En la sección anterior, @ref{How LilyPond files work} hemos podido
 ver la organización general de los archivos de entrada de LilyPond.
 Pero parece que nos saltamos la parte más importante: ¿cómo
 averiguamos qué escribir después de @code{\score}?
@@ -207,7 +207,7 @@ todo:
 @end quotation
 
 @noindent
-Quizá encuentre útil dar un repaso a @ruser{Music expressions
+Quizá encuentre útil dar un repaso a @ref{Music expressions
 explained}.  En esta sección, vimos cómo elaborar grandes expresiones
 musicales a partir de pequeñas piezas (comenzábamos con notas, luego
 acordes, etc.).  Ahora partiremos de una gran expresión musical y
diff --git a/Documentation/es/user/keyboards.itely b/Documentation/es/user/keyboards.itely
index 915d5dcad2..1cb45c78d1 100644
--- a/Documentation/es/user/keyboards.itely
+++ b/Documentation/es/user/keyboards.itely
@@ -13,18 +13,21 @@
 @section Keyboard instruments
 
 @menu
-* Piano sections::              
+* Common notation for keyboards::  
+* Piano::                       
+* Accordion::                   
 @end menu
 
 @node Common notation for keyboards
 @subsection Common notation for keyboards
 
 @menu
-* Automatic staff changes::     
-* Manual staff switches::       
-* Pedals::                      
-* Staff switch lines::          
-* Cross staff stems::           
+* References for keyboards::    
+* The piano staff::             
+* Changing staff manually::     
+* Changing staff automatically::  
+* Staff-change lines::          
+* Cross-staff stems::           
 @end menu
 
 @node References for keyboards
@@ -141,7 +144,7 @@ práctico
 
 @seealso
 
-En este manual: @ref{Manual staff switches}.
+En este manual: @ref{Inside the staff}.
 
 Referencia del programa: @internalsref{AutoChangeMusic}.
 
@@ -230,7 +233,7 @@ noFlag = \once \override Stem #'flag-style = #'no-flag
 @subsection Piano
 
 @menu
-* Piano pedals::
+* Piano pedals::                
 @end menu
 
 @node Piano pedals
@@ -307,7 +310,7 @@ Referencia de la notación: @ref{Ties} (laissez vibrer).
 @subsection Accordion
 
 @menu
-* Discant symbols::
+* Discant symbols::             
 @end menu
 
 @node Discant symbols
diff --git a/Documentation/es/user/notation-appendices.itely b/Documentation/es/user/notation-appendices.itely
index 52f8788de8..06248d28c3 100644
--- a/Documentation/es/user/notation-appendices.itely
+++ b/Documentation/es/user/notation-appendices.itely
@@ -18,8 +18,8 @@
 * List of colors::              
 * The Feta font::               
 * Note head styles::            
-* Overview of text markup commands::  
-* Overview of text markup list commands::  
+* Text markup commands::  
+* Text markup list commands::  
 * List of articulations::       
 * All context properties::      
 * Layout properties::           
@@ -213,17 +213,15 @@ Se pueden usar los siguientes estilos para las cabezas de las notas.
 @lilypondfile[noindent]{note-head-style.ly}
 
 
-@node Overview of text markup commands
-@appendixsec Overview of text markup commands
-
+@ignore
 Todas las instrucciones siguientes se pueden usar dentro de @code{\markup @{ @}}.
+@end ignore
 
 @include markup-commands.tely
 
-@node Overview of text markup list commands
-@appendixsec Overview of text markup list commands
-
+@ignore
 Todas las instrucciones siguientes se pueden utilizar con @code{\markuplines}.
+@end ignore
 
 @include markup-list-commands.tely
 
diff --git a/Documentation/es/user/percussion.itely b/Documentation/es/user/percussion.itely
index ff2bd28b48..39fc9b98dd 100644
--- a/Documentation/es/user/percussion.itely
+++ b/Documentation/es/user/percussion.itely
@@ -99,7 +99,7 @@ down = \drummode { bassdrum4 snare8 bd r bd sn4 }
 @end lilypond
 
 El ejemplo anterior muestra una notación polifónica prolija.  La notación
-polifónica abreviada, descrita en @ref{Basic polyphony}, también se puede usar si
+polifónica abreviada, descrita en @rlearning{I'm hearing Voices}, también se puede usar si
 las @internalsref{DrumVoice}s se instancian primero a mano.  Por ejemplo,
 
 @lilypond[quote,ragged-right,fragment,verbatim]
diff --git a/Documentation/es/user/pitches.itely b/Documentation/es/user/pitches.itely
index 5d1a98f129..607f6bfc76 100644
--- a/Documentation/es/user/pitches.itely
+++ b/Documentation/es/user/pitches.itely
@@ -340,7 +340,7 @@ Glosario musical:
 @rglos{double sharp},
 @rglos{double flat},
 @rglos{Pitch names},
-@rglos{quarter-tone}.
+@rglos{semitone}.
 
 Manual de aprendizaje:
 @rlearning{Accidentals and key signatures}.
diff --git a/Documentation/es/user/specialist.itely b/Documentation/es/user/specialist.itely
index f2cd98e2e1..77f75525ec 100644
--- a/Documentation/es/user/specialist.itely
+++ b/Documentation/es/user/specialist.itely
@@ -8,6 +8,9 @@
 
 @c \version "2.11.38"
 
+@node Specialist notation
+@chapter Specialist notation
+
 This chapter explains how to create musical notation for specific
 types of instrument or in specific styles.
 
diff --git a/Documentation/es/user/templates.itely b/Documentation/es/user/templates.itely
index ad03e6e903..7e320c2d00 100644
--- a/Documentation/es/user/templates.itely
+++ b/Documentation/es/user/templates.itely
@@ -1490,7 +1490,7 @@ violin concerto as TchaikovskyPI, whereas perhaps you wish to print
 @appendixsec lilypond-book templates
 
 Estas plantillas se usan para @code{lilypond-book}.  Si no está familiarizado con este
-programa, consulte @rprogram{lilypond-book}.
+programa, consulte @rprogram{LilyPond-book}.
 
 @appendixsubsec LaTeX
 
diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely
index 33c565a79a..87c915e9ae 100644
--- a/Documentation/es/user/text.itely
+++ b/Documentation/es/user/text.itely
@@ -446,7 +446,7 @@ indicaciones.  Tenga en cuenta que la tipografía de dinámica contiene solament
 Algunas situaciones (como las indicaciones de dinámica) tienen propiedades de tipografía
 establecidas como fijas.  Si estamos creando texto en estas situaciones,  se recomienda
 cancelar dichas propiedades con
-@code{normal-text}.  Consulte @ref{Overview of text markup commands} para
+@code{normal-text}.  Consulte @ref{Text markup commands} para
 ver más detalles.
 
 @cindex make-dynamic-script
@@ -503,7 +503,7 @@ c1_\markup { "\special {weird} #characters" }
 @end lilypond
 
 @noindent
-Consulte @ref{Overview of text markup commands}, para ver una lista de todas las
+Consulte @ref{Text markup commands}, para ver una lista de todas las
 instrucciones.
 
 @code{\markup} se usa principalmente para indicaciones del tipo @internalsref{TextScript},
@@ -621,13 +621,13 @@ c'4^\markup{ \hspace #0 \raise #1.5 raised }
 Algunas situaciones (como las indicaciones de dinámica) tienen propiedades de tipografía
 preestablecidas.  Si está creando texto en tales situaciones, recomendamos
 cancelar dichas propiedades con
-@code{normal-text}.  Consulte @ref{Overview of text markup commands}
+@code{normal-text}.  Consulte @ref{Text markup commands}
 para ver más detalles.
 
 
 @seealso
 
-En el presente manual: @ref{Overview of text markup commands}.
+En el presente manual: @ref{Text markup commands}.
 
 Referencia del programa: @internalsref{TextScript}.
 
@@ -685,11 +685,11 @@ que se pueden extender sobre varias páginas:
 @code{\markuplines} admite una lista de elementos de marcado, ya sea el resultado de
 una instrucción de lista de marcado, o una lista de elementos o listas de elementos. Las
 instrucciones incorporadas de lista de elementos de marcado se describen en
-@ref{Overview of text markup list commands}.
+@ref{Text markup list commands}.
 
 @seealso
 
-En este manual: @ref{Overview of text markup list commands}, 
+En este manual: @ref{Text markup list commands}, 
 @ref{New markup list command definition}.
 
 @predefined
diff --git a/Documentation/es/user/tutorial.itely b/Documentation/es/user/tutorial.itely
index 55ee8fc9bd..c564656cc5 100644
--- a/Documentation/es/user/tutorial.itely
+++ b/Documentation/es/user/tutorial.itely
@@ -816,7 +816,7 @@ c2\< c2\ff\> c2 c2\!
 @quotation
 @table @asis
 @item Articulaciones
-véase @ruser{Articulations}.
+véase @rglos{articulation}.
 @item Digitaciones
 véase @ruser{Fingering instructions}.
 @item Matices
@@ -934,7 +934,7 @@ véase @ruser{Grace notes},
 @item Grupos especiales
 véase @ruser{Tuplets},
 @item Anacrusas
-véase @ruser{Partial measures}.
+véase @ruser{Upbeats}.
 @end table
 @end quotation
 
@@ -1060,7 +1060,7 @@ expresión simultánea, hay más de un pentagrama.
 @node Multiple staves
 @subsection Multiple staves
 
-Como ya hemos visto en @ruser{Music expressions explained}, los archivos de entrada para LilyPond
+Como ya hemos visto en @ref{Music expressions explained}, los archivos de entrada para LilyPond
 se construyen a base de expresiones musicales.  Si la partitura comienza con
 expresiones musicales simultáneas, LilyPond crea varios pentagramas.  Sin embargo
 es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.
@@ -1152,7 +1152,7 @@ de las líneas divisorias.
 
 @seealso
 
-Referencia de la notación: @ruser{Piano music}, 
+Referencia de la notación: @ruser{References for keyboards}, 
 @ruser{Displaying staves}.
 
 @node Combining notes into chords
@@ -1230,7 +1230,7 @@ Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
 
 @seealso
 @quotation
-Véase @ruser{Basic polyphony}.
+Véase @ref{I'm hearing Voices}.
 @end quotation
 
 
@@ -1603,7 +1603,7 @@ más detalles, consulte @rprogram{Updating files with convert-ly}).
 La información sobre el título, autor, número de Opus y similares se
 escriben en el bloque @code{\header}.  Éste se encuentra fuera de la
 expresión musical principal; el bloque @code{\header} normalmente se
-sitúa por debajo del @ruser{Version number}.
+sitúa por debajo del @ref{Version number}.
 
 @example
 \version @w{"@version{}"}
@@ -1706,7 +1706,7 @@ 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 tratada en el
 tutorial, eche un vistazo a la Referencia de Notación, empezando por
-@ruser{Basic notation}.  Si quiere escribir música para un conjunto
+@ruser{Musical notation}.  Si quiere escribir música para un conjunto
 instrumental que no está cubierto por ninguna plantilla, consulte
 @ref{Extending the templates}.
 
diff --git a/Documentation/es/user/tweaks.itely b/Documentation/es/user/tweaks.itely
index 98f06479bb..a744232b4c 100644
--- a/Documentation/es/user/tweaks.itely
+++ b/Documentation/es/user/tweaks.itely
@@ -2844,7 +2844,7 @@ voces?  El índice de la Referencia de la Notación no menciona la
 mezcla de notas, pero una búsqueda de texto por la palabra @q{fusión}
 o @q{mezcla} nos lleva rápidamente a las sobreescrituras necesarias
 para mezclar o fusionar notas con distinta cabeza y con o sin puntillo
-en @ruser{Collision Resolution}.  En nuestro ejemplo tenemos que
+en @ruser{Collision resolution}.  En nuestro ejemplo tenemos que
 fusionar ambos tipos de nota en el transcurso de la sección polifónica
 del compás 3; por tanto, en virtud de la información que aparece en la
 Referencia de la Notación, escribimos
diff --git a/Documentation/es/user/vocal.itely b/Documentation/es/user/vocal.itely
index f61af06b7e..2c327fd7fa 100644
--- a/Documentation/es/user/vocal.itely
+++ b/Documentation/es/user/vocal.itely
@@ -358,7 +358,7 @@ o especificando la duración de cada sílaba explícitamente, utilizando
 @menu
 * Automatic syllable durations::  
 * Manual syllable durations::   
-* Multiple notes to one syllable::  
+* Multiple syllables to one note::  
 * Multiple notes to one syllable::  
 * Skipping notes::              
 * Extenders and hyphens::       
@@ -466,8 +466,8 @@ duraciones manuales de las sílabas del texto:
 Referencia de funcionamiento interno: @internalsref{Lyrics}.
 
 
-@node Multiple notes to one syllable
-@subsubsection Multiple notes to one syllable
+@node Multiple syllables to one note
+@subsubsection Multiple syllables to one note
 
 
 @funindex _
diff --git a/Documentation/es/user/working.itely b/Documentation/es/user/working.itely
index f18fda6d8e..5fe8c6b182 100644
--- a/Documentation/es/user/working.itely
+++ b/Documentation/es/user/working.itely
@@ -82,8 +82,8 @@ el número de versión de LilyPond que estaba usando hace unos años.
 @code{convert-ly} requiere que declare qué versión de LilyPond
 utilizó.
 
-@item @strong{Incluya comprobaciones}: @ruser{Bar and barnumber checks},
-@ruser{Octave check}.  Si incluye comprobaciones de vez en cuando, en
+@item @strong{Incluya comprobaciones}: @rglos{baritone},
+@ruser{Absolute octave entry}.  Si incluye comprobaciones de vez en cuando, en
 caso de que cometa un error podrá localizarlo mucho más rápidamente.
 ¿Con qué frecuencia es @q{de vez en cuando}?  Depende de la
 complejidad de la música.  Para una música muy sencilla, quizá tan
diff --git a/Documentation/fr/user/ancient.itely b/Documentation/fr/user/ancient.itely
index 20f0417bed..f63532407f 100644
--- a/Documentation/fr/user/ancient.itely
+++ b/Documentation/fr/user/ancient.itely
@@ -2091,7 +2091,7 @@ Les altérations s'obtiennent en ajoutant aux chiffres les caractères
 
 Le caractère @code{_} insère un espace, et l'on peut imprimer des
 crochets avec @code{[} et @code{]}.  Vous pouvez aussi ajouter des
-chaînes de caractères ou des étiquettes --- cf. @ref{Overview of text
+chaînes de caractères ou des étiquettes --- cf. @ref{Text
 markup commands}.
 
 @example
diff --git a/Documentation/fr/user/changing-defaults.itely b/Documentation/fr/user/changing-defaults.itely
index 9ee6972ec4..e8de10fc6a 100644
--- a/Documentation/fr/user/changing-defaults.itely
+++ b/Documentation/fr/user/changing-defaults.itely
@@ -65,7 +65,7 @@ infrastructure.  Modifier les choix de mise en page revient à pénétrer dans
 les entrailles du programme, et de ce fait requiert l'emploi du Scheme.
 Les fragments de Scheme, dans un fichier @code{.ly}, sont introduits par le
 caractère @q{hash}, (@code{#}, improprement surnommé @q{dièse}).@footnote{Le 
-@ref{Scheme tutorial} fournit quelques notions de base pour saisir des nombres,
+@rlearning{Scheme tutorial} fournit quelques notions de base pour saisir des nombres,
 des listes, des chaînes de caractères ou des symboles, en Scheme.}
 
 
@@ -1244,7 +1244,7 @@ On peut alors saisir la musique, comme dans l'exemple plus haut :
 
 Il est possible d'aligner verticalement chaque nouveau contexte,
 en-dessous ou au-dessus, par exemple dans le cas de musique vocale
-(@ref{Vocal ensembles}) ou d'@qq{ossias}.
+(@rlearning{Vocal ensembles}) ou d'@qq{ossias}.
 
 @cindex ossia
 @findex alignAboveContext
diff --git a/Documentation/fr/user/fretted-strings.itely b/Documentation/fr/user/fretted-strings.itely
index 57089289c2..fa6d40a22d 100644
--- a/Documentation/fr/user/fretted-strings.itely
+++ b/Documentation/fr/user/fretted-strings.itely
@@ -274,7 +274,7 @@ Vous pouvez indiquer vos diagrammes de trois manières différentes :
 @qq{standard}, @qq{terse} ou @qq{verbeux}. Ces trois interfaces
 produisent des schémas similaires, mais demandent d'entrer plus ou moins
 d'informations.  Vous trouverez tout les détails dans
-@ref{Overview of text markup commands}.
+@ref{Text markup commands}.
 
 Par ailleurs, plusieurs propriétés permettent d'ajuster le graphisme
 à votre convenance. Vous en trouverez les détails dans
@@ -363,6 +363,6 @@ Lorsque des notes doivent être jouées détimbrées --- le doigt effleurant
 la corde sans la presser, en un effet presque percussif, mais où la
 hauteur est encore perceptible ---, on peut employer des têtes de notes
 spéciales en forme de croix.
-Vous trouverez plus de détails dans @ref{Special noteheads}.
+Vous trouverez plus de détails dans @ref{Special note heads}.
 
 
diff --git a/Documentation/fr/user/fundamental.itely b/Documentation/fr/user/fundamental.itely
index 7741a2d98d..ef72093522 100644
--- a/Documentation/fr/user/fundamental.itely
+++ b/Documentation/fr/user/fundamental.itely
@@ -147,8 +147,8 @@ libre de choisir comment dénommer vos variables@footnote{Les noms de
 variables sont sensibles à la casse, et ne peuvent contenir ni
 chiffre, ni tiret, ni caractère accentué.} ; ce peut être
 @code{melodie}, @code{global}, @code{maindroitepiano}, ou
-@code{laTeteAToto}.  Pour plus de détails, voir @ruser{Saving typing
-with identifiers and functions}.
+@code{laTeteAToto}.  Pour plus de détails, voir @ref{Saving
+typing with variables and functions}.
 
 Pour une description complète du format des fichiers d'entrée, voir 
 @ruser{File structure}.
@@ -173,7 +173,7 @@ expression musicale.}
 
 @noindent
 Peut-être serait-il judicieux de relire la section
-@ruser{Music expressions explained}, dans laquelle vous avez
+@ref{Music expressions explained}, dans laquelle vous avez
 appris à construire de grandes expressions musicales petit bout
 par petit bout --- nous avons vu les notes, puis les accords, etc.
 Maintenant, nous allons partir d'une grande expression musicale,
@@ -647,7 +647,7 @@ de type @var{Contexte}, quel que puisse être son nom.
 Cette variante sert à des expressions musicales qui peuvent être interprétées à
 plusieurs niveaux.  Par exemple, une commande telle que @code{\applyOutput} (voir
 @c FIXME: broken link
-@c @ref{Running a function on all layout objects}) : si elle n'est pas associée avec
+@c @ruser{Running a function on all layout objects}) : si elle n'est pas associée avec
 @code{\context}, elle s'applique par défaut dans le contexte @context{Voice}.
 
 @example
diff --git a/Documentation/fr/user/introduction.itely b/Documentation/fr/user/introduction.itely
index 9e1da4d2a0..e08a09906f 100644
--- a/Documentation/fr/user/introduction.itely
+++ b/Documentation/fr/user/introduction.itely
@@ -765,22 +765,22 @@ de manière linéaire.
 @ifhtml
 Le
 @end ifhtml
-@emph{@ruser{Tutorial}}
+@emph{@ref{Tutorial}}
 propose une introduction en douceur à la typographie musicale.
 Les utilisateurs débutants sont invités à commencer ici.
 
 @item
-@emph{@ruser{Putting it all together}}
+@emph{@ref{Fundamental concepts}}
 explique des concepts généraux du format de fichier ly. Si vous n'êtes
 pas certain de l'endroit où placer une commande, lisez ce chapitre !
 
 @item
-@emph{@ruser{Working on LilyPond projects}}
+@emph{@ref{Working on LilyPond projects}}
 montre des utilisations pratiques de LilyPond et donne des conseils
 afin d'éviter les problèmes les plus courants.
 
 @item
-@emph{@ruser{Tweaking output}}
+@emph{@ref{Tweaking output}}
 est une introduction aux retouches de gravure avec LilyPond.
 
 @end itemize
@@ -795,23 +795,17 @@ concepts exposés dans le manuel d'apprentissage.
 @itemize @bullet
 
 @item
-@emph{@ruser{Basic notation}}
+@emph{@ruser{Musical notation}}
 traite de sujets groupés par type de notation.  Cette section
 détaille la notation de base, qui sera utile dans la plupart des
 projets de partition.
 
 @item
-@emph{@ruser{Instrument-specific notation}}
+@emph{@ruser{Specialist notation}}
 traite de sujets groupés par type de notation.  Cette section détaille
 des notations spéciales qui ne seront utiles que pour des types
 particuliers d'instruments ou la voix.
 
-@item
-@emph{@ruser{Advanced notation}}
-traite de sujets groupés par type de notation.  Cette section
-donne des précisions à propos de notations compliquées et
-inhabituelles
-
 @item
 @emph{@ruser{Changing defaults}}
 explique comment ajuster finement la mise en page.
@@ -851,7 +845,7 @@ en savoir plus sur la notation et la gravure.
 
 @item
 Le
-@emph{@ruser{Scheme tutorial}}
+@emph{@ref{Scheme tutorial}}
 propose une courte introduction à Scheme, le langage de programmation
 utilisé dans les fonctions de musique.
 
@@ -865,7 +859,7 @@ instruments MIDI, les noms de couleur, et la police Feta.
 
 @item
 Les
-@emph{@ruser{Templates}}
+@emph{@ref{Templates}}
 de pièces LilyPond.  Copiez et collez un modèle
 dans un fichier, ajoutez les notes, et c'est prêt !
 
diff --git a/Documentation/fr/user/keyboards.itely b/Documentation/fr/user/keyboards.itely
index 5bab171bc3..7aa82b7746 100644
--- a/Documentation/fr/user/keyboards.itely
+++ b/Documentation/fr/user/keyboards.itely
@@ -56,7 +56,7 @@ conçu pour gérer la notation spécifique au piano, notamment ces croisements.
 
 Les nuances ne sont pas centrées verticalement, mais il existe
 des astuces.  Voir à ce sujet le modèle @q{alignement des nuances au
-piano} au chapitre @ref{Piano templates}.
+piano} au chapitre @rlearning{Piano templates}.
 
 
 @node Changing staff manually
@@ -146,7 +146,7 @@ place les silences en fonction des notes qui les suivront. Ainsi :
 
 @seealso
 
-Dans ce même manuel : @ref{Manual staff switches}.
+Dans ce même manuel : @ruser{Changing staff manually}.
 
 Référence du programme : @internalsref{AutoChangeMusic}.
 
diff --git a/Documentation/fr/user/notation-appendices.itely b/Documentation/fr/user/notation-appendices.itely
index a2f480f3d3..11d31a830b 100644
--- a/Documentation/fr/user/notation-appendices.itely
+++ b/Documentation/fr/user/notation-appendices.itely
@@ -14,16 +14,14 @@
 @node Notation manual tables
 @appendix Notation manual tables
 
-UNTRANSLATED NODE: IGNORE ME
-
 @menu 
 * Chord name chart::
 * MIDI instruments::
 * List of colors::
 * The Feta font::
 * Note head styles::
-* Overview of text markup commands::
-* Overview of text markup list commands::
+* Text markup commands::
+* Text markup list commands::
 * List of articulations::       
 * All context properties::      
 * Layout properties::           
@@ -62,20 +60,17 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
-
-@node Overview of text markup commands
-@appendixsec Overview of text markup commands
-
+@ignore
 Vous pouvez utiliser les commandes suivantes au sein d'un bloc
 @code{\markup @{ @}}.
+@end ignore
 
 @include markup-commands.tely
 
 
-@node Overview of text markup list commands
-@appendixsec Overview of text markup list commands
-
+@ignore
 Vous pouvez utiliser les commandes suivantes avec @code{\markuplines}.
+@end ignore
 
 @include markup-list-commands.tely
 
diff --git a/Documentation/fr/user/simultaneous.itely b/Documentation/fr/user/simultaneous.itely
index cfd7121bdb..7b655fd87d 100644
--- a/Documentation/fr/user/simultaneous.itely
+++ b/Documentation/fr/user/simultaneous.itely
@@ -46,7 +46,7 @@ d'articulation, comme une simple note.
 <c e g>4 <c>8
 @end lilypond
 
-Pour plus d'information à propos des accords, voir @ref{Chord names}.
+Pour plus d'information à propos des accords, voir @ref{Chord notation}.
 
 
 @node Clusters
diff --git a/Documentation/fr/user/text.itely b/Documentation/fr/user/text.itely
index 4076e16e40..5c0f5ee62e 100644
--- a/Documentation/fr/user/text.itely
+++ b/Documentation/fr/user/text.itely
@@ -469,7 +469,7 @@ Certains composants, tels que les marques de nuances, possèdent des
 propriétés particulières et prédéfinies quant à leur police.  Lorsque
 vous créez du texte en pareille situation, nous vous recommandons
 d'utiliser @code{normal-text} pour annuler ces propriétés.  Voir 
-@ref{Overview of text markup commands} pour plus de détails.
+@ref{Text markup commands} pour plus de détails.
 
 @cindex make-dynamic-script
 
@@ -528,7 +528,7 @@ c1_\markup { "\special {weird} #characters" }
 
 @noindent
 Pour une liste des différentes commandes disponibles, consultez
-@ref{Overview of text markup commands}. 
+@ref{Text markup commands}. 
 
 
 @code{\markup} est avant tout conçu pour gérer les
@@ -652,12 +652,12 @@ Certaines situations particulières, telles que les indications de
 nuance, possèdent des propriétés prédéfinies quant à leur police.
 Nous vous conseillons, en pareil cas, de réinitialiser ces propriétés
 en utilisant @code{normal-text}.  Pour plus d'informations, consultez
-@ref{Overview of text markup commands}. 
+@ref{Text markup commands}. 
 
 
 @seealso
 
-Dans ce manuel : @ref{Overview of text markup commands}.
+Dans ce manuel : @ref{Text markup commands}.
 
 Référence du programme : @internalsref{TextScript}.
 
@@ -727,11 +727,11 @@ tour des lignes de texte, comme ici :
 @end verbatim
 
 Les différentes commandes permettant de générer des listes de lignes
-se trouve dans @ref{Overview of text markup list commands}.
+se trouve dans @ref{Text markup list commands}.
 
 @seealso
 
-Dans ce manuel : @ref{Overview of text markup list commands}, 
+Dans ce manuel : @ref{Text markup list commands}, 
 @ref{New markup list command definition}.
 
 @predefined
diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely
index 5b83b61ba7..3dc0e66958 100644
--- a/Documentation/fr/user/tutorial.itely
+++ b/Documentation/fr/user/tutorial.itely
@@ -503,13 +503,13 @@ Le fragment suivant met en évidence quelques usages possibles des commentaires
 @end itemize
 
 Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
-@ruser{Suggestions for writing LilyPond files}.
+@ref{Suggestions for writing LilyPond files}.
 
 
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-Comme nous l'avons vu dans @ruser{Working on text files}, un code
+Comme nous l'avons vu dans @ref{Working on text files}, un code
 LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
 c'' @{ ...  @}} afin d'être compris.  Cependant, dans la suite de ce
 manuel, la plupart des exemples ne feront pas apparaître ces signes.
@@ -554,9 +554,9 @@ Cette section présente la notation courante dont on a besoin pour
 @node Relative note names
 @subsection Relative note names
 
-Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
+Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
 hauteur de chaque note en fonction de la précédente@footnote{Il existe
-un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
+un autre mode de saisie des hauteurs, le mode @ref{Absolute note
 names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
 au mode de hauteurs relatives.}.  Si aucune indication supplémentaire
 d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
@@ -911,7 +911,7 @@ voir @ruser{Grace notes},
 @item nolets
 voir @ruser{Tuplets},
 @item levées
-voir @ruser{Partial measures}.
+voir @ruser{Upbeats}.
 @end table
 @end quotation
 
@@ -1043,7 +1043,7 @@ polyphoniques.
 @node Multiple staves
 @subsection Multiple staves
 
-Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
+Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier
 d'entrée LilyPond est fait d'expressions musicales.  Si la partition
 commence par plusieurs expressions simultanées, LilyPond créera
 plusieurs portées.  Cependant, il est plus facile de voir ce qu'il
@@ -1107,7 +1107,7 @@ n'affecte @emph{pas} les autres portées.
 @cindex voix changeant manuellement de portée
 La musique pour piano s'écrit sur deux portées reliées par une accolade.
 Imprimer ce type de portée revient au même que dans l'exemple de musique
-polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
+polyphonique de @ref{Multiple staves}, mais maintenant cette expression
 entière doit être interprétée dans un contexte @code{PianoStaff} :
 
 @example
@@ -1130,7 +1130,7 @@ Voici un bref exemple :
 
 @seealso
 @quotation
-Voir @ruser{Piano music}.
+Voir @ruser{Keyboard instruments}.
 @end quotation
 
 
@@ -1350,7 +1350,7 @@ partition de chanson :
 @seealso
 @quotation
 Une liste complète de modificateurs et d'autres options de mise en forme
-se trouve à la section @ruser{Chords}.
+se trouve à la section @ruser{Chord notation}.
 @end quotation
 
 
@@ -1560,12 +1560,12 @@ différents endroits.  L'exemple suivant utilise la variable ci-dessus :
 @subsection After the tutorial
 
 Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
-morceau ou deux.  Commencez par copier l'un des @ruser{Templates} types et
+morceau ou deux.  Commencez par copier l'un des @ref{Templates} types et
 ajoutez-y des notes.  Si vous voulez employer une notation que vous
 n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
-en commençant par la @ruser{Basic notation}.  Si vous désirez écrire pour
-un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
-section @ruser{Extending the templates}.
+en commençant par la @ruser{Musical notation}.  Si vous désirez écrire pour
+un ensemble instrumental non couvert par les @ref{Templates}, lisez la
+section @ref{Extending the templates}.
 
 Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
 manuel d'apprentissage.  Rien ne s'oppose à ce que vous consultiez dès à
@@ -1577,7 +1577,7 @@ et y revenir plus tard après avoir acquis de l'expérience.
 @node How to read the manual
 @subsection How to read the manual
 
-Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
+Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
 nombreux exemples du tutoriel n'ont pas fait apparaître
 @code{\relative c'' @{ ...  @}} dans l'extrait de code affiché.
 
@@ -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 à @ruser{About this manual}.
+reportez-vous à @ref{About this manual}.
diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely
index c3d8d96a7a..446883866c 100644
--- a/Documentation/fr/user/tweaks.itely
+++ b/Documentation/fr/user/tweaks.itely
@@ -173,13 +173,13 @@ c4^"piu mosso" d e f
 
 @seealso
 
-Dans ce même manuel : @ruser{The \override command}, @ruser{Common tweaks}.
+Dans ce même manuel : @ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
 @section Fixing overlapping notation
 
-Dans la section @ruser{Moving objects}, nous avons vu comment
+Dans la section @ref{Moving objects}, nous avons vu comment
 déplacer un objet @code{TextScript}.  Ce même procédé peut être
 appliqué à d'autres types d'objet : il vous suffira de remplacer
 @code{TextScript} par le nom de l'objet en question.
@@ -491,7 +491,7 @@ largement personnalisé à l'aide de commandes comme
 @code{\override TextScript #'extra-offset = ( 1 . -1)}.  Cependant,
 l'utilisation de Scheme ouvre des possibilités encore plus grandes.
 Pour des explications complètes là-dessus, consultez le 
-@ruser{Scheme tutorial}  et les @ruser{Interfaces for programmers}.
+@ref{Scheme tutorial}  et les @ruser{Interfaces for programmers}.
 
 On peut utiliser Scheme simplement à l'aide des commandes @code{\override}.
 
diff --git a/Documentation/fr/user/vocal.itely b/Documentation/fr/user/vocal.itely
index 9ee15c039e..dc470fb76d 100644
--- a/Documentation/fr/user/vocal.itely
+++ b/Documentation/fr/user/vocal.itely
@@ -79,7 +79,7 @@ Pour que les paroles évitent également les barres de mesure, ajoutez
 
 Le @emph{parlato} est du texte scandé en rythme, mais sans hauteurs
 définies ; il est indiqué par des notes en croix, à l'instar des
-percussions --- voir @ref{Special noteheads}.
+percussions --- voir @ref{Special note heads}.
 
 
 @node Setting simple songs
@@ -146,7 +146,7 @@ il est aussi possible d'attribuer automatiquement chaque syllabe à une
 note d'une mélodie ou d'une voix existante, avec @code{\addlyrics} ou
 @code{\lyricsto}.  
 @c  TODO: broken but exists Aligning lyrics
-@c For more details see @ref{The Lyrics context}.
+@c For more details see @ref{Aligning contexts}.
 
 Dans les paroles, un mot ou une syllabe commence par une lettre de
 l'alphabet, et se termine par un espace (éventuellement précédé d'un
@@ -549,7 +549,7 @@ connecter manuellement créera un mélisme.
 @cindex choral score
 
 Vous trouverez un exemple complet de partition pour chœur dans la
-section @ref{Vocal ensembles}.
+section @rlearning{Vocal ensembles}.
 
 
 @predefined
diff --git a/Documentation/fr/user/working.itely b/Documentation/fr/user/working.itely
index cab2b18b47..6f320193aa 100644
--- a/Documentation/fr/user/working.itely
+++ b/Documentation/fr/user/working.itely
@@ -108,8 +108,8 @@ structuré si vous n'y avez pas adjoint de commentaires.
 viennent d'un défaut de parité entre @code{@{} et @code{@}}.
 
 @item @strong{Séparez les affinages de mise en forme} de la musique
-elle-même. Voyez @ruser{Saving typing with identifiers and functions} et
-@ruser{Style sheets}.
+elle-même. Voyez @ref{Saving typing with variables and functions} et
+@ref{Style sheets}.
 
 @end itemize
 
@@ -168,7 +168,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Séparez les retouches} des définitions de
-musique.  Ce conseil a été vu dans @ruser{General suggestions},
+musique.  Ce conseil a été vu dans @ref{General suggestions},
 mais pour les projets d'importance c'est absolument vital.  Nous
 pouvons avoir besoin de changer la définition de
 @code{fthenp}, mais dans ce cas nous n'aurons besoin de le faire
@@ -285,8 +285,8 @@ padText =
 
 Utiliser les identificateurs est aussi un bon moyen pour vous épargner
 du travail si la syntaxe de LilyPond change un jour --- voir
-@ruser{Updating old files}.  Si vous avez une seule définition, par
-exemple @code{\dolce}, pour tous vos fichiers (voir @ruser{Style
+@ref{Updating old files}.  Si vous avez une seule définition, par
+exemple @code{\dolce}, pour tous vos fichiers (voir @ref{Style
 sheets}), et que la syntaxe change, alors vous n'aurez qu'à mettre à
 jour votre seule définition @code{\dolce}, au lieu de devoir modifier
 chaque fichier @code{.ly}.
@@ -296,14 +296,14 @@ chaque fichier @code{.ly}.
 @subsection Style sheets
 
 La sortie que produit LilyPond peut être largement modifiée --- voir
-@ruser{Tweaking output} pour plus de détails.  Mais que faire si vous
+@ref{Tweaking output} pour plus de détails.  Mais que faire si vous
 avez beaucoup de fichiers auxquels vous souhaitez appliquer vos
 retouches ? Ou si vous souhaitez simplement séparer les retouches de
 la musique elle-même ?  Rien de plus facile.
 
 Prenons un exemple.  Ne vous inquiétez pas si vous ne comprenez pas
 les parties avec tous les @code{#()}.  Celles-ci sont expliquées dans
-@ruser{Advanced tweaks with Scheme}.
+@ref{Advanced tweaks with Scheme}.
 
 @lilypond[quote,verbatim,ragged-right]
 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@@ -324,7 +324,7 @@ tempoMark = #(define-music-function (parser location markp) (string?)
 @end lilypond
 
 Il y a quelques problèmes de chevauchement ; nous allons arranger
-cela en utilisant les techniques de @ruser{Moving objects}.  On peut
+cela en utilisant les techniques de @ref{Moving objects}.  On peut
 aussi faire quelque chose pour les définitions de @code{mpdolce}
 et @code{tempoMark}.  Elles produisent le résultat que nous désirons,
 mais nous pourrions aussi vouloir les utiliser dans une autre pièce.
@@ -645,10 +645,10 @@ problème.
 
 Une autre technique de déboguage très utile est la construction
 @iftex
-de @ruser{Minimal examples}.
+de @ref{Minimal examples}.
 @end iftex
 @ifnottex
-d'@ruser{Minimal examples}.
+d'@ref{Minimal examples}.
 @end ifnottex
 
 
@@ -811,7 +811,7 @@ ce qui équivaut à
 
 Des informations plus détaillées sur la mise en place de conducteurs
 et de parties séparées se trouvent dans le manuel : voir
-@ruser{Orchestral music}.
+@ruser{Writing parts}.
 
 Les variables (@q{propriétés}) réglables sont abordées en détail dans
 @ruser{Changing context properties on the fly}.
diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 760d1ed337..b66ec6dcc3 100644
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -155,8 +155,8 @@ Learning Manual:
 @rlearning{Fixing overlapping notation}.
 
 Notation Reference:
-@ruser{Stems},
-@ruser{Automatic beams}.
+@ref{Stems},
+@ref{Automatic beams}.
 
 Snippets:
 @rlsr{Keyboards}.
diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely
index ab8bc3d53f..b20c93d8ac 100644
--- a/Documentation/user/rhythms.itely
+++ b/Documentation/user/rhythms.itely
@@ -975,8 +975,8 @@ Music Glossary:
 @rglos{time signature}
 
 Notation Reference:
-@ruser{Ancient time signatures},
-@ruser{Time administration}.
+@ref{Ancient time signatures},
+@ref{Time administration}.
 
 Snippets:
 @rlsr{Rhythms}.
diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely
index 5cf5c8d370..442082c5e3 100644
--- a/Documentation/user/spacing.itely
+++ b/Documentation/user/spacing.itely
@@ -2087,7 +2087,7 @@ effect.  In general the commands shown in this section can
 be placed in either.
 
 Much more detail on the options for tweaking the laying out
-of music are contained in @ruser{Spacing issues}.
+of music are contained in @ref{Spacing issues}.
 
 @node Global sizes
 @subsection Global sizes
@@ -2191,7 +2191,7 @@ a page-break at the point where they are inserted.
 Of course, the @code{\pageBreak} command also forces a line break.
 Like @code{\break}, the @code{\pageBreak} command is effective only
 at the end of a @q{complete} bar as defined above.  For more
-details see @ruser{Page breaking} and following sections.
+details see @ref{Page breaking} and following sections.
 
 There are also analogous settings to @code{ragged-right} and
 @code{ragged-last} which have the same effect on vertical spacing:
@@ -2199,7 +2199,7 @@ There are also analogous settings to @code{ragged-right} and
 @code{##t} the systems on all pages or just the last page
 respectively will not be justified vertically.
 
-For more details see @ruser{Vertical spacing}.
+For more details see @ref{Vertical spacing}.
 
 @node Fitting music onto fewer pages
 @subsection Fitting music onto fewer pages
@@ -2211,7 +2211,7 @@ of room left on those.
 
 When investigating layout issues, @code{annotate-spacing} is
 an invaluable tool.  This command prints the values of various
-layout spacing commands; see @ruser{Displaying spacing}, for more
+layout spacing commands; see @ref{Displaying spacing}, for more
 details.  From the output of @code{annotate-spacing}, we can
 see which margins we may wish to alter.
 
@@ -2262,7 +2262,7 @@ e4 c g\f c
 
 @item
 Alter the horizontal spacing via @code{SpacingSpanner}.  See
-@ruser{Changing horizontal spacing}, for more details.  Here's
+@ref{Changing horizontal spacing}, for more details.  Here's
 an example first showing the default behavior:
 
 @lilypond[verbatim,quote,ragged-right]
-- 
2.39.2