From: Reinhold Kainhofer <reinhold@kainhofer.com>
Date: Sun, 4 Nov 2007 20:57:18 +0000 (+0100)
Subject: Merge branch 'master' of ssh://kainhofer@git.sv.gnu.org/srv/git/lilypond into kainhofer
X-Git-Tag: release/2.11.35-1~46
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=555d8e498a31380d62be9f4853ab514b3786e986;hp=cc4370c05c005e07a81ab6ec2ec8657a6d361787;p=lilypond.git

Merge branch 'master' of ssh://kainhofer@git.sv.gnu.org/srv/git/lilypond into kainhofer
---

diff --git a/Documentation/de/index.html.in b/Documentation/de/index.html.in
index a198206224..f8f47f8f7b 100644
--- a/Documentation/de/index.html.in
+++ b/Documentation/de/index.html.in
@@ -48,7 +48,7 @@
           <td class="left-column">
 	  <ul>
 	    <li>
-	    <a class="title" href="user/lilypond/Tutorial.de.html">&Uuml;bung</a>
+	    <a class="title" href="user/lilypond-learning/index.de.html">&Uuml;bung</a>
 	      <br>(F&uuml;r einen ersten Anfang.)
 
  
diff --git a/Documentation/de/user/advanced-notation.itely b/Documentation/de/user/advanced-notation.itely
deleted file mode 100644
index 4a7ea280fe..0000000000
--- a/Documentation/de/user/advanced-notation.itely
+++ /dev/null
@@ -1,310 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
-
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@node Advanced notation
-@chapter Advanced notation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Text::
-* Preparing parts::
-* Orchestral music::
-* Contemporary notation::
-* Educational use::
-@end menu 
-@node Text
-@section Text
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Text scripts::
-* Text and line spanners::
-* Text spanners::
-* Text marks::
-* Text markup::
-* Nested scores::
-* Page wrapping text::
-* Overview of text markup commands::
-* Overview of text markup list commands::
-* Font selection::
-* New dynamic marks::
-@end menu 
-@node Text scripts
-@subsection Text scripts
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Text and line spanners
-@subsection Text and line spanners
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Text spanners
-@subsection Text spanners
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Text marks
-@subsection Text marks
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Text markup
-@subsection Text markup
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Nested scores
-@subsection Nested scores
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Page wrapping text
-@subsection Page wrapping text
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Overview of text markup commands
-@subsection Overview of text markup commands
-
-UNTRANSLATED NODE: IGNORE ME
-
-@include markup-commands.tely
-@node Overview of text markup list commands
-@subsection Overview of text markup list commands
-
-UNTRANSLATED NODE: IGNORE ME
-
-@include markup-list-commands.tely
-@node Font selection
-@subsection Font selection
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node New dynamic marks
-@subsection New dynamic marks
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Preparing parts
-@section Preparing parts
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Multi measure rests::
-* Metronome marks::
-* Rehearsal marks::
-* Bar numbers::
-* Instrument names::
-* Instrument transpositions::
-* Ottava brackets::
-* Different editions from one source::
-@end menu 
-@node Multi measure rests
-@subsection Multi measure rests
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Metronome marks
-@subsection Metronome marks
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Rehearsal marks
-@subsection Rehearsal marks
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Bar numbers
-@subsection Bar numbers
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Instrument names
-@subsection Instrument names
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Instrument transpositions
-@subsection Instrument transpositions
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Ottava brackets
-@subsection Ottava brackets
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Different editions from one source
-@subsection Different editions from one source
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Orchestral music
-@section Orchestral music
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Automatic part combining::
-* Hiding staves::
-* Quoting other voices::
-* Formatting cue notes::
-* Aligning to cadenzas::
-@end menu 
-@node Automatic part combining
-@subsection Automatic part combining
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Hiding staves
-@subsection Hiding staves
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Quoting other voices
-@subsection Quoting other voices
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Formatting cue notes
-@subsection Formatting cue notes
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Aligning to cadenzas
-@subsection Aligning to cadenzas
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Contemporary notation
-@section Contemporary notation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Polymetric notation::
-* Time administration::
-* Proportional notation (introduction)::
-* Clusters::
-* Special noteheads::
-* Feathered beams::
-* Improvisation::
-* Selecting notation font size::
-@end menu 
-@node Polymetric notation
-@subsection Polymetric notation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Time administration
-@subsection Time administration
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Proportional notation (introduction)
-@subsection Proportional notation (introduction)
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Clusters
-@subsection Clusters
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Special noteheads
-@subsection Special noteheads
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Feathered beams
-@subsection Feathered beams
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Improvisation
-@subsection Improvisation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Selecting notation font size
-@subsection Selecting notation font size
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Educational use
-@section Educational use
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Balloon help::
-* Blank music sheet::
-* Hidden notes::
-* Shape note heads::
-* Easy Notation note heads::
-* Analysis brackets::
-* Coloring objects::
-* Parentheses::
-* Grid lines::
-@end menu 
-@node Balloon help
-@subsection Balloon help
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Blank music sheet
-@subsection Blank music sheet
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Hidden notes
-@subsection Hidden notes
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Shape note heads
-@subsection Shape note heads
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Easy Notation note heads
-@subsection Easy Notation note heads
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Analysis brackets
-@subsection Analysis brackets
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Coloring objects
-@subsection Coloring objects
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Parentheses
-@subsection Parentheses
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Grid lines
-@subsection Grid lines
-
-UNTRANSLATED NODE: IGNORE ME
-
-
--- SKELETON FILE --
-When you actually translate this file, please remove these lines as
-well as all `UNTRANSLATED NODE: IGNORE ME' lines.
diff --git a/Documentation/de/user/ancient.itely b/Documentation/de/user/ancient.itely
new file mode 100644
index 0000000000..9b0162fa0c
--- /dev/null
+++ b/Documentation/de/user/ancient.itely
@@ -0,0 +1,2240 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Ancient notation
+@section Ancient notation
+
+@cindex Vaticana, Editio
+@cindex Medicaea, Editio
+@cindex Editio Vaticana
+@cindex Editio Medicea
+@cindex Hufnagelnotation
+@cindex Petrucci-Notation
+@cindex Mensuralnotation
+
+In gewissem Rahmen unterstützt LilyPond die Notation 
+Alter Musik: Mensuralnotation sowie der Gregorianische 
+Choral werden unterstützt, dazu kommt noch rudimentäre 
+Unterstützung der Generalbassnotation.
+
+Viele graphische Objekte stellen eine Stil- (@code{style})-Eigenschaft
+zur Verfügung, siehe
+@itemize @bullet
+@item
+@ref{Ancient note heads},
+@item
+@ref{Ancient accidentals},
+@item
+@ref{Ancient rests},
+@item
+@ref{Ancient clefs},
+@item
+@ref{Ancient flags},
+@item
+@ref{Ancient time signatures}.
+@end itemize
+
+Indem eine dieser grob- (graph. Obj.)-Eigenschaften verändert wird, 
+ändert sich auch die Erscheindung der grafischen Objekte zu einem 
+bestimmten Notationsstil, ohne dass neue Notationskonzepte 
+bemüht werden müssen.
+
+Zusätzlich zu den Standard-Artikulationszeichen, wie sie in Abschnitt 
+@ref{Articulations} beschrieben werden, gibt es auch besondere 
+Artikulationszeichen für die Alte Musik.
+
+@itemize @bullet
+@item
+@ref{Ancient articulations}
+@end itemize
+
+Andere Eigenheiten der Notation Alter Musik können nicht so einfach 
+verändert werden, als dass es genügte, nur einen Stil eines graphischen 
+Objektes umzudefinieren. Bestimmte Konzepte sind speziell für die 
+Alte Musik eingeführt worden:
+
+@itemize @bullet
+@item
+@ref{Custodes},
+@item
+@ref{Divisiones},
+@item
+@ref{Ligatures}.
+@end itemize
+
+Sollte Ihnen das zu viel Dokumentation sein, denn Sie wollen eigentlich 
+schnell mit dem Notensatz beginnen, ohne sich groß um die Details 
+zur Anpassung von Kontexten zu kümmern, können Sie sich auch die 
+vordefinierten Kontexte anschauen. Sie können benutzt werden, um 
+zwei bestimmte Stile im Stimmen- und Staff-Kontext direkt zu benutzen:
+
+@itemize @bullet
+@item
+@ref{Gregorian Chant contexts},
+@item
+@ref{Mensural contexts}.
+@end itemize
+
+Es gibt auch begrenzte Unterstützung für bezifferten Bass/Generalbass, eine 
+Notationstradition, die aus dem Barock stammt.
+
+@itemize @bullet
+@item
+@ref{Figured bass}
+@end itemize
+
+Hier sind alle Unterkapitel auf einen Blick:
+
+@menu
+* Ancient TODO::                
+@end menu
+
+
+@node Ancient TODO
+@subsection Ancient TODO
+
+@menu
+* Ancient note heads::          
+* Ancient accidentals::         
+* Ancient rests::               
+* Ancient clefs::               
+* Ancient flags::               
+* Ancient time signatures::     
+* Ancient articulations::       
+* Custodes::                    
+* Divisiones::                  
+* Ligatures::                   
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+* Gregorian Chant contexts::    
+* Mensural contexts::           
+* Musica ficta accidentals::    
+* Figured bass::                
+@end menu
+
+
+
+@node Ancient note heads
+@unnumberedsubsubsec Ancient note heads
+
+@cindex Notenköpfe, Alte Musik
+
+Für die Notation Alter Musik kann ein Notenkopfstil ausgewählt werden, der sich 
+vom Standard (@code{default}) unterscheidet. Dies wird erreicht, indem die 
+@code{style}-Eigenschaft der Notenkopf-(@internalsref{NoteHead})-Objekte auf  
+einen der Werte @code{baroque}, @code{neomensural}, @code{mensural} oder 
+@code{petrucci} gesetzt wird. Der barocke (@code{baroque}) Stil unterscheidet 
+sich vom Standard (@code{default}) nur in sofern, als eine viereckige Form für 
+die Brevis (@code{\breve}) benutzt wird. Der @code{neomensural}-Stil 
+unterscheidet sich vom barocken Stil darin, dass hier rhomboide Notenköpfe für 
+ganze Noten und kleinere Notenwerte eingesetzt ewrden. Hälse werden über oder 
+unter den Notenköpfen zentriert. Dieser Stil ist vor allem dann sinnvoll, wenn 
+mensurale Musik transkribiert werden soll, etwa für ein Incipit. Der
+mensurale (@code{mensural}) Stil erstellt Notenköpfe, die das Aussehen 
+historischer Drucke des 16. Jahrhunderts imitieren. Der @code{petrucci}-Stil 
+schließlich imitiert auch historische Drucke, verwendet allerdings größere 
+Notenköpfe.
+
+Das folgende Beispiel soll den neomensuralen Stil demonstrieren:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override NoteHead #'style = #'neomensural
+a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
+@end lilypond
+
+Für die Notation des Gregorianischen Chorals werden vom 
+@internalsref{Gregorian_ligature_engraver} automatisch die richtigen Notenköpfe 
+ausgewählt, so dass man den Stil nicht manuell setzen muss. Trotzdem kann 
+der Stil manuell verändert werden, z. B. auf den Wert 
+@code{vaticana_punctum}, um Punktum-Neumen zu produzieren. Gleichfalls erstellt 
+der @internalsref{Mensural_ligature_engraver} automatisch Ligaturen der 
+Mensuralnotation. Siehe @ref{Ligatures} zu einer Übersicht über die Funktion 
+und Notation von Ligaturen.
+
+@seealso
+
+@ref{Note head styles} stellt einen Überblick über alle verfügbaren 
+Notenkopfstile zur Verfügung.
+
+
+@node Ancient accidentals
+@unnumberedsubsubsec Ancient accidentals
+
+@cindex Vorzeichen, Alte Musik
+
+
+Mit der @code{glyph-name-alist}-Eigenschaft der
+Versetzungszeichen-(@internalsref{Accidental})- und
+Vorzeichen-(@internalsref{KeySignature})-Eigenschaften können Vorzeichen 
+und Versetzungszeichen für die Alte Musik ausgewählt werden.
+
+@lilypond[quote,ragged-right,staffsize=26]
+\score {
+{
+  \fatText
+  s^\markup {
+    \column {
+      "vaticana"
+      \line { " " \musicglyph #"accidentals.vaticana-1"
+        " " \musicglyph #"accidentals.vaticana0" }
+    }
+    \column {
+      "medicaea"
+      \line { " " \musicglyph #"accidentals.medicaea-1" }
+    }
+    \column {
+      "hufnagel"
+      \line { " " \musicglyph #"accidentals.hufnagel-1" }
+    }
+    \column {
+      "mensural"
+      \line { " " \musicglyph #"accidentals.mensural-1"
+        " " \musicglyph #"accidentals.mensural1" }
+    }
+  }
+}
+\layout {
+  interscoreline = 1
+  \context { \Score \remove "Bar_number_engraver" }
+  \context { \Staff
+      \remove "Clef_engraver"
+      \remove "Key_engraver"
+      \remove "Time_signature_engraver"
+      \remove "Staff_symbol_engraver"
+      \override VerticalAxisGroup #'minimum-Y-extent = ##f
+    }
+  }
+}
+@end lilypond
+
+Wie zu sehen ist, werden nicht alle Versetzungszeichen von jedem Stil 
+unterstützt. Wenn versucht wird, ein Versetzungszeichen zu notieren, 
+das von einem bestimmten Stil nicht untersützt wird, wechselt LilyPond zu einem 
+anderen Stil, wie in dem Beispiel @lsr{ancient,ancient-accidentals.ly}
+demonstriert wird.
+
+Ähnlich wie Versetzungszeichen können auch die Vorzeichen für die Angabe der 
+Tonart verändert werden, indem die @code{glyph-name-alist}-Eigenschaft 
+des @internalsref{KeySignature}-Objektes gesetzt wird.
+
+@seealso
+
+In diesem Handbuch: @ref{Pitches}, @ref{Cautionary accidentals} und
+@ref{Automatic accidentals} geben eine allgemeine Einführung in die Benutzung 
+von Versetzungszeichen. Der Abschnitt @ref{Key signature} zeigt die allgemeine 
+Benutzung von Vorzeichen.
+
+Programmreferenz: @internalsref{KeySignature}.
+
+Beispiele: @lsrdir{ancient}.
+
+@node Ancient rests
+@unnumberedsubsubsec Ancient rests
+
+@cindex Pausen, Alte Musik
+
+Besondere Pausensymbole für die Notation der Alten Musik können mit der 
+@code{style}-Eigenschaft des graphischen Objektes (grob) @qq{Pause}
+(@internalsref{Rest}) angewählt werden. Unterstützte Stile sind 
+klassisch (@code{classical}), @code{neomensural} und @code{mensural}. 
+Der klassische (@code{classical}) Stil unterscheidet sich vom Standardstil 
+(@code{default}) nur darin, dass die Viertelpause wie eine gespiegelte 
+Achtelpause aussieht. Der neomensurale Stil eignet sich gut, um z. B. das 
+Incipit von transkribierter Musik zu notieren. Der mensurale Stil ahmt die 
+Form von Pausen nach, wie man sie in Drucken des 16. Jahrhunderts finden kann.
+
+Das nächste Beispiel demonstriert den neomensuralen (@code{neomensural})
+Stil:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override Rest #'style = #'neomensural
+r\longa r\breve r1 r2 r4 r8 r16
+@end lilypond
+
+Es gibt keine 32-stel- und 64-stel-Pausen für den mensuralen oder neomensuralen
+Stil. Anstatt dessen werden die Pausenformen des Standardstiles verwendet. 
+Vgl. eine Liste aller vorhandenen Pausen in @lsr{pitches,rests}.
+
+Für die Notation des Gregorianischen Chorals gibt es keine Pausen; anstelle 
+dessen werden @ref{Divisiones} verwendet.
+
+@seealso
+
+In diesem Handbuch: Der Abschnitt @ref{Rests} enthält eine allgemeine 
+Einführung zur Benutzung von Pausen.
+
+
+@node Ancient clefs
+@unnumberedsubsubsec Ancient clefs
+
+@cindex Schlüssel, Alte Musik
+
+
+LilyPond unterstützt eine große Anzahl von Notenschlüsseln, von denen eine 
+ganze Anzahl für die Alte Musik geeignet ist.
+
+In der Tabelle unten werden alle Schlüssel für die Alte Musik gezeigt, die 
+mit dem @code{\clef}-Befehl erreicht werden. Manche Schlüssel benutzen den 
+selben Schlüssel, unterscheiden sich aber in der Notenlinie, auf der der 
+Schlüssel notiert wird. In diesem Fällen ist eine Nummer im Schlüsselnamen 
+eingefügt. Man kann aber trotzdem eine beliebige Nummer erzwingen, wie es im 
+Abschnitt @ref{Clef} beschrieben wird. Die Note, die rechts von jedem Schlüssel 
+gesetzt ist, zeigt das @code{c'} in Bezug zu dem jeweiligen Schlüssel.
+
+@multitable @columnfractions .4 .4 .2
+@item
+@b{Beschreibung}
+@tab
+@b{Unterstützte Schlüssel}
+@tab
+@b{Beispiel}
+
+@item
+Mensuraler C-Schlüssel im modernen Stil
+@tab
+@code{neomensural-c1}, @code{neomensural-c2},@*
+@code{neomensural-c3}, @code{neomensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "neomensural-c2" c
+@end lilypond
+
+@item
+Mensuraler C-Schlüssel im Petrucci-Stil, zur Benutzung auf verschiedenen 
+Notenlinien (im 
+Beispiel den Schlüssel auf der zweiten Linie)
+@tab
+@code{petrucci-c1}, @code{petrucci-c2},@*
+@code{petrucci-c3}, @code{petrucci-c4},@*
+@code{petrucci-c5}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Mensuraler F-Schlüssel im Petrucci-Stil
+@tab
+@code{petrucci-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Mensuraler G-Schlüssel im Petrucci-Stil
+@tab
+@code{petrucci-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Mensuraler C-Schlüssel im historischen Stil
+@tab
+@code{mensural-c1}, @code{mensural-c2},@*
+@code{mensural-c3}, @code{mensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Mensuraler F-Schlüssel im historischen Stil
+@tab
+@code{mensural-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Mensuraler G-Schlüssel im historischen Stil
+@tab
+@code{mensural-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Do-Schlüssel der Editio Vaticana
+@tab
+@code{vaticana-do1}, @code{vaticana-do2},@*
+@code{vaticana-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-do2"
+  c
+@end lilypond
+
+@item
+Fa-Schlüssel der Editio Vaticana
+@tab
+@code{vaticana-fa1}, @code{vaticana-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-fa2"
+  c
+@end lilypond
+
+@item
+Do-Schlüssel der Editio Medicaea
+@tab
+@code{medicaea-do1}, @code{medicaea-do2},@*
+@code{medicaea-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-do2"
+  c
+@end lilypond
+
+@item
+Fa-Schlüssel der Editio Medicaea
+@tab
+@code{medicaea-fa1}, @code{medicaea-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-fa2"
+  c
+@end lilypond
+
+@item
+Hufnagel Do-Schlüssel für den historischen Stil
+@tab
+@code{hufnagel-do1}, @code{hufnagel-do2},@*
+@code{hufnagel-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do2"
+  c
+@end lilypond
+
+@item
+Hufnagel Fa-Schlüssel für den historischen Stil
+@tab
+@code{hufnagel-fa1}, @code{hufnagel-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-fa2"
+  c
+@end lilypond
+
+@item
+Kombinierter Do/Fa-Hufnagelschlüssel für den historischen Stil
+@tab
+@code{hufnagel-do-fa}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do-fa"
+  c
+@end lilypond
+@end multitable
+
+
+
+@emph{Moderner Stil} bedeutet: @qq{Wie in modernen Editionen von 
+transkribierter Mensuralmusik benutzt.}
+
+@emph{Petrucci-Stil} bedeutet: @qq{Inspiriert von Drucken, die der berühmte 
+Notensetzer Petrucci (1466--1539) produziert hat.}
+
+@emph{Historischer Stil} bedeutet: @qq{Wie in anderen als Petruccis Editionen 
+gedruckt oder geschrieben wurde.}
+
+@emph{Editio XXX-Stil} bedeutet: @qq{Wie in der Editio XXX gedruckt 
+wird.}
+
+Petrucci verwendete C-Schlüssel mit unterschiedlich balanciertem vertikalen 
+Balken auf der linken Seite in Abhängigkeit davon, auf welcher Notenlinie 
+der Schlüssel gesetzt wird.
+
+@seealso
+
+In diesem Handbuch: siehe @ref{Clef}.
+
+@refbugs
+
+Der mensurale G-Schlüssel ist als Petrucci-G-schlüssel deklariert.
+
+
+
+@node Ancient flags
+@unnumberedsubsubsec Ancient flags
+
+@cindex Fähnchen, Alte Musik
+
+Mit der Fähnchen-(@code{flag-style})-Eigenschaft der graphischen Objekte 
+@qq{Hals} (@internalsref{Stem}) können auch Fähnchen passend zu den Notenköpfen 
+der Alten Musik gesetzt werden. Neben dem Standardstil (@code{default}) ist 
+auch ein mensuraler Stil (@code{mensural}) unterstützt.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\override Stem #'flag-style = #'mensural
+\override Stem #'thickness = #1.0
+\override NoteHead #'style = #'mensural
+\autoBeamOff
+c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
+c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
+@end lilypond
+
+Dabei ist die innerste Fahne immer vertikal auf eine Notenlinie ausgerichtet.
+
+Es gibt keinen eigenen Stil für die @qq{neomensurale} Notation. Insofern sollte 
+für das Incipit bei der Transkription mensuraler Musik der Standardstil 
+benutzt werden. Für die Notation des Gregorianischen Chorals gibt es keine 
+Fähnchen.
+
+@refbugs
+
+Die Positionierung der Fähnchen an den Hälsen ist leicht verschoben seit einer 
+Änderung in einer frühen 2.3.x-Version.
+
+Vertikale Ausrichtung der Fähnchen an einer Notenlinie geht von der Annahme 
+aus, dass der Hals entweder genau auf einer Notenlinie oder genau zwischen zwei 
+Notenlinien endet. Das ist aber nicht unbedingt immer der Fall, weil LilyPond 
+komplizierte Methoden zur Ermittlung des besten Layouts verwendet. Diese 
+Methoden sollten aber eigentlich nicht zur Notation von mensuraler Musik 
+eingesetzt werden.
+
+
+@node Ancient time signatures
+@unnumberedsubsubsec Ancient time signatures
+
+@cindex Taktart, Alte Musik
+@cindex Mensur
+
+LilyPond besitzt grundlegende Untersützung für mensurale Taktangaben. Die 
+Symbole sind starr verknüpft mit bestimmten Brüchen. Darum müssen die Werte 
+@code{n} und @code{m} der folgenden Tabelle in den Befehl 
+@code{\time n/m} eingesetzt werden, um die entsprechenden Symbole zu erhalten.
+
+@lilypond[quote,ragged-right]
+\layout {
+  indent = 0.0
+  \context {
+    \Staff
+    \remove Staff_symbol_engraver
+    \remove Clef_engraver
+    \remove Time_signature_engraver
+  }
+}
+{
+  \set Score.timing = ##f
+  \set Score.barAlways = ##t
+  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural44" }
+  s
+  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural22" }
+  s
+  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural64" }
+  s
+  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural68" }
+  \break
+  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural32" }
+  s
+  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural34" }
+  s
+  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural94" }
+  s
+  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural98" }
+  \break
+  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural48" }
+  s
+  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural24" }
+}
+@end lilypond
+
+Mit der @code{style}-Eigenschaft des Objektes @internalsref{TimeSignature} 
+können die Taktarten angewählt werden. Unterstützte Stile sind:
+@code{neomensural} und @code{mensural}. In der Tabelle oben wurde der 
+neomensurale Stil verwendet. Dieser Stil ist geeignet, um im Incipt von 
+transkribierter Mensuralmusik eingesetzt zu werden. Der mensurale Stil dagegen 
+ahmt die Form historischer Druck des 16. Jahrhunderts nach.
+
+Im folgenden Beispiel sind die unterschiedlichen Stile dargestellt.
+
+@lilypond[ragged-right,fragment,relative=1,quote]
+{
+  \fatText
+
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter default }
+
+  \override Staff.TimeSignature #'style = #'numbered
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter numbered }
+
+  \override Staff.TimeSignature #'style = #'mensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter mensural }
+
+  \override Staff.TimeSignature #'style = #'neomensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter neomensural }
+  \override Staff.TimeSignature #'style = #'single-digit
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter single-digit }
+}
+@end lilypond
+
+@seealso
+
+In diesem Handbuch: @ref{Time signature} bietet eine allgemeine Übersicht über 
+den Einsatz von Taktangaben.
+
+@refbugs
+
+Die Verhältnisse der Notenwerte ändern sich nicht, wenn die Taktart (Mensur) 
+gewechselt wird. Zum Beispiel muss das Verhältnis 1 brevis = 3 semibrevis
+(tempus perfectum) manuell erstellt werden, indem folgende Variable erstellt 
+wird:
+
+@example
+breveTP = #(ly:make-duration -1 0 3 2)
+@dots{}
+@{ c\breveTP f1 @}
+@end example
+
+@noindent
+Hiermit wird die Variable @code{breveTP} auf den Wert 
+@qq{3/2 mal 2 = 3 mal eine Ganze} gesetzt.
+
+Das @code{old6/8alt}-Symbol (ein alternatives Symbol für 6/8) kann nicht 
+mit dem Befehl @code{\time} angesprochen werden. Verwenden Sie anstatt dessen 
+eine Textbeschriftung (@code{\markup}).
+
+
+@node Ancient articulations
+@unnumberedsubsubsec Ancient articulations
+
+@cindex articulations
+
+Zusätzlich zu den Standardartikulationszeichen, wie sie im Abschnitt
+@ref{Articulations} beschrieben werden, werden auch Artikulationszeichen 
+für die Alte Musik zur Verfügung gestellt. Diese sind darauf hin geformt, dass 
+sie mit der Notation des Editio Vaticana-Stils verwendet werden können.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \override TextScript #'font-family = #'typewriter
+    \override TextScript #'font-shape = #'upright
+    \override Script #'padding = #-0.1
+    a\ictus_"ictus" \break
+    a\circulus_"circulus" \break
+    a\semicirculus_"semicirculus" \break
+    a\accentus_"accentus" \break
+    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
+  }
+}
+@end lilypond
+
+@refbugs
+
+Einige Artikulationszeichen sind vertikal zu dich an den entsprechenden 
+Notenköpfen gesetzt.
+
+Die Episem-Linie wird in vielen Fällen nicht angezeigt. Wenn sie angezeigt wird,
+ist das rechte Ende der Episem-Linie oft zu weit rechts.
+
+@node Custodes
+@unnumberedsubsubsec Custodes
+
+@cindex Custodes
+
+Ein @emph{custos} (Plural: @emph{custodes}; Lateinisch: @qq{Beschützer}) ist
+ein Symbol, das am Ende jedes Notensystems erscheint. Es nimmt die Tonhöhe 
+der ersten Note der nächsten Zeile vorweg und hilft damit dem Vortragenden, 
+die Zeilenwechsel während der Vorführung zu bewältigen.
+
+Custodes wurden bis zum 17. Jahrhundert sehr häufig in der Musiknotation 
+eingesetzt. Heute finden sie sich nur noch in einigen bestimmten 
+Notationsformen, etwa modernen Editionen des Gregorianischen Chorals wie die 
+@emph{editio vaticana}. LilyPond stellt unterschiedliche Custos-Symbole für 
+die unterschiedlichen Notationsstile zur Verfügung.
+
+Damit Custodes angezeigt werden, muss ein @internalsref{Custos_engraver} 
+im @internalsref{Staff}-Kontext gefordert werden. Der Aufruf folgt im Rahmen 
+des Layout-Kontextes, wie das folgende Beispiel zeigt.
+
+@example
+\layout @{
+  \context @{
+    \Staff
+    \consists Custos_engraver
+    Custos \override #'style = #'mensural
+  @}
+@}
+@end example
+
+Das Ergebnis sieht ungefähr folgendermaßen aus:
+
+@lilypond[quote,ragged-right]
+\score {
+{
+  a'1
+  \override Staff.Custos #'style = #'mensural
+  \break
+  g'
+}
+\layout {
+  \context { \Staff \consists Custos_engraver }
+  }
+}
+@end lilypond
+
+Das Custos-Zeichen wird von der @code{style}-Eigenschaft ausgewählt. Die 
+unterstützten Stile sind: @code{vaticana}, @code{medicaea}, @code{hufnagel}
+und @code{mensural}. Sie werden im folgenden Fragment demonstriert.
+
+@lilypond[quote,ragged-right,fragment]
+\new Lyrics \lyricmode {
+  \markup { \column {
+    \typewriter "vaticana"
+    \line { " " \musicglyph #"custodes.vaticana.u0" }
+  } }
+  \markup { \column {
+    \typewriter "medicaea"
+    \line { " " \musicglyph #"custodes.medicaea.u0" }
+  }}
+  \markup { \column {
+    \typewriter "hufnagel"
+    \line { " " \musicglyph #"custodes.hufnagel.u0" }
+  }}
+  \markup { \column {
+    \typewriter "mensural"
+    \line { " " \musicglyph #"custodes.mensural.u0" }
+  }}
+}
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{Custos}.
+
+Examples:
+@lsr{ancient,custodes@/.ly}.
+
+
+@node Divisiones
+@unnumberedsubsubsec Divisiones
+
+@cindex divisio
+@cindex divisiones
+@cindex finalis
+
+Eine @emph{divisio} (Plural: @emph{divisiones}; Latein: @qq{Teilung}) ist ein 
+Symbol des Notensystemkontextes, das benutzt wird, um Phrasierung und 
+Abschnitte im Gregorianischen Choral anzuzeigen. Die musikalische Bedeutung 
+von @emph{divisio minima}, @emph{divisio maior} und @emph{divisio maxima} kann 
+beschrieben werden als kurze, mittlere und lange Pause, ungefähr wie die 
+Atemzeichen aus dem Abschnitt @ref{Breath marks}. Das @emph{finalis}-Zeichen 
+bezeichnet nicht nur das Ende eines Chorals, sondern wird auch oft innerhalb 
+eines Antiphons/Responsoriums benutzt, um das Ende eines Abschnitts anzuzeigen.
+
+Divisiones können benutzt werden, indem die Datei @file{gregorian@/-init@/.ly}
+in die Quelldatei eingefügt wird. Hier sind die entsprechenden Definitionen 
+schon abgelegt, so dass es genügt, die Befehle @code{\divisioMinima}, 
+@code{\divisioMaior}, @code{\divisioMaxima} und @code{\finalis} an den 
+entsprechenden Stellen zu schreiben. Einige Editionen verwenden eine 
+@emph{virgula} oder @emph{caesura} anstelle der divisio minima. Darum findet 
+sich in der Datei @file{gregorian@/-init@/.ly} auch eine Definition für 
+@code{\virgula} und @code{\caesura}.
+
+@lilypondfile[quote,ragged-right]{divisiones.ly}
+
+@refcommands
+
+@funindex \virgula
+@code{\virgula},
+@funindex \caesura
+@code{\caesura},
+@funindex \divisioMinima
+@code{\divisioMinima},
+@funindex \divisioMaior
+@code{\divisioMaior},
+@funindex \divisioMaxima
+@code{\divisioMaxima},
+@funindex \finalis
+@code{\finalis}.
+
+@seealso
+
+In diesem Handbuch: @ref{Breath marks}.
+
+Programmreferenz: @internalsref{BreathingSign}.
+
+Beispiele: @lsr{expressive,breathing-sign.ly}.
+
+@node Ligatures
+@unnumberedsubsubsec Ligatures
+
+@cindex Ligaturen
+
+@c TODO: Should double check if I recalled things correctly when I wrote
+@c down the following paragraph by heart.
+
+Eine Ligatur ist ein graphisches Symbol das wenigstens zwei unterschiedliche 
+Noten darstellt. Ligaturen treten ursprünglich in Manuskripten des 
+Gregorianischen Chorals auf, um auf- oder absteigende Notensequenzen zu 
+notieren.
+
+Ligaturen werden eingegeben, indem die dazugehörigen Noten zwischen
+@code{\[} und @code{\]} eingeschlossen werden. Einige Ligaturstile benötigen 
+zusätzliche Syntax für eine bestimmte Ligatur. In der Standardeinstellung
+setzt der @internalsref{LigatureBracket} ganz einfach eckige Klammern über 
+die Noten der Ligatur.
+
+@lilypond[quote,ragged-right,verbatim]
+\transpose c c' {
+  \[ g c a f d' \]
+  a g f
+  \[ e f a g \]
+}
+@end lilypond
+
+Um einen gestimmten Ligaturstil auszuwählen, muss ein entsprechender 
+Ligatur-Engraver zum Stimmkontext hinzugefügt werden, wie in den folgenden 
+Abschnitten erklärt wird. Nur weiße Mensuralligaturen sind unterstützt -- mit 
+Einschränkungen.
+
+
+@refbugs
+
+Ligaturen benötigen von klassischer Notation unterschiedliche Platzaufteilung, 
+was sie aber noch nicht können. Darum ist fast immer zu viel Platz zwischen 
+Ligaturen und Zeilenumbrüche sind ungenügend. Text lässt sich auch nicht 
+richtig an Ligaturen ausrichten.
+
+Akzidenzien dürfen nicht innerhalb von einer Ligatur gedruckt werden, sondern 
+müssen gesammelt und vor der Ligatur ausgegeben werden.
+
+Die Syntax verwendet immer noch den verworfenen Infix-Stil (@code{\[ 
+musik. Ausdr. \]}). Für die Konsistenz soll dies geändert werden in den 
+Postfix-Stil (@code{Note\[ ... Note\]}). Alternativ kann die Datei 
+@file{gregorian@/-init@/.ly} eingefügt werden, die eine Scheme-Funktion
+@example
+\ligature @var{musik. Ausdr.}
+@end example
+mit der selben Wirkung zur Verfügung stellt und stabil zu sein scheint.
+
+@menu
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+@end menu
+
+@node White mensural ligatures
+@unnumberedsubsubsec White mensural ligatures
+
+@cindex Mensuralligaturen
+@cindex Weiße Mensuralligaturen
+@cindex Ligaturen, weiße Mensuralnotation
+
+Begrenzte Unterstützung für Ligaturen der weißen Mensuralnotation.
+
+Um weiße Mensuralligaturen zu benutzen, muss innerhalb des Layout-Blocks 
+im @internalsref{Voice}-Kontext der @internalsref{Mensural_ligature_engraver}
+aktiviert werden und gleichzeitig der 
+@internalsref{Ligature_bracket_engraver} (der die Klammern über den Noten 
+setzt) entfernt werden, wie im Beispiel.
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \remove Ligature_bracket_engraver
+    \consists Mensural_ligature_engraver
+  @}
+@}
+@end example
+
+Zusätzlich zu diesen Einstellungen gibt es keine eigenen Befehle, die die 
+Form einer Ligatur bestimmen. Die Form wird vielmehr aus Tonhöhen und 
+Tondauern der in Klammern gesetzten Noten geschlossen. Diese 
+Herangehensweise erfordert einige Eingewöhnung, hat aber den großen 
+Vorteil, dass der musikalische Inhalt der Ligatur dem Programm bekannt ist.
+Das ist nicht nur notwendig für korrekte MIDI-Ausgabe, sondern erlaubt 
+es auch, automatische Transkriptionen von Ligaturen anzufertigen.
+
+Eine Datei kann zum Beispiel so aussehen:
+
+@example
+\set Score.timing = ##f
+\set Score.defaultBarType = "empty"
+\override NoteHead #'style = #'neomensural
+\override Staff.TimeSignature #'style = #'neomensural
+\clef "petrucci-g"
+\[ c'\maxima g \]
+\[ d\longa c\breve f e d \]
+\[ c'\maxima d'\longa \]
+\[ e'1 a g\breve \]
+@end example
+@lilypond[quote,ragged-right]
+\score {
+  \transpose c c' {
+    \set Score.timing = ##f
+    \set Score.defaultBarType = "empty"
+    \override NoteHead #'style = #'neomensural
+    \override Staff.TimeSignature #'style = #'neomensural
+    \clef "petrucci-g"
+    \[ c'\maxima g \]
+    \[ d\longa c\breve f e d \]
+    \[ c'\maxima d'\longa \]
+    \[ e'1 a g\breve \]
+  }
+  \layout {
+    \context {
+      \Voice
+      \remove Ligature_bracket_engraver
+      \consists Mensural_ligature_engraver
+    }
+  }
+}
+@end lilypond
+
+Wenn der @internalsref{Ligature_bracket_engraver} nicht durch den
+@internalsref{Mensural_ligature_engraver} ersetzt wird, werden die Noten 
+wie folgt ausgegeben:
+
+@lilypond[quote,ragged-right]
+\transpose c c' {
+  \set Score.timing = ##f
+  \set Score.defaultBarType = "empty"
+  \override NoteHead #'style = #'neomensural
+  \override Staff.TimeSignature #'style = #'neomensural
+  \clef "petrucci-g"
+  \[ c'\maxima g \]
+  \[ d\longa c\breve f e d \]
+  \[ c'\maxima d'\longa \]
+  \[ e'1 a g\breve \]
+}
+@end lilypond
+
+@refbugs
+
+Die horizontale Positionierung ist sehr schlecht.
+
+@node Gregorian square neumes ligatures
+@unnumberedsubsubsec Gregorian square neumes ligatures
+
+@cindex Quadratische Neumenligaturen
+@cindex Gregorianische quadratische Neumenligaturen
+@cindex Ligaturen der quadratischen Neumennoation
+
+Beschränkte Unterstützung für gregorianische Quadratneumen-Ligaturen 
+(nach dem Stil der Editio Vaticana) ist vorhanden. Die wichtigsten 
+Ligaturen können schon gesetzt werden, aber wichtige Eigenschaften 
+anspruchsvoller Typographie wie horizontale Ausrichtung von mehreren 
+Ligaturen, korrekte Silbenpositionierung und richtiger Umgang mit 
+Versetzungszeichen fehlen noch.
+
+Die folgende Tabelle enthält die erweiterte Neumenliste des zweiten Bands des 
+ Antiphonale Romanum (@emph{Liber Hymnarius}), 
+1983 von den Mönchen von Solesmes herausgegeben.
+
+@multitable @columnfractions .4 .2 .2 .2
+
+@item
+@b{Neuma aut@*
+Neumarum Elementa}
+@tab
+@b{Figurae@*
+Rectae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Auctae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Deminutae}
+
+@c TODO: \layout block is identical in all of the below examples.
+@c Therefore, it should somehow be included rather than duplicated all
+@c the time. --jr
+
+@c why not make identifiers in ly/engraver-init.ly? --hwn
+
+@c Because it's just used to typeset plain notes without
+@c a staff for demonstration purposes rather than something
+@c special of Gregorian chant notation. --jr
+
+@item
+@code{1. Punctum}
+@tab
+@lilypond[staffsize=26,line-width=1.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum
+    \[ b \]
+    \noBreak s^\markup {"a"} \noBreak
+
+    % Punctum Inclinatum
+    \[ \inclinatum b \]
+    \noBreak s^\markup {"b"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Auctum Ascendens
+    \[ \auctum \ascendens b \]
+    \noBreak s^\markup {"c"} \noBreak
+
+    % Punctum Auctum Descendens
+    \[ \auctum \descendens b \]
+    \noBreak s^\markup {"d"} \noBreak
+
+    % Punctum Inclinatum Auctum
+    \[ \inclinatum \auctum b \]
+    \noBreak s^\markup {"e"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Inclinatum Parvum
+    \[ \inclinatum \deminutum b \]
+    \noBreak s^\markup {"f"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{2. Virga}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Virga
+    \[ \virga b \]
+    \noBreak s^\markup {"g"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{3. Apostropha vel Stropha}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha
+    \[ \stropha b \]
+    \noBreak s^\markup {"h"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha Aucta
+    \[ \stropha \auctum b \]
+    \noBreak s^\markup {"i"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{4. Oriscus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Oriscus
+    \[ \oriscus b \]
+    \noBreak s^\markup {"j"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{5. Clivis vel Flexa}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis vel Flexa
+    \[ b \flexa g \]
+    s^\markup {"k"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis Aucta Descendens
+    \[ b \flexa \auctum \descendens g \]
+    \noBreak s^\markup {"l"} \noBreak
+
+    % Clivis Aucta Ascendens
+    \[ b \flexa \auctum \ascendens g \]
+    \noBreak s^\markup {"m"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Cephalicus
+    \[ b \flexa \deminutum g \]
+    s^\markup {"n"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{6. Podatus vel Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Podatus vel Pes
+    \[ g \pes b \]
+    s^\markup {"o"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens
+    \[ g \pes \auctum \descendens b \]
+    \noBreak s^\markup {"p"} \noBreak
+
+    % Pes Auctus Ascendens
+    \[ g \pes \auctum \ascendens b \]
+    \noBreak s^\markup {"q"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Epiphonus
+    \[ g \pes \deminutum b \]
+    s^\markup {"r"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{7. Pes Quassus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus
+    \[ \oriscus g \pes \virga b \]
+    s^\markup {"s"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus Auctus Descendens
+    \[ \oriscus g \pes \auctum \descendens b \]
+    s^\markup {"t"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{8. Quilisma Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes
+    \[ \quilisma g \pes b \]
+    s^\markup {"u"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes Auctus Descendens
+    \[ \quilisma g \pes \auctum \descendens b \]
+    s^\markup {"v"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{9. Podatus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Initio Debilis
+    \[ \deminutum g \pes b \]
+    s^\markup {"w"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens Initio Debilis
+    \[ \deminutum g \pes \auctum \descendens b \]
+    s^\markup {"x"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{10. Torculus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus
+    \[ a \pes b \flexa g \]
+    s^\markup {"y"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens
+    \[ a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"z"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus
+    \[ a \pes b \flexa \deminutum g \]
+    s^\markup {"A"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{11. Torculus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Initio Debilis
+    \[ \deminutum a \pes b \flexa g \]
+    s^\markup {"B"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens Initio Debilis
+    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"C"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus Initio Debilis
+    \[ \deminutum a \pes b \flexa \deminutum g \]
+    s^\markup {"D"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{12. Porrectus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus
+    \[ a \flexa g \pes b \]
+    s^\markup {"E"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Auctus Descendens
+    \[ a \flexa g \pes \auctum \descendens b \]
+    s^\markup {"F"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Deminutus
+    \[ a \flexa g \pes \deminutum b \]
+    s^\markup {"G"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{13. Climacus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus
+    \[ \virga b \inclinatum a \inclinatum g \]
+    s^\markup {"H"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Auctus
+    \[ \virga b \inclinatum a \inclinatum \auctum g \]
+    s^\markup {"I"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Deminutus
+    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
+    s^\markup {"J"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{14. Scandicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus
+    \[ g \pes a \virga b \]
+    s^\markup {"K"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Auctus Descendens
+    \[ g \pes a \pes \auctum \descendens b \]
+    s^\markup {"L"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Deminutus
+    \[ g \pes a \pes \deminutum b \]
+    s^\markup {"M"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{15. Salicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus
+    \[ g \oriscus a \pes \virga b \]
+    s^\markup {"N"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus Auctus Descendens
+    \[ g \oriscus a \pes \auctum \descendens b \]
+    s^\markup {"O"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{16. Trigonus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Trigonus
+    \[ \stropha b \stropha b \stropha a \]
+    s^\markup {"P"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@tab
+
+@end multitable
+
+Anders als in den meisten Neumennotationssystemen zeigt der Quellcode 
+von LilyPond nicht das typographische Aussehen der Ligatur an, sondern 
+deren musikalischen Inhalt. Der Code  @code{\[ a \pes b
+\flexa g \]} etwa ergibt einen Torculus, der aus drei Punctum-Köpfen besteht, 
+während @code{\[ a \flexa g \pes b \]} einen Porrectus mit einer gekrümmten 
+Flexa und einem einzelnen Punctum ausgibt.
+Es gibt also keinen Befehl, der explizit eine gekrümmte Flexa setzen würde; 
+die Entscheidung, wann diese gesetzt werden soll hängt vielmehr davon ab, 
+welcher musikalische Inhalt dargestellt werden soll. Der Sinn dieser 
+Herangehensweise ist es, den Inhalt von der graphischen Repräsentation zu 
+trennen. Auf diese Art kann mit der gleichen Eingabe ein anderer gregorianischer 
+Stil gesetzt werden, ohne die Notation zu verändern.
+
+Die folgende Tabelle zeigt Code-Fragmente, mit denen die Ligaturen der vorigen 
+Tabelle erstellt werden können. Der Buchstabe in der ersten Spalte jeder Zeile 
+der unteren Tabelle zeigt an, auf welche Ligatur in der vorigen Tabelle sie sich 
+bezieht. In der zweiten Spalte erscheint die Bezeichnung der Ligatur. Die dritte 
+Spalte enthält das Fragment, mit dem die Ligatur erzeugt wurde, wobei 
+@code{g}, @code{a} und @code{b} als Beispieltonhöhen eingesetzt werden.
+
+@multitable @columnfractions .02 .31 .67
+@item
+@b{#}
+@tab
+@b{Name}
+@tab
+@b{Input Language}
+
+@item
+a
+@tab
+Punctum
+@tab
+@code{\[ b \]}
+
+@item
+b
+@tab
+Punctum Inclinatum
+@tab
+@code{\[ \inclinatum b \]}
+
+@item
+c
+@tab
+Punctum Auctum@*
+Ascendens
+@tab
+@code{\[ \auctum \ascendens b \]}
+
+@item
+d
+@tab
+Punctum Auctum@*
+Descendens
+@tab
+@code{\[ \auctum \descendens b \]}
+
+@item
+e
+@tab
+Punctum Inclinatum@*
+Auctum
+@tab
+@code{\[ \inclinatum \auctum b \]}
+
+@item
+f
+@tab
+Punctum Inclinatum@*
+Parvum @tab
+@code{\[ \inclinatum \deminutum b \]}
+
+@item
+g
+@tab
+Virga
+@tab
+@code{\[ \virga b \]}
+
+@item
+h
+@tab
+Stropha
+@tab
+@code{\[ \stropha b \]}
+
+@item
+i
+@tab
+Stropha Aucta
+@tab
+@code{\[ \stropha \auctum b \]}
+
+@item
+j
+@tab
+Oriscus
+@tab
+@code{\[ \oriscus b \]}
+
+@item
+k
+@tab
+Clivis vel Flexa
+@tab
+@code{\[ b \flexa g \]}
+
+@item
+l
+@tab
+Clivis Aucta@*
+Descendens
+@tab
+@code{\[ b \flexa \auctum \descendens g \]}
+
+@item
+m
+@tab
+Clivis Aucta@*
+Ascendens
+@tab
+@code{\[ b \flexa \auctum \ascendens g \]}
+
+@item
+n
+@tab
+Cephalicus
+@tab
+@code{\[ b \flexa \deminutum g \]}
+
+@item
+o
+@tab
+Podatus vel Pes
+@tab
+@code{\[ g \pes b \]}
+
+@item
+p
+@tab
+Pes Auctus@*
+Descendens
+@tab
+@code{\[ g \pes \auctum \descendens b \]}
+
+@item
+q
+@tab
+Pes Auctus@*
+Ascendens
+@tab
+@code{\[ g \pes \auctum \ascendens b \]}
+
+@item
+r
+@tab
+Epiphonus
+@tab
+@code{\[ g \pes \deminutum b \]}
+
+@item
+s
+@tab
+Pes Quassus
+@tab
+@code{\[ \oriscus g \pes \virga b \]}
+
+@item
+t
+@tab
+Pes Quassus@*
+Auctus Descendens @tab
+@code{\[ \oriscus g \pes \auctum \descendens b \]}
+
+@item
+u
+@tab
+Quilisma Pes
+@tab
+@code{\[ \quilisma g \pes b \]}
+
+@item
+v
+@tab
+Quilisma Pes@*
+Auctus Descendens
+@tab
+@code{\[ \quilisma g \pes \auctum \descendens b \]}
+
+@item
+w
+@tab
+Pes Initio Debilis
+@tab
+@code{\[ \deminutum g \pes b \]}
+
+@item
+x
+@tab
+Pes Auctus Descendens@*
+Initio Debilis
+@tab
+@code{\[ \deminutum g \pes \auctum \descendens b \]}
+
+@item
+y
+@tab
+Torculus
+@tab
+@code{\[ a \pes b \flexa g \]}
+
+@item
+z
+@tab
+Torculus Auctus@*
+Descendens
+@tab
+@code{\[ a \pes b \flexa \auctum \descendens g \]}
+
+@item
+A
+@tab
+Torculus Deminutus
+@tab
+@code{\[ a \pes b \flexa \deminutum g \]}
+
+@item
+B
+@tab
+Torculus Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa g \]}
+
+@item
+C
+@tab
+Torculus Auctus@*
+Descendens Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
+
+@item
+D
+@tab
+Torculus Deminutus@*
+Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
+
+@item
+E
+@tab
+Porrectus
+@tab
+@code{\[ a \flexa g \pes b \]}
+
+@item
+F
+@tab
+Porrectus Auctus@*
+Descendens
+@tab
+@code{\[ a \flexa g \pes \auctum \descendens b \]}
+
+@item
+G
+@tab
+Porrectus Deminutus
+@tab
+@code{\[ a \flexa g \pes \deminutum b \]}
+
+@item
+H
+@tab
+Climacus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum g \]}
+
+@item
+I
+@tab
+Climacus Auctus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
+
+@item
+J
+@tab
+Climacus Deminutus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
+
+@item
+K
+@tab
+Scandicus
+@tab
+@code{\[ g \pes a \virga b \]}
+
+@item
+L
+@tab
+Scandicus Auctus@*
+Descendens
+@tab
+@code{\[ g \pes a \pes \auctum \descendens b \]}
+
+@item
+M
+@tab
+Scandicus Deminutus
+@tab
+@code{\[ g \pes a \pes \deminutum b \]}
+
+@item
+N
+@tab
+Salicus
+@tab
+@code{\[ g \oriscus a \pes \virga b \]}
+
+@item
+O
+@tab
+Salicus Auctus Descendens
+@tab
+@code{\[ g \oriscus a \pes \auctum \descendens b \]}
+
+@item
+P
+@tab
+Trigonus
+@tab
+@code{\[ \stropha b \stropha b \stropha a \]}
+@end multitable
+
+Die Ligaturen dieser Liste dienen als begrenzter, aber doch 
+repräsentativer Vorrat an Ligaturbeispielen des Gregorianischen 
+Chorals. Innerhalb der Ligaturbegrenzungen  @code{\[} und 
+@code{\]}  kann jedoch problemlos jede nur mögliche Anzahl an 
+Noten gesetzt werden, und Präfixe wie 
+@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
+usw können nach Belieben gemischt werden. Die Regeln, 
+die der Konstruktion der Ligaturen in den Tabellen zugrunde liegen, 
+werden entsprechend angepasst. Auf diese Weise können unendlich 
+viele Ligaturen gesetzt werden.
+
+Augmentum-Punkte, auch @emph{morae} genannt, werden mit dem 
+Befehl @code{\augmentum} hinzugefügt. @code{\augmentum} ist allerdings 
+als eigene musikalische Funktion gebaut und nicht als ein Notenpräfix. 
+Insofern hat der Befehl in diesem Kontext:
+@code{\augmentum \virga c} keine sichtbaren Auswirkungen. Erst mit 
+@code{\virga \augmentum c} oder @code{\augmentum @{\virga c@}}
+funktionieren beide Befehle. Es ist auch möglich, mit 
+@code{\augmentum @{a g@}} die Schreibweise 
+@code{\augmentum a \augmentum g} abzukürzen.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \[ \augmentum a \flexa \augmentum g \]
+    \augmentum g
+  }
+}
+@end lilypond
+
+@refcommands
+
+Folgende Notenpräfixe sind unterstützt:
+
+@funindex \virga
+@code{\virga},
+@funindex \stropha
+@code{\stropha},
+@funindex \inclinatum
+@code{\inclinatum},
+@funindex \auctum
+@code{\auctum},
+@funindex \descendens
+@code{\descendens},
+@funindex \ascendens
+@code{\ascendens},
+@funindex \oriscus
+@code{\oriscus},
+@funindex \quilisma
+@code{\quilisma},
+@funindex \deminutum
+@code{\deminutum},
+@funindex \cavum
+@code{\cavum},
+@funindex \linea
+@code{\linea}.
+
+Präfixe können kombiniert werden, wenn es hier auch Begrenzungen 
+gibt. Zum Beispiel können die Präfixe @code{\descendens} oder 
+@code{\ascendens} vor einer Note geschrieben werden, aber nicht 
+beide für die selbe Note
+.
+@funindex \pes
+@funindex \flexa
+Zwei benachbarte Noten können mit den @code{\pes} und
+@code{\flexa}-Infixen verbunden werden, um eine steigende bwz. 
+fallende Melodielinie zu notieren.
+
+@funindex \augmentum
+Die musikalische Funktion @code{\augmentum} muss benutzt werden, um 
+augmentum-Punkte hinzuzufügen.
+
+@refbugs
+
+Wenn ein @code{\augmentum}-Punkt am Ende des letzten Systems innerhalb 
+einer Ligatur gesetzt wird, ist er vertikal etwas falsch positioniert. Als 
+Abhilfe kann eine unsichtbare Note (z. B. @code{s8}) als letzte Note im 
+System eingegeben werden.
+
+@code{\augmentum} sollte als Präfix implementiert sein, nicht als eigene 
+musikalische Funktion, so dass @code{\augmentum} mit den anderen 
+Präfixen in arbiträrer Reihenfolge notiert werden kann.
+
+@node Gregorian Chant contexts
+@unnumberedsubsubsec Gregorian Chant contexts
+
+@cindex VaticanaVoiceContext
+@cindex VaticanaStaffContext
+
+Die vordefinierten Kontexte @code{VaticanaVoiceContext} (für eine 
+gregorianische Stimme) und @code{VaticanaStaffContext} (für ein 
+gregorianisches Notensystem) können eingesetzt werden, um 
+Gregorianischen Choral im Stil der Editio Vaticana zu setzen. Diese 
+Kontexte initialisieren alle relevanten Eigenschaften für das Notensystem 
+und die graphischen Objekte, so dass unmittelbar mit der Notation 
+begonnen werden kann. Siehe das folgende Beispiel:
+
+@lilypond[quote,ragged-right,packed,verbatim]
+\include "gregorian-init.ly"
+\score {
+  <<
+    \new VaticanaVoice = "cantus" {
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \]
+      f \divisioMinima
+      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
+      c' \divisioMinima \break
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
+    }
+    \new Lyrics \lyricsto "cantus" {
+      San- ctus, San- ctus, San- ctus
+    }
+  >>
+}
+@end lilypond
+
+
+@node Mensural contexts
+@unnumberedsubsubsec Mensural contexts
+
+@cindex MensuralVoiceContext
+@cindex MensuralStaffContext
+
+
+Die vordefinierten Kontexte @code{MensuralVoiceContext} und
+@code{MensuralStaffContext} können eingesetzt werden, um 
+ein Stück in Mensuralnotations zu schreiben. Die Kontexte 
+initialisieren alle relevanten Eigenschaften der Kontexte und 
+graphischen Objekte, so dass unmittelbar mit der Notation begonnen 
+werden kann. Siehe das folgende Beispiel:
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new MensuralVoice = "discantus" \transpose c c' {
+      \override Score.BarNumber #'transparent = ##t {
+        c'1\melisma bes a g\melismaEnd
+        f\breve
+        \[ f1\melisma a c'\breve d'\melismaEnd \]
+        c'\longa
+        c'\breve\melisma a1 g1\melismaEnd
+        fis\longa^\signumcongruentiae
+      }
+    }
+    \new Lyrics \lyricsto "discantus" {
+      San -- ctus, San -- ctus, San -- ctus
+    }
+  >>
+}
+@end lilypond
+
+@node Musica ficta accidentals
+@unnumberedsubsubsec Musica ficta accidentals
+
+In der europäischen Musik vor 1600 wurden vom Sänger oftmals 
+chromatische Alterationen erwartet, die nicht notiert wurden. 
+Diese Praxis wird @qq{Musica Ficta} genannt. In modernen 
+Transkripition werden die Versetzungszeichen üblicherweise 
+oberhalb der Noten gesetzt.
+
+@cindex Versetzungszeichen, musica ficta
+@cindex Musica ficta
+
+Unterstützung für solche empfohlenen Versetzungszeichen ist 
+implementiert und kann aktiviert werden, indem die 
+Eigenschaft @code{suggestAccidentals} auf wahr gesetzt wird. 
+Siehe auch das Beispiel.
+
+@funindex suggestAccidentals
+
+@lilypond[verbatim,fragment,relative=1]
+fis gis
+\set suggestAccidentals = ##t
+ais bis
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{Accidental_engraver}-Setzer und das
+@internalsref{AccidentalSuggestion}-Objekt.
+
+@node Figured bass
+@unnumberedsubsubsec Figured bass
+
+@cindex Basso continuo
+@cindex Generalbass
+@cindex Bezifferter Bass
+
+@c TODO: musicological blurb about FB
+
+
+LilyPond stellt Unterstützung für Generalbassnotation zur Verfügung.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+<<
+  \new Voice { \clef bass dis4 c d ais g fis}
+  \new FiguredBass \figuremode {
+    < 6 >4 < 7\+ >8 < 6+ [_!] >
+    < 6 >4 <6 5 [3+] >
+    < _ >4 < 6 5/>4
+  }
+>>
+@end lilypond
+
+Die Unterstützung besteht aus zwei Teilen: Es gibt einen Eingabe-Modus,
+aktiviert durch den Befehl @code{\figuremode}, in dem Ziffern für den Bass 
+als Nummern eingegeben werden können, und einen Kontext
+ @internalsref{FiguredBass}, der dafür sorgt, dass die entsprechenden 
+ @internalsref{BassFigure}-Objekte auch erstellt werden.
+
+Im Eingabemodus wird eine Gruppe von Bassziffern mit den Zeichen
+@code{<} and @code{>} begrenzt. Die Dauer wird nach dem @code{>}-Zeichen 
+eingegeben.
+
+@example
+<4 6>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { <4 6> }
+@end lilypond
+
+Versetzungszeichen werden durch Anhängen von @code{-}, @code{!} und @code{+}
+hinter die Nummern erreicht. Ein Pluszeichen wird mit dem Befehl @code{\+}
+gesetzt, verminderte Quinten und Septimen mit @code{5/} und @code{7/}.
+
+@example
+<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@end lilypond
+
+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}.
+
+@example
+< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@end lilypond
+
+Es ist auch möglich, Vortsetzungslinien für wiederholte Ziffern zu benutzen.
+
+@lilypond[verbatim,relative=1]
+<<
+  \new Staff {
+    \clef bass
+    c4 c c
+  }
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <4 6> <3 6> <3 7>
+  }
+>>
+@end lilypond
+
+@noindent
+In diesem Fall werden wiederholte Ziffern immer durch eine Linie ersetzt.
+
+Der @code{FiguredBass}-Kontext kümmert sich nicht um die aktuelle Basslinie.
+Als Konsequenz müssen eventuell zusätzliche Ziffern eingefügt werden, um 
+Linien unter alle Noten zu erhalten, und die Verwendung von @code{\!}
+kann nötig werden, um zu lange Linien zu stoppen.
+
+@lilypond[relative=1]
+<<
+  \new Voice
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+  }
+  {
+    \clef bass
+    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+  }
+>>
+@end lilypond
+Bei der Benutzung von Linien werden gemeinsame Ziffern immer in die 
+gleiche vertikale Position gesetzt. Wenn dies nicht gewünscht ist, 
+können Pausen (@code{r}) eingefügt werden. Dadurch wird die vorangegangene
+Positionierung aufgehoben. So kann man etwa 
+
+@example
+  <4 6>8 r8
+@end example
+
+@noindent
+anstelle von
+@example
+  <4 6>4
+@end example
+
+@noindent
+schreiben.
+
+Versetzungszeichen und Pluszeichen können vor oder nach den Ziffern stehen, 
+abhängig von den @code{figuredBassAlterationDirection}- und
+@code{figuredBassPlusDirection}-Eigenschaften.
+
+@lilypond
+  \figures {
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassPlusDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #-1
+    <6\+> <5+> <6 4-> r
+  }
+@end lilypond
+
+Auch wenn die Unterstützung für bezifferten Bass anscheinend an die 
+Akkord-Notation erinnert, ist sie doch sehr viel einfacher. Der Modus 
+@code{\figuremode} speichert einfach die Ziffern und  der
+@internalsref{FiguredBass}-Kontext gibt sie so aus, wie sie notiert 
+werden. Es gibt also keine Umrechnung von Tonhöhen und die Notation 
+wird in der MIDI-Datei nicht umgesetzt.
+
+Programmintern erstellt die Funktion einfache Textbeschriftung. Somit 
+sind alle Textbeschriftungsbefehle verfügbar, um die Formatierungen zu 
+verändern. So kann zum Beispiel die vertikale Position der Ziffern mit 
+@code{baseline-skip} gesetzt werden.
+
+Bassziffern können auch direkt einem Notensystemkontext (@code{Staff})
+hinzugefügt werden. In diesem Fall wird ihre vertikale Position automatisch 
+bestimmt.
+
+@lilypond[ragged-right,fragment,quote]
+<<
+  \new Staff = someUniqueName
+  \relative c'' {
+    c4 c'8 r8 c,4 c'
+  }
+
+  %% send to existing Staff.
+  \context Staff = someUniqueName 
+  \figuremode {
+    <4>4 <6 10>8 s8
+    
+    \set Staff.useBassFigureExtenders = ##t
+    <4 6>4 <4 6>
+  }
+>>
+@end lilypond
+
+@commonprop
+
+In der Standardeinstellung werden die Bassziffern über den Noten 
+ausgegeben. Um Ziffern unter den Noten zu erhalten, kann der 
+Befehl
+
+@example
+\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
+@end example
+
+@noindent
+benutzt werden.
+
+
+@refbugs
+
+Wenn Bassziffern über dem Notensystem mit Ergänzungslinien und
+@code{implicitBassFigures}  benutzt werden, kann es vorkommen, dass 
+die Linien vertauscht werden. Besonders kritisch wird es, wenn 
+mehrere Bassziffern sich überschneidende Linien haben. Um dieses 
+Problem zu vermeiden, sollte @code{stacking-dir} 
+im @code{BassFigureAlignment} benutzt werden.
+
+
+@seealso
+
+Programmreferenz: @internalsref{NewBassFigure}-,
+@internalsref{BassFigureAlignment}-, @internalsref{BassFigureLine}-,
+@internalsref{BassFigureBracket}- und
+@internalsref{BassFigureContinuation}-Objekte und der
+@internalsref{FiguredBass}-Kontext.
+
+
+
diff --git a/Documentation/de/user/bagpipes.itely b/Documentation/de/user/bagpipes.itely
new file mode 100644
index 0000000000..95903e0ac3
--- /dev/null
+++ b/Documentation/de/user/bagpipes.itely
@@ -0,0 +1,119 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Bagpipes
+@section Bagpipes
+
+This section includes extra information for writing for bagpipes.
+
+@menu 
+* Bagpipe::
+@end menu
+
+@node Bagpipe
+@subsection Bagpipe
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* Bagpipe definitions::
+* Bagpipe example::
+@end menu
+
+@node Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+LilyPond besitzt spezielle Definitionen, mit der die Musik 
+des schottischen Hochland-Dudelsacks notiert wird. Um sie 
+zu benutzen, muss
+
+@example
+\include "bagpipe.ly"
+@end example
+
+@noindent
+am Anfang der LilyPond-Quelldatei eingefügt werden. Hierdurch 
+können dann bestimmte Verzierungsnoten, die für die Dudelsackmusik 
+üblich sind, mit kurzen Befehlen eingefügt werden. So reicht etwa der 
+Befehl @code{\taor}, anstatt
+
+@example
+\grace @{ \small G32[ d G e] @}
+@end example
+
+@noindent zu schreiben.
+
+@code{bagpipe.ly} enthält außerdem Definitionen für Tonhöhen von 
+Dudelsacknoten in bestimmten Oktoven, so dass man sich nicht mehr um
+@code{\relative} oder @code{\transpose} kümmern muss.
+
+@lilypond[ragged-right,verbatim,quote,notime]
+\include "bagpipe.ly"
+{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
+@end lilypond
+
+Musik für den Dudelsack wird dem Namen nach in D-dur
+ geschrieben (auch wenn das eigentlich nicht stimmt). Weil 
+ das aber die einzige Tonart ist, die benutzt werden kann, werden 
+ die Vorzeichen meistens nicht geschrieben. Damit das funktioniert, 
+ müssen die Noten immer mit @code{\hideKeySignature} beginnen. 
+ Wenn die Vorzeichen hingegen angezeigt werden sollen, kann das 
+ mithilfe des Befehls @code{\showKeySignature} vorgenommen werden.
+
+Some modern music use cross fingering on c and f to flatten those notes.
+This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
+piobaireachd high g can be written @code{gflat} when it occurs in light
+music.
+
+
+@node Bagpipe example
+@unnumberedsubsubsec Bagpipe example
+
+So sieht die bekannte Melodie Amazing Grace aus, wenn man sie für 
+Dudelsack notiert.
+
+@lilypond[verbatim,quote]
+\include "bagpipe.ly"
+\layout {
+  indent = 0.0\cm
+  \context { \Score \remove "Bar_number_engraver" }
+}
+
+\header {
+  title = "Amazing Grace"
+  meter = "Hymn"
+  arranger = "Trad. arr."
+}
+
+{
+  \hideKeySignature
+  \time 3/4
+  \grg \partial 4 a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg e8. f16
+  \dblA A2 \grg A4
+  \grg A2 f8. A16
+  \grg A2 \hdblf f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 e4
+  \thrwd d2.
+  \slurd d2
+  \bar "|."
+}
+@end lilypond
+
+
diff --git a/Documentation/de/user/basic-notation.itely b/Documentation/de/user/basic-notation.itely
deleted file mode 100644
index 7d1a1819ca..0000000000
--- a/Documentation/de/user/basic-notation.itely
+++ /dev/null
@@ -1,3704 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: ad389dc87664ea7cf89ae5b87ef4c591d9a29f14
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Basic notation
-@chapter Basic notation
-
-In diesem Kapitel wird die Notation der am häufigsten benutzten 
-Notationsformen und -elemente vorgestellt.
-
-@menu
-* Pitches::                     
-* Rhythms::                     
-* Polyphony::                   
-* Staff notation::              
-* Connecting notes::            
-* Expressive marks::            
-* Repeats::                     
-@end menu
-
-
-
-@node Pitches
-@section Pitches
-In diesem Abschnitt wird behandelt, wie die Tonhöhe angegeben wird.
-
-@menu
-* Normal pitches::              
-* Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
-* Note names in other languages::  
-* Relative octaves::            
-* Octave check::                
-* Transpose::                   
-* Rests::                       
-* Skips::                       
-@end menu
-
-
-@node Normal pitches
-@subsection Normal pitches
-
-@cindex Tonhöhenbezeichnungen
-
-
-Tonhöhenbezeichnungen werden durch Kleinbuchstaben von
-@code{a} bis @code{g} angegeben.@footnote{Die Benutzung deutscher 
-Notenbezeichnungen mit der Unterscheidung von b und h ist 
-auch möglich, siehe @ref{Note names in other languages}.}
-Eine aufsteigende C-Dur-Tonleiter wird wie folgt notiert:
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef bass
-c d e f g a b c'
-@end lilypond
-
-Die Notenbezeichnung @code{c} schreibt als Note ein kleines 
-C, eine Oktave unter dem eingestrichenen C.
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef treble
-c1
-\clef bass
-c1
-@end lilypond
-
-@funindex '
-@funindex ,
-
-Zusätzliche Oktavbestimmung wird mit einer Anzahl von 
-Apostrophen (@q{'}) oder Kommas (@q{,}) vorgenommen. 
-Jeder Apostroph erhöht die Note um eine Oktave, jedes 
-Komma erniedrigt sie um eine Oktave.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\clef treble
-c' c'' e' g d'' d' d c
-\clef bass
-c, c,, e, g d,, d, d c
-@end lilypond
-
-Eine alternative Methode gibt am Anfang die Oktave vor, 
-innerhalb derer die Noten gesetzt werden, dabei werden 
-unter Umständen weniger Oktavangaben (@code{'} oder @code{,})
-benötigt. Siehe auch 
-@ref{Relative octaves}.
-
-
-@node Accidentals
-@subsection Accidentals
-
-@cindex Notenbezeichnungen, Deutsch
-@cindex Notenbezeichnungen, Standard
-@cindex Vorzeichen, Deutsch
-@cindex Versetzungszeichen
-@cindex Akzidenzen
-
-Ein Kreuz wird eingegeben, indem man @code{-is} an die 
-Notenbezeichnung hängt, ein b durch @code{-es}. Doppelkreuze 
-und Doppel-Bs werden durch Hinzufügen von @code{-isis} und 
-@code{-eses} hinter die Notenbezeichnung erzeugt.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
-@end lilypond
-
-@noindent
-Auch die deutschen Varianten @code{as} für @code{aes} und
-@code{es} für @code{ees} sind erlaubt. Im Unterschied zum 
-Deutschen ist aber @code{bes} die einzige Version für den Ton
-B, während his als @code{bis} geschrieben werden muss. Das kann
-aber auch verändert werden, siehe @ref{Note names in other languages}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
-@end lilypond
-
-Ein Auflösungszeichen macht die Wirkung eines Kreuzes oder Bs
-rückgängig. Diese Auflösungszeichen werden jedoch nicht 
-als Suffix einer Tonhöhenbezeichnung eingegeben, sondern
-sie ergeben sich (automatisch) aus dem Kontext, wenn die 
-nicht alterierte Notenbezeichnung eingegeben wird.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a4 aes a2
-@end lilypond
-
-Die Sequenz @code{d e f} wird interpretiert als: @qq{Setze eine
- D-Noten, eine E-Note und eine F-Note,} unabhängig von den 
- Vorzeichen der Tonart. Mehr Information über den Unterschied 
- zwischen musikalischem Inhalt und der Präsentation dieses 
- Inhalts siehe @ref{Accidentals and key signatures}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
-@end lilypond
-
-
-@commonprop
-
-Den Satzregeln für den Notensatz folgend wird ein Auflösungszeichen 
-dann ausgegeben, wenn eine vorhergehende Akzidenz rückgängig 
-gemacht werden soll. Um dieses Verhalten zu ändern, muss 
-@code{\set Staff.extraNatural = ##f} eingesetzt werden.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-ceses4 ces cis c
-\set Staff.extraNatural = ##f
-ceses4 ces cis c
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{LedgerLineSpanner},
-@internalsref{NoteHead}.
-
-
-@node Cautionary accidentals
-@subsection Cautionary accidentals
-
-@cindex Versetzungszeichen, Erinnerung
-@cindex Versetzungszeichen, Warnung
-@cindex Vorzeichen, Erinnerung
-@cindex Vorzeichen in Klammern
-@cindex Erinnerungsvorzeichen
-@cindex Warnungsvorzeichen
-@funindex ?
-@cindex Klammern um Vorzeichen
-@funindex !
-
-Normalerweise werden Versetzungszeichen automatisch gesetzt, aber
-sie können auch manuell hinzugefügt werden. Ein erinnerndes 
-Versetzungszeichen kann erzwungen werden, indem man ein Ausrufungszeichen
-(@code{!}) hinter die Notenbezeichnung schreibt. Ein warnendes 
-Versetzungszeichen (also ein Vorzeichen in Klammern) wird durch Anfügen 
-eines Fragezeichens (@code{?}) erstellt. Mit diesen zusätzlichen 
-Zeichen kann man sich auch Auflösungszeichen ausgeben lassen.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-cis cis cis! cis? c c? c! c
-@end lilypond
-
-
-@seealso
-Die automatische Setzung von Versetzungszeichen kann auf viele Arten 
-beeinflusst werden. Mehr Information dazu siehe
- @ref{Automatic accidentals}.
-
-
-@node Micro tones
-@subsection Micro tones
-
-@cindex Vierteltöne
-@cindex Vorzeichen, Vierteltöne
-@cindex Versetzungszeichen, Vierteltöne
-@cindex Mikrotöne
-
-Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
-@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
-Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
-aufsteigende Serie vom kleinen C.
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Mikrotöne werden auch in die MIDI-Dateien geschrieben.
-
-
-
-@refbugs
-
-Es gibt keine allgemein anerkannten Standards für die 
-Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
-Symbol entspricht also keinem Standard.
-
-
-@node Note names in other languages
-@subsection Note names in other languages
-
-Es gibt vordefinierte Bezeichnungen für die Notenbezeichnungen in anderen 
-Sprachen als Englisch. Um sie zu benutzen, muss nur die 
-entsprechende Datei für die jeweilige Sprache eingefügt werden.
-Zum Beispiel fügt man mit @code{\include "deutsch.ly"} die 
-Notendefinitionen für die deutsche Sprache am Anfang der Datei 
-hinzu. In der Tabelle sind die existierenden Definitionen
-mit den dazugehörigen Notenbezeichnungen dargestellt.
-
-
-@c  Should this be made into a multitable?
-@cindex Notenbezeichnungen, andere Sprachen
-@example
-               Notenbezeichnungen              Kreuz       B         Doppelkreuz   Doppel-B
-
-nederlands.ly  c   d   e   f   g   a   bes b   -is         -es       -isis         -eses
-english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat  -ss/-x/       -ff/
-                                                                     -sharpsharp   -flatflat
-deutsch.ly     c   d   e   f   g   a   b   h   -is         -es       -isis         -eses
-norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es  -ississ/-isis -essess/-eses
-svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess      -ississ       -essess
-italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b        -dd           -bb
-catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b        -dd/-ss       -bb
-espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b        -ss           -bb
-@end example
-
-@noindent
-Auf Holländisch, Deutsch, Norwegisch und Schwedisch (u. a.) werden die 
-Erniedrigungen von @q{a} wie @code{aes} und @code{aeses} zu
-@code{as} und @code{ases} (oder auch @code{asas}) zusammengezogen.
-In manchen Sprachen sind nur diese Kurzformen definiert (das gilt auch für die 
-Endungen der Vierteltöne).
-
-@noindent
-Bestimmte Musik verwendet Alterationen, die Bruchteile von den 
-@qq{üblichen} Kreuzen oder Bs sind. Die Notenbezeichnungen für 
-Vierteltöne für die verschiedenen Sprachen sind in der folgenden 
-Tabelle aufgeführt. Die Präfixe @qq{Semi-} und @qq{Sesqui-} bedeuten 
-@qq{halb} bzw. @qq{eineinhalb}. Für Norwegisch, Schwedisch, Katalanisch 
-und Spanisch sind noch keine eigenen Namen definiert.
-@c What about Turkish Maquam music and similar microtonal systems?
-@c
-@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
-@c is actually misleading since the alteration is in fact one and a half
-@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
-
-@example
-               Notenbezeichnungen              Semi-   Semi-  Sesqui-  Sesqui-
-                                               kreuz   B      Kreuz    B
-
-nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
-english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
-deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
-norsk.ly       c   d   e   f   g   a   b   h   
-svenska.ly     c   d   e   f   g   a   b   h   
-italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
-catalan.ly     do  re  mi  fa  sol la  sib si  
-espanol.ly     do  re  mi  fa  sol la  sib si  
-@end example
-
-
-
-@node Relative octaves
-@subsection Relative octaves
-
-@cindex Relativ
-@cindex Relative Oktavbestimmung
-@funindex \relative
-
-Oktaven werden angegeben, indem man @code{'} oder @code{,}
-an die Notenbezeichnung hängt. Wenn Sie schon existierende 
-Musik kopieren, passiert es schnell, eine Note aus Versehen 
-in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
-finden. Der relative Oktaven-Modus verhindert solche Fehler,
-indem mögliche Fehler stark vergrößert werden: ein einziger 
-Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
-
-Die Syntax des Befehls lautet:
-
-@example
-\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-oder:
-
-@example
-\relative @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
-wenn sie nicht extra angegeben wird.
-
-Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
-wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
-benutzt werden, wird als Intervall zwischen der Noten und der 
-vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
-Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
-übermäßige Quarte ist also ein kleineres Intervall als eine 
-verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
-
-Die Oktavversetzungszeichen @code{'} und @code{,} können 
-hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
-oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
-ein Referenzton angegeben werden, der als die vorhergehende Note 
-für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
-wird. Wenn dieser Referenzton nicht angeben wird, wird das 
-eingestrichene C verwendet.
-
-So funktioniert der relative Modus:
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
-die größer als eine Quarte sind.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
-des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
-bestimmen.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
-
-Die relative Veränderung wirkt sich nicht auf 
-Transposition (@code{\transpose}),
-Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
-aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
-verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
-Klammern des @code{\transpose}-Befehls gesetzt werden.
-
-@node Octave check
-@subsection Octave check
-
-@cindex Oktavenüberprüfung
-
-Durch Oktavenüberprüfung können Fehler einfacher entdeckt werden:
-nach einer Note kann @code{=}@var{Apostrophe} geschrieben werden, 
-womit angezeigt wird, was ihre wirkliche Oktave sein soll. Im 
-folgenden Beispiel
-
-@example
-\relative c'' @{ c='' b=' d,='' @}
-@end example
-
-@noindent
-erzeugt das @code{d} eine Warnung, weil ein @code{d''} erwartet
-wird (denn  zwischen @code{b'} und @code{d''} befindet sich nur eine Terz), 
-aber ein @code{d'} ist notiert. In der Notenausgabe wird die 
-Oktave zu  @code{d''} korrigiert und die nächste Note wird 
-relativ zu  @code{d''} anstelle von @code{d'} errechnet.
-
-Es gibt auch eine Oktavenüberprüfung, die keine sichtbare Ausgabe 
-erzeugt. Die Syntax:
-
-@example
-\octave @var{Tonhöhe}
-@end example
-
-Hierdurch wird überprüft, dass die @var{Tonhöhe} (ohne Apostroph) 
-der @var{Tonhöhe} (mit Apostroph) entspricht. Wenn sie 
-sich nicht entsprechen, wird eine Warnung ausgegeben und die 
-Oktave wird korrigiert. Die @var{Tonhöhe} wird nicht als 
-Note gesetzt.
-
-Im nächsten Beispiel erzeugt die erste Überprüfung keine Warnung, 
-weil das @code{e} (im relativen Modus) innerhalb einer Quarte 
-zum @code{a'} liegt. Die zweite Überprüfung aber erzeugt eine 
-Warnung, weil das @code{e} mehr als eine Quarte vom 
-@code{b'} entfernt ist. Die Warnung wird ausgegeben und die Oktave wird 
-korrigiert, so dass auch die folgenden Noten wieder in der 
-richtigen Oktave gesetzt werden.
-
-
-@example
-\relative c' @{
-  e
-  \octave a'
-  \octave b'
-@}
-@end example
-
-Die Oktave einer Note, der eine Oktavüberprüfung angefügt wurde, 
-wird in Hinsicht auf die vorherige Note bestimmt. Im nächsten 
-Fragment ist die letzte Note ein @code{a'}. 
-Die Oktavenüberprüfung stellt fest, dass zwischen e' und kleinem
-b eine Quarte Abstand ist und dass die folgende Note, ein a', sich
-wieder innerhalb einer Quarte vom e' aus befindet. Die Überprüfung
-gibt also einen Erfolgswert zurück und die Notenausgabe wird nicht
-verändert.
-
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octave b
-  a
-}
-@end lilypond
-
-
-@node Transpose
-@subsection Transpose
-
-@cindex Transposition
-@cindex Transponieren
-@funindex \transpose
-
-Ein musikalischer Ausdruck kann mit dem Befehl @code{\transpose}
-transponiert werden. Die Syntax lautet:
-@example
-\transpose @var{von} @var{nach} @var{mus. Ausdruck}
-@end example
-
-Das bedeutet, dass der @var{mus. Ausdruck} um das Intervall zwischen den 
-Tonhöhen @var{von} und @var{nach} transponiert wird: Jede Note, die die 
-Tonhöhe @var{von} hat, wird in die Tonhöhe @var{nach} umgewandelt.
-
-So kann z. B. ein Stück in D-Dur, wenn es für den Sänger etwas zu
-tief ist, mit dem Befehl
-
-@example
-\transpose d e @dots{}
-@end example
-
-@noindent
-nach E-Dur transponiert werden.
-
-Oder eine Violinstimme, die so notiert wird, wie sie erklingt, 
-soll von einer A-Klarinette gespielt werden. Hier ist ein 
-klingendes A als C notiert, so dass alles also eine kleine
-Terz tiefer erklingt, als es notiert ist. Für die Erzeugung der 
-Klarinettenstimme muss folgender Befehl verwendet werden:
-
-@example
-\transpose a c @dots{}
-@end example
-
-@code{\transpose} unterscheidet enharmonische Verwechslungen: sowohl 
-@code{\transpose c cis} als auch @code{\transpose c des} transponieren 
-die Musik einen Halbton nach oben. Aber die erste Version gibt als 
-Versetzungszeichen Kreuze aus, die zweite dagegen B-Versetzungszeichen.
-
-@lilypond[quote,ragged-right,verbatim]
-mus = { \key d \major cis d fis g }
-\new Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
-}
-@end lilypond
-
-@code{\transpose} kann auch benutzt werden, um die geschriebenen 
-Noten eines transponierenden Instruments zu notieren. Tonhöhen in 
-LilyPond werden üblicherweise notiert, wie sie erklingen, aber 
-man kann auch eine andere Tonart verwenden. Noten einer 
-B-Trompete, die mit einem klingenden D anfangen, könnte man also 
-auch so eingeben:
-
-@example
-\transpose c bes @{ e4 @dots{} @}
-@end example
-
-Um die Noten dann wiederum als Trompetenstimme zu drucken (also einen 
-Ganzton tiefer, als sie erklingen), setzt man einfach um sie herum 
-eine weitere Transposition:
-
-@example
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
-@end example
-
-
-@seealso
-
-Programmreferenz: @internalsref{TransposedMusic}.
-
-Beispiel: @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
-
-
-@refbugs
-
-Wenn Sie sowohl  @code{\transpose} als auch @code{\relative} 
-benutzen wollen, muss die @code{\transpose}-Umgebung sich 
-außerhalb der @code{\relative}-Umgebung befinden, da 
-@code{\relative} keine Auswirkungen auf Noten hat, die sich 
-innerhalb von @code{\transpose} befinden.
-
-
-@node Rests
-@subsection Rests
-@cindex Pausen
-
-@funindex \rest
-@funindex r
-
-Pausen werden wie Noten eingegeben, ihre Bezeichnung ist @code{r}.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-r1 r2 r4 r8
-@end lilypond
-
-Pausen, die ganze Takte ausfüllen und in der Taktmitte zentriert 
-werden sollen, müssen als mehrtaktige Pausen eingegeben werden. 
-Sie können sowohl für einen einzigen Takt als auch für mehrere 
-Takte verwendet werden, Näheres im Abschnitt
-@ref{Multi measure rests}.
-
-Um die vertikale Position einer Pause explizit festzulegen, 
-kann eine Note eingegeben werden, gefolgt vom Befehl @code{\rest}. 
-Die Pause wird dann an die Stelle gesetzt, wo sich sonst die 
-Note befinden würde.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-a'4\rest d'4\rest
-@end lilypond
-
-@noindent
-Damit wird die manuelle Formatierung von mehrstimmiger Musik 
-sehr viel einfacher, da die Formatierungsfunktion zur automatischen 
-Auflösung von Zusammenstößen diese Pausen nicht mit einbezieht.
-
-
-@seealso
-
-Programmreferenz: @internalsref{Rest}.
-
-
-@node Skips
-@subsection Skips
-
-@cindex Skip
-@cindex Überspringen von Zeichen
-@cindex Unsichtbare Pausen
-@cindex Platzhalternoten
-@funindex \skip
-@funindex s
-
-Eine unsichtbare Pause (auch als @qq{skip} oder Überspringung bezeichnet) 
-kann wie eine Note eingegeben werden, die Notationsbezeichnung ist @code{s}. 
-Man kann aber auch die Dauer extra angeben mit @code{\skip @var{Dauer}}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a4 a4 s4 a4 \skip 1 a4
-@end lilypond
-
-Die @code{s}-Syntax steht nur im Noten- oder Akkordmodus zur Verfügung. In 
-anderen Situationen, z. B. innerhalb eines Liedtextes, muss @code{\skip} 
-benutzt werden.
-
-@lilypond[quote,ragged-right,verbatim]
-<<
-  \relative { a'2 a2 }
-  \new Lyrics \lyricmode { \skip 2 bla2 }
->>
-@end lilypond
-
-Der Überspringungsbefehl (@code{\skip}) ist einfach ein leerer Platzhalter. 
-Durch ihn wird 
-überhaupt nichts gesetzt, auch keine transparenten Objekte.
-
-Die Überspringung mit @code{s} hingegen erstellt  @internalsref{Staff} und
-@internalsref{Voice} wenn es erforderlich ist, genauso wie Noten und Pausen. 
-Das folgende Beispiel etwa setzt ein leeres Notensystem:
-
-@lilypond[quote,ragged-right,verbatim]
-{ s4 }
-@end lilypond
-
-Das Fragment @code{@{ \skip 4 @}} würde nur eine leere Seite produzieren.
-
-@seealso
-
-Programmreferenz: @internalsref{SkipMusic}.
-
-
-
-@node Rhythms
-@section Rhythms
-
-Dieser Abschnitt erklärt Rhythmen, Dauern und Takte.
-
-@menu
-* Durations::                   
-* Augmentation dots::           
-* Tuplets::                     
-* Scaling durations::           
-* Bar check::                   
-* Barnumber check::             
-* Automatic note splitting::    
-@end menu
-
-
-@node Durations
-@subsection Durations
-
-@cindex Dauer
-@cindex Notenlänge
-@funindex \longa
-@funindex \breve
-@funindex \maxima
-
-Im Noten-, Akkord- und Liedtextmodus werden Notenlängen (Dauern) durch 
-Zahlen und Punkte notiert: Dauern werden als reziproke Werte geschrieben. 
-Zum Beispiel wird eine Viertelnote mit @code{4} notiert (weil sie eine 
-1/4-Note ist), eine halbe Note mit @code{2} (weil sie eine 1/2-Note ist). 
-Noten, die länger als eine Ganze sind, müssen mit @code{\longa} 
-(für die Longa, also vier Ganze) und 
-@code{\breve} (für die Brevis, auch Doppelganze genannt) notiert werden.
-
-@example
-c'\breve
-c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
-r\longa r\breve
-r1 r2 r4 r8 r16 r32 r64 r64
-@end example
-
-@lilypond[quote]
-\score {
-\relative c'' {
-    a\breve*1/2 \autoBeamOff
-    a1 a2 a4 a8 a16 a32 a64 a64
-   \bar "empty"
-   \break
-    r\longa*1/4 r\breve *1/2
-    r1 r2 r4 r8 r16 r32 r64 r64
-  }
-  \layout {
-    ragged-right = ##t
-    indent=0\mm
-    \context {
-      \Score
-        \remove "Bar_number_engraver"
-    }
-    \context {
-      \Staff
-        \remove "Clef_engraver"
-        \override StaffSymbol #'transparent = ##t
-        \override TimeSignature #'transparent = ##t
-        \override BarLine #'transparent = ##t
-        \consists "Pitch_squash_engraver"
-    }
-  }
-}
-@end lilypond
-
-Wenn die Dauer hinter einer Notenbezeichnung nicht angegeben ist, 
-wird die Dauer der vorhergehenden Note eingesetzt. Der Standardwert 
-für die erste Note ist eine Viertel.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-{ a a a2 a a4 a a1 a }
-@end lilypond
-
-
-@node Augmentation dots
-@subsection Augmentation dots
-
-@funindex .
-@cindex Punktierung
-
-Um punktierte Notendauern zu erhalten, muss einfach nur ein Punkt 
-(@code{.}) hinter die Zahl der Dauer gesetzt werden. Zwei Punkte 
-ergeben eine doppelte Punktierung.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-a'4 b' c''4. b'8 a'4. b'4.. c''8.
-@end lilypond
-
-@refcommands
-
-Punkte werden normalerweise nach oben verschoben, damit sie die Notenlinien 
-nicht berühren. Das gilt aber nicht für mehrstimmige Passagen. Mit den 
-folgenden Befehlen kann ein anderes Verhalten der Punktierung erreicht werden.
-
-@funindex \dotsUp
-@code{\dotsUp} (Der Punkt wird nach oben verschoben.),
-@funindex \dotsDown
-@code{\dotsDown} (Der Punkt wird nach unten verschoben.),
-@funindex \dotsNeutral (Wiederherstellung des Standards.)
-@code{\dotsNeutral}.
-
-@seealso
-
-Programmreferenz: @internalsref{Dots} und @internalsref{DotColumn}.
-
-
-@node Tuplets
-@subsection Tuplets
-
-@cindex N-tolen
-@cindex Triolen
-@cindex Rhythmische Aufteilungen
-@funindex \times
-
-Triolen und andere rhythmische Aufteilungen werden aus einem musikalischen 
-Ausdruck erstellt, indem dessen Tondauern mit einem Bruch multipliziert werden.
-
-@example
-\times @var{Bruch} @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-Die Dauer eines @var{musikalischen Ausdrucks} wird mit dem Bruch multipliziert. 
-Der Nenner des Bruchs wird über den Noten ausgegeben, optional mit einer 
-eckigen Klammer, die die Noten einfasst. Die üblichste Aufteilung ist die 
-Triole, in welcher drei Noten die Länge von zwei haben, der Wert jeder 
-einzelnen Note ist also 2/3 der notierten Länge.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-g'4 \times 2/3 {c'4 c' c'} d'4 d'4
-@end lilypond
-
-Diese Brüche können auch ineinander geschachtelt werden, etwa so:
-
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\override TupletNumber #'text = #tuplet-number::calc-fraction-text
-\times 4/6 {
-  a4 a
-  \times 3/5 { a a a a a }
-}
-@end lilypond
-
-@refcommands
-
-@funindex \tupletUp
-@code{\tupletUp},
-@funindex \tupletDown
-@code{\tupletDown},
-@funindex \tupletNeutral
-@code{\tupletNeutral}.
-
-
-@commonprop
-
-@funindex tupletNumberFormatFunction
-@cindex Formatierung von Brüchen
-@cindex Formatierung von Triolen
-@cindex N-tolen, Formatierung
-
-Der Wert von @code{tupletSpannerDuration} definiert, wie lange jede 
-Klammer dauert. Mit entsprechender Einstellung kann man beliebig 
-viele Triolen schreiben, aber nur einmal den Befehl @code{\times}
-benutzen. Im nächsten Beispiel etwa werden zwei Triolen gedruckt, 
-@code{\times} aber nur einmal benutzt. Das gilt natürlich auch für alle 
-anderen Brüche.
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
-
-@noindent
-Mehr Information zu @code{make-moment} findet sich im Abschnitt 
-@ref{Time administration}.
-
-Die Formatierung der Nummer wird durch die Eigenschaft @code{text} 
-in @code{TupletNumber} bestimmt. Die Standardeinstellung gibt nur 
-den Nenner aus, aber wenn @code{TupletNumber} auf den Wert 
-@code{tuplet-number::calc-fraction-text}
-gestellt wird, wird @var{Zähler}:@var{Nenner} ausgegeben.
-
-Um gar keine Nummern anzeigen zu lassen, kann folgender Code benutzt
- werden:
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-\override TupletNumber #'transparent = ##t
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-@end lilypond
-
-Mit der  @code{\tweak}-Funktion können die Zahlen von geschachtelten Brüchen 
-eingestellt werden, die  zur gleichen Zeit beginnen. Im Beispiel unten 
-wird mit @code{\tweak} definiert, dass für die äußere Klammer der Bruch
-ausgegeben wird, für die innere aber nur der Nenner.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \times 4/3 {
-     \tweak #'text #tuplet-number::calc-denominator-text
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Im nächsten Beispiel werden @code{\tweak} und @code{\override} 
-zusammen verwendet, um die Darstellung der Klammer 
-(@code{TupletBracket}) zu bestimmen. Mit dem ersten @code{\tweak} 
-wird die Klammer der äußeren Triole über dem Notensystem platziert. 
-Das zweite @code{\tweak} platziert die erste der drei inneren Klammern 
-unter dem System (von der Klammer wird hier nur der Nenner des
-Bruchs dargestellt). Dieses Paar von @code{\tweak}-Einstellungen wirkt 
-sich jedoch nur auf die äußere und die @emph{erste} innere Klammer 
-aus, weil nur sie zur gleichen Zeit beginnen. Mit dem @code{\override}-Befehl 
-kann die Richtung der zweiten und dritten @code{TupletBracket} 
-verändert werden, in 
-diesem Fall wird sie unter das Notensystem geschrieben.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \tweak #'direction #up
-  \times 4/3 {
-     \tweak #'direction #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \override TupletBracket #'direction = #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Die Klammern können so eingestellt werden, dass sie bis zu 
-einem Taktvorspann oder bis zur nächsten Note reichen.
-
-@lilypond[ragged-right]
-\new RhythmicStaff {
-  \set tupletFullLength = ##t
-  \time 4/4
-  \times 4/5 {
-    c4 c1
-  }
-  \set tupletFullLengthNote = ##t
-  \time 2/4
-  \times 2/3 {
-    c4 c c 
-  }
-  \time 3/4
-  c4 
-}
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{TupletBracket},
-@internalsref{TupletNumber} und @internalsref{TimeScaledMusic}.
-
-
-
-@node Scaling durations
-@subsection Scaling durations
-
-Die Dauer von Längen kann mit einem Bruch multipliziert werden, 
-indem hinter die Note  @qq{*@var{N/M}} (oder @qq{*@var{N}} wenn @var{M=1}) 
-geschrieben wird. Das beeinflusst nicht die Erscheinung der Note oder 
-Pause im Druckbild. Die Werte können auch kombiniert werden, etwa 
-@qq{*M*N}.
-
-Im nächsten Beispiel nehmen die drei ersten Noten genau zwei Schläge ein, 
-aber es wird keine Triolenklammer über ihnen ausgegeben.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\time 2/4
-a4*2/3 gis4*2/3 a4*2/3
-a4 a4 a4*2
-b16*4 c4
-@end lilypond
-
-
-@seealso
-
-Abschnitt @ref{Tuplets}
-
-
-@node Bar check
-@subsection Bar check
-
-@cindex Taktüberprüfung
-@funindex barCheckSynchronize
-@funindex |
-
-Die Taktüberprüfung hilft, Fehler in den Notendauern zu entdecken. 
-Eine Taktüberprüfung wird mit dem Taktstrichsymbol @qq{|} (Taste AltGr+<) 
-eingegeben. Immer, wenn LilyPond bei der Ausgabe des Notendrucks 
-auf dieses Zeichen stößt, sollte hier in den Noten auch ein 
-Taktstrich erscheinen. Wenn das nicht der Fall ist, wird eine Warnung 
-ausgegeben. Im nächsten Beispiel resultiert die zweite Taktüberprüfung 
-in einer Fehlermeldung.
-
-@example
-\time 3/4 c2 e4 | g2 |
-@end example
-
-Taktüberprüfungen können auch in Liedtexten verwendet werden:
-
-@example
-\lyricmode @{
-  \time 2/4
-  Twin -- kle | Twin -- kle
-@}
-@end example
-
-Eine Taktüberprüfung gilt als nicht bestanden, wenn die Notenwerte 
-nicht stimmen. Besonders in mehrstimmiger komplizierter Musik können 
-solche falschen Notenwerte die ganze Partitur durcheinander bringen. 
-Es lohnt sich also, die Fehlersuche damit zu beginnen, nicht bestandene 
-Taktüberprüfungen zu kontrollieren.
-
-@funindex |
-@funindex pipeSymbol
-
-Es ist auch möglich, die Bedeutung des Symbols @code{|} umzudefinieren. 
-Das geschieht, indem man der Pipe (@code{pipeSymbol} einen musikalischen 
-Ausdruck zuweist:
-
-@lilypond[quote,ragged-right,verbatim]
-pipeSymbol = \bar "||"
-
-{ c'2 c' | c'2 c' }
-@end lilypond
-
-
-@node Barnumber check
-@subsection Barnumber check
-
-Wenn man größere Musikstücke kopiert, kann es hilfreich sein, wenn 
-LilyPond überprüft, ob die Taktnummer, in der Sie gerade kopieren, 
-mit der des Originales übereinstimmt. Das kann mit dem Befehl
-@code{\barNumberCheck} folgenderweise überprüft werden:
-
-@verbatim
-\barNumberCheck #123
-@end verbatim
-
-@noindent
-Eine Warnung wird ausgegeben, wenn der interne Zähler 
-@code{currentBarNumber} von LilyPond
-nicht mit dem Wert 123 übereinstimmt.
-
-
-@node Automatic note splitting
-@subsection Automatic note splitting
-
-Lange Noten können automatisch in übergebundene Noten aufgeteilt werden. 
-Dieses Verhalten erreicht man, indem der  @internalsref{Note_heads_engraver} 
-mit dem @internalsref{Completion_heads_engraver} ausgetauscht wird. 
-Im nächsten Beispiel werden Noten, die über die Taktlinie dauern, aufgeteilt 
-und übergebunden.
-
-@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
-\new Voice \with {
-  \remove "Note_heads_engraver"
-  \consists "Completion_heads_engraver"
-} {
-  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
-}
-@end lilypond
-
-Dieser Notationsformatierer (eng. engraver) teilt alle Noten 
-auf, die über eine Taktlinie dauern und fügt Bindebögen hinzu. 
-Er kann unter Anderem dann nützlich sein, wenn man komplexe 
-Partituren auf Fehler überprüfen möchte: Wenn die Takte nicht 
-vollständig gefüllt sind, zeigt die Überbindung genau an, wie viele 
-Notenwerte noch in dem jeweiligen Takt fehlen.
-
-Wenn Sie wollen, dass auch Zeilenumbrüche an den Stellen, an denen 
-automatisch Noten aufgeteilt wurden, stattfinden, müssen Sie auch 
-den Formatierer  @internalsref{Forbid_line_break_engraver}  mit 
-dem @code{\remove}-Befehl entfernen.
-
-
-@refbugs
-
-Nicht alle Notenwerte (besonders wenn sie andere rhythmische 
-Aufteilungen beinhalten) können exakt durch normale Noten und 
-Punktierungen wiedergegeben werden. Der Engraver setzt aber
-trotzdem keine Triolen etc.
-
-@code{Completion_heads_engraver} wirkt sich nur auf Noten aus; 
-Pausen werden nicht aufgeteilt.
-
-@seealso
-
-Programmreferenz: @internalsref{Completion_heads_engraver}.
-
-
-@node Polyphony
-@section Polyphony
-
-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 
-von mehr als einer Stimme pro System.
-
-@menu
-* Chords::                      
-* Stems::                       
-* Basic polyphony::             
-* Explicitly instantiating voices::  
-* Collision Resolution::        
-@end menu
-
-
-@node Chords
-@subsection Chords
-
-@cindex Akkorde
-
-Ein Akkord wird notiert, indem die zu ihm gehörenden Tonhöhen 
-zwischen spitze Klammern (@code{<} und @code{>} gesetzt werden.
-Auf einen Akkord kann eine Dauer-Angabe folgen, genauso wie bei 
-einfachen Noten.
-
-
-@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
-@end lilypond
-
-Siehe @ref{Chord names} für mehr Information.
-
-@c  I don't like having this here, but I can't think of
-@c  anywhere else to put it.  :(   -gp
-@node Stems
-@subsection Stems
-
-Immer, wenn das Programm eine Note findet, wird automatisch 
-ein Notenhals (@internalsref{Stem}) -Objekt erzeugt. Auch 
-für ganze Noten und Pausen werden sie erzeugt, aber unsichtbar 
-gemacht.
-
-@refcommands
-
-@funindex \stemUp
-@code{\stemUp} (Hälse nach oben),
-@funindex \stemDown
-@code{\stemDown} (Hälse nach unten),
-@funindex \stemNeutral
-@code{\stemNeutral} (Hälse je nach Notenposition).
-
-
-@commonprop
-
-Um die Richtung der Hälse zu ändern, können die Befehle
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
-
-@noindent benutzt werden.
-
-@node Basic polyphony
-@subsection Basic polyphony
-
-@cindex Mehrstimmigkeit
-@cindex Polyphonie
-
-Die einfachste Weise, Abschnitte mit mehr als einer Stimme pro
-Notensystem zu notieren, ist es, jede Stimme als eine
-Sequenz zu notieren (innerhalb der Klammern @code{@{...@}}) 
-und dann die beiden Klammer simultan zu kombinieren, indem
-sie mit @code{\\} getrennt werden.
-
-@funindex \\
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  c16 d e f
-  <<
-    { g4 f e | d2 e2 } \\
-    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
-    { s2. | s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-Dieser Trenner veranlasst, dass Stimmen (@internalsref{Voice}) 
--Kontexte@footnote{Polyphone Stimmen werden in anderen
-Programmen teilweise als @qq{layers} (Schichten) bezeichnet.}
-@cindex Layers
-angelegt werden. Sie tragen die Namen @code{"1"}, @code{"2"} 
-usw. In jedem dieser Kontexte wird die Richtung von Bögen,
-Hälsen usw. entsprechend angepasst.
-
-Diese Stimmen sind alle unabhängig von der Stimme, in der die 
-Noten außerhalb der @code{<< \\ >>}-Konstruktion notiert sind.
-Das sollte man berücksichtigen, wenn man auf Stimmen-Ebene
-Veränderungen vornimmt. Das bedeutet gleichzeitig auch, dass 
-Legato- und Bindebögen nicht in eine @code{<< \\ >>}-Umgebung 
-hinein- noch aus hier hinaus ragen können. Die parallelen 
-Notenabschnitte aus unterschiedlichen @code{<< \\ >>}-Umgebungen
-hingegen gehören der gleichen Stimme an. Hier noch einmal das 
-gleiche Beispiel mit unterschiedlichen Notenköpfen und Farben 
-für jede Stimme. 
-Die Veränderung der Notenköpfe in der Hauptstimme hat keine
-Auswirkung auf die Stimmen innerhalb der  @code{<< \\ >>}-Umgebungen, 
-und die Veränderung der Notenköpfe für die untere Stimme setzt 
-sich fort in der zweiten  @code{<< \\ >>}-Umgebung. Hier ist auch 
-eine Noten über die Taktgrenze hinweg an die untere Stimme der 
-zweiten Polyphonie-Umgebung angebunden.
-
-@cindex Notenköpfe, Stile
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  <<
-    { g4 f e } \\
-    { \override NoteHead #'style = #'triangle
-      \override NoteHead #'color = #blue
-    r8 e4 d c8 ~ }
-  >> |
-  <<
-    { d2 e2 } \\
-    { c8 b16 a b8 g ~ g2 } \\
-    { \override NoteHead #'style = #'slash 
-      \override NoteHead #'color = #green
-      s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-Polyphonie verändert nicht das Verhältnis der Noten 
-innerhalb einer @code{\relative @{ @}}-Umgebung.
-Jede Note wird weiterhin errechnet aus der direkt 
-vorhergehenden.
-
-@example
-\relative @{ NoteA << NoteB \\ NoteC >> NoteD @}
-@end example
-
-@code{NoteC} ist relativ zu @code{NoteB}, nicht @code{NoteA};
-@code{NoteD} ist relativ zu @code{NoteC}, nicht @code{NoteB} oder
-@code{NoteA}.
-
-
-@node Explicitly instantiating voices
-@subsection Explicitly instantiating voices
-
-@internalsref{Voice}-Kontexte können auch manuell innerhalb 
-eines @code{<< >>}-Abschnittes initiiert werden. Mit den Befehlen 
-@code{\voiceOne} bis hin zu @code{\voiceFour} kann jeder Stimme 
-entsprechendes Verhalten von vertikaler Verschiebung und Richtung 
-von Hälsen und anderen Objekten hinzugefügt werden.
-
-Genauer gesagt,
-@example
-<< \upper \\ \lower >>
-@end example
-
-@noindent
-entspricht 
-
-@example
-<<
-  \new Voice = "1" @{ \voiceOne \upper @}
-  \new Voice = "2" @{ \voiceTwo \lower @}
->>
-@end example
-
-Der @code{\voiceXXX}-Befehl setzt die Richtung von Hälsen, 
-Bögen, Artikulationszeichen, Text, Punktierungen und Fingersätzen. 
- @code{\voiceOne} und @code{\voiceThree} lassen diese Objekte 
- nach oben zeigen, 
- @code{\voiceTwo} und @code{\voiceFour}
-dagegen lassen sie abwärts zeigen. Der Befehl 
-@code{\oneVoice} stellt wieder auf das normale Verhalten um.
-
-Ein Ausdruck, der direkt innerhalb einer @code{<< >>}-Umgebung 
-auftritt, gehört der Hauptstimme an. Das ist nützlich, wenn zusätzliche 
-Stimme auftreten, während die Hauptstimme sich fortsetzt. Hier also 
-eine bessere Version des Beispiels aus dem vorigen Abschnitt. Die 
-farbigen Kreuz-Notenköpfe zeigen, dass die Hauptstimme sich jetzt in 
-einem einzigen Stimmen (@code{voice})-Kontext befindet.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2 }
-    \new Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. | s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Und mit der richtigen Definition der Stimmen kann die Melodie auch 
-übergebunden werden.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Indem man den @code{\\}-Trenner vermeidet, gelingt es auch, mehrstimmige 
-Abschnitte ineinander zu schachteln, was in manchen Fällen die bessere 
-und natürlichere Lösung sein kann.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ |
-      <<
-        {c8 b16 a b8 g ~ g2}
-        \new Voice { \voiceThree
-          s4 b4 c2
-          \oneVoice
-        }
-      >>
-    \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-In manchen Fällen von sehr komplexer polyphoner Musik können noch 
-mehr Stimmen benötigt werden, um Zusammenstöße zwischen Noten zu 
-vermeiden. Zusätzliche Stimmen werden durch einen neuen Bezeichner 
-erstellt, wie das nächste Beispiel zeigt.
-
-@lilypond[quote,verbatim,ragged-right,relative=2]
-voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
-
-\relative c''' <<
-  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
-  { \voiceThree  b4} \\
-  { \voiceFive d,} \\
-  { \voiceTwo g,}
->>
-@end lilypond
-
-
-@node Collision Resolution
-@subsection Collision Resolution
-
-Normalerweise werden Notenköpfe mit einer unterschiedlichen Anzahl 
-von Punktierungen nicht verschmolzen, aber wenn die Objekt-Eigenschaft 
- @code{merge-differently-dotted} in ein 
-Notenkollisions (@internalsref{NoteCollision})-Objekt gesetzt wird, 
-werden sie zusammengefasst.
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice << {
-  g8 g8
-  \override Staff.NoteCollision
-    #'merge-differently-dotted = ##t
-  g8 g8
-} \\ { g8.[ f16] g8.[ f16] } >>
-@end lilypond
-
-Auf gleiche Art können auch Halbe mit Achteln vereinigt werden, indem 
-@code{merge-differently-headed} eingesetzt wird:
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\new Voice << {
-  c8 c4.
-  \override Staff.NoteCollision
-    #'merge-differently-headed = ##t
-c8 c4. } \\ { c2 c2 } >>
-@end lilypond
-
-@noindent
-@code{merge-differently-headed} und @code{merge-differently-dotted}
-wirken sich allerdings nur auf Noten mit unterschiedlich gerichteten 
-Hälsen aus (wie etwa Stimme 1 und 2).
-
-LilyPond verschiebt auch Pausen vertikal, die einem Hals gegenüber stehen:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new Voice << c''4 \\ r4 >>
-@end lilypond
-
-Wenn drei oder mehr Noten in der selben Spalte angeordnet werden, 
-kann @code{merge-differently-headed} nicht mehr erfolgreich die 
-Noten vereinen, die ineinander gesetzt werden müssten. Damit die 
-Vereinigung funktioniert, muss der Befehl @code{\shift} vor die
-Note gesetzt werden, auf die er Auswirkung hat. Im ersten Takt 
-des folgenden Beispiels funktioniert @code{merge-differently-headed} 
-nicht (der Notenkopf der Halben ist schwarz). Im zweiten Takt 
-wurde @code{\shiftOn} eingefügt, um das obere @code{g} aus der 
-Spalte zu rücken, und das Vereinigen funktioniert wie gewünscht.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-<<
-  { d=''2 g2 } \\
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-<<
-  { d'=''2 \shiftOn g2 } \\ 
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-@end lilypond
-
-
-@refcommands
-
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
-
-@funindex \shiftOn
-@code{\shiftOn},
-@funindex \shiftOnn
-@code{\shiftOnn},
-@funindex \shiftOnnn
-@code{\shiftOnnn},
-@funindex \shiftOff
-@code{\shiftOff}: Diese Befehle definieren den Grad, mit 
-welchem Noten der aktuellen Stimmen verschoben werden 
-sollen. Die äußeren Stimmen (normalerweise 1 und 2) haben 
-den Befehl @code{\shiftOff}, die inneren dagegen (drei und 
-vier) den Befehl @code{\shiftOn}. @code{\shiftOnn} und 
-@code{\shiftOnnn} stellen weitere Verschiebungsebenen dar.
-
-Wenn LilyPond selber keine Lösung bieten kann, können die 
-Eigenschaft @code{force-hshift} des 
-@internalsref{NoteColumn}-Objektes (siehe unten) 
-sowie Pausen mit definierter Tonhöhe eingesetzt werden, 
-um Satzentscheidungen des Programmes zu überschreiben.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative <<
-{
-  <d g>
-  <d g>
-} \\ {
-  <b f'>
-  \once \override NoteColumn #'force-hshift = #1.7
-  <b f'>
-} >>
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: Die Objekte, die für Auflösung von Zusammenstößen 
-zuständig sind, sind 
-@internalsref{NoteCollision} und @internalsref{RestCollision}.
-
-
-@refbugs
-
-Wenn @code{merge-differently-headed} mit einer nach oben gerichteten 
-Achtel oder kleineren Note verwendet wird, und die nach unten gerichtete 
-Note ist eine Halbe, bekommt die Achtel die falsche Richtung gesetzt.
-
-Es gibt keine Unterstützung für Cluster, in denen die gleiche Note 
-mit unterschiedlichen Vorzeichen im selben Akkord auftritt. In diesem 
-Fall sollte man eine enharmonische Transkription benutzen oder 
-die spezielle Cluster-Notationsweise, siehe @ref{Clusters}.
-
-
-
-@node Staff notation
-@section Staff notation
-
-@cindex Notation von Systemelementen
-@cindex Systemelemente
-@cindex Symbole, systemweit
-
-Dieser Abschnitt zeigt die Notation von Symbolen, die auf 
-Systemebene wirken, wie Tonartvorzeichen, Schlüssel oder 
-Taktangaben.
-
-@menu
-* Clef::                        
-* Key signature::               
-* Time signature::              
-* Partial measures::            
-* Bar lines::                   
-* Unmetered music::             
-* System start delimiters::     
-* Staff symbol::                
-* Writing music in parallel::   
-@end menu
-
-
-@node Clef
-@subsection Clef
-
-@funindex \clef
-
-Der Schlüssel zeigt eine bestimme Systemlinie an und markiert die 
-Tonhöhe, mit der sie korrespondiert. Ein Schlüssel wird mit dem 
-@code{\clef}-Befehl gesetzt.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
-@end lilypond
-
-@cindex Notenschlüssel
-@cindex Schlüssel
-@cindex Violinschlüssel
-@cindex Sopranschlüssel
-@cindex Altschlüssel
-@cindex Bratschenschlüssel
-@cindex Tenorschlüssel
-@cindex Bassschlüssel
-@cindex Franz. Violinschlüssel
-@cindex C-Schlüssel
-@cindex Mezzosopranschlüssel
-@cindex Baritonschlüssel
-@cindex Subbasschlüssel
-
-Unterstützt sind folgende Schlüssel:
-
-@multitable @columnfractions .33 .66
-@headitem Schlüssel @tab Lage
-@item @code{treble} (Violinschlüssel) @tab
-G-Schlüssel auf der zweiten Linie
-@item @code{alto, C} (Bratschenschlüssel) @tab
-C-Schlüssel auf der dritten Linie
-@item @code{tenor} (Tenorschlüssel) @tab
-C-Schlüssel auf der vierten Linie
-@item @code{bass, F} (Bassschlüssel) @tab
-F-Schlüssel auf der vierten Linie
-@item @code{french} (Franz. Violinschlüssel)@tab
-G-Schlüssel auf der ersten Linie
-@item @code{soprano} (Sopranschlüssel) @tab
-C-Schlüssel auf der ersten Linie
-@item @code{mezzosoprano}(Mezzosopranschlüssel)  @tab
-C-Schlüssel auf der zweiten Linie
-@item @code{baritone} (Baritonschlüssel) @tab
-C-Schlüssel auf der fünften Linie
-@item @code{varbaritone} (Bariton-F-Schlüssel) @tab
-F-Schlüssel auf der dritten Linie
-@item @code{subbass} (Kontrabassschlüssel) @tab
-F-Schlüssel auf der fünften Linie
-@item @code{percussion} @tab
-Schlagzeugschlüssel
-@item @code{tab} @tab
-Tabulaturschlüssel
-@end multitable
-
-Indem @code{_8} oder @code{^8} an die jeweilige Schlüsselbezeichnung 
-angehängt wird, wird der Schlüssel um eine Oktave nach oben oder unten 
-transponiert, mit @code{_15} oder @code{^15} um zwei Oktaven. 
-Die Schlüsselbezeichnung muss in Anführungszeichen gesetzt werden, 
-wenn sie Unterstriche oder Zahlen enthält, siehe Beispiel:
-
-@cindex Tenorschlüssel, Chor
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\clef "G_8" c4
-@end lilypond
-
-
-@commonprop
-
-Dem Befehl @code{\clef "treble_8"} entspricht die entsprechende separate 
-Einstellung von @code{clefGlyph},
-@code{clefPosition} (womit y- und x-Position des Schlüssel bestimmt werden),
-@code{middleCPosition} und @code{clefOctavation}. Ein Schlüssel wird 
-immer dann ausgegeben, wenn eine dieser Eigenschaften sich ändert. Im 
-nächsten Beispiel werden Möglichkeiten gezeigt, die Eigenschaften manuell 
-zu setzen.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
-@end lilypond
-
-
-@seealso
-
-Handbuch: @ref{Grace notes}.
-
-Programmreferenz: @internalsref{Clef}.
-
-
-@node Key signature
-@subsection Key signature
-
-@cindex Tonart
-@cindex Vorzeichen
-@funindex \key
-
-Die Vorzeichen zeigen die Tonart an, in welcher ein Stück notiert ist. 
-Es handelt sich um eine Anzahl von Alterationszeichen (Kreuzen oder 
-Bs) am Beginn jedes Notensystems.
-
-Das Setzen und Ändern von Tonarteinstellungen wird mit dem 
-@code{\key}-Befehl vorgenommen.
-
-@example
-@code{\key} @var{Tonhöhe} @var{Art}
-@end example
-
-@funindex \minor
-@funindex \major
-@funindex \minor
-@funindex \ionian
-@funindex \locrian
-@funindex \aeolian
-@funindex \mixolydian
-@funindex \lydian
-@funindex \phrygian
-@funindex \dorian
-@cindex Kirchentonarten
-@cindex Modus
-
-Der Wert @var{Art} sollte entweder @code{\major} oder @code{\minor} 
-sein, um Moll oder Dur der @var{Tonhöhe} zu erhalten. Es können auch 
-Modusbezeichnungen für Kirchentonarten verwendet werden: @code{\ionian} 
-(Ionisch), @code{\locrian} (Locrisch), @code{\aeolian} (Aeolisch), 
-@code{\mixolydian} (Mixolydisch), @code{\lydian} (Lydisch),
-@code{\phrygian} (Phrygisch) und @code{\dorian} (Dorisch).
-
-Dieser Befehl ändert die Kontexteigenschaft 
-@code{Staff.keySignature}. Vorzeichen, die nicht dem Standard entsprechen, 
-können manuell mit dieser Eigenschaft eingegeben werden.
-
-Versetzungszeichen und Vorzeichen können am Anfang etwas verwirrend sein, 
-da unveränderte Noten je nach Tonart ein Auflösungszeichen bekommen 
-können (Beispiel). Mehr Information in den Abschnitten  @ref{Accidentals} 
-oder @ref{Accidentals and key signatures}.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\key g \major
-f1
-fis
-@end lilypond
-
-
-@commonprop
-
-Ein Auflösungszeichen wird gesetzt, um vorhergehende Vorzeichen 
-rückgängig zu machen. Das kann aber unterdrückt werden, indem 
-die @code{Staff.printKeyCancellation}-Eigenschaft angepasst wird.
-
-@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-\set Staff.printKeyCancellation = ##f
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{KeyCancellation},
-@internalsref{KeySignature}.
-
-
-@node Time signature
-@subsection Time signature
-
-@cindex Taktangabe
-@cindex Metrum
-@funindex \time
-
-Taktangaben zeigen das Metrum eines Stückes an: eine 
-regelmäßige Folge von betonten und unbetonten Zeiten. 
-Es wird angezeigt als ein Bruch vor Beginn der Noten.
-
-Die Taktangabe wird mit dem @code{\time}-Befehl gesetzt.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 2/4 c'2 \time 3/4 c'2.
-@end lilypond
-
-@commonprop
-
-Das Symbol, das angezeigt wird, kann durch die 
-@code{style}-Eigenschaft angepasst werden. Wenn man 
-es auf den Wert @code{#'()} setzt, wird auch für 
-4/4- und 2/2-Takte ein Bruch angezeigt.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-\time 4/4 c'1
-\time 2/2 c'1
-\override Staff.TimeSignature #'style = #'()
-\time 4/4 c'1
-\time 2/2 c'1
-@end lilypond
-
-Es gibt noch sehr viel mehr Optionen für das Layout. 
-Siehe den Abschnitt @ref{Ancient time
-signatures} für weitere Beispiele.
-
-Der Befehl @code{\time} stellt die Eigenschaften 
-@code{timeSignatureFraction}, @code{beatLength} 
-und @code{measureLength} im @code{Timing}-Kontext ein, 
-der normalerweise zu den Eigenschaften aller System 
-(@internalsref{Score}-Ebene) gehört. Die Eigenschaft 
-@code{measureLenght} bestimmt, wo Taktlinien eingefügt werden, 
-und wie automatische Balken gesetzt werden. Ein Verändern 
-der Eigenschaften von @code{timeSignatureFraction} gibt 
-das neue Symbol an dieser Stelle aus.
-
-Auf weitere Optionen kann man über die Scheme-Funktion
-@code{set-time-signature} zugreifen. In Kombination mit
-@internalsref{Measure_grouping_engraver} werden hiermit 
-@internalsref{MeasureGrouping}-Zeichen erzeugt. Solche 
-Zeichen erleichtern es, rhythmisch komplexe moderne Musik 
-zu lesen. Im nächsten Beispiel ist der 9/8-Takt in 2, 2, 2 
-und 3 Achtel unterteilt. Das wird im dritten Argument an 
-@code{set-time-signature} weitergegeben @code{(2 2 2 3)}.
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    #(set-time-signature 9 8 '(2 2 2 3))
-    g8[ g] d[ d] g[ g] a8[( bes g]) |
-    #(set-time-signature 5 8 '(3 2))
-    a4. g4
-  }
-  \layout {
-    \context {
-      \Staff
-      \consists "Measure_grouping_engraver"
-    }
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{TimeSignature} und
-@internalsref{Timing_translator}.
-
-Beispiele: @lsr{contemporary,compound-time-signature.ly}.
-
-
-@refbugs
-
-Automatische Balken richten sich nicht nach den Taktunterteilungen, die 
-mit @code{set-time-signature} erzeugt werden.
-
-
-@node Partial measures
-@subsection Partial measures
-
-@cindex Auftakt
-@cindex Takte verkürzen
-@funindex \partial
-
-Verkleinerte Takte, wie etwa ein Auftakt, werden wie folgt notiert:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\partial 16*5 c16 cis d dis e | a2. c,4 | b2
-@end lilypond
-
-Die Syntax für den Befehl lautet:
-
-@example
-\partial @var{Dauer}
-@end example
-
-wobei @code{Dauer} eine rhythmische Länge ist, die vor dem nächsten Taktstrich 
-eingefügt wird.
-
-Das wird intern übersetzt nach:
-
-@example
-\set Timing.measurePosition = -@var{Länge der Dauer}
-@end example
-
-Die Eigenschaft @code{measurePosition} enthält eine rationale Zahl, 
-die darstellt, wie groß der Abstand zum Taktanfang ist. Deshalb ist 
-sie eine negative Zahl; @code{\partial 4} wird also intern übersetzt 
-zu: @qq{Eine Viertel bleibt übrig vom ganzen Takt.}
-
-@refbugs
-
-Dieser Befehl berücksichtigt keine Verzierungen/Vorschläge am Anfang der 
-Noten. Wenn ein Stück mit einem Vorschlag anfängt, muss der Befehl 
-@code{\partial} @emph{nach} dem Vorschlag kommen:
-
-@lilypond[verbatim,quote,ragged-right,relative,fragment]
-\grace f16
-\partial 4
-g4
-a2 g2
-@end lilypond
-
-@code{\partial} ist nur für den Anfang eines Stückes vorgesehen. Wenn der 
-Befehl innerhalb eines Stückes verwendet wird, können seltsame Warnungen 
-auftreten.
-
-@node Bar lines
-@subsection Bar lines
-
-@cindex Taktlinien
-@funindex \bar
-@cindex Doppellinie
-@cindex Wiederholungszeichen
-
-Taktlinien trennen die Takte voneinander, werden aber auch verwendet, 
-um Wiederholungen anzuzeigen. Normalerweise werden sie automatisch 
-eingefügt. Zeilenumbrüche können nur an Taktlinien stattfinden.
-
-Besondere Taktlinien-Arten können mit dem @code{\bar}-Befehl erzwungen 
-werden.
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-c4 \bar "|:" c4
-@end lilypond
-
-Folgende Taktlinienarten sind vorhanden:
-
-@lilypondfile[ragged-right,quote]{bar-lines.ly}
-
-Als letztes ist @code{"||:"} notiert, das sich ähnlich wie 
-@code{"|:"} verhält. Es gibt jedoch nur an Zeilenenden eine doppelte 
-Taktlinie aus und fängt die Wiederholungslinie erst in der nächsten 
-Zeile an.
-
-Um einen Zeilenumbruch an einer Stelle zu erlauben, wo keine sichtbare 
-Taktlinie ist, kann man 
-
-@example
-\bar ""
-@end example
-
-@noindent
-benutzen. Damit wird eine unsichtbare Taktlinie an dieser Stelle eingefügt 
-und damit ein Zeilenumbruch erlaubt (ohne dass sich die Anzahl der Takte 
-erhöhen würde).
-
-In Partituren mit vielen Systemen wird ein @code{\bar}-Befehl in einem 
-System automatisch auf alle anderen Systeme angewendet. Die resultierenden 
-Taktlinien sind miteinander verbunden innerhalb einer Gruppe 
- (@code{StaffGroup}) oder einem Klaviersystem (@code{PianoStaff} 
-bzw. (@code{GrandStaff}).
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-<<
-  \new StaffGroup <<
-    \new Staff {
-      e'4 d'
-      \bar "||"
-      f' e'
-    }
-    \new Staff { \clef bass c4 g e g }
-  >>
-  \new Staff { \clef bass c2 c2 }
->>
-@end lilypond
-
-
-@commonprop
-
-@funindex whichBar
-@funindex repeatCommands
-@funindex defaultBarType
-
-Der Befehl @code{\bar }@var{Taktart} ist eine Kurzform von:
-@code{\set Timing.whichBar = }@var{Taktart}. Immer, wenn 
-@code{whichBar} auf einen Wert gesetzt wird, wird eine 
-Taktlinie dieses Typs erzeugt.
-
-Eine Taktlinie wird auch durch Setzen der 
- @code{whichBar}-Eigenschaft erzeugt. Am Anfang eines Taktes 
-wird sie auf den Wert von @code{Timing.defaultBarType} 
-gesetzt. Der Inhalt des @code{repeatCommands}-Befehls 
-wird benutzt, um Standardtaktlinien zu überschreiben.
-
-Sie sollten jedoch Wiederholungen mit dem @code{\repeat}-Befehl 
-erzeugen. Siehe Abschnitt @ref{Repeats}.
-
-
-@seealso
-
-Im Handbuch: @ref{Repeats}, @ref{System start delimiters}.
-
-Programmreferenz: @internalsref{BarLine} (auf Partitur 
-(@internalsref{Staff})-Ebene erstellt), 
-@internalsref{SpanBar} (zwischen Systemen).
-
-
-@node Unmetered music
-@subsection Unmetered music
-
-@cindex Kadenz
-@funindex \cadenzaOn
-@funindex \cadenzaOff
-
-Taktlinien und Taktzahlen werden automatisch erzeugt. Für Musik 
-ohne Meter hingegen (etwa Kadenzen) ist das allerdings nicht 
-erwünscht. Mit den Befehlen @code{\cadenzaOn} und 
-@code{\cadenzaOff} kann dieses Verhalten ausgeschaltet und 
-wieder angeschaltet werden.
-
-@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
-c4 d e d
-\cadenzaOn
-c4 c d8 d d f4 g4.
-\cadenzaOff
-\bar "|"
-d4 e d c
-@end lilypond
-
-
-@refbugs
-
-LilyPond fügt Zeilen- und Seitenumbrüche nur an einer Taktlinie 
-ein. Wenn die Kadenz nicht vor einem Umbruch endet, müssen Sie 
-selber unsichtbare Taktlinien 
-
-@example
-\bar ""
-@end example
-
-@noindent
-einfügen, um anzuzeigen, wo umgebrochen werden darf.
-
-
-@node System start delimiters
-@subsection System start delimiters
-
-@cindex Beginn eines Notensystems
-@cindex Systeme, mehrere
-@cindex Notensysteme, mehrere
-@cindex Klammer, vertikal
-@cindex Klammer, geschweift
-@cindex Partitur
-@cindex Systemgruppe
-@cindex Instrumentengruppe
-@cindex Stimmgruppe
-@cindex System, Chor
-
-Viele Partituren bestehen aus mehr als einem Notensystem. Diese Systeme 
-können auf vier unterschiedliche Arten verbunden werden:
-
-@itemize @bullet
-@item Die Gruppe wird mit einer Klammer an der linken Seite geöffnet und 
-die Taktlinien sind verbunden. Das ist der Klaviersystem 
-(@internalsref{GrandStaff})-Kontext.
-
-@lilypond[verbatim,ragged-right,quote]
-\new GrandStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item Die Gruppe beginnt mit einer Klammer und die Taktlinien sind verbunden. 
-Dieses Verhalten erzeugt der Stimmgruppen 
-(@internalsref{StaffGroup})-Kontext.
-
-@lilypond[verbatim,ragged-right,quote]
-\new StaffGroup
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item Die Gruppe beginnt mit einer Klammer, aber die Taktlinien sind nicht 
-miteinander verbunden. Das wird mit dem Chorsystem 
-(@internalsref{ChoirStaff})-Kontext erreicht.
-
-@lilypond[verbatim,ragged-right,quote]
-\new ChoirStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item Die Gruppe beginnt mit einer vertikalen Linie. Taktlinien sind nicht 
-verbunden. Das ist die Standardeinstellung für eine Partitur.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-@end itemize
-
-
-@seealso
-
-Die Definition der Taktlinien am Beginn jedes Systems werden mit 
-den Befehlen @internalsref{SystemStartBar}, @internalsref{SystemStartBrace} 
-und @internalsref{SystemStartBracket} festgelegt. Nur einer dieser 
-drei Typen wird in jedem Kontext erstellt, und dieser Typ wird durch 
-die @code{systemStartDelimiter}-Eigenschaft bestimmt.
-
-
-@commonprop
-
-Anfangsklammern können tief einander verschachtelt werden.
-
-@lilypond[quote,ragged-right,verbatim]
-\new StaffGroup
-\relative <<
-  \set StaffGroup.systemStartDelimiterHierarchy
-    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
->>
-@end lilypond
-
-
-@node Staff symbol
-@subsection Staff symbol
-
-@cindex Justierung von Notensystemen
-@cindex Notensysteme, Modifikation
-
-Noten, Dynamikzeichen usw. werden auf den Notenlinien angeordnet, die 
-sich zu einem Notensystem zusammenfassen lassen. Das Programm LilyPond 
-zeichnet diese Linien durch ein spezielles graphisches Objekt, 
-@code{staff symbol} (engl. @qq{staff} = Notensystem) genannt.
-
-Dieses Objekt kann bezüglich seiner Eigenschaften, wie Anzahl, Dicke und 
-Abstand der Linien verändert werden. Das wird gezeigt in den Beispieldateien 
-@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} und
-@lsr{staff,changing-the-staff-size.ly}.
-
-Zusätzlich können Systeme beliebig begonnen und beendet werden. Das 
-geschieht mit den Befehlen @code{\startStaff} und @code{\stopStaff}.
-
-@lilypond[verbatim,relative=2,fragment]
-b4 b
-\override Staff.StaffSymbol #'line-count = 2
-\stopStaff \startStaff
-b b
-\revert Staff.StaffSymbol #'line-count
-\stopStaff \startStaff
-b b
-@end lilypond
-
-Kombiniert mit verkleinerten Systemen, kann man diese Funktion etwa 
-benutzen, um Ossia-Abschnitte zu notieren. Siehe das Beispiel:
-
-@cindex Ossia
-
-@lilypondfile{ossia.ly}
-
-@cindex Notenlinien, Anzahl
-@cindex Notenlinien, Dicke
-@cindex Dicke der Notenlinien einstellen
-@cindex Anzahl der Notenlinien einstellen
-@cindex Zahl der Notenlinien einstellen
-
-@seealso
-
-Programmreferenz: @internalsref{StaffSymbol}.
-
-Beispiele: @lsrdir{staff}
-
-
-@node Writing music in parallel
-@subsection Writing music in parallel
-
-@cindex Parallele Notation, Eingabe
-@cindex Eingabe von Noten parallel
-@cindex Verschachtelte Musik
-
-Noten für mehrere Stimmen können verschachtelt notiert werden:
-
-@lilypond[quote,fragment,verbatim]
-\parallelMusic #'(voiceA voiceB) {
-  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
-  c'2                                c'2                                |
-  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
-  c'2                                c'2                                |
-}
-\new StaffGroup <<
-  \new Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
->>
-@end lilypond
-
-Das funktioniert ziemlich gut für Klaviernoten:
-
-@lilypond[quote,verbatim]
-music = {
-  \key c \major
-  \time 4/4
-  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
-    % Bar 1
-    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
-e''] |
-    c'2                                 c'2 |
-    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
-    c2                                  c2 |
-
-    % Bar 2
-    a'8 b'      c'' d''    e'' f''    g'' a'' |
-    d'4         d'         d'         d' |
-    c16 d e f   d e f g    e f g a    f g a b |
-    a,4         a,4        a,4        a,4 |
-
-    % Bar 3 ...
-  }
-}
-
-\score {
-  \new PianoStaff <<
-    \music
-    \new Staff <<
-      \voiceA \\
-      \voiceB
-    >>
-    \new Staff {
-      \clef bass
-      <<
-        \voiceC \\
-        \voiceD
-      >>
-    }
-  >>
-}
-@end lilypond
-
-
-@node Connecting notes
-@section Connecting notes
-
-Dieser Abschnitt stellt Eigenschaften dar, die Gruppen von 
-Noten betreffen.
-
-@menu
-* Ties::                        
-* Slurs::                       
-* Phrasing slurs::              
-* Laissez vibrer ties::         
-* Automatic beams::             
-* Manual beams::                
-* Grace notes::                 
-@end menu
-
-
-@node Ties
-@subsection Ties
-
-@cindex Bindebogen
-@cindex Überbindung
-@funindex ~
-
-Ein Bindebogen verbindet zwei benachbarte Noten der selben 
-Tonhöhe. Als Resultat wird die Dauer der Notenlänge verlängert. 
-Bindebögen dürfen nicht mit Legatobögen verwechselt werden, durch 
-die die Vortragsart bezeichnet wird, noch mit Phrasierungsbögen, 
-die musikalische Phrasen anzeigen. Eine Bindebogen wird mit der 
-Tilde @code{~} (AltGr++) notiert.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-e' ~ e' <c' e' g'> ~ <c' e' g'>
-@end lilypond
-
-Wenn ein Bindebogen an einen Akkord gehängt wird, werden alle Noten 
-dieses Akkordes übergebunden. Wenn kein Notenkopf passt, wird auch 
-kein Bogen erzeugt. Noten in Akkorden können auch einzeln übergebunden 
-werden, indem sie innerhalb des Akkordes hinter die entsprechende Note 
-geschrieben werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-<c~ e g~ b> <c e g b>
-@end lilypond
-
-Ein Bindebogen ist nur eine andere Art, die Notendauer zu verlängern, 
-ähnlich wie die Punktierung. Im nächsten Beispiel sind zwei Arten gezeigt, 
-die gleiche Notenlänge zu notieren:
-
-@lilypond[quote,fragment,ragged-right]
-\time 3/4 c'2. c'2 ~ c'4
-@end lilypond
-
-@noindent
-Bindebögen werden verwendet, wenn die Note entweder über die Taktgrenze 
-hinausragt, oder wenn Punktierung nicht benutzt werden kann, um die 
-Verlängerung anzuzeigen. Wenn man Überbindungen verwendet, sollten 
-größere Notenwerte an die Unterteilungen des Taktes angepasst werden.
-
-@lilypond[fragment,quote,ragged-right]
-\relative {
-  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
-}
-@end lilypond
-
-Wenn sehr viele Noten über die Taktgrenzen hinüber angebunden 
-werden müssen, ist es oft einfacher, die automatische Aufteilung 
-von Noten einzusetzen (siehe @ref{Automatic note splitting}). Mit 
-dieser Funktion werden automatisch lange Noten aufgeteilt und über 
-die Taktgrenze übergebunden.
-
-@funindex \repeatTie
-
-Wenn die zweite Variante einer Wiederholung mit einer Überbindung 
-anfängt, muss der Bindebogen wiederholt werden. Dass geschieht durch 
-den Befehl @code{\repeatTie}.
-
-@lilypond[fragment,quote,ragged-right,relative=2]
-r <c e g>\repeatTie
-@end lilypond
-
-@cindex Volta und Überbindung
-@cindex Wiederholung und Überbindung
-
-@commonprop
-
-Bindebögen werden teilweise verwendet, um Arpeggien auszuschreiben. 
-In diesem Fall müssen mehrere übergebundene Noten nacheinander 
-erscheinen. Das ist möglich, indem die @code{tieWaitForNote}-Eigenschaft 
-auf wahr (##t) gesetzt wird. Diese Funktion ist auch nützlich, um 
-ein Tremolo an einen Akkord zu binden. Siehe das Beispiel:
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-\set tieWaitForNote = ##t
-\grace { c16[~ e~ g]~ } <c, e g>2
-\repeat tremolo 8 { c32~ c'~ } <c c,>1
-e8~ c~ a~ f~ <e' c a f>2
-@end lilypond
-
-Bindebögen können manuell gesetzt werden, indem die 
-@code{tie-configuration}-Eigenschaft verändert wird. 
-Die erste Zahl zeigt den Abstand von der Mitte des 
-Notensystems in Notenlinienzwischenräumen, die zweite 
-die Richtung (1=nach oben, -1=nach unten).
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-<c e g>2~ <c e g> |
-\override TieColumn #'tie-configuration =
-  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
-<c e g>~ <c e g> |
-@end lilypond
-
-
-@refcommands
-
-
-@funindex \tieUp
-@code{\tieUp},
-@funindex \tieDown
-@code{\tieDown},
-@funindex \tieNeutral
-@code{\tieNeutral},
-@funindex \tieDotted
-@code{\tieDotted},
-@funindex \tieDashed
-@code{\tieDashed},
-@funindex \tieSolid
-@code{\tieSolid}.
-
-
-@seealso
-
-Im Handbuch: @ref{Automatic note splitting}.
-
-Programmreferenz: @internalsref{Tie}.
-
-
-@refbugs
-
-Der Wechsel zwischen Systemen bei aktiver Überbindung produziert keinen 
-gekrümmten Bogen.
-
-Änderung von Schlüssel oder Oktavierung zwischen übergebundenen Noten 
-ist nicht richtig definiert. In diesen Fällen kann es besser sein, einen 
-Legatobogen zu verwenden.
-
-@node Slurs
-@subsection Slurs
-
-@cindex Legatobögen
-
-Ein Legatobogen (engl. slur) zeigt an, dass die Noten 
-@emph{legato} gespielt werden sollen. Er wird mit Klammern 
-hinter den Notenwerten notiert.
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-f( g a) a8 b( a4 g2 f4)
-<c e>2( <b d>2)
-@end lilypond
-
-Die Richtung eines Legatobogens kann mit den Befehlen 
-@code{\slur@emph{DIR}}, wobei @code{@emph{DIR}} entweder
- @code{Up}, @code{Down}, oder @code{Neutral}, angezeigt
-werden.
-
-Es gibt aber auch eine Kurzform. Indem @code{_} oder @code{^} 
-for die öffnende Klammer gestellt wird, wird die Richtung 
-angegeben.
-
-@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
-c4_( c) c^( c)
-@end lilypond
-
-Nur ein Legatobogen kann gleichzeitig geschrieben werden. Wenn Sie einen 
-langen Bogen über mehreren kurzen notieren wollen, müssen Sie 
- @ref{Phrasing slurs} benutzen.
-
-
-@commonprop
-
-Manche Komponisten schreiben zwei Legatobögen, um Legatoakkorde zu 
-markieren. Das kann in LilyPond erreicht werden, indem die Eigenschaft 
-@code{doubleSlurs} gesetzt wird.
-
-@lilypond[verbatim,ragged-right,relative,fragment,quote]
-\set doubleSlurs = ##t
-<c e>4 ( <d f> <c e> <d f> )
-@end lilypond
-
-
-@refcommands
-
-@funindex \slurUp
-@code{\slurUp},
-@funindex \slurDown
-@code{\slurDown},
-@funindex \slurNeutral
-@code{\slurNeutral},
-@funindex \slurDashed
-@code{\slurDashed},
-@funindex \slurDotted
-@code{\slurDotted},
-@funindex \slurSolid
-@code{\slurSolid}.
-
-@seealso
-
-Programmreferenz: @seeinternals{Slur}.
-
-
-@node Phrasing slurs
-@subsection Phrasing slurs
-
-@cindex Phrasierungsbögen
-
-Ein Phrasierungsbogen verbindet Noten und wird verwendet, um einen 
-musikalischen Ausdruck anzuzeigen. Er wird mit den Befehlen 
-@code{\(} und @code{\)} eingegeben.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-\time 6/4 c'\( d( e) f( e) d\)
-@end lilypond
-
-Im typographischen Sinne verhalten sich Phrasierungsbögen genauso wie 
-Legatobögen. Sie werden aber als eigene Objekte behandelt. Ein 
-@code{\slurUp} hat also keine Auswirkung auf die Phrasierungsbögen, 
-anstelle dessen muss 
-@code{\phrasingSlurUp}, @code{\phrasingSlurDown} oder
-@code{\phrasingSlurNeutral} benutzt werden.
-
-Es können keine simultanen Phrasierungsbögen gesetzt werden.
-
-
-@refcommands
-
-@funindex \phrasingSlurUp
-@code{\phrasingSlurUp},
-@funindex \phrasingSlurDown
-@code{\phrasingSlurDown},
-@funindex \phrasingSlurNeutral
-@code{\phrasingSlurNeutral}.
-
-
-@seealso
-
-Programmreferenz: @internalsref{PhrasingSlur}.
-
-
-@node Laissez vibrer ties
-@subsection Laissez vibrer ties
-@cindex Laissez vibrer
-@cindex Bögen, laissez vibrer
-@cindex Ausklingen lassen
-
-So genannte @qq{laissez vibrer}-Bögen werden verwendet um anzuzeigen, dass 
-man die Musik ausklingen lassen soll. Sie werden in der Klavier-, Harfen-, 
-anderer Saiteninstrument- und Schlagzeugnotation verwendet. Sie können 
-mit dem Befehl @code{\laissezVibrer} eingegeben werden.
-
-@lilypond[fragment,ragged-right,verbatim,relative=1]
-<c f g>\laissezVibrer
-@end lilypond
-
-@seealso
-
-Programmreferenz:
-@internalsref{LaissezVibrerTie}
-@internalsref{LaissezVibrerTieColumn}
-
-Beispiele:
-@lsr{connecting,laissez-vibrer-ties.ly}
-
-
-@node Automatic beams
-@subsection Automatic beams
-
-LilyPond setzt Balken (engl. beam) automatisch.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
-@end lilypond
-
-Wenn diese automatischen Entscheidungen nicht gut genug sind, können 
-die Balken auch explizit eingegeben werden. Es können auch bestimmte 
-Balkenmuster, die sich vom Standard unterscheiden, definiert werden. 
-Hierzu siehe den Abschnitt @ref{Setting automatic beam behavior} 
-für Einzelheiten.
-
-Einzelne Noten können mit dem Befehl @code{\noBeam} markiert werden, 
-damit sie nicht mit einem Balken versehen werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c\noBeam c c
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{Beam}.
-
-
-@node Manual beams
-@subsection Manual beams
-
-@cindex Balken, manuell
-@funindex ]
-@funindex [
-
-In einigen Fällen kann es nötig sein, den automatischen Algorithmus 
-für die Balken zu überschreiben. Die automatischen Balken werden 
-beispielsweise nicht über Pausen oder Taktlinien hinweg gesetzt. 
-Manuell definierte Balken werden mit den Zeichen @code{[} und 
-@code{]} (AltGr+8 bzw. 9) markiert.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-  r4 r8[ g' a r8] r8 g[ | a] r8
-}
-@end lilypond
-
-
-@commonprop
-
-@funindex stemLeftBeamCount
-@funindex stemRightBeamCount
-
-LilyPond kann die Balkengruppen innerhalb eines größeren Balkens
-selber bestimmen, aber dabei können teilweise seltsame Ergebnisse 
-entstehen. Mit den Eigenschaften @code{stemLeftBeamCount} und 
-@code{stemRightBeamCount} können diese Unterteilungen manuell
-eingestellt werden. Wenn eine dieser Eigenschaften gesetzt ist, 
-wird es nur einmal verwendet und dann wieder zum Standard zurück 
-geschaltet.
-
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-   f8[ r16
-      f g a]
-   f8[ r16
-   \set stemLeftBeamCount = #1
-      f g a]
-}
-@end lilypond
-
-Die Eigenschaft @code{subdivideBeams} kann benutzt werden, um alle 
-16tel-Balken oder kleinere Werte zu bestimmten Taktzeiten zu 
-unterteilen. Diese Zeiten werden mit der @code{beatLength}-Eigenschaft 
-gesetzt.
-
-@lilypond[fragment,quote,relative=2,verbatim]
-c16[ c c c c c c c]
-\set subdivideBeams = ##t
-c16[ c c c c c c c]
-\set Score.beatLength = #(ly:make-moment 1 8)
-c16[ c c c c c c c]
-@end lilypond
-@funindex subdivideBeams
-
-@noindent
-Zu mehr Information über @code{make-moment} siehe
-@ref{Time administration}.
-
-Zeilenumbrüche sind normalerweise verboten, wenn Balken sich über 
-die Taktlinien erstrecken. Das kann aber durch Setzen von 
-@code{breakable} verändert werden.
-
-@funindex breakable
-
-@cindex Balken und Zeilenumbrüche
-@cindex Balken zwischen Systemen
-@funindex auto-knee-gap
-
-
-Balken mit Hälsen nach oben und unten werden automatisch eingesetzt, 
-wenn ein großer Abstand zwischen Notenköpfen gefunden wird. Die Größe 
-des Wertes kann mit dem 
-@code{auto-knee-gap}-Objekt eingestellt werden.
-
-@refbugs
-
-Automatisch erstellte Balken zwischen Systemen können nicht zusammen 
-mit automatisch versteckten Systemen verwendet werden. Siehe auch
- @ref{Hiding staves}.
-
-@c Is this still true with skyline spacing stuff? -J.Mandereau
-Balken vermeiden nicht andere Objekte, wie etwa Text und Versetzungszeichen.
-
-@node Grace notes
-@subsection Grace notes
-
-@funindex \grace
-@cindex Verzierungen
-@cindex Ziernoten
-@cindex Vorhalt
-@cindex Vorschlag
-
-Verzierungen sind ausgeschriebene Ornamente. Die üblichste ist der 
-Vorschlag. Er wird durch eine verkleinerte Note mit Schrägstrich 
-und Bogen notiert. Der Vorhalt dagegen ist eine Verzierung, die 
-einen bestimmten Notenwert der Hauptnote für sich beansprucht. 
-Er wird als verkleinerte Note ohne Schrägstrich notiert. 
-Der Vorschlag wird mit dem Befehl @code{\acciaccatura} und der Vorhalt 
-mit @code{\appoggiatura} eingegeben.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-b4 \acciaccatura d8 c4 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
-@end lilypond
-
-Bei beiden handelt es sich um spezielle Formen des @code{\grace} 
-(engl. Verzierung)-Befehl. Wenn dieser Befehl einem musikalischen 
-Ausdruck vorgestellt wird, wird ein neuer Ausdruck geschaffen, 
-der in kleineren Noten gesetzt wird und von der logischen Zeit 
-innerhalb des Taktes keinen Raum beansprucht.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2 c4
-@end lilypond
-
-@noindent
-Anders als @code{\acciaccatura} oder @code{\appoggiatura} setzt 
-der @code{\grace}-Befehl keinen Bogen.
-
-@cindex Zeitberechnung, intern
-
-Programmintern wird die Zeitberechnung für Verzierungen in einer 
-zweiten Zählebene vorgenommen. Jeder Zeitpunkt beinhaltet zwei 
-rationale Zahlen: die eine steht für die logische Zeit, die andere 
-für die @qq{Verzierungszeit}. Das obere Beispiel ist hier 
-mit den entsprechenden Zeitwerten angezeigt:
-
-@lilypond[quote,ragged-right]
-<<
-  \relative c''{
-    c4 \grace c16 c4 \grace {
-    c16[ d16] } c2 c4
-  }
-  \new Lyrics \lyricmode {
-    \override LyricText #'font-family = #'typewriter
-
-    \markup { (0,0) } 4
-    \grace { \markup {
-      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
-    \markup { (\fraction 1 4 , 0 ) } 4
-    \grace {
-      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
-      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
-    }
-    \markup { ( \fraction 2 4 , 0 ) }
-  }
->>
-@end lilypond
-
-Die Position von Verzierungen wird zwischen den Systemen synchronisiert. 
-Im folgenden Beispiel sind jeweils zwei Sechzehntel gegen jede Achtel 
-gesetzt:
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \grace { c16[ d e f] } e4 }
-   \new Staff { c4 \grace { g8[ b] } c4 } >>
-@end lilypond
-
-@funindex \afterGrace
-
-Eine Verzierung kann auch auf eine Note folgend gesetzt werden. Dazu wird 
-der @code{\afterGrace}-Befehl benutzt. Er nimmt zwei Argumente: die 
-Hauptnote und die Verzierungen, die nach der Hauptnote erscheinen sollen.
-
-@lilypond[ragged-right, verbatim,relative=2,fragment]
-c1 \afterGrace d1 { c16[ d] } c4
-@end lilypond
-
-Damit wird die Verzierung im Abstand von 3/4 der Länge der Hauptnote 
-gesetzt. Dieser Bruch kann durch Setzen von 
-@code{afterGraceFraction} verändert werden:
-
-@example
-#(define afterGraceFraction (cons 7 8))
-@end example
-
-@noindent
-Hier wurde die Position auf das vorletzte Achtel der Notenlänge gesetzt.
-
-Der gleiche Effekt kann auch manuell erreicht werden:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  << { d1^\trill_( }
-     { s2 \grace { c16[ d] } } >>
-  c4)
-}
-@end lilypond
-
-@noindent
-Indem die Dauer der unsichtbaren Note (hier eine Halbe) wird der 
-Abstand zwischen Hauptnote und Verzierung angepasst.
-
-Ein @code{\grace}-Notenabschnitt wird nach besonderen Satzregeln 
-gesetzt, um z. B. kleinere Noten zu benutzen und die Richtung der 
-Hälse einzustellen. Veränderungen am Layout müssen also innerhalb 
-des Verzierungsausdrucks gesetzt werden, damit sie auch eine Auswirkung haben.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  \acciaccatura {
-    \stemDown
-    f16->
-    \stemNeutral
-  }
-  g4
-}
-@end lilypond
-
-@noindent
-Diese Einstellungen müssen auch innerhalb der Verzierungsebene wieder 
-rückgängig gemacht werden.
-
-Das Layout der Verzierungsausdrücke kann mit der Funktion 
- @code{add-grace-property} verändert werden. Im folgenden Beispiel 
-wird die Richtung der Notenhälse neutralisiert, so dass sie nicht 
-unbedingt in nach oben zeigen.
-
-@example
-\new Staff @{
-  #(add-grace-property 'Voice 'Stem 'direction '())
-  @dots{}
-@}
-@end example
-
-@noindent
-Eine andere Option ist es, die Variablen @code{startGraceMusic},
-@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
-@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic} und
-@code{stopAppoggiaturaMusic} zu vermeiden. Mehr Information findet sich 
-in der Datei @file{ly/@/grace@/-init@/.ly}.
-
-@noindent
-Der Schrägstrich durch den Notenhals der Vorschläge kann auch in anderen 
-Situation erreicht werden mit 
-@code{\override Stem  #'stroke-style = #"grace"}.
-
-
-@commonprop
-
-Verzierungen könne gezwungen werden, den Hauptnoten entsprechend aufgeteilt 
-zu werden.
-
-@lilypond[relative=2,ragged-right]
-<<
-  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
-  \new Staff {
-     c'4
-     \afterGrace
-     c'4
-     { c'16[ c'8 c'16] }
-     c'4
-  }  
-  \new Staff {
-     c'16[ c'16 c'16 c'16]
-     c'16[ c'16 c'16 c'16]
-     c'4
-  }
->>
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{GraceMusic}.
-
-
-@refbugs
-
-Eine Partitur, die mit einem @code{\grace}-Ausdruck beginnt, benötigt 
-eine explizit gesetzte neue Stimme (@code{\new Voice}), sonst werden 
-Hauptnote und Verzierung auf verschiedenen Systemen gesetzt.
-
-Die Synchronisation von Verzierungen kann auch zu Überraschungen führen. 
-Auch andere Symbole der Systeme, wie Vorzeichen, Taktlinien usw., werden 
-synchronisiert. Vorsicht ist geboten, wenn nur in bestimmten Systemen 
-Verzierungen vorkommen:
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" d4 } >>
-@end lilypond
-
-@noindent
-Dem kann abgeholfen werden, indem unsichtbare Verzierungsnoten der selben 
-Länge in die anderen Systeme gesetzt werden. Im obigen Beispiel müsste 
-also 
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
-@end lilypond
-
-@noindent gesetzt werden.
-
-Verzierungsabschnitte sollten nur innerhalb von sequentiellen musikalischen 
-Ausdrücken benützt werden. Wenn sie ineinandergeschachtelt werden, kann es 
-zu Fehlermeldungen oder Abstürzen kommen.
-
-
-
-@node Expressive marks
-@section Expressive marks
-
-Vortragszeichen helfen dem Musiker, mehr Ausdruck in die Musik zu legen.
-
-@menu
-* Articulations::               
-* Fingering instructions::      
-* Dynamics::                    
-* Breath marks::                
-* Trills::                      
-* Glissando::                   
-* Arpeggio::                    
-* Falls and doits::             
-@end menu
-
-
-@node Articulations
-@subsection Articulations
-
-@cindex Artikulationszeichen
-@cindex Beschriftung
-@cindex Zeichen
-
-Eine Vielfalt an Symbolen kann über und unter den Noten erscheinen, 
-um zu markieren, auf welche Art die Note ausgeführt werden soll. Sie 
-werden in LilyPond notiert, indem ein Minuszeichen an die Note gehängt 
-wird, gefolgt von dem jeweiligen Zeichen. Hier einige Beispiele:
-
-@lilypondfile[quote,ragged-right]{script-abbreviations.ly}
-
-Die Bedeutung der Zeichen kann auch verändert werden. Siehe etwa 
-@file{ly/@/script@/-init@/.ly} für Beispiele.
-
-Das Artikulationszeichen wird automatisch gesetzt, aber die Richtung kann 
-auch erzwungen werden. Wie auch bei anderen LilyPond-Befehlen, erreicht 
-man mit @code{_} eine Ausrichtung unter der Note, mit @code{^} eine 
-Ausrichtung über der Note.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c''4^^ c''4_^
-@end lilypond
-
-Andere Symbole können mit der Syntax 
-@var{Note}@code{\}@var{Bezeichnung} hinzugefügt werden. 
-Auch sie können mit @code{^} und @code{_} nach oben 
-und unten gezwungen werden:
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c\fermata c^\fermata c_\fermata
-@end lilypond
-
-@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
-
-Hier ist eine Liste, die alle möglichen Zeichen darstellt:
-
-@lilypondfile[ragged-right,quote]{script-chart.ly}
-
-
-@commonprop
-
-Die vertikale Anordnung der Zeichen wird durch die 
-@code{script-priority}-Eigenschaft kontrolliert. Je kleiner die Zahl 
-ist, umso näher wird das Zeichen an die Note gesetzt. In dem 
-nächsten Beispiel hat das Textsymbol (@internalsref{TextScript}),
-ein Kreuz, die niedrigste Priorität und wird also als unterstes 
-gesetzt. Im zweiten Beispiel hat der Praller (das @internalsref{Script}) 
-die niedrigste Priorität und erscheint innen. Wenn zwei Objekte die 
-gleiche Priorität haben, entscheidet die Reihenfolge, in der sie notiert 
-sind, welches zuerst kommt.
-
-@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
-\once \override TextScript #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-
-\once \override Script #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{Script}.
-
-
-@refbugs
-
-Diese Zeichen erscheinen zwar im Druck, haben aber keine Auswirkung 
-auf die produzierte MIDI-Datei.
-
-@node Fingering instructions
-@subsection Fingering instructions
-
-@cindex Fingersatz
-@cindex Fingerwechsel
-
-Fingersatzanweisungen können folgenderweise notiert werden:
-@example
-@var{Note}-@var{Zahl}
-@end example
-Für Fingerwechsel muss eine Textbeschriftung (markup) benutzt werden:
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
-@end lilypond
-
-Mit dem Daumen-Befehl (@code{\thumb}) können die Noten bezeichnet 
-werden, die mit dem 
-Daumen (etwa auf dem Cello) gespielt werden sollen.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
-@end lilypond
-
-Fingersätze für Akkorde können auch zu einzelnen Noten des 
-Akkordes hinzugefügt werden, indem sie innerhalb der Akkord-Klammer 
-direkt an die Noten angefügt werden.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
-@end lilypond
-
-
-@commonprop
-
-Eine bessere Kontrolle über die Position der Fingersätze in Akkorden 
-lässt sich mit der Eigenschaft @code{fingeringOrientations} herstellen:
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-Mit dieser Funktion können Fingersatzbezeichnungen auch bei einstimmiger 
-Musik sehr nah in die Notenköpfe gerückt werden.
-
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{Fingering}.
-
-Beispiele: @lsr{expressive,fingering-chords.ly}
-
-
-@node Dynamics
-@subsection Dynamics
-
-@cindex Lautstärke
-@cindex Dynamik
-@funindex \pppp
-@funindex \ppp
-@funindex \pp
-@funindex \p
-@funindex \mp
-@funindex \mf
-@funindex \f
-@funindex \ff
-@funindex \fff
-@funindex \ffff
-@funindex \fp
-@funindex \sf
-@funindex \sff
-@funindex \sp
-@funindex \spp
-@funindex \sfz
-@funindex \rfz
-
-Absolute Dynamikbezeichnung wird mit Befehlen nach den Noten 
-angezeigt. Die vordefinierten Befehle lauten:
-@code{\ppppp},
-@code{\pppp}, @code{\ppp},
-@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
-@code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
-@code{\sp}, @code{\spp}, @code{\sfz} und @code{\rfz}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
-c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
-@end lilypond
-
-@funindex \<
-@funindex \>
-@funindex \!
-
-Eine Crescendo-Klammer wird mit dem Befehl @code{\<} begonnen und 
-mit @code{\!} oder einem absoluten Dynamikbefehl beendet. Ein 
-Decrescendo beginnt mit @code{\>} und wird auf die gleiche Art 
-beendet. @code{\cr} und @code{\decr} können anstelle von @code{\<} und 
-@code{\>} benutzt werden. Weil diese Zeichen an Noten gekoppelt sind, 
-müssen unsichtbare Noten benutzt werden, wenn mehr als ein Zeichen pro 
-Note benötigt wird.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\< c\! d\> e\!
-<< f1 { s4 s4\< s4\! \> s4\! } >>
-@end lilypond
-
-@noindent
-Eine Crescendo-Klammer beginnt normalerweise am linken Rand der Anfangsnote 
-und endet am rechten Rand der Endnote. Wenn das Ende auf den Taktanfang 
-fällt, endet die Klammer an der direkt vorhergehenden Taktlinie. Diese 
-Einstellung lässt sich aber durch die Eigenschaft @code{hairpinToBarline} 
-verändern.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set hairpinToBarline = ##f
-c4\< c2. c4\!
-@end lilypond
-
-In manchen Situationen kann auch der @code{\espressivo}-Befehl 
-geeignet sein, ein An- und Abschwellen einer Note anzuzeigen.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c2 b4 a g1\espressivo
-@end lilypond
-
-Hier können allerdings sehr kurze Klammern auftreten. Der Wert von 
-@code{minimum-length} in @internalsref{Voice}.@internalsref{Hairpin} 
-kann angepasst werden, etwa:
-
-@example
-\override Voice.Hairpin #'minimum-length = #5
-@end example
-
-@cindex Al niente
-@cindex Niente, al
-
-Klammern können auch mit einem kleinen Kreis um die Spitze 
-(al niente-Notation) gedruckt werden, 
-wenn die @code{circled-tip}-Eigenschaft gesetzt wird.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override Hairpin #'circled-tip = ##t
-c2\< c\!
-c4\> c\< c2\!
-@end lilypond
-
-
-@cindex Crescendo
-@cindex Decrescendo
-@cindex Diminuendo
-
-Anstelle der Klammern kann auch der Text @emph{cresc.} bzw. @emph{decr.}
-oder @emph{dim.} ausgegeben werden.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\setTextCresc
-c\< d e f\!
-\setHairpinCresc
-e\> d c b\!
-\setTextDecresc
-c\> d e f\!
-\setTextDim
-e\> d c b\!
-@end lilypond
-
-Dieser Text kann auch beliebig angepasst werden:
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\set crescendoText = \markup { \italic "cresc. poco" }
-\set crescendoSpanner = #'dashed-line
-a'2\< a a a\!\mf
-@end lilypond
-
-Um neue Dynamikzeichen oder Text, der mit diesen zusammen 
-gesetzt wird, zu erstellen, siehe den Abschnitt @ref{New dynamic marks}.
-
-Vertikale Position der Zeichen wird von der Funktion 
-@internalsref{DynamicLineSpanner} verwaltet.
-
-
-@commonprop
-
-Dynamikzeichen, die an der selben Note auftreten, werden vertikal 
-angeordnet. Wenn Sie sicher gehen wollen, dass die Zeichen angeordnet 
-werden, auch wenn sie nicht an der selben Note vorkommen, kann die 
-@code{staff-padding}-Eigenschaft vergrößert werden.
-
-@example
-\override DynamicLineSpanner #'staff-padding = #4
-@end example
-
-Diese Eigenschaft kann man auch benutzen, um Dynamikzeichen davor zu 
-hindern, mit anderen Noten zusammenzustoßen.
-
-Crescendi und Decrescendi, die an der ersten Note einer neuen Zeile 
-enden, werden nicht ausgegeben. Mit
-
-@example
-\override Score.Hairpin #'after-line-breaking = ##t
-@end example
-
-@noindent
-wird dieses Verhalten ausgeschaltet.
-
-Text für dynamische Änderungen (wie @emph{cresc.}) 
-wird mit einer gestrichelten Linie gesetzt. Um diese Linie 
-zu unterdrücken, kann der Befehl
-
-@example
-\override DynamicTextSpanner #'dash-period = #-1.0
-@end example
-
-@noindent
-eingesetzt werden.
-
-@refcommands
-
-@funindex \dynamicUp
-@code{\dynamicUp},
-@funindex \dynamicDown
-@code{\dynamicDown},
-@funindex \dynamicNeutral
-@code{\dynamicNeutral}.
-
-
-@seealso
-
-Programmreferenz: @internalsref{DynamicText}, @internalsref{Hairpin}.
-Vertikale Positionierung der Symbole wird von der Eigenschaft 
-@internalsref{DynamicLineSpanner} verwaltet.
-
-
-@node Breath marks
-@subsection Breath marks
-
-Atemzeichen werden mit dem Befehl @code{\breathe} eingegeben.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c'4 \breathe d4
-@end lilypond
-
-
-@commonprop
-
-Das Symbol für das Atemzeichen kann verändert werden, indem die Eigenschaft 
-@code{text} des @code{BreathingSign}-Objektes mit beliebigem Text 
-überschrieben wird. Zum Beispiel ergibt
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-c'4
-\override BreathingSign #'text
-  = #(make-musicglyph-markup "scripts.rvarcomma")
-\breathe
-d4
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{BreathingSign}.
-
-Beispiele: @lsr{expressive,breathing-sign.ly}
-
-
-@node Trills
-@subsection Trills
-@cindex Triller
-
-Kurze Triller können wie ein normales Artikulationszeichen eingegeben 
-werden, siehe @ref{Articulations}.
-
-Längere Triller werden mit den Befehlen @code{\startTrillSpan} zu 
-Beginn und @code{\stopTrillSpan} am Ende erstellt.
-
-@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
-\new Voice {
-  << { c1 \startTrillSpan }
-     { s2. \grace { d16[\stopTrillSpan e] } } >>
-  c4 }
-@end lilypond
-
-@cindex Triller mit Tonhöhe
-
-Triller, die auf einer bestimmten Note ausgeführt werden sollen, können 
-mit dem Befehl @code{pitchedTrill} notiert werden.
-
-@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
-\pitchedTrill c4\startTrillSpan fis
-f\stopTrillSpan
-@end lilypond
-
-@noindent
-Dabei ist das erste Argument die Hauptnote. Die zweite Note wird 
-ohne Hals in Klammern gesetzt.
-
-
-@refcommands
-
-@code{\startTrillSpan},
-@funindex \startTrillSpan
-@code{\stopTrillSpan}.
-@funindex \stopTrillSpan
-
-
-@seealso
-
-Programmreferenz: @internalsref{TrillSpanner}.
-
-
-@node Glissando
-@subsection Glissando
-
-@cindex Glissando
-@funindex \glissando
-
-Ein Glissando ist ein Gleiten zwischen Tonhöhen. Es wird mit einer 
-geraden oder gezackten Linie zwischen zwei Noten notiert. Es wird 
-mit dem Befehl @code{\glissando} auf eine Note folgend notiert.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-c2\glissando c'
-\override Glissando #'style = #'zigzag
-c2\glissando c,
-@end lilypond
- 
-@commonprop
-
-@lilypond[quote,ragged-right,verbatim]
-I = \once \override NoteColumn #'ignore-collision = ##t
-
-\relative <<
-  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
-  { \oneVoice \I c2 \glissando \I d, }
->>
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{Glissando}.
-
-Beispiele:
-@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
-
-
-
-@refbugs
-
-Text über der Linie (wie etwa @emph{gliss.}) wird nicht unterstützt.
-
-
-@node Arpeggio
-@subsection Arpeggio
-
-@cindex Arpeggio
-@cindex Gebrochene Akkorde
-@funindex \arpeggio
-
-Ein Arpeggio als Zeichen, dass ein Akkord gebrochen gespielt werden soll, 
-kann mit dem Befehl @code{\arpeggio} hinter dem 
-Akkord erzeugt werden.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-<c e g c>\arpeggio
-@end lilypond
-
-Eine eckige Klammer zur Linken des Akkordes zeigt an, dass kein Arpeggio 
-gespielt werden soll.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\arpeggioBracket
-<c' e g c>\arpeggio
-@end lilypond
-
-Die Richtung des Arpeggios wird manchmal mit Pfeilen notiert und hat 
-eigene Befehle.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new Voice {
-  \arpeggioUp
-  <c e g c>\arpeggio
-  \arpeggioDown
-  <c e g c>\arpeggio
-}
-@end lilypond
-
-
-@commonprop
-
-Wenn ein Arpeggio sich über mehrere Systeme erstreckt, kann mit einem 
-Klaviersystem die Eigenschaft 
-@internalsref{PianoStaff}.@code{connectArpeggios} gesetzt werden.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \set PianoStaff.connectArpeggios = ##t
-  \new Staff { <c' e g c>\arpeggio }
-  \new Staff { \clef bass <c,, e g>\arpeggio }
->>
-@end lilypond
-
-@c TODO: cross-voice arpeggio example?
-@c such an example is already in LSR -J.Mandereau
-
-@refcommands
-
-@code{\arpeggio},
-@funindex \arpeggioUp
-@code{\arpeggioUp},
-@funindex \arpeggioDown
-@code{\arpeggioDown},
-@funindex \arpeggioNeutral
-@code{\arpeggioNeutral},
-@funindex \arpeggioBracket
-@code{\arpeggioBracket}.
-
-
-@seealso
-
-Notationshandbuch: @ref{Ties}, um Arpeggios auszuschreiben.
-
-Programmreferenz: @internalsref{Arpeggio}.
-
-
-@refbugs
-
-Es ist nicht möglich, Arpeggios zwischen Systemen und solche, die sich 
-nur auf ein System erstrecken, zum gleichen Zeitpunkt in einem 
-Klaviersystem zu benutzen.
-
-
-@node Falls and doits
-@subsection Falls and doits
-
-Gleiten nach oben und unten kann mit dem Befehl @code{\bendAfter} 
-notiert werden.
-
-@lilypond[fragment,ragged-right,relative=2]
-\override Score.SpacingSpanner #'shortest-duration-space = #3.0
-c4-\bendAfter #+5
-c4-\bendAfter #-3
-@end lilypond
-
-
-@node Repeats
-@section Repeats
-
-Wiederholung ist ein zentrales Konzept in der Musik, und es gibt eine 
-ganze Vielzahl von Notationsmöglichkeiten für Wiederholungen.
-
-@menu
-* Repeat types::                
-* Repeat syntax::               
-* Repeats and MIDI::            
-* Manual repeat commands::      
-* Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
-@end menu
-
-
-@node Repeat types
-@subsection Repeat types
-
-@cindex Wiederholungen
-
-Die folgenden Wiederholungsarten sind unterstützt:
-
-@table @code
-@item unfold
-Die wiederholte Musik wird vollständig ausgeschrieben (bzw. gespielt). 
-Hiermit können sehr einfach sich wiederholende Stellen notiert werden. 
-Es ist auch der einzige Wiederholungstyp, der in der MIDI-Ausgabe 
-berücksichtigt wird.
-
-@item volta
-Wiederholungen werden nicht ausgeschrieben, aber alternative Endungen 
-(Volta-Klammern) können bei Bedarf notiert werden. Das ist die übliche 
-Wiederholung für Wiederholungen mit unterschiedlichen Enden. Die 
-Wiederholung wird in der MIDI-Datei nicht berücksichtigt.
-
-
-@item tremolo
-Hiermit können Tremolo-Balken erstellt werden. Sie werden nicht in die 
-MIDI-Datei aufgenommen.
-
-@item percent
-Hiermit können noten- oder taktweise Wiederholungszeichen notiert werden. 
-Sie erinnern an das Prozentzeichen. Auch sie werden nicht in der MIDI-Datei 
-berücksichtigt. Diese Wiederholungen müssen innerhalb eines Stimmen 
-(@code{Voice})-Kontextes erstellt werden.
-
-@end table
-
-
-@node Repeat syntax
-@subsection Repeat syntax
-
-@cindex Klammer, Wiederholung
-@cindex Volta
-@cindex Prima volta
-@cindex Seconda volta
-@cindex Zweite Klammer
-@funindex \repeat
-
-LilyPond besitzt eine einzige Syntax für alle unterschiedlichen 
-Wiederholungstypen. Sie lautet:
-
-@example
-\repeat @var{Typ} @var{Wiederholungszähler} @var{Wiederholungsnoten}
-@end example
-
-Wenn Sie unterschiedliche Endungen haben, können Sie diese mit dem 
-Befehl 
-@funindex \alternative notieren, etwa 
-@example
-\alternative @{
-  @var{Klammer1}
-  @var{Klammer2}
-  @var{Klammer3}
-  @dots{}
-@}
-@end example
-
-@noindent
-wobei jede Klammer ein musikalischer Ausdruck ist. Wenn Sie nicht genug 
-unterschiedliche Alternativen für alle Wiederholungen angeben, wird 
-angenommen, dass die erste Alternative mehr als einmal verwendet wird.
-
-Eine typische Wiederholung kann so aussehen:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
-@end lilypond
-
-Und mit unterschiedlichen Klammern:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
-@end lilypond
-
-Wiederholungen können mit Auftakten kombiniert werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 e |
-  \repeat volta 4 { c2 d2 | e2 f2 | }
-  \alternative { { g4 g g e } { a a a a | b2. } }
-}
-@end lilypond
-
-@noindent
-or
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 
-  \repeat volta 4 { e | c2 d2 | e2 f2 | }
-  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
-}
-@end lilypond
-
-
-@funindex \repeatTie
-
-Bindebögen können auch an eine zweite Klammer angefügt werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
-@end lilypond
-
-Es ist auch möglich, die Klammern zu verkürzen, indem ihnen ein 
-Wert in der Eigenschaft @code{voltaSpannerDuration} zugewiesen 
-wird. Im nächsten Beispiel ist die Klammer beispielsweise nur 
-einen 3/4-Takt lang.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c''{
-  \time 3/4
-  c c c
-  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
-  \repeat volta 5 { d d d }
-  \alternative { { e e e f f f }
-  { g g g } }
-}
-@end lilypond
-
-Wenn eine Wiederholung am Anfang einer neuen Zeile beginnen soll 
-und eine Doppellinie am Ende der vorhergehenden Zeile stehen soll, 
-muss
-@example
-@dots{} \bar "||:" \break 
-\repeat volta 2 @{ @dots{} 
-@end example
-
-@noindent benutzt werden. Siehe 
- @ref{Bar lines} for more information.
-
-@seealso
-
-Programmreferenz: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} und
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-Beispiele:
-
-Klammern für die Wiederholung werden normalerweise nur über dem obersten 
-System ausgegeben. Das kann verändert werden, indem 
- @code{Volta_engraver} in den @code{Staff}-Kontext gesetzt wird,
-über dem diese Klammern erscheinen sollen. Vgl.
-@ref{Modifying context plug-ins} und
-
-@lsr{repeats,volta@/-multi@/-staff@/.ly}.
-
-
-@refbugs
-
-@cindex Wiederholung, mehrdeutig
-
-Eine ineinandergeschachtelte Wiederholung wie 
-
-@example
-\repeat @dots{}
-\repeat @dots{}
-\alternative
-@end example
-
-@noindent
-ist mehrdeutig, weil nicht klar ist, zu welchem @code{\repeat}-Abschnitt 
-die @code{\alternative}-Endung gehört. Diese Mehrdeutigkeit wird von 
-LilyPond aufgelöst, indem die alternative Endung immer zu der innersten 
-Wiederholung gehört. Um Klarheit zu schaffen, bietet es sich an, in solchen 
-Situationen Klammern zu benutzen.
-
-Die Taktposition wird bei einer alternativen Endung nicht mitgeteilt, so 
-dass nach einer Wiederholung diese Information manuell angegeben werden 
-muss, 
-entweder durch setzen von @code{Score.measurePosition} oder indem der 
-Befehl @code{\partial} benutzt wird. Gleichermaßen werden auch Legato- oder 
-Bindebögen nicht wiederholt.
-
-
-@node Repeats and MIDI
-@subsection Repeats and MIDI
-
-@cindex Erweiterung von Wiederholungen
-@funindex \unfoldRepeats
-
-Mit ein bisschen Anpassung können alle Wiederholungstypen 
-auch in der MIDI-Datei wiedergegeben werden. Das wird erreicht 
-durch die @code{\unfoldRepeats}-Funktion. Hiermit werden alle 
-Wiederholungen, welcher Art auch immer, in notengetreue Wiederholungen 
-umgewandelt, die Noten werden also wiederholt ausgegeben.
-
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
-  \repeat tremolo 8 {c'32 e' }
-  \repeat percent 2 { c''8 d'' }
-  \repeat volta 2 {c'4 d' e' f'}
-  \alternative {
-    { g' a' a' g' }
-    {f' e' d' c' }
-  }
-}
-\bar "|."
-@end lilypond
-
-Wenn man eine Partitur schreibt, die diesen @code{\unfoldRepeats}-Befehl 
-für die MIDI-Ausgabe benutzt, muss man zwei @code{\score}-Umgebungen 
-schreiben: eine für die MIDI-Ausgabe, wo die Wiederholungen ausgeschrieben 
-werden, und eine für die gedruckte Notation, in der Klammern, Tremolo und 
-Prozent-Wiederholungen benutzt werden. Zum Beispiel:
-
-@example
-\score @{
-  @var{..music..}
-  \layout @{ .. @}
-@}
-\score @{
-  \unfoldRepeats @var{..music..}
-  \midi @{ .. @}
-@}
-@end example
-
-
-@node Manual repeat commands
-@subsection Manual repeat commands
-
-@funindex repeatCommands
-
-Die Eigenschaft @code{repeatCommands} kann verwendet werden, um das 
-Aussehen der Wiederholungen zu beeinflussen. Ihr Argument ist eine 
-Scheme-Liste an Wiederholungsbefehlen.
-
-@table @asis
-@item @code{start-repeat}
-Setzt eine @code{|:} Taktlinie.
-
-@item @code{end-repeat}
-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 
-Schriftart zu verändern, weil die Standardschriftart für die Nummern 
-keine Buchstaben enthält.
-
-@item @code{(volta #f)}
-Beendet eine aktive Klammer.
-@end table
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c4
-  \set Score.repeatCommands = #'((volta "93") end-repeat)
-c4 c4
-  \set Score.repeatCommands = #'((volta #f))
-c4 c4
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} und
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-@node Tremolo repeats
-@subsection Tremolo repeats
-
-@cindex Tremolobalken
-
-Um Tremolozeichen zwischen den Noten zu setzen, kann der 
-Wiederholungstyp @code{tremolo} benutzt werden.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
-}
-@end lilypond
-
-Tremolozeichen können auch einer einzelnen Noten hinzugefügt werden. In 
-diesem Fall darf die Note nicht von Klammern eingefasst sein.
-
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
-@end lilypond
-
-Ähnliche Darstellung wird erreicht durch eine innere Tremolountereilung, 
-die im Abschnitt @ref{Tremolo subdivisions} beschrieben wird.
-
-
-@seealso
-
-Im Handbuch: @ref{Tremolo subdivisions}, @ref{Repeats}.
-
-Programmreferenz: @internalsref{Beam}, @internalsref{StemTremolo}.
-
-
-@node Tremolo subdivisions
-@subsection Tremolo subdivisions
-
-@cindex Tremolozeichen
-@funindex tremoloFlags
-
-Tremolozeichen können einer einzelnen Noten hinzugefügt werden, indem 
-an sie die Zeichen @code{:}[@var{Anzahl}] angefügt werden. Die Anzahl 
-bezeichnet die Dauer der einzelnen Noten, und ihr Mindestwert ist 8. 
-Mit der Zahl 8 erhält man eine Linie durch den Notenhals. Wenn die 
-Anzahl ausgelassen wird, wird der letzte benutzte Wert (in der 
-Funktion @code{tremoloFlags} gespeichert) eingesetzt.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
-@end lilypond
-
-
-@refbugs
-
-Tremolos, die auf diese Weise notiert werden, werden nicht in die 
-MIDI-Datei aufgenommen.
-
-
-@seealso
-
-Im Handbuch: @ref{Tremolo repeats}.
-
-Programmreferenz: @internalsref{StemTremolo}.
-
-
-@node Measure repeats
-@subsection Measure repeats
-
-@cindex Prozent-Wiederholungen
-@cindex Taktweise Wiederholungen
-
-Wenn der Prozent (@code{percent})-Wiederholungsstil gesetzt ist, wird 
-eine Notenphrase wiederholt. Sie wird einmal gedruckt und dann durch 
-ein spezielles Zeichen ersetzt. Phrasen von ein oder zwei Takten Dauer 
-werden durch ein dem Prozentzeichen ähnlichen Zeichen markiert, Phrasen, 
-die kürzer als ein Takt sind, durch einen Schrägstrich dargestellt. 
-Dieser Wiederholungstyp muss innerhalb eines Stimmen 
-(@code{Voice})-Kontextes notiert werden.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Wiederholungen, die länger als einen Takt dauern, können gezählt werden, 
-wenn die @code{countPercentRepeats}-Eigenschaft eingeschaltet wird.
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat "percent" 4 { c1 }
-}
-@end lilypond
-
-Isolierte Prozentzeichen können auch gedruckt werden. Das geschieht, indem 
-einer Ganztaktpause (@code{R}) eine andere Funktion zugewiesen wird.
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
-
-
-
diff --git a/Documentation/de/user/changing-defaults.itely b/Documentation/de/user/changing-defaults.itely
index 0b6bf5b47a..cba4c17761 100644
--- a/Documentation/de/user/changing-defaults.itely
+++ b/Documentation/de/user/changing-defaults.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/chords.itely b/Documentation/de/user/chords.itely
new file mode 100644
index 0000000000..d36ffe221d
--- /dev/null
+++ b/Documentation/de/user/chords.itely
@@ -0,0 +1,424 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Chords Blah
+@section Chords Blah
+
+Intro text.
+
+@menu 
+* TODO chords fix::
+@end menu
+
+
+@node TODO chords fix
+@subsection TODO chords fix
+
+@c  awkward name; awkward section name.
+@c  still, the Basic "chords" seems like a good name...  :(
+@menu
+* Introducing chord names::     
+* Chords mode::                 
+* Printing chord names::        
+@end menu
+
+@node Introducing chord names
+@unnumberedsubsubsec Introducing chord names
+@cindex Akkordbezeichnungen
+
+LilyPond bringt Unterstützung zur Ausgabe von Akkordsymbolen 
+mit. Akkorde können entweder mithilfe der musikalischen 
+Akkordeingabe (also @code{< ... >}) notiert werden, aber sie 
+können auch mit ihren Bezeichnungen direkt eingegeben werden. 
+Programmintern werden die Akkorde als eine Gruppe von Tonhöhen
+dargestellt und können somit transponiert werden.
+
+@lilypond[quote,ragged-right,verbatim,ragged-right]
+twoWays = \transpose c c' {
+  \chordmode {
+    c1 f:sus4 bes/f
+  }
+  <c e g>
+  <f bes c'>
+  <f bes d'>
+}
+
+<< \new ChordNames \twoWays
+   \new Voice \twoWays >>
+@end lilypond
+
+Dieses Beispiel zeigt auch, dass die Ausgaberoutinen für die 
+Akkordsymbole nicht besonders klug sind. Der letzte Akkord 
+(@code{f bes d}) wird nicht als Umkehrung erkannt.
+
+Achtung: Die Dauer eines Akkordes muss außerhalb der 
+spitzen Klammern @code{<>} notiert werden.
+
+@example
+<c e g>2
+@end example
+
+
+@node Chords mode
+@unnumberedsubsubsec Chords mode
+@cindex Akkord-Modus
+
+Im Akkord-Modus wird eine Anzahl von Tonhöhen (ein Akkord) 
+durch eine normale Notenbezeichnung notiert. Ein Akkord wird 
+mit seinem Grundton notiert, der einfach wie eine normale
+Note geschrieben wird:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { es4. d8 c2 }
+@end lilypond
+
+@noindent
+Dieser Modus wird mit dem @code{\chordmode}-Befehl aktiviert.
+
+@cindex Akkord-Notation
+@cindex Eingabe von Akkorden
+
+Andere als die Grundakkorde können notiert werden, indem an 
+die Notenbezeichnung ein Doppelpunkt und eine Spezifizierung 
+(die auch aus einer Zahl bestehen kann) angefügt wird.
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { e1:m e1:7 e1:m7 }
+@end lilypond
+
+@noindent 
+Die erste Zahl, die auf den Grundton folgt, wird als @qq{Art} 
+des Akkordes interpretiert: Terzen werden auf dem Grundton 
+gestapelt, bis die angegebene Zahl (=Tonhöhe) erreicht ist.
+Eine Ausnahme ist @code{c:13}, weil hier die 11 ausgelassen wird.
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@end lilypond
+
+@cindex Grundton eines Akkordes
+@cindex Additionen in Akkorden
+@cindex Subtration in Akkorden
+@cindex Hinzufügen von Tönen in Akkorden
+@cindex Entfernen von Tönen aus Akkorden
+
+Kompliziertere Akkorde können auch konstruiert werden, indem
+einzelne Intervalle zu dem Grundton addiert werden. 
+Diese Additionen werden nach der ersten Zahl notiert und mit 
+Punkten voneinander getrennt.
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+@end lilypond
+
+@noindent
+Einzelne Intervalle können mit @code{-} oder @code{+} vergrößert 
+oder verkleinert werden.
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+@end lilypond
+
+@noindent
+Zu entfernende Töne werden mit der gleichen Methode notiert, 
+allerdings mit einem Dach (@code{^}) vor der Sequenz, die 
+nicht erscheinen soll. Sie müssen nach den zu addierenden 
+Tönen notiert werden.
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c^3 c:7^5 c:9^3.5 }
+@end lilypond
+
+Mit weiteren Endungen können Tonhöhen der Akkorde beeinflusst werden. 
+Folgende Endungen sind unterstützt:
+
+@table @code
+@item m
+Der Moll-Akkord. Diese Endung erniedrigt die Terz (3) und die Septime (7), 
+wenn vorhanden.
+
+@item dim
+Der verminderte Akkord. Diese Endung erniedrigt die Terz (3), Quinte (5)
+und Septime (7), wenn vorhanden.
+
+@item aug
+Der übermäßige Akkord. Diese Endung erhöht die Quinte (5).
+
+@item maj
+Der große Sept-Akkord. Diese Endung erhöht die Septime (7), 
+wenn vorhanden.
+
+@item sus
+Der Sekundakkord. Diese Endung entfernt die Terz (3) aus dem 
+Akkord. Schreiben Sie @code{2} oder @code{4} hinter die Endung, 
+um entweder die Sekunde (2) oder die Quarte (4) zum Akkord 
+hinzuzufügen.
+@end table
+
+Die Endungen können mit weiteren hinzugefügten Tönen kombiniert 
+werden.
+@lilypond[quote,verbatim,fragment]
+  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+@end lilypond
+
+@cindex Modi, in Akkorden
+@cindex Akkordmodi
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex sus
+@funindex m
+
+Da der unveränderte elfte Ton in Verbindung mit einem unveränderten 
+13. Ton nicht gut klingt, wird die 11 in diesem Fall automatisch 
+entfernt (es sei denn, sie wird explizit gefordert).
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c:13 c:13.11 c:m13 }
+@end lilypond
+
+@funindex /
+
+Eine Umkehrung (ein Ton des Akkordes wird unter den Grundton gesetzt) 
+sowie auch Bassnoten können mit dem Schrägstrich (@code{/}) markiert 
+werden:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/g c/f }
+@end lilypond
+@funindex /+
+
+Eine Bassnote kann hinzugefügt werden, anstatt dass sie aus dem Akkord 
+entnommen wird, indem noch ein Plus zwischen den Schrägstrich und 
+die Tonhöhe gesetzt wird:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/+g c/+f }
+@end lilypond
+
+Der Akkord-Modus funktioniert ähnlich wie der Liedtext-Modus 
+(@code{\lyricmode}) usw. Die meisten Befehle funktionieren weiter, 
+so können etwa @code{r} und @code{\skip} benutzt werden, 
+um Pausen und Zwischenräume einzufügen. Mit Eigenschaftsbefehlen 
+können verschiedene Einstellungen verändert werden.
+
+
+@refbugs
+
+Jedes Intervall kann nur einmal in einem Akkord vorkommen. 
+Im folgenden Beispiel wird nur der erweiterte Akkord erstellt, 
+weil @code{5+} als letztes kommt.
+
+@cindex Cluster
+@lilypond[quote,ragged-right,verbatim,fragment]
+\chordmode { c:5.5-.5+ }
+@end lilypond
+
+
+@node Printing chord names
+@unnumberedsubsubsec Printing chord names
+
+@cindex Akkordsymbole
+@cindex Ausgabe von Akkordbezeichnungen
+@cindex Akkorde
+@cindex Symbole, Akkord-
+
+Um Akkordsymbole anstelle der Noten zu setzen, muss der 
+@internalsref{ChordNames}-Kontext. Die Akkorde können entweder 
+mit der Notation aus dem vorigen Abschnitt oder direkt 
+mit der Akkordeingabe für Noten (@code{<} und @code{>}) 
+notiert werden.
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = {
+  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+}
+<<
+  \new ChordNames \harmonies
+  \new Staff \harmonies
+>>
+@end lilypond
+
+Sie können Akkordwiederholungen unterdrücken, so dass nur 
+bei einer Änderung des Akkordes ein Symbol ausgegeben wird. 
+Das aktuelle Symbol wird auch am Zeilenanfang wiederholt. 
+Das geschieht mit dem Befehl @code{\set chordChanges = ##t}.
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = \chordmode {
+  c1:m c:m \break c:m c:m d
+}
+<<
+  \new ChordNames {
+    \set chordChanges = ##t
+    \harmonies }
+  \new Staff \transpose c c' \harmonies
+>>
+@end lilypond
+
+In den vorangegangenen Beispielen wurden alle Akkorde über dem 
+Notensystem mit den entsprechenden Noten ausgegeben. Das ist aber 
+nicht erforderlich. Akkorde können auch alleine gedruckt werden. 
+Dabei kann es nötig sein, @internalsref{Volta_engraver} und 
+@internalsref{Bar_engraver} einzufügen, damit Wiederholungen 
+angezeigt werden.
+
+@lilypond[ragged-right,verbatim]
+\new ChordNames \with {
+  \override BarLine #'bar-size = #4
+  \consists Bar_engraver
+  \consists "Volta_engraver"
+}
+\chordmode { \repeat volta 2 {
+  f1:maj7 f:7 bes:7
+  c:maj7
+} \alternative {
+  es e
+}
+}
+@end lilypond
+
+Die Standardeinstellungen für die Symbole entsprechen den Konventionen 
+im Jazz, wie sie von Klaus Ignatzek (siehe @ref{Literature list}). 
+vorgeschlagen wurden. Mit den folgenden Befehlen könne aber 
+Anpssungen vorgenommen werden:
+
+@table @code
+@funindex chordNameExceptions
+@item chordNameExceptions
+Das ist eine Liste, die alle Akkorder aufführt, die angewöhnliche 
+Form haben.
+
+Die Liste muss nach dem Schema 
+@example
+@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
+@end example
+@noindent
+gesetzt werden.
+
+Diese Liste in die @code{chordNameExceptions}-Funktion einzulesen 
+ist allerdings etwas kompliziert. Mit dem folgenden Code-Abschnitt 
+wird @code{chExceptionMusic} (aufeinander folgende 
+Noten) in eine Ausnahmeliste umgewandelt:
+@example
+(sequential-music-to-chord-exceptions chExceptionMusic #t)
+@end example
+Dann werden mit dem Code
+@example
+(append
+ (sequential-music-to-chord-exceptions chExceptionMusic #t)
+ ignatzekExceptions)
+@end example
+die neuen Ausnahmen zu den schon vorhandenen hinzugefügt, die in 
+der Datei @file{ly/@/chord@/-modifier@/-init@/.ly} definiert sind.
+
+Ein Beispiel für die Benutzung dieser Eigenschaft findet sich 
+auch in der Datei @lsr{chords,chord@/-name@/-exceptions@/.ly}.
+@cindex Ausnahmen, Akkordsymbole
+
+
+@funindex majorSevenSymbol
+@item majorSevenSymbol
+Mit dieser Eigenschaft wird das Aussehen der Notation für die 
+große Septime (7) bestimmt. Vordefiniert sind die Optionen
+@code{whiteTriangleMarkup} und @code{blackTriangleMarkup}. 
+Siehe auch 
+@lsr{chords,chord@/-name@/-major7@/.ly} für ein Beispiel.
+
+@funindex chordNameSeparator
+@item chordNameSeparator
+Verschiedene Teile eines Akkordsymboles werden normalerweise 
+durch einen Schrägstrich markiert. Indem @code{chordNameSeparator} 
+ein anderer Wert zugewiesen wird, kann das Ausehen des Trenners 
+verändert werden, z. B.:
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new ChordNames \chordmode {
+  c:7sus4
+  \set chordNameSeparator
+    = \markup { \typewriter "|" }
+  c:7sus4
+}
+@end lilypond
+
+@funindex chordRootNamer
+@item chordRootNamer
+Der Grundton eines Akkordes wird normalerweise als Buchstabe mit 
+optionaler Erhöhung oder Erniedrigung dargestellt. Die Interpretation 
+einer Tonhöhe als Buchstabe wird von der @code{chordRootNamer}-Eigenschaft 
+übernommen. Besondere Bezeichnungen, wie etwa im Deutschen H für
+einen H-Dur-Akkord (und nicht @qq{B} wie im Englischen), können 
+durch Hinzufügen einer neuen Funktion zu dieser Eigenschaft 
+erstellt werden.
+
+@funindex chordNoteNamer
+@item chordNoteNamer
+In den Standardeinstellungen wird ein einziger Buchstabe für einen 
+Akkord ausgegeben, nämlich sein Grundton, der von der 
+@code{chordRootNamer}-Eigenschaft bestimmt wird. Die 
+@code{chordNoteNamer}-Eigenschaft hingegen kann das Aussehen dieses 
+Buchstaben ändern, ihn etwa als Klein- und nicht als Großbuchstabe 
+darstellen.
+
+@funindex chordPrefixSpacer
+@item chordPrefixSpacer
+Das @qq{m} für Moll-Akkorde wird normalerweise direkt hinter dem 
+Akkordbuchstaben gesetzt. Mit der Eigenschaft @code{chordPrefixSpacer} 
+kann ein Abstand(halter) zwischen den Buchstaben und das @qq{m} 
+gesetzt werden. Der Abstandhalter wird nicht verwendet, wenn der 
+Grundton erhöht oder erniedrigt ist.
+
+@end table
+
+Die vordefinierten Befehle @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} und @code{\frenchChords}
+benutzen diese Variablen. Die Auswirkungen werden im nächsten Beispiel 
+gezeigt.
+
+@lilypondfile[ragged-right]{chord-names-languages.ly}
+
+Zusätzlich sind zwei weitere Vorlagen: eine alternative Jazz-Notation 
+und eine systematische Notation, genannt Banter-Akkorde. Die 
+alternative Jazz-Notation findet sich auch in der Liste im 
+Abschnitt @ref{Chord name chart}. Wie diese Stile verwendet werden, 
+wird in der Datei 
+@lsr{chords,chord-names-jazz.ly} gezeigt.
+
+@cindex Banter
+@cindex Jazz-Akkorde
+@cindex Akkorde, Jazz
+
+
+@refcommands
+
+@funindex \germanChords
+@code{\germanChords},
+@funindex \semiGermanChords
+@code{\semiGermanChords}.
+@funindex \italianChords
+@code{\italianChords}.
+@funindex \frenchChords
+@code{\frenchChords}.
+
+@seealso
+
+Beispiele: @lsrdir{chords}.
+
+Init-Dateien: @file{scm/@/chords@/-ignatzek@/.scm} und
+@file{scm/@/chord@/-entry@/.scm}.
+
+
+@refbugs
+
+Akkordsymbole werden nur von den Tonhöhenbezeichnungen bestimmt. 
+Akkordumkehrungen sind nicht definiert, noch werden Bassnoten 
+hinzugefügt. Deshalb kann es zu seltsamen Akkord-Symbolen kommen, 
+wenn die Akkorde mit der @code{< ... >} Syntax notiert werden.
+
+
diff --git a/Documentation/de/user/converters.itely b/Documentation/de/user/converters.itely
index f676d7581a..c59f416e01 100644
--- a/Documentation/de/user/converters.itely
+++ b/Documentation/de/user/converters.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/educational.itely b/Documentation/de/user/educational.itely
new file mode 100644
index 0000000000..1891d03fd7
--- /dev/null
+++ b/Documentation/de/user/educational.itely
@@ -0,0 +1,217 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Educational use
+@section Educational use
+
+@menu
+* Note heads::                  
+* Inside the staff::            
+* Outside the staff::           
+@end menu
+
+
+@node Note heads
+@subsection Note heads
+
+@menu
+* Easy notation note heads::    
+* Shape note heads::            
+* Improvisation::               
+* Special noteheads::           
+@end menu
+
+@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
+
+
+@node Special noteheads
+@unnumberedsubsubsec Special noteheads
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Inside the staff
+@subsection Inside the staff
+
+
+@menu
+* Selecting notation font size::  
+* Fingering instructions::      
+* Hidden notes::                
+* Coloring objects::            
+* Parentheses::                 
+* Ambitus::                     
+* Stems::                       
+@end menu
+
+@node Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Fingering instructions
+@unnumberedsubsubsec Fingering instructions
+
+@cindex Fingersatz
+@cindex Fingerwechsel
+
+Fingersatzanweisungen können folgenderweise notiert werden:
+@example
+@var{Note}-@var{Zahl}
+@end example
+Für Fingerwechsel muss eine Textbeschriftung (markup) benutzt werden:
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+c4-1 c-2 c-3 c-4
+c^\markup { \finger "2 - 3" }
+@end lilypond
+
+Mit dem Daumen-Befehl (@code{\thumb}) können die Noten bezeichnet 
+werden, die mit dem 
+Daumen (etwa auf dem Cello) gespielt werden sollen.
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+<a_\thumb a'-3>8 <b_\thumb b'-3>
+@end lilypond
+
+Fingersätze für Akkorde können auch zu einzelnen Noten des 
+Akkordes hinzugefügt werden, indem sie innerhalb der Akkord-Klammer 
+direkt an die Noten angefügt werden.
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+< c-1 e-2 g-3 b-5 >4
+@end lilypond
+
+
+@commonprop
+
+Eine bessere Kontrolle über die Position der Fingersätze in Akkorden 
+lässt sich mit der Eigenschaft @code{fingeringOrientations} herstellen:
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+\set fingeringOrientations = #'(left down)
+<c-1 es-2 g-4 bes-5 > 4
+\set fingeringOrientations = #'(up right down)
+<c-1 es-2 g-4 bes-5 > 4
+@end lilypond
+
+Mit dieser Funktion können Fingersatzbezeichnungen auch bei einstimmiger 
+Musik sehr nah in die Notenköpfe gerückt werden.
+
+@lilypond[verbatim,ragged-right,quote,fragment]
+\set fingeringOrientations = #'(right)
+<es'-2>4
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{Fingering}.
+
+Beispiele: @lsr{expressive,fingering-chords.ly}
+
+
+@node Hidden notes
+@unnumberedsubsubsec Hidden notes
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Coloring objects
+@unnumberedsubsubsec Coloring objects
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Parentheses
+@unnumberedsubsubsec Parentheses
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Stems
+@unnumberedsubsubsec Stems
+
+Immer, wenn das Programm eine Note findet, wird automatisch 
+ein Notenhals (@internalsref{Stem}) -Objekt erzeugt. Auch 
+für ganze Noten und Pausen werden sie erzeugt, aber unsichtbar 
+gemacht.
+
+@refcommands
+
+@funindex \stemUp
+@code{\stemUp} (Hälse nach oben),
+@funindex \stemDown
+@code{\stemDown} (Hälse nach unten),
+@funindex \stemNeutral
+@code{\stemNeutral} (Hälse je nach Notenposition).
+
+
+@commonprop
+
+Um die Richtung der Hälse zu ändern, können die Befehle
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+a4 b c b
+\override Stem #'neutral-direction = #up
+a4 b c b
+\override Stem #'neutral-direction = #down
+a4 b c b
+@end lilypond
+
+@noindent benutzt werden.
+
+
+@node Outside the staff
+@subsection Outside the staff
+
+
+@menu
+* Balloon help::                
+* Grid lines::                  
+* Blank music sheet::           
+@end menu
+
+@node Balloon help
+@subsection Balloon help
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Grid lines
+@subsection Grid lines
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Blank music sheet
+@subsection Blank music sheet
+
+UNTRANSLATED NODE: IGNORE ME
+
+
diff --git a/Documentation/de/user/expressive.itely b/Documentation/de/user/expressive.itely
new file mode 100644
index 0000000000..d9b1d13a5e
--- /dev/null
+++ b/Documentation/de/user/expressive.itely
@@ -0,0 +1,797 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Expressive marks
+@section Expressive marks
+
+@menu
+* Attached to notes::           
+* Curves::                      
+* Lines::                       
+@end menu
+
+
+@node Attached to notes
+@subsection Attached to notes
+
+
+@menu
+* Articulations::               
+* Dynamics::                    
+@end menu
+
+@node Articulations
+@unnumberedsubsubsec Articulations
+
+@cindex Artikulationszeichen
+@cindex Beschriftung
+@cindex Zeichen
+
+Eine Vielfalt an Symbolen kann über und unter den Noten erscheinen, 
+um zu markieren, auf welche Art die Note ausgeführt werden soll. Sie 
+werden in LilyPond notiert, indem ein Minuszeichen an die Note gehängt 
+wird, gefolgt von dem jeweiligen Zeichen. Hier einige Beispiele:
+
+@c @l ilypondfile[quote,ragged-right]{script-abbreviations.ly}
+
+Die Bedeutung der Zeichen kann auch verändert werden. Siehe etwa 
+@file{ly/@/script@/-init@/.ly} für Beispiele.
+
+Das Artikulationszeichen wird automatisch gesetzt, aber die Richtung kann 
+auch erzwungen werden. Wie auch bei anderen LilyPond-Befehlen, erreicht 
+man mit @code{_} eine Ausrichtung unter der Note, mit @code{^} eine 
+Ausrichtung über der Note.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c''4^^ c''4_^
+@end lilypond
+
+Andere Symbole können mit der Syntax 
+@var{Note}@code{\}@var{Bezeichnung} hinzugefügt werden. 
+Auch sie können mit @code{^} und @code{_} nach oben 
+und unten gezwungen werden:
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\fermata c^\fermata c_\fermata
+@end lilypond
+
+@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
+
+Hier ist eine Liste, die alle möglichen Zeichen darstellt:
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+
+@commonprop
+
+Die vertikale Anordnung der Zeichen wird durch die 
+@code{script-priority}-Eigenschaft kontrolliert. Je kleiner die Zahl 
+ist, umso näher wird das Zeichen an die Note gesetzt. In dem 
+nächsten Beispiel hat das Textsymbol (@internalsref{TextScript}),
+ein Kreuz, die niedrigste Priorität und wird also als unterstes 
+gesetzt. Im zweiten Beispiel hat der Praller (das @internalsref{Script}) 
+die niedrigste Priorität und erscheint innen. Wenn zwei Objekte die 
+gleiche Priorität haben, entscheidet die Reihenfolge, in der sie notiert 
+sind, welches zuerst kommt.
+
+@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
+\once \override TextScript #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+
+\once \override Script #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{Script}.
+
+
+@refbugs
+
+Diese Zeichen erscheinen zwar im Druck, haben aber keine Auswirkung 
+auf die produzierte MIDI-Datei.
+
+@node Dynamics
+@unnumberedsubsubsec Dynamics
+
+@cindex Lautstärke
+@cindex Dynamik
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
+
+Absolute Dynamikbezeichnung wird mit Befehlen nach den Noten 
+angezeigt. Die vordefinierten Befehle lauten:
+@code{\ppppp},
+@code{\pppp}, @code{\ppp},
+@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
+@code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
+@code{\sp}, @code{\spp}, @code{\sfz}, and @code{\rfz}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
+c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
+@end lilypond
+
+@funindex \<
+@funindex \>
+@funindex \!
+
+Eine Crescendo-Klammer wird mit dem Befehl @code{\<} begonnen und 
+mit @code{\!} oder einem absoluten Dynamikbefehl beendet. Ein 
+Decrescendo beginnt mit @code{\>} und wird auf die gleiche Art 
+beendet. @code{\cr} und @code{\decr} können anstelle von @code{\<} und 
+@code{\>} benutzt werden. Weil diese Zeichen an Noten gekoppelt sind, 
+müssen unsichtbare Noten benutzt werden, wenn mehr als ein Zeichen pro 
+Note benötigt wird.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\< c\! d\> e\!
+<< f1 { s4 s4\< s4\! \> s4\! } >>
+@end lilypond
+
+@noindent
+Eine Crescendo-Klammer beginnt normalerweise am linken Rand der Anfangsnote 
+und endet am rechten Rand der Endnote. Wenn das Ende auf den Taktanfang 
+fällt, endet die Klammer an der direkt vorhergehenden Taktlinie. Diese 
+Einstellung lässt sich aber durch die Eigenschaft @code{hairpinToBarline} 
+verändern.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set hairpinToBarline = ##f
+c4\< c2. c4\!
+@end lilypond
+
+In manchen Situationen kann auch der @code{\espressivo}-Befehl 
+geeignet sein, ein An- und Abschwellen einer Note anzuzeigen.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c2 b4 a g1\espressivo
+@end lilypond
+
+Hier können allerdings sehr kurze Klammern auftreten. Der Wert von 
+@code{minimum-length} in @internalsref{Voice}.@internalsref{Hairpin} 
+kann angepasst werden, etwa:
+
+@example
+\override Voice.Hairpin #'minimum-length = #5
+@end example
+
+@cindex Al niente
+@cindex Niente, al
+
+Klammern können auch mit einem kleinen Kreis um die Spitze 
+(al niente-Notation) gedruckt werden, 
+wenn die @code{circled-tip}-Eigenschaft gesetzt wird.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
+@cindex Crescendo
+@cindex Decrescendo
+@cindex Diminuendo
+
+Anstelle der Klammern kann auch der Text @emph{cresc.} bzw. @emph{decr.}
+oder @emph{dim.} ausgegeben werden.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\setTextCresc
+c\< d e f\!
+\setHairpinCresc
+e\> d c b\!
+\setTextDecresc
+c\> d e f\!
+\setTextDim
+e\> d c b\!
+@end lilypond
+
+Dieser Text kann auch beliebig angepasst werden:
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\set crescendoText = \markup { \italic "cresc. poco" }
+\set crescendoSpanner = #'dashed-line
+a'2\< a a a\!\mf
+@end lilypond
+
+Um neue Dynamikzeichen oder Text, der mit diesen zusammen 
+gesetzt wird, zu erstellen, siehe den Abschnitt @ref{New dynamic marks}.
+
+Vertikale Position der Zeichen wird von der Funktion 
+@internalsref{DynamicLineSpanner} verwaltet.
+
+
+@commonprop
+
+Dynamikzeichen, die an der selben Note auftreten, werden vertikal 
+angeordnet. Wenn Sie sicher gehen wollen, dass die Zeichen angeordnet 
+werden, auch wenn sie nicht an der selben Note vorkommen, kann die 
+@code{staff-padding}-Eigenschaft vergrößert werden.
+
+@example
+\override DynamicLineSpanner #'staff-padding = #4
+@end example
+
+Diese Eigenschaft kann man auch benutzen, um Dynamikzeichen davor zu 
+hindern, mit anderen Noten zusammenzustoßen.
+
+Crescendi and Decrescendi, die an der ersten Note einer neuen Zeile 
+enden, werden nicht ausgegeben. Mit
+
+@example
+\override Score.Hairpin #'after-line-breaking = ##t
+@end example
+
+@noindent
+wird dieses Verhalten ausgeschaltet.
+
+Text für dynamische Änderungen (wie @emph{cresc.}) 
+wird mit einer gestrichelten Linie gesetzt. Um diese Linie 
+zu unterdrücken, kann der Befehl
+
+@example
+\override DynamicTextSpanner #'dash-period = #-1.0
+@end example
+
+@noindent
+eingesetzt werden.
+
+@refcommands
+
+@funindex \dynamicUp
+@code{\dynamicUp},
+@funindex \dynamicDown
+@code{\dynamicDown},
+@funindex \dynamicNeutral
+@code{\dynamicNeutral}.
+
+
+@seealso
+
+Programmreferenz: @internalsref{DynamicText}, @internalsref{Hairpin}.
+Vertikale Positionierung der Symbole wird von der Eigenschaft 
+@internalsref{DynamicLineSpanner} verwaltet.
+
+
+@node Curves
+@subsection Curves
+
+@menu
+* Ties::                        
+* Slurs::                       
+* Phrasing slurs::              
+* Laissez vibrer ties::         
+* Breath marks::                
+* Falls and doits::             
+@end menu
+
+@node Ties
+@unnumberedsubsubsec Ties
+
+@cindex Bindebogen
+@cindex Überbindung
+@funindex ~
+
+Ein Bindebogen verbindet zwei benachbarte Noten der selben 
+Tonhöhe. Als Resultat wird die Dauer der Notenlänge verlängert. 
+Bindebögen dürfen nicht mit Legatobögen verwechselt werden, durch 
+die die Vortragsart bezeichnet wird, noch mit Phrasierungsbögen, 
+die musikalische Phrasen anzeigen. Eine Bindebogen wird mit der 
+Tilde @code{~} (AltGr++) notiert.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+e' ~ e' <c' e' g'> ~ <c' e' g'>
+@end lilypond
+
+Wenn ein Bindebogen an einen Akkord gehängt wird, werden alle Noten 
+dieses Akkordes übergebunden. Wenn kein Notenkopf passt, wird auch 
+kein Bogen erzeugt. Noten in Akkorden können auch einzeln übergebunden 
+werden, indem sie innerhalb des Akkordes hinter die entsprechende Note 
+geschrieben werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+<c~ e g~ b> <c e g b>
+@end lilypond
+
+Ein Bindebogen ist nur eine andere Art, die Notendauer zu verlängern, 
+ähnlich wie die Punktierung. Im nächsten Beispiel sind zwei Arten gezeigt, 
+die gleiche Notenlänge zu notieren:
+
+@lilypond[quote,fragment,ragged-right]
+\time 3/4 c'2. c'2 ~ c'4
+@end lilypond
+
+@noindent
+Bindebögen werden verwendet, wenn die Note entweder über die Taktgrenze 
+hinausragt, oder wenn Punktierung nicht benutzt werden kann, um die 
+Verlängerung anzuzeigen. Wenn man Überbindungen verwendet, sollten 
+größere Notenwerte an die Unterteilungen des Taktes angepasst werden.
+
+@lilypond[fragment,quote,ragged-right]
+\relative {
+  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
+}
+@end lilypond
+
+Wenn sehr viele Noten über die Taktgrenzen hinüber angebunden 
+werden müssen, ist es oft einfacher, die automatische Aufteilung 
+von Noten einzusetzen (siehe @ref{Automatic note splitting}). Mit 
+dieser Funktion werden automatisch lange Noten aufgeteilt und über 
+die Taktgrenze übergebunden.
+
+@funindex \repeatTie
+
+Wenn die zweite Variante einer Wiederholung mit einer Überbindung 
+anfängt, muss der Bindebogen wiederholt werden. Dass geschieht durch 
+den Befehl @code{\repeatTie}.
+
+@lilypond[fragment,quote,ragged-right,relative=2]
+r <c e g>\repeatTie
+@end lilypond
+
+@cindex Volta und Überbindung
+@cindex Wiederholung und Überbindung
+
+@commonprop
+
+Bindebögen werden teilweise verwendet, um Arpeggien auszuschreiben. 
+In diesem Fall müssen mehrere übergebundene Noten nacheinander 
+erscheinen. Das ist möglich, indem die @code{tieWaitForNote}-Eigenschaft 
+auf wahr (##t) gesetzt wird. Diese Funktion ist auch nützlich, um 
+ein Tremolo an einen Akkord zu binden. Siehe das Beispiel:
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+\set tieWaitForNote = ##t
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat tremolo 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
+@end lilypond
+
+Bindebögen können manuell gesetzt werden, indem die 
+@code{tie-configuration}-Eigenschaft verändert wird. 
+Die erste Zahl zeigt den Abstand von der Mitte des 
+Notensystems in Notenlinienzwischenräumen, die zweite 
+die Richtung (1=nach oben, -1=nach unten).
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+<c e g>2~ <c e g> |
+\override TieColumn #'tie-configuration =
+  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
+<c e g>~ <c e g> |
+@end lilypond
+
+
+@refcommands
+
+
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
+
+
+@seealso
+
+Im Handbuch: @ref{Automatic note splitting}.
+
+Programmreferenz: @internalsref{Tie}.
+
+
+@refbugs
+
+Der Wechsel zwischen Systemen bei aktiver Überbindung produziert keinen 
+gekrümmten Bogen.
+
+Änderung von Schlüssel oder Oktavierung zwischen übergebundenen Noten 
+ist nicht richtig definiert. In diesen Fällen kann es besser sein, einen 
+Legatobogen zu verwenden.
+
+@node Slurs
+@unnumberedsubsubsec Slurs
+
+@cindex Legatobögen
+
+Ein Legatobogen (engl. slur) zeigt an, dass die Noten 
+@emph{legato} gespielt werden sollen. Er wird mit Klammern 
+hinter den Notenwerten notiert.
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+f( g a) a8 b( a4 g2 f4)
+<c e>2( <b d>2)
+@end lilypond
+
+Die Richtung eines Legatobogens kann mit den Befehlen 
+@code{\slur@emph{DIR}}, wobei @code{@emph{DIR}} entweder
+ @code{Up}, @code{Down}, oder @code{Neutral}, angezeigt
+werden.
+
+Es gibt aber auch eine Kurzform. Indem @code{_} oder @code{^} 
+for die öffnende Klammer gestellt wird, wird die Richtung 
+angegeben.
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_( c) c^( c)
+@end lilypond
+
+Nur ein Legatobogen kann gleichzeitig geschrieben werden. Wenn Sie einen 
+langen Bogen über mehreren kurzen notieren wollen, müssen Sie 
+ @ref{Phrasing slurs} benutzen.
+
+
+@commonprop
+
+Manche Komponisten schreiben zwei Legatobögen, um Legatoakkorde zu 
+markieren. Das kann in LilyPond erreicht werden, indem die Eigenschaft 
+@code{doubleSlurs} gesetzt wird.
+
+@lilypond[verbatim,ragged-right,relative,fragment,quote]
+\set doubleSlurs = ##t
+<c e>4 ( <d f> <c e> <d f> )
+@end lilypond
+
+
+@refcommands
+
+@funindex \slurUp
+@code{\slurUp},
+@funindex \slurDown
+@code{\slurDown},
+@funindex \slurNeutral
+@code{\slurNeutral},
+@funindex \slurDashed
+@code{\slurDashed},
+@funindex \slurDotted
+@code{\slurDotted},
+@funindex \slurSolid
+@code{\slurSolid}.
+
+@seealso
+
+Programmreferenz: @internalsref{Slur}.
+
+
+@node Phrasing slurs
+@unnumberedsubsubsec Phrasing slurs
+
+@cindex Phrasierungsbögen
+
+Ein Phrasierungsbogen verbindet Noten und wird verwendet, um einen 
+musikalischen Ausdruck anzuzeigen. Er wird mit den Befehlen 
+@code{\(} und @code{\)} eingegeben.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+\time 6/4 c'\( d( e) f( e) d\)
+@end lilypond
+
+Im typographischen Sinne verhalten sich Phrasierungsbögen genauso wie 
+Legatobögen. Sie werden aber als eigene Objekte behandelt. Ein 
+@code{\slurUp} hat also keine Auswirkung auf die Phrasierungsbögen, 
+anstelle dessen muss 
+@code{\phrasingSlurUp}, @code{\phrasingSlurDown} oder
+@code{\phrasingSlurNeutral} benutzt werden.
+
+Es können keine simultanen Phrasierungsbögen gesetzt werden.
+
+
+@refcommands
+
+@funindex \phrasingSlurUp
+@code{\phrasingSlurUp},
+@funindex \phrasingSlurDown
+@code{\phrasingSlurDown},
+@funindex \phrasingSlurNeutral
+@code{\phrasingSlurNeutral}.
+
+
+@seealso
+
+Programmreferenz: @internalsref{PhrasingSlur}.
+
+
+@node Laissez vibrer ties
+@unnumberedsubsubsec Laissez vibrer ties
+@cindex Laissez vibrer
+@cindex Bögen, laissez vibrer
+@cindex Ausklingen lassen
+
+So genannte @qq{laissez vibrer}-Bögen werden verwendet um anzuzeigen, dass 
+man die Musik ausklingen lassen soll. Sie werden in der Klavier-, Harfen-, 
+anderer Saiteninstrument- und Schlagzeugnotation verwendet. Sie können 
+mit dem Befehl @code{\laissezVibrer} eingegeben werden.
+
+@lilypond[fragment,ragged-right,verbatim,relative=1]
+<c f g>\laissezVibrer
+@end lilypond
+
+@seealso
+
+Programmreferenz:
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+Beispiele:
+@lsr{connecting,laissez-vibrer-ties.ly}
+
+
+@node Breath marks
+@unnumberedsubsubsec Breath marks
+
+Atemzeichen werden mit dem Befehl @code{\breathe} eingegeben.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c'4 \breathe d4
+@end lilypond
+
+
+@commonprop
+
+Das Symbol für das Atemzeichen kann verändert werden, indem die Eigenschaft 
+@code{text} des @code{BreathingSign}-Objektes mit beliebigem Text 
+überschrieben wird. Zum Beispiel ergibt
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+c'4
+\override BreathingSign #'text
+  = #(make-musicglyph-markup "scripts.rvarcomma")
+\breathe
+d4
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{BreathingSign}.
+
+Beispiele: @lsr{expressive,breathing-sign.ly}
+
+
+@node Falls and doits
+@unnumberedsubsubsec Falls and doits
+
+Gleiten nach oben und unten kann mit dem Befehl @code{\bendAfter} 
+notiert werden.
+
+@lilypond[fragment,ragged-right,relative=2]
+\override Score.SpacingSpanner #'shortest-duration-space = #3.0
+c4-\bendAfter #+5
+c4-\bendAfter #-3
+@end lilypond
+
+
+@node Lines
+@subsection Lines
+
+@menu
+* Glissando::                   
+* Arpeggio::                    
+* Trills::                      
+* Analysis brackets::           
+@end menu
+
+@node Glissando
+@unnumberedsubsubsec Glissando
+
+@cindex Glissando
+@funindex \glissando
+
+Ein Glissando ist ein Gleiten zwischen Tonhöhen. Es wird mit einer 
+geraden oder gezackten Linie zwischen zwei Noten notiert. Es wird 
+mit dem Befehl @code{\glissando} auf eine Note folgend notiert.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+c2\glissando c'
+\override Glissando #'style = #'zigzag
+c2\glissando c,
+@end lilypond
+ 
+@commonprop
+
+@lilypond[quote,ragged-right,verbatim]
+I = \once \override NoteColumn #'ignore-collision = ##t
+
+\relative <<
+  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
+  { \oneVoice \I c2 \glissando \I d, }
+>>
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{Glissando}.
+
+Beispiele:
+@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
+
+
+
+@refbugs
+
+Text über der Linie (wie etwa @emph{gliss.}) wird nicht unterstützt.
+
+
+@node Arpeggio
+@unnumberedsubsubsec Arpeggio
+
+@cindex Arpeggio
+@cindex Gebrochene Akkorde
+@funindex \arpeggio
+
+Ein Arpeggio als Zeichen, dass ein Akkord gebrochen gespielt werden soll, 
+kann mit dem Befehl @code{\arpeggio} hinter dem 
+Akkord erzeugt werden.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+<c e g c>\arpeggio
+@end lilypond
+
+Eine eckige Klammer zur Linken des Akkordes zeigt an, dass kein Arpeggio 
+gespielt werden soll.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\arpeggioBracket
+<c' e g c>\arpeggio
+@end lilypond
+
+Die Richtung des Arpeggios wird manchmal mit Pfeilen notiert und hat 
+eigene Befehle.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new Voice {
+  \arpeggioUp
+  <c e g c>\arpeggio
+  \arpeggioDown
+  <c e g c>\arpeggio
+}
+@end lilypond
+
+
+@commonprop
+
+Wenn ein Arpeggio sich über mehrere Systeme erstreckt, kann mit einem 
+Klaviersystem die Eigenschaft 
+@internalsref{PianoStaff}.@code{connectArpeggios} gesetzt werden.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \set PianoStaff.connectArpeggios = ##t
+  \new Staff { <c' e g c>\arpeggio }
+  \new Staff { \clef bass <c,, e g>\arpeggio }
+>>
+@end lilypond
+
+@c TODO: cross-voice arpeggio example?
+@c such an example is already in LSR -J.Mandereau
+
+@refcommands
+
+@code{\arpeggio},
+@funindex \arpeggioUp
+@code{\arpeggioUp},
+@funindex \arpeggioDown
+@code{\arpeggioDown},
+@funindex \arpeggioNeutral
+@code{\arpeggioNeutral},
+@funindex \arpeggioBracket
+@code{\arpeggioBracket}.
+
+
+@seealso
+
+Notationshandbuch: @ref{Ties}, um Arpeggios auszuschreiben.
+
+Programmreferenz: @internalsref{Arpeggio}.
+
+
+@refbugs
+
+Es ist nicht möglich, Arpeggios zwischen Systemen und solche, die sich 
+nur auf ein System erstrecken, zum gleichen Zeitpunkt in einem 
+Klaviersystem zu benutzen.
+
+
+@node Trills
+@unnumberedsubsubsec Trills
+@cindex Triller
+
+Kurze Triller können wie ein normales Artikulationszeichen eingegeben 
+werden, siehe @ref{Articulations}.
+
+Längere Triller werden mit den Befehlen @code{\startTrillSpan} zu 
+Beginn und @code{\stopTrillSpan} am Ende erstellt.
+
+@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
+\new Voice {
+  << { c1 \startTrillSpan }
+     { s2. \grace { d16[\stopTrillSpan e] } } >>
+  c4 }
+@end lilypond
+
+@cindex Triller mit Tonhöhe
+
+Triller, die auf einer bestimmten Note ausgeführt werden sollen, können 
+mit dem Befehl @code{pitchedTrill} notiert werden.
+
+@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
+\pitchedTrill c4\startTrillSpan fis
+f\stopTrillSpan
+@end lilypond
+
+@noindent
+Dabei ist das erste Argument die Hauptnote. Die zweite Note wird 
+ohne Hals in Klammern gesetzt.
+
+
+@refcommands
+
+@code{\startTrillSpan},
+@funindex \startTrillSpan
+@code{\stopTrillSpan}.
+@funindex \stopTrillSpan
+
+
+@seealso
+
+Programmreferenz: @internalsref{TrillSpanner}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+
+UNTRANSLATED NODE: IGNORE ME
+
+
diff --git a/Documentation/de/user/fundamental.itely b/Documentation/de/user/fundamental.itely
new file mode 100644
index 0000000000..6901ac7805
--- /dev/null
+++ b/Documentation/de/user/fundamental.itely
@@ -0,0 +1,40 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond-learning.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Fundamental concepts
+@chapter Fundamental concepts
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* File structure (introduction)::
+* How LilyPond files work::
+* Score is a single musical expression::
+@end menu 
+@node File structure (introduction)
+@section File structure (introduction)
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node How LilyPond files work
+@section How LilyPond files work
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Score is a single musical expression
+@section Score is a single musical expression
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+-- SKELETON FILE --
+When you actually translate this file, please remove these lines as
+well as all `UNTRANSLATED NODE: IGNORE ME' lines.
diff --git a/Documentation/de/user/guitar.itely b/Documentation/de/user/guitar.itely
new file mode 100644
index 0000000000..550570883c
--- /dev/null
+++ b/Documentation/de/user/guitar.itely
@@ -0,0 +1,373 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Guitar
+@section Guitar
+
+@cindex tablature
+@cindex guitar tablature
+
+@menu 
+* Guitar TODO::
+@end menu 
+
+@node Guitar TODO
+@subsection Guitar TODO
+
+@menu
+* String number indications::   
+* Tablatures basic::            
+* Non-guitar tablatures::       
+* Banjo tablatures::            
+* Fret diagrams::               
+* Right hand fingerings::       
+* Other guitar issues::         
+@end menu
+
+@node String number indications
+@unnumberedsubsubsec String number indications
+
+@cindex String numbers
+
+Saitennummerierung kann zu den Akkorden hinzugefügt werden, 
+indem die Saitennummer nach einem Backslash als Zahl angegeben 
+wird:
+
+@lilypond[relative,relative=1,ragged-right,fragment]
+<c\1 e\2 g\3>
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.
+
+
+@node Tablatures basic
+@unnumberedsubsubsec Tablatures basic
+@cindex Tablatures basic
+
+Tabulatur-Notation wird für die Notation von Zupfinstrumenten benutzt. 
+Tonhöhen werden hier nicht durch Notenköpfe, sondern durch Zahlen 
+notiert. Diese Zahlen zeigen an, auf welcher Saite und welchem Bund 
+der Ton gespielt werden soll. LilyPond bringt beschränkte Unterstützung 
+für Tabulaturen mit.
+
+Die Saitennummer, die mit einer Note assoziiert ist, wird durch einen 
+Backslash, gefolgt von einer Zahl, notiert, etwa @code{c4\3} für eine 
+Viertelnote C auf der dritten Saite. In der Standardeinstellung ist 
+die erste Saite die höchste Saite und als Stimmung wird die übliche 
+Gitarrenstimmung auf sechs Saiten angenommen. Die Noten werden in 
+einer Tabulatur gesetzt, indem @internalsref{TabStaff} und
+@internalsref{TabVoice}-Kontexte verwendet werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff {
+  a,4\5 c'\2 a\3 e'\1
+  e\4 c'\2 a\3 e'\1
+}
+@end lilypond
+
+@funindex minimumFret
+@cindex Bund
+
+Wenn keine Saite angegeben wird, wird die Saite, deren Bund-Zahl 
+weniger als der Betrag in @code{minimumFret} beträgt, ausgewählt. 
+Der Standardwert für @code{minimumFret} beträgt 0.
+
+
+@example
+e16 fis gis a b4
+\set TabStaff.minimumFret = #8
+e16 fis gis a b4
+@end example
+@lilypond[quote,ragged-right]
+frag = {
+  \key e \major
+  e16 fis gis a b4
+  \set TabStaff.minimumFret = #8
+  e16 fis gis a b4
+}
+  \new StaffGroup <<
+    \new Staff { \clef "G_8" \frag }
+    \new TabStaff { \frag }
+  >>
+@end lilypond
+
+
+@commonprop
+
+Um Tabulaturen mit Hälsen nach unten und horizontalen Balken 
+zu erstellen, muss der @code{TabStaff} mit folgenden Parametern 
+initialisiert werden:
+
+@example
+\stemDown
+\override Beam #'damping = #100000
+@end example
+
+@seealso
+
+Programmreferenz: @internalsref{TabStaff}, @internalsref{TabVoice}.
+
+@refbugs
+
+Akkorde werden nicht gesondert behandelt, sodass die Saitenauswahlfunktion 
+eventuell die selbe Saite für zwei Töne eines Akkordes auswählen kann.
+
+Damit die Kombination von Stimmen (@code{\partcombine}) richtig funktioniert, 
+müssen spziell erstellte Stimmen innerhalb des Tabulatursystems 
+(@code{TabStaff}) benutzt werden:
+
+@lilypond[quote,ragged-right,verbatim]
+melodia = \partcombine { e4 g g g }{ e4 e e e }
+<<
+  \new TabStaff <<
+    \new TabVoice = "one" s1
+    \new TabVoice = "two" s1
+    \new TabVoice = "shared" s1
+    \new TabVoice = "solo" s1
+    { \melodia }
+  >>
+>>
+@end lilypond
+
+
+
+@node Non-guitar tablatures
+@unnumberedsubsubsec Non-guitar tablatures
+@cindex Non-guitar tablatures
+
+Die Stimmung der Saiten kann verändert werden. Die Stimmung muss als 
+eine Scheme-Liste dargestellt werden, in der jeder Saite eine Zahl
+zugewiesen ist, die die Tonhöhe der offenen Saite in Halbtönen 
+(gemessen von c') darstellt. Die Liste wird als Definition von 
+@code{stringTunings} dargestellt. Die Halbtöne können vom c' aus addiert 
+oder subtrahiert werden. Die Reihenfolge der Zahlen bestimmt auch 
+die Reihenfolge der Saiten. LilyPond entnimmt aus dieser Liste 
+auch die Anzahl der Saiten.
+
+Im nächsten Beispiel wird 
+@code{stringTunings} für die Tonhöhen @code{e, a, d,} und @code{g} gesetzt.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
+  {
+    a,4 c' a e' e c' a e'
+  }
+>>
+@end lilypond
+
+LilyPond bringt schon vordefinierte Stimmungen für Banjo, Mandoline, 
+Gitarre und Bassgitarre mit.
+
+@example
+\set TabStaff.stringTunings = #bass-tuning
+@end example
+
+Der Standard ist die Gitarrenstimmung (@code{guitar-tuning}) mit den 
+Saiten EADGBE. Andere vordefinierte Stimmungen sind 
+@code{guitar-open-g-tuning},
+@code{mandolin-tuning} und @code{banjo-open-g-tuning}.
+
+@seealso
+
+In der Datei @file{scm/@/output@/-lib@/.scm} sind die Stimmungen 
+definiert.
+Programmreferenz: @internalsref{Tab_note_heads_engraver}.
+
+@refbugs
+
+Spezialeffekte für Gitarren sind noch nicht implementiert.
+
+
+
+@node Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
+@cindex Banjo tablatures
+
+LilyPond unterstützt die Basisnotation für das fünfsaitige Banjo. Die 
+Banjo-Tabulatur-Funktion sollte zum Notieren von Banjo-Tabulaturen 
+verwendet werden, damit die richtigen Bund-Nummern für die fünfte 
+Saite gesetzt werden:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
+  \set TabStaff.stringTunings = #banjo-open-g-tuning
+  {
+    \stemDown
+    g8 d' g'\5 a b g e d' |
+    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
+    g4
+  }
+>>
+@end lilypond
+
+Eine Anzahl von üblichen Stimmungen für das Banjo sind in LilyPond 
+schon vordefiniert: 
+@code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
+@code{banjo-open-d-tuning} (aDF#AD) und @code{banjo-open-dm-tuning}
+(aDFAD).
+
+Diese Stimmungen können für das viersaitige Banjo angepasst werden, 
+indem die @code{four-string-banjo}-Funktion eingesetzt wird:
+
+@example
+\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
+@end example
+
+@seealso
+
+Die Datei @file{scm/@/output@/-lib@/.scm} enthält vordefinierte 
+Banjo-Stimmungen.
+
+
+@node Fret diagrams
+@unnumberedsubsubsec Fret diagrams
+@cindex Fret-Diagramme
+@cindex Griffsymbole
+@cindex Gitarrengriffsymbole
+@cindex Akkordtabulartur
+@cindex Akkorddiagramm
+
+Akkordtabulaturen (Fret-Diagramme) können zu Noten als eine Beschriftung 
+hinzugefügt werden. Die Beschriftung enthält Information über die 
+erwünschte Akkordtabulatur, wie das folgende Beispiel zeigt:
+
+@lilypond[verbatim, ragged-right, quote]
+\new Voice {
+  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d' d' d'
+  fis'^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  fis' fis' fis'
+  c'^\markup \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+  c' c' c'
+}
+@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 in dem Beschriftungs-Befehl. Details über die 
+Beschriftungsbefehle finden sich im Abschnitt 
+ @ref{Overview of 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 
+@internalsref{fret-diagram-interface}.
+
+
+@seealso
+
+Examples: @lsrdir{guitar}.
+
+
+@node Right hand fingerings
+@unnumberedsubsubsec Right hand fingerings
+
+Fingersatz für die rechte Hand in Akkorden kann notiert werden, indem 
+der Befehl @code{@var{note}-\rightHandFinger @var{finger}} 
+benutzt wird.
+
+@lilypond[verbatim,fragment,relative=2]
+  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+@end lilypond
+
+Zur Erleichterung kann der Befehl @code{\rightHandFinger} zu ein paar
+Buchstaben abgekürzt werden, etwa @code{RH}.
+
+@example
+#(define RH rightHandFinger)
+@end example
+
+@cindex Fingersatz, rechte Hand, Gitarre
+@cindex Rechte Hand-Fingersatz für Gitarre
+ 
+@commonprop
+
+Größere Kontrolle über den Fingersatz der rechten Hand kann 
+mit einer Definition des Befehls @code{strokeFingerOrientations}
+erreicht werden:
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(up down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+  \set strokeFingerOrientations = #'(up right down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+}
+@end lilypond
+
+Die Buchstaben, die für den Fingersatz verwendet werden, sind in der 
+Eigenschaft @code{digit-names} enthalten, aber sie können auch individuell 
+verändert werden, indem @code{\rightHandFinger} mit einer Zeichenfolge als 
+Argument eingesetzt wird, wie im nächsten Beispiel:
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(right)
+  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
+  <c-\RH #5 >4
+  <c-\RH "@">4  
+}
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{StrokeFinger}
+
+
+
+@node Other guitar issues
+@unnumberedsubsubsec Other guitar issues
+
+Dieses Beispiel zeigt, wie Griff - und Barre-Angaben 
+eingefügt werden können.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
+\clef "G_8"
+b16 d16 g16 b16 e16
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text = #"XII "
+  g16\startTextSpan
+  b16 e16 g16 e16 b16 g16\stopTextSpan
+e16 b16 g16 d16
+@end lilypond
+
+Gedämpfte (X) Notenköpfe werden in der Gitarrenmusik benutzt, um 
+zu signalisieren, dass der Gitarist 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}
+gezeigt.
+
+
diff --git a/Documentation/de/user/install.itely b/Documentation/de/user/install.itely
index 2a16f7511a..f5c6479eda 100644
--- a/Documentation/de/user/install.itely
+++ b/Documentation/de/user/install.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
@@ -9,70 +9,21 @@
 @end ignore
 
 
-@ifclear INSTALL
 @node Install
 @chapter Install
-@end ifclear
-
-@c  I don't know what this comment does.  Remove?  -gp
-@ignore
-@h tml
-<a name="download-source">
-@e nd html
-@end ignore
-
-Es gibt zwei Versionen von LilyPond: stabile Versionen und nicht stabile
-Entwicklerversionen. Stabile Versionen haben gerade Versionsnummern an
- zweiter Stelle (z. B. 2.8, 2.10, 2.12 usw.). Entwicklerversionen 
-haben ungerade Versionsnummern an zweiter Stelle (etwa 2.7, 2.9,
-2.11 usw.).
-
-Den Quellcode von LilyPond zu übersetzen, ist ein ziemlich komplizierter
-Prozess, so dass davon @strong{sehr} abgeraten wird und die Benutzung der 
-vorkompilierten Binärpakete empfohlen wird.
-
-@menu
-* Precompiled binaries::        
-* Compiling from source::       
-@end menu
 
+UNTRANSLATED NODE: IGNORE ME
 
+@menu 
+* Precompiled binaries::
+* Compiling from source::
+@end menu 
 @node Precompiled binaries
 @section Precompiled binaries
 
-@subsection Downloading
-
-Auf der Internetseite @uref{http://lilypond.org/web/install/} findet sich 
-immer aktuelle Information zu Binärpaketen für Ihre Plattform. Wenn Ihr 
-Betriebssystem auf dieser Seite nicht abgedeckt ist, schauen Sie sich die 
-vollständige Liste auf @uref{http://download.linuxaudio.org/lilypond/binaries/}
-an.
-
-Zur Zeit werden Benärpakete für 
-
-@example
-darwin-ppc  - MacOS X powerpc
-darwin-x86  - MacOS X intel
-freebsd-64  - FreeBSD 6.x, x86_64
-freebsd-x86 - FreeBSD 4.x, x86
-linux-64    - Any GNU/Linux distribution, x86_64
-linux-arm   - Any GNU/Linux distribution, arm
-linux-ppc   - Any GNU/Linux distribution, powerpc
-linux-x86   - Any GNU/Linux distribution, x86
-mingw       - Windows x86
-@end example
-
-@noindent
-erstellt.
-
-@c TRANSLATORS:
-@c   Please **do not** translate anything below this line.  Users
-@c   should not be compiling LilyPond themselves; if they really 
-@c   want to do so, they should be able to read the English docs,
-@c   because they'll probably need to ask questions in English
-@c   on the -devel list.   -gp
-
+UNTRANSLATED NODE: IGNORE ME
 
+@subsection Downloading
 @node Compiling from source
 @section Compiling from source
 
diff --git a/Documentation/de/user/instrument-notation.itely b/Documentation/de/user/instrument-notation.itely
deleted file mode 100644
index 471aabc6bf..0000000000
--- a/Documentation/de/user/instrument-notation.itely
+++ /dev/null
@@ -1,3852 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: 1e31973e26eedc61b771826dbe2186f79bbe89ac
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Instrument-specific notation
-@chapter Instrument-specific notation
-
-Dieses Kapitel zeigt Eigenheiten der Notation von spezifischen Instrumenten.
-
-@menu
-* Piano music::                 
-* Chord names::                 
-* Vocal music::                 
-* Rhythmic music::              
-* Guitar::                      
-* Bagpipe::                     
-* Ancient notation::            
-* Other instrument specific notation::  
-@end menu
-
-
-
-@node Piano music
-@section Piano music
-
-Ein Pianosystem besteht aus zwei normalen Notensystemen, die durch 
-eine Klammer verbunden sind. Die Systeme sind verhältnismäßig 
-unabhängig, aber zeitweise können Stimmen zwischen den Systemen 
-wechseln. Die gleiche Notation wird auch für andere Tasteninstrumente 
-sowie Harfen verwendet. Das Klaviersystem (mit dem Befehl 
-@internalsref{PianoStaff} erstellt) ist speziell dazu geschaffen, Stimmen 
-zwischen den Systemen wechseln zu lassen. In diesem Abschnitt werden 
-das Klaviersystem und andere Eigenheiten der Pianonotation besprochen.
-
-@menu
-* Automatic staff changes::     
-* Manual staff switches::       
-* Pedals::                      
-* Staff switch lines::          
-* Cross staff stems::           
-@end menu
-
-@refbugs
-
-Dynamische Zeichen werden nicht automatisch mittig notiert, aber 
-dafür gibt es Lösungen, vgl. die 
-@q{piano centered dynamics}-Vorlage in @ref{Piano templates}.
-
-@cindex Hälse über zwei Systeme
-@cindex System querende Hälse
-@cindex Abstand zwischen Systemen in Klaviernoten
-
-
-@node Automatic staff changes
-@subsection Automatic staff changes
-@cindex Automatischer Systemwechsel
-
-Stimmen können angewiesen werden, automatisch zwischen dem 
-oberen und unteren System zu wechseln. Die Syntax hierfür lautet:
-
-@quotation
-@example
-\autochange @dots{}@var{Noten}@dots{}
-@end example
-@end quotation
-
-@noindent
-Damit werden zwei Notensysteme innerhalb des aktiven Klaviersystems 
-erstellt, die @qq{oben} (@code{up}) und @qq{unten} (@code{down}) genannt 
-werden. Auf dem unteren System wird als Standard der Bassschlüssel 
-gesetzt.
-
-Ein @code{\relative}-Abschnitt, der sich außerhalb des 
-@code{\autochange}-Abschnittes befindet, hat keinen Einfluss auf die 
-Notenhöhen der @var{Noten}. Es muss also bei Bedarf ein 
-weiterer @code{\relative}-Befehl innerhalb des Abschnittes 
-benutzt werden.
-
-@quotation
-@example
-\autochange \relative @dots{} @dots{}
-@end example
-@end quotation
-
-Der Wechsel wird automatisch besierend auf der Tonhöhe der Note 
-vorgenommen (als Wechselpunkt gilt das eingestrichene C). Dabei 
-wird die Richtung auch über Pausen hinweg im Voraus bestimmt.
-
-@lilypond[quote,verbatim,ragged-right]
-\new PianoStaff
-  \autochange \relative c'
-  {
-    g4 a b c d r4 a g
-  }
-@end lilypond
-
-
-@seealso
-
-Im Handbuch: @ref{Manual staff switches}.
-
-Programmreferenz: @internalsref{AutoChangeMusic}.
- 
-@refbugs
-
-Der Systemwechsel wird nicht immer an der optimalen Stelle vorgenommen. 
-Für hohe Qualität muss der Wechsel mit der Hand eingegeben werden.
-
-@code{\autochange} kann sich nicht innerhalb einer @code{\times}-Umbegung 
-befinden.
-
-@node Manual staff switches
-@subsection Manual staff switches
-
-@cindex manuelle Systemwechsel
-@cindex Systemwechsel, manuell
-@cindex Wechsel des Systems, manuell
-
-Stimmen können mit dem Befehl
-@example
-\change Staff = @var{Systembezeichnung} @var{Noten}
-@end example
-
-@noindent
-manuell erzielt werden. Die Zeichenkette @var{Systembezeichnung} ist die 
-Bezeichnung des Systems. Damit wird die aktuelle Stimme vom aktuellen 
-System zu dem System mit der @var{Systembezeichnung} gewechselt. 
-Üblicherweise ist die Systembezeichnung @code{"up"} oder
-@code{"down"}.  Dieses System (@context{Staff}), auf das verweisen wird, 
-muss auch wirklich existieren, weshalb die Aufstellung eines Klaviersystems 
-dann überlicherweise damit beginnt, die Systeme zu benennen. Hierbei können 
-natürlich beliebige Namen vergeben werden.
-
-@example
-<<
-  \new Staff = "up" @{
-    \skip 1 * 10  % @emph{keep staff alive}
-    @}
-  \new Staff = "down" @{
-    \skip 1 * 10  % @emph{idem}
-    @}
->>
-@end example
-
-@noindent
-Die einzelnen Stimmen werden mit dem @code{Voice}-Befehl 
-daraufhin eingefügt.
-
-@example
-\context Staff = down
-  \new Voice @{ @dots{} \change Staff = up @dots{} @}
-@end example
-
-
-@node Pedals
-@subsection Pedals
-@cindex Pedalbezeichnung
-
-Klaviere haben Pedale, mit denen die Klangeigenschaften beeinflusst werden 
-können. Normalerweise besitzt ein Klavier drei Pedale, das linke oder 
-Haltepedal, das rechte oder Una-corda-Pedal und das Sostenuto-Pedal.
-
-Spielanweisungen für das Pedal können durch die Befehle 
-@code{\sustainDown} (linkes Pedal), @code{\sustainUp} (linkes Pedal 
-hoch), @code{\unaCorda} (rechtes Pedal), @code{\treCorde} (rechtes 
-Pedal hoch), @code{\sostenutoDown} (mittleres Pedal) und 
-@code{\sostenutoUp} (mittleres Pedal hoch) anschließend an eine 
-Note oder einen Akkord notiert werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c'4\sustainDown c'4\sustainUp
-@end lilypond
-
-Die Ausgabe kann verändert werden, indem der Wert 
-What is printed can be modified by setting @code{pedal@var{X}Strings},
-where @var{X} is one of the pedal types: @code{Sustain},
-@code{Sostenuto} or @code{UnaCorda}.  Refer to
-@internalsref{SustainPedal} in the program reference for more
-information.
-
-Pedalbenutzung kann auch durch eine Anzahl von Klammern angezeigt 
-werden, wenn die @code{pedalSustainStyle}-Eigenschaft 
-auf Klammern (eng. bracket) gesetzt wird.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'bracket
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-Eine dritte Art der Pedalnotation besteht aus einer Mischung von Text 
-und den Pedalklammern. Sie wird durch setzen von 
-@code{pedalSustainStyle} auf @code{mixed} erreicht. 
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'mixed
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-Die Einstellungen für linkes @c ?
-und mittleres Pedal ist überlicherweise ein @code{#'text}-Stil. Für das 
-mittlere Pedal ist der gemischte Stil voreingestellt.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-Die Erscheinung der Pedal-Klammer kann mit den Eigenschaften 
-@code{edge-width}, @code{edge-height} und @code{shorten-pair} des
-@code{PianoPedalBracket}-Objekts verändert werden (siehe 
-@internalsref{PianoPedalBracket} in der Programmreferenz). Zum 
-Beispiel kann die Klammer bis zum rechten Einde eines Notenkopfes 
-verlängert werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-@seealso
-
-Im Handbuch: @ref{Laissez vibrer ties}
-
-@node Staff switch lines
-@subsection Staff switch lines
-
-
-@cindex Stimmkreuzung
-@cindex Systemwechsel von Stimmen
-@cindex Wechsel zwischen Systemen
-
-@funindex followVoice
-
-Immer, wenn eine Stimme von einem Klaviersystem zu dem anderen 
-wechselt, kann automatisch eine Linie zur Verdeutlichung des 
-Stimmenverlaufs ausgegeben werden. Das wird erreicht, indem 
-@code{followVoice} aktiviert wird:
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \new Staff="one" {
-    \set followVoice = ##t
-    c1
-    \change Staff=two
-    b2 a
-  }
-  \new Staff="two" { \clef bass \skip 1*2 }
->>
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{VoiceFollower}.
-
-@refcommands
-
-@funindex \showStaffSwitch
-@code{\showStaffSwitch},
-@funindex \hideStaffSwitch
-@code{\hideStaffSwitch}.
-
-
-@node Cross staff stems
-@subsection Cross staff stems
-
-Akkorde, die über zwei Systeme reichen, können erstellt werden,
-indem die Länge der Hälse im unteren System vergrößert wird, 
-bis sie zum oberen System hinauf reichen bzw. umgekehrt bei 
-Hälsen, die nach unten zeigen.
-
-@lilypond[ragged-right,verbatim,quote]
-stemExtend = {
-  \once \override Stem #'length = #10
-  \once \override Stem #'cross-staff = ##t
-}
-noFlag = \once \override Stem #'flag-style = #'no-flag
-\new PianoStaff <<
-  \new Staff {
-    \stemDown \stemExtend
-    f'4
-    \stemExtend \noFlag
-    f'8
-  }
-  \new Staff {
-    \clef bass
-    a4 a8
-  }
->>
-@end lilypond
-
-
-
-@node Chord names
-@section Chord names
-
-@menu
-* Introducing chord names::     
-* Chords mode::                 
-* Printing chord names::        
-@end menu
-
-
-@node Introducing chord names
-@subsection Introducing chord names
-@cindex Akkordbezeichnungen
-
-LilyPond bringt Unterstützung zur Ausgabe von Akkordsymbolen 
-mit. Akkorde können entweder mithilfe der musikalischen 
-Akkordeingabe (also @code{< ... >}) notiert werden, aber sie 
-können auch mit ihren Bezeichnungen direkt eingegeben werden. 
-Programmintern werden die Akkorde als eine Gruppe von Tonhöhen
-dargestellt und können somit transponiert werden.
-
-@lilypond[quote,ragged-right,verbatim,ragged-right]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
-
-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
-@end lilypond
-
-Dieses Beispiel zeigt auch, dass die Ausgaberoutinen für die 
-Akkordsymbole nicht besonders klug sind. Der letzte Akkord 
-(@code{f bes d}) wird nicht als Umkehrung erkannt.
-
-Achtung: Die Dauer eines Akkordes muss außerhalb der 
-spitzen Klammern @code{<>} notiert werden.
-
-@example
-<c e g>2
-@end example
-
-
-@node Chords mode
-@subsection Chords mode
-@cindex Akkord-Modus
-
-Im Akkord-Modus wird eine Anzahl von Tonhöhen (ein Akkord) 
-durch eine normale Notenbezeichnung notiert. Ein Akkord wird 
-mit seinem Grundton notiert, der einfach wie eine normale
-Note geschrieben wird:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { es4. d8 c2 }
-@end lilypond
-
-@noindent
-Dieser Modus wird mit dem @code{\chordmode}-Befehl aktiviert.
-
-@cindex Akkord-Notation
-@cindex Eingabe von Akkorden
-
-Andere als die Grundakkorde können notiert werden, indem an 
-die Notenbezeichnung ein Doppelpunkt und eine Spezifizierung 
-(die auch aus einer Zahl bestehen kann) angefügt wird.
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
-@end lilypond
-
-@noindent 
-Die erste Zahl, die auf den Grundton folgt, wird als @qq{Art} 
-des Akkordes interpretiert: Terzen werden auf dem Grundton 
-gestapelt, bis die angegebene Zahl (=Tonhöhe) erreicht ist.
-Eine Ausnahme ist @code{c:13}, weil hier die 11 ausgelassen wird.
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
-@end lilypond
-
-@cindex Grundton eines Akkordes
-@cindex Additionen in Akkorden
-@cindex Subtration in Akkorden
-@cindex Hinzufügen von Tönen in Akkorden
-@cindex Entfernen von Tönen aus Akkorden
-
-Kompliziertere Akkorde können auch konstruiert werden, indem
-einzelne Intervalle zu dem Grundton addiert werden. 
-Diese Additionen werden nach der ersten Zahl notiert und mit 
-Punkten voneinander getrennt.
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
-@end lilypond
-
-@noindent
-Einzelne Intervalle können mit @code{-} oder @code{+} vergrößert 
-oder verkleinert werden.
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
-@end lilypond
-
-@noindent
-Zu entfernende Töne werden mit der gleichen Methode notiert, 
-allerdings mit einem Dach (@code{^}) vor der Sequenz, die 
-nicht erscheinen soll. Sie müssen nach den zu addierenden 
-Tönen notiert werden.
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c^3 c:7^5 c:9^3.5 }
-@end lilypond
-
-Mit weiteren Endungen können Tonhöhen der Akkorde beeinflusst werden. 
-Folgende Endungen sind unterstützt:
-
-@table @code
-@item m
-Der Moll-Akkord. Diese Endung erniedrigt die Terz (3) und die Septime (7), 
-wenn vorhanden.
-
-@item dim
-Der verminderte Akkord. Diese Endung erniedrigt die Terz (3), Quinte (5)
-und Septime (7), wenn vorhanden.
-
-@item aug
-Der übermäßige Akkord. Diese Endung erhöht die Quinte (5).
-
-@item maj
-Der große Sept-Akkord. Diese Endung erhöht die Septime (7), 
-wenn vorhanden.
-
-@item sus
-Der Sekundakkord. Diese Endung entfernt die Terz (3) aus dem 
-Akkord. Schreiben Sie @code{2} oder @code{4} hinter die Endung, 
-um entweder die Sekunde (2) oder die Quarte (4) zum Akkord 
-hinzuzufügen.
-@end table
-
-Die Endungen können mit weiteren hinzugefügten Tönen kombiniert 
-werden.
-@lilypond[quote,verbatim,fragment]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
-@end lilypond
-
-@cindex Modi, in Akkorden
-@cindex Akkordmodi
-@funindex aug
-@funindex dim
-@funindex maj
-@funindex sus
-@funindex m
-
-Da der unveränderte elfte Ton in Verbindung mit einem unveränderten 
-13. Ton nicht gut klingt, wird die 11 in diesem Fall automatisch 
-entfernt (es sei denn, sie wird explizit gefordert).
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
-@end lilypond
-
-@funindex /
-
-Eine Umkehrung (ein Ton des Akkordes wird unter den Grundton gesetzt) 
-sowie auch Bassnoten können mit dem Schrägstrich (@code{/}) markiert 
-werden:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/g c/f }
-@end lilypond
-@funindex /+
-
-Eine Bassnote kann hinzugefügt werden, anstatt dass sie aus dem Akkord 
-entnommen wird, indem noch ein Plus zwischen den Schrägstrich und 
-die Tonhöhe gesetzt wird:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/+g c/+f }
-@end lilypond
-
-Der Akkord-Modus funktioniert ähnlich wie der Liedtext-Modus 
-(@code{\lyricmode}) usw. Die meisten Befehle funktionieren weiter, 
-so können etwa @code{r} und @code{\skip} benutzt werden, 
-um Pausen und Zwischenräume einzufügen. Mit Eigenschaftsbefehlen 
-können verschiedene Einstellungen verändert werden.
-
-
-@refbugs
-
-Jedes Intervall kann nur einmal in einem Akkord vorkommen. 
-Im folgenden Beispiel wird nur der erweiterte Akkord erstellt, 
-weil @code{5+} als letztes kommt.
-
-@cindex Cluster
-@lilypond[quote,ragged-right,verbatim,fragment]
-\chordmode { c:5.5-.5+ }
-@end lilypond
-
-
-@node Printing chord names
-@subsection Printing chord names
-
-@cindex Akkordsymbole
-@cindex Ausgabe von Akkordbezeichnungen
-@cindex Akkorde
-@cindex Symbole, Akkord-
-
-Um Akkordsymbole anstelle der Noten zu setzen, muss der 
-@internalsref{ChordNames}-Kontext. Die Akkorde können entweder 
-mit der Notation aus dem vorigen Abschnitt oder direkt 
-mit der Akkordeingabe für Noten (@code{<} und @code{>}) 
-notiert werden.
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
-}
-<<
-  \new ChordNames \harmonies
-  \new Staff \harmonies
->>
-@end lilypond
-
-Sie können Akkordwiederholungen unterdrücken, so dass nur 
-bei einer Änderung des Akkordes ein Symbol ausgegeben wird. 
-Das aktuelle Symbol wird auch am Zeilenanfang wiederholt. 
-Das geschieht mit dem Befehl @code{\set chordChanges = ##t}.
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
-}
-<<
-  \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
->>
-@end lilypond
-
-In den vorangegangenen Beispielen wurden alle Akkorde über dem 
-Notensystem mit den entsprechenden Noten ausgegeben. Das ist aber 
-nicht erforderlich. Akkorde können auch alleine gedruckt werden. 
-Dabei kann es nötig sein, @internalsref{Volta_engraver} und 
-@internalsref{Bar_engraver} einzufügen, damit Wiederholungen 
-angezeigt werden.
-
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-size = #4
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
-}
-}
-@end lilypond
-
-Die Standardeinstellungen für die Symbole entsprechen den Konventionen 
-im Jazz, wie sie von Klaus Ignatzek (siehe @ref{Literature list}). 
-vorgeschlagen wurden. Mit den folgenden Befehlen könne aber 
-Anpssungen vorgenommen werden:
-
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-Das ist eine Liste, die alle Akkorder aufführt, die angewöhnliche 
-Form haben.
-
-Die Liste muss nach dem Schema 
-@example
-@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-@noindent
-gesetzt werden.
-
-Diese Liste in die @code{chordNameExceptions}-Funktion einzulesen 
-ist allerdings etwas kompliziert. Mit dem folgenden Code-Abschnitt 
-wird @code{chExceptionMusic} (aufeinander folgende 
-Noten) in eine Ausnahmeliste umgewandelt:
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Dann werden mit dem Code
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
-die neuen Ausnahmen zu den schon vorhandenen hinzugefügt, die in 
-der Datei @file{ly/@/chord@/-modifier@/-init@/.ly} definiert sind.
-
-Ein Beispiel für die Benutzung dieser Eigenschaft findet sich 
-auch in der Datei @lsr{chords,chord@/-name@/-exceptions@/.ly}.
-@cindex Ausnahmen, Akkordsymbole
-
-
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Mit dieser Eigenschaft wird das Aussehen der Notation für die 
-große Septime (7) bestimmt. Vordefiniert sind die Optionen
-@code{whiteTriangleMarkup} und @code{blackTriangleMarkup}. 
-Siehe auch 
-@lsr{chords,chord@/-name@/-major7@/.ly} für ein Beispiel.
-
-@funindex chordNameSeparator
-@item chordNameSeparator
-Verschiedene Teile eines Akkordsymboles werden normalerweise 
-durch einen Schrägstrich markiert. Indem @code{chordNameSeparator} 
-ein anderer Wert zugewiesen wird, kann das Ausehen des Trenners 
-verändert werden, z. B.:
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
-}
-@end lilypond
-
-@funindex chordRootNamer
-@item chordRootNamer
-Der Grundton eines Akkordes wird normalerweise als Buchstabe mit 
-optionaler Erhöhung oder Erniedrigung dargestellt. Die Interpretation 
-einer Tonhöhe als Buchstabe wird von der @code{chordRootNamer}-Eigenschaft 
-übernommen. Besondere Bezeichnungen, wie etwa im Deutschen H für
-einen H-Dur-Akkord (und nicht @qq{B} wie im Englischen), können 
-durch Hinzufügen einer neuen Funktion zu dieser Eigenschaft 
-erstellt werden.
-
-@funindex chordNoteNamer
-@item chordNoteNamer
-In den Standardeinstellungen wird ein einziger Buchstabe für einen 
-Akkord ausgegeben, nämlich sein Grundton, der von der 
-@code{chordRootNamer}-Eigenschaft bestimmt wird. Die 
-@code{chordNoteNamer}-Eigenschaft hingegen kann das Aussehen dieses 
-Buchstaben ändern, ihn etwa als Klein- und nicht als Großbuchstabe 
-darstellen.
-
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-Das @qq{m} für Moll-Akkorde wird normalerweise direkt hinter dem 
-Akkordbuchstaben gesetzt. Mit der Eigenschaft @code{chordPrefixSpacer} 
-kann ein Abstand(halter) zwischen den Buchstaben und das @qq{m} 
-gesetzt werden. Der Abstandhalter wird nicht verwendet, wenn der 
-Grundton erhöht oder erniedrigt ist.
-
-@end table
-
-Die vordefinierten Befehle @code{\germanChords},
-@code{\semiGermanChords}, @code{\italianChords} und @code{\frenchChords}
-benutzen diese Variablen. Die Auswirkungen werden im nächsten Beispiel 
-gezeigt.
-
-@lilypondfile[ragged-right]{chord-names-languages.ly}
-
-Zusätzlich sind zwei weitere Vorlagen: eine alternative Jazz-Notation 
-und eine systematische Notation, genannt Banter-Akkorde. Die 
-alternative Jazz-Notation findet sich auch in der Liste im 
-Abschnitt @ref{Chord name chart}. Wie diese Stile verwendet werden, 
-wird in der Datei 
-@lsr{chords,chord-names-jazz.ly} gezeigt.
-
-@cindex Banter
-@cindex Jazz-Akkorde
-@cindex Akkorde, Jazz
-
-
-@refcommands
-
-@funindex \germanChords
-@code{\germanChords},
-@funindex \semiGermanChords
-@code{\semiGermanChords}.
-@funindex \italianChords
-@code{\italianChords}.
-@funindex \frenchChords
-@code{\frenchChords}.
-
-@seealso
-
-Beispiele: @lsrdir{chords}.
-
-Init-Dateien: @file{scm/@/chords@/-ignatzek@/.scm} und
-@file{scm/@/chord@/-entry@/.scm}.
-
-
-@refbugs
-
-Akkordsymbole werden nur von den Tonhöhenbezeichnungen bestimmt. 
-Akkordumkehrungen sind nicht definiert, noch werden Bassnoten 
-hinzugefügt. Deshalb kann es zu seltsamen Akkord-Symbolen kommen, 
-wenn die Akkorde mit der @code{< ... >} Syntax notiert werden.
-
-
-
-@node Vocal music
-@section Vocal music
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Setting simple songs::
-* Entering lyrics::
-* Aligning lyrics to a melody::
-* Working with lyrics and identifiers::
-* Flexibility in placement::
-* Spacing lyrics::
-* More about stanzas::
-* Ambitus::
-* Other vocal issues::
-@end menu 
-@node Setting simple songs
-@subsection Setting simple songs
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Entering lyrics
-@subsection Entering lyrics
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Aligning lyrics to a melody
-@subsection Aligning lyrics to a melody
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Automatic syllable durations::
-* Another way of entering lyrics::
-* Assigning more than one syllable to a single note::
-* More than one note on a single syllable::
-* Extenders and hyphens::
-@end menu 
-@node Automatic syllable durations
-@subsubsection Automatic syllable durations
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Another way of entering lyrics
-@subsubsection Another way of entering lyrics
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Assigning more than one syllable to a single note
-@subsubsection Assigning more than one syllable to a single note
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node More than one note on a single syllable
-@subsubsection More than one note on a single syllable
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Extenders and hyphens
-@subsubsection Extenders and hyphens
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Working with lyrics and identifiers
-@subsection Working with lyrics and identifiers
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Flexibility in placement
-@subsection Flexibility in placement
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Lyrics to multiple notes of a melisma::
-* Divisi lyrics::
-* Switching the melody associated with a lyrics line::
-* Lyrics independent of notes::
-@end menu 
-@node Lyrics to multiple notes of a melisma
-@subsubsection Lyrics to multiple notes of a melisma
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Divisi lyrics
-@subsubsection Divisi lyrics
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Switching the melody associated with a lyrics line
-@subsubsection Switching the melody associated with a lyrics line
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Spacing lyrics
-@subsection Spacing lyrics
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node More about stanzas
-@subsection More about stanzas
-
-UNTRANSLATED NODE: IGNORE ME
-
-@subsubsection Adding stanza numbers 
-@subsubsection Adding dynamics marks
-@subsubsection Adding singer names
-@subsubsection Printing stanzas at the end 
-@subsubsection Printing stanzas at the end in multiple columns 
-@node Ambitus
-@subsection Ambitus
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Other vocal issues
-@subsection Other vocal issues
-
-UNTRANSLATED NODE: IGNORE ME
-
-
-@node Rhythmic music
-@section Rhythmic music
-
-Rhythmusnotation wird vor allem für Schlaginstrumente eingesetzt, 
-aber hiermit kann auch der Rhythmus einer Melodie dargestellt werden.
-
-@menu
-* Showing melody rhythms::      
-* Entering percussion::         
-* Percussion staves::           
-* Ghost notes::                 
-@end menu
-
-
-@node Showing melody rhythms
-@subsection Showing melody rhythms
-
-Manchmal soll nur der Rhythmus einer Melodie dargestellt werden. Das 
-erreicht man mit einem Schlagzeug-Notensystem. Alle Tonhöhen werden 
-auf eine Linie reduziert und das System hat auch nur eine einzige 
-Linie.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new RhythmicStaff {
-  \time 4/4
-  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
-}
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{RhythmicStaff}.
-
-
-@node Entering percussion
-@subsection Entering percussion
-
-@cindex Percussion
-@cindex Drums
-@cindex Schlagzeug
-
-
-Schlagzeug-Noten können im @code{\drummode}-Modus notiert werden, 
-der sich ähnlich verhält wie der Standardmodus für die Noteneingabe. 
-Jedes Schlagzeuginstrument hat einen langen Namen und eine Abkürzung,
-und beide können nebeneinander benutzt werden.
-
-@lilypond[quote,ragged-right,verbatim]
-\drums {
-  hihat hh bassdrum bd
-}
-@end lilypond
-
-Eine vollständige Liste der Schlagwerk-Bezeichnungen findet sich in 
-der Datei @file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
-
-@seealso
-
-Programmreferenz: @internalsref{note-event}.
-
-@node Percussion staves
-@subsection Percussion staves
-@cindex Perkussion
-@cindex Schlagzeug
-
-Ein Schlagzeug-System besteht überlicherweise aus einem Notensystem 
-mit mehreren Linien, wobei jede Linie ein bestimmtes Schlagzeug-Instrument 
-darstellt.
-
-Um die Noten darstellen zu können, müssen sie sich innerhalb von 
-einem @internalsref{DrumStaff}- und einem 
-@internalsref{DrumVoice}-Kontext befinden.
-
-@lilypond[quote,ragged-right,verbatim]
-up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
-down = \drummode { bassdrum4 snare8 bd r bd sn4 }
-  \new DrumStaff <<
-    \new DrumVoice { \voiceOne \up }
-    \new DrumVoice { \voiceTwo \down }
-  >>
-@end lilypond
-Das Beispiel zeigt ausdrücklich definierte mehrstimmige Notation. Die 
-Kurznotation für mehrstimmige Musik, wie sie im Abschnitt 
-@ref{Basic polyphony} beschrieben wird, kann auch verwendet werden, 
-wenn die @internalsref{DrumVoice} (Schlagzeugstimmen) am Anfang explizit 
-initialisiert werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
-  \drummode {
-    bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { bd4 sn4 bd4 sn4 }
-    >>
-  }
->>
-@end lilypond
-
-Es gibt auch weitere Layout-Einstellungen. Um diese zu verwenden, 
-muss die Eigenschaft @code{drumStyleTable} im 
-@internalsref{DrumVoice}-Kontext entsprechend eingestellt werden. 
-Folgende Variablen sind vordefiniert:
-
-@table @code
-@item drums-style
-Das ist die Standardeinstellung. Hiermit wird ein typisches 
-Schlagzeug-System auf fünf Notenlinien erstellt.
-
-@lilypond[quote,line-width=10.0\cm]
-nam = \lyricmode {
-  cymc cyms cymr hh hhc hho hhho hhp
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
-mus = \drummode {
-  cymc cyms cymr hh hhc hho hhho hhp \break
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
-\score {
-  << \new DrumStaff \with {
-       \remove Bar_engraver
-       \remove Time_signature_engraver
-       \override Stem #'transparent = ##t
-       \override Stem #'Y-extent-callback = ##f
-       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
-     } \mus
-     \new Lyrics \nam
-  >>
-  \layout {
-    \context {
-      \Score
-      \override LyricText #'font-family = #'typewriter
-      \override BarNumber #'transparent =##T
-    }
-  }
-}
-@end lilypond
-Die Schlagzeugdefinitionen unterstützen sechs unterschiedliche 
-Tom Toms. Falls eine geringere Anzahl verwendet wird, kann man 
-einfach die Tom Toms auswählen, deren Notation man haben will. 
-Tom Toms auf den drei mittleren Linien werden mit den Bezeichnungen 
-@code{tommh}, @code{tomml} und @code{tomfh} notiert.
-
-@item timbales-style
-Hiermit werden Timbale auf zwei Notenlinien gesetzt.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { timh ssh timl ssl cb }
-mus = \drummode { timh ssh timl ssl cb s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-    \override StaffSymbol #'line-count = #2
-    \override StaffSymbol #'staff-space = #2
-    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
-    drumStyleTable = #timbales-style
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item congas-style
-Hiermit werden Congas auf zwei Linien gesetzt.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
-mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    drumStyleTable = #congas-style
-    \override StaffSymbol #'line-count = #2
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item bongos-style
-Hiermit werden Bongos auf zwei Linien gesetzt.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
-mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override StaffSymbol #'line-count = #2
-    drumStyleTable = #bongos-style
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item percussion-style
-Dieser Stil ist für alle einfachen Perkussionsinstrumente auf einer Notenlinie.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
-mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
-
-<<
-  \new DrumStaff \with{
-    \remove Bar_engraver
-    drumStyleTable = #percussion-style
-    \override StaffSymbol #'line-count = #1
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-@end table
-
-Wenn ihnen keine der vordefinierten Stile gefällt, können Sie auch eine 
-eigene Liste der Positionen und Notenköpfe am Anfang ihrer Datei erstellen.
-
-@lilypond[quote,ragged-right,verbatim]
-#(define mydrums '(
-         (bassdrum     default   #f         -1)
-         (snare        default   #f         0)
-         (hihat        cross     #f         1)
-         (pedalhihat   xcircle   "stopped"  2)
-         (lowtom       diamond   #f         3)))
-up = \drummode { hh8 hh hh hh hhp4 hhp }
-down = \drummode { bd4 sn bd toml8 toml }
-
-\new DrumStaff <<
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
-  \new DrumVoice { \voiceOne \up }
-  \new DrumVoice { \voiceTwo \down }
->>
-@end lilypond
-
-
-@seealso
-
-Init-Dateien: @file{ly/@/drumpitch@/-init@/.ly}.
-
-Programmreferenz: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
-
-@refbugs
-
-Weil in den allgemeinen MIDI-Definitionen kein Rimshot enthalten ist, 
-wird sidestick für diesen Zweck benutzt.
-
-
-@c FIXME: check name -tr
-@node Ghost notes
-@subsection Ghost notes
-
-Geisternoten für Schlagzeug und Perkussion können mit dem 
-Klammer- (@code{\parenthesize})-Befehl, beschrieben in @ref{Parentheses}, 
-erstellt werden. Im Standard-@code{\drummode}-Modus ist aber 
-das @code{Parenthesis_engraver}-Plugin nicht automatisch enthalten. 
-Sie müssen das Plugin ausdrücklich in den Kontext-Definitionen 
-laden, wie im Abschnitt @ref{Changing context properties on the fly}
-detailliert beschrieben.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\new DrumStaff \with {
-  \consists "Parenthesis_engraver"
-} <<
-  \context DrumVoice  = "1"  { s1 *2 }
-  \context DrumVoice  = "2" { s1 *2 }
-  \drummode {
-    <<
-      {
-        hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
-      } \\ {
-        bd4 r4 bd8 bd r8 bd
-      }
-    >>
-  }
->>
-@end lilypond
-
-@noindent
-Um jede Klammer-Definition (@code{\parenthesize}) müssen
- zusätzlich die spitzen 
-Klammern für Akkorde (@code{< >}) gesetzt werden.
-
-
-@node Guitar
-@section Guitar
-
-@cindex tablature
-@cindex guitar tablature
-
-@menu
-* String number indications::   
-* Tablatures basic::            
-* Non-guitar tablatures::       
-* Banjo tablatures::            
-* Fret diagrams::               
-* Right hand fingerings::       
-* Other guitar issues::         
-@end menu
-
-@node String number indications
-@subsection String number indications
-
-@cindex String numbers
-
-Saitennummerierung kann zu den Akkorden hinzugefügt werden, 
-indem die Saitennummer nach einem Backslash als Zahl angegeben 
-wird:
-
-@lilypond[relative,relative=1,ragged-right,fragment]
-<c\1 e\2 g\3>
-@end lilypond
-
-
-@seealso
-
-Programmreferenz: @internalsref{StringNumber},
-@lsr{guitar/,string-number.ly}.
-
-
-@node Tablatures basic
-@subsection Tablatures basic
-@cindex Tablatures basic
-
-Tabulatur-Notation wird für die Notation von Zupfinstrumenten benutzt. 
-Tonhöhen werden hier nicht durch Notenköpfe, sondern durch Zahlen 
-notiert. Diese Zahlen zeigen an, auf welcher Saite und welchem Bund 
-der Ton gespielt werden soll. LilyPond bringt beschränkte Unterstützung 
-für Tabulaturen mit.
-
-Die Saitennummer, die mit einer Note assoziiert ist, wird durch einen 
-Backslash, gefolgt von einer Zahl, notiert, etwa @code{c4\3} für eine 
-Viertelnote C auf der dritten Saite. In der Standardeinstellung ist 
-die erste Saite die höchste Saite und als Stimmung wird die übliche 
-Gitarrenstimmung auf sechs Saiten angenommen. Die Noten werden in 
-einer Tabulatur gesetzt, indem @internalsref{TabStaff} und
-@internalsref{TabVoice}-Kontexte verwendet werden.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  a,4\5 c'\2 a\3 e'\1
-  e\4 c'\2 a\3 e'\1
-}
-@end lilypond
-
-@funindex minimumFret
-@cindex Bund
-
-Wenn keine Saite angegeben wird, wird die Saite, deren Bund-Zahl 
-weniger als der Betrag in @code{minimumFret} beträgt, ausgewählt. 
-Der Standardwert für @code{minimumFret} beträgt 0.
-
-
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
-  \key e \major
-  e16 fis gis a b4
-  \set TabStaff.minimumFret = #8
-  e16 fis gis a b4
-}
-  \new StaffGroup <<
-    \new Staff { \clef "G_8" \frag }
-    \new TabStaff { \frag }
-  >>
-@end lilypond
-
-
-@commonprop
-
-Um Tabulaturen mit Hälsen nach unten und horizontalen Balken 
-zu erstellen, muss der @code{TabStaff} mit folgenden Parametern 
-initialisiert werden:
-
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
-
-@seealso
-
-Programmreferenz: @internalsref{TabStaff}, @internalsref{TabVoice}.
-
-@refbugs
-
-Akkorde werden nicht gesondert behandelt, sodass die Saitenauswahlfunktion 
-eventuell die selbe Saite für zwei Töne eines Akkordes auswählen kann.
-
-Damit die Kombination von Stimmen (@code{\partcombine}) richtig funktioniert, 
-müssen spziell erstellte Stimmen innerhalb des Tabulatursystems 
-(@code{TabStaff}) benutzt werden:
-
-@lilypond[quote,ragged-right,verbatim]
-melodia = \partcombine { e4 g g g }{ e4 e e e }
-<<
-  \new TabStaff <<
-    \new TabVoice = "one" s1
-    \new TabVoice = "two" s1
-    \new TabVoice = "shared" s1
-    \new TabVoice = "solo" s1
-    { \melodia }
-  >>
->>
-@end lilypond
-
-
-
-@node Non-guitar tablatures
-@subsection Non-guitar tablatures
-@cindex Non-guitar tablatures
-
-Die Stimmung der Saiten kann verändert werden. Die Stimmung muss als 
-eine Scheme-Liste dargestellt werden, in der jeder Saite eine Zahl
-zugewiesen ist, die die Tonhöhe der offenen Saite in Halbtönen 
-(gemessen von c') darstellt. Die Liste wird als Definition von 
-@code{stringTunings} dargestellt. Die Halbtöne können vom c' aus addiert 
-oder subtrahiert werden. Die Reihenfolge der Zahlen bestimmt auch 
-die Reihenfolge der Saiten. LilyPond entnimmt aus dieser Liste 
-auch die Anzahl der Saiten.
-
-Im nächsten Beispiel wird 
-@code{stringTunings} für die Tonhöhen @code{e, a, d,} und @code{g} gesetzt.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
->>
-@end lilypond
-
-LilyPond bringt schon vordefinierte Stimmungen für Banjo, Mandoline, 
-Gitarre und Bassgitarre mit.
-
-@example
-\set TabStaff.stringTunings = #bass-tuning
-@end example
-
-Der Standard ist die Gitarrenstimmung (@code{guitar-tuning}) mit den 
-Saiten EADGBE. Andere vordefinierte Stimmungen sind 
-@code{guitar-open-g-tuning},
-@code{mandolin-tuning} und @code{banjo-open-g-tuning}.
-
-@seealso
-
-In der Datei @file{scm/@/output@/-lib@/.scm} sind die Stimmungen 
-definiert.
-Programmreferenz: @internalsref{Tab_note_heads_engraver}.
-
-@refbugs
-
-Spezialeffekte für Gitarren sind noch nicht implementiert.
-
-
-
-@node Banjo tablatures
-@subsection Banjo tablatures
-@cindex Banjo tablatures
-
-LilyPond unterstützt die Basisnotation für das fünfsaitige Banjo. Die 
-Banjo-Tabulatur-Funktion sollte zum Notieren von Banjo-Tabulaturen 
-verwendet werden, damit die richtigen Bund-Nummern für die fünfte 
-Saite gesetzt werden:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
-  \set TabStaff.stringTunings = #banjo-open-g-tuning
-  {
-    \stemDown
-    g8 d' g'\5 a b g e d' |
-    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
-    g4
-  }
->>
-@end lilypond
-
-Eine Anzahl von üblichen Stimmungen für das Banjo sind in LilyPond 
-schon vordefiniert: 
-@code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
-@code{banjo-open-d-tuning} (aDF#AD) und @code{banjo-open-dm-tuning}
-(aDFAD).
-
-Diese Stimmungen können für das viersaitige Banjo angepasst werden, 
-indem die @code{four-string-banjo}-Funktion eingesetzt wird:
-
-@example
-\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
-@end example
-
-@seealso
-
-Die Datei @file{scm/@/output@/-lib@/.scm} enthält vordefinierte 
-Banjo-Stimmungen.
-
-
-@node Fret diagrams
-@subsection Fret diagrams
-@cindex Fret-Diagramme
-@cindex Griffsymbole
-@cindex Gitarrengriffsymbole
-@cindex Akkordtabulartur
-@cindex Akkorddiagramm
-
-Akkordtabulaturen (Fret-Diagramme) können zu Noten als eine Beschriftung 
-hinzugefügt werden. Die Beschriftung enthält Information über die 
-erwünschte Akkordtabulatur, wie das folgende Beispiel zeigt:
-
-@lilypond[verbatim, ragged-right, quote]
-\new Voice {
-  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
-  d' d' d'
-  fis'^\markup \override #'(size . 0.75) {
-    \override #'(finger-code . below-string) {
-      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
-                               (place-fret 5 4 3) (place-fret 4 4 4)
-                               (place-fret 3 3 2) (place-fret 2 2 1)
-                               (place-fret 1 2 1))
-    }
-  }
-  fis' fis' fis'
-  c'^\markup \override #'(dot-radius . 0.35) {
-    \override #'(finger-code . in-dot) {
-      \override #'(dot-color . white) {
-        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
-      }
-    }
-  }
-  c' c' c'
-}
-@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 in dem Beschriftungs-Befehl. Details über die 
-Beschriftungsbefehle finden sich im Abschnitt 
- @ref{Overview of 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 
-@internalsref{fret-diagram-interface}.
-
-
-@seealso
-
-Examples: @lsrdir{guitar}.
-
-
-@node Right hand fingerings
-@subsection Right hand fingerings
-
-Fingersatz für die rechte Hand in Akkorden kann notiert werden, indem 
-der Befehl @code{@var{note}-\rightHandFinger @var{finger}} 
-benutzt wird.
-
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
-@end lilypond
-
-Zur Erleichterung kann der Befehl @code{\rightHandFinger} zu ein paar
-Buchstaben abgekürzt werden, etwa @code{RH}.
-
-@example
-#(define RH rightHandFinger)
-@end example
-
-@cindex Fingersatz, rechte Hand, Gitarre
-@cindex Rechte Hand-Fingersatz für Gitarre
- 
-@commonprop
-
-Größere Kontrolle über den Fingersatz der rechten Hand kann 
-mit einer Definition des Befehls @code{strokeFingerOrientations}
-erreicht werden:
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-}
-@end lilypond
-
-Die Buchstaben, die für den Fingersatz verwendet werden, sind in der 
-Eigenschaft @code{digit-names} enthalten, aber sie können auch individuell 
-verändert werden, indem @code{\rightHandFinger} mit einer Zeichenfolge als 
-Argument eingesetzt wird, wie im nächsten Beispiel:
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
-  <c-\RH #5 >4
-  <c-\RH "@">4  
-}
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{StrokeFinger}
-
-
-
-@node Other guitar issues
-@subsection Other guitar issues
-
-Dieses Beispiel zeigt, wie Griff - und Barre-Angaben 
-eingefügt werden können.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
-\clef "G_8"
-b16 d16 g16 b16 e16
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text = #"XII "
-  g16\startTextSpan
-  b16 e16 g16 e16 b16 g16\stopTextSpan
-e16 b16 g16 d16
-@end lilypond
-
-Gedämpfte (X) Notenköpfe werden in der Gitarrenmusik benutzt, um 
-zu signalisieren, dass der Gitarist 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}
-gezeigt.
-
-
-@node Bagpipe
-@section Bagpipe
-
-@cindex Sackpfeife
-@cindex Dudelsack
-
-@menu
-* Bagpipe definitions::         
-* Bagpipe example::             
-@end menu
-
-
-@node Bagpipe definitions
-@subsection Bagpipe definitions
-
-LilyPond besitzt spezielle Definitionen, mit der die Musik 
-des schottischen Hochland-Dudelsacks notiert wird. Um sie 
-zu benutzen, muss
-
-@example
-\include "bagpipe.ly"
-@end example
-
-@noindent
-am Anfang der LilyPond-Quelldatei eingefügt werden. Hierdurch 
-können dann bestimmte Verzierungsnoten, die für die Dudelsackmusik 
-üblich sind, mit kurzen Befehlen eingefügt werden. So reicht etwa der 
-Befehl @code{\taor}, anstatt
-
-@example
-\grace @{ \small G32[ d G e] @}
-@end example
-
-@noindent zu schreiben.
-
-@code{bagpipe.ly} enthält außerdem Definitionen für Tonhöhen von 
-Dudelsacknoten in bestimmten Oktoven, so dass man sich nicht mehr um
-@code{\relative} oder @code{\transpose} kümmern muss.
-
-@lilypond[ragged-right,verbatim,quote,notime]
-\include "bagpipe.ly"
-{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
-@end lilypond
-
-Musik für den Dudelsack wird dem Namen nach in D-dur
- geschrieben (auch wenn das eigentlich nicht stimmt). Weil 
- das aber die einzige Tonart ist, die benutzt werden kann, werden 
- die Vorzeichen meistens nicht geschrieben. Damit das funktioniert, 
- müssen die Noten immer mit @code{\hideKeySignature} beginnen. 
- Wenn die Vorzeichen hingegen angezeigt werden sollen, kann das 
- mithilfe des Befehls @code{\showKeySignature} vorgenommen werden.
-
-Some modern music use cross fingering on c and f to flatten those notes.
-This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
-piobaireachd high g can be written @code{gflat} when it occurs in light
-music.
-
-
-@node Bagpipe example
-@subsection Bagpipe example
-
-So sieht die bekannte Melodie Amazing Grace aus, wenn man sie für 
-Dudelsack notiert.
-
-@lilypond[verbatim,quote]
-\include "bagpipe.ly"
-\layout {
-  indent = 0.0\cm
-  \context { \Score \remove "Bar_number_engraver" }
-}
-
-\header {
-  title = "Amazing Grace"
-  meter = "Hymn"
-  arranger = "Trad. arr."
-}
-
-{
-  \hideKeySignature
-  \time 3/4
-  \grg \partial 4 a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg e8. f16
-  \dblA A2 \grg A4
-  \grg A2 f8. A16
-  \grg A2 \hdblf f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 e4
-  \thrwd d2.
-  \slurd d2
-  \bar "|."
-}
-@end lilypond
-
-
-@node Ancient notation
-@section Ancient notation
-
-@cindex Vaticana, Editio
-@cindex Medicaea, Editio
-@cindex Editio Vaticana
-@cindex Editio Medicea
-@cindex Hufnagelnotation
-@cindex Petrucci-Notation
-@cindex Mensuralnotation
-
-In gewissem Rahmen unterstützt LilyPond die Notation 
-Alter Musik: Mensuralnotation sowie der Gregorianische 
-Choral werden unterstützt, dazu kommt noch rudimentäre 
-Unterstützung der Generalbassnotation.
-
-Viele graphische Objekte stellen eine Stil- (@code{style})-Eigenschaft
-zur Verfügung, siehe
-@itemize @bullet
-@item
-@ref{Ancient note heads},
-@item
-@ref{Ancient accidentals},
-@item
-@ref{Ancient rests},
-@item
-@ref{Ancient clefs},
-@item
-@ref{Ancient flags},
-@item
-@ref{Ancient time signatures}.
-@end itemize
-
-Indem eine dieser grob- (graph. Obj.)-Eigenschaften verändert wird, 
-ändert sich auch die Erscheindung der grafischen Objekte zu einem 
-bestimmten Notationsstil, ohne dass neue Notationskonzepte 
-bemüht werden müssen.
-
-Zusätzlich zu den Standard-Artikulationszeichen, wie sie in Abschnitt 
-@ref{Articulations} beschrieben werden, gibt es auch besondere 
-Artikulationszeichen für die Alte Musik.
-
-@itemize @bullet
-@item
-@ref{Ancient articulations}
-@end itemize
-
-Andere Eigenheiten der Notation Alter Musik können nicht so einfach 
-verändert werden, als dass es genügte, nur einen Stil eines graphischen 
-Objektes umzudefinieren. Bestimmte Konzepte sind speziell für die 
-Alte Musik eingeführt worden:
-
-@itemize @bullet
-@item
-@ref{Custodes},
-@item
-@ref{Divisiones},
-@item
-@ref{Ligatures}.
-@end itemize
-
-Sollte Ihnen das zu viel Dokumentation sein, denn Sie wollen eigentlich 
-schnell mit dem Notensatz beginnen, ohne sich groß um die Details 
-zur Anpassung von Kontexten zu kümmern, können Sie sich auch die 
-vordefinierten Kontexte anschauen. Sie können benutzt werden, um 
-zwei bestimmte Stile im Stimmen- und Staff-Kontext direkt zu benutzen:
-
-@itemize @bullet
-@item
-@ref{Gregorian Chant contexts},
-@item
-@ref{Mensural contexts}.
-@end itemize
-
-Es gibt auch begrenzte Unterstützung für bezifferten Bass/Generalbass, eine 
-Notationstradition, die aus dem Barock stammt.
-
-@itemize @bullet
-@item
-@ref{Figured bass}
-@end itemize
-
-Hier sind alle Unterkapitel auf einen Blick:
-
-@menu
-* Ancient note heads::          
-* Ancient accidentals::         
-* Ancient rests::               
-* Ancient clefs::               
-* Ancient flags::               
-* Ancient time signatures::     
-* Ancient articulations::       
-* Custodes::                    
-* Divisiones::                  
-* Ligatures::                   
-* Gregorian Chant contexts::    
-* Mensural contexts::           
-* Musica ficta accidentals::    
-* Figured bass::                
-@end menu
-
-
-
-@node Ancient note heads
-@subsection Ancient note heads
-
-@cindex Notenköpfe, Alte Musik
-
-Für die Notation Alter Musik kann ein Notenkopfstil ausgewählt werden, der sich 
-vom Standard (@code{default}) unterscheidet. Dies wird erreicht, indem die 
-@code{style}-Eigenschaft der Notenkopf-(@internalsref{NoteHead})-Objekte auf  
-einen der Werte @code{baroque}, @code{neomensural}, @code{mensural} oder 
-@code{petrucci} gesetzt wird. Der barocke (@code{baroque}) Stil unterscheidet 
-sich vom Standard (@code{default}) nur in sofern, als eine viereckige Form für 
-die Brevis (@code{\breve}) benutzt wird. Der @code{neomensural}-Stil 
-unterscheidet sich vom barocken Stil darin, dass hier rhomboide Notenköpfe für 
-ganze Noten und kleinere Notenwerte eingesetzt ewrden. Hälse werden über oder 
-unter den Notenköpfen zentriert. Dieser Stil ist vor allem dann sinnvoll, wenn 
-mensurale Musik transkribiert werden soll, etwa für ein Incipit. Der
-mensurale (@code{mensural}) Stil erstellt Notenköpfe, die das Aussehen 
-historischer Drucke des 16. Jahrhunderts imitieren. Der @code{petrucci}-Stil 
-schließlich imitiert auch historische Drucke, verwendet allerdings größere 
-Notenköpfe.
-
-Das folgende Beispiel soll den neomensuralen Stil demonstrieren:
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override NoteHead #'style = #'neomensural
-a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
-@end lilypond
-
-Für die Notation des Gregorianischen Chorals werden vom 
-@internalsref{Gregorian_ligature_engraver} automatisch die richtigen Notenköpfe 
-ausgewählt, so dass man den Stil nicht manuell setzen muss. Trotzdem kann 
-der Stil manuell verändert werden, z. B. auf den Wert 
-@code{vaticana_punctum}, um Punktum-Neumen zu produzieren. Gleichfalls erstellt 
-der @internalsref{Mensural_ligature_engraver} automatisch Ligaturen der 
-Mensuralnotation. Siehe @ref{Ligatures} zu einer Übersicht über die Funktion 
-und Notation von Ligaturen.
-
-@seealso
-
-@ref{Note head styles} stellt einen Überblick über alle verfügbaren 
-Notenkopfstile zur Verfügung.
-
-
-@node Ancient accidentals
-@subsection Ancient accidentals
-
-@cindex Vorzeichen, Alte Musik
-
-
-Mit der @code{glyph-name-alist}-Eigenschaft der
-Versetzungszeichen-(@internalsref{Accidental})- und
-Vorzeichen-(@internalsref{KeySignature})-Eigenschaften können Vorzeichen 
-und Versetzungszeichen für die Alte Musik ausgewählt werden.
-
-@lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \fatText
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
-  }
-}
-@end lilypond
-
-Wie zu sehen ist, werden nicht alle Versetzungszeichen von jedem Stil 
-unterstützt. Wenn versucht wird, ein Versetzungszeichen zu notieren, 
-das von einem bestimmten Stil nicht untersützt wird, wechselt LilyPond zu einem 
-anderen Stil, wie in dem Beispiel @lsr{ancient,ancient-accidentals.ly}
-demonstriert wird.
-
-Ähnlich wie Versetzungszeichen können auch die Vorzeichen für die Angabe der 
-Tonart verändert werden, indem die @code{glyph-name-alist}-Eigenschaft 
-des @internalsref{KeySignature}-Objektes gesetzt wird.
-
-@seealso
-
-In diesem Handbuch: @ref{Pitches}, @ref{Cautionary accidentals} und
-@ref{Automatic accidentals} geben eine allgemeine Einführung in die Benutzung 
-von Versetzungszeichen. Der Abschnitt @ref{Key signature} zeigt die allgemeine 
-Benutzung von Vorzeichen.
-
-Programmreferenz: @internalsref{KeySignature}.
-
-Beispiele: @lsrdir{ancient}.
-
-@node Ancient rests
-@subsection Ancient rests
-
-@cindex Pausen, Alte Musik
-
-Besondere Pausensymbole für die Notation der Alten Musik können mit der 
-@code{style}-Eigenschaft des graphischen Objektes (grob) @qq{Pause}
-(@internalsref{Rest}) angewählt werden. Unterstützte Stile sind 
-klassisch (@code{classical}), @code{neomensural} und @code{mensural}. 
-Der klassische (@code{classical}) Stil unterscheidet sich vom Standardstil 
-(@code{default}) nur darin, dass die Viertelpause wie eine gespiegelte 
-Achtelpause aussieht. Der neomensurale Stil eignet sich gut, um z. B. das 
-Incipit von transkribierter Musik zu notieren. Der mensurale Stil ahmt die 
-Form von Pausen nach, wie man sie in Drucken des 16. Jahrhunderts finden kann.
-
-Das nächste Beispiel demonstriert den neomensuralen (@code{neomensural})
-Stil:
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override Rest #'style = #'neomensural
-r\longa r\breve r1 r2 r4 r8 r16
-@end lilypond
-
-Es gibt keine 32-stel- und 64-stel-Pausen für den mensuralen oder neomensuralen
-Stil. Anstatt dessen werden die Pausenformen des Standardstiles verwendet. 
-Vgl. eine Liste aller vorhandenen Pausen in @lsr{pitches,rests}.
-
-Für die Notation des Gregorianischen Chorals gibt es keine Pausen; anstelle 
-dessen werden @ref{Divisiones} verwendet.
-
-@seealso
-
-In diesem Handbuch: Der Abschnitt @ref{Rests} enthält eine allgemeine 
-Einführung zur Benutzung von Pausen.
-
-
-@node Ancient clefs
-@subsection Ancient clefs
-
-@cindex Schlüssel, Alte Musik
-
-
-LilyPond unterstützt eine große Anzahl von Notenschlüsseln, von denen eine 
-ganze Anzahl für die Alte Musik geeignet ist.
-
-In der Tabelle unten werden alle Schlüssel für die Alte Musik gezeigt, die 
-mit dem @code{\clef}-Befehl erreicht werden. Manche Schlüssel benutzen den 
-selben Schlüssel, unterscheiden sich aber in der Notenlinie, auf der der 
-Schlüssel notiert wird. In diesem Fällen ist eine Nummer im Schlüsselnamen 
-eingefügt. Man kann aber trotzdem eine beliebige Nummer erzwingen, wie es im 
-Abschnitt @ref{Clef} beschrieben wird. Die Note, die rechts von jedem Schlüssel 
-gesetzt ist, zeigt das @code{c'} in Bezug zu dem jeweiligen Schlüssel.
-
-@multitable @columnfractions .4 .4 .2
-@item
-@b{Beschreibung}
-@tab
-@b{Unterstützte Schlüssel}
-@tab
-@b{Beispiel}
-
-@item
-Mensuraler C-Schlüssel im modernen Stil
-@tab
-@code{neomensural-c1}, @code{neomensural-c2},@*
-@code{neomensural-c3}, @code{neomensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "neomensural-c2" c
-@end lilypond
-
-@item
-Mensuraler C-Schlüssel im Petrucci-Stil, zur Benutzung auf verschiedenen 
-Notenlinien (im 
-Beispiel den Schlüssel auf der zweiten Linie)
-@tab
-@code{petrucci-c1}, @code{petrucci-c2},@*
-@code{petrucci-c3}, @code{petrucci-c4},@*
-@code{petrucci-c5}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Mensuraler F-Schlüssel im Petrucci-Stil
-@tab
-@code{petrucci-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Mensuraler G-Schlüssel im Petrucci-Stil
-@tab
-@code{petrucci-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Mensuraler C-Schlüssel im historischen Stil
-@tab
-@code{mensural-c1}, @code{mensural-c2},@*
-@code{mensural-c3}, @code{mensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Mensuraler F-Schlüssel im historischen Stil
-@tab
-@code{mensural-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Mensuraler G-Schlüssel im historischen Stil
-@tab
-@code{mensural-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Do-Schlüssel der Editio Vaticana
-@tab
-@code{vaticana-do1}, @code{vaticana-do2},@*
-@code{vaticana-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-do2"
-  c
-@end lilypond
-
-@item
-Fa-Schlüssel der Editio Vaticana
-@tab
-@code{vaticana-fa1}, @code{vaticana-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-fa2"
-  c
-@end lilypond
-
-@item
-Do-Schlüssel der Editio Medicaea
-@tab
-@code{medicaea-do1}, @code{medicaea-do2},@*
-@code{medicaea-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-do2"
-  c
-@end lilypond
-
-@item
-Fa-Schlüssel der Editio Medicaea
-@tab
-@code{medicaea-fa1}, @code{medicaea-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-fa2"
-  c
-@end lilypond
-
-@item
-Hufnagel Do-Schlüssel für den historischen Stil
-@tab
-@code{hufnagel-do1}, @code{hufnagel-do2},@*
-@code{hufnagel-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do2"
-  c
-@end lilypond
-
-@item
-Hufnagel Fa-Schlüssel für den historischen Stil
-@tab
-@code{hufnagel-fa1}, @code{hufnagel-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-fa2"
-  c
-@end lilypond
-
-@item
-Kombinierter Do/Fa-Hufnagelschlüssel für den historischen Stil
-@tab
-@code{hufnagel-do-fa}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do-fa"
-  c
-@end lilypond
-@end multitable
-
-
-
-@emph{Moderner Stil} bedeutet: @qq{Wie in modernen Editionen von 
-transkribierter Mensuralmusik benutzt.}
-
-@emph{Petrucci-Stil} bedeutet: @qq{Inspiriert von Drucken, die der berühmte 
-Notensetzer Petrucci (1466--1539) produziert hat.}
-
-@emph{Historischer Stil} bedeutet: @qq{Wie in anderen als Petruccis Editionen 
-gedruckt oder geschrieben wurde.}
-
-@emph{Editio XXX-Stil} bedeutet: @qq{Wie in der Editio XXX gedruckt 
-wird.}
-
-Petrucci verwendete C-Schlüssel mit unterschiedlich balanciertem vertikalen 
-Balken auf der linken Seite in Abhängigkeit davon, auf welcher Notenlinie 
-der Schlüssel gesetzt wird.
-
-@seealso
-
-In diesem Handbuch: siehe @ref{Clef}.
-
-@refbugs
-
-Der mensurale G-Schlüssel ist als Petrucci-G-schlüssel deklariert.
-
-
-
-@node Ancient flags
-@subsection Ancient flags
-
-@cindex Fähnchen, Alte Musik
-
-Mit der Fähnchen-(@code{flag-style})-Eigenschaft der graphischen Objekte 
-@qq{Hals} (@internalsref{Stem}) können auch Fähnchen passend zu den Notenköpfen 
-der Alten Musik gesetzt werden. Neben dem Standardstil (@code{default}) ist 
-auch ein mensuraler Stil (@code{mensural}) unterstützt.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\override Stem #'flag-style = #'mensural
-\override Stem #'thickness = #1.0
-\override NoteHead #'style = #'mensural
-\autoBeamOff
-c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
-c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
-@end lilypond
-
-Dabei ist die innerste Fahne immer vertikal auf eine Notenlinie ausgerichtet.
-
-Es gibt keinen eigenen Stil für die @qq{neomensurale} Notation. Insofern sollte 
-für das Incipit bei der Transkription mensuraler Musik der Standardstil 
-benutzt werden. Für die Notation des Gregorianischen Chorals gibt es keine 
-Fähnchen.
-
-@refbugs
-
-Die Positionierung der Fähnchen an den Hälsen ist leicht verschoben seit einer 
-Änderung in einer frühen 2.3.x-Version.
-
-Vertikale Ausrichtung der Fähnchen an einer Notenlinie geht von der Annahme 
-aus, dass der Hals entweder genau auf einer Notenlinie oder genau zwischen zwei 
-Notenlinien endet. Das ist aber nicht unbedingt immer der Fall, weil LilyPond 
-komplizierte Methoden zur Ermittlung des besten Layouts verwendet. Diese 
-Methoden sollten aber eigentlich nicht zur Notation von mensuraler Musik 
-eingesetzt werden.
-
-
-@node Ancient time signatures
-@subsection Ancient time signatures
-
-@cindex Taktart, Alte Musik
-@cindex Mensur
-
-LilyPond besitzt grundlegende Untersützung für mensurale Taktangaben. Die 
-Symbole sind starr verknüpft mit bestimmten Brüchen. Darum müssen die Werte 
-@code{n} und @code{m} der folgenden Tabelle in den Befehl 
-@code{\time n/m} eingesetzt werden, um die entsprechenden Symbole zu erhalten.
-
-@lilypond[quote,ragged-right]
-\layout {
-  indent = 0.0
-  \context {
-    \Staff
-    \remove Staff_symbol_engraver
-    \remove Clef_engraver
-    \remove Time_signature_engraver
-  }
-}
-{
-  \set Score.timing = ##f
-  \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural44" }
-  s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural22" }
-  s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural64" }
-  s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural68" }
-  \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural32" }
-  s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural34" }
-  s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural94" }
-  s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural98" }
-  \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural48" }
-  s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural24" }
-}
-@end lilypond
-
-Mit der @code{style}-Eigenschaft des Objektes @internalsref{TimeSignature} 
-können die Taktarten angewählt werden. Unterstützte Stile sind:
-@code{neomensural} und @code{mensural}. In der Tabelle oben wurde der 
-neomensurale Stil verwendet. Dieser Stil ist geeignet, um im Incipt von 
-transkribierter Mensuralmusik eingesetzt zu werden. Der mensurale Stil dagegen 
-ahmt die Form historischer Druck des 16. Jahrhunderts nach.
-
-Im folgenden Beispiel sind die unterschiedlichen Stile dargestellt.
-
-@lilypond[ragged-right,fragment,relative=1,quote]
-{
-  \fatText
-
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter default }
-
-  \override Staff.TimeSignature #'style = #'numbered
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter numbered }
-
-  \override Staff.TimeSignature #'style = #'mensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter mensural }
-
-  \override Staff.TimeSignature #'style = #'neomensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter neomensural }
-  \override Staff.TimeSignature #'style = #'single-digit
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter single-digit }
-}
-@end lilypond
-
-@seealso
-
-In diesem Handbuch: @ref{Time signature} bietet eine allgemeine Übersicht über 
-den Einsatz von Taktangaben.
-
-@refbugs
-
-Die Verhältnisse der Notenwerte ändern sich nicht, wenn die Taktart (Mensur) 
-gewechselt wird. Zum Beispiel muss das Verhältnis 1 brevis = 3 semibrevis
-(tempus perfectum) manuell erstellt werden, indem folgende Variable erstellt 
-wird:
-
-@example
-breveTP = #(ly:make-duration -1 0 3 2)
-@dots{}
-@{ c\breveTP f1 @}
-@end example
-
-@noindent
-Hiermit wird die Variable @code{breveTP} auf den Wert 
-@qq{3/2 mal 2 = 3 mal eine Ganze} gesetzt.
-
-Das @code{old6/8alt}-Symbol (ein alternatives Symbol für 6/8) kann nicht 
-mit dem Befehl @code{\time} angesprochen werden. Verwenden Sie anstatt dessen 
-eine Textbeschriftung (@code{\markup}).
-
-
-@node Ancient articulations
-@subsection Ancient articulations
-
-@cindex articulations
-
-Zusätzlich zu den Standardartikulationszeichen, wie sie im Abschnitt
-@ref{Articulations} beschrieben werden, werden auch Artikulationszeichen 
-für die Alte Musik zur Verfügung gestellt. Diese sind darauf hin geformt, dass 
-sie mit der Notation des Editio Vaticana-Stils verwendet werden können.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \override TextScript #'font-family = #'typewriter
-    \override TextScript #'font-shape = #'upright
-    \override Script #'padding = #-0.1
-    a\ictus_"ictus" \break
-    a\circulus_"circulus" \break
-    a\semicirculus_"semicirculus" \break
-    a\accentus_"accentus" \break
-    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
-  }
-}
-@end lilypond
-
-@refbugs
-
-Einige Artikulationszeichen sind vertikal zu dich an den entsprechenden 
-Notenköpfen gesetzt.
-
-Die Episem-Linie wird in vielen Fällen nicht angezeigt. Wenn sie angezeigt wird,
-ist das rechte Ende der Episem-Linie oft zu weit rechts.
-
-@node Custodes
-@subsection Custodes
-
-@cindex Custodes
-
-Ein @emph{custos} (Plural: @emph{custodes}; Lateinisch: @qq{Beschützer}) ist
-ein Symbol, das am Ende jedes Notensystems erscheint. Es nimmt die Tonhöhe 
-der ersten Note der nächsten Zeile vorweg und hilft damit dem Vortragenden, 
-die Zeilenwechsel während der Vorführung zu bewältigen.
-
-Custodes wurden bis zum 17. Jahrhundert sehr häufig in der Musiknotation 
-eingesetzt. Heute finden sie sich nur noch in einigen bestimmten 
-Notationsformen, etwa modernen Editionen des Gregorianischen Chorals wie die 
-@emph{editio vaticana}. LilyPond stellt unterschiedliche Custos-Symbole für 
-die unterschiedlichen Notationsstile zur Verfügung.
-
-Damit Custodes angezeigt werden, muss ein @internalsref{Custos_engraver} 
-im @internalsref{Staff}-Kontext gefordert werden. Der Aufruf folgt im Rahmen 
-des Layout-Kontextes, wie das folgende Beispiel zeigt.
-
-@example
-\layout @{
-  \context @{
-    \Staff
-    \consists Custos_engraver
-    Custos \override #'style = #'mensural
-  @}
-@}
-@end example
-
-Das Ergebnis sieht ungefähr folgendermaßen aus:
-
-@lilypond[quote,ragged-right]
-\score {
-{
-  a'1
-  \override Staff.Custos #'style = #'mensural
-  \break
-  g'
-}
-\layout {
-  \context { \Staff \consists Custos_engraver }
-  }
-}
-@end lilypond
-
-Das Custos-Zeichen wird von der @code{style}-Eigenschaft ausgewählt. Die 
-unterstützten Stile sind: @code{vaticana}, @code{medicaea}, @code{hufnagel}
-und @code{mensural}. Sie werden im folgenden Fragment demonstriert.
-
-@lilypond[quote,ragged-right,fragment]
-\new Lyrics \lyricmode {
-  \markup { \column {
-    \typewriter "vaticana"
-    \line { " " \musicglyph #"custodes.vaticana.u0" }
-  } }
-  \markup { \column {
-    \typewriter "medicaea"
-    \line { " " \musicglyph #"custodes.medicaea.u0" }
-  }}
-  \markup { \column {
-    \typewriter "hufnagel"
-    \line { " " \musicglyph #"custodes.hufnagel.u0" }
-  }}
-  \markup { \column {
-    \typewriter "mensural"
-    \line { " " \musicglyph #"custodes.mensural.u0" }
-  }}
-}
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{Custos}.
-
-Examples:
-@lsr{ancient,custodes@/.ly}.
-
-
-@node Divisiones
-@subsection Divisiones
-
-@cindex divisio
-@cindex divisiones
-@cindex finalis
-
-Eine @emph{divisio} (Plural: @emph{divisiones}; Latein: @qq{Teilung}) ist ein 
-Symbol des Notensystemkontextes, das benutzt wird, um Phrasierung und 
-Abschnitte im Gregorianischen Choral anzuzeigen. Die musikalische Bedeutung 
-von @emph{divisio minima}, @emph{divisio maior} und @emph{divisio maxima} kann 
-beschrieben werden als kurze, mittlere und lange Pause, ungefähr wie die 
-Atemzeichen aus dem Abschnitt @ref{Breath marks}. Das @emph{finalis}-Zeichen 
-bezeichnet nicht nur das Ende eines Chorals, sondern wird auch oft innerhalb 
-eines Antiphons/Responsoriums benutzt, um das Ende eines Abschnitts anzuzeigen.
-
-Divisiones können benutzt werden, indem die Datei @file{gregorian@/-init@/.ly}
-in die Quelldatei eingefügt wird. Hier sind die entsprechenden Definitionen 
-schon abgelegt, so dass es genügt, die Befehle @code{\divisioMinima}, 
-@code{\divisioMaior}, @code{\divisioMaxima} und @code{\finalis} an den 
-entsprechenden Stellen zu schreiben. Einige Editionen verwenden eine 
-@emph{virgula} oder @emph{caesura} anstelle der divisio minima. Darum findet 
-sich in der Datei @file{gregorian@/-init@/.ly} auch eine Definition für 
-@code{\virgula} und @code{\caesura}.
-
-@lilypondfile[quote,ragged-right]{divisiones.ly}
-
-@refcommands
-
-@funindex \virgula
-@code{\virgula},
-@funindex \caesura
-@code{\caesura},
-@funindex \divisioMinima
-@code{\divisioMinima},
-@funindex \divisioMaior
-@code{\divisioMaior},
-@funindex \divisioMaxima
-@code{\divisioMaxima},
-@funindex \finalis
-@code{\finalis}.
-
-@seealso
-
-In diesem Handbuch: @ref{Breath marks}.
-
-Programmreferenz: @internalsref{BreathingSign}.
-
-Beispiele: @lsr{expressive,breathing-sign.ly}.
-
-@node Ligatures
-@subsection Ligatures
-
-@cindex Ligaturen
-
-@c TODO: Should double check if I recalled things correctly when I wrote
-@c down the following paragraph by heart.
-
-Eine Ligatur ist ein graphisches Symbol das wenigstens zwei unterschiedliche 
-Noten darstellt. Ligaturen treten ursprünglich in Manuskripten des 
-Gregorianischen Chorals auf, um auf- oder absteigende Notensequenzen zu 
-notieren.
-
-Ligaturen werden eingegeben, indem die dazugehörigen Noten zwischen
-@code{\[} und @code{\]} eingeschlossen werden. Einige Ligaturstile benötigen 
-zusätzliche Syntax für eine bestimmte Ligatur. In der Standardeinstellung
-setzt der @internalsref{LigatureBracket} ganz einfach eckige Klammern über 
-die Noten der Ligatur.
-
-@lilypond[quote,ragged-right,verbatim]
-\transpose c c' {
-  \[ g c a f d' \]
-  a g f
-  \[ e f a g \]
-}
-@end lilypond
-
-Um einen gestimmten Ligaturstil auszuwählen, muss ein entsprechender 
-Ligatur-Engraver zum Stimmkontext hinzugefügt werden, wie in den folgenden 
-Abschnitten erklärt wird. Nur weiße Mensuralligaturen sind unterstützt -- mit 
-Einschränkungen.
-
-
-@refbugs
-
-Ligaturen benötigen von klassischer Notation unterschiedliche Platzaufteilung, 
-was sie aber noch nicht können. Darum ist fast immer zu viel Platz zwischen 
-Ligaturen und Zeilenumbrüche sind ungenügend. Text lässt sich auch nicht 
-richtig an Ligaturen ausrichten.
-
-Akzidenzien dürfen nicht innerhalb von einer Ligatur gedruckt werden, sondern 
-müssen gesammelt und vor der Ligatur ausgegeben werden.
-
-Die Syntax verwendet immer noch den verworfenen Infix-Stil (@code{\[ 
-musik. Ausdr. \]}). Für die Konsistenz soll dies geändert werden in den 
-Postfix-Stil (@code{Note\[ ... Note\]}). Alternativ kann die Datei 
-@file{gregorian@/-init@/.ly} eingefügt werden, die eine Scheme-Funktion
-@example
-\ligature @var{musik. Ausdr.}
-@end example
-mit der selben Wirkung zur Verfügung stellt und stabil zu sein scheint.
-
-@menu
-* White mensural ligatures::    
-* Gregorian square neumes ligatures::  
-@end menu
-
-@node White mensural ligatures
-@subsubsection White mensural ligatures
-
-@cindex Mensuralligaturen
-@cindex Weiße Mensuralligaturen
-@cindex Ligaturen, weiße Mensuralnotation
-
-Begrenzte Unterstützung für Ligaturen der weißen Mensuralnotation.
-
-Um weiße Mensuralligaturen zu benutzen, muss innerhalb des Layout-Blocks 
-im @internalsref{Voice}-Kontext der @internalsref{Mensural_ligature_engraver}
-aktiviert werden und gleichzeitig der 
-@internalsref{Ligature_bracket_engraver} (der die Klammern über den Noten 
-setzt) entfernt werden, wie im Beispiel.
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \remove Ligature_bracket_engraver
-    \consists Mensural_ligature_engraver
-  @}
-@}
-@end example
-
-Zusätzlich zu diesen Einstellungen gibt es keine eigenen Befehle, die die 
-Form einer Ligatur bestimmen. Die Form wird vielmehr aus Tonhöhen und 
-Tondauern der in Klammern gesetzten Noten geschlossen. Diese 
-Herangehensweise erfordert einige Eingewöhnung, hat aber den großen 
-Vorteil, dass der musikalische Inhalt der Ligatur dem Programm bekannt ist.
-Das ist nicht nur notwendig für korrekte MIDI-Ausgabe, sondern erlaubt 
-es auch, automatische Transkriptionen von Ligaturen anzufertigen.
-
-Eine Datei kann zum Beispiel so aussehen:
-
-@example
-\set Score.timing = ##f
-\set Score.defaultBarType = "empty"
-\override NoteHead #'style = #'neomensural
-\override Staff.TimeSignature #'style = #'neomensural
-\clef "petrucci-g"
-\[ c'\maxima g \]
-\[ d\longa c\breve f e d \]
-\[ c'\maxima d'\longa \]
-\[ e'1 a g\breve \]
-@end example
-@lilypond[quote,ragged-right]
-\score {
-  \transpose c c' {
-    \set Score.timing = ##f
-    \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'neomensural
-    \override Staff.TimeSignature #'style = #'neomensural
-    \clef "petrucci-g"
-    \[ c'\maxima g \]
-    \[ d\longa c\breve f e d \]
-    \[ c'\maxima d'\longa \]
-    \[ e'1 a g\breve \]
-  }
-  \layout {
-    \context {
-      \Voice
-      \remove Ligature_bracket_engraver
-      \consists Mensural_ligature_engraver
-    }
-  }
-}
-@end lilypond
-
-Wenn der @internalsref{Ligature_bracket_engraver} nicht durch den
-@internalsref{Mensural_ligature_engraver} ersetzt wird, werden die Noten 
-wie folgt ausgegeben:
-
-@lilypond[quote,ragged-right]
-\transpose c c' {
-  \set Score.timing = ##f
-  \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'neomensural
-  \override Staff.TimeSignature #'style = #'neomensural
-  \clef "petrucci-g"
-  \[ c'\maxima g \]
-  \[ d\longa c\breve f e d \]
-  \[ c'\maxima d'\longa \]
-  \[ e'1 a g\breve \]
-}
-@end lilypond
-
-@refbugs
-
-Die horizontale Positionierung ist sehr schlecht.
-
-@node Gregorian square neumes ligatures
-@subsubsection Gregorian square neumes ligatures
-
-@cindex Quadratische Neumenligaturen
-@cindex Gregorianische quadratische Neumenligaturen
-@cindex Ligaturen der quadratischen Neumennoation
-
-Beschränkte Unterstützung für gregorianische Quadratneumen-Ligaturen 
-(nach dem Stil der Editio Vaticana) ist vorhanden. Die wichtigsten 
-Ligaturen können schon gesetzt werden, aber wichtige Eigenschaften 
-anspruchsvoller Typographie wie horizontale Ausrichtung von mehreren 
-Ligaturen, korrekte Silbenpositionierung und richtiger Umgang mit 
-Versetzungszeichen fehlen noch.
-
-Die folgende Tabelle enthält die erweiterte Neumenliste des zweiten Bands des 
- Antiphonale Romanum (@emph{Liber Hymnarius}), 
-1983 von den Mönchen von Solesmes herausgegeben.
-
-@multitable @columnfractions .4 .2 .2 .2
-
-@item
-@b{Neuma aut@*
-Neumarum Elementa}
-@tab
-@b{Figurae@*
-Rectae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Auctae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Deminutae}
-
-@c TODO: \layout block is identical in all of the below examples.
-@c Therefore, it should somehow be included rather than duplicated all
-@c the time. --jr
-
-@c why not make identifiers in ly/engraver-init.ly? --hwn
-
-@c Because it's just used to typeset plain notes without
-@c a staff for demonstration purposes rather than something
-@c special of Gregorian chant notation. --jr
-
-@item
-@code{1. Punctum}
-@tab
-@lilypond[staffsize=26,line-width=1.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum
-    \[ b \]
-    \noBreak s^\markup {"a"} \noBreak
-
-    % Punctum Inclinatum
-    \[ \inclinatum b \]
-    \noBreak s^\markup {"b"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Auctum Ascendens
-    \[ \auctum \ascendens b \]
-    \noBreak s^\markup {"c"} \noBreak
-
-    % Punctum Auctum Descendens
-    \[ \auctum \descendens b \]
-    \noBreak s^\markup {"d"} \noBreak
-
-    % Punctum Inclinatum Auctum
-    \[ \inclinatum \auctum b \]
-    \noBreak s^\markup {"e"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Inclinatum Parvum
-    \[ \inclinatum \deminutum b \]
-    \noBreak s^\markup {"f"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{2. Virga}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Virga
-    \[ \virga b \]
-    \noBreak s^\markup {"g"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{3. Apostropha vel Stropha}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha
-    \[ \stropha b \]
-    \noBreak s^\markup {"h"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha Aucta
-    \[ \stropha \auctum b \]
-    \noBreak s^\markup {"i"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{4. Oriscus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Oriscus
-    \[ \oriscus b \]
-    \noBreak s^\markup {"j"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{5. Clivis vel Flexa}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis vel Flexa
-    \[ b \flexa g \]
-    s^\markup {"k"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis Aucta Descendens
-    \[ b \flexa \auctum \descendens g \]
-    \noBreak s^\markup {"l"} \noBreak
-
-    % Clivis Aucta Ascendens
-    \[ b \flexa \auctum \ascendens g \]
-    \noBreak s^\markup {"m"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Cephalicus
-    \[ b \flexa \deminutum g \]
-    s^\markup {"n"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{6. Podatus vel Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Podatus vel Pes
-    \[ g \pes b \]
-    s^\markup {"o"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens
-    \[ g \pes \auctum \descendens b \]
-    \noBreak s^\markup {"p"} \noBreak
-
-    % Pes Auctus Ascendens
-    \[ g \pes \auctum \ascendens b \]
-    \noBreak s^\markup {"q"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Epiphonus
-    \[ g \pes \deminutum b \]
-    s^\markup {"r"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{7. Pes Quassus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus
-    \[ \oriscus g \pes \virga b \]
-    s^\markup {"s"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus Auctus Descendens
-    \[ \oriscus g \pes \auctum \descendens b \]
-    s^\markup {"t"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{8. Quilisma Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes
-    \[ \quilisma g \pes b \]
-    s^\markup {"u"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes Auctus Descendens
-    \[ \quilisma g \pes \auctum \descendens b \]
-    s^\markup {"v"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{9. Podatus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Initio Debilis
-    \[ \deminutum g \pes b \]
-    s^\markup {"w"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens Initio Debilis
-    \[ \deminutum g \pes \auctum \descendens b \]
-    s^\markup {"x"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{10. Torculus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus
-    \[ a \pes b \flexa g \]
-    s^\markup {"y"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens
-    \[ a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"z"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus
-    \[ a \pes b \flexa \deminutum g \]
-    s^\markup {"A"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{11. Torculus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Initio Debilis
-    \[ \deminutum a \pes b \flexa g \]
-    s^\markup {"B"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens Initio Debilis
-    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"C"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus Initio Debilis
-    \[ \deminutum a \pes b \flexa \deminutum g \]
-    s^\markup {"D"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{12. Porrectus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus
-    \[ a \flexa g \pes b \]
-    s^\markup {"E"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Auctus Descendens
-    \[ a \flexa g \pes \auctum \descendens b \]
-    s^\markup {"F"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Deminutus
-    \[ a \flexa g \pes \deminutum b \]
-    s^\markup {"G"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{13. Climacus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus
-    \[ \virga b \inclinatum a \inclinatum g \]
-    s^\markup {"H"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Auctus
-    \[ \virga b \inclinatum a \inclinatum \auctum g \]
-    s^\markup {"I"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Deminutus
-    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
-    s^\markup {"J"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{14. Scandicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus
-    \[ g \pes a \virga b \]
-    s^\markup {"K"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Auctus Descendens
-    \[ g \pes a \pes \auctum \descendens b \]
-    s^\markup {"L"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Deminutus
-    \[ g \pes a \pes \deminutum b \]
-    s^\markup {"M"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{15. Salicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus
-    \[ g \oriscus a \pes \virga b \]
-    s^\markup {"N"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus Auctus Descendens
-    \[ g \oriscus a \pes \auctum \descendens b \]
-    s^\markup {"O"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{16. Trigonus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Trigonus
-    \[ \stropha b \stropha b \stropha a \]
-    s^\markup {"P"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@tab
-
-@end multitable
-
-Anders als in den meisten Neumennotationssystemen zeigt der Quellcode 
-von LilyPond nicht das typographische Aussehen der Ligatur an, sondern 
-deren musikalischen Inhalt. Der Code  @code{\[ a \pes b
-\flexa g \]} etwa ergibt einen Torculus, der aus drei Punctum-Köpfen besteht, 
-während @code{\[ a \flexa g \pes b \]} einen Porrectus mit einer gekrümmten 
-Flexa und einem einzelnen Punctum ausgibt.
-Es gibt also keinen Befehl, der explizit eine gekrümmte Flexa setzen würde; 
-die Entscheidung, wann diese gesetzt werden soll hängt vielmehr davon ab, 
-welcher musikalische Inhalt dargestellt werden soll. Der Sinn dieser 
-Herangehensweise ist es, den Inhalt von der graphischen Repräsentation zu 
-trennen. Auf diese Art kann mit der gleichen Eingabe ein anderer gregorianischer 
-Stil gesetzt werden, ohne die Notation zu verändern.
-
-Die folgende Tabelle zeigt Code-Fragmente, mit denen die Ligaturen der vorigen 
-Tabelle erstellt werden können. Der Buchstabe in der ersten Spalte jeder Zeile 
-der unteren Tabelle zeigt an, auf welche Ligatur in der vorigen Tabelle sie sich 
-bezieht. In der zweiten Spalte erscheint die Bezeichnung der Ligatur. Die dritte 
-Spalte enthält das Fragment, mit dem die Ligatur erzeugt wurde, wobei 
-@code{g}, @code{a} und @code{b} als Beispieltonhöhen eingesetzt werden.
-
-@multitable @columnfractions .02 .31 .67
-@item
-@b{#}
-@tab
-@b{Name}
-@tab
-@b{Input Language}
-
-@item
-a
-@tab
-Punctum
-@tab
-@code{\[ b \]}
-
-@item
-b
-@tab
-Punctum Inclinatum
-@tab
-@code{\[ \inclinatum b \]}
-
-@item
-c
-@tab
-Punctum Auctum@*
-Ascendens
-@tab
-@code{\[ \auctum \ascendens b \]}
-
-@item
-d
-@tab
-Punctum Auctum@*
-Descendens
-@tab
-@code{\[ \auctum \descendens b \]}
-
-@item
-e
-@tab
-Punctum Inclinatum@*
-Auctum
-@tab
-@code{\[ \inclinatum \auctum b \]}
-
-@item
-f
-@tab
-Punctum Inclinatum@*
-Parvum @tab
-@code{\[ \inclinatum \deminutum b \]}
-
-@item
-g
-@tab
-Virga
-@tab
-@code{\[ \virga b \]}
-
-@item
-h
-@tab
-Stropha
-@tab
-@code{\[ \stropha b \]}
-
-@item
-i
-@tab
-Stropha Aucta
-@tab
-@code{\[ \stropha \auctum b \]}
-
-@item
-j
-@tab
-Oriscus
-@tab
-@code{\[ \oriscus b \]}
-
-@item
-k
-@tab
-Clivis vel Flexa
-@tab
-@code{\[ b \flexa g \]}
-
-@item
-l
-@tab
-Clivis Aucta@*
-Descendens
-@tab
-@code{\[ b \flexa \auctum \descendens g \]}
-
-@item
-m
-@tab
-Clivis Aucta@*
-Ascendens
-@tab
-@code{\[ b \flexa \auctum \ascendens g \]}
-
-@item
-n
-@tab
-Cephalicus
-@tab
-@code{\[ b \flexa \deminutum g \]}
-
-@item
-o
-@tab
-Podatus vel Pes
-@tab
-@code{\[ g \pes b \]}
-
-@item
-p
-@tab
-Pes Auctus@*
-Descendens
-@tab
-@code{\[ g \pes \auctum \descendens b \]}
-
-@item
-q
-@tab
-Pes Auctus@*
-Ascendens
-@tab
-@code{\[ g \pes \auctum \ascendens b \]}
-
-@item
-r
-@tab
-Epiphonus
-@tab
-@code{\[ g \pes \deminutum b \]}
-
-@item
-s
-@tab
-Pes Quassus
-@tab
-@code{\[ \oriscus g \pes \virga b \]}
-
-@item
-t
-@tab
-Pes Quassus@*
-Auctus Descendens @tab
-@code{\[ \oriscus g \pes \auctum \descendens b \]}
-
-@item
-u
-@tab
-Quilisma Pes
-@tab
-@code{\[ \quilisma g \pes b \]}
-
-@item
-v
-@tab
-Quilisma Pes@*
-Auctus Descendens
-@tab
-@code{\[ \quilisma g \pes \auctum \descendens b \]}
-
-@item
-w
-@tab
-Pes Initio Debilis
-@tab
-@code{\[ \deminutum g \pes b \]}
-
-@item
-x
-@tab
-Pes Auctus Descendens@*
-Initio Debilis
-@tab
-@code{\[ \deminutum g \pes \auctum \descendens b \]}
-
-@item
-y
-@tab
-Torculus
-@tab
-@code{\[ a \pes b \flexa g \]}
-
-@item
-z
-@tab
-Torculus Auctus@*
-Descendens
-@tab
-@code{\[ a \pes b \flexa \auctum \descendens g \]}
-
-@item
-A
-@tab
-Torculus Deminutus
-@tab
-@code{\[ a \pes b \flexa \deminutum g \]}
-
-@item
-B
-@tab
-Torculus Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa g \]}
-
-@item
-C
-@tab
-Torculus Auctus@*
-Descendens Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
-
-@item
-D
-@tab
-Torculus Deminutus@*
-Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
-
-@item
-E
-@tab
-Porrectus
-@tab
-@code{\[ a \flexa g \pes b \]}
-
-@item
-F
-@tab
-Porrectus Auctus@*
-Descendens
-@tab
-@code{\[ a \flexa g \pes \auctum \descendens b \]}
-
-@item
-G
-@tab
-Porrectus Deminutus
-@tab
-@code{\[ a \flexa g \pes \deminutum b \]}
-
-@item
-H
-@tab
-Climacus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum g \]}
-
-@item
-I
-@tab
-Climacus Auctus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
-
-@item
-J
-@tab
-Climacus Deminutus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
-
-@item
-K
-@tab
-Scandicus
-@tab
-@code{\[ g \pes a \virga b \]}
-
-@item
-L
-@tab
-Scandicus Auctus@*
-Descendens
-@tab
-@code{\[ g \pes a \pes \auctum \descendens b \]}
-
-@item
-M
-@tab
-Scandicus Deminutus
-@tab
-@code{\[ g \pes a \pes \deminutum b \]}
-
-@item
-N
-@tab
-Salicus
-@tab
-@code{\[ g \oriscus a \pes \virga b \]}
-
-@item
-O
-@tab
-Salicus Auctus Descendens
-@tab
-@code{\[ g \oriscus a \pes \auctum \descendens b \]}
-
-@item
-P
-@tab
-Trigonus
-@tab
-@code{\[ \stropha b \stropha b \stropha a \]}
-@end multitable
-
-Die Ligaturen dieser Liste dienen als begrenzter, aber doch 
-repräsentativer Vorrat an Ligaturbeispielen des Gregorianischen 
-Chorals. Innerhalb der Ligaturbegrenzungen  @code{\[} und 
-@code{\]}  kann jedoch problemlos jede nur mögliche Anzahl an 
-Noten gesetzt werden, und Präfixe wie 
-@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
-usw können nach Belieben gemischt werden. Die Regeln, 
-die der Konstruktion der Ligaturen in den Tabellen zugrunde liegen, 
-werden entsprechend angepasst. Auf diese Weise können unendlich 
-viele Ligaturen gesetzt werden.
-
-Augmentum-Punkte, auch @emph{morae} genannt, werden mit dem 
-Befehl @code{\augmentum} hinzugefügt. @code{\augmentum} ist allerdings 
-als eigene musikalische Funktion gebaut und nicht als ein Notenpräfix. 
-Insofern hat der Befehl in diesem Kontext:
-@code{\augmentum \virga c} keine sichtbaren Auswirkungen. Erst mit 
-@code{\virga \augmentum c} oder @code{\augmentum @{\virga c@}}
-funktionieren beide Befehle. Es ist auch möglich, mit 
-@code{\augmentum @{a g@}} die Schreibweise 
-@code{\augmentum a \augmentum g} abzukürzen.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \[ \augmentum a \flexa \augmentum g \]
-    \augmentum g
-  }
-}
-@end lilypond
-
-@refcommands
-
-Folgende Notenpräfixe sind unterstützt:
-
-@funindex \virga
-@code{\virga},
-@funindex \stropha
-@code{\stropha},
-@funindex \inclinatum
-@code{\inclinatum},
-@funindex \auctum
-@code{\auctum},
-@funindex \descendens
-@code{\descendens},
-@funindex \ascendens
-@code{\ascendens},
-@funindex \oriscus
-@code{\oriscus},
-@funindex \quilisma
-@code{\quilisma},
-@funindex \deminutum
-@code{\deminutum},
-@funindex \cavum
-@code{\cavum},
-@funindex \linea
-@code{\linea}.
-
-Präfixe können kombiniert werden, wenn es hier auch Begrenzungen 
-gibt. Zum Beispiel können die Präfixe @code{\descendens} oder 
-@code{\ascendens} vor einer Note geschrieben werden, aber nicht 
-beide für die selbe Note
-.
-@funindex \pes
-@funindex \flexa
-Zwei benachbarte Noten können mit den @code{\pes} und
-@code{\flexa}-Infixen verbunden werden, um eine steigende bwz. 
-fallende Melodielinie zu notieren.
-
-@funindex \augmentum
-Die musikalische Funktion @code{\augmentum} muss benutzt werden, um 
-augmentum-Punkte hinzuzufügen.
-
-@refbugs
-
-Wenn ein @code{\augmentum}-Punkt am Ende des letzten Systems innerhalb 
-einer Ligatur gesetzt wird, ist er vertikal etwas falsch positioniert. Als 
-Abhilfe kann eine unsichtbare Note (z. B. @code{s8}) als letzte Note im 
-System eingegeben werden.
-
-@code{\augmentum} sollte als Präfix implementiert sein, nicht als eigene 
-musikalische Funktion, so dass @code{\augmentum} mit den anderen 
-Präfixen in arbiträrer Reihenfolge notiert werden kann.
-
-@node Gregorian Chant contexts
-@subsection Gregorian Chant contexts
-
-@cindex VaticanaVoiceContext
-@cindex VaticanaStaffContext
-
-Die vordefinierten Kontexte @code{VaticanaVoiceContext} (für eine 
-gregorianische Stimme) und @code{VaticanaStaffContext} (für ein 
-gregorianisches Notensystem) können eingesetzt werden, um 
-Gregorianischen Choral im Stil der Editio Vaticana zu setzen. Diese 
-Kontexte initialisieren alle relevanten Eigenschaften für das Notensystem 
-und die graphischen Objekte, so dass unmittelbar mit der Notation 
-begonnen werden kann. Siehe das folgende Beispiel:
-
-@lilypond[quote,ragged-right,packed,verbatim]
-\include "gregorian-init.ly"
-\score {
-  <<
-    \new VaticanaVoice = "cantus" {
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \]
-      f \divisioMinima
-      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
-      c' \divisioMinima \break
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
-    }
-    \new Lyrics \lyricsto "cantus" {
-      San- ctus, San- ctus, San- ctus
-    }
-  >>
-}
-@end lilypond
-
-
-@node Mensural contexts
-@subsection Mensural contexts
-
-@cindex MensuralVoiceContext
-@cindex MensuralStaffContext
-
-
-Die vordefinierten Kontexte @code{MensuralVoiceContext} und
-@code{MensuralStaffContext} können eingesetzt werden, um 
-ein Stück in Mensuralnotations zu schreiben. Die Kontexte 
-initialisieren alle relevanten Eigenschaften der Kontexte und 
-graphischen Objekte, so dass unmittelbar mit der Notation begonnen 
-werden kann. Siehe das folgende Beispiel:
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  <<
-    \new MensuralVoice = "discantus" \transpose c c' {
-      \override Score.BarNumber #'transparent = ##t {
-        c'1\melisma bes a g\melismaEnd
-        f\breve
-        \[ f1\melisma a c'\breve d'\melismaEnd \]
-        c'\longa
-        c'\breve\melisma a1 g1\melismaEnd
-        fis\longa^\signumcongruentiae
-      }
-    }
-    \new Lyrics \lyricsto "discantus" {
-      San -- ctus, San -- ctus, San -- ctus
-    }
-  >>
-}
-@end lilypond
-
-@node Musica ficta accidentals
-@subsection Musica ficta accidentals
-
-In der europäischen Musik vor 1600 wurden vom Sänger oftmals 
-chromatische Alterationen erwartet, die nicht notiert wurden. 
-Diese Praxis wird @qq{Musica Ficta} genannt. In modernen 
-Transkripition werden die Versetzungszeichen üblicherweise 
-oberhalb der Noten gesetzt.
-
-@cindex Versetzungszeichen, musica ficta
-@cindex Musica ficta
-
-Unterstützung für solche empfohlenen Versetzungszeichen ist 
-implementiert und kann aktiviert werden, indem die 
-Eigenschaft @code{suggestAccidentals} auf wahr gesetzt wird. 
-Siehe auch das Beispiel.
-
-@funindex suggestAccidentals
-
-@lilypond[verbatim,fragment,relative=1]
-fis gis
-\set suggestAccidentals = ##t
-ais bis
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{Accidental_engraver}-Setzer und das
-@internalsref{AccidentalSuggestion}-Objekt.
-
-@node Figured bass
-@subsection Figured bass
-
-@cindex Basso continuo
-@cindex Generalbass
-@cindex Bezifferter Bass
-
-@c TODO: musicological blurb about FB
-
-
-LilyPond stellt Unterstützung für Generalbassnotation zur Verfügung.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-<<
-  \new Voice { \clef bass dis4 c d ais g fis}
-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
-  }
->>
-@end lilypond
-
-Die Unterstützung besteht aus zwei Teilen: Es gibt einen Eingabe-Modus,
-aktiviert durch den Befehl @code{\figuremode}, in dem Ziffern für den Bass 
-als Nummern eingegeben werden können, und einen Kontext
- @internalsref{FiguredBass}, der dafür sorgt, dass die entsprechenden 
- @internalsref{BassFigure}-Objekte auch erstellt werden.
-
-Im Eingabemodus wird eine Gruppe von Bassziffern mit den Zeichen
-@code{<} and @code{>} begrenzt. Die Dauer wird nach dem @code{>}-Zeichen 
-eingegeben.
-
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { <4 6> }
-@end lilypond
-
-Versetzungszeichen werden durch Anhängen von @code{-}, @code{!} und @code{+}
-hinter die Nummern erreicht. Ein Pluszeichen wird mit dem Befehl @code{\+}
-gesetzt, verminderte Quinten und Septimen mit @code{5/} und @code{7/}.
-
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
-@end lilypond
-
-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}.
-
-@example
-< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
-@end lilypond
-
-Es ist auch möglich, Vortsetzungslinien für wiederholte Ziffern zu benutzen.
-
-@lilypond[verbatim,relative=1]
-<<
-  \new Staff {
-    \clef bass
-    c4 c c
-  }
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
-  }
->>
-@end lilypond
-
-@noindent
-In diesem Fall werden wiederholte Ziffern immer durch eine Linie ersetzt.
-
-Der @code{FiguredBass}-Kontext kümmert sich nicht um die aktuelle Basslinie.
-Als Konsequenz müssen eventuell zusätzliche Ziffern eingefügt werden, um 
-Linien unter alle Noten zu erhalten, und die Verwendung von @code{\!}
-kann nötig werden, um zu lange Linien zu stoppen.
-
-@lilypond[relative=1]
-<<
-  \new Voice
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
-  }
-  {
-    \clef bass
-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
-  }
->>
-@end lilypond
-Bei der Benutzung von Linien werden gemeinsame Ziffern immer in die 
-gleiche vertikale Position gesetzt. Wenn dies nicht gewünscht ist, 
-können Pausen (@code{r}) eingefügt werden. Dadurch wird die vorangegangene
-Positionierung aufgehoben. So kann man etwa 
-
-@example
-  <4 6>8 r8
-@end example
-
-@noindent
-anstelle von
-@example
-  <4 6>4
-@end example
-
-@noindent
-schreiben.
-
-Versetzungszeichen und Pluszeichen können vor oder nach den Ziffern stehen, 
-abhängig von den @code{figuredBassAlterationDirection}- und
-@code{figuredBassPlusDirection}-Eigenschaften.
-
-@lilypond
-  \figures {
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
-  }
-@end lilypond
-
-Auch wenn die Unterstützung für bezifferten Bass anscheinend an die 
-Akkord-Notation erinnert, ist sie doch sehr viel einfacher. Der Modus 
-@code{\figuremode} speichert einfach die Ziffern und  der
-@internalsref{FiguredBass}-Kontext gibt sie so aus, wie sie notiert 
-werden. Es gibt also keine Umrechnung von Tonhöhen und die Notation 
-wird in der MIDI-Datei nicht umgesetzt.
-
-Programmintern erstellt die Funktion einfache Textbeschriftung. Somit 
-sind alle Textbeschriftungsbefehle verfügbar, um die Formatierungen zu 
-verändern. So kann zum Beispiel die vertikale Position der Ziffern mit 
-@code{baseline-skip} gesetzt werden.
-
-Bassziffern können auch direkt einem Notensystemkontext (@code{Staff})
-hinzugefügt werden. In diesem Fall wird ihre vertikale Position automatisch 
-bestimmt.
-
-@lilypond[ragged-right,fragment,quote]
-<<
-  \new Staff = someUniqueName
-  \relative c'' {
-    c4 c'8 r8 c,4 c'
-  }
-
-  %% send to existing Staff.
-  \context Staff = someUniqueName 
-  \figuremode {
-    <4>4 <6 10>8 s8
-    
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
-  }
->>
-@end lilypond
-
-@commonprop
-
-In der Standardeinstellung werden die Bassziffern über den Noten 
-ausgegeben. Um Ziffern unter den Noten zu erhalten, kann der 
-Befehl
-
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
-
-@noindent
-benutzt werden.
-
-
-@refbugs
-
-Wenn Bassziffern über dem Notensystem mit Ergänzungslinien und
-@code{implicitBassFigures}  benutzt werden, kann es vorkommen, dass 
-die Linien vertauscht werden. Besonders kritisch wird es, wenn 
-mehrere Bassziffern sich überschneidende Linien haben. Um dieses 
-Problem zu vermeiden, sollte @code{stacking-dir} 
-im @code{BassFigureAlignment} benutzt werden.
-
-
-@seealso
-
-Programmreferenz: @internalsref{NewBassFigure}-,
-@internalsref{BassFigureAlignment}-, @internalsref{BassFigureLine}-,
-@internalsref{BassFigureBracket}- und
-@internalsref{BassFigureContinuation}-Objekte und der
-@internalsref{FiguredBass}-Kontext.
-
-
-
-@node Other instrument specific notation
-@section Other instrument specific notation
-
-In diesem Abschnitt findet sich zusätzliche instrumentenspezifische
-Information.
-
-@menu
-* Artificial harmonics (strings)::  
-@end menu
-
-@node Artificial harmonics (strings)
-@subsection Artificial harmonics (strings)
-
-@cindex Flageolett
-
-Flageolett-Töne werden mit einem anderen Notenkopfstil notiert. 
-Sie werden eingegeben, indem die Flageolettnote mit dem 
-Befehl @code{\harmonic} markiert wird.
-
-@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
-<c g'\harmonic>4
-@end lilypond
-
diff --git a/Documentation/de/user/introduction.itely b/Documentation/de/user/introduction.itely
index 31d8296df2..4fe434deb7 100644
--- a/Documentation/de/user/introduction.itely
+++ b/Documentation/de/user/introduction.itely
@@ -731,6 +731,8 @@ In diesem Buch wird erklärt, wie man das Programm LilyPond erlernt; mit
 einfachen Begriffen werden einige Schlüsselkonzepte erklärt. Die Kapitel 
 sollten hintereinander gelsen werden.
 
+@c we need to completely rewrite this once GDP is finished.  -gp
+@ignore
 @itemize @bullet
 
 @item
@@ -847,6 +849,7 @@ Der
 ist ein vollständiger Index.
 
 @end itemize
+@end ignore
 
 
 @subheading Program usage
diff --git a/Documentation/de/user/lilypond-book.itely b/Documentation/de/user/lilypond-book.itely
index 66f9dc2c17..ba6504b469 100644
--- a/Documentation/de/user/lilypond-book.itely
+++ b/Documentation/de/user/lilypond-book.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/lilypond-learning.tely b/Documentation/de/user/lilypond-learning.tely
new file mode 100644
index 0000000000..7c21b1cea5
--- /dev/null
+++ b/Documentation/de/user/lilypond-learning.tely
@@ -0,0 +1,222 @@
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: e9a620b6e7e1c0a1bf39b7063ff1744ad61efb08
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+@setfilename lilypond-learning.info
+@settitle GNU LilyPond Learning Manual
+@documentencoding UTF-8
+@documentlanguage de
+
+@iftex
+@afourpaper
+@c don't replace quotes with directed quotes
+@tex
+\gdef\SETtxicodequoteundirected{Foo}
+\gdef\SETtxicodequotebacktick{Bla}
+@end tex
+@end iftex
+
+
+@c don't remove this comment.
+@ignore
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
+@omfdescription User manual of the LilyPond music engraving system
+@omftype program usage
+@omfcategory Applications|Publishing
+@omflanguage German
+@end ignore
+
+
+@ifhtml
+Dieses Dokument ist auch als
+@uref{source/Documentation/user/lilypond-learning.de.pdf,PDF} und als 
+@uref{source/Documentation/user/lilypond-learning-big-page.html,eine große Seite}
+(in Englisch) verfügbar.
+@end ifhtml
+
+
+@c  This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
+
+
+@finalout
+
+@c TRANSLATE ME
+@titlepage
+@title LilyPond
+@subtitle Das Notensatzprogramm
+@titlefont{Learning Manual}
+@author Das LilyPond-Entwicklerteam
+
+
+Copyright @copyright{} 1999--2007 bei den Autoren
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{Die Übersetzung der folgenden Lizenzanmerkung ist zur Orientierung 
+für Leser, die nicht Englisch sprechen. Im rechtlichen Sinne ist aber 
+nur die englische Version gültig.}
+
+@quotation
+Es ist erlaubt, dieses Dokument unter den Bedingungen der
+GNU Free Documentation Lizenz (Version 1.1 oder
+spätere, von der Free Software Foundation publizierte Versionen), 
+zu kopieren, verbreiten und/oder
+zu verändern. Eie Kopie der Lizenz ist im Abschnitt ``GNU
+Free Documentation License'' angefügt.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+
+@vskip 20pt
+
+@lilypond[ragged-right]
+\score {
+  \context Lyrics {
+    \override Score.RehearsalMark #'self-alignment-X = #LEFT
+    \override Score.RehearsalMark #'font-size = #-2
+    \mark #(ly:export (string-append
+      "(For LilyPond version " (lilypond-version) ")"))
+    s2
+  }
+  \layout {
+    indent = 0.0\pt
+  }
+}
+@end lilypond
+
+@end titlepage
+
+@copying
+Copyright @copyright{} 1999--2007 bei den Autoren
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{Die Übersetzung der folgenden Lizenzanmerkung ist zur Orientierung 
+für Leser, die nicht Englisch sprechen. Im rechtlichen Sinne ist aber 
+nur die englische Version gültig.}
+
+@quotation
+Es ist erlaubt, dieses Dokument unter den Bedingungen der
+GNU Free Documentation Lizenz (Version 1.1 oder
+spätere, von der Free Software Foundation publizierte Versionen), 
+zu kopieren, verbreiten und/oder
+zu verändern. Eie Kopie der Lizenz ist im Abschnitt ``GNU
+Free Documentation License'' angefügt.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end copying
+
+@c TRANSLATE ME
+@ifnottex
+This file documents GNU LilyPond program usage.
+
+Copyright @copyright{} 1999--2007 bei den Autoren
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{Die Übersetzung der folgenden Lizenzanmerkung ist zur Orientierung 
+für Leser, die nicht Englisch sprechen. Im rechtlichen Sinne ist aber 
+nur die englische Version gültig.}
+
+@quotation
+Es ist erlaubt, dieses Dokument unter den Bedingungen der
+GNU Free Documentation Lizenz (Version 1.1 oder
+spätere, von der Free Software Foundation publizierte Versionen), 
+zu kopieren, verbreiten und/oder
+zu verändern. Eie Kopie der Lizenz ist im Abschnitt ``GNU
+Free Documentation License'' angefügt.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end ifnottex
+
+@c TRANSLATE ME
+@ifnottex
+@node Top
+@top GNU LilyPond --- learning manual
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
+
+@c TRANSLATE ME
+This is the learning manual for GNU LilyPond 2.11.x series.
+@ifhtml
+(See the bottom of this page for the exact version number).
+@end ifhtml
+
+@cindex web site
+@cindex URL
+
+More information can be found at
+@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
+of this and other documentation.
+
+@menu
+* Preface::                        Vorwort.
+* Introduction::                   Was, warum und wie.
+* Tutorial::                       Eine Übung zur Einführung.
+* Putting it all together::        Genauere Erklärungen zu LilyPonds
+Eigenschaften.
+* Working on LilyPond projects::   Benutzung des Programms im
+wirklichen Leben.
+* Tweaking output::                Einleitung in die Beeinflussung des
+Notenbilds.
+
+Anhänge
+
+* GNU Free Documentation License:: License of this document.
+* LilyPond index::
+@end menu
+@end ifnottex
+
+@contents
+
+
+@include macros.itexi
+
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include putting.itely
+@include working.itely
+@include tweaks.itely
+
+@include fdl.itexi
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
+
+@bye
diff --git a/Documentation/de/user/lilypond.tely b/Documentation/de/user/lilypond.tely
index 71e417c755..113af6d51a 100644
--- a/Documentation/de/user/lilypond.tely
+++ b/Documentation/de/user/lilypond.tely
@@ -1,6 +1,6 @@
 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 3121682025660b6c85fbf3f22bb9cd8396699ad1
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -216,21 +216,11 @@ finden sich Kopien dieser und anderer Dokumentationsdateien.
 
 @include dedication.itely
 
+@c TRANSLATE ME
 @menu
-Handbuch zum Lernen
-
-* Preface::                        Vorwort.
-* Introduction::                   Was, warum und wie.
-* Tutorial::                       Eine Übung zur Einführung.
-* Putting it all together::        Genauere Erklärungen zu LilyPonds Eigenschaften.
-* Working on LilyPond projects::   Benutzung des Programms im wirklichen Leben.
-* Tweaking output::                Einleitung in die Beeinflussung des Notenbilds.
-
-Alles über die Notation
-
-* Basic notation::                 Grundlegende Notation.
-* Instrument-specific notation::   Spezielle Notation.
-* Advanced notation::              Seltener eingesetzte Notation.
+* Musical notation::               Musical notation.
+* Specialist notation::            Notation which is only used for
+specicific purposes.
 * Changing defaults::              Das Notenbild verfeinern.
 * Non-musical notation::           Alles, was nicht Musiknotation ist.
 * Spacing issues::                 Anzeige der Ausgabe auf dem Papier.
@@ -253,16 +243,10 @@ Anhänge
 
 
 @include macros.itexi
-@include preface.itely
-@include introduction.itely
-@include tutorial.itely
-@include putting.itely
-@include working.itely
-@include tweaks.itely
-
-@include basic-notation.itely
-@include instrument-notation.itely
-@include advanced-notation.itely
+
+@include notation.itely
+@include specialist.itely
+
 @include changing-defaults.itely
 @include non-music.itely
 @include spacing.itely
diff --git a/Documentation/de/user/macros.itexi b/Documentation/de/user/macros.itexi
index 512a1b66d7..c8dfedb9e4 100644
--- a/Documentation/de/user/macros.itexi
+++ b/Documentation/de/user/macros.itexi
@@ -1,29 +1,75 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 3db3697bb5109201192c9cecdd2e4b7a5520421a
+    Translation of GIT committish: d30aabb4adc9e13c7a5a99a22230e97a0f164255
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c **** all formats ****
 
-@macro refbugs
-@noindent
-@subsubheading Bugs
+@c   ***** Displaying text *****
 
+@c we need this since @q{\} doesn't work with makeinfo 4.8 --
+@c say @q{@value{backslash}} instead
+@set backslash \
+
+@c to get decent quotes in `foo' and ``foo''
+@c  these need to be split up so that "@qq{foo}." looks nice.  :(
+@iftex
+@macro q{TEXT}
+@quotesinglbase{}\TEXT\`
 @end macro
 
-@macro moreinfo
-@subheading More information
+@macro qq{TEXT}
+@quotedblbase{}\TEXT\``
+@end macro
+@end iftex
 
+
+@ifinfo
+@macro q{TEXT}
+‚\TEXT\‘
 @end macro
 
-@macro seealso
-@noindent
-@subsubheading See also
+@macro qq{TEXT}
+„\TEXT\“
+@end macro
+@end ifinfo
+
+
+@ifhtml
+@macro q{TEXT}
+@html
+&sbquo;\TEXT\&lsquo;
+@end html
+@end macro
+
+@macro qq{TEXT}
+@html
+&bdquo;\TEXT\&ldquo;
+@end html
+@end macro
+@end ifhtml
+
+
+@ifdocbook
+@macro q{TEXT}
+@html
+&sbquo;\TEXT\&lsquo;
+@end html
+@end macro
 
+@macro qq{TEXT}
+@html
+&bdquo;\TEXT\&ldquo;
+@end html
 @end macro
+@end ifdocbook
+
+
+
+
+@c   **** Headings in a doc subsection ****
 
 @macro refcommands
 @noindent
@@ -31,104 +77,109 @@
 
 @end macro
 
-@macro context{NAME}
-@vindex \NAME\
-@code{\NAME\}@c should use internalsref
+@macro commonprop
+@noindent
+@subsubheading Commonly tweaked properties
+
 @end macro
 
-@macro refcommand{WHAT}
-@vindex \WHAT\
-@code{\WHAT\}
+@macro seealso
+@noindent
+@subsubheading See also
+
 @end macro
 
-@macro commonprop
+@macro refbugs
 @noindent
-@subsubheading Commonly tweaked properties
+@subsubheading Bugs
 
 @end macro
 
-@macro funindex {WORD}
-@findex \WORD\
-@kindex \WORD\
+
+@macro context{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}@c should use internalsref
 @end macro
 
+@macro refcommand{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
+@end macro
+
+@macro funindex {TEXT}
+@findex \TEXT\
+@kindex \TEXT\
+@end macro
 
 
-@c  *** Macros with variable output ***
+
+@c   **** Links and references ****
 
 @c usage: @lsr{ancient,custodes.ly}
-@macro lsr{DIR,NAME}
+@macro lsr{DIR,TEXT}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
+@uref{source/input/lsr/\DIR\/collated-files.html#\TEXT\,@file{\DIR\/\TEXT\}}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\/\NAME\}
+@file{\DIR\/\TEXT\}
 @end ifnothtml
 @end macro
 
 @macro lsrdir{DIR}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
+@uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\}
+@file{\DIR\}
 @end ifnothtml
 @end macro
 
 
 
 
-@macro arrow{}
-@iftex
-@tex $\\Rightarrow$ @end tex@c
-@end iftex
-@ifhtml
-@html
-&rarr;
-@end html
-@end ifhtml
-@ifinfo
--->
-@end ifinfo
-@end macro
-
-
-@c we need this since @q{\} doesn't work with makeinfo 4.8 --
-@c say @q{@value{backslash}} instead
-@set backslash \
-
+@c  Definitions for references:
+@c     @internalsref
+@c     @rglos
+@c     @rprogram
+@c     @ruser
+@c     @rlearning
 
 @ifhtml
 @c ***** HTML *****
 
 @c makeinfo-4.7 encodes html names, which means that nodes that
 @c contain nonalphanum characters will be broken links on the website.
-@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
+@c @uref{../lilypond-internals/\TEXT\.html,\TEXT\}@c
 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
 @c better than a broken link.
-@c @inforef{\NAME\,,lilypond-internals}@c
+@c @inforef{\TEXT\,,lilypond-internals}@c
 @c using @ref without punctuation is OK without for formats other than info
 
 @ifset bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals-big-page}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals-big-page}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary-big-page}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary-big-page}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program-big-page}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program-big-page}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-big-page}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-big-page}
+@end macro
+
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning-big-page}
 @end macro
 
 @end ifset
@@ -136,47 +187,32 @@
 
 @ifclear bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
-@end macro
-
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@end ifclear
-
-
-@c usage: @inputfileref{input@/regression,FILE@/-NAME.ly}
-@macro inputfileref{DIR,NAME}
-@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent German quotes in `foo'
-@macro q{TEXT}
-@html
-&sbquo;\TEXT\&lsquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
-@c to get decent German quotes in ``foo''
-@macro qq{TEXT}
-@html
-&bdquo;\TEXT\&ldquo;
-@end html
-@end macro
+@end ifclear
 
 @end ifhtml
 
@@ -184,40 +220,29 @@
 @ifdocbook
 @c ***** DOCBOOK-XML *****
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-
-
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent German quotes in `foo'
-@macro q{TEXT}
-@html
-&sbquo;\TEXT\&lsquo;
-@end html
-@end macro
-
-@c to get decent German quotes in ``foo''
-@macro qq{TEXT}
-@html
-&bdquo;\TEXT\&ldquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifdocbook
@@ -233,31 +258,22 @@
 
 @macro rglos{NAME}
 @vindex \NAME\
-@inforef{\NAME\,,,music-glossary}
+@inforef{\NAME\,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
-@end macro
-
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
-@end macro
-
-@macro usermanref{NAME}
-@inforef{\NAME\}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-‚\TEXT\‘
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-„\TEXT\“
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifinfo
@@ -266,58 +282,29 @@
 @c **** TEX ****
 @iftex
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@code{\NAME\}
-@end macro
-
-@macro rglos {NAME}
-@vindex \NAME\
-@code{\NAME\}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro seeinternals{NAME}
-Programmreferenz, @internalsref{\NAME\}
+@macro rglos {TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro usermanref{NAME}
-Benutzerhandbuch, @internalsref{\NAME\}
+@macro rprogram{TEXT}
+Programmbenutzung, @internalsref{\TEXT\}
 @end macro
 
-@macro rprogram{NAME}
-Programmbenutzung, @internalsref{\NAME\}
-@end macro
-
-@alias ruser=usermanref
-
-@c to get decent German quotes in `foo'
-@macro q{TEXT}
-@quotesinglbase{}\TEXT\`
+@macro ruser{TEXT}
+Benutzerhandbuch, @internalsref{\TEXT\}
 @end macro
 
-@c to get decent German quotes in ``foo''
-@macro qq{TEXT}
-@quotedblbase{}\TEXT\``
+@macro rlearning{TEXT}
+Handbuch zum Lernen, @internalsref{\TEXT\}
 @end macro
 
 @end iftex
 
 
-@ifnottex
-@c **** not TEX ****
-
-@macro seeinternals{NAME}
-@internalsref{\NAME\}
-@end macro
-
-@ifnotinfo
-@macro usermanref{NAME}
-@ref{\NAME\}
-@end macro
-@end ifnotinfo
-
-@end ifnottex
-
-
 @c EOF
-
diff --git a/Documentation/de/user/non-music.itely b/Documentation/de/user/non-music.itely
index 44b43a07b0..4f7ddd485a 100644
--- a/Documentation/de/user/non-music.itely
+++ b/Documentation/de/user/non-music.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
@@ -27,19 +27,14 @@ UNTRANSLATED NODE: IGNORE ME
 UNTRANSLATED NODE: IGNORE ME
 
 @menu 
-* File structure (introduction)::
 * File structure::
 * A single music expression::
 * Multiple scores in a book::
 * Extracting fragments of notation::
 * Including LilyPond files::
 * Text encoding::
+* Different editions from one source::
 @end menu 
-@node File structure (introduction)
-@subsection File structure (introduction)
-
-UNTRANSLATED NODE: IGNORE ME
-
 @node File structure
 @subsection File structure
 
@@ -70,6 +65,11 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
+@node Different editions from one source
+@subsection Different editions from one source
+
+UNTRANSLATED NODE: IGNORE ME
+
 @node Titles and headers
 @section Titles and headers
 
diff --git a/Documentation/de/user/notation.itely b/Documentation/de/user/notation.itely
new file mode 100644
index 0000000000..93fddb97cc
--- /dev/null
+++ b/Documentation/de/user/notation.itely
@@ -0,0 +1,33 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Musical notation
+@chapter Musical notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Pitches::            Writing and display the pitches of notes.
+* Rhythms::            Writing and displaying the durations of notes.
+* Expressive marks::   Adding expression to notes.
+* Repeats::            Repeat music.
+* Simultaneous notes:: More than one note at once.
+* Staff notation::     Displaying staves.
+* Educational use::    Special notation to increase legibility.
+* Text::               Adding text to scores.
+@end menu
+
+@include pitches.itely
+@include rhythms.itely
+@include expressive.itely
+@include repeats.itely
+@include simultaneous.itely
+@include staff.itely
+@include educational.itely
+@include text.itely
+
diff --git a/Documentation/de/user/percussion.itely b/Documentation/de/user/percussion.itely
new file mode 100644
index 0000000000..4dbdeb598b
--- /dev/null
+++ b/Documentation/de/user/percussion.itely
@@ -0,0 +1,334 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Percussion
+@section Percussion
+
+@menu 
+* TODO percussion node fix::
+@end menu
+
+@node TODO percussion node fix
+@subsection TODO percussion node fix
+
+Rhythmusnotation wird vor allem für Schlaginstrumente eingesetzt, 
+aber hiermit kann auch der Rhythmus einer Melodie dargestellt werden.
+
+@menu
+* Showing melody rhythms::      
+* Entering percussion::         
+* Percussion staves::           
+* Ghost notes::                 
+@end menu
+
+
+@node Showing melody rhythms
+@unnumberedsubsubsec Showing melody rhythms
+
+Manchmal soll nur der Rhythmus einer Melodie dargestellt werden. Das 
+erreicht man mit einem Schlagzeug-Notensystem. Alle Tonhöhen werden 
+auf eine Linie reduziert und das System hat auch nur eine einzige 
+Linie.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new RhythmicStaff {
+  \time 4/4
+  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
+}
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{RhythmicStaff}.
+
+
+@node Entering percussion
+@unnumberedsubsubsec Entering percussion
+
+@cindex Percussion
+@cindex Drums
+@cindex Schlagzeug
+
+
+Schlagzeug-Noten können im @code{\drummode}-Modus notiert werden, 
+der sich ähnlich verhält wie der Standardmodus für die Noteneingabe. 
+Jedes Schlagzeuginstrument hat einen langen Namen und eine Abkürzung,
+und beide können nebeneinander benutzt werden.
+
+@lilypond[quote,ragged-right,verbatim]
+\drums {
+  hihat hh bassdrum bd
+}
+@end lilypond
+
+Eine vollständige Liste der Schlagwerk-Bezeichnungen findet sich in 
+der Datei @file{ly/@/drumpitch@/-init@/.ly}.
+@c TODO: properly document this.
+
+@seealso
+
+Programmreferenz: @internalsref{note-event}.
+
+@node Percussion staves
+@unnumberedsubsubsec Percussion staves
+@cindex Perkussion
+@cindex Schlagzeug
+
+Ein Schlagzeug-System besteht überlicherweise aus einem Notensystem 
+mit mehreren Linien, wobei jede Linie ein bestimmtes Schlagzeug-Instrument 
+darstellt.
+
+Um die Noten darstellen zu können, müssen sie sich innerhalb von 
+einem @internalsref{DrumStaff}- und einem 
+@internalsref{DrumVoice}-Kontext befinden.
+
+@lilypond[quote,ragged-right,verbatim]
+up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
+down = \drummode { bassdrum4 snare8 bd r bd sn4 }
+  \new DrumStaff <<
+    \new DrumVoice { \voiceOne \up }
+    \new DrumVoice { \voiceTwo \down }
+  >>
+@end lilypond
+Das Beispiel zeigt ausdrücklich definierte mehrstimmige Notation. Die 
+Kurznotation für mehrstimmige Musik, wie sie im Abschnitt 
+@ref{Basic polyphony} beschrieben wird, kann auch verwendet werden, 
+wenn die @internalsref{DrumVoice} (Schlagzeugstimmen) am Anfang explizit 
+initialisiert werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new DrumStaff <<
+  \new DrumVoice = "1" { s1 *2 }
+  \new DrumVoice = "2" { s1 *2 }
+  \drummode {
+    bd4 sn4 bd4 sn4
+    <<
+      { \repeat unfold 16 hh16 }
+      \\
+      { bd4 sn4 bd4 sn4 }
+    >>
+  }
+>>
+@end lilypond
+
+Es gibt auch weitere Layout-Einstellungen. Um diese zu verwenden, 
+muss die Eigenschaft @code{drumStyleTable} im 
+@internalsref{DrumVoice}-Kontext entsprechend eingestellt werden. 
+Folgende Variablen sind vordefiniert:
+
+@table @code
+@item drums-style
+Das ist die Standardeinstellung. Hiermit wird ein typisches 
+Schlagzeug-System auf fünf Notenlinien erstellt.
+
+@lilypond[quote,line-width=10.0\cm]
+nam = \lyricmode {
+  cymc cyms cymr hh hhc hho hhho hhp
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
+mus = \drummode {
+  cymc cyms cymr hh hhc hho hhho hhp \break
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
+\score {
+  << \new DrumStaff \with {
+       \remove Bar_engraver
+       \remove Time_signature_engraver
+       \override Stem #'transparent = ##t
+       \override Stem #'Y-extent-callback = ##f
+       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
+     } \mus
+     \new Lyrics \nam
+  >>
+  \layout {
+    \context {
+      \Score
+      \override LyricText #'font-family = #'typewriter
+      \override BarNumber #'transparent =##T
+    }
+  }
+}
+@end lilypond
+Die Schlagzeugdefinitionen unterstützen sechs unterschiedliche 
+Tom Toms. Falls eine geringere Anzahl verwendet wird, kann man 
+einfach die Tom Toms auswählen, deren Notation man haben will. 
+Tom Toms auf den drei mittleren Linien werden mit den Bezeichnungen 
+@code{tommh}, @code{tomml} und @code{tomfh} notiert.
+
+@item timbales-style
+Hiermit werden Timbale auf zwei Notenlinien gesetzt.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { timh ssh timl ssl cb }
+mus = \drummode { timh ssh timl ssl cb s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+    \override StaffSymbol #'line-count = #2
+    \override StaffSymbol #'staff-space = #2
+    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
+    drumStyleTable = #timbales-style
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item congas-style
+Hiermit werden Congas auf zwei Linien gesetzt.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
+mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    drumStyleTable = #congas-style
+    \override StaffSymbol #'line-count = #2
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item bongos-style
+Hiermit werden Bongos auf zwei Linien gesetzt.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
+mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override StaffSymbol #'line-count = #2
+    drumStyleTable = #bongos-style
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item percussion-style
+Dieser Stil ist für alle einfachen Perkussionsinstrumente auf einer Notenlinie.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
+mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
+
+<<
+  \new DrumStaff \with{
+    \remove Bar_engraver
+    drumStyleTable = #percussion-style
+    \override StaffSymbol #'line-count = #1
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+@end table
+
+Wenn ihnen keine der vordefinierten Stile gefällt, können Sie auch eine 
+eigene Liste der Positionen und Notenköpfe am Anfang ihrer Datei erstellen.
+
+@lilypond[quote,ragged-right,verbatim]
+#(define mydrums '(
+         (bassdrum     default   #f         -1)
+         (snare        default   #f         0)
+         (hihat        cross     #f         1)
+         (pedalhihat   xcircle   "stopped"  2)
+         (lowtom       diamond   #f         3)))
+up = \drummode { hh8 hh hh hh hhp4 hhp }
+down = \drummode { bd4 sn bd toml8 toml }
+
+\new DrumStaff <<
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+  \new DrumVoice { \voiceOne \up }
+  \new DrumVoice { \voiceTwo \down }
+>>
+@end lilypond
+
+
+@seealso
+
+Init-Dateien: @file{ly/@/drumpitch@/-init@/.ly}.
+
+Programmreferenz: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
+
+@refbugs
+
+Weil in den allgemeinen MIDI-Definitionen kein Rimshot enthalten ist, 
+wird sidestick für diesen Zweck benutzt.
+
+
+@c FIXME: check name -tr
+@node Ghost notes
+@unnumberedsubsubsec Ghost notes
+
+Geisternoten für Schlagzeug und Perkussion können mit dem 
+Klammer- (@code{\parenthesize})-Befehl, beschrieben in @ref{Parentheses}, 
+erstellt werden. Im Standard-@code{\drummode}-Modus ist aber 
+das @code{Parenthesis_engraver}-Plugin nicht automatisch enthalten. 
+Sie müssen das Plugin ausdrücklich in den Kontext-Definitionen 
+laden, wie im Abschnitt @ref{Changing context properties on the fly}
+detailliert beschrieben.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\new DrumStaff \with {
+  \consists "Parenthesis_engraver"
+} <<
+  \context DrumVoice  = "1"  { s1 *2 }
+  \context DrumVoice  = "2" { s1 *2 }
+  \drummode {
+    <<
+      {
+        hh8[ hh] <hh sn> hh16
+        < \parenthesize sn > hh < \parenthesize
+        sn > hh8 <hh sn> hh
+      } \\ {
+        bd4 r4 bd8 bd r8 bd
+      }
+    >>
+  }
+>>
+@end lilypond
+
+@noindent
+Um jede Klammer-Definition (@code{\parenthesize}) müssen
+ zusätzlich die spitzen 
+Klammern für Akkorde (@code{< >}) gesetzt werden.
+
+
diff --git a/Documentation/de/user/piano.itely b/Documentation/de/user/piano.itely
new file mode 100644
index 0000000000..f2bc655a4d
--- /dev/null
+++ b/Documentation/de/user/piano.itely
@@ -0,0 +1,290 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Piano music
+@section Piano music
+
+@menu 
+* TODO piano node fix::
+@end menu
+
+@node TODO piano node fix
+@subsection TODO piano node fix
+
+Ein Pianosystem besteht aus zwei normalen Notensystemen, die durch 
+eine Klammer verbunden sind. Die Systeme sind verhältnismäßig 
+unabhängig, aber zeitweise können Stimmen zwischen den Systemen 
+wechseln. Die gleiche Notation wird auch für andere Tasteninstrumente 
+sowie Harfen verwendet. Das Klaviersystem (mit dem Befehl 
+@internalsref{PianoStaff} erstellt) ist speziell dazu geschaffen, Stimmen 
+zwischen den Systemen wechseln zu lassen. In diesem Abschnitt werden 
+das Klaviersystem und andere Eigenheiten der Pianonotation besprochen.
+
+@menu
+* Automatic staff changes::     
+* Manual staff switches::       
+* Pedals::                      
+* Staff switch lines::          
+* Cross staff stems::           
+@end menu
+
+@refbugs
+
+Dynamische Zeichen werden nicht automatisch mittig notiert, aber 
+dafür gibt es Lösungen, vgl. die 
+@q{piano centered dynamics}-Vorlage in @ref{Piano templates}.
+
+@cindex Hälse über zwei Systeme
+@cindex System querende Hälse
+@cindex Abstand zwischen Systemen in Klaviernoten
+
+
+@node Automatic staff changes
+@unnumberedsubsubsec Automatic staff changes
+@cindex Automatischer Systemwechsel
+
+Stimmen können angewiesen werden, automatisch zwischen dem 
+oberen und unteren System zu wechseln. Die Syntax hierfür lautet:
+
+@quotation
+@example
+\autochange @dots{}@var{Noten}@dots{}
+@end example
+@end quotation
+
+@noindent
+Damit werden zwei Notensysteme innerhalb des aktiven Klaviersystems 
+erstellt, die @qq{oben} (@code{up}) und @qq{unten} (@code{down}) genannt 
+werden. Auf dem unteren System wird als Standard der Bassschlüssel 
+gesetzt.
+
+Ein @code{\relative}-Abschnitt, der sich außerhalb des 
+@code{\autochange}-Abschnittes befindet, hat keinen Einfluss auf die 
+Notenhöhen der @var{Noten}. Es muss also bei Bedarf ein 
+weiterer @code{\relative}-Befehl innerhalb des Abschnittes 
+benutzt werden.
+
+@quotation
+@example
+\autochange \relative @dots{} @dots{}
+@end example
+@end quotation
+
+Der Wechsel wird automatisch besierend auf der Tonhöhe der Note 
+vorgenommen (als Wechselpunkt gilt das eingestrichene C). Dabei 
+wird die Richtung auch über Pausen hinweg im Voraus bestimmt.
+
+@lilypond[quote,verbatim,ragged-right]
+\new PianoStaff
+  \autochange \relative c'
+  {
+    g4 a b c d r4 a g
+  }
+@end lilypond
+
+
+@seealso
+
+Im Handbuch: @ref{Manual staff switches}.
+
+Programmreferenz: @internalsref{AutoChangeMusic}.
+ 
+@refbugs
+
+Der Systemwechsel wird nicht immer an der optimalen Stelle vorgenommen. 
+Für hohe Qualität muss der Wechsel mit der Hand eingegeben werden.
+
+@code{\autochange} kann sich nicht innerhalb einer @code{\times}-Umbegung 
+befinden.
+
+@node Manual staff switches
+@unnumberedsubsubsec Manual staff switches
+
+@cindex manuelle Systemwechsel
+@cindex Systemwechsel, manuell
+@cindex Wechsel des Systems, manuell
+
+Stimmen können mit dem Befehl
+@example
+\change Staff = @var{Systembezeichnung} @var{Noten}
+@end example
+
+@noindent
+manuell erzielt werden. Die Zeichenkette @var{Systembezeichnung} ist die 
+Bezeichnung des Systems. Damit wird die aktuelle Stimme vom aktuellen 
+System zu dem System mit der @var{Systembezeichnung} gewechselt. 
+Üblicherweise ist die Systembezeichnung @code{"up"} oder
+@code{"down"}.  Dieses System (@context{Staff}), auf das verweisen wird, 
+muss auch wirklich existieren, weshalb die Aufstellung eines Klaviersystems 
+dann überlicherweise damit beginnt, die Systeme zu benennen. Hierbei können 
+natürlich beliebige Namen vergeben werden.
+
+@example
+<<
+  \new Staff = "up" @{
+    \skip 1 * 10  % @emph{keep staff alive}
+    @}
+  \new Staff = "down" @{
+    \skip 1 * 10  % @emph{idem}
+    @}
+>>
+@end example
+
+@noindent
+Die einzelnen Stimmen werden mit dem @code{Voice}-Befehl 
+daraufhin eingefügt.
+
+@example
+\context Staff = down
+  \new Voice @{ @dots{} \change Staff = up @dots{} @}
+@end example
+
+
+@node Pedals
+@unnumberedsubsubsec Pedals
+@cindex Pedalbezeichnung
+
+Klaviere haben Pedale, mit denen die Klangeigenschaften beeinflusst werden 
+können. Normalerweise besitzt ein Klavier drei Pedale, das linke oder 
+Haltepedal, das rechte oder Una-corda-Pedal und das Sostenuto-Pedal.
+
+Spielanweisungen für das Pedal können durch die Befehle 
+@code{\sustainDown} (linkes Pedal), @code{\sustainUp} (linkes Pedal 
+hoch), @code{\unaCorda} (rechtes Pedal), @code{\treCorde} (rechtes 
+Pedal hoch), @code{\sostenutoDown} (mittleres Pedal) und 
+@code{\sostenutoUp} (mittleres Pedal hoch) anschließend an eine 
+Note oder einen Akkord notiert werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c'4\sustainDown c'4\sustainUp
+@end lilypond
+
+Die Ausgabe kann verändert werden, indem der Wert 
+What is printed can be modified by setting @code{pedal@var{X}Strings},
+where @var{X} is one of the pedal types: @code{Sustain},
+@code{Sostenuto} or @code{UnaCorda}.  Refer to
+@internalsref{SustainPedal} in the program reference for more
+information.
+
+Pedalbenutzung kann auch durch eine Anzahl von Klammern angezeigt 
+werden, wenn die @code{pedalSustainStyle}-Eigenschaft 
+auf Klammern (eng. bracket) gesetzt wird.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'bracket
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+Eine dritte Art der Pedalnotation besteht aus einer Mischung von Text 
+und den Pedalklammern. Sie wird durch setzen von 
+@code{pedalSustainStyle} auf @code{mixed} erreicht. 
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'mixed
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+Die Einstellungen für linkes @c ?
+und mittleres Pedal ist überlicherweise ein @code{#'text}-Stil. Für das 
+mittlere Pedal ist der gemischte Stil voreingestellt.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+Die Erscheinung der Pedal-Klammer kann mit den Eigenschaften 
+@code{edge-width}, @code{edge-height} und @code{shorten-pair} des
+@code{PianoPedalBracket}-Objekts verändert werden (siehe 
+@internalsref{PianoPedalBracket} in der Programmreferenz). Zum 
+Beispiel kann die Klammer bis zum rechten Einde eines Notenkopfes 
+verlängert werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+@seealso
+
+Im Handbuch: @ref{Laissez vibrer ties}
+
+@node Staff switch lines
+@unnumberedsubsubsec Staff switch lines
+
+
+@cindex Stimmkreuzung
+@cindex Systemwechsel von Stimmen
+@cindex Wechsel zwischen Systemen
+
+@funindex followVoice
+
+Immer, wenn eine Stimme von einem Klaviersystem zu dem anderen 
+wechselt, kann automatisch eine Linie zur Verdeutlichung des 
+Stimmenverlaufs ausgegeben werden. Das wird erreicht, indem 
+@code{followVoice} aktiviert wird:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \new Staff="one" {
+    \set followVoice = ##t
+    c1
+    \change Staff=two
+    b2 a
+  }
+  \new Staff="two" { \clef bass \skip 1*2 }
+>>
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{VoiceFollower}.
+
+@refcommands
+
+@funindex \showStaffSwitch
+@code{\showStaffSwitch},
+@funindex \hideStaffSwitch
+@code{\hideStaffSwitch}.
+
+
+@node Cross staff stems
+@unnumberedsubsubsec Cross staff stems
+
+Akkorde, die über zwei Systeme reichen, können erstellt werden,
+indem die Länge der Hälse im unteren System vergrößert wird, 
+bis sie zum oberen System hinauf reichen bzw. umgekehrt bei 
+Hälsen, die nach unten zeigen.
+
+@lilypond[ragged-right,verbatim,quote]
+stemExtend = {
+  \once \override Stem #'length = #10
+  \once \override Stem #'cross-staff = ##t
+}
+noFlag = \once \override Stem #'flag-style = #'no-flag
+\new PianoStaff <<
+  \new Staff {
+    \stemDown \stemExtend
+    f'4
+    \stemExtend \noFlag
+    f'8
+  }
+  \new Staff {
+    \clef bass
+    a4 a8
+  }
+>>
+@end lilypond
+
+
+
diff --git a/Documentation/de/user/pitches.itely b/Documentation/de/user/pitches.itely
new file mode 100644
index 0000000000..0eef30ac6b
--- /dev/null
+++ b/Documentation/de/user/pitches.itely
@@ -0,0 +1,740 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Pitches
+@section Pitches
+
+This section discusses how to specify the pitch of notes.
+
+@menu
+* Writing pitches::             
+* Changing multiple pitches::   
+* Displaying pitches::          
+@end menu
+
+
+@node Writing pitches
+@subsection Writing pitches
+
+Into text.
+
+@menu
+* Normal pitches::              
+* Accidentals::                 
+* Cautionary accidentals::      
+* Micro tones::                 
+* Note names in other languages::  
+@end menu
+
+@node Normal pitches
+@unnumberedsubsubsec Normal pitches
+
+@cindex Tonhöhenbezeichnungen
+
+
+Tonhöhenbezeichnungen werden durch Kleinbuchstaben von
+@code{a} bis @code{g} angegeben.@footnote{Die Benutzung deutscher 
+Notenbezeichnungen mit der Unterscheidung von b und h ist 
+auch möglich, siehe @ref{Note names in other languages}.}
+Eine aufsteigende C-Dur-Tonleiter wird wie folgt notiert:
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef bass
+c d e f g a b c'
+@end lilypond
+
+Die Notenbezeichnung @code{c} schreibt als Note ein kleines 
+C, eine Oktave unter dem eingestrichenen C.
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef treble
+c1
+\clef bass
+c1
+@end lilypond
+
+@funindex '
+@funindex ,
+
+Zusätzliche Oktavbestimmung wird mit einer Anzahl von 
+Apostrophen (@q{'}) oder Kommas (@q{,}) vorgenommen. 
+Jeder Apostroph erhöht die Note um eine Oktave, jedes 
+Komma erniedrigt sie um eine Oktave.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\clef treble
+c' c'' e' g d'' d' d c
+\clef bass
+c, c,, e, g d,, d, d c
+@end lilypond
+
+Eine alternative Methode gibt am Anfang die Oktave vor, 
+innerhalb derer die Noten gesetzt werden, dabei werden 
+unter Umständen weniger Oktavangaben (@code{'} oder @code{,})
+benötigt. Siehe auch 
+@ref{Relative octaves}.
+
+
+@node Accidentals
+@unnumberedsubsubsec Accidentals
+
+@cindex Notenbezeichnungen, Deutsch
+@cindex Notenbezeichnungen, Standard
+@cindex Vorzeichen, Deutsch
+@cindex Versetzungszeichen
+@cindex Akzidenzen
+
+Ein Kreuz wird eingegeben, indem man @code{-is} an die 
+Notenbezeichnung hängt, ein b durch @code{-es}. Doppelkreuze 
+und Doppel-Bs werden durch Hinzufügen von @code{-isis} und 
+@code{-eses} hinter die Notenbezeichnung erzeugt.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a2 ais a aes
+a2 aisis a aeses
+@end lilypond
+
+@noindent
+Auch die deutschen Varianten @code{as} für @code{aes} und
+@code{es} für @code{ees} sind erlaubt. Im Unterschied zum 
+Deutschen ist aber @code{bes} die einzige Version für den Ton
+B, während his als @code{bis} geschrieben werden muss. Das kann
+aber auch verändert werden, siehe @ref{Note names in other languages}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a2 as e es
+@end lilypond
+
+Ein Auflösungszeichen macht die Wirkung eines Kreuzes oder Bs
+rückgängig. Diese Auflösungszeichen werden jedoch nicht 
+als Suffix einer Tonhöhenbezeichnung eingegeben, sondern
+sie ergeben sich (automatisch) aus dem Kontext, wenn die 
+nicht alterierte Notenbezeichnung eingegeben wird.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a4 aes a2
+@end lilypond
+
+Die Sequenz @code{d e f} wird interpretiert als: @qq{Setze eine
+ D-Noten, eine E-Note und eine F-Note,} unabhängig von den 
+ Vorzeichen der Tonart. Mehr Information über den Unterschied 
+ zwischen musikalischem Inhalt und der Präsentation dieses 
+ Inhalts siehe @rlearning{Accidentals and key signatures}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+\key d \major
+d e f g
+d e fis g
+@end lilypond
+
+
+@commonprop
+
+Den Satzregeln für den Notensatz folgend wird ein Auflösungszeichen 
+dann ausgegeben, wenn eine vorhergehende Akzidenz rückgängig 
+gemacht werden soll. Um dieses Verhalten zu ändern, muss 
+@code{\set Staff.extraNatural = ##f} eingesetzt werden.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+ceses4 ces cis c
+\set Staff.extraNatural = ##f
+ceses4 ces cis c
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{LedgerLineSpanner},
+@internalsref{NoteHead}.
+
+
+@node Cautionary accidentals
+@unnumberedsubsubsec Cautionary accidentals
+
+@cindex Versetzungszeichen, Erinnerung
+@cindex Versetzungszeichen, Warnung
+@cindex Vorzeichen, Erinnerung
+@cindex Vorzeichen in Klammern
+@cindex Erinnerungsvorzeichen
+@cindex Warnungsvorzeichen
+@funindex ?
+@cindex Klammern um Vorzeichen
+@funindex !
+
+Normalerweise werden Versetzungszeichen automatisch gesetzt, aber
+sie können auch manuell hinzugefügt werden. Ein erinnerndes 
+Versetzungszeichen kann erzwungen werden, indem man ein Ausrufungszeichen
+(@code{!}) hinter die Notenbezeichnung schreibt. Ein warnendes 
+Versetzungszeichen (also ein Vorzeichen in Klammern) wird durch Anfügen 
+eines Fragezeichens (@code{?}) erstellt. Mit diesen zusätzlichen 
+Zeichen kann man sich auch Auflösungszeichen ausgeben lassen.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+cis cis cis! cis? c c? c! c
+@end lilypond
+
+
+@seealso
+Die automatische Setzung von Versetzungszeichen kann auf viele Arten 
+beeinflusst werden. Mehr Information dazu siehe
+ @ref{Automatic accidentals}.
+
+
+@node Micro tones
+@unnumberedsubsubsec Micro tones
+
+@cindex Vierteltöne
+@cindex Vorzeichen, Vierteltöne
+@cindex Versetzungszeichen, Vierteltöne
+@cindex Mikrotöne
+
+Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
+@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
+Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
+aufsteigende Serie vom kleinen C.
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Mikrotöne werden auch in die MIDI-Dateien geschrieben.
+
+
+
+@refbugs
+
+Es gibt keine allgemein anerkannten Standards für die 
+Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
+Symbol entspricht also keinem Standard.
+
+
+@node Note names in other languages
+@unnumberedsubsubsec Note names in other languages
+
+Es gibt vordefinierte Bezeichnungen für die Notenbezeichnungen in anderen 
+Sprachen als Englisch. Um sie zu benutzen, muss nur die 
+entsprechende Datei für die jeweilige Sprache eingefügt werden.
+Zum Beispiel fügt man mit @code{\include "deutsch.ly"} die 
+Notendefinitionen für die deutsche Sprache am Anfang der Datei 
+hinzu. In der Tabelle sind die existierenden Definitionen
+mit den dazugehörigen Notenbezeichnungen dargestellt.
+
+
+@c  Should this be made into a multitable?
+@cindex Notenbezeichnungen, andere Sprachen
+@example
+               Notenbezeichnungen              Kreuz       B         Doppelkreuz   Doppel-B
+
+nederlands.ly  c   d   e   f   g   a   bes b   -is         -es       -isis         -eses
+english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat  -ss/-x/       -ff/
+                                                                     -sharpsharp   -flatflat
+deutsch.ly     c   d   e   f   g   a   b   h   -is         -es       -isis         -eses
+norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es  -ississ/-isis -essess/-eses
+svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess      -ississ       -essess
+italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b        -dd           -bb
+catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b        -dd/-ss       -bb
+espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b        -ss           -bb
+@end example
+
+@noindent
+Auf Holländisch, Deutsch, Norwegisch und Schwedisch (u. a.) werden die 
+Erniedrigungen von @q{a} wie @code{aes} und @code{aeses} zu
+@code{as} und @code{ases} (oder auch @code{asas}) zusammengezogen.
+In manchen Sprachen sind nur diese Kurzformen definiert (das gilt auch für die 
+Endungen der Vierteltöne).
+
+@noindent
+Bestimmte Musik verwendet Alterationen, die Bruchteile von den 
+@qq{üblichen} Kreuzen oder Bs sind. Die Notenbezeichnungen für 
+Vierteltöne für die verschiedenen Sprachen sind in der folgenden 
+Tabelle aufgeführt. Die Präfixe @qq{Semi-} und @qq{Sesqui-} bedeuten 
+@qq{halb} bzw. @qq{eineinhalb}. Für Norwegisch, Schwedisch, Katalanisch 
+und Spanisch sind noch keine eigenen Namen definiert.
+@c What about Turkish Maquam music and similar microtonal systems?
+@c
+@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
+@c is actually misleading since the alteration is in fact one and a half
+@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
+
+@example
+               Notenbezeichnungen              Semi-   Semi-  Sesqui-  Sesqui-
+                                               kreuz   B      Kreuz    B
+
+nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
+english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
+deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
+norsk.ly       c   d   e   f   g   a   b   h   
+svenska.ly     c   d   e   f   g   a   b   h   
+italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
+catalan.ly     do  re  mi  fa  sol la  sib si  
+espanol.ly     do  re  mi  fa  sol la  sib si  
+@end example
+
+
+@node Changing multiple pitches
+@subsection Changing multiple pitches
+
+@menu
+* Relative octaves::            
+* Octave check::                
+* Transpose::                   
+@end menu
+
+@node Relative octaves
+@unnumberedsubsubsec Relative octaves
+
+@cindex Relativ
+@cindex Relative Oktavbestimmung
+@funindex \relative
+
+Oktaven werden angegeben, indem man @code{'} oder @code{,}
+an die Notenbezeichnung hängt. Wenn Sie schon existierende 
+Musik kopieren, passiert es schnell, eine Note aus Versehen 
+in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
+finden. Der relative Oktaven-Modus verhindert solche Fehler,
+indem mögliche Fehler stark vergrößert werden: ein einziger 
+Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
+
+Die Syntax des Befehls lautet:
+
+@example
+\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+oder:
+
+@example
+\relative @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
+wenn sie nicht extra angegeben wird.
+
+Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
+wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
+benutzt werden, wird als Intervall zwischen der Noten und der 
+vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
+Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
+übermäßige Quarte ist also ein kleineres Intervall als eine 
+verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
+
+Die Oktavversetzungszeichen @code{'} und @code{,} können 
+hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
+oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
+ein Referenzton angegeben werden, der als die vorhergehende Note 
+für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
+wird. Wenn dieser Referenzton nicht angeben wird, wird das 
+eingestrichene C verwendet.
+
+So funktioniert der relative Modus:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
+die größer als eine Quarte sind.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
+des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
+bestimmen.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
+
+Die relative Veränderung wirkt sich nicht auf 
+Transposition (@code{\transpose}),
+Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
+aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
+verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
+Klammern des @code{\transpose}-Befehls gesetzt werden.
+
+@node Octave check
+@unnumberedsubsubsec Octave check
+
+@cindex Oktavenüberprüfung
+
+Durch Oktavenüberprüfung können Fehler einfacher entdeckt werden:
+nach einer Note kann @code{=}@var{Apostrophe} geschrieben werden, 
+womit angezeigt wird, was ihre wirkliche Oktave sein soll. Im 
+folgenden Beispiel
+
+@example
+\relative c'' @{ c='' b=' d,='' @}
+@end example
+
+@noindent
+erzeugt das @code{d} eine Warnung, weil ein @code{d''} erwartet
+wird (denn  zwischen @code{b'} und @code{d''} befindet sich nur eine Terz), 
+aber ein @code{d'} ist notiert. In der Notenausgabe wird die 
+Oktave zu  @code{d''} korrigiert und die nächste Note wird 
+relativ zu  @code{d''} anstelle von @code{d'} errechnet.
+
+Es gibt auch eine Oktavenüberprüfung, die keine sichtbare Ausgabe 
+erzeugt. Die Syntax:
+
+@example
+\octave @var{Tonhöhe}
+@end example
+
+Hierdurch wird überprüft, dass die @var{Tonhöhe} (ohne Apostroph) 
+der @var{Tonhöhe} (mit Apostroph) entspricht. Wenn sie 
+sich nicht entsprechen, wird eine Warnung ausgegeben und die 
+Oktave wird korrigiert. Die @var{Tonhöhe} wird nicht als 
+Note gesetzt.
+
+Im nächsten Beispiel erzeugt die erste Überprüfung keine Warnung, 
+weil das @code{e} (im relativen Modus) innerhalb einer Quarte 
+zum @code{a'} liegt. Die zweite Überprüfung aber erzeugt eine 
+Warnung, weil das @code{e} mehr als eine Quarte vom 
+@code{b'} entfernt ist. Die Warnung wird ausgegeben und die Oktave wird 
+korrigiert, so dass auch die folgenden Noten wieder in der 
+richtigen Oktave gesetzt werden.
+
+
+@example
+\relative c' @{
+  e
+  \octave a'
+  \octave b'
+@}
+@end example
+
+Die Oktave einer Note, der eine Oktavüberprüfung angefügt wurde, 
+wird in Hinsicht auf die vorherige Note bestimmt. Im nächsten 
+Fragment ist die letzte Note ein @code{a'}. 
+Die Oktavenüberprüfung stellt fest, dass zwischen e' und kleinem
+b eine Quarte Abstand ist und dass die folgende Note, ein a', sich
+wieder innerhalb einer Quarte vom e' aus befindet. Die Überprüfung
+gibt also einen Erfolgswert zurück und die Notenausgabe wird nicht
+verändert.
+
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' {
+  e
+  \octave b
+  a
+}
+@end lilypond
+
+
+@node Transpose
+@unnumberedsubsubsec Transpose
+
+@cindex Transposition
+@cindex Transponieren
+@funindex \transpose
+
+Ein musikalischer Ausdruck kann mit dem Befehl @code{\transpose}
+transponiert werden. Die Syntax lautet:
+@example
+\transpose @var{von} @var{nach} @var{mus. Ausdruck}
+@end example
+
+Das bedeutet, dass der @var{mus. Ausdruck} um das Intervall zwischen den 
+Tonhöhen @var{von} und @var{nach} transponiert wird: Jede Note, die die 
+Tonhöhe @var{von} hat, wird in die Tonhöhe @var{nach} umgewandelt.
+
+So kann z. B. ein Stück in D-Dur, wenn es für den Sänger etwas zu
+tief ist, mit dem Befehl
+
+@example
+\transpose d e @dots{}
+@end example
+
+@noindent
+nach E-Dur transponiert werden.
+
+Oder eine Violinstimme, die so notiert wird, wie sie erklingt, 
+soll von einer A-Klarinette gespielt werden. Hier ist ein 
+klingendes A als C notiert, so dass alles also eine kleine
+Terz tiefer erklingt, als es notiert ist. Für die Erzeugung der 
+Klarinettenstimme muss folgender Befehl verwendet werden:
+
+@example
+\transpose a c @dots{}
+@end example
+
+@code{\transpose} unterscheidet enharmonische Verwechslungen: sowohl 
+@code{\transpose c cis} als auch @code{\transpose c des} transponieren 
+die Musik einen Halbton nach oben. Aber die erste Version gibt als 
+Versetzungszeichen Kreuze aus, die zweite dagegen B-Versetzungszeichen.
+
+@lilypond[quote,ragged-right,verbatim]
+mus = { \key d \major cis d fis g }
+\new Staff {
+  \clef "F" \mus
+  \clef "G"
+  \transpose c g' \mus
+  \transpose c f' \mus
+}
+@end lilypond
+
+@code{\transpose} kann auch benutzt werden, um die geschriebenen 
+Noten eines transponierenden Instruments zu notieren. Tonhöhen in 
+LilyPond werden üblicherweise notiert, wie sie erklingen, aber 
+man kann auch eine andere Tonart verwenden. Noten einer 
+B-Trompete, die mit einem klingenden D anfangen, könnte man also 
+auch so eingeben:
+
+@example
+\transpose c bes @{ e4 @dots{} @}
+@end example
+
+Um die Noten dann wiederum als Trompetenstimme zu drucken (also einen 
+Ganzton tiefer, als sie erklingen), setzt man einfach um sie herum 
+eine weitere Transposition:
+
+@example
+\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
+@end example
+
+
+@seealso
+
+Programmreferenz: @internalsref{TransposedMusic}.
+
+Beispiel: @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
+
+
+@refbugs
+
+Wenn Sie sowohl  @code{\transpose} als auch @code{\relative} 
+benutzen wollen, muss die @code{\transpose}-Umgebung sich 
+außerhalb der @code{\relative}-Umgebung befinden, da 
+@code{\relative} keine Auswirkungen auf Noten hat, die sich 
+innerhalb von @code{\transpose} befinden.
+
+
+@node Displaying pitches
+@subsection Displaying pitches
+
+@menu
+* Clef::                        
+* Key signature::               
+* Ottava brackets::             
+* Instrument transpositions::   
+@end menu
+
+@node Clef
+@unnumberedsubsubsec Clef
+
+@funindex \clef
+
+Der Schlüssel zeigt eine bestimme Systemlinie an und markiert die 
+Tonhöhe, mit der sie korrespondiert. Ein Schlüssel wird mit dem 
+@code{\clef}-Befehl gesetzt.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+{ c''2 \clef alto g'2 }
+@end lilypond
+
+@cindex Notenschlüssel
+@cindex Schlüssel
+@cindex Violinschlüssel
+@cindex Sopranschlüssel
+@cindex Altschlüssel
+@cindex Bratschenschlüssel
+@cindex Tenorschlüssel
+@cindex Bassschlüssel
+@cindex Franz. Violinschlüssel
+@cindex C-Schlüssel
+@cindex Mezzosopranschlüssel
+@cindex Baritonschlüssel
+@cindex Subbasschlüssel
+
+Unterstützt sind folgende Schlüssel:
+
+@multitable @columnfractions .33 .66
+@headitem Schlüssel @tab Lage
+@item @code{treble} (Violinschlüssel) @tab
+G-Schlüssel auf der zweiten Linie
+@item @code{alto, C} (Bratschenschlüssel) @tab
+C-Schlüssel auf der dritten Linie
+@item @code{tenor} (Tenorschlüssel) @tab
+C-Schlüssel auf der vierten Linie
+@item @code{bass, F} (Bassschlüssel) @tab
+F-Schlüssel auf der vierten Linie
+@item @code{french} (Franz. Violinschlüssel)@tab
+G-Schlüssel auf der ersten Linie
+@item @code{soprano} (Sopranschlüssel) @tab
+C-Schlüssel auf der ersten Linie
+@item @code{mezzosoprano}(Mezzosopranschlüssel)  @tab
+C-Schlüssel auf der zweiten Linie
+@item @code{baritone} (Baritonschlüssel) @tab
+C-Schlüssel auf der fünften Linie
+@item @code{varbaritone} (Bariton-F-Schlüssel) @tab
+F-Schlüssel auf der dritten Linie
+@item @code{subbass} (Kontrabassschlüssel) @tab
+F-Schlüssel auf der fünften Linie
+@item @code{percussion} @tab
+Schlagzeugschlüssel
+@item @code{tab} @tab
+Tabulaturschlüssel
+@end multitable
+
+Indem @code{_8} oder @code{^8} an die jeweilige Schlüsselbezeichnung 
+angehängt wird, wird der Schlüssel um eine Oktave nach oben oder unten 
+transponiert, mit @code{_15} oder @code{^15} um zwei Oktaven. 
+Die Schlüsselbezeichnung muss in Anführungszeichen gesetzt werden, 
+wenn sie Unterstriche oder Zahlen enthält, siehe Beispiel:
+
+@cindex Tenorschlüssel, Chor
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\clef "G_8" c4
+@end lilypond
+
+
+@commonprop
+
+Dem Befehl @code{\clef "treble_8"} entspricht die entsprechende separate 
+Einstellung von @code{clefGlyph},
+@code{clefPosition} (womit y- und x-Position des Schlüssel bestimmt werden),
+@code{middleCPosition} und @code{clefOctavation}. Ein Schlüssel wird 
+immer dann ausgegeben, wenn eine dieser Eigenschaften sich ändert. Im 
+nächsten Beispiel werden Möglichkeiten gezeigt, die Eigenschaften manuell 
+zu setzen.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \set Staff.clefGlyph = #"clefs.F"
+  \set Staff.clefPosition = #2
+  c'4
+  \set Staff.clefGlyph = #"clefs.G"
+  c'4
+  \set Staff.clefGlyph = #"clefs.C"
+  c'4
+  \set Staff.clefOctavation = #7
+  c'4
+  \set Staff.clefOctavation = #0
+  \set Staff.clefPosition = #0
+  c'4
+  \clef "bass"
+  c'4
+  \set Staff.middleCPosition = #4
+  c'4
+}
+@end lilypond
+
+
+@seealso
+
+Handbuch: @ref{Grace notes}.
+
+Programmreferenz: @internalsref{Clef}.
+
+
+@node Key signature
+@unnumberedsubsubsec Key signature
+
+@cindex Tonart
+@cindex Vorzeichen
+@funindex \key
+
+Die Vorzeichen zeigen die Tonart an, in welcher ein Stück notiert ist. 
+Es handelt sich um eine Anzahl von Alterationszeichen (Kreuzen oder 
+Bs) am Beginn jedes Notensystems.
+
+Das Setzen und Ändern von Tonarteinstellungen wird mit dem 
+@code{\key}-Befehl vorgenommen.
+
+@example
+@code{\key} @var{Tonhöhe} @var{Art}
+@end example
+
+@funindex \minor
+@funindex \major
+@funindex \minor
+@funindex \ionian
+@funindex \locrian
+@funindex \aeolian
+@funindex \mixolydian
+@funindex \lydian
+@funindex \phrygian
+@funindex \dorian
+@cindex Kirchentonarten
+@cindex Modus
+
+Der Wert @var{Art} sollte entweder @code{\major} oder @code{\minor} 
+sein, um Moll oder Dur der @var{Tonhöhe} zu erhalten. Es können auch 
+Modusbezeichnungen für Kirchentonarten verwendet werden: @code{\ionian} 
+(Ionisch), @code{\locrian} (Locrisch), @code{\aeolian} (Aeolisch), 
+@code{\mixolydian} (Mixolydisch), @code{\lydian} (Lydisch),
+@code{\phrygian} (Phrygisch) und @code{\dorian} (Dorisch).
+
+Dieser Befehl ändert die Kontexteigenschaft 
+@code{Staff.keySignature}. Vorzeichen, die nicht dem Standard entsprechen, 
+können manuell mit dieser Eigenschaft eingegeben werden.
+
+Versetzungszeichen und Vorzeichen können am Anfang etwas verwirrend sein, 
+da unveränderte Noten je nach Tonart ein Auflösungszeichen bekommen 
+können (Beispiel). Mehr Information in den Abschnitten  @ref{Accidentals} 
+oder @rlearning{Accidentals and key signatures}.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\key g \major
+f1
+fis
+@end lilypond
+
+
+@commonprop
+
+Ein Auflösungszeichen wird gesetzt, um vorhergehende Vorzeichen 
+rückgängig zu machen. Das kann aber unterdrückt werden, indem 
+die @code{Staff.printKeyCancellation}-Eigenschaft angepasst wird.
+
+@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+\set Staff.printKeyCancellation = ##f
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{KeyCancellation},
+@internalsref{KeySignature}.
+
+
+@node Ottava brackets
+@unnumberedsubsubsec Ottava brackets
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Instrument transpositions
+@unnumberedsubsubsec Instrument transpositions
+
+UNTRANSLATED NODE: IGNORE ME
+
diff --git a/Documentation/de/user/programming-interface.itely b/Documentation/de/user/programming-interface.itely
index d0a9631436..782e7de5f5 100644
--- a/Documentation/de/user/programming-interface.itely
+++ b/Documentation/de/user/programming-interface.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/putting.itely b/Documentation/de/user/putting.itely
index ff00db7be2..9097a10fe9 100644
--- a/Documentation/de/user/putting.itely
+++ b/Documentation/de/user/putting.itely
@@ -229,7 +229,7 @@ Quelldateien anzulegen. Für Neulinge kann diese Flexibilität aber
 erst einmal verwirrend sein. In diesem Kapitel soll darum ein Teil 
 dieser Strukturen dargestellt werden, vieles aber zur Vereinfachung 
 auch weggelassen werden. Für eine komplette Beschreibung des Eingabeformats 
-siehe @ref{File structure}.
+siehe @ruser{File structure}.
 
 Die meisten Beispiele in diesem Handbuch sind kleine Schnipsel, wie 
 etwa dieser:
@@ -332,16 +332,16 @@ 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
-@ref{Saving typing with identifiers and functions}.
+@ruser{Saving typing with identifiers and functions}.
 
 Eine komplette Definition des Eingabeformats findet sich
-im Kapitel @ref{File structure}.
+im Kapitel @ruser{File structure}.
 
 
 @node Score is a single musical expression
 @section Score is a single musical expression
 
-Im vorigen Kapitel, @ref{How LilyPond files work}, 
+Im vorigen Kapitel, @ruser{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 
@@ -358,7 +358,7 @@ von einem einzelnen musikalischen Ausdruck.}
 
 @noindent
 Vielleicht wollen Sie noch einmal 
-@ref{Music expressions explained} überfliegen. In diesem
+@ruser{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 
@@ -470,7 +470,7 @@ lower = @{ @}
 @noindent
 Nochmal: der Bezeichner kann aller möglicher Text sein. Die 
 Einschränkungen sind in
-@ref{File structure} genau aufgelistet.
+@ruser{File structure} genau aufgelistet.
 
 Beim Schreiben (oder Lesen) einer @code{\score}-Umgebung 
 sollte man langsam und sorgfältig vorgehen. Am besten fängt 
@@ -617,11 +617,11 @@ Und mit LilyPond übersetzt:
 
 Tiefer gehende Information darüber, wie Stimmauszüge und Partituren 
 erstellt werden, finden sich im Notationshandbuch, siehe 
-@ref{Orchestral music}.
+@ruser{Orchestral music}.
 
 Das Setzen der Variablen, die das Verhalten von LilyPond beeinflussen 
 (@q{properties}), wird im Kapitel
-@ref{Changing context properties on the fly} besprochen.
+@ruser{Changing context properties on the fly} besprochen.
 
 
 
diff --git a/Documentation/de/user/repeats.itely b/Documentation/de/user/repeats.itely
new file mode 100644
index 0000000000..7a7e1e3d2a
--- /dev/null
+++ b/Documentation/de/user/repeats.itely
@@ -0,0 +1,429 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Repeats
+@section Repeats
+
+Wiederholung ist ein zentrales Konzept in der Musik, und es gibt eine 
+ganze Vielzahl von Notationsmöglichkeiten für Wiederholungen.
+
+@menu
+* Writing repeats::             
+* Other repeats::               
+@end menu
+
+@node Writing repeats
+@subsection Writing repeats
+
+@menu
+* Repeat types::                
+* Repeat syntax::               
+* Manual repeat commands::      
+* Repeats and MIDI::            
+@end menu
+
+@node Repeat types
+@unnumberedsubsubsec Repeat types
+
+@cindex Wiederholungen
+
+Die folgenden Wiederholungsarten sind unterstützt:
+
+@table @code
+@item unfold
+Die wiederholte Musik wird vollständig ausgeschrieben (bzw. gespielt). 
+Hiermit können sehr einfach sich wiederholende Stellen notiert werden. 
+Es ist auch der einzige Wiederholungstyp, der in der MIDI-Ausgabe 
+berücksichtigt wird.
+
+@item volta
+Wiederholungen werden nicht ausgeschrieben, aber alternative Endungen 
+(Volta-Klammern) können bei Bedarf notiert werden. Das ist die übliche 
+Wiederholung für Wiederholungen mit unterschiedlichen Enden. Die 
+Wiederholung wird in der MIDI-Datei nicht berücksichtigt.
+
+
+@item tremolo
+Hiermit können Tremolo-Balken erstellt werden. Sie werden nicht in die 
+MIDI-Datei aufgenommen.
+
+@item percent
+Hiermit können noten- oder taktweise Wiederholungszeichen notiert werden. 
+Sie erinnern and das Prozentzeichen. Auch sie werden nicht in der MIDI-Datei 
+berücksichtigt. Diese Wiederholungen müssen innerhalb eines Stimmen 
+(@code{Voice})-Kontextes erstellt werden.
+
+@end table
+
+
+@node Repeat syntax
+@unnumberedsubsubsec Repeat syntax
+
+@cindex Klammer, Wiederholung
+@cindex Volta
+@cindex Prima volta
+@cindex Seconda volta
+@cindex Zweite Klammer
+@funindex \repeat
+
+LilyPond besitzt eine einzige Syntax für alle unterschiedlichen 
+Wiederholungstypen. Sie lautet:
+
+@example
+\repeat @var{Typ} @var{Wiederholungszähler} @var{Wiederholungsnoten}
+@end example
+
+Wenn Sie unterschiedliche Endungen haben, können Sie diese mit dem 
+Befehl 
+@funindex \alternative notieren, etwa 
+@example
+\alternative @{
+  @var{Klammer1}
+  @var{Klammer2}
+  @var{Klammer3}
+  @dots{}
+@}
+@end example
+
+@noindent
+wobei jede Klammer ein musikalischer Ausdruck ist. Wenn Sie nicht genug 
+unterschiedliche Alternativen für alle Wiederholungen angeben, wird 
+angenommen, dass die erste Alternative mehr als einmal verwendet wird.
+
+Eine typische Wiederholung kann so aussehen:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 { c4 d e f }
+\repeat volta 2 { f e d c }
+@end lilypond
+
+Und mit unterschiedlichen Klammern:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f}
+\alternative { {d2 d} {f f,} }
+@end lilypond
+
+Wiederholungen können mit Auftakten kombiniert werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 e |
+  \repeat volta 4 { c2 d2 | e2 f2 | }
+  \alternative { { g4 g g e } { a a a a | b2. } }
+}
+@end lilypond
+
+@noindent
+or
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 
+  \repeat volta 4 { e | c2 d2 | e2 f2 | }
+  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+}
+@end lilypond
+
+
+@funindex \repeatTie
+
+Bindebögen können auch an eine zweite Klammer angefügt werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f ~ }
+\alternative { {f2 d} {f\repeatTie f,} }
+@end lilypond
+
+Es ist auch möglich, die Klammern zu verkürzen, indem ihnen ein 
+Wert in der Eigenschaft @code{voltaSpannerDuration} zugewiesen 
+wird. Im nächsten Beispiel ist die Klammer beispielsweise nur 
+einen 3/4-Takt lang.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c''{
+  \time 3/4
+  c c c
+  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
+  \repeat volta 5 { d d d }
+  \alternative { { e e e f f f }
+  { g g g } }
+}
+@end lilypond
+
+Wenn eine Wiederholung am Anfang einer neuen Zeile beginnen soll 
+und eine Doppellinie am Ende der vorhergehenden Zeile stehen soll, 
+muss
+@example
+@dots{} \bar "||:" \break 
+\repeat volta 2 @{ @dots{} 
+@end example
+
+@noindent benutzt werden. Siehe 
+ @ref{Bar lines} for more information.
+
+@seealso
+
+Programmreferenz: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic} und
+@internalsref{UnfoldedRepeatedMusic}.
+
+
+Beispiele:
+
+Klammern für die Wiederholung werden normalerweise nur über dem obersten 
+System ausgegeben. Das kann verändert werden, indem 
+ @code{Volta_engraver} in den @code{Staff}-Kontext gesetzt wird,
+über dem diese Klammern erscheinen sollen. Vgl.
+@ref{Modifying context plug-ins} und
+
+@lsr{repeats,volta@/-multi@/-staff@/.ly}.
+
+
+@refbugs
+
+@cindex Wiederholung, mehrdeutig
+
+Eine ineinandergeschachtelte Wiederholung wie 
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+ist mehrdeutig, weil nicht klar ist, zu welchem @code{\repeat}-Abschnitt 
+die @code{\alternative}-Endung gehört. Diese Mehrdeutigkeit wird von 
+LilyPond aufgelöst, indem die alternative Endung immer zu der innersten 
+Wiederholung gehört. Um Klarheit zu schaffen, bietet es sich an, in solchen 
+Situationen Klammern zu benutzen.
+
+Die Taktposition wird bei einer alternativen Endung nicht mitgeteilt, so 
+dass nach einer Wiederholung diese Information manuell angegeben werden 
+muss, 
+entweder durch setzen von @code{Score.measurePosition} oder indem der 
+Befehl @code{\partial} benutzt wird. Gleichermaßen werden auch Legato- oder 
+Bindebögen nicht wiederholt.
+
+
+@node Manual repeat commands
+@unnumberedsubsubsec Manual repeat commands
+
+@funindex repeatCommands
+
+Die Eigenschaft @code{repeatCommands} kann verwendet werden, um das 
+Aussehen der Wiederholungen zu beeinflussen. Ihr Argument ist eine 
+Scheme-Liste an Wiederholungsbefehlen.
+
+@table @asis
+@item @code{start-repeat}
+Setzt eine @code{|:} Taktlinie.
+
+@item @code{end-repeat}
+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 
+Schriftart zu verändern, weil die Standardschriftart für die Nummern 
+keine Buchstaben enthält.
+
+@item @code{(volta #f)}
+Beendet eine aktive Klammer.
+@end table
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c4
+  \set Score.repeatCommands = #'((volta "93") end-repeat)
+c4 c4
+  \set Score.repeatCommands = #'((volta #f))
+c4 c4
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic} und
+@internalsref{UnfoldedRepeatedMusic}.
+
+
+@node Repeats and MIDI
+@unnumberedsubsubsec Repeats and MIDI
+
+@cindex Erweiterung von Wiederholungen
+@funindex \unfoldRepeats
+
+Mit ein bisschen Anpassung können alle Wiederholungstypen 
+auch in der MIDI-Datei wiedergegeben werden. Das wird erreicht 
+durch die @code{\unfoldRepeats}-Funktion. Hiermit werden alle 
+Wiederholungen, welcher Art auch immer, in notengetreue Wiederholungen 
+umgewandelt, die Noten werden also wiederholt ausgegeben.
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+  \repeat tremolo 8 {c'32 e' }
+  \repeat percent 2 { c''8 d'' }
+  \repeat volta 2 {c'4 d' e' f'}
+  \alternative {
+    { g' a' a' g' }
+    {f' e' d' c' }
+  }
+}
+\bar "|."
+@end lilypond
+
+Wenn man eine Partitur schreibt, die diesen @code{\unfoldRepeats}-Befehl 
+für die MIDI-Ausgabe benutzt, muss man zwei @code{\score}-Umgebungen 
+schreiben: eine für die MIDI-Ausgabe, wo die Wiederholungen ausgeschrieben 
+werden, und eine für die gedruckte Notation, in der Klammern, Tremolo und 
+Prozent-Wiederholungen benutzt werden. Zum Beispiel:
+
+@example
+\score @{
+  @var{..music..}
+  \layout @{ .. @}
+@}
+\score @{
+  \unfoldRepeats @var{..music..}
+  \midi @{ .. @}
+@}
+@end example
+
+
+@node Other repeats
+@subsection Other repeats
+
+@menu
+* Tremolo repeats::             
+* Tremolo subdivisions::        
+* Measure repeats::             
+@end menu
+
+@node Tremolo repeats
+@unnumberedsubsubsec Tremolo repeats
+
+@cindex Tremolobalken
+
+Um Tremolozeichen zwischen den Noten zu setzen, kann der 
+Wiederholungstyp @code{tremolo} benutzt werden.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat tremolo 8 { c16 d16 }
+  \repeat tremolo 4 { c16 d16 }
+  \repeat tremolo 2 { c16 d16 }
+}
+@end lilypond
+
+Tremolozeichen können auch einer einzelnen Noten hinzugefügt werden. In 
+diesem Fall darf die Note nicht von Klammern eingefasst sein.
+
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
+@end lilypond
+
+Ähnliche Darstellung wird erreicht durch eine innere Tremolountereilung, 
+die im Abschnitt @ref{Tremolo subdivisions} beschrieben wird.
+
+
+@seealso
+
+Im Handbuch: @ref{Tremolo subdivisions}, @ref{Repeats}.
+
+Programmreferenz: @internalsref{Beam}, @internalsref{StemTremolo}.
+
+
+@node Tremolo subdivisions
+@unnumberedsubsubsec Tremolo subdivisions
+
+@cindex Tremolozeichen
+@funindex tremoloFlags
+
+Tremolozeichen können einer einzelnen Noten hinzugefügt werden, indem 
+an sie die Zeichen @code{:}[@var{Anzahl}] angefügt werden. Die Anzahl 
+bezeichnet die Dauer der einzelnen Noten, und ihr Mindestwert ist 8. 
+Mit der Zahl 8 erhält man eine Linie durch den Notenhals. Wenn die 
+Anzahl ausgelassen wird, wird der letzte benutzte Wert (in der 
+Funktion @code{tremoloFlags} gespeichert) eingesetzt.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+c'2:8 c':32 | c': c': |
+@end lilypond
+
+
+@refbugs
+
+Tremolos, die auf diese Weise notiert werden, werden nicht in die 
+MIDI-Datei aufgenommen.
+
+
+@seealso
+
+Im Handbuch: @ref{Tremolo repeats}.
+
+Programmreferenz: @internalsref{StemTremolo}.
+
+
+@node Measure repeats
+@unnumberedsubsubsec Measure repeats
+
+@cindex Prozent-Wiederholungen
+@cindex Taktweise Wiederholungen
+
+Wenn der Prozent (@code{percent})-Wiederholungsstil gesetzt ist, wird 
+eine Notenphrase wiederholt. Sie wird einmal gedruckt und dann durch 
+ein spezielles Zeichen ersetzt. Phrasen von ein oder zwei Takten Dauer 
+werden durch ein dem Prozentzeichen ähnlichen Zeichen markiert, Phrasen, 
+die kürzer als ein Takt sind, durch einen Schrägstrich dargestellt. 
+Dieser Wiederholungstyp muss innerhalb eines Stimmen 
+(@code{Voice})-Kontextes notiert werden.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
+}
+@end lilypond
+
+Wiederholungen, die länger als einen Takt dauern, können gezählt werden, 
+wenn die @code{countPercentRepeats}-Eigenschaft eingeschaltet wird.
+
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+  \repeat "percent" 4 { c1 }
+}
+@end lilypond
+
+Isolierte Prozentzeichen können auch gedruckt werden. Das geschieht, indem 
+einer Ganztaktpause (@code{R}) eine andere Funktion zugewiesen wird.
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+  = #ly:multi-measure-rest::percent
+R1
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
+
+
+
diff --git a/Documentation/de/user/rhythms.itely b/Documentation/de/user/rhythms.itely
new file mode 100644
index 0000000000..969f84eb05
--- /dev/null
+++ b/Documentation/de/user/rhythms.itely
@@ -0,0 +1,1206 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Rhythms
+@section Rhythms
+
+This section discusses rhythms, durations, and bars.
+
+@menu
+* Writing rhythms::             
+* Writing rests::               
+* Displaying rhythms::          
+* Beams::                       
+* Bars::                        
+* Special rhythmic concerns::   
+@end menu
+
+
+@node Writing rhythms
+@subsection Writing rhythms
+
+@menu
+* Durations::                   
+* Augmentation dots::           
+* Tuplets::                     
+* Scaling durations::           
+@end menu
+
+@node Durations
+@unnumberedsubsubsec Durations
+
+@cindex Dauer
+@cindex Notenlänge
+@funindex \longa
+@funindex \breve
+@funindex \maxima
+
+Im Noten-, Akkord- und Liedtextmodus werden Notenlängen (Dauern) durch 
+Zahlen und Punkte notiert: Dauern werden als reziproke Werte geschrieben. 
+Zum Beispiel wird eine Viertelnote mit @code{4} notiert (weil sie eine 
+1/4-Note ist), eine halbe Note mit @code{2} (weil sie eine 1/2-Note ist). 
+Noten, die länger als eine Ganze sind, müssen mit @code{\longa} 
+(für die Longa, also vier Ganze) und 
+@code{\breve} (für die Brevis, auch Doppelganze genannt) notiert werden.
+
+@example
+c'\breve
+c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
+r\longa r\breve
+r1 r2 r4 r8 r16 r32 r64 r64
+@end example
+
+@lilypond[quote]
+\score {
+\relative c'' {
+    a\breve*1/2 \autoBeamOff
+    a1 a2 a4 a8 a16 a32 a64 a64
+   \bar "empty"
+   \break
+    r\longa*1/4 r\breve *1/2
+    r1 r2 r4 r8 r16 r32 r64 r64
+  }
+  \layout {
+    ragged-right = ##t
+    indent=0\mm
+    \context {
+      \Score
+        \remove "Bar_number_engraver"
+    }
+    \context {
+      \Staff
+        \remove "Clef_engraver"
+        \override StaffSymbol #'transparent = ##t
+        \override TimeSignature #'transparent = ##t
+        \override BarLine #'transparent = ##t
+        \consists "Pitch_squash_engraver"
+    }
+  }
+}
+@end lilypond
+
+Wenn die Dauer hinter einer Notenbezeichnung nicht angegeben ist, 
+wird die Dauer der vorhergehenden Note eingesetzt. Der Standardwert 
+für die erste Note ist eine Viertel.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+{ a a a2 a a4 a a1 a }
+@end lilypond
+
+
+@node Augmentation dots
+@unnumberedsubsubsec Augmentation dots
+
+@funindex .
+@cindex Punktierung
+
+Um punktierte Notendauern zu erhalten, muss einfach nur ein Punkt 
+(@code{.}) hinter die Zahl der Dauer gesetzt werden. Zwei Punkte 
+ergeben eine doppelte Punktierung.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+a'4 b' c''4. b'8 a'4. b'4.. c''8.
+@end lilypond
+
+@refcommands
+
+Punkte werden normalerweise nach oben verschoben, damit sie die Notenlinien 
+nicht berühren. Das gilt aber nicht für mehrstimmige Passagen. Mit den 
+folgenden Befehlen kann ein anderes Verhalten der Punktierung erreicht werden.
+
+@funindex \dotsUp
+@code{\dotsUp} (Der Punkt wird nach oben verschoben.),
+@funindex \dotsDown
+@code{\dotsDown} (Der Punkt wird nach unten verschoben.),
+@funindex \dotsNeutral (Wiederherstellung des Standards.)
+@code{\dotsNeutral}.
+
+@seealso
+
+Programmreferenz: @internalsref{Dots}, and @internalsref{DotColumn}.
+
+
+@node Tuplets
+@unnumberedsubsubsec Tuplets
+
+@cindex N-tolen
+@cindex Triolen
+@cindex Rhythmische Aufteilungen
+@funindex \times
+
+Triolen und andere rhythmische Aufteilungen werden aus einem musikalischen 
+Ausdruck erstellt, indem dessen Tondauern mit einem Bruch multipliziert werden.
+
+@example
+\times @var{Bruch} @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+Die Dauer eines @var{musikalischen Ausdrucks} wird mit dem Bruch multipliziert. 
+Der Nenner des Bruchs wird über den Noten ausgegeben, optional mit einer 
+eckigen Klammer, die die Noten einfasst. Die üblichste Aufteilung ist die 
+Triole, in welcher drei Noten die Länge von zwei haben, der Wert jeder 
+einzelnen Note ist also 2/3 der notierten Länge.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+g'4 \times 2/3 {c'4 c' c'} d'4 d'4
+@end lilypond
+
+Diese Brüche können auch ineinander geschachtelt werden, etwa so:
+
+@lilypond[fragment,ragged-right,verbatim,relative=2]
+\override TupletNumber #'text = #tuplet-number::calc-fraction-text
+\times 4/6 {
+  a4 a
+  \times 3/5 { a a a a a }
+}
+@end lilypond
+
+@refcommands
+
+@funindex \tupletUp
+@code{\tupletUp},
+@funindex \tupletDown
+@code{\tupletDown},
+@funindex \tupletNeutral
+@code{\tupletNeutral}.
+
+
+@commonprop
+
+@funindex tupletNumberFormatFunction
+@cindex Formatierung von Brüchen
+@cindex Formatierung von Triolen
+@cindex N-tolen, Formatierung
+
+Der Wert von @code{tupletSpannerDuration} definiert, wie lange jede 
+Klammer dauert. Mit entsprechender Einstellung kann man beliebig 
+viele Triolen schreiben, aber nur einmal den Befehl @code{\times}
+benutzen. Im nächsten Beispiel etwa werden zwei Triolen gedruckt, 
+@code{\times} aber nur einmal benutzt. Das gilt natürlich auch für alle 
+anderen Brüche.
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\set tupletSpannerDuration = #(ly:make-moment 1 4)
+\times 2/3 { c8 c c c c c }
+@end lilypond
+
+@noindent
+Mehr Information zu @code{make-moment} findet sich im Abschnitt 
+@ref{Time administration}.
+
+Die Formatierung der Nummer wird durch die Eigenschaft @code{text} 
+in @code{TupletNumber} bestimmt. Die Standardeinstellung gibt nur 
+den Nenner aus, aber wenn @code{TupletNumber} auf den Wert 
+@code{tuplet-number::calc-fraction-text}
+gestellt wird, wird @var{Zähler}:@var{Nenner} ausgegeben.
+
+Um gar keine Nummern anzeigen zu lassen, kann folgender Code benutzt
+ werden:
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+\override TupletNumber #'transparent = ##t
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+@end lilypond
+
+Mit der  @code{\tweak}-Funktion können die Zahlen von geschachtelten Brüchen 
+eingestellt werden, die  zur gleichen Zeit beginnen. Im Beispiel unten 
+wird mit @code{\tweak} definiert, dass für die äußere Klammer der Bruch
+ausgegeben wird, für die innere aber nur der Nenner.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \times 4/3 {
+     \tweak #'text #tuplet-number::calc-denominator-text
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Im nächsten Beispiel werden @code{\tweak} und @code{\override} 
+zusammen verwendet, um die Darstellung der Klammer 
+(@code{TupletBracket}) zu bestimmen. Mit dem ersten @code{\tweak} 
+wird die Klammer der äußeren Triole über dem Notensystem platziert. 
+Das zweite @code{\tweak} platziert die erste der drei inneren Klammern 
+unter dem System (von der Klammer wird hier nur der Nenner des
+Bruchs dargestellt). Dieses Paar von @code{\tweak}-Einstellungen wirkt 
+sich jedoch nur auf die äußere und die @emph{erste} innere Klammer 
+aus, weil nur sie zur gleichen Zeit beginnen. Mit dem @code{\override}-Befehl 
+kann die Richtung der zweiten und dritten @code{TupletBracket} 
+verändert werden, in 
+diesem Fall wird sie unter das Notensystem geschrieben.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \tweak #'direction #up
+  \times 4/3 {
+     \tweak #'direction #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \override TupletBracket #'direction = #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Die Klammern können so eingestellt werden, dass sie bis zu 
+einem Taktvorspann oder bis zur nächsten Note reichen.
+
+@lilypond[ragged-right]
+\new RhythmicStaff {
+  \set tupletFullLength = ##t
+  \time 4/4
+  \times 4/5 {
+    c4 c1
+  }
+  \set tupletFullLengthNote = ##t
+  \time 2/4
+  \times 2/3 {
+    c4 c c 
+  }
+  \time 3/4
+  c4 
+}
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{TupletBracket},
+@internalsref{TupletNumber} und @internalsref{TimeScaledMusic}.
+
+
+
+@node Scaling durations
+@unnumberedsubsubsec Scaling durations
+
+Die Dauer von Längen kann mit einem Bruch multipliziert werden, 
+indem hinter die Note  @qq{*@var{N/M}} (oder @qq{*@var{N}} wenn @var{M=1}) 
+geschrieben wird. Das beeinflusst nicht die Erscheinung der Note oder 
+Pause im Druckbild. Die Werte können auch kombiniert werden, etwa 
+@qq{*M*N}.
+
+Im nächsten Beispiel nehmen die drei ersten Noten genau zwei Schläge ein, 
+aber es wird keine Triolenklammer über ihnen ausgegeben.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\time 2/4
+a4*2/3 gis4*2/3 a4*2/3
+a4 a4 a4*2
+b16*4 c4
+@end lilypond
+
+
+@seealso
+
+Abschnitt @ref{Tuplets}
+
+
+@node Writing rests
+@subsection Writing rests
+
+@menu
+* Rests::                       
+* Skips::                       
+* Multi measure rests::         
+@end menu
+
+@node Rests
+@unnumberedsubsubsec Rests
+@cindex Pausen
+
+@funindex \rest
+@funindex r
+
+Pausen werden wie Noten eingegeben, ihre Bezeichnung ist @code{r}.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+r1 r2 r4 r8
+@end lilypond
+
+Pausen, die ganze Takte ausfüllen und in der Taktmitte zentriert 
+werden sollen, müssen als mehrtaktige Pausen eingegeben werden. 
+Sie können sowohl für einen einzigen Takt als auch für mehrere 
+Takte verwendet werden, Näheres im Abschnitt
+@ref{Multi measure rests}.
+
+Um die vertikale Position einer Pause explizit festzulegen, 
+kann eine Note eingegeben werden, gefolgt vom Befehl @code{\rest}. 
+Die Pause wird dann an die Stelle gesetzt, wo sich sonst die 
+Note befinden würde.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+a'4\rest d'4\rest
+@end lilypond
+
+@noindent
+Damit wird die manuelle Formatierung von mehrstimmiger Musik 
+sehr viel einfacher, da die Formatierungsfunktion zur automatischen 
+Auflösung von Zusammenstößen diese Pausen nicht mit einbezieht.
+
+
+@seealso
+
+Programmreferenz: @internalsref{Rest}.
+
+
+@node Skips
+@unnumberedsubsubsec Skips
+
+@cindex Skip
+@cindex Überspringen von Zeichen
+@cindex Unsichtbare Pausen
+@cindex Platzhalternoten
+@funindex \skip
+@funindex s
+
+Eine unsichtbare Pause (auch als @qq{skip} oder Überspringung bezeichnet) 
+kann wie eine Note eingegeben werden, die Notationsbezeichnung ist @code{s}. 
+Man kann aber auch die Dauer extra angeben mit @code{\skip @var{Dauer}}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a4 a4 s4 a4 \skip 1 a4
+@end lilypond
+
+Die @code{s}-Syntax steht nur im Noten- oder Akkordmodus zur Verfügung. In 
+anderen Situationen, z. B. innerhalb eines Liedtextes, muss @code{\skip} 
+benutzt werden.
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+  \relative { a'2 a2 }
+  \new Lyrics \lyricmode { \skip 2 bla2 }
+>>
+@end lilypond
+
+Der Überspringungsbefehl (@code{\skip}) ist einfach ein leerer Platzhalter. 
+Durch ihn wird 
+überhaupt nichts gesetzt, auch keine transparenten Objekte.
+
+Die Überspringung mit @code{s} hingegen erstellt  @internalsref{Staff} und
+@internalsref{Voice} wenn es erforderlich ist, genauso wie Noten und Pausen. 
+Das folgende Beispiel etwa setzt ein leeres Notensystem:
+
+@lilypond[quote,ragged-right,verbatim]
+{ s4 }
+@end lilypond
+
+Das Fragment @code{@{ \skip 4 @}} würde nur eine leere Seite produzieren.
+
+@seealso
+
+Programmreferenz: @internalsref{SkipMusic}.
+
+
+@node Multi measure rests
+@unnumberedsubsubsec Multi measure rests
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Displaying rhythms
+@subsection Displaying rhythms
+
+@menu
+* Time signature::              
+* Upbeats::                     
+* Unmetered music::             
+* Polymetric notation::         
+* Automatic note splitting::    
+@end menu
+
+@node Time signature
+@unnumberedsubsubsec Time signature
+
+@cindex Taktangabe
+@cindex Metrum
+@funindex \time
+
+Taktangaben zeigen das Metrum eines Stückes an: eine 
+regelmäßige Folge von betonten und unbetonten Zeiten. 
+Es wird angezeigt als ein Bruch vor Beginn der Noten.
+
+Die Taktangabe wird mit dem @code{\time}-Befehl gesetzt.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 2/4 c'2 \time 3/4 c'2.
+@end lilypond
+
+@commonprop
+
+Das Symbol, das angezeigt wird, kann durch die 
+@code{style}-Eigenschaft angepasst werden. Wenn man 
+es auf den Wert @code{#'()} setzt, wird auch für 
+4/4- und 2/2-Takte ein Bruch angezeigt.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+\time 4/4 c'1
+\time 2/2 c'1
+\override Staff.TimeSignature #'style = #'()
+\time 4/4 c'1
+\time 2/2 c'1
+@end lilypond
+
+Es gibt noch sehr viel mehr Optionen für das Layout. 
+Siehe den Abschnitt @ref{Ancient time
+signatures} für weitere Beispiele.
+
+Der Befehl @code{\time} stellt die Eigenschaften 
+@code{timeSignatureFraction}, @code{beatLength} 
+und @code{measureLength} im @code{Timing}-Kontext ein, 
+der normalerweise zu den Eigenschaften aller System 
+(@internalsref{Score}-Ebene) gehört. Die Eigenschaft 
+@code{measureLenght} bestimmt, wo Taktlinien eingefügt werden, 
+und wie automatische Balken gesetzt werden. Ein Verändern 
+der Eigenschaften von @code{timeSignatureFraction} gibt 
+das neue Symbol an dieser Stelle aus.
+
+Auf weitere Optionen kann man über die Scheme-Funktion
+@code{set-time-signature} zugreifen. In Kombination mit
+@internalsref{Measure_grouping_engraver} werden hiermit 
+@internalsref{MeasureGrouping}-Zeichen erzeugt. Solche 
+Zeichen erleichtern es, rhythmisch komplexe moderne Musik 
+zu lesen. Im nächsten Beispiel ist der 9/8-Takt in 2, 2, 2 
+und 3 Achtel unterteilt. Das wird im dritten Argument an 
+@code{set-time-signature} weitergegeben @code{(2 2 2 3)}.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    #(set-time-signature 9 8 '(2 2 2 3))
+    g8[ g] d[ d] g[ g] a8[( bes g]) |
+    #(set-time-signature 5 8 '(3 2))
+    a4. g4
+  }
+  \layout {
+    \context {
+      \Staff
+      \consists "Measure_grouping_engraver"
+    }
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{TimeSignature} und
+@internalsref{Timing_translator}.
+
+Beispiele: @lsr{contemporary,compound-time-signature.ly}.
+
+
+@refbugs
+
+Automatische Balken richten sich nicht nach den Taktunterteilungen, die 
+mit @code{set-time-signature} erzeugt werden.
+
+
+@node Upbeats
+@unnumberedsubsubsec Upbeats
+
+@cindex Auftakt
+@cindex Takte verkürzen
+@funindex \partial
+
+Verkleinerte Takte, wie etwa ein Auftakt, werden wie folgt notiert:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\partial 16*5 c16 cis d dis e | a2. c,4 | b2
+@end lilypond
+
+Die Syntax für den Befehl lautet:
+
+@example
+\partial @var{Dauer}
+@end example
+
+wobei @code{Dauer} eine rhythmische Länge ist, die vor dem nächsten Taktstrich 
+eingefügt wird.
+
+Das wird intern übersetzt nach:
+
+@example
+\set Timing.measurePosition = -@var{Länge der Dauer}
+@end example
+
+Die Eigenschaft @code{measurePosition} enthält eine rationale Zahl, 
+die darstellt, wie groß der Abstand zum Taktanfang ist. Deshalb ist 
+sie eine negative Zahl; @code{\partial 4} wird also intern übersetzt 
+zu: @qq{Eine Viertel bleibt übrig vom ganzen Takt.}
+
+@refbugs
+
+Dieser Befehl berücksichtigt keine Verzierungen/Vorschläge am Anfang der 
+Noten. Wenn ein Stück mit einem Vorschlag anfängt, muss der Befehl 
+@code{\partial} @emph{nach} dem Vorschlag kommen:
+
+@lilypond[verbatim,quote,ragged-right,relative,fragment]
+\grace f16
+\partial 4
+g4
+a2 g2
+@end lilypond
+
+@code{\partial} ist nur für den Anfang eines Stückes vorgesehen. Wenn der 
+Befehl innerhalb eines Stückes verwendet wird, können seltsame Warnungen 
+auftreten.
+
+
+@node Unmetered music
+@unnumberedsubsubsec Unmetered music
+
+@cindex Kadenz
+@funindex \cadenzaOn
+@funindex \cadenzaOff
+
+Taktlinien und Taktzahlen werden automatisch erzeugt. Für Musik 
+ohne Meter hingegen (etwa Kadenzen) ist das allerdings nicht 
+erwünscht. Mit den Befehlen @code{\cadenzaOn} und 
+@code{\cadenzaOff} kann dieses Verhalten ausgeschaltet und 
+wieder angeschaltet werden.
+
+@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
+c4 d e d
+\cadenzaOn
+c4 c d8 d d f4 g4.
+\cadenzaOff
+\bar "|"
+d4 e d c
+@end lilypond
+
+
+@refbugs
+
+LilyPond fügt Zeilen- und Seitenumbrüche nur an einer Taktlinie 
+ein. Wenn die Kadenz nicht vor einem Umbruch endet, müssen Sie 
+selber unsichtbare Taktlinien 
+
+@example
+\bar ""
+@end example
+
+@noindent
+einfügen, um anzuzeigen, wo umgebrochen werden darf.
+
+
+@node Polymetric notation
+@unnumberedsubsubsec Polymetric notation
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Automatic note splitting
+@unnumberedsubsubsec Automatic note splitting
+
+Lange Noten können automatisch in übergebundene Noten aufgeteilt werden. 
+Dieses Verhalten erreicht man, indem der  @internalsref{Note_heads_engraver} 
+mit dem @internalsref{Completion_heads_engraver} ausgetauscht wird. 
+Im nächsten Beispiel werden Noten, die über die Taktlinie dauern, aufgeteilt 
+und übergebunden.
+
+@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
+\new Voice \with {
+  \remove "Note_heads_engraver"
+  \consists "Completion_heads_engraver"
+} {
+  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
+}
+@end lilypond
+
+Dieser Notationsformatierer (eng. engraver) teilt alle Noten 
+auf, die über eine Taktlinie dauern und fügt Bindebögen hinzu. 
+Er kann unter Anderem dann nützlich sein, wenn man komplexe 
+Partituren auf Fehler überprüfen möchte: Wenn die Takte nicht 
+vollständig gefüllt sind, zeigt die Überbindung genau an, wie viele 
+Notenwerte noch in dem jeweiligen Takt fehlen.
+
+Wenn Sie wollen, dass auch Zeilenumbrüche an den Stellen, an denen 
+automatisch Noten aufgeteilt wurden, stattfinden, müssen Sie auch 
+den Formatierer  @internalsref{Forbid_line_break_engraver}  mit 
+dem @code{\remove}-Befehl entfernen.
+
+
+@refbugs
+
+Nicht alle Notenwerte (besonders wenn sie andere rhythmische 
+Aufteilungen beinhalten) können exakt durch normale Noten und 
+Punktierungen wiedergegeben werden. Der Engraver setzt aber
+trotzdem keine Triolen etc.
+
+@code{Completion_heads_engraver} wirkt sich nur auf Noten aus; 
+Pausen werden nicht aufgeteilt.
+
+@seealso
+
+Programmreferenz: @internalsref{Completion_heads_engraver}.
+
+
+@node Beams
+@subsection Beams
+
+@menu
+* Automatic beams::             
+* Manual beams::                
+* Feathered beams::             
+@end menu
+
+@node Automatic beams
+@unnumberedsubsubsec Automatic beams
+
+LilyPond setzt Balken (engl. beam) automatisch.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
+@end lilypond
+
+Wenn diese automatischen Entscheidungen nicht gut genug sind, können 
+die Balken auch explizit eingegeben werden. Es können auch bestimmte 
+Balkenmuster, die sich vom Standard unterscheiden, definiert werden. 
+Hierzu siehe den Abschnitt @ref{Setting automatic beam behavior} 
+für Einzelheiten.
+
+Einzelne Noten können mit dem Befehl @code{\noBeam} markiert werden, 
+damit sie nicht mit einem Balken versehen werden.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c\noBeam c c
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{Beam}.
+
+
+@node Manual beams
+@unnumberedsubsubsec Manual beams
+
+@cindex Balken, manuell
+@funindex ]
+@funindex [
+
+In einigen Fällen kann es nötig sein, den automatischen Algorithmus 
+für die Balken zu überschreiben. Die automatischen Balken werden 
+beispielsweise nicht über Pausen oder Taktlinien hinweg gesetzt. 
+Manuell definierte Balken werden mit den Zeichen @code{[} und 
+@code{]} (AltGr+8 bzw. 9) markiert.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+  r4 r8[ g' a r8] r8 g[ | a] r8
+}
+@end lilypond
+
+
+@commonprop
+
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
+
+LilyPond kann die Balkengruppen innerhalb eines größeren Balkens
+selber bestimmen, aber dabei können teilweise seltsame Ergebnisse 
+entstehen. Mit den Eigenschaften @code{stemLeftBeamCount} und 
+@code{stemRightBeamCount} können diese Unterteilungen manuell
+eingestellt werden. Wenn eine dieser Eigenschaften gesetzt ist, 
+wird es nur einmal verwendet und dann wieder zum Standard zurück 
+geschaltet.
+
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+   f8[ r16
+      f g a]
+   f8[ r16
+   \set stemLeftBeamCount = #1
+      f g a]
+}
+@end lilypond
+
+Die Eigenschaft @code{subdivideBeams} kann benutzt werden, um alle 
+16tel-Balken oder kleinere Werte zu bestimmten Taktzeiten zu 
+unterteilen. Diese Zeiten werden mit der @code{beatLength}-Eigenschaft 
+gesetzt.
+
+@lilypond[fragment,quote,relative=2,verbatim]
+c16[ c c c c c c c]
+\set subdivideBeams = ##t
+c16[ c c c c c c c]
+\set Score.beatLength = #(ly:make-moment 1 8)
+c16[ c c c c c c c]
+@end lilypond
+@funindex subdivideBeams
+
+@noindent
+Zu mehr Information über @code{make-moment} siehe
+@ref{Time administration}.
+
+Zeilenumbrüche sind normalerweise verboten, wenn Balken sich über 
+die Taktlinien erstrecken. Das kann aber durch Setzen von 
+@code{breakable} verändert werden.
+
+@funindex breakable
+
+@cindex Balken und Zeilenumbrüche
+@cindex Balken zwischen Systemen
+@funindex auto-knee-gap
+
+
+Balken mit Hälsen nach oben und unten werden automatisch eingesetzt, 
+wenn ein großer Abstand zwischen Notenköpfen gefunden wird. Die Größe 
+des Wertes kann mit dem 
+@code{auto-knee-gap}-Objekt eingestellt werden.
+
+@refbugs
+
+Automatisch erstellte Balken zwischen Systemen können nicht zusammen 
+mit automatisch versteckten Systemen verwendet werden. Siehe auch
+ @ref{Hiding staves}.
+
+@c Is this still true with skyline spacing stuff? -J.Mandereau
+Balken vermeiden nicht andere Objekte, wie etwa Text und Versetzungszeichen.
+
+
+@node Feathered beams
+@unnumberedsubsubsec Feathered beams
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Bars
+@subsection Bars
+
+
+@menu
+* Bar check::                   
+* Bar lines::                   
+* Bar numbers::                 
+* Barnumber check::             
+* Rehearsal marks::             
+@end menu
+
+@node Bar check
+@unnumberedsubsubsec Bar check
+
+@cindex Taktüberprüfung
+@funindex barCheckSynchronize
+@funindex |
+
+Die Taktüberprüfung hilft, Fehler in den Notendauern zu entdecken. 
+Eine Taktüberprüfung wird mit dem Taktstrichsymbol @qq{|} (Taste AltGr+<) 
+eingegeben. Immer, wenn LilyPond bei der Ausgabe des Notendrucks 
+auf dieses Zeichen stößt, sollte hier in den Noten auch ein 
+Taktstrich erscheinen. Wenn das nicht der Fall ist, wird eine Warnung 
+ausgegeben. Im nächsten Beispiel resultiert die zweite Taktüberprüfung 
+in einer Fehlermeldung.
+
+@example
+\time 3/4 c2 e4 | g2 |
+@end example
+
+Taktüberprüfungen können auch in Liedtexten verwendet werden:
+
+@example
+\lyricmode @{
+  \time 2/4
+  Twin -- kle | Twin -- kle
+@}
+@end example
+
+Eine Taktüberprüfung gilt als nicht bestanden, wenn die Notenwerte 
+nicht stimmen. Besonders in mehrstimmiger komplizierter Musik können 
+solche falschen Notenwerte die ganze Partitur durcheinander bringen. 
+Es lohnt sich also, die Fehlersuche damit zu beginnen, nicht bestandene 
+Taktüberprüfungen zu kontrollieren.
+
+@funindex |
+@funindex pipeSymbol
+
+Es ist auch möglich, die Bedeutung des Symbols @code{|} umzudefinieren. 
+Das geschieht, indem man der Pipe (@code{pipeSymbol} einen musikalischen 
+Ausdruck zuweist:
+
+@lilypond[quote,ragged-right,verbatim]
+pipeSymbol = \bar "||"
+
+{ c'2 c' | c'2 c' }
+@end lilypond
+
+
+@node Bar lines
+@unnumberedsubsubsec Bar lines
+
+@cindex Taktlinien
+@funindex \bar
+@cindex Doppellinie
+@cindex Wiederholungszeichen
+
+Taktlinien trennen die Takte voneinander, werden aber auch verwendet, 
+um Wiederholungen anzuzeigen. Normalerweise werden sie automatisch 
+eingefügt. Zeilenumbrüche können nur an Taktlinien stattfinden.
+
+Besondere Taktlinien-Arten können mit dem @code{\bar}-Befehl erzwungen 
+werden.
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+c4 \bar "|:" c4
+@end lilypond
+
+Folgende Taktlinienarten sind vorhanden:
+
+@c @lilypondfile[ragged-right,quote]{bar-lines.ly}
+
+Als letztes ist @code{"||:"} notiert, das sich ähnlich wie 
+@code{"|:"} verhält. Es gibt jedoch nur an Zeilenenden eine doppelte 
+Taktlinie aus und fängt die Wiederholungslinie erst in der nächsten 
+Zeile an.
+
+Um einen Zeilenumbruch an einer Stelle zu erlauben, wo keine sichtbare 
+Taktlinie ist, kann man 
+
+@example
+\bar ""
+@end example
+
+@noindent
+benutzen. Damit wird eine unsichtbare Taktlinie an dieser Stelle eingefügt 
+und damit ein Zeilenumbruch erlaubt (ohne dass sich die Anzahl der Takte 
+erhöhen würde).
+
+In Partituren mit vielen Systemen wird ein @code{\bar}-Befehl in einem 
+System automatisch auf alle anderen Systeme angewendet. Die resultierenden 
+Taktlinien sind miteinander verbunden innerhalb einer Gruppe 
+ (@code{StaffGroup}) oder einem Klaviersystem (@code{PianoStaff} 
+bzw. (@code{GrandStaff}).
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+  \new StaffGroup <<
+    \new Staff {
+      e'4 d'
+      \bar "||"
+      f' e'
+    }
+    \new Staff { \clef bass c4 g e g }
+  >>
+  \new Staff { \clef bass c2 c2 }
+>>
+@end lilypond
+
+
+@commonprop
+
+@funindex whichBar
+@funindex repeatCommands
+@funindex defaultBarType
+
+Der Befehl @code{\bar }@var{Taktart} ist eine Kurzform von:
+@code{\set Timing.whichBar = }@var{Taktart}. Immer, wenn 
+@code{whichBar} auf einen Wert gesetzt wird, wird eine 
+Taktlinie dieses Typs erzeugt.
+
+Eine Taktlinie wird auch durch Setzen der 
+ @code{whichBar}-Eigenschaft erzeugt. Am Anfang eines Taktes 
+wird sie auf den Wert von @code{Timing.defaultBarType} 
+gesetzt. Der Inhalt des @code{repeatCommands}-Befehls 
+wird benutzt, um Standardtaktlinien zu überschreiben.
+
+Sie sollten jedoch Wiederholungen mit dem @code{\repeat}-Befehl 
+erzeugen. Siehe Abschnitt @ref{Repeats}.
+
+
+@seealso
+
+Im Handbuch: @ref{Repeats}, @ref{System start delimiters}.
+
+Programmreferenz: @internalsref{BarLine} (auf Partitur 
+(@internalsref{Staff})-Ebene erstellt), 
+@internalsref{SpanBar} (zwischen Systemen).
+
+
+@node Bar numbers
+@unnumberedsubsubsec Bar numbers
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Barnumber check
+@unnumberedsubsubsec Barnumber check
+
+Wenn man größere Musikstücke kopiert, kann es hilfreich sein, wenn 
+LilyPond überprüft, ob die Taktnummer, in der Sie gerade kopieren, 
+mit der des Originales übereinstimmt. Das kann mit dem Befehl
+@code{\barNumberCheck} folgenderweise überprüft werden:
+
+@verbatim
+\barNumberCheck #123
+@end verbatim
+
+@noindent
+Eine Warnung wird ausgegeben, wenn der interne Zähler 
+@code{currentBarNumber} von LilyPond
+nicht mit dem Wert 123 übereinstimmt.
+
+
+@node Rehearsal marks
+@unnumberedsubsubsec Rehearsal marks
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Special rhythmic concerns
+@subsection Special rhythmic concerns
+
+
+@menu
+* Grace notes::                 
+* Aligning to cadenzas::        
+* Time administration::         
+* Proportional notation (introduction)::  
+@end menu
+
+@node Grace notes
+@unnumberedsubsubsec Grace notes
+
+@funindex \grace
+@cindex Verzierungen
+@cindex Ziernoten
+@cindex Vorhalt
+@cindex Vorschlag
+
+Verzierungen sind ausgeschriebene Ornamente. Die üblichste ist der 
+Vorschlag. Er wird durch eine verkleinerte Note mit Schrägstrich 
+und Bogen notiert. Der Vorhalt dagegen ist eine Verzierung, die 
+einen bestimmten Notenwert der Hauptnote für sich beansprucht. 
+Er wird als verkleinerte Note ohne Schrägstrich notiert. 
+Der Vorschlag wird mit dem Befehl @code{\acciaccatura} und der Vorhalt 
+mit @code{\appoggiatura} eingegeben.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+b4 \acciaccatura d8 c4 \appoggiatura e8 d4
+\acciaccatura { g16[ f] } e4
+@end lilypond
+
+Bei beiden handelt es sich um spezielle Formen des @code{\grace} 
+(engl. Verzierung)-Befehl. Wenn dieser Befehl einem musikalischen 
+Ausdruck vorgestellt wird, wird ein neuer Ausdruck geschaffen, 
+der in kleineren Noten gesetzt wird und von der logischen Zeit 
+innerhalb des Taktes keinen Raum beansprucht.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+c4 \grace c16 c4
+\grace { c16[ d16] } c2 c4
+@end lilypond
+
+@noindent
+Anders als @code{\acciaccatura} oder @code{\appoggiatura} setzt 
+der @code{\grace}-Befehl keinen Bogen.
+
+@cindex Zeitberechnung, intern
+
+Programmintern wird die Zeitberechnung für Verzierungen in einer 
+zweiten Zählebene vorgenommen. Jeder Zeitpunkt beinhaltet zwei 
+rationale Zahlen: die eine steht für die logische Zeit, die andere 
+für die @qq{Verzierungszeit}. Das obere Beispiel ist hier 
+mit den entsprechenden Zeitwerten angezeigt:
+
+@lilypond[quote,ragged-right]
+<<
+  \relative c''{
+    c4 \grace c16 c4 \grace {
+    c16[ d16] } c2 c4
+  }
+  \new Lyrics \lyricmode {
+    \override LyricText #'font-family = #'typewriter
+
+    \markup { (0,0) } 4
+    \grace { \markup {
+      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
+    \markup { (\fraction 1 4 , 0 ) } 4
+    \grace {
+      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
+      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
+    }
+    \markup { ( \fraction 2 4 , 0 ) }
+  }
+>>
+@end lilypond
+
+Die Position von Verzierungen wird zwischen den Systemen synchronisiert. 
+Im folgenden Beispiel sind jeweils zwei Sechzehntel gegen jede Achtel 
+gesetzt:
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \grace { c16[ d e f] } e4 }
+   \new Staff { c4 \grace { g8[ b] } c4 } >>
+@end lilypond
+
+@funindex \afterGrace
+
+Eine Verzierung kann auch auf eine Note folgend gesetzt werden. Dazu wird 
+der @code{\afterGrace}-Befehl benutzt. Er nimmt zwei Argumente: die 
+Hauptnote und die Verzierungen, die nach der Hauptnote erscheinen sollen.
+
+@lilypond[ragged-right, verbatim,relative=2,fragment]
+c1 \afterGrace d1 { c16[ d] } c4
+@end lilypond
+
+Damit wird die Verzierung im Abstand von 3/4 der Länge der Hauptnote 
+gesetzt. Dieser Bruch kann durch Setzen von 
+@code{afterGraceFraction} verändert werden:
+
+@example
+#(define afterGraceFraction (cons 7 8))
+@end example
+
+@noindent
+Hier wurde die Position auf das vorletzte Achtel der Notenlänge gesetzt.
+
+Der gleiche Effekt kann auch manuell erreicht werden:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  << { d1^\trill_( }
+     { s2 \grace { c16[ d] } } >>
+  c4)
+}
+@end lilypond
+
+@noindent
+Indem die Dauer der unsichtbaren Note (hier eine Halbe) wird der 
+Abstand zwischen Hauptnote und Verzierung angepasst.
+
+Ein @code{\grace}-Notenabschnitt wird nach besonderen Satzregeln 
+gesetzt, um z. B. kleinere Noten zu benutzen und die Richtung der 
+Hälse einzustellen. Veränderungen am Layout müssen also innerhalb 
+des Verzierungsausdrucks gesetzt werden, damit sie auch eine Auswirkung haben.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  \acciaccatura {
+    \stemDown
+    f16->
+    \stemNeutral
+  }
+  g4
+}
+@end lilypond
+
+@noindent
+Diese Einstellungen müssen auch innerhalb der Verzierungsebene wieder 
+rückgängig gemacht werden.
+
+Das Layout der Verzierungsausdrücke kann mit der Funktion 
+ @code{add-grace-property} verändert werden. Im folgenden Beispiel 
+wird die Richtung der Notenhälse neutralisiert, so dass sie nicht 
+unbedingt in nach oben zeigen.
+
+@example
+\new Staff @{
+  #(add-grace-property 'Voice 'Stem 'direction '())
+  @dots{}
+@}
+@end example
+
+@noindent
+Eine andere Option ist es, die Variablen @code{startGraceMusic},
+@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
+@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic} und
+@code{stopAppoggiaturaMusic} zu vermeiden. Mehr Information findet sich 
+in der Datei @file{ly/@/grace@/-init@/.ly}.
+
+@noindent
+Der Schrägstrich durch den Notenhals der Vorschläge kann auch in anderen 
+Situation erreicht werden mit 
+@code{\override Stem  #'stroke-style = #"grace"}.
+
+
+@commonprop
+
+Verzierungen könne gezwungen werden, den Hauptnoten entsprechend aufgeteilt 
+zu werden.
+
+@lilypond[relative=2,ragged-right]
+<<
+  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
+  \new Staff {
+     c'4
+     \afterGrace
+     c'4
+     { c'16[ c'8 c'16] }
+     c'4
+  }  
+  \new Staff {
+     c'16[ c'16 c'16 c'16]
+     c'16[ c'16 c'16 c'16]
+     c'4
+  }
+>>
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: @internalsref{GraceMusic}.
+
+
+@refbugs
+
+Eine Partitur, die mit einem @code{\grace}-Ausdruck beginnt, benötigt 
+eine explizit gesetzte neue Stimme (@code{\new Voice}), sonst werden 
+Hauptnote und Verzierung auf verschiedenen Systemen gesetzt.
+
+Die Synchronisation von Verzierungen kann auch zu Überraschungen führen. 
+Auch andere Symbole der Systeme, wie Vorzeichen, Taktlinien usw., werden 
+synchronisiert. Vorsicht ist geboten, wenn nur in bestimmten Systemen 
+Verzierungen vorkommen:
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" d4 } >>
+@end lilypond
+
+@noindent
+Dem kann abgeholfen werden, indem unsichtbare Verzierungsnoten der selben 
+Länge in die anderen Systeme gesetzt werden. Im obigen Beispiel müsste 
+also 
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
+@end lilypond
+
+@noindent gesetzt werden.
+
+Verzierungsabschnitte sollten nur innerhalb von sequentiellen musikalischen 
+Ausdrücken benützt werden. Wenn sie ineinandergeschachtelt werden, kann es 
+zu Fehlermeldungen oder Abstürzen kommen.
+
+
+@node Aligning to cadenzas
+@unnumberedsubsubsec Aligning to cadenzas
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Time administration
+@unnumberedsubsubsec Time administration
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Proportional notation (introduction)
+@unnumberedsubsubsec Proportional notation (introduction)
+
+UNTRANSLATED NODE: IGNORE ME
+
diff --git a/Documentation/de/user/running.itely b/Documentation/de/user/running.itely
index 4a60831d4e..cc61bea302 100644
--- a/Documentation/de/user/running.itely
+++ b/Documentation/de/user/running.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/simultaneous.itely b/Documentation/de/user/simultaneous.itely
new file mode 100644
index 0000000000..f5c19c8dab
--- /dev/null
+++ b/Documentation/de/user/simultaneous.itely
@@ -0,0 +1,478 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Simultaneous notes
+@section Simultaneous notes
+
+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 
+von mehr als einer Stimme pro System.
+
+@menu
+* Single voice::                
+* Multiple voices::             
+@end menu
+
+
+@node Single voice
+@subsection Single voice
+
+@menu
+* Chords::                      
+* Clusters::                    
+@end menu
+
+@node Chords
+@unnumberedsubsubsec Chords
+
+@cindex Akkorde
+
+Ein Akkord wird notiert, indem die zu ihm gehörenden Tonhöhen 
+zwischen spitze Klammern (@code{<} und @code{>} gesetzt werden.
+Auf einen Akkord kann eine Dauer-Angabe folgen, genauso wie bei 
+einfachen Noten.
+
+
+@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
+<c e g>4 <c>8
+@end lilypond
+
+Siehe @ref{Chord names} für mehr Information.
+
+
+@node Clusters
+@unnumberedsubsubsec Clusters
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Multiple voices
+@subsection Multiple voices
+
+@menu
+* Basic polyphony::             
+* Explicitly instantiating voices::  
+* Collision Resolution::        
+* Automatic part combining::    
+* Writing music in parallel::   
+@end menu
+
+@node Basic polyphony
+@unnumberedsubsubsec Basic polyphony
+
+@cindex Mehrstimmigkeit
+@cindex Polyphonie
+
+Die einfachste Weise, Abschnitte mit mehr als einer Stimme pro
+Notensystem zu notieren, ist es, jede Stimme als eine
+Sequenz zu notieren (innerhalb der Klammern @code{@{...@}}) 
+und dann die beiden Klammer simultan zu kombinieren, indem
+sie mit @code{\\} getrennt werden.
+
+@funindex \\
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  c16 d e f
+  <<
+    { g4 f e | d2 e2 } \\
+    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
+    { s2. | s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+Dieser Trenner veranlasst, dass Stimmen (@internalsref{Voice}) 
+-Kontexte@footnote{Polyphone Stimmen werden in anderen
+Programmen teilweise als @qq{layers} (Schichten) bezeichnet.}
+@cindex Layers
+angelegt werden. Sie tragen die Namen @code{"1"}, @code{"2"} 
+usw. In jedem dieser Kontexte wird die Richtung von Bögen,
+Hälsen usw. entsprechend angepasst.
+
+Diese Stimmen sind alle unabhängig von der Stimme, in der die 
+Noten außerhalb der @code{<< \\ >>}-Konstruktion notiert sind.
+Das sollte man berücksichtigen, wenn man auf Stimmen-Ebene
+Veränderungen vornimmt. Das bedeutet gleichzeitig auch, dass 
+Legato- und Bindebögen nicht in eine @code{<< \\ >>}-Umgebung 
+hinein- noch aus hier hinaus ragen können. Die parallelen 
+Notenabschnitte aus unterschiedlichen @code{<< \\ >>}-Umgebungen
+hingegen gehören der gleichen Stimme an. Hier noch einmal das 
+gleiche Beispiel mit unterschiedlichen Notenköpfen und Farben 
+für jede Stimme. 
+Die Veränderung der Notenköpfe in der Hauptstimme hat keine
+Auswirkung auf die Stimmen innerhalb der  @code{<< \\ >>}-Umgebungen, 
+und die Veränderung der Notenköpfe für die untere Stimme setzt 
+sich fort in der zweiten  @code{<< \\ >>}-Umgebung. Hier ist auch 
+eine Noten über die Taktgrenze hinweg an die untere Stimme der 
+zweiten Polyphonie-Umgebung angebunden.
+
+@cindex Notenköpfe, Stile
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  <<
+    { g4 f e } \\
+    { \override NoteHead #'style = #'triangle
+      \override NoteHead #'color = #blue
+    r8 e4 d c8 ~ }
+  >> |
+  <<
+    { d2 e2 } \\
+    { c8 b16 a b8 g ~ g2 } \\
+    { \override NoteHead #'style = #'slash 
+      \override NoteHead #'color = #green
+      s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+Polyphonie verändert nicht das Verhältnis der Noten 
+innerhalb einer @code{\relative @{ @}}-Umgebung.
+Jede Note wird weiterhin errechnet aus der direkt 
+vorhergehenden.
+
+@example
+\relative @{ NoteA << NoteB \\ NoteC >> NoteD @}
+@end example
+
+@code{NoteC} ist relativ zu @code{NoteB}, nicht @code{NoteA};
+@code{NoteD} ist relativ zu @code{NoteC}, nicht @code{NoteB} oder
+@code{NoteA}.
+
+
+@node Explicitly instantiating voices
+@unnumberedsubsubsec Explicitly instantiating voices
+
+@internalsref{Voice}-Kontexte können auch manuell innerhalb 
+eines @code{<< >>}-Abschnittes initiiert werden. Mit den Befehlen 
+@code{\voiceOne} bis hin zu @code{\voiceFour} kann jeder Stimme 
+entsprechendes Verhalten von vertikaler Verschiebung und Richtung 
+von Hälsen und anderen Objekten hinzugefügt werden.
+
+Genauer gesagt,
+@example
+<< \upper \\ \lower >>
+@end example
+
+@noindent
+entspricht 
+
+@example
+<<
+  \new Voice = "1" @{ \voiceOne \upper @}
+  \new Voice = "2" @{ \voiceTwo \lower @}
+>>
+@end example
+
+Der @code{\voiceXXX}-Befehl setzt die Richtung von Hälsen, 
+Bögen, Artikulationszeichen, Text, Punktierungen und Fingersätzen. 
+ @code{\voiceOne} und @code{\voiceThree} lassen diese Objekte 
+ nach oben zeigen, 
+ @code{\voiceTwo} und @code{\voiceFour}
+dagegen lassen sie abwärts zeigen. Der Befehl 
+@code{\oneVoice} stellt wieder auf das normale Verhalten um.
+
+Ein Ausdruck, der direkt innerhalb einer @code{<< >>}-Umgebung 
+auftritt, gehört der Hauptstimme an. Das ist nützlich, wenn zusätzliche 
+Stimme auftreten, während die Hauptstimme sich fortsetzt. Hier also 
+eine bessere Version des Beispiels aus dem vorigen Abschnitt. Die 
+farbigen Kreuz-Notenköpfe zeigen, dass die Hauptstimme sich jetzt in 
+einem einzigen Stimmen (@code{voice})-Kontext befindet.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2 }
+    \new Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. | s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Und mit der richtigen Definition der Stimmen kann die Melodie auch 
+übergebunden werden.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Indem man den @code{\\}-Trenner vermeidet, gelingt es auch, mehrstimmige 
+Abschnitte ineinander zu schachteln, was in manchen Fällen die bessere 
+und natürlichere Lösung sein kann.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ |
+      <<
+        {c8 b16 a b8 g ~ g2}
+        \new Voice { \voiceThree
+          s4 b4 c2
+          \oneVoice
+        }
+      >>
+    \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+In manchen Fällen von sehr komplexer polyphoner Musik können noch 
+mehr Stimmen benötigt werden, um Zusammenstöße zwischen Noten zu 
+vermeiden. Zusätzliche Stimmen werden durch einen neuen Bezeichner 
+erstellt, wie das nächste Beispiel zeigt.
+
+@lilypond[quote,verbatim,ragged-right,relative=2]
+voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
+
+\relative c''' <<
+  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
+  { \voiceThree  b4} \\
+  { \voiceFive d,} \\
+  { \voiceTwo g,}
+>>
+@end lilypond
+
+
+@node Collision Resolution
+@unnumberedsubsubsec Collision Resolution
+
+Normalerweise werden Notenköpfe mit einer unterschiedlichen Anzahl 
+von Punktierungen nicht verschmolzen, aber wenn die Objekt-Eigenschaft 
+ @code{merge-differently-dotted} in ein 
+Notenkollisions (@internalsref{NoteCollision})-Objekt gesetzt wird, 
+werden sie zusammengefasst.
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice << {
+  g8 g8
+  \override Staff.NoteCollision
+    #'merge-differently-dotted = ##t
+  g8 g8
+} \\ { g8.[ f16] g8.[ f16] } >>
+@end lilypond
+
+Auf gleiche Art können auch Halbe mit Achteln vereinigt werden, indem 
+@code{merge-differently-headed} eingesetzt wird:
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\new Voice << {
+  c8 c4.
+  \override Staff.NoteCollision
+    #'merge-differently-headed = ##t
+c8 c4. } \\ { c2 c2 } >>
+@end lilypond
+
+@noindent
+@code{merge-differently-headed} und @code{merge-differently-dotted}
+wirken sich allerdings nur auf Noten mit unterschiedlich gerichteten 
+Hälsen aus (wie etwa Stimme 1 und 2).
+
+LilyPond verschiebt auch Pausen vertikal, die einem Hals gegenüber stehen:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new Voice << c''4 \\ r4 >>
+@end lilypond
+
+Wenn drei oder mehr Noten in der selben Spalte angeordnet werden, 
+kann @code{merge-differently-headed} nicht mehr erfolgreich die 
+Noten vereinen, die ineinander gesetzt werden müssten. Damit die 
+Vereinigung funktioniert, muss der Befehl @code{\shift} vor die
+Note gesetzt werden, auf die er Auswirkung hat. Im ersten Takt 
+des folgenden Beispiels funktioniert @code{merge-differently-headed} 
+nicht (der Notenkopf der Halben ist schwarz). Im zweiten Takt 
+wurde @code{\shiftOn} eingefügt, um das obere @code{g} aus der 
+Spalte zu rücken, und das Vereinigen funktioniert wie gewünscht.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.NoteCollision #'merge-differently-headed = ##t
+<<
+  { d=''2 g2 } \\
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+<<
+  { d'=''2 \shiftOn g2 } \\ 
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+@end lilypond
+
+
+@refcommands
+
+@funindex \oneVoice
+@code{\oneVoice},
+@funindex \voiceOne
+@code{\voiceOne},
+@funindex \voiceTwo
+@code{\voiceTwo},
+@funindex \voiceThree
+@code{\voiceThree},
+@funindex \voiceFour
+@code{\voiceFour}.
+
+@funindex \shiftOn
+@code{\shiftOn},
+@funindex \shiftOnn
+@code{\shiftOnn},
+@funindex \shiftOnnn
+@code{\shiftOnnn},
+@funindex \shiftOff
+@code{\shiftOff}: Diese Befehle definieren den Grad, mit 
+welchem Noten der aktuellen Stimmen verschoben werden 
+sollen. Die äußeren Stimmen (normalerweise 1 und 2) haben 
+den Befehl @code{\shiftOff}, die inneren dagegen (drei und 
+vier) den Befehl @code{\shiftOn}. @code{\shiftOnn} und 
+@code{\shiftOnnn} stellen weitere Verschiebungsebenen dar.
+
+Wenn LilyPond selber keine Lösung bieten kann, können die 
+Eigenschaft @code{force-hshift} des 
+@internalsref{NoteColumn}-Objektes (siehe unten) 
+sowie Pausen mit definierter Tonhöhe eingesetzt werden, 
+um Satzentscheidungen des Programmes zu überschreiben.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative <<
+{
+  <d g>
+  <d g>
+} \\ {
+  <b f'>
+  \once \override NoteColumn #'force-hshift = #1.7
+  <b f'>
+} >>
+@end lilypond
+
+
+@seealso
+
+Programmreferenz: Die Objekte, die für Auflösung von Zusammenstößen 
+zuständig sind, sind 
+@internalsref{NoteCollision} und @internalsref{RestCollision}.
+
+
+@refbugs
+
+Wenn @code{merge-differently-headed} mit einer nach oben gerichteten 
+Achtel oder kleineren Note verwendet wird, und die nach unten gerichtete 
+Note ist eine Halbe, bekommt die Achtel die falsche Richtung gesetzt.
+
+Es gibt keine Unterstützung für Cluster, in denen die gleiche Note 
+mit unterschiedlichen Vorzeichen im selben Akkord auftritt. In diesem 
+Fall sollte man eine enharmonische Transkription benutzen oder 
+die spezielle Cluster-Notationsweise, siehe @ref{Clusters}.
+
+
+@node Automatic part combining
+@unnumberedsubsubsec Automatic part combining
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Writing music in parallel
+@unnumberedsubsubsec Writing music in parallel
+
+@cindex Parallele Notation, Eingabe
+@cindex Eingabe von Noten parallel
+@cindex Verschachtelte Musik
+
+Noten für mehrere Stimmen können verschachtelt notiert werden:
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
+  c'2                                c'2                                |
+  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
+  c'2                                c'2                                |
+}
+\new StaffGroup <<
+  \new Staff \new Voice \voiceA
+  \new Staff \new Voice \voiceB
+>>
+@end lilypond
+
+Das funktioniert ziemlich gut für Klaviernoten:
+
+@lilypond[quote,verbatim]
+music = {
+  \key c \major
+  \time 4/4
+  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
+    % Bar 1
+    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
+e''] |
+    c'2                                 c'2 |
+    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
+    c2                                  c2 |
+
+    % Bar 2
+    a'8 b'      c'' d''    e'' f''    g'' a'' |
+    d'4         d'         d'         d' |
+    c16 d e f   d e f g    e f g a    f g a b |
+    a,4         a,4        a,4        a,4 |
+
+    % Bar 3 ...
+  }
+}
+
+\score {
+  \new PianoStaff <<
+    \music
+    \new Staff <<
+      \voiceA \\
+      \voiceB
+    >>
+    \new Staff {
+      \clef bass
+      <<
+        \voiceC \\
+        \voiceD
+      >>
+    }
+  >>
+}
+@end lilypond
+
+
diff --git a/Documentation/de/user/spacing.itely b/Documentation/de/user/spacing.itely
index 3e745f2d00..9327914f68 100644
--- a/Documentation/de/user/spacing.itely
+++ b/Documentation/de/user/spacing.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 57271e99d4571e2bda7e3991d4050b59519028c0
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/de/user/specialist.itely b/Documentation/de/user/specialist.itely
new file mode 100644
index 0000000000..66edc579f2
--- /dev/null
+++ b/Documentation/de/user/specialist.itely
@@ -0,0 +1,34 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Specialist notation
+@chapter Specialist notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Vocal music:: a
+* Chords Blah:: b
+* Piano music:: c
+* Percussion:: d
+* Guitar:: e
+* Orchestral strings::
+* Bagpipes::
+* Ancient notation:: g
+@end menu
+
+@include vocal.itely
+@include chords.itely
+@include piano.itely
+@include percussion.itely
+@include guitar.itely
+@include strings.itely
+@include bagpipes.itely
+@include ancient.itely
+
+
diff --git a/Documentation/de/user/staff.itely b/Documentation/de/user/staff.itely
new file mode 100644
index 0000000000..becb7e1ecd
--- /dev/null
+++ b/Documentation/de/user/staff.itely
@@ -0,0 +1,209 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Staff notation
+@section Staff notation
+
+staff = singular, staves = plural
+
+@menu
+* Displaying staves::           
+* Writing parts::               
+@end menu
+
+
+@node Displaying staves
+@subsection Displaying staves
+
+@menu
+* System start delimiters::     
+* Staff symbol::                
+* Hiding staves::               
+@end menu
+
+@node System start delimiters
+@unnumberedsubsubsec System start delimiters
+
+@cindex Beginn eines Notensystems
+@cindex Systeme, mehrere
+@cindex Notensysteme, mehrere
+@cindex Klammer, vertikal
+@cindex Klammer, geschweift
+@cindex Partitur
+@cindex Systemgruppe
+@cindex Instrumentengruppe
+@cindex Stimmgruppe
+@cindex System, Chor
+
+Viele Partituren bestehen aus mehr als einem Notensystem. Diese Systeme 
+können auf vier unterschiedliche Arten verbunden werden:
+
+@itemize @bullet
+@item Die Gruppe wird mit einer Klammer an der linken Seite geöffnet und 
+die Taktlinien sind verbunden. Das ist der Klaviersystem 
+(@internalsref{GrandStaff})-Kontext.
+
+@lilypond[verbatim,ragged-right,quote]
+\new GrandStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item Die Gruppe beginnt mit einer Klammer und die Taktlinien sind verbunden. 
+Dieses Verhalten erzeugt der Stimmgruppen 
+(@internalsref{StaffGroup})-Kontext.
+
+@lilypond[verbatim,ragged-right,quote]
+\new StaffGroup
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item Die Gruppe beginnt mit einer Klammer, aber die Taktlinien sind nicht 
+miteinander verbunden. Das wird mit dem Chorsystem 
+(@internalsref{ChoirStaff})-Kontext erreicht.
+
+@lilypond[verbatim,ragged-right,quote]
+\new ChoirStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item Die Gruppe beginnt mit einer vertikalen Linie. Taktlinien sind nicht 
+verbunden. Das ist die Standardeinstellung für eine Partitur.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+@end itemize
+
+
+@seealso
+
+Die Definition der Taktlinien am Beginn jedes Systems werden mit 
+den Befehlen @internalsref{SystemStartBar}, @internalsref{SystemStartBrace} 
+und @internalsref{SystemStartBracket} festgelegt. Nur einer dieser 
+drei Typen wird in jedem Kontext erstellt, und dieser Typ wird durch 
+die @code{systemStartDelimiter}-Eigenschaft bestimmt.
+
+
+@commonprop
+
+Anfangsklammern können tief einander verschachtelt werden.
+
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup
+\relative <<
+  \set StaffGroup.systemStartDelimiterHierarchy
+    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+>>
+@end lilypond
+
+
+@node Staff symbol
+@unnumberedsubsubsec Staff symbol
+
+@cindex Justierung von Notensystemen
+@cindex Notensysteme, Modifikation
+
+Noten, Dynamikzeichen usw. werden auf den Notenlinien angeordnet, die 
+sich zu einem Notensystem zusammenfassen lassen. Das Programm LilyPond 
+zeichnet diese Linien durch ein spezielles graphisches Objekt, 
+@code{staff symbol} (engl. @qq{staff} = Notensystem) genannt.
+
+Dieses Objekt kann bezüglich seiner Eigenschaften, wie Anzahl, Dicke und 
+Abstand der Linien verändert werden. Das wird gezeigt in den Beispieldateien 
+@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} und
+@lsr{staff,changing-the-staff-size.ly}.
+
+Zusätzlich können Systeme beliebig begonnen und beendet werden. Das 
+geschieht mit den Befehlen @code{\startStaff} und @code{\stopStaff}.
+
+@lilypond[verbatim,relative=2,fragment]
+b4 b
+\override Staff.StaffSymbol #'line-count = 2
+\stopStaff \startStaff
+b b
+\revert Staff.StaffSymbol #'line-count
+\stopStaff \startStaff
+b b
+@end lilypond
+
+Kombiniert mit verkleinerten Systemen, kann man diese Funktion etwa 
+benutzen, um Ossia-Abschnitte zu notieren. Siehe das Beispiel:
+
+@cindex Ossia
+
+@c @lilypondfile{ossia.ly}
+
+@cindex Notenlinien, Anzahl
+@cindex Notenlinien, Dicke
+@cindex Dicke der Notenlinien einstellen
+@cindex Anzahl der Notenlinien einstellen
+@cindex Zahl der Notenlinien einstellen
+
+@seealso
+
+Programmreferenz: @internalsref{StaffSymbol}.
+
+Beispiele: @lsrdir{staff}
+
+
+@node Hiding staves
+@unnumberedsubsubsec Hiding staves
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Writing parts
+@subsection Writing parts
+
+@menu
+* Metronome marks::             
+* Instrument names::            
+* Quoting other voices::        
+* Formatting cue notes::        
+@end menu
+
+@node Metronome marks
+@unnumberedsubsubsec Metronome marks
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Instrument names
+@unnumberedsubsubsec Instrument names
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Quoting other voices
+@unnumberedsubsubsec Quoting other voices
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Formatting cue notes
+@unnumberedsubsubsec Formatting cue notes
+
+UNTRANSLATED NODE: IGNORE ME
+
diff --git a/Documentation/de/user/strings.itely b/Documentation/de/user/strings.itely
new file mode 100644
index 0000000000..9b3543cd2c
--- /dev/null
+++ b/Documentation/de/user/strings.itely
@@ -0,0 +1,42 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Orchestral strings
+@section Orchestral strings
+
+This section includes extra information for writing for orchestral
+strings.
+
+@menu 
+* Orchestral strings TODO::
+@end menu
+
+@node Orchestral strings TODO
+@subsection Orchestral strings TODO
+
+
+@menu 
+* Artificial harmonics (strings)::
+@end menu
+
+@node Artificial harmonics (strings)
+@unnumberedsubsubsec Artificial harmonics (strings)
+
+@cindex Flageolett
+
+Flageolett-Töne werden mit einem anderen Notenkopfstil notiert. 
+Sie werden eingegeben, indem die Flageolettnote mit dem 
+Befehl @code{\harmonic} markiert wird.
+
+@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
+<c g'\harmonic>4
+@end lilypond
+
+
diff --git a/Documentation/de/user/text.itely b/Documentation/de/user/text.itely
new file mode 100644
index 0000000000..b4a6545a11
--- /dev/null
+++ b/Documentation/de/user/text.itely
@@ -0,0 +1,8 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
diff --git a/Documentation/de/user/tutorial.itely b/Documentation/de/user/tutorial.itely
index 4e0c5bd2b4..7545bb05fc 100644
--- a/Documentation/de/user/tutorial.itely
+++ b/Documentation/de/user/tutorial.itely
@@ -61,7 +61,7 @@ Wenn Sie einfach alles kopieren, was im
  @qq{ly snippet} Abschnitt steht, und in eine Text-Datei
 einfügen, haben Sie schon eine fertige Vorlage für weitere
 Experimente. Wenn Sie auf diese Weise lernen, lohnt es
-sich wohl, das Kapitel @ref{Cheat sheet} auszudrucken oder
+sich wohl, das Kapitel @ruser{Cheat sheet} auszudrucken oder
 ein Lesezeichen dafür im Browser zu setzen. Hier sind die wichtigsten
 LilyPond-Befehle zum schnellen Nachschlagen aufgelistet.
 @end ifhtml
@@ -261,7 +261,7 @@ Ausnahme entsprechen sie den deutschen, deshalb wird die Voreinstellung
 von LilyPond für diese Übung beibehalten. Die @emph{Ausnahme} ist das h -- in 
 LilyPond muss man anstelle dessen b schreiben! Das deutsche b dagegen
 wird als bes notiert, ein his dagegen würde bis geschrieben. Siehe auch 
-Kap. @ref{Accidentals} und @ref{Note names in other languages}, hier wird beschrieben,
+Kap. @ruser{Accidentals} und @ruser{Note names in other languages}, hier wird beschrieben,
 wie sich die deutschen Notennamen benutzen lassen.
 @c end addition
 
@@ -409,17 +409,17 @@ Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Eingabe von Tonhöhen und -dauern
-siehe @ref{Pitches} und @ref{Durations}.
+siehe @ruser{Pitches} und @ruser{Durations}.
 @item Pausen
-siehe @ref{Rests}.
+siehe @ruser{Rests}.
 @item Taktangeben und andere Zeitangaben
-siehe @ref{Time signature}.
+siehe @ruser{Time signature}.
 @item Notenschlüssel
-siehe @ref{Clef}.
+siehe @ruser{Clef}.
 @end table
 @end quotation
 
@@ -512,13 +512,13 @@ mögliche Anwendung von Kommentaren:
 
 Weitere Vorschläge zur Konstruktion von Quelldateien
 finden sich in
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
 
 
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-Wie wir in @ref{Working on text files} gesehen haben, muss LilyPond-Code
+Wie wir in @ruser{Working on text files} gesehen haben, muss LilyPond-Code
 immer von  @{ @} Zeichen oder einem @code{\relative c'' @{ ... @}} umgeben sein.
 Im Rest dieses Handbuchs werden die meisten Beispiel allerdings darauf
 verzichten.
@@ -565,10 +565,10 @@ die für eine Stimme auf einem System gebraucht werden.
 @node Relative note names
 @subsection Relative note names
 
-Wie wir im Kapitel @ref{Simple notation} gesehen haben,
+Wie wir im Kapitel @ruser{Simple notation} gesehen haben,
 errechnet LilyPond die Tonhöhe der folgenden Noten bezüglich
 der vorhergehenden.@footnote{Es gibt noch einen anderen Eingabemodus
-für Tonhöhen, siehe @ref{Absolute note names}, aber für die Praxis ist
+für Tonhöhen, siehe @ruser{Absolute note names}, aber für die Praxis ist
 der relative Modus viel einfacher und sicherer zu benutzen.} Wenn
 keine
 zusätzlichen Oktavierungszeichen (@code{'} und @code{,}) gesetzt sind,
@@ -587,13 +587,13 @@ c2 fis
 c2 ges
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Relativer Oktaveintrag
-siehe @ref{Relative octaves}.
+siehe @ruser{Relative octaves}.
 @item Oktaveüberprüfung
-siehe @ref{Octave check}.
+siehe @ruser{Octave check}.
 @end table
 @end quotation
 
@@ -618,7 +618,7 @@ von @q{isis} oder @q{eses} geschrieben.@footnote{Diese Syntax
 stammt aus der Tradition der germanischen Sprachen und ist also für
 deutsche Benutzer kein Problem. Es ist aber möglich, die Namen anderer
 Sprachen zu benutzen, siehe
-@ref{Note names in other languages}.}
+@ruser{Note names in other languages}.}
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 cis1 ees fisis, aeses
@@ -689,16 +689,16 @@ etwas mehr Schreibarbeit, hat aber den großen Vorteil, das
 Transposition
 sehr viel einfacher gemacht wird und der Druck von Versetzungszeichen nach
 unterschiedlichen Regeln erfolgen kann. Siehe
-@ref{Automatic accidentals} für einige Beispiele, wie Vorzeichen
+@ruser{Automatic accidentals} für einige Beispiele, wie Vorzeichen
 anhand von unterschiedlichen Regeln ausgegeben werden können.
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Versetzungszeichen
-siehe @ref{Accidentals} und @ref{Automatic accidentals}.
+siehe @ruser{Accidentals} und @ruser{Automatic accidentals}.
 @item Tonart (Vorzeichen)
-siehe @ref{Key signature}.
+siehe @ruser{Key signature}.
 @end table
 @end quotation
 
@@ -758,15 +758,15 @@ geschachtelt werden.
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Bindebögen
-siehe @ref{Ties}.
+siehe @ruser{Ties}.
 @item Legatobögen
-siehe @ref{Slurs}.
+siehe @ruser{Slurs}.
 @item Phrasierungsbögen
-siehe @ref{Phrasing slurs}.
+siehe @ruser{Phrasing slurs}.
 @end table
 @end quotation
 
@@ -829,15 +829,15 @@ beziehungsweise @code{\>} begonnen.  Ein Dynamik-Zeichen, etwa
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Artikulationszeichen
-siehe @ref{Articulations}.
+siehe @ruser{Articulations}.
 @item Fingersatz
-siehe @ref{Fingering instructions}.
+siehe @ruser{Fingering instructions}.
 @item Dynamik
-siehe @ref{Dynamics}.
+siehe @ruser{Dynamics}.
 @end table
 @end quotation
 
@@ -862,13 +862,13 @@ anfängt, erhält ein @q{[} (AltGr+8) und die, an der er endet, ein
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Automatische Balken
-siehe @ref{Automatic beams}.
+siehe @ruser{Automatic beams}.
 @item Manuelle Balken
-siehe @ref{Manual beams}.
+siehe @ruser{Manual beams}.
 @end table
 @end quotation
 
@@ -921,15 +921,15 @@ c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Vorschläge, Verzierungen
-siehe @ref{Grace notes},
+siehe @ruser{Grace notes},
 @item Triolen
-siehe @ref{Tuplets},
+siehe @ruser{Tuplets},
 @item Auftakt
-siehe @ref{Partial measures}.
+siehe @ruser{Partial measures}.
 @end table
 @end quotation
 
@@ -1069,7 +1069,7 @@ werden. Das wird benötigt für komplexe Musik mit vielen Stimmen.
 @node Multiple staves
 @subsection Multiple staves
 
-Wie wir in @ref{Music expressions explained} gesehen haben, sind
+Wie wir in @ruser{Music expressions explained} gesehen haben, sind
 LilyPond-Quelldateien aus musikalischen Ausdrücken konstruiert.
 Wenn die Noteneingabe mit parallelen Ausdrücken beginnt, werden
 mehrere Notensysteme erstellt. Es ist aber sicherer und einfacherer
@@ -1114,7 +1114,7 @@ erweitert.
 Die Taktangabe, die in einem einzelnen System angegeben wird, wirkt
 sich auf alle anderen System aus.@footnote{Dies kann natürlich auch geändert
 werden, siehe
-@ref{Polymetric notation} für Einzelheiten.} Die 
+@ruser{Polymetric notation} für Einzelheiten.} Die 
 Angabe der Tonart in einem System hingegen beeinflusst @emph{nicht} die 
 Tonart der anderen Systeme.
 
@@ -1143,7 +1143,7 @@ Musik für das Klavier wird üblicherweise auf zwei Systemen notiert,
 die durch eine geschweifte Klammer verbunden sind (Akkolade). 
 Um ein derartiges
 Notensystem zu erstellen, geht man ähnlich vor wie in dem Beispiel
-aus @ref{Multiple staves}, nur dass der gesamte Ausdruck jetzt in
+aus @ruser{Multiple staves}, nur dass der gesamte Ausdruck jetzt in
 eine @code{PianoStaff}-Umgebung eingefügt wird.
 
 @example
@@ -1164,9 +1164,9 @@ Hier ein kleines Beispiel:
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Siehe @ref{Piano music}.
+Siehe @ruser{Piano music}.
 @end quotation
 
 @node Combining notes into chords
@@ -1247,9 +1247,9 @@ kombiniert werden.
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Siehe @ref{Basic polyphony}.
+Siehe @ruser{Basic polyphony}.
 @end quotation
 
 
@@ -1331,10 +1331,10 @@ dargestellt.
 @end lilypond
 @c \addlyrics { In -- te -- res -- sant }
 
-@moreinfo
+@seealso
 @quotation
 Mehr Möglichkeiten, wie etwa mehrere Strophen unter der gleichen
-Melodie, werden im Kapitel @ref{Vocal music} gezeigt.
+Melodie, werden im Kapitel @ruser{Vocal music} gezeigt.
 @end quotation
 
 
@@ -1391,10 +1391,10 @@ kombiniert, hat man ein Song-Blatt.
 @end lilypond
 @c \addlyrics { Frei und froh denkt der Mensch __ }
 
-@moreinfo
+@seealso
 @quotation
 Eine vollständige Liste der Akkordbezeichnungen und andere
-Optionen für das Layout sind im Kapitel @ref{Chords} zu
+Optionen für das Layout sind im Kapitel @ruser{Chords} zu
 finden.
 @end quotation
 
@@ -1464,7 +1464,7 @@ direkt nach der Versionsnummer eingefügt.
 
 Wenn die Datei übersetzt wird, werden Titel- und Komponisteneinträge
 über der Musik ausgegeben. Mehr Information über die Titelei findet
-sich im Kapitel @ref{Creating
+sich im Kapitel @ruser{Creating
 titles}.
 
 
@@ -1633,13 +1633,13 @@ Benutzung der eben definierten Bezeichner:
 
 Wenn Sie diese Übung absolviert haben, sollten Sie am
 besten ein paar Stücke selber notieren. Beginnen Sie mit
-den @ref{Templates} und fügen Sie einfach Ihre Noten
+den @ruser{Templates} und fügen Sie einfach Ihre Noten
 dazu. Wenn Sie irgendetwas brauchen, das nicht in der
 Übung besprochen wurde, schauen Sie sich den Abschnitt Alles
- über die Notation an, angefangen mit @ref{Basic notation}.
+ über die Notation an, angefangen mit @ruser{Basic notation}.
 Wenn Sie für ein Instrument oder Ensemble Noten schreiben
 wollen, für das es keine Vorlage gibt, schauen Sie ins
-Kapitel  @ref{Extending the templates}.
+Kapitel  @ruser{Extending the templates}.
 
 Wenn Sie ein paar kurze Stücke notiert haben, lesen Sie
 den Rest des Lernhandbuchs (Kapitel 3--5). Natürlich können
@@ -1653,7 +1653,7 @@ Sie einige Erfahrunge im Notieren gewonnen haben.
 @node How to read the manual
 @subsection How to read the manual
 
-Wie wir im Kapitel @ref{How to read the tutorial} gesehen haben,
+Wie wir im Kapitel @ruser{How to read the tutorial} gesehen haben,
 haben wir bei vielen Beispielen in der Übung die
 @code{\relative c''}-Umgebung weggelassen.
 
@@ -1673,6 +1673,6 @@ Sie auf die Notenbilder, um die dazugehörige Textdatei anzuschauen,
 mit der dieses Notenbild erstellt worden ist.
 
 Mehr Information über die Struktur des restlichen Benutzerhandbuches 
-erhalten Sie im Abschnitt @ref{About this manual}.
+erhalten Sie im Abschnitt @ruser{About this manual}.
 
 
diff --git a/Documentation/de/user/tweaks.itely b/Documentation/de/user/tweaks.itely
index 24d7575c5b..8fd4c01d24 100644
--- a/Documentation/de/user/tweaks.itely
+++ b/Documentation/de/user/tweaks.itely
@@ -143,7 +143,7 @@ Um das Verhalten zu verändern, so dass alles, was nach dem Befehl
 kommt, verändert wird, müssen Sie den Befehl @code{\once} weglassen. 
 Um die Veränderung zu stoppen, benutzen Sie den Befehl @code{\revert}.
 Das wird genauer im Kapitel
-@ref{The \override command} erklärt.
+@ruser{The \override command} erklärt.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
@@ -165,13 +165,13 @@ c4^"piu mosso" d e f
 
 @seealso
 
-@ref{The \override command}, @ref{Common tweaks}.
+@ruser{The \override command}, @ruser{Common tweaks}.
 
 
 @node Fixing overlapping notation
 @section Fixing overlapping notation
 
-Im Kapitel @ref{Moving objects} wurde gezeigt, wie man Texte 
+Im Kapitel @ruser{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 
@@ -179,7 +179,7 @@ ersetzt werden.
 
 Um den Objektnamen zu finden, siehe die @q{@strong{see also}}-Hinweise 
 am Ende des jeweiligen Abschnittes. Zum Beispiel am Ende des
-Kapitels  @ref{Dynamics} findet sich:
+Kapitels  @ruser{Dynamics} findet sich:
 
 @quotation
 @seealso
@@ -259,7 +259,7 @@ für bestimmte Objekte zuständig ist. Weil das
  @code{MetronomeMark}-Objekt vom @code{Score}-Kontext gesetzt 
 wird, werden Veränderungen innerhalb des @code{Voice}-Kontextes 
 nicht berücksichtigt. Genauere Details im Kapitel
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
 
 @cindex extra-offset
 @cindex zusätzlicher Abstand
@@ -395,7 +395,7 @@ ist, um die Systeme noch unterzubringen.
 Wenn man versucht, das Layout zu verändern, kommt einem 
 der Befehl @code{annotate-spacing} zu Hilfe. Mit diesem 
 Befehl erhält man die Werte von verschiedenen Abstandsbefehlen 
-ausgedruckt, mehr Information im Kapitel @ref{Displaying spacing}. 
+ausgedruckt, mehr Information im Kapitel @ruser{Displaying spacing}. 
 Anhand dieser Angaben kann dann entschieden werden, welche 
 Werte verändert werden müssen.
 
@@ -449,7 +449,7 @@ weit @qq{hervorstehen}, zu verschieben.
 @item
 Die horizontalen Abstände können mit der 
  @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
-@ref{Changing horizontal spacing} für Einzelheiten.
+@ruser{Changing horizontal spacing} für Einzelheiten.
 
 @lilypond[verbatim,quote]
 \score {
@@ -480,8 +480,8 @@ 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 
- @ref{Scheme tutorial} und den
-@ref{Interfaces for programmers}.
+ @ruser{Scheme tutorial} und den
+@ruser{Interfaces for programmers}.
 
 Scheme kann benutzt werden, um einfach nur Befehle zu @qq{überschreiben} 
 (@code{\override}):
diff --git a/Documentation/de/user/vocal.itely b/Documentation/de/user/vocal.itely
new file mode 100644
index 0000000000..fc99cbeb69
--- /dev/null
+++ b/Documentation/de/user/vocal.itely
@@ -0,0 +1,150 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Vocal music
+@section Vocal music
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* TODO subsection vocal music::
+@end menu 
+@node TODO subsection vocal music
+@subsection TODO subsection vocal music
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* Setting simple songs::
+* Entering lyrics::
+* Aligning lyrics to a melody::
+* Automatic syllable durations::
+* Another way of entering lyrics::
+* Assigning more than one syllable to a single note::
+* More than one note on a single syllable::
+* Extenders and hyphens::
+* Working with lyrics and identifiers::
+* Flexibility in placement::
+* Lyrics to multiple notes of a melisma::
+* Divisi lyrics::
+* Switching the melody associated with a lyrics line::
+* Lyrics independent of notes::
+* Spacing lyrics::
+* More about stanzas::
+* Other vocal issues::
+@end menu 
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Entering lyrics
+@unnumberedsubsubsec Entering lyrics
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Aligning lyrics to a melody
+@unnumberedsubsubsec Aligning lyrics to a melody
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* Automatic syllable durations::
+* Another way of entering lyrics::
+* Assigning more than one syllable to a single note::
+* More than one note on a single syllable::
+* Extenders and hyphens::
+@end menu 
+@node Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Another way of entering lyrics
+@unnumberedsubsubsec Another way of entering lyrics
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Assigning more than one syllable to a single note
+@unnumberedsubsubsec Assigning more than one syllable to a single note
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node More than one note on a single syllable
+@unnumberedsubsubsec More than one note on a single syllable
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Working with lyrics and identifiers
+@unnumberedsubsubsec Working with lyrics and identifiers
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Flexibility in placement
+@unnumberedsubsubsec Flexibility in placement
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* Lyrics to multiple notes of a melisma::
+* Divisi lyrics::
+* Switching the melody associated with a lyrics line::
+* Lyrics independent of notes::
+@end menu 
+@node Lyrics to multiple notes of a melisma
+@unnumberedsubsubsec Lyrics to multiple notes of a melisma
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Switching the melody associated with a lyrics line
+@unnumberedsubsubsec Switching the melody associated with a lyrics line
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Spacing lyrics
+@unnumberedsubsubsec Spacing lyrics
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node More about stanzas
+@unnumberedsubsubsec More about stanzas
+
+UNTRANSLATED NODE: IGNORE ME
+
+@unnumberedsubsubsec Adding stanza numbers 
+@unnumberedsubsubsec Adding dynamics marks
+@unnumberedsubsubsec Adding singer names
+@unnumberedsubsubsec Printing stanzas at the end 
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns 
+@node Other vocal issues
+@unnumberedsubsubsec Other vocal issues
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+-- SKELETON FILE --
+When you actually translate this file, please remove these lines as
+well as all `UNTRANSLATED NODE: IGNORE ME' lines.
diff --git a/Documentation/de/user/working.itely b/Documentation/de/user/working.itely
index 66f064c469..acd4be3d15 100644
--- a/Documentation/de/user/working.itely
+++ b/Documentation/de/user/working.itely
@@ -80,9 +80,9 @@ frustrierend sein kann zu erinnern, welche Programmversion man etwa
 vor einem Jahr verwendet hat. Auch @code{convert-ly} benötigt die 
 Versionsnummer.
 
-@item @strong{Benutzen Sie Überprüfungen}: @ref{Bar check}, 
-@ref{Octave check} und
-@ref{Barnumber check}.  Wenn Sie hier und da diese Überprüfungen 
+@item @strong{Benutzen Sie Überprüfungen}: @ruser{Bar check}, 
+@ruser{Octave check} und
+@ruser{Barnumber check}.  Wenn Sie hier und da diese Überprüfungen 
 einfügen, finden Sie einen möglichen Fehler weit schneller. Wie oft 
 aber 
 ist @qq{hier und da}? Das hängt von der Komplexität der Musik ab. Bei 
@@ -117,9 +117,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 @ref{Saving typing with identifiers and functions} 
+Noten. Siehe auch @ruser{Saving typing with identifiers and functions} 
 und
-@ref{Style sheets}.
+@ruser{Style sheets}.
 
 @end itemize
 
@@ -137,7 +137,7 @@ LilyPond-Eingabe einer gedruckten Partitur):
 Sie jedes System, nachdem Sie es fertig kopiert haben. Mit dem 
 @code{showLastLength}-Befehl können Sie den Übersetzungsprozess 
 beschleunigen. Siehe auch 
-@ref{Skipping corrected music}.
+@ruser{Skipping corrected music}.
 
 @item Definieren Sie @code{mBreak = @{ \break @}} und schreiben Sie
  @code{\mBreak} in der Quelldatei immer dann, wenn im Manuskript 
@@ -180,7 +180,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Trennen Sie Einstellungen von den Noten}.  Diese 
-Empfehlung wurde schon im Abschnitt @ref{General suggestions} gegeben, 
+Empfehlung wurde schon im Abschnitt @ruser{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, 
@@ -296,9 +296,9 @@ padText =
 
 Die Benutzung von Variablen hilft auch, viele Schreibarbeit zu 
 vermeiden, wenn die Eingabesyntax von LilyPond sich verändert 
-(siehe auch @ref{Updating old files}). Wenn nur eine einzige 
+(siehe auch @ruser{Updating old files}). Wenn nur eine einzige 
 Definition (etwa @code{\dolce}) für alle Dateien verwendet wird 
-(vgl. @ref{Style sheets}), muss nur diese einzige Definition 
+(vgl. @ruser{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.
 
@@ -306,14 +306,14 @@ des Befehles beziehen sich dann auf die neue Definition.
 @section Style sheets
 
 Die Ausgabe, die LilyPond erstellt, kann sehr start modifiziert 
-werden, siehe @ref{Tweaking output} für Einzelheiten. Aber wie 
+werden, siehe @ruser{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 @ref{Advanced tweaks with Scheme} erklärt.
+wird im Kapitel @ruser{Advanced tweaks with Scheme} erklärt.
 
 @lilypond[quote,verbatim,ragged-right]
 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@@ -334,7 +334,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 @ref{Moving objects}.
+werden beseitigt mit den Tricks aus dem Kapitel @ruser{Moving objects}.
 Aber auch die @code{mpdolce} und @code{tempoMark}-Defintiionen 
 können verbessert werden. Sie produzieren das Ergebnis, das 
 gewünscht ist, aber es wäre schön, sie auch in anderen Stücken 
@@ -653,7 +653,7 @@ Bassstimme wieder hineinzunehmen, bis Sie die problematische
 Zeile finden.
 
 Eine andere nützliche Technik zur Problemlösung ist es, 
-@ref{Minimal examples} zu konstruieren.
+@ruser{Minimal examples} zu konstruieren.
 
 
 @node Minimal examples
diff --git a/Documentation/devel.html.in b/Documentation/devel.html.in
index a82c9ee063..078b184496 100644
--- a/Documentation/devel.html.in
+++ b/Documentation/devel.html.in
@@ -69,6 +69,8 @@
           <td valign="baseline" class="left-column">
           &nbsp;
 	<ul>
+	    <li><a class="title" href="http://lilypond.org/web/devel">lilypond.org development page</a>
+              <br>(for all contributors)
             <li><a class="title" href="devel.html">lilypond.git repository</a>
               <br>(official sources)
             <li><a class="title" href="http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=README;hb=gub">GUB Readme</a>
@@ -77,7 +79,9 @@
     </td><td class="right-column">
           &nbsp;
 	<ul>
-            <li>lilypond.org <a class="title" href="http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=README;hb=web">Readme</a>
+	    <li><a class="title" href="http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=Documentation/user/README.txt;hb=lilypond/gdp">Documentation Readme</a>
+	      <br>(for documentation editors)
+            <li><a class="title" href="http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=README;hb=web">lilypond.org Readme</a>
 and <a class="title" href="http://git.sv.gnu.org/gitweb/?p=lilypond.git;a=blob_plain;f=TRANSLATION;hb=web">Translation</a>
               <br>(how to translate and build lilypond.org website)
             <li>
diff --git a/Documentation/es/index.html.in b/Documentation/es/index.html.in
index 69f45d57d3..a9755e4ef3 100644
--- a/Documentation/es/index.html.in
+++ b/Documentation/es/index.html.in
@@ -48,7 +48,7 @@
           <td class="left-column">
 	  <ul>
 	    <li>
-	    <a class="title" href="user/lilypond/Tutorial.es.html">Tutorial</a>
+	    <a class="title" href="user/lilypond-learning/index.es.html">Tutorial</a>
 	      <br>(comience por aquí)
 
 	   <li><a class="title" href="user/music-glossary/index.html">Glosario</a> multilingüe<br>
diff --git a/Documentation/es/user/advanced-notation.itely b/Documentation/es/user/advanced-notation.itely
index 97adc5b6c7..ab461df46b 100644
--- a/Documentation/es/user/advanced-notation.itely
+++ b/Documentation/es/user/advanced-notation.itely
@@ -1,1401 +1,31 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 90541cc59a99d0b53baccedc0327748b760fce68
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-
-@node Advanced notation
-@chapter Advanced notation
-
-Este capítulo se ocupa de la notación avanzada o de uso poco frecuente.
-
-@menu
-* Text::                        
-* Preparing parts::             
-* Orchestral music::            
-* Contemporary notation::       
-* Educational use::             
-@end menu
-
-
-
-@node Text
-@section Text
-
-Esta sección explica cómo incluir texto (con diversos estilos de formateo) en las
-partituras.
-
-@cindex Texto, en otros idiomas
-Para escribir texto con caracteres acentuados y especiales (como los de idiomas distintos del inglés),
-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
-* Text scripts::                
-* Text and line spanners::      
-* Text spanners::               
-* Text marks::                  
-* Text markup::                 
-* Nested scores::               
-* Page wrapping text::          
-* Overview of text markup commands::  
-* Overview of text markup list commands::  
-* Font selection::              
-* New dynamic marks::           
-@end menu
-
-
-@node Text scripts
-@subsection Text scripts
-
-@cindex Texto, inscripciones de
-@cindex texto, elementos no vacíos de
-@cindex no vacíos, textos
-
-Es posible colocar cadenas de texto arbitrarias o @ref{Text markup},
-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{\fatText}, las anchuras se tendrán en cuenta
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c4^"longtext" \fatText c4_"longlongtext" c4
-@end lilypond
-
-@noindent
-Para evitar que el texto influya sobre el espaciado, utilice @code{\emptyText}.
-
-También se pueden añadir a una nota textos con un formato más complejo utilizando la
-orden markup (marcado),
-
-@lilypond[fragment,ragged-right,verbatim,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-La instrucción @code{\markup} se describe con más detalle en
-@ref{Text markup}.
-
-
-@refcommands
-
-@funindex \fatText
-@code{\fatText},
-@funindex \emptyText
-@code{\emptyText}.
-
-
-@commonprop
-
-La comprobación (por parte del programa) que asegura que las inscripciones de texto y la letra se encuentran dentro de los márgenes, es
-una tarea computacional relativamente grande.  Para acelerar el procesado, lilypond de entrada no realiza
-dichos cálculos; para habilitarlo, utilice
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-
-@seealso
-
-En este manual: @ref{Text markup}.
-
-Referencia del programa: @internalsref{TextScript}.
-
-
-@node Text and line spanners
-@subsection Text and line spanners
-
-Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
-@i{accelerando} y los @i{trinos} se escriben como texto y se extienden
-sobre muchos compases mediante líneas, a veces punteadas u onduladas.
-
-Todos ellos usan las mismas rutinas que el glissando para dibujar los textos y las líneas,
-y por ello el ajuste fino de su comportamiento se hace de la
-misma manera. Se hace con un spanner (un objeto de extensión), y la rutina responsable
-de dibujar los objetos de extensión es @code{ly:line-interface::print}. Esta
-rutina determina la colocación exacta de los dos @i{extremos del
-objeto de extensión} y dibuja una línea entre ellos, en el estilo solicitado.
-
-He aquí un ejemplo de los distintos estilos de línea disponibles, y cómo
-aplicarles ajustes finos.
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-d2 \glissando d'2
-\once \override Glissando #'dash-fraction = #0.5
-d,2 \glissando d'2
-\override Glissando #'style = #'dotted-line
-d,2 \glissando d'2
-\override Glissando #'style = #'zigzag
-d,2 \glissando d'2
-\override Glissando #'style = #'trill
-d,2 \glissando d'2
-@end lilypond
-
-La información que determina los puntos extremos se calcula al vuelo
-para cada objeto gráfico, pero es posible sobreescribirlos.
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-e2 \glissando f
-\once \override Glissando #'bound-details #'right #'Y = #-2
-e2 \glissando f
-@end lilypond
-
-El objeto @code{Glissando}, como cualquier otro que use la rutina
-@code{ly:line-interface::print}, conlleva una lista asociativa
-anidada. En la instrucción anterior, el valor de @code{Y}
-se establece a @code{-2} para la lista asociativa correspondiente al extremo final de la
-derecha. Por supuesto, también es posible ajustar el extremo de la izquierda con
-@code{left} en vez de @code{right}.
-
-Si no se establece el valor de @code{Y}, se calcula a partir de la posición
-vertical del punto de anclaje derecho del objeto de extensión.
-
-En el caso de un salto de línea, los valores de los puntos extremos se extienden
-con los contenidos de las sublistas @code{left-broken} y @code{right-broken},
-por ejemplo
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-\override Glissando #'breakable = ##T 
-\override Glissando #'bound-details #'right-broken #'Y = #-3
-c1 \glissando \break
-f1
-@end lilypond
-
-Las siguientes propiedades se pueden usar para el ajuste fino de los objetos de extensión:
-
-@table @code
-@item Y
-Establece la coordenada Y del punto extremo, en espacios de pentagrama.  Por
-omisión, es el centro del objeto con que enlaza.  Así, para un glissando
-apuntaría al centro vertical de la cabeza de la nota.
-
-Para objetos de extensión horizontales, como el de texto y los trinos, tiene el valor
-fijo de cero.
-
-@item attach-dir
-Determina el lugar donde la línea comienza y acaba en la dirección X,
-relativo al objeto al que se enlaza.  Así, un valor de @code{-1} (o
-@code{LEFT}) hace que la línea comience o acabe en el lado izquierdo de la cabeza de la nota
-a la que el objeto se encuentra adjuntado.
-
-@item X
-Es la coordenada absoluta del extremo final. Normalmente
-se calcula al vuelo y no tiene mucho sentido sobreescribirlo.
-
-@item stencil
-Los objetos extensores de línea pueden tener símbolos al principio o al final, que se encuentra contenido
-dentro de esta subpropiedad.  Es para uso interno y se recomienda
-usar @code{text}.
-
-@item text
-Es un elemento de marcado que se evalúa para generar la propiedad stencil anterior. Se usa
-para poner @i{cresc.} y @i{tr} sobre los objetos de extensión horizontales.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override TextSpanner #'bound-details #'left #'text
-   = \markup { \small \bold Slower }
-c2\startTextSpan b c a\stopTextSpan
-@end lilypond
-
-@item stencil-align-dir-y
-@item stencil-offset
-Sin un valor establecido para esto, el stencil se coloca simplemente sobre el extremo del final,
-tal y como se encuentra definido por las subpropiedades @code{X} e @code{Y}.
-La asignación de un valor para @code{stencil-align-dir-y} o para @code{stencil-offset}
-desplaza el símbolo del extremo de forma relativa al extremo de la línea
-
-@lilypond[relative=1,fragment,verbatim]
-\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
-\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
-
-\override TextSpanner #'bound-details #'left #'text = #"gggg"
-\override TextSpanner #'bound-details #'right #'text = #"hhhh"
-c4^\startTextSpan c c c \stopTextSpan
-@end lilypond
-
-@item arrow (flecha)
-El establecimiento de esta subpropiedad al valor de @code{#t} produce una cabeza de flecha al final de la
-línea.
-
-@item padding (relleno)
-Esta subpropiedad controla el espacio entre el punto extremo de la línea especificado
-y el extremo real.  Sin relleno, un glissando empezaría
-y acabaría en el centro de las cabezas de las notas.
-
-@end table
-
-@seealso
-
-Referencia del programa: @internalsref{TextSpanner},
-@internalsref{Glissando}, @internalsref{VoiceFollower},
-@internalsref{TrillSpanner}, @internalsref{line-spanner-interface}.
-
-Ejemplos: @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
-
-
-@node Text spanners
-@subsection Text spanners
-
-@cindex Texto, objetos de extensión de
-
-Algunas indicaciones de interpretación, p.ej., @i{rallentando} o @i{accelerando},
-se escriben como texto y se extienden sobre varios compases con líneas de puntos.
-Estos textos se crean mediante objetos de extensión; añada
-@code{\startTextSpan} y @code{\stopTextSpan} a la primera y última
-notas del intervalo abarcado por el objeto de extensión.
-
-La cadena de caracteres que se imprime, así como el estilo, se establecen a través de las
-propiedades de objeto
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c1
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \upright "rall" } 
-c2\startTextSpan b c\stopTextSpan a
-\break
-\textSpannerUp
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \italic "rit" } 
-c2\startTextSpan b c\stopTextSpan a
-@end lilypond
-
-@refcommands
-
-@funindex textSpannerUp
-@code{\textSpannerUp},
-@funindex textSpannerDown
-@code{\textSpannerDown},
-@funindex textSpannerNeutral
-@code{\textSpannerNeutral}.
-
-
-@commonprop
-
-Para imprimir una línea continua, use
-
-@example
-\override TextSpanner #'dash-fraction = #'()
-@end example
-
-
-@seealso
-
-Referencia del programa: @internalsref{TextSpanner}.
-
-
-@node Text marks
-@subsection Text marks
-
-@cindex coda sobre la línea divisoria
-@cindex segno sobre la línea divisoria
-@cindex calderón sobre la línea divisoria
-@cindex líneas divisorias, símbolos sobre las
-@funindex \mark
-
-La instrucción @code{\mark} (llamada de ensayo) se usa principalmente para
-@ref{Rehearsal marks},
-pero también se puede usar para poner símbolos como coda,
-segno y calderón encima de una línea divisoria.  Utilice @code{\markup} para
-acceder al símbolo apropiado (los símbolos se encuentran relacionados en
-@ref{The Feta font}).
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
-c1
-@end lilypond
-
-@noindent
-@code{\mark} se tipografía solamente sobre el pentagrama superior de la partitura.  Si
-especifica la instrucción @code{\mark} en una línea divisoria, la llamada resultante
-se coloca encima de la barra.  Si lo especifica en medio de un compás
-la llamada resultante se coloca entre las notas.  Si se especifica
-antes del comienzo de una línea de la partitura, se coloca
-antes de la primera nota de esta línea.  Por último, si la marca se produce en un salto
-de línea, se imprimirá al principio
-de la línea siguiente.
-@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
-@c  delete this sentence.   -gp
-Si no hay ninguna línea después de la actual, la llamada no se imprimirá en absoluto.
-
-
-@commonprop
-
-Para imprimir la llamada al final de la línea actual, utilice
-
-@example
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-@end example
-
-Con frecuencia, @code{\mark} se utiliza para añadir texto al final de un compás.  En tales
-casos es muy útil cambiar el @code{#'self-alignment}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-c1 c c c4 c c c
-\once \override Score.RehearsalMark #'self-alignment-X = #right
-\mark "D.S. al Fine "
-@end lilypond
-
-Las llamadas de texto se pueden alinear con otros objetos de notación además de las líneas
-divisorias,
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\relative {
-  c1
-  \key cis \major
-  \clef alto
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  \mark "on key"
-  cis
-  \key ces \major
-  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
-  \clef treble
-  \mark "on clef"
-  ces
-  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
-  \key d \minor
-  \clef tenor
-  \time 3/4
-  \mark "on time"
-  c
-}
-@end lilypond
-
-Los símbolos posibles para la lista @code{break-align-symbols} son
-@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
-@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
-@code{key-signature} y @code{time-signature}.
-
-Las llamadas de texto, por omisión se alinearán con el punto medio del objeto de notación,
-pero esto se puede cambiar sobreescribiendo las propiedades
-@code{break-align-anchor-alignment} y
-@code{break-align-anchor} para el objeto gráfico apropiado.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-{
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  c1
-  \key cis \major
-
-  % the RehearsalMark will be aligned with the left edge of the KeySignature
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
-  \mark \default
-  cis1
-  \key ces \major
-
-  % the RehearsalMark will be aligned with the right edge of the KeySignature
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
-  \mark \default
-  ces1
-  \key cis \major
-
-  % the RehearsalMark will be aligned with the left edge of the KeySignature
-  % and then shifted right by 2 units.
-  \once \override Staff.KeySignature #'break-align-anchor = #2
-  \mark \default
-  ces1
-}
-@end lilypond
-
-Aunque normalmente las llamadas textuales se imprimen sólo encima del pentagrama superior,
-podemos alterar este comportamiento para que se impriman sobre todos los pentagramas,
-
-@lilypond[quote,ragged-right,verbatim,relative=2]
-{
-  \new Score \with {
-    \remove "Mark_engraver"
-  }
-  <<
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c''1 \mark "foo" c'' }
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c'1 \mark "foo" c' }
-  >>
-}
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{RehearsalMark}.
-
+@c NOTE: dummy committish
+@c the stuff below is still to be moved -J.Mandereau
 
 @node Text markup
 @subsection Text markup
 
-@cindex marcado
-@cindex texto, marcado de
-@cindex marcado de texto
-@cindex tipografiar texto
-
-Utilice @code{\markup} para tipografiar texto.  Las instrucciones se escriben con la barra
-invertida @code{\}.  Para escribir @code{\} and @code{#}, utilice
-comillas dobles.
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { hello }
-c1_\markup { hi there }
-c1^\markup { hi \bold there, is \italic {anyone home?} }
-c1_\markup { "\special {weird} #characters" }
-@end lilypond
-
-@noindent
-Consulte @ref{Overview of text markup commands}, para ver una lista de todas las
-instrucciones.
-
-@code{\markup} se usa principalmente para indicaciones del tipo @internalsref{TextScript},
-pero también se pueden usar en cualquier lugar donde se requiere texto en lilypond
-
-@lilypond[quote,verbatim]
-\header{ title = \markup{ \bold { foo \italic { bar! } } } }
-\score{
-  \relative c'' {
-    \override Score.RehearsalMark
-      #'break-visibility = #begin-of-line-invisible
-    \override Score.RehearsalMark #'self-alignment-X = #right
-
-    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
-    c2^\markup{ don't be \flat }
-    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
-    b2\startTextSpan
-    a2\mark \markup{ \large \bold Fine }
-    r2\stopTextSpan
-    \bar "||"
-  }
-  \addlyrics { bar, foo \markup{ \italic bar! } }
-}
-@end lilypond
-
-Una orden @code{\markup} también se puede poner por sí misma, fuera de cualquier bloque
-@code{\score}, véase @ref{Multiple scores in a book}.
-
-@lilypond[quote,ragged-right,verbatim]
-\markup{ Here is some text. }
-@end lilypond
-
-@cindex cambio de tipografía
-
-El elemento de marcado en el ejemplo presenta un ejemplo de las instrucciones de cambio de tipografía.  Las órdenes
-@code{\bold} e @code{\italic} se aplican sólo a la siguiente palabra;
-para aplicar una orden a más de una palabra, encierre las palabras
-entre llaves,
-
-@example
-\markup @{ \bold @{ buenos días @} @}
-@end example
-
-@noindent
-Para mayor claridad, también puede hacerlo para argumentos de una sola palabra, p.ej.
-
-@example
-\markup @{ ¿hay \italic @{ alguien @} ahí? @}
-@end example
-
-En el modo de marcado puede componer expresiones, similares a las expresiones
-matemáticas, documentos XML y expresiones musicales.  Podemos apilar
-las expresiones en grupos verticales con la instrucción @code{\column}.
-De forma similar, @code{\center-align} alinea textos por sus líneas medias:
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { \column { a bbbb \line { c d } } }
-c1^\markup { \center-align { a bbbb c } }
-c1^\markup { \line { a b c } }
-@end lilypond
-
-Las listas sin una instrucción previa no se mantienen separadas.  La expresión
-
-@example
-\center-align @{ @{ a b @} @{ c d @} @}
-@end example
-
-@noindent
-
-equivale a
-
-@example
-\center-align @{ a b c d @}
-@end example
-
-@noindent
-
-Para dejar separadas las listas de palabras, podemos utilizar comillas @code{"} o la
-orden @code{\line}
-
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c4^\markup{ \center-align { on three lines } }
-c4^\markup{ \center-align { "all one line" } }
-c4^\markup{ \center-align { { on three lines } } }
-c4^\markup{ \center-align { \line { on one line } } }
-@end lilypond
-
-Los elementos de marcado se pueden almacenar dentro de variables, y estas variables se pueden adjuntar a notas,
-como en
-@example
-allegro = \markup @{ \bold \large @{ Allegro @} @}
- @{ a^\allegro b c d @}
-@end example
-
-Ciertos objetos tienen procedimientos de alineación propios, que cancelan
-cualquier efecto de las alineaciones aplicadas a sus argumentos de marcado en su conjunto.
-Por ejemplo la @internalsref{RehearsalMark} se centra
-horizontalmente, por lo que usar @code{\mark \markup @{ \left-align .. @}} no tiene
-ningún efecto.
-
-Además, la colocación vertical se realiza después de crear el objeto
-de marcado de texto.  Si queremos mover un elemento de marcado completo,
-tenemos que usar la propiedad de relleno #'padding o crear un punto de @q{anclaje}
-dentro del elemento de marcado (generalmente con @code{\hspace #0}).
-
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c'4^\markup{ \raise #5 "not raised" }
-\once \override TextScript #'padding = #3
-c'4^\markup{ raised }
-c'4^\markup{ \hspace #0 \raise #1.5 raised }
-@end lilypond
-
-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}
-para ver más detalles.
-
-
-@seealso
-
-En el presente manual: @ref{Overview of text markup commands}.
-
-Referencia del programa: @internalsref{TextScript}.
-
-Archivos de inicio: @file{scm/@/new@/-markup@/.scm}.
-
-
-@refbugs
-
-El «kerning» y la generación de ligaduras de texto se hacen sólo cuando se usa el «backend» o fundamento de @TeX{}.
-En este caso, LilyPond no se encarga de ellos y así los textos
-quedarán espaciados ligeramente más separados.
-
-Los errores de sintaxis para el modo de marcado son confusos.
-
-
-@node Nested scores
-@subsection Nested scores
-
-Es posible anidar música dentro de los elementos de marcado, añadiendo un bloque @code{\score}
-a una expresión de marcado.  Dicha partitura debe contener un bloque
-@code{\layout}.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative {
-  c4 d^\markup {
-    \score {
-      \relative { c4 d e f }
-      \layout { }
-    }
-  }
-  e f
-}
-@end lilypond
-
-@node Page wrapping text
-@subsection 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:
-
-@verbatim
-\markuplines {
-  \justified-lines {
-    Un texto muy largo de líneas justificadas.
-    ...
-  }
-  \justified-lines {
-    Otro párrafo muy largo.
-    ...
-  }
-  ...
-}
-@end verbatim
-
-@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}.
-
-@seealso
-
-En este manual: @ref{Overview of text markup list commands}, 
-@ref{New markup list command definition}.
-
-@refcommands
-
-@funindex \markuplines
-@code{\markuplines}
-
 @node Overview of text markup commands
 @subsection Overview of text markup commands
 
-Todas las siguientes órdenes se pueden usar dentro de @code{\markup @{ @}}.
-
-@include markup-commands.tely
-
-@node Overview of text markup list commands
-@subsection Overview of text markup list commands
-
-Todos las siguientes instrucciones se puede utilizar con @code{\markuplines}.
-
-@include markup-list-commands.tely
-
-@node Font selection
-@subsection Font selection
-
-@cindex fuente tipográfica, selección de la
-@cindex fuente tipográfica, ampliación
-@funindex font-interface
-
-Estableciendo las propiedades de objetos que se describen más abajo, puede seleccionar
-una fuente tipográfica de entre las familias tipográficas preconfiguradas.  LilyPond contempla por defecto
-la tipografía musical feta. Las tipografías del texto se seleccionan a través de
-Pango/FontConfig. La fuente tipográfica con serifa por defecto es New Century Schoolbook,
-las tipografías sans y tipo máquina de escribir son por defecto las que correspondan a la instalación
-de Pango.
-
-
-@itemize @bullet
-@item @code{font-encoding}
-es un símbolo que establece la disposición de los glifos.  Se debe ajustar solamente para
-seleccionar distintos tipos de tipografías no textuales, p.ej.:
-
-@code{fetaBraces} para las llaves de sistemas de piano, @code{fetaMusic} la
-tipografía estándar de música, incluyendo los glifos de la música antigua, @code{fetaDynamic} para
-indicaciones dinámicas y @code{fetaNumber} para la tipografía de números.
-
-@item @code{font-family}
-es un símbolo que indica la clase general de la tipografía.  Están contemplados
-@code{roman} (Computer Modern), @code{sans} y @code{typewriter} (monoespaciado).
-
-@item @code{font-shape}
-es un símbolo que indica la forma de la tipografía.  Normalmente están disponibles varias
-formas de tipografía para cada familia.  Se puede elegir entre
-@code{italic} (cursiva), @code{caps} (versalitas) y @code{upright} (recta).
-
-@item @code{font-series}
-es un símbolo que indica la serie de la tipografía.  Normalmente cada familia y forma de
-tipografía tiene varias series.  Se puede elegir entre
-@code{medium} (normal) y @code{bold} (negrita).
-
-@end itemize
-
-Las tipografías seleccionadas de la forma que se acaba de esquematizar, vienen con una hoja de estilos predefinida.
-Si quiere usar una tipografía desde fuera de la hoja de estilos,
-ajuste la propiedad
-@code{font-name},
-
-@lilypond[fragment,verbatim]
-{
-  \override Staff.TimeSignature #'font-name = #"Charter"
-  \override Staff.TimeSignature #'font-size = #2
-  \time 3/4
-  c'1_\markup {
-    \override #'(font-name . "Vera Bold")
-      { This text is in Vera Bold }
-  }
-}
-@end lilypond
-
-@noindent
-Se puede usar cualquier tipografía en la medida en que esté disponible por parte de Pango/FontConfig.
-Para conseguir una lista completa de todas las tipografías que están disponibles, ejecute la orden
-@example
-lilypond -dshow-available-fonts blabla
-@end example
-(el último argumento de la instrucción puede ser cualquier cosa, pero debe estar presente).
-
-
-El tamaño de la tipografía se puede establecer con la propiedad @code{font-size}.
-El tamaño resultante se toma como relativo al tamaño
-@code{text-font-size} tal y como está definido en el bloque @code{\paper}.
-
-@cindex fuente tipográfica, tamaño de la
-@cindex fuente tipográfica, aumento
-
-
-También es posible cambiar la familia por defecto de la tipografía para todo el
-documento.  Esto se hace llamando al árbol @code{make-pango-font-tree} desde
-dentro del bloque @code{\paper}. La función toma los nombres de las familias tipográficas
-que se deseen utilizar para el texto en estilo roman, sans serif y monoespaciado.  Por
-ejemplo,
-
-
-@cindex fuentes tipográficas, establecer la familia de las
-@cindex Pango
-
-
-@lilypond[verbatim]
-\paper  {
-  myStaffSize = #20
-
-  #(define fonts
-    (make-pango-font-tree "Times New Roman"
-                          "Nimbus Sans"
-                          "Luxi Mono"
-                           (/ myStaffSize 20)))
-}
-
-{
-  c'^\markup { roman: foo \sans bla \typewriter bar }
-}
-@end lilypond
-
-@c we don't do Helvetica / Courier, since GS incorrectly loads
-@c Apple TTF fonts
-
-
-
-@seealso
-
-Ejemplos: @lsr{text,font@/-family@/-override.ly}.
-
-
-@node New dynamic marks
-@subsection New dynamic marks
-
-Es posible imprimir nuevas indicaciones de dinámica o texto que debe ir alineado
-con ellas.  Utilice @code{make-dynamic-script} para crear estas
-indicaciones.  Tenga en cuenta que la tipografía de dinámica contiene solamente los caracteres
-@code{f,m,p,r,s} y @code{z}.
-
-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
-ver más detalles.
-
-@cindex make-dynamic-script
-
-@lilypond[quote,verbatim,ragged-right]
-sfzp = #(make-dynamic-script "sfzp")
-\relative c' {
-  c4 c c\sfzp c
-}
-@end lilypond
-
-@cindex dinámica, indicaciones, editoriales
-@cindex dinámica, indicaciones, paréntesis
-
-También es posible imprimir las indicaciones de dinámica entre paréntesis redondos o entre corchetes rectos.
-Éstos se usan con frecuencia para añadir indicaciones de dinámica editoriales.
-
-@lilypond[quote,verbatim,ragged-right]
-rndf = \markup{ \center-align {\line { \bold{\italic (}
-  \dynamic f \bold{\italic )} }} }
-boxf = \markup{ \bracket { \dynamic f } }
-{ c'1_\rndf c'1_\boxf }
-@end lilypond
-
-
-
-@node Preparing parts
-@section Preparing parts
-
-Esta sección describe varias posibilidades de notación que son de utilidad al preparar
-particellas individuales.
-
-@menu
-* Multi measure rests::         
-* Metronome marks::             
-* Rehearsal marks::             
-* Bar numbers::                 
-* Instrument names::            
-* Instrument transpositions::   
-* Ottava brackets::             
-* Different editions from one source::  
-@end menu
-
-
-@node Multi measure rests
-@subsection Multi measure rests
-
-@cindex multicompás, silencios
-@cindex compás completo, silencios de
-@cindex Silencios multicompás
-@cindex Silencios de compás completo
-@cindex redonda, silencios de, para un compás completo
-@funindex R
-
-Los silencios de un compás completo (o muchos compases) se escriben como @samp{R}.  Esto está
-indicado específicamente para silencios de compás completo y para escribir particellas: el silencio
-se puede expandir de forma que rellene una partitura con silencios, o se puede imprimir como un solo silencio multicompás.
-Esta expansión se controla por medio de la propiedad
-@code{Score.skipBars}.  Si está establecido al valor true, los compases vacíos no se
-expandirán, y se añadirá automáticamente el número correspondiente
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
-\set Score.skipBars = ##t R1*17 R1*4
-@end lilypond
-
-El número @code{1} de @code{R1} es similar a la notación de la duración que se usa para las
-notas.  De aquí que para indicaciones de compás distintas al 4/4, tengamos que escribir
-otras duraciones.  Esto se puede hacer con puntillos de prolongación o con fracciones
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-\time 3/4
-R2. | R2.*2
-\time 13/8
-R1*13/8
-R1*13/8*12 |
-\time 10/8 R4*5*4 |
-@end lilypond
-
-Una @code{R} que dura un solo compás se imprime como un silencio de redonda o breve,
-centrado en el compás independientemente de la indicación de compás.
-
-Si hay sólo algunos compases de silencio, LilyPond imprime @q{silencios eclesiásticos}
-(un conjunto de pequeños rectángulos) en el pentagrama.  Para sustituirlos con silencios ordinarios,
-utilice @code{MultiMeasureRest.expand-limit}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-R1*2 | R1*5 | R1*9
-\override MultiMeasureRest #'expand-limit = 1
-R1*2 | R1*5 | R1*9
-@end lilypond
-
-@cindex texto sobre silencios multicompás
-@cindex textual, inscripción, sobre silencios multicompás
-@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}.
-Hay una variable (@code{\fermataMarkup}) para añadir
-calderones
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\set Score.skipBars = ##t
-\time 3/4
-R2.*10^\markup { \italic "ad lib." }
-R2.^\fermataMarkup
-@end lilypond
-
-¡Advertencia!  Este texto se crea por parte de @code{MultiMeasureRestText}, no de
-@code{TextScript}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\override TextScript #'padding = #5
-R1^"low"
-\override MultiMeasureRestText #'padding = #5
-R1^"high"
-@end lilypond
-
-Si queremos poner texto a la izquierda de un silencio multicompás,
-adjuntamos el texto a una nota de salto de longitud cero, esto es
-
-@example
-s1*0^"Allegro"
-R1*4
-@end example
-
-
-@seealso
-
-Referencia del programa: @internalsref{MultiMeasureRestMusicGroup},
-@internalsref{MultiMeasureRest}.
-
-El objeto de presentación @internalsref{MultiMeasureRestNumber} es para el número
-por defecto, y @internalsref{MultiMeasureRestText} para los textos
-definidos por el usuario.
-
-
-@refbugs
-
-No se pueden usar digitaciones (p.ej. @code{R1-4}) para poner números
-encima de los silencios multicompás.  Y la altura de los silencios multicompás (o
-silencios centrados en el pentagrama) no se puede modificar.
-
-@cindex silencios condensados
-
-No hay ninguna forma de condensar automáticamente muchos silencios en un solo
-silencio multicompás.  Los silencios multicompás no toman parte en las comprobaciones de colisión de
-silencios.
-
-Tenga cuidado al escribir silencios multicompás seguidos por redondas.
-El código siguiente introduce dos notas que tienen una duración de cuatro compases cada una
-@example
-R1*4 cis cis
-@end example
-Cuando @code{skipBars} esté establecido, el aspecto del resultado será correcto, pero la numeración
-de los compases estará desactivada.
-
-
-@node Metronome marks
-@subsection Metronome marks
-
-@cindex Tempo
-@cindex pulsos por minuto
-@cindex metrónomo, indicación de
-
-Las indicaciones metronómicas se pueden escribir como sigue
-@example
-\tempo @var{duración} = @var{pulsos_por_minuto}
-@end example
-
-En la salida MIDI, se interpretan como un cambio de tempo.  En la salida
-visual, se imprime una indicación metronómica
-@funindex \tempo
-@lilypond[quote,ragged-right,verbatim,fragment]
-\tempo 8.=120 c''1
-@end lilypond
-
-
-@commonprop
-
-Para cambiar el tempo en la salida MIDI sin imprimir nada en la salida visual, haga invisible
-la indicación metronómica
-@example
-\once \override Score.MetronomeMark #'transparent = ##t
-@end example
-
-Para imprimir otras indicaciones metronómicas, use estas instrucciones de marcado
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-c4^\markup {
-  (
-  \smaller \general-align #Y #DOWN \note #"16." #1
-  =
-  \smaller \general-align #Y #DOWN \note #"8" #1
-  ) }
-@end lilypond
-
-@noindent
-Consulte @ref{Text markup} para ver más detalles.
-
-
-@seealso
-
-Referencia del programa: @internalsref{MetronomeMark}.
-
-
-@refbugs
-
-No se comprueba la existencia de colisiones.  Si tenemos notas por encima de la línea superior del pentagrama
-(o notas con articulaciones, ligaduras, texto, etc), la indicación metronómica
-se podría imprimir encima de los símbolos musicales.  Si esto ocurre,
-aumente el relleno adicional de la indicación metronómica para colocarla
-más lejos del pentagrama.
-
-@example
-\override Score.MetronomeMark #'padding = #2.5
-@end example
-
-
-@node Rehearsal marks
-@subsection Rehearsal marks
-
-@cindex Ensayo, letras de
-@funindex \mark
-
-Para imprimir una letra de ensayo, utilice la orden @code{\mark}
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1 \mark \default
-c1 \mark \default
-c1 \mark #8
-c1 \mark \default
-c1 \mark \default
-@end lilypond
-
-@noindent
-La letra@tie{}@q{I} se salta de acuerdo con las tradiciones de grabado.
-Si quiere incluir la letra @q{I}, use
-
-@example
-\set Score.markFormatter = #format-mark-alphabet
-@end example
-
-La letra de ensayo se incrementa automáticamente si usa @code{\mark
-\default}, pero también puede utilizar un número entero como argumento para establecer la indicación manualmente.
-El valor que se utilizará se almacena dentro de la propiedad
-@code{rehearsalMark}.
-
-El estilo se define por medio de la propiedad @code{markFormatter}.  Es una función
-que toma como argumentos la marca en curso (un número entero) y el contexto actual.
-Debe devolver un objeto de marcado.  En el ejemplo
-siguiente, se establece @code{markFormatter} con el valor de un procedimiento enlatado.  Después de
-algunos compases, se establece con el valor de una función que produce un número encerrado en una caja.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\set Score.markFormatter = #format-mark-numbers
-c1 \mark \default
-c1 \mark \default
-\set Score.markFormatter = #format-mark-box-numbers
-c1 \mark \default
-c1 \mark \default
-c1
-@end lilypond
-
-El archivo @file{scm/@/translation@/-functions@/.scm} contiene las definiciones de
-@code{format-mark-numbers} (el formato por omisión),
-@code{format-mark-box-numbers},
-@code{format-mark-letters} y @code{format-mark-box-letters}.
-Se pueden usar éstos como inspiración para otras funciones de formateo.
-
-Podemos utilizar @code{format-mark-barnumbers}, @code{format-mark-box-barnumbers}
-y @code{format-mark-circle-barnumbers} para obtener números de compás en lugar de
-números o letras secuenciales.
-
-Otros estilos de marca de ensayo se pueden especificar de forma manual
-
-@example
-\mark "A1"
-@end example
-
-@noindent
-@code{Score.markFormatter} no afecta a las marcas que se especifican de esta forma.
-Sin embargo, es posible aplicar un elemento @code{\markup} a la cadena.
-
-@example
-\mark \markup@{ \box A1 @}
-@end example
-
-@cindex segno
-@cindex coda
-@cindex D.S al Fine
-
-Los glifos musicales (como el segno) se pueden imprimir dentro de un elemento
-@code{\mark}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-c1 \mark \markup { \musicglyph #"scripts.segno" }
-c1 \mark \markup { \musicglyph #"scripts.coda" }
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
-c1
-@end lilypond
-
-@noindent
-Consulte @ref{The Feta font} para ver una lista de los símbolos que se pueden imprimir
-con @code{\musicglyph}.
-
-Para ver formas comunes de trucar la colocación de las marcas de ensayo, consulte @ref{Text marks}.
-
-@seealso
-
-En este manual: @ref{Text marks}.
-
-Referencia del programa: @internalsref{RehearsalMark}.
-
-Archivos de inicio: @file{scm/@/translation@/-functions@/.scm} contiene la definición
-de @code{format-mark-numbers} y de
-@code{format-mark-letters}.  Se pueden usar como inspiración para escribir otras
-funciones de formateo.
-
-Ejemplos: @lsr{parts,rehearsal-mark-numbers.ly}
-
-
-@node Bar numbers
-@subsection Bar numbers
-
-@cindex Compás, números de
-@cindex números de compás
-@funindex currentBarNumber
-
-Por defecto, los números de compás se imprimen al principio de la línea.  El
-número propiamente dicho se almacena en la propiedad @code{currentBarNumber}, que normalmente
-se actualiza automáticamente para cada compás.
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\repeat unfold 4 {c4 c c c} \break
-\set Score.currentBarNumber = #50
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-Los números de compás sólo se pueden imprimir en las líneas divisorias; para imprimir un número de
-compás al principio de la pieza, se debe añadir una línea divisoria
-vacía
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\set Score.currentBarNumber = #50
-\bar ""
-\repeat unfold 4 {c4 c c c} \break
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-Los números de compás se pueden tipografiar a intervalos regulares en vez de al principio de cada
-línea.  Esto queda ilustrado en el ejemplo siguiente,
-cuyo código fuente se encuentra disponible como
-@lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
-
-@lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
-
-Los números de compás se pueden suprimir completamente quitando el grabador de números de compás
-de la partitura.
-
-@lilypond[verbatim,ragged-right,quote]
-\layout {
-  \context {
-    \Score
-    \remove "Bar_number_engraver"
-  }
-}
-\relative c''{
-c4 c c c \break
-c4 c c c
-}
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{BarNumber}.
-
-Ejemplos: @lsrdir{staff}
-
-
-@refbugs
-
-Los números de compás pueden colisionar con el corchete @internalsref{StaffGroup}, si hay uno
-en la parte de arriba.  Para solucionarlo, se puede usar la propiedad de relleno
-@code{padding} de @internalsref{BarNumber} para
-colocar el número correctamente.
-
-
-@node Instrument names
-@subsection Instrument names
-
-En una partitura orquestal, los nombres de los instrumentos se imprimen en el lado izquierdo
-de los pentagramas.
-
-Esto se puede conseguir estableciendo @internalsref{Staff}.@code{instrumentName}
-y @internalsref{Staff}.@code{shortInstrumentName}, o bien
-@internalsref{PianoStaff}.@code{instrumentName} y
-@internalsref{PianoStaff}.@code{shortInstrumentName}.  Esto
-imprimirá el texto antes del
-principio del pentagrama.  Para el primer pentagrama se usa @code{instrumentName},
-y para los siguientes se usa @code{shortInstrumentName}.
-
-@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-\set Staff.instrumentName = "Ploink "
-\set Staff.shortInstrumentName = "Plk "
-c1
-\break
-c''
-@end lilypond
-
-También podemos usar elementos de marcado de texto para construir nombres de instrumento más complicados,
-por ejemplo
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c''1
-@end lilypond
-
-Si queremos centrar los nombres de instrumento, hemos de centrarlos todos
-
-@lilypond[quote,verbatim,ragged-right]
-{ <<
-\new Staff {
-  \set Staff.instrumentName = \markup {
-    \center-align { "Clarinetti"
-      \line { "in B" \smaller \flat } } }
-  c''1
-}
-\new Staff {
-  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
-  c''1
-}
->>
-}
-@end lilypond
-
-Para nombres de instrumento más largos, puede ser útil aumentar el valor de
-@code{indent} dentro del bloque @code{\layout}.
-
-Para centrar los nombres de instrumento y al mismo tiempo dejar espacio adicional a la derecha,
-
-@lilypond[quote,verbatim,ragged-right]
-\new StaffGroup \relative
-<<
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
-    c1 c1
-  }
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
-    c1 c1
-  }
->>
-@end lilypond
-
-Para añadir nombres de instrumento a otros contextos (como @code{GrandStaff},
-@code{ChoirStaff} o @code{StaffGroup}), debemos añadir el grabador
-a dicho contexto.
-
-@example
-\layout@{
-  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
-@}
-@end example
-
-@noindent
-Se puede encontrar más información sobre cómo añadir y suprimir grabadores
-en @ref{Modifying context plug-ins}.
-
-Los nombres de instrumento se pueden cambiar en mitad de una pieza,
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\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
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{InstrumentName}.
-
-
-
-@node Instrument transpositions
-@subsection Instrument transpositions
-
-@cindex transposición de MIDI
-@cindex transposición instrumental
-
-También se puede especificar el tono de un instrumento transpositor.  Esto se
-aplica a muchos instrumentos de viento, por ejemplo: los clarinetes (en Si bemol, La y
-Mi bemol), la trompa (en Fa) y la trompeta (en Si bemol, Do, Re y Mi bemol).
-
-La transposición se escribe después de la palabra clave @code{\transposition}
-
-@example
-\transposition bes   %% clarinete en Si bemol
-@end example
-
-@noindent
-Esta instrucción establece la propiedad @code{instrumentTransposition}.  El valor de esta
-propiedad se utiliza para la salida MIDI y para las citas guía.  No afecta
-a la forma en que se imprimen las notas en el pentagrama en curso.  Para cambiar la salida impresa,
-véase @ref{Transpose}.
-
-El tono usado para @code{\transposition} debe corresponderse con el sonido
-real que se oye cuando el instrumento transpositor interpreta un Do central @code{c'} escrito en el
-pentagrama.  Por ejemplo, cuando escribimos una partitura en afinación de
-concierto, normalmente todas las voces se escriben en Do, por lo que
-se introducen como
-
-@example
-clarinet = @{
-  \transposition c'
-  ...
-@}
-saxophone = @{
-  \transposition c'
-  ...
-@}
-@end example
-
-La orden @code{\transposition} se debe usar cuando la música se escribe a partir de una
-particella orquestal (transportada).  Por ejemplo, en
-particellas clásicas para trompa, el tono del instrumento con frecuencia se modifica
-durante la pieza.  Al copiar las notas de la particella, utilice
-@code{\transposition}, p.ej.,
-
-@example
-\transposition d'
-c'4^"en Re"
-...
-\transposition g'
-c'4^"en Sol"
-...
-@end example
-
-
-@node Ottava brackets
-@subsection Ottava brackets
-
-Los corchetes de @q{Ottava} introducen un trasporte adicional de una octava para el pentagrama.
-Se crean por medio de la invocación de la función
-@code{set-octavation}
-
-@cindex ottava
-@cindex 15ma
-@cindex octavación
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c''' {
-  a2 b
-  #(set-octavation 1)
-  a b
-  #(set-octavation 0)
-  a b
-}
-@end lilypond
-
-La función @code{set-octavation} también admite los valores -1 (para 8va bassa), 2@tie{}(para 15ma) y
--2 (para 15ma bassa) como argumentos.  Internamente, la función establece las propiedades
-@code{ottavation} (p.ej., para @code{"8va"} o @code{"8vb"}) y
-@code{centralCPosition}.  Para sobreescribir el texto del corchete, establezca
-@code{ottavation} después de invocar a @code{set-octavation}, es decir
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  #(set-octavation 1)
-  \set Staff.ottavation = #"8"
-  c'''
-}
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{OttavaBracket}.
+Todas las siguientes órdenes se pueden usar dentro de @code{\markup @{ @}}.
 
+@include markup-commands.tely
 
-@refbugs
+@node Overview of text markup list commands
+@subsection Overview of text markup list commands
 
-@code{set-octavation} se confundirá cuando se produzcan cambios de clave
-en el interior de un corchete de octavación.
+Todos las siguientes instrucciones se puede utilizar con @code{\markuplines}.
 
+@include markup-list-commands.tely
 
 @node Different editions from one source
 @subsection Different editions from one source
@@ -1473,813 +103,3 @@ etiquetadas.
 
 
 
-@node Orchestral music
-@section Orchestral music
-
-La música orquestal conlleva ciertos elementos de notación especiales, tanto en la partitura del director
-como en las particellas individuales.  Esta sección explica cómo tratar con
-ciertos problemas comunes de la música orquestal.
-
-@menu
-* Automatic part combining::    
-* Hiding staves::               
-* Quoting other voices::        
-* Formatting cue notes::        
-* Aligning to cadenzas::        
-@end menu
-
-
-@node Automatic part combining
-@subsection Automatic part combining
-@cindex particellas, combinación automática
-@cindex particellas, combinador de
-
-La combinación automática de particellas se usa para mezclar dos partes musicales sobre un pentagrama.
-Tiene como objetivo el tipografiado de partituras orquestales.  Cuando las dos partes
-son idénticas durante un período de tiempo, sólo se presenta una de ellas.  En los lugares
-en que las dos partes son diferentes, se tipografían como voces separadas,
-y las direcciones de las plicas se establecen de forma automática.  También las partes de solo
-y @emph{a due} quedan identificadas y es posible marcarlas.
-
-La sintaxis para la combinación de las partes es
-
-@example
-\partcombine @var{expresión_musical_1} @var{expresión_musical_2}
-@end example
-
-
-El ejemplo siguiente ejemplifica la funcionalidad básica del combinador de
-partes: poner las partes en un solo pentagrama, y establecer las direcciones de las plicas y la
-polifonía
-
-@lilypond[quote,verbatim,ragged-right,fragment]
-\new Staff \partcombine
-  \relative g' { g g a( b) c c r r }
-  \relative g' { g g r4 r e e g g }
-@end lilypond
-
-El primer Sol (@code{g}) aparece una sola vez, aunque se especificaba
-dos veces (una en cada parte).  Las direcciones de las plicas, ligaduras de expresión y ligaduras de unión se
-establecen automáticamente, dependiendo de si es un solo o un unísono.  La primera
-parte (la que tiene el contexto llamado @code{one}) siempre tiene las plicas para arriba, y
-@q{Solo}, mientras que la segunda (llamada @code{two}) siempre tiene las plicas para abajo y
-@q{Solo II}.
-
-Si queremos sólo las partes mezcladas y no las marcas textuales, podemos
-establecer la propiedad @code{printPartCombineTexts} al valor false
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Staff.printPartCombineTexts = ##f
-  \partcombine
-    \relative g' { g a( b) r }
-    \relative g' { g r4 r f }
->>
-@end lilypond
-
-Para cambiar el texto que se imprime para los solos o la fusión, podemos
-establecer las propiedades @code{soloText}, @code{soloIIText} y
-@code{aDueText}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Score.soloText = #"ichi"
-  \set Score.soloIIText = #"ni"
-  \set Score.aDueText = #"tachi"
-  \partcombine
-    \relative g' { g4 g a( b) r }
-    \relative g' { g4 g r r f }
->>
-@end lilypond
-
-Los dos argumentos de @code{\partcombine} se interpretan como contextos de
-@internalsref{Voice}.  Si se están usando octavas relativas,
-se debe especificar @code{\relative} para ambas expresiones musicales, es decir
-
-@example
-\partcombine
-  \relative @dots{} @var{expresión_musical_1}
-  \relative @dots{} @var{expresión_musical_2}
-@end example
-
-@noindent
-Una sección @code{\relative} que se encuentra fuera de @code{\partcombine} no tiene ningún
-efecto sobre las notas de @var{expresión_musical_1} y @var{expresión_musical_2}.
-
-@seealso
-
-Referencia del programa: @internalsref{PartCombineMusic}.
-
-@refbugs
-
-Si @code{printPartCombineTexts} está establecido, cuando las dos voces tocan y terminan las mismas notas,
-el combinador de partes puede tipografiar @code{a2} más
-de una vez en el mismo compás.
-
-@code{\partcombine} no puede estar dentro de @code{\times}.
-
-@code{\partcombine} no puede estar dentro de @code{\relative}.
-
-Internamente, el @code{\partcombine} interpreta los dos argumentos como
-@code{Voice}s llamadas @code{one} y @code{two}, y después decide cuándo se pueden combinar
-las partes.  Como consecuencia, si los argumentos cambian a
-contextos de @internalsref{Voice} con nombres diferentes, los eventos que contienen
-se ignorarán.
-
-
-@node Hiding staves
-@subsection Hiding staves
-
-@cindex Francesa, partituras a la
-@cindex Ocultación de pentagramas
-
-En las partituras orquestales, generalmente se eliminan las líneas de pauta que contienen sólo silencios;
-así se ahorra espacio.  Este estilo se llama @q{Partitura francesa}.
-Para @internalsref{Lyrics},
-@internalsref{ChordNames} y @internalsref{FiguredBass}, esta opción está
-activada por defecto.  Cuando las líneas de estos contextos resultan vacías
-después del proceso de cálculo de los saltos de línea, se eliminan.
-
-Para las pautas normales hay un contexto especializado @internalsref{Staff}, que
-hace lo mismo: las pautas que no contienen nada (o solamente
-silencios multicompás) se quitan.  La definición de contexto se almacena dentro de la variable
-@code{\RemoveEmptyStaffContext}.  Observe cómo el segundo pentagrama del siguiente ejemplo
-desaparece en la segunda línea
-
-@lilypond[quote,ragged-right,verbatim]
-\layout {
-  \context { \RemoveEmptyStaffContext }
-}
-
-{
-  \relative c' <<
-    \new Staff { e4 f g a \break c1 }
-    \new Staff { c4 d e f \break R1 }
-  >>
-}
-@end lilypond
-
-El primer sistema muestra todos los pentagramas al completo.  Si queremos que los pentagramas vacíos se
-quiten también del primer sistema, podemos establecer @code{remove-first} al valor true en
-@internalsref{VerticalAxisGroup}.
-
-@example
-\override Score.VerticalAxisGroup #'remove-first = ##t
-@end example
-
-Para quitar otros tipos de contextos, utilice @code{\AncientRemoveEmptyStaffContext}
-o @code{\RemoveEmptyRhythmicStaffContext}.
-
-Otra aplicación es hacer secciones de ossia, es decir, melodías alternativas
-sobre un trozo de pentagrama separado, con la ayuda de los pentagramas a la
-francesa.
-
-
-@node Quoting other voices
-@subsection Quoting other voices
-
-@cindex guías
-
-Con las citas, se pueden insertar fragmentos de otras partes directamente dentro de una
-parte.  Antes de que una parte pueda ser citada, se debe marcar especialmente como
-citable.  Esto se hace con la instrucción @code{\addQuote}.
-
-@example
-\addQuote @var{nombre} @var{música}
-@end example
-
-
-@noindent
-Aquí, @var{nombre} es una cadena identificativa.  La @var{música} es cualquier tipo
-de música.  He aquí un ejemplo de @code{\addQuote}
-
-@example
-\addQuote clarinete \relative c' @{
-  f4 fis g gis
-@}
-@end example
-
-Esta orden se debe escribir en el nivel más alto, es decir, fuera de cualquier bloque de
-música.
-
-Después de la llamada a @code{\addQuote}, la cita se puede hacer con
-@code{\quoteDuring} o con @code{\cueDuring},
-
-@example
-\quoteDuring #@var{nombre} @var{música}
-@end example
-
-En el transcurso de una parte, un fragmento de música se puede citar con la instrucción
-@code{\quoteDuring}.
-
-@example
-\quoteDuring #"clarinete" @{ s2. @}
-@end example
-
-Esto citaría tres negras (la duración de la blanca con puntillo @code{s2.})  de la voz
-@code{clarinete} que se escribió previamente.
-
-
-De manera más precisa, toma el paso de tiempo actual de la parte que se está imprimiendo,
-y extrae las notas en el punto correspondiente de la voz
-@code{\addQuote}ada.  Por tanto, el argumento de @code{\addQuote}
-debe ser la parte completa de la voz que se va a citar, incluidos los silencios
-del principio, si los hay.
-
-Las citas tienen en cuenta tanto la transposición del instrumento origen como la del de destino,
-si se han especificado utilizando la instrucción @code{\transposition}.
-
-@lilypond[quote,ragged-right,verbatim]
-\addQuote clarinet \relative c' {
-  \transposition bes
-  f4 fis g gis
-}
-
-{
-  e'8 f'8 \quoteDuring #"clarinet" { s2 }
-}
-@end lilypond
-
-Los tipos de eventos que aparecen en las notas guía se pueden recortar con
-la propiedad @code{quotedEventTypes}.  El valor por defecto es
-@code{(note-event rest-event)}, lo que significa que sólo las notas y los silencios
-de la voz citada acaban en el @code{\quoteDuring}.
-Al establecer
-
-@example
-\set Staff.quotedEventTypes =
-       #'(note-event articulation-event dynamic-event)
-@end example
-
-@noindent
-se citarán las notas (pero no los silencios), además de las inscripciones textuales y de dinámica.
-
-@refbugs
-
-Sólo los contenidos de la primera @internalsref{Voice} que aparece dentro de una
-instrucción @code{\addQuote} se tendrán en consideración para su cita, así que
-@var{música} no puede contener sentencias @code{\new} y @code{\context Voice}
-que podrían producir el cambio a una Voz diferente.
-
-La cita de notas de adorno es defectuosa e incluso puede causar una caída del programa LilyPond.
-
-La cita de tresillos anidados puede dar como resultado una notación pobre.
-
-
-@seealso
-
-En este manual: @ref{Instrument transpositions}.
-
-Ejemplos: @lsr{parts,quote.ly}, @lsr{parts,quote-transportation.ly}
-
-Referencia del programa: @internalsref{QuoteMusic}.
-
-
-@node Formatting cue notes
-@subsection Formatting cue notes
-
-@cindex guía, formateo de las notas
-
-La sección anterior trata de la inserción de notas que proceden de otra voz.
-Hay una función musical más avanzada que se llama @code{\cueDuring},
-que facilita el formateo de las notas guía.
-
-La sintaxis es
-
-@example
-  \cueDuring #@var{nombre} #@var{arriba_abajo} @var{música}
-@end example
-
-Esto insertará las notas de la parte @var{nombre} en una
-@internalsref{Voice} llamada @code{cue}.  Esto ocurre de forma simultánea
-con @var{música}, que por lo general es un silencio.  Cuando comienzan las notas guía,
-el pentagrama se hace polifónico por un momento.  El argumento
-@var{arriba_abajo} determina si las notas guía se deben tipografiar como
-primera o como segunda voz.
-
-
-@lilypond[verbatim,ragged-right]
-smaller = {
-  \set fontSize = #-2
-  \override Stem #'length-fraction = #0.8
-  \override Beam #'thickness = #0.384
-  \override Beam #'length-fraction = #0.8
-}
-
-\addQuote clarinet \relative {
-  R1*20
-  r2 r8 c' f f
-}
-
-\new Staff \relative  <<
-
-  % setup a context for cue notes.
-  \new Voice = "cue" { \smaller \skip 1*21 }
-
-  \set Score.skipBars = ##t
-
-  \new Voice {
-    R1*20
-    \cueDuring #"clarinet" #UP {
-      R1
-    }
-    g4 g2.
-  }
->>
-@end lilypond
-
-
-Presentamos a continuación un par de consejos para culminar con éxito la escritura de notas guía.
-
-@itemize @bullet
-@item
-Las notas guía tienen un tamaño tipográfico menor.
-@item
- la parte citada se marca con el instrumento que toca la cita.
-@item
- cuando la parte original vuelve, se debe marcar con el nombre del instrumento
- original.
-
-@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
-
-@c Yes, this is good practice.  Otherwise, the start of the original
-@c part can only be seen from the font size.  This is not good enough
-@c for sight-reading.  It is possilbe to use other
-@c markers (e.g. a big close-bracket over the staff) to indicate the cue
-@c   notes are
-@c finished.
-@c -hwn
-
-
-Además cualquier otro cambio introducido por la parte citada se debe deshacer.
-Por ejemplo, si el instrumento citado toca en una clave distinta,
-la clave original se debe hacer constar de nuevo.
-
-@end itemize
-
-La macroinstrucción @code{\transposedCueDuring} es
-útil para añadir notas guía a instrumentos que utilizan un rango de octava completamente distinto
-(por ejemplo, tener una cita del piccolo dentro de la parte de
-contrafagot).
-
-@lilypond[verbatim,ragged-right,quote]
-picc = \relative c''' {
-  \clef "treble^8"
-  R1 |
-  c8 c c e g2 |
-  a4 g g2 |
-}
-\addQuote "picc" { \picc }
-
-cbsn = \relative c, {
-  \clef "bass_8"
-  c4 r g r
-  \transposedCueDuring #"picc" #UP c,, { R1 } |
-  c4 r g r |
-}
-
-<<
-  \context Staff = "picc" \picc
-  \context Staff = "cbsn" \cbsn
->>
-@end lilypond
-
-
-
-@node Aligning to cadenzas
-@subsection Aligning to cadenzas
-
-En un contexto orquestal, las cadenzas presentan un problema especial:
-al construir una partitura que tiene una cadenza, todos los demás instrumentos
-deben saltar tantas notas como la longitud de la cadenza,
-pues en caso contrario empezarán demasiado pronto o tarde.
-
-Una solución a este problema son las funciones @code{mmrest-of-length}
-y @code{skip-of-length}.  Estas funciones de Scheme toman un fragmento de música
-como argumento y generan un @code{\skip} o silencio multicompás, de la longitud exacta
-del fragmento.  El uso de @code{mmrest-of-length} se muestra
-en el ejemplo siguiente.
-
-@lilypond[verbatim,ragged-right,quote]
-cadenza = \relative c' {
-  c4 d8 << { e f g } \\ { d4. } >>
-  g4 f2 g4 g
-}
-
-\new GrandStaff <<
-  \new Staff { \cadenza c'4 }
-  \new Staff {
-    #(ly:export (mmrest-of-length cadenza))
-    c'4
-  }
->>
-@end lilypond
-
-
-@c I didn't translated weird blurb about contemporary music sectioning,
-@c because it will be quite soon updated. - FVD
-
-
-
-@node Contemporary notation
-@section Contemporary notation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
-* Polymetric notation::
-* Time administration::
-* Proportional notation (introduction)::
-* Clusters::
-* Special noteheads::
-* Feathered beams::
-* Improvisation::
-* Selecting notation font size::
-@end menu 
-@node Polymetric notation
-@subsection Polymetric notation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Time administration
-@subsection Time administration
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Proportional notation (introduction)
-@subsection Proportional notation (introduction)
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Clusters
-@subsection Clusters
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Special noteheads
-@subsection Special noteheads
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Feathered beams
-@subsection Feathered beams
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Improvisation
-@subsection Improvisation
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Selecting notation font size
-@subsection Selecting notation font size
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Educational use
-@section Educational use
-
-Con la cantidad de control que ofrece LilyPond, se pueden hacer magníficos
-materiales de enseñanza además de unas estupendas partituras.
-
-@menu
-* Balloon help::                
-* Blank music sheet::           
-* Hidden notes::                
-* Shape note heads::            
-* Easy Notation note heads::    
-* Analysis brackets::           
-* Coloring objects::            
-* Parentheses::                 
-* Grid lines::                  
-@end menu
-
-@node Balloon help
-@subsection Balloon help
-
-Los elementos de notación se pueden marcar y nombrar con la ayuda de un cartel o globo de ayuda
-rectangular.  El propósito principal de esta funcionalidad es la explicación de la notación.
-
-El ejemplo siguiente presenta una demostración de su uso.
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice \with { \consists "Balloon_engraver" }
-{
-  \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
-  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
-}
-@end lilypond
-
-@noindent
-Existen dos funciones musicales, @code{balloonText} y
-@code{balloonGrobText}. Este último toma su nombre del objeto gráfico que se adorna,
-mientras que el primero se puede usar como una articulación sobre una nota.
-Los otros argumentos son el desplazamiento y el texto de la etiqueta.
-
-@cindex globo
-@cindex notación, explicaciones
-
-@seealso
-
-Referencia del programa: @internalsref{text-balloon-interface}.
-
-
-
-
-@node Blank music sheet
-@subsection Blank music sheet
-
-@cindex papel de música vacío
-@cindex Pentagramas, hoja en blanco
-
-También se pueden producir hojas de papel de música en blanco utilizando notas invisibles y
-suprimiendo el grabador @code{Bar_number_engraver}.
-
-
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
-  \repeat unfold 2 % Change this for more lines.
-  { s1\break }
-  \bar "|."
-}
-\new Score \with {
-  \override TimeSignature #'transparent = ##t
-% un-comment this line if desired
-%  \override Clef #'transparent = ##t
-  defaultBarType = #""
-  \remove Bar_number_engraver
-} <<
-
-% modify these to get the staves you want
-  \new Staff \emptymusic
-  \new TabStaff \emptymusic
->>
-@end lilypond
-
-
-@node Hidden notes
-@subsection Hidden notes
-
-@cindex ocultas, notas
-@cindex invisibles, notas
-@cindex transparentes, notas
-
-@funindex \hideNotes
-@funindex \unHideNotes
-Las notas ocultas (o invisibles, o transparentes) pueden ser de utilidad en la preparación de ejercicios
-de teoría o de composición.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-c4 d4
-\hideNotes
-e4 f4
-\unHideNotes
-g4 a
-@end lilypond
-
-
-@node Shape note heads
-@subsection Shape note heads
-
-@cindex notas, cabezas de, con formas
-
-En notación de cabezas con forma, la forma de la cabeza corresponde
-a la función armónica de una nota dentro de la escala. Esta notación se hizo popular
-en los libros americanos de canciones durante el s.XIX.
-
-Las cabezas con formas se pueden producir estableciendo @code{\aikenHeads} o
-@code{\sacredHarpHeads}, según el estilo deseado.
-
-@lilypond[verbatim,relative=1,fragment]
-  \aikenHeads
-  c8 d4 e8 a2 g1
-  \sacredHarpHeads
-  c8 d4. e8 a2 g1
-@end lilypond
-
-Las formas se determinan en función del grado de la escala, donde la tónica
-está determinada por la instrucción @code{\key}
-
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
-
-Las cabezas con formas están programadas a través de la propiedad @code{shapeNoteStyles}.
-Su valor es un vector de símbolos.  El elemento en el lugar k indica qué estilo
-usa el grado k de la escala.  Son posibles las combinaciones
-arbitrarias, p.ej.:
-
-@lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
-  c8 d4. e8 a2 g1
-@end lilypond
-
-
-@node Easy Notation note heads
-@subsection Easy Notation note heads
-
-@cindex notas, cabezas de, estudio
-@cindex notas, cabezas de, notación simplificada
-@cindex simplificada, notación
-@cindex Hal Leonard
-
-Las cabezas @q{easy play} (fáciles de tocar) tienen el nombre de la nota (en inglés) dentro de la cabeza.  Se usa
-en la música para principiantes
-
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
-  \setEasyHeads
-  c'2 e'4 f' | g'1
-@end lilypond
-
-La orden @code{\setEasyHeads} sobreescribe los ajustes del objeto
-@internalsref{NoteHead}.  Para que las letras sean legibles, se tienen que imprimir
-en un tamaño grande de la tipografía.  Para imprimir con un tamaño de tipografía mayor, consulte
-@ref{Setting the staff size}.
-
-@refcommands
-
-@funindex \setEasyHeads
-@code{\setEasyHeads}
-
-
-@node Analysis brackets
-@subsection Analysis brackets
-@cindex corchetes
-@cindex fraseo, corchetes de
-@cindex musicológico, análisis
-@cindex notas, corchetes de agrupación de
-
-Los corchetes se usan en análisis musical para indicar las estructuras presentes en las piezas
-musicales.  LilyPond contempla una forma básica de corchetes horizontales anidados.
-Para usarlos, añada el grabador @internalsref{Horizontal_bracket_engraver}
-al contexto @internalsref{Staff}.  Un corchete se abre con
-@code{\startGroup} y se cierra con @code{\stopGroup}
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\stopGroup
-  }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{HorizontalBracket}.
-
-
-@node Coloring objects
-@subsection Coloring objects
-
-Se pueden asignar colores a los objetos individuales.  Podemos usar los nombres de color
-que se relacionan en la @ref{List of colors}.
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\override NoteHead #'color = #red
-c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
-d
-\override Stem #'color = #blue
-e
-@end lilypond
-
-Se puede acceder al espectro completo de colores definido para X11 usando la función
-de Scheme x11-color.  Esta función acepta un argumento que puede ser un
-símbolo
-
-@example
-\override Beam #'color = #(x11-color 'MediumTurquoise)
-@end example
-
-o una cadena
-
-@example
-\override Beam #'color = #(x11-color "MediumTurquoise")
-@end example
-
-La primera forma es más rápida de escribir y más eficiente.  Sin embargo,
-es posible usar la segunda forma para acceder a los colores de X11 a través de la variante del
-nombre que tiene varias palabras
-
-@example
-\override Beam #'color = #(x11-color "medium turquoise")
-@end example
-
-Si el parámetro no tiene sentido para x11-color, el color por defecto que se devuelve
-es el negro.  Debería ser obvio, a la vista de la partitura resultante, que algo está
-mal.
-
-Este ejemplo ilustra el uso de x11-color.  Tenga en cuenta que el color de la plica
-sigue siendo negro después de haberlo establecido a (x11-color 'Boggle), que es un color sin sentido
-escrito a propósito.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-  \set Staff.instrumentName = \markup {
-    \with-color #(x11-color 'navy) "Clarinet"
-  }
-  \time 2/4
-  gis''8 a''
-  \override Beam #'color = #(x11-color "medium turquoise")
-  gis'' a''
-  \override NoteHead #'color = #(x11-color "LimeGreen")
-  gis'' a''
-  \override Stem #'color = #(x11-color 'Boggle)
-  gis'' a''
-}
-@end lilypond
-
-
-@seealso
-
-Apéndice: @ref{List of colors}.
-
-
-@refbugs
-En un navegador de web, no todos los colores de x11 se distinguen entre sí.  Para su utilización en la
-web se recomiendan los colores normales.
-
-Un color de x11 no es necesariamente de la misma tonalidad que un color normal
-con un nombre similar.
-
-Las notas de un acorde no se pueden colorear con @code{\override}; en su lugar utilice
-@code{\tweak}.  Consulte @ref{Objects connected to the input}
-para ver más detalles.
-
-
-@node Parentheses
-@subsection Parentheses
-
-@cindex fantasma, notas
-@cindex notas fantasma
-@cindex notas entre paréntesis
-
-Los objetos se pueden encerrar entre paréntesis anteponiendo @code{\parenthesize} al evento
-musical,
-
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
-  c
-  \parenthesize d
-  g
->4-\parenthesize -.
-@end lilypond
-
-Esto sólo funciona dentro de los acordes, incluso para notas sueltas
-
-@example
-< \parenthesize NOTA>
-@end example
-
-
-@node Grid lines
-@subsection Grid lines
-
-Se pueden dibujar líneas verticales, sincronizadas con las notas, entre
-pentagramas.
-
-@lilypond[ragged-right,quote,verbatim]
-\layout {
-  \context {
-    \Staff
-    \consists "Grid_point_engraver" %% sets of grid
-    gridInterval = #(ly:make-moment 1 4)
-  }
-}
-
-\new Score \with {
-  \consists "Grid_line_span_engraver"
-  %% centers grid lines  horizontally below noteheads
-  \override NoteColumn #'X-offset = #-0.5
-}
-
-\new ChoirStaff <<
-  \new Staff {
-    \stemUp
-    \relative {
-      c'4. d8 e8 f g4
-    }
-  }
-  \new Staff {
-    %% centers grid lines  vertically
-    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
-    \stemDown
-    \clef bass
-    \relative c {
-      c4  g'  f  e
-    }
-  }
->>
-@end lilypond
-
-Ejemplos: @lsrdir{education}
-
diff --git a/Documentation/es/user/ancient.itely b/Documentation/es/user/ancient.itely
new file mode 100644
index 0000000000..b28bfc096d
--- /dev/null
+++ b/Documentation/es/user/ancient.itely
@@ -0,0 +1,2205 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Ancient notation
+@section Ancient notation
+
+@cindex Vaticana, Editio
+@cindex Medicaea, Editio
+@cindex hufnagel
+@cindex Petrucci
+@cindex mensural
+
+El tratamiento de la notación antigua incluye posibilidades orientadas a la notación mensural
+y de Canto Gregoriano.  También se contempla de forma limitada la notación del
+bajo figurado.
+
+Muchos objetos gráficos ofrecen una propiedad @code{style}, consulte
+@itemize @bullet
+@item
+@ref{Ancient note heads},
+@item
+@ref{Ancient accidentals},
+@item
+@ref{Ancient rests},
+@item
+@ref{Ancient clefs},
+@item
+@ref{Ancient flags},
+@item
+@ref{Ancient time signatures}.
+@end itemize
+
+Al manipular la mencionada propiedad del elemento gráfico, la presentación tipográfica de los
+objetos gráficos afectados se puede acomodar a una variedad de notación específica
+sin necesidad de introducir ningún concepto notacional
+nuevo.
+
+Además de los signos de articulación estándar que se describen en la sección
+@ref{Articulations}, se ofrecen signos de articulación específicos para la notación
+antigua.
+
+@itemize @bullet
+@item
+@ref{Ancient articulations}
+@end itemize
+
+Otros aspectos de la notación antigua no se pueden expresar fácilmente
+en términos de cambiar simplemente una propiedad de estilo de un objeto gráfico o añadir
+símbolos de articulación.  Ciertos conceptos notacionales se introducen específicamente para
+la notación antigua,
+
+@itemize @bullet
+@item
+@ref{Custodes},
+@item
+@ref{Divisiones},
+@item
+@ref{Ligatures}.
+@end itemize
+
+Si todo esto le supone un exceso de documentación, y lo único que desea es
+navegar por el mar de la composición tipográfica sin tener que preocuparse demasiado de los detalles relativos a la
+manera de personalizar un contexto, puede echarles un vistazo a los contextos
+predefinidos.  Úselos para preparar contextos de voz y de pentagrama específicos de un estilo,
+y luego pase directamente a introducir las notas,
+
+@itemize @bullet
+@item
+@ref{Gregorian Chant contexts},
+@item
+@ref{Mensural contexts}.
+@end itemize
+
+Se contempla de forma limitada la notación del bajo figurado que apareció en el
+período barroco.
+
+@itemize @bullet
+@item
+@ref{Figured bass}
+@end itemize
+
+Aquí puede ver de forma resumida todos los apartados relacionados:
+
+@menu
+* Ancient TODO::                
+@end menu
+
+
+@node Ancient TODO
+@subsection Ancient TODO
+
+@menu
+* Ancient note heads::          
+* Ancient accidentals::         
+* Ancient rests::               
+* Ancient clefs::               
+* Ancient flags::               
+* Ancient time signatures::     
+* Ancient articulations::       
+* Custodes::                    
+* Divisiones::                  
+* Ligatures::                   
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+* Gregorian Chant contexts::    
+* Mensural contexts::           
+* Musica ficta accidentals::    
+* Figured bass::                
+@end menu
+
+
+
+@node Ancient note heads
+@unnumberedsubsubsec Ancient note heads
+
+@cindex cabezas de nota antiguas
+
+Para la notación antigua, se puede elegir un estilo de cabezas de notas distinto al @code{default}
+(estilo por defecto).  Esto se consigue estableciendo la propiedad @code{style}
+del objeto @internalsref{NoteHead} a los valores @code{baroque},
+@code{neomensural}, @code{mensural} o @code{petrucci}.  El estilo
+@code{baroque} se diferencia del estilo por defecto @code{default} únicamente en que usa
+una forma cuadrada para las cabezas de las @code{\breve}.  El estilo
+@code{neomensural} se diferencia del estilo @code{baroque} en que
+usa cabezas romboidales para las redondas y todas las figuras de duración menor.
+Las plicas aparecen centradas sobre las cabezas.  Este estilo es particularmente
+útil al transcribir música mensural, p.ej. para el incipit.  El estilo
+@code{mensural} produce cabezas que imitan el aspecto de aquellas que aparecen en las ediciones impresas
+del siglo XVI.  Finalmente, el estilo
+@code{petrucci} también imita las ediciones históricas, pero utiliza unas cabezas
+mayores.
+
+El ejemplo siguiente muestra el estilo @code{neomensural}
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override NoteHead #'style = #'neomensural
+a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
+@end lilypond
+
+Cuando se tipografía una pieza en notación de Canto Gregoriano, el grabador
+@internalsref{Gregorian_ligature_engraver} selecciona automáticamente
+las cabezas adecuadas, de manera que no es necesario establecer el estilo de las cabezas
+explícitamente.  Aún así, el estilo de las cabezas se puede establecer, p.ej., a
+@code{vaticana_punctum} para producir neumas punctum.  De forma similar, se utiliza un grabador
+@internalsref{Mensural_ligature_engraver} para construir automáticamente
+ligaduras mensurales.  Consulte @ref{Ligatures} para ver cómo funcionan los grabadores
+de las ligaduras.
+
+@seealso
+
+@ref{Note head styles} ofrece una visión de conjunto sobre la totalidad de los estilos de cabeza disponibles.
+
+
+@node Ancient accidentals
+@unnumberedsubsubsec Ancient accidentals
+
+@cindex alteraciones accidentales
+
+
+Utilice la propiedad @code{glyph-name-alist} del elemento gráfico
+@internalsref{Accidental} y @internalsref{KeySignature} para seleccionar
+los símbolos de alteración de la notación antigua.
+
+@lilypond[quote,ragged-right,staffsize=26]
+\score {
+{
+  \fatText
+  s^\markup {
+    \column {
+      "vaticana"
+      \line { " " \musicglyph #"accidentals.vaticana-1"
+        " " \musicglyph #"accidentals.vaticana0" }
+    }
+    \column {
+      "medicaea"
+      \line { " " \musicglyph #"accidentals.medicaea-1" }
+    }
+    \column {
+      "hufnagel"
+      \line { " " \musicglyph #"accidentals.hufnagel-1" }
+    }
+    \column {
+      "mensural"
+      \line { " " \musicglyph #"accidentals.mensural-1"
+        " " \musicglyph #"accidentals.mensural1" }
+    }
+  }
+}
+\layout {
+  interscoreline = 1
+  \context { \Score \remove "Bar_number_engraver" }
+  \context { \Staff
+      \remove "Clef_engraver"
+      \remove "Key_engraver"
+      \remove "Time_signature_engraver"
+      \remove "Staff_symbol_engraver"
+      \override VerticalAxisGroup #'minimum-Y-extent = ##f
+    }
+  }
+}
+@end lilypond
+
+Como se muestra aquí, no todas las alteraciones están contempladas por cada uno de los estilos. Cuando
+trate de acceder a una alteración no contemplada, LilyPond cambiará a un estilo diferente,
+como se muestra en
+@lsr{ancient,ancient-accidentals.ly}.
+
+De forma similar a las alteraciones accidentales, el estilo de la armadura de la tonalidad se puede
+controlar a través de la propiedad @code{glyph-name-alist} del elemento gráfico
+@internalsref{KeySignature}.
+
+@seealso
+
+En el presente manual: @ref{Pitches}, @ref{Cautionary accidentals} y
+@ref{Automatic accidentals} proporcionan una introducción general al uso de las
+alteraciones.  @ref{Key signature} ofrece una introducción general al uso de
+las armaduras de tonalidad.
+
+Referencia del programa: @internalsref{KeySignature}.
+
+Ejemplos: @lsrdir{ancient}
+
+@node Ancient rests
+@unnumberedsubsubsec Ancient rests
+
+@cindex silencios antiguos
+
+
+Utilice la propiedad @code{style} del elemento gráfico @internalsref{Rest} para seleccionar
+silencios antiguos.  Los estilos contemplados son @code{classical},
+@code{neomensural} y @code{mensural}.  @code{classical} se diferencia
+del estilo por defecto @code{default} solamente en que el silencio de negra parece
+un silencio de corchea invertido horizontalmente.  El estilo @code{neomensural} es adecuado para,
+p.ej., el incipit de una pieza transcrita de música mensural.
+Finalmente, el estilo @code{mensural} reproduce el aspecto de los silencios de las ediciones impresas históricas
+del siglo XVI.
+
+El ejemplo siguiente muestra el estilo @code{neomensural}
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override Rest #'style = #'neomensural
+r\longa r\breve r1 r2 r4 r8 r16
+@end lilypond
+
+No existen silencios de fusa y semifusa específicos para los estilos mensural
+ni neo-mensural.  En su lugar se tomarán los silencios del estilo por defecto.
+Consulte @lsr{pitches,rests} para ver un cuadro de todos los silencios.
+
+No hay silencios en la notación del Canto Gregoriano; en su lugar, se utilizan
+@ref{Divisiones}.
+
+@seealso
+
+En este manual: @ref{Rests} ofrece una introducción general al uso de los
+silencios.
+
+
+@node Ancient clefs
+@unnumberedsubsubsec Ancient clefs
+
+@cindex claves
+
+
+LilyPond contempla una amplia variedad de claves, muchas de ellas antiguas.
+
+La siguiente tabla presenta todas las claves antiguas que están contempladas a través de la
+instrucción @code{\clef}.  Algunas de las claves usan el mismo glifo, pero
+se diferencian sólo en la línea en que se imprimen.  En tales casos,
+se usa un número añadido al nombre para enumerar dichas claves.
+Aún así, puede forzar manualmente que se escriba un glifo de clave sobre una
+línea arbitraria, como se encuentra descrito en @ref{Clef}.  La nota impresa a la derecha
+de cada clave en la columna de los ejemplos denota la situación del Do central (@code{c'})
+con respecto a dicha clave.
+
+@multitable @columnfractions .4 .4 .2
+@item
+@b{Descripción}
+@tab
+@b{Claves posibles}
+@tab
+@b{Ejemplo}
+
+@item
+clave de Do en estilo mensural moderno
+@tab
+@code{neomensural-c1}, @code{neomensural-c2},@*
+@code{neomensural-c3}, @code{neomensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "neomensural-c2" c
+@end lilypond
+
+@item
+claves de Do mensurales en estilo de Petrucci, para su uso sobre diferentes líneas de la pauta
+(los ejemplos muestran la clave de Do en segunda línea)
+@tab
+@code{petrucci-c1}, @code{petrucci-c2},@*
+@code{petrucci-c3}, @code{petrucci-c4},@*
+@code{petrucci-c5}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Fa mensural en estilo de Petrucci
+@tab
+@code{petrucci-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Sol mensural en estilo de Petrucci
+@tab
+@code{petrucci-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Do mensural en estilo histórico
+@tab
+@code{mensural-c1}, @code{mensural-c2},@*
+@code{mensural-c3}, @code{mensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Fa mensural en estilo histórico
+@tab
+@code{mensural-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Sol mensural de estilo histórico
+@tab
+@code{mensural-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+clave de Do del estilo de la Editio Vaticana
+@tab
+@code{vaticana-do1}, @code{vaticana-do2},@*
+@code{vaticana-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-do2"
+  c
+@end lilypond
+
+@item
+clave de Fa del estilo de la Editio Vaticana
+@tab
+@code{vaticana-fa1}, @code{vaticana-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-fa2"
+  c
+@end lilypond
+
+@item
+clave de Do del estilo de la Editio Medicaea
+@tab
+@code{medicaea-do1}, @code{medicaea-do2},@*
+@code{medicaea-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-do2"
+  c
+@end lilypond
+
+@item
+clave de Fa del estilo de la Editio Medicaea
+@tab
+@code{medicaea-fa1}, @code{medicaea-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-fa2"
+  c
+@end lilypond
+
+@item
+clave de Do hufnagel de estilo histórico
+@tab
+@code{hufnagel-do1}, @code{hufnagel-do2},@*
+@code{hufnagel-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do2"
+  c
+@end lilypond
+
+@item
+clave de Fa hufnagel de estilo histórico
+@tab
+@code{hufnagel-fa1}, @code{hufnagel-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-fa2"
+  c
+@end lilypond
+
+@item
+clave hufnagel de Do y Fa combinados de estilo histórico
+@tab
+@code{hufnagel-do-fa}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do-fa"
+  c
+@end lilypond
+@end multitable
+
+
+
+@emph{Estilo Moderno} significa @qq{como se encuentra tipografiado en las ediciones contemporáneas de
+música mensural transcrita.}
+
+@emph{Estilo de Petrucci} significa @qq{inspirado por las ediciones impresas del famoso
+grabador Petrucci (1466-1539).}
+
+@emph{Estilo Histórico} significa @qq{como se tipografiaba o se escribía en las ediciones
+históricas (aparte de las de Petrucci).}
+
+@emph{Estilo de la Editio XXX} significa @qq{como se imprime o imprimía en la Editio XXX.}
+
+Petrucci usaba claves de Do que tenían barras verticales en el lado izquierdo en un equilibrio variable,
+dependiendo de la línea de la pauta en que se imprimían.
+
+@seealso
+
+En este manual: consulte @ref{Clef}.
+
+@refbugs
+
+La clave mensural de Sol está reasignada a la clave de Sol de Petrucci.
+
+
+
+@node Ancient flags
+@unnumberedsubsubsec Ancient flags
+
+@cindex corchetes
+
+
+Utilice la propiedad @code{flag-style} del elemento gráfico @internalsref{Stem} para seleccionar
+los corchetes de estilo antiguo.  Aparte del estilo de corchete por defecto @code{default},
+sólo está contemplado el estilo @code{mensural}
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\override Stem #'flag-style = #'mensural
+\override Stem #'thickness = #1.0
+\override NoteHead #'style = #'mensural
+\autoBeamOff
+c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
+c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
+@end lilypond
+
+Dese cuenta de que la bandera más interna de cada uno de los corchetes mensurales siempre
+se alinea verticalmente con una línea de la pauta.
+
+No existe un estilo particular de corchete para la notación neo-mensural.  Por ello,
+cuando tipografíe el incipit de una pieza transcrita de música mensural,
+debe usar el estilo de corchete por defecto.  No existen corchetes en la notación
+del Canto Gregoriano.
+
+@refbugs
+
+La unión de los corchetes antiguos a las plicas está ligeramente desviada a causa de un
+cambio en la antigua versión 2.3.x.
+
+La alineación vertical de cada uno de los corchetes con una línea de la pauta da por supuesto que las plicas
+siempre terminan exactamente encima o bien exactamente en el medio de dos líneas de la
+pauta.  Esto puede no ser siempre cierto cuando se utilizan las posibilidades de disposición
+avanzadas de la notación clásica (que, de todas formas, por lo común se encuentra fuera del ámbito de la
+notación mensural).
+
+@node Ancient time signatures
+@unnumberedsubsubsec Ancient time signatures
+
+@cindex compás, indicación de
+
+
+Las indicaciones de compás mensurales están contempladas de forma limitada.  Los
+glifos están configurados de forma fija para determinadas fracciones de tiempo.  En otras palabras,
+para obtener un glifo de compás mensural determinado con la instrucción @code{\time n/m},
+se tienen que escoger @code{n} y @code{m} según la siguiente
+tabla
+
+@lilypond[quote,ragged-right]
+\layout {
+  indent = 0.0
+  \context {
+    \Staff
+    \remove Staff_symbol_engraver
+    \remove Clef_engraver
+    \remove Time_signature_engraver
+  }
+}
+{
+  \set Score.timing = ##f
+  \set Score.barAlways = ##t
+  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural44" }
+  s
+  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural22" }
+  s
+  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural64" }
+  s
+  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural68" }
+  \break
+  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural32" }
+  s
+  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural34" }
+  s
+  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural94" }
+  s
+  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural98" }
+  \break
+  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural48" }
+  s
+  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural24" }
+}
+@end lilypond
+
+Utilice la propiedad @code{style} del elemento gráfico @internalsref{TimeSignature} para
+seleccionar las indicaciones de compás de la música antigua.  Los estilos contemplados son
+@code{neomensural} y @code{mensural}.  La tabla anterior utiliza el
+estilo @code{neomensural}.  Este estilo es adecuado para el
+incipit de las transcripciones de piezas mensurales.  El estilo @code{mensural}
+reproduce el aspecto de las ediciones impresas históricas del s. XVI.
+
+Los ejemplos siguientes muestran las diferencias que existen entre los estilos:
+
+@lilypond[ragged-right,fragment,relative=1,quote]
+{
+  \fatText
+
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter default }
+
+  \override Staff.TimeSignature #'style = #'numbered
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter numbered }
+
+  \override Staff.TimeSignature #'style = #'mensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter mensural }
+
+  \override Staff.TimeSignature #'style = #'neomensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter neomensural }
+  \override Staff.TimeSignature #'style = #'single-digit
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter single-digit }
+}
+@end lilypond
+
+@seealso
+
+En el presente manual: @ref{Time signature} ofrece una introducción general al
+uso de las indicaciones de compás.
+
+@refbugs
+
+Las relaciones de duración de las notas no se modifican cuando cambia la indicación de compás.  Por
+ejemplo, la razón de 1 breve = 3 semibreves (tiempo perfecto) se debe
+hacer a mano mediante el establecimiento de
+
+@example
+breveTP = #(ly:make-duration -1 0 3 2)
+@dots{}
+@{ c\breveTP f1 @}
+@end example
+
+@noindent
+Esto fija un valor para @code{breveTP} de 3/2 multiplicado por 2 = 3 veces una redonda.
+
+El símbolo @code{old6/8alt} (alternativo al símbolo de 6/8) no se puede
+seleccionar directamente con @code{\time}.  En su lugar, utilice un elemento de marcado @code{\markup}.
+
+@node Ancient articulations
+@unnumberedsubsubsec Ancient articulations
+
+@cindex articulaciones
+
+Además de los signos de articulación estándar que se hallan descritos en la sección
+@ref{Articulations}, se proveen signos de articulación para la notación
+antigua.  Éstos están pensados específicamente para utilizarlos con la notación del estilo
+Editio Vaticana.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \override TextScript #'font-family = #'typewriter
+    \override TextScript #'font-shape = #'upright
+    \override Script #'padding = #-0.1
+    a\ictus_"ictus" \break
+    a\circulus_"circulus" \break
+    a\semicirculus_"semicirculus" \break
+    a\accentus_"accentus" \break
+    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
+  }
+}
+@end lilypond
+
+@refbugs
+
+Ciertas articulaciones se colocan demasiado cerca verticalmente de las
+cabezas de nota correspondientes.
+
+La línea episemática no se muestra en muchos casos.  Si se presenta,
+el extremo derecho de la línea episemática se encuentra a menudo demasiado lejos hacia la derecha.
+
+@node Custodes
+@unnumberedsubsubsec Custodes
+
+@cindex custos
+@cindex custodias
+
+Un @emph{custos} (en plural: @emph{custodias}, que en latín significa @q{guarda}) es un
+símbolo que aparece al final de una pauta.  Anticipa la altura
+de la primera o primeras notas de la línea siguiente, ayudando al intérprete con
+los saltos de línea durante la ejecución.
+
+Las custodias se utilizaron mucho en la notación musical hasta el siglo XVII.
+En nuestros días, sobreviven sólo en algunas formas particulares
+de notación musical como las ediciones contemporáneas de Canto Gregoriano
+como la @emph{editio vaticana}.  Hay distintos glifos para el custos
+que se utilizan en las diferentes variaciones de estilo notacional.
+
+Para tipografiar las custodias, simplemente coloque un grabador @internalsref{Custos_engraver} dentro del contexto
+@internalsref{Staff} (el contexto del pentagrama) al declarar el bloque de @code{\layout} (el bloque de disposición de la página),
+como se muestra en el ejemplo siguiente:
+
+@example
+\layout @{
+  \context @{
+    \Staff
+    \consists Custos_engraver
+    Custos \override #'style = #'mensural
+  @}
+@}
+@end example
+
+El resultado tendrá el aspecto siguiente:
+
+@lilypond[quote,ragged-right]
+\score {
+{
+  a'1
+  \override Staff.Custos #'style = #'mensural
+  \break
+  g'
+}
+\layout {
+  \context { \Staff \consists Custos_engraver }
+  }
+}
+@end lilypond
+
+El glifo del custos se selecciona mediante la propiedad @code{style}.  Los estilos
+contemplados son @code{vaticana}, @code{medicaea}, @code{hufnagel} y
+@code{mensural}.  Se muestran en el siguiente fragmento:
+
+@lilypond[quote,ragged-right,fragment]
+\new Lyrics \lyricmode {
+  \markup { \column {
+    \typewriter "vaticana"
+    \line { " " \musicglyph #"custodes.vaticana.u0" }
+  } }
+  \markup { \column {
+    \typewriter "medicaea"
+    \line { " " \musicglyph #"custodes.medicaea.u0" }
+  }}
+  \markup { \column {
+    \typewriter "hufnagel"
+    \line { " " \musicglyph #"custodes.hufnagel.u0" }
+  }}
+  \markup { \column {
+    \typewriter "mensural"
+    \line { " " \musicglyph #"custodes.mensural.u0" }
+  }}
+}
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{Custos}.
+
+Ejemplos:
+@lsr{ancient,custodes@/.ly}.
+
+
+@node Divisiones
+@unnumberedsubsubsec Divisiones
+
+@cindex divisio
+@cindex divisiones
+@cindex finalis
+
+Una @emph{divisio} (en plural: @emph{divisiones}, que en latín significa
+@q{división}) es un símbolo del contexto del pentagrama que se usa para estructurar
+la música Gregoriana en frases y secciones.  El significado musical de
+@emph{divisio minima}, @emph{divisio maior} y @emph{divisio maxima}
+se podrían caracterizar como una pausa corta, media y larga (respectivamente), algo así como
+las marcas de respiración de @ref{Breath marks}.  El signo de @emph{finalis} no sólo
+marca el final de un canto, sino que se usa también con frecuencia dentro de un único
+canto antifonal o responsorial para marcar el final de cada una de las secciones.
+
+
+Para usar divisiones, incluya el archivo @file{gregorian@/-init@/.ly}.  Contiene
+definiciones que podrá aplicar con tan sólo escribir
+@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima}
+y @code{\finalis} en los lugares adecuados de la entrada.  Algunas ediciones usan
+@emph{virgula} o @emph{caesura} en vez de divisio minima.
+Por ello, @file{gregorian@/-init@/.ly} define también las instrucciones @code{\virgula} y
+@code{\caesura}
+
+@lilypondfile[quote,ragged-right]{divisiones.ly}
+
+@refcommands
+
+@funindex \virgula
+@code{\virgula},
+@funindex \caesura
+@code{\caesura},
+@funindex \divisioMinima
+@code{\divisioMinima},
+@funindex \divisioMaior
+@code{\divisioMaior},
+@funindex \divisioMaxima
+@code{\divisioMaxima},
+@funindex \finalis
+@code{\finalis}.
+
+@seealso
+
+En el presente manual: @ref{Breath marks}.
+
+Referencia del programa: @internalsref{BreathingSign}.
+
+Ejemplos: @lsr{expressive,breathing-sign.ly}.
+
+
+@node Ligatures
+@unnumberedsubsubsec Ligatures
+
+@cindex Ligaduras
+
+@c TODO: Should double check if I recalled things correctly when I wrote
+@c down the following paragraph by heart.
+
+Una ligadura es un símbolo gráfico que representa al menos dos notas
+distintas.  Las ligaduras aparecieron originalmente en los manuscritos de la notación del
+Canto Gregoriano para denotar secuencias de notas ascendentes o descendentes.
+
+Las ligaduras se escriben encerrándolas dentro de un par @code{\[} y @code{\]}.
+Ciertos estilos de ligadura podrían necesitar una sintaxis de entrada adicional específica para
+este tipo de ligadura en particular.  Por defecto, el grabador
+@internalsref{LigatureBracket} se limita a colocar un corchete recto
+sobre la ligadura
+
+@lilypond[quote,ragged-right,verbatim]
+\transpose c c' {
+  \[ g c a f d' \]
+  a g f
+  \[ e f a g \]
+}
+@end lilypond
+
+Para seleccionar un estilo de ligaduras específico, se debe añadir el grabador adecuado
+al contexto @internalsref{Voice}, tal y como se explica en los 
+sub-apartados siguientes.   Solamente están contempladas las ligaduras mensurales
+blancas con ciertas limitaciones.
+
+
+
+@refbugs
+
+Las ligaduras necesitan un espaciado especial que aún no se ha desarrollado.  Como
+consecuencia, la mayor parte del tiempo existe una separación excesiva entre las ligaduras,
+y a menudo los cortes de línea no son satisfactorios.  Además, la letra de los cantos no se alinea
+correctamente con las ligaduras.
+
+Las alteraciones accidentales no se deben imprimir dentro de las ligaduras, sino que deben
+reunirse e imprimirse juntas delante de ellas.
+
+La sintaxis todavía utiliza el obsoleto estilo infijo @code{\[ música expresión
+\]}.  Por motivos de consistencia, esto cambiará algún día al estilo
+postfijo @code{nota\[ ... nota\]}.  De forma alternativa, puede incluirse el archivo
+@file{gregorian@/-init@/.ly}; proporciona una función de
+Scheme
+@example
+\ligature @var{música expresión}
+@end example
+que causa el mismo efecto y se supone que es lo bastante estable.
+
+@menu
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+@end menu
+
+@node White mensural ligatures
+@unnumberedsubsubsec White mensural ligatures
+
+@cindex ligaduras mensurales
+@cindex ligaduras mensurales blancas
+
+Las ligaduras mensurales blancas están contempladas de forma limitada.
+
+Para grabar ligaduras mensurales blancas, en el bloque layout o de disposición de la página coloque el grabador
+@internalsref{Mensural_ligature_engraver} dentro del contexto
+@internalsref{Voice}, y elimine el grabador
+@internalsref{Ligature_bracket_engraver}, de la siguiente manera:
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \remove Ligature_bracket_engraver
+    \consists Mensural_ligature_engraver
+  @}
+@}
+@end example
+
+No existe ningún lenguaje de entrada adicional para describir la forma de una
+ligadura mensural blanca.  Más bien la forma se determina exclusivamente a partir
+de la altura y duración de las notas comprendidas.  Si bien este enfoque podría
+hacer que un usuario con poca experiencia tardase un tiempo en acostumbrarse a él, tiene la gran ventaja de que
+toda la información musical de la ligadura se conoce internamente.
+Esto no se requiere solamente para una salida MIDI correcta, sino que también permite la
+transcripción automática de las ligaduras.
+
+Por ejemplo,
+
+@example
+\set Score.timing = ##f
+\set Score.defaultBarType = "empty"
+\override NoteHead #'style = #'neomensural
+\override Staff.TimeSignature #'style = #'neomensural
+\clef "petrucci-g"
+\[ c'\maxima g \]
+\[ d\longa c\breve f e d \]
+\[ c'\maxima d'\longa \]
+\[ e'1 a g\breve \]
+@end example
+@lilypond[quote,ragged-right]
+\score {
+  \transpose c c' {
+    \set Score.timing = ##f
+    \set Score.defaultBarType = "empty"
+    \override NoteHead #'style = #'neomensural
+    \override Staff.TimeSignature #'style = #'neomensural
+    \clef "petrucci-g"
+    \[ c'\maxima g \]
+    \[ d\longa c\breve f e d \]
+    \[ c'\maxima d'\longa \]
+    \[ e'1 a g\breve \]
+  }
+  \layout {
+    \context {
+      \Voice
+      \remove Ligature_bracket_engraver
+      \consists Mensural_ligature_engraver
+    }
+  }
+}
+@end lilypond
+
+Si no se sustituye el grabador @internalsref{Ligature_bracket_engraver} por el
+@internalsref{Mensural_ligature_engraver}, la misma música se transcribe
+de la siguiente manera:
+
+@lilypond[quote,ragged-right]
+\transpose c c' {
+  \set Score.timing = ##f
+  \set Score.defaultBarType = "empty"
+  \override NoteHead #'style = #'neomensural
+  \override Staff.TimeSignature #'style = #'neomensural
+  \clef "petrucci-g"
+  \[ c'\maxima g \]
+  \[ d\longa c\breve f e d \]
+  \[ c'\maxima d'\longa \]
+  \[ e'1 a g\breve \]
+}
+@end lilypond
+
+@refbugs
+
+El espaciado horizontal es pobre.
+
+@node Gregorian square neumes ligatures
+@unnumberedsubsubsec Gregorian square neumes ligatures
+
+@cindex ligaduras de neumas cuadrados
+@cindex ligaduras gregorianas de neumas cuadrados
+
+La notación de neumas cuadrados gregorianos está contemplada de forma limitada
+(siguiendo el estilo de la Editio Vaticana).  El núcleo principal del conjunto de las ligaduras
+ya se pueden tipografiar, pero aún faltan aspectos esenciales para una composición tipográfica seria,
+como (entre otros) la alineación horizontal de varias ligaduras,
+la alineación de la letra y un correcto manejo de las alteraciones accidentales.
+
+
+La tabla siguiente contiene los neumas extendidos del segundo
+volumen del Antiphonale Romanum (@emph{Liber Hymnarius}), publicado
+en el año 1983 por los monjes de Solesmes.
+
+@multitable @columnfractions .4 .2 .2 .2
+
+@item
+@b{Neuma aut@*
+Neumarum Elementa}
+@tab
+@b{Figurae@*
+Rectae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Auctae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Deminutae}
+
+@c TODO: \layout block is identical in all of the below examples.
+@c Therefore, it should somehow be included rather than duplicated all
+@c the time. --jr
+
+@c why not make identifiers in ly/engraver-init.ly? --hwn
+
+@c Because it's just used to typeset plain notes without
+@c a staff for demonstration purposes rather than something
+@c special of Gregorian chant notation. --jr
+
+@item
+@code{1. Punctum}
+@tab
+@lilypond[staffsize=26,line-width=1.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum
+    \[ b \]
+    \noBreak s^\markup {"a"} \noBreak
+
+    % Punctum Inclinatum
+    \[ \inclinatum b \]
+    \noBreak s^\markup {"b"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Auctum Ascendens
+    \[ \auctum \ascendens b \]
+    \noBreak s^\markup {"c"} \noBreak
+
+    % Punctum Auctum Descendens
+    \[ \auctum \descendens b \]
+    \noBreak s^\markup {"d"} \noBreak
+
+    % Punctum Inclinatum Auctum
+    \[ \inclinatum \auctum b \]
+    \noBreak s^\markup {"e"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Inclinatum Parvum
+    \[ \inclinatum \deminutum b \]
+    \noBreak s^\markup {"f"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{2. Virga}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Virga
+    \[ \virga b \]
+    \noBreak s^\markup {"g"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{3. Apostropha vel Stropha}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha
+    \[ \stropha b \]
+    \noBreak s^\markup {"h"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha Aucta
+    \[ \stropha \auctum b \]
+    \noBreak s^\markup {"i"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{4. Oriscus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Oriscus
+    \[ \oriscus b \]
+    \noBreak s^\markup {"j"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{5. Clivis vel Flexa}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis vel Flexa
+    \[ b \flexa g \]
+    s^\markup {"k"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis Aucta Descendens
+    \[ b \flexa \auctum \descendens g \]
+    \noBreak s^\markup {"l"} \noBreak
+
+    % Clivis Aucta Ascendens
+    \[ b \flexa \auctum \ascendens g \]
+    \noBreak s^\markup {"m"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Cephalicus
+    \[ b \flexa \deminutum g \]
+    s^\markup {"n"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{6. Podatus vel Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Podatus vel Pes
+    \[ g \pes b \]
+    s^\markup {"o"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens
+    \[ g \pes \auctum \descendens b \]
+    \noBreak s^\markup {"p"} \noBreak
+
+    % Pes Auctus Ascendens
+    \[ g \pes \auctum \ascendens b \]
+    \noBreak s^\markup {"q"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Epiphonus
+    \[ g \pes \deminutum b \]
+    s^\markup {"r"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{7. Pes Quassus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus
+    \[ \oriscus g \pes \virga b \]
+    s^\markup {"s"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus Auctus Descendens
+    \[ \oriscus g \pes \auctum \descendens b \]
+    s^\markup {"t"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{8. Quilisma Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes
+    \[ \quilisma g \pes b \]
+    s^\markup {"u"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes Auctus Descendens
+    \[ \quilisma g \pes \auctum \descendens b \]
+    s^\markup {"v"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{9. Podatus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Initio Debilis
+    \[ \deminutum g \pes b \]
+    s^\markup {"w"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens Initio Debilis
+    \[ \deminutum g \pes \auctum \descendens b \]
+    s^\markup {"x"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{10. Torculus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus
+    \[ a \pes b \flexa g \]
+    s^\markup {"y"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens
+    \[ a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"z"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus
+    \[ a \pes b \flexa \deminutum g \]
+    s^\markup {"A"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{11. Torculus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Initio Debilis
+    \[ \deminutum a \pes b \flexa g \]
+    s^\markup {"B"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens Initio Debilis
+    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"C"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus Initio Debilis
+    \[ \deminutum a \pes b \flexa \deminutum g \]
+    s^\markup {"D"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{12. Porrectus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus
+    \[ a \flexa g \pes b \]
+    s^\markup {"E"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Auctus Descendens
+    \[ a \flexa g \pes \auctum \descendens b \]
+    s^\markup {"F"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Deminutus
+    \[ a \flexa g \pes \deminutum b \]
+    s^\markup {"G"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{13. Climacus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus
+    \[ \virga b \inclinatum a \inclinatum g \]
+    s^\markup {"H"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Auctus
+    \[ \virga b \inclinatum a \inclinatum \auctum g \]
+    s^\markup {"I"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Deminutus
+    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
+    s^\markup {"J"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{14. Scandicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus
+    \[ g \pes a \virga b \]
+    s^\markup {"K"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Auctus Descendens
+    \[ g \pes a \pes \auctum \descendens b \]
+    s^\markup {"L"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Deminutus
+    \[ g \pes a \pes \deminutum b \]
+    s^\markup {"M"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{15. Salicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus
+    \[ g \oriscus a \pes \virga b \]
+    s^\markup {"N"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus Auctus Descendens
+    \[ g \oriscus a \pes \auctum \descendens b \]
+    s^\markup {"O"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{16. Trigonus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Trigonus
+    \[ \stropha b \stropha b \stropha a \]
+    s^\markup {"P"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@tab
+
+@end multitable
+
+
+Al contrario que la mayor parte de los otros sistemas de notación de neumas, el lenguaje de entrada
+para los neumas no refleja la apariencia tipográfica, sino que está pensado para
+mantener la atención sobre el significado musical.  Por ejemplo, @code{\[ a \pes b
+\flexa g \]} produce un Torculus que consiste en tres cabezas de Punctum,
+mientras que @code{\[ a \flexa g \pes b \]} produce un Porrectus con una forma
+de flexa curvada y una sola cabeza de Punctum.  No existe ninguna instrucción para
+tipografiar explícitamente la forma de flexa curvada; la decisión de
+cuándo tipografiar una forma de flexa curvada está basada en la entrada
+musical.  La idea de este enfoque es separar los aspectos musicales
+de la entrada, del estilo de notación de la salida.  De esta forma, la misma
+entrada se puede reutilizar para tipografiar la misma música en un estilo diferente
+de notación de Canto Gregoriano.
+
+La tabla siguiente muestra los fragmentos de código que producen las
+ligaduras en la anterior tabla de neumas.  La letra de la primera columna
+de cada línea en la tabla siguiente, indica a qué ligadura de la tabla anterior se refiere.
+La segunda columna da el nombre de la
+ligadura.  La tercera columna muestra el fragmento de código que produce esta ligadura,
+utilizando @code{g}, @code{a} @code{b} (Sol, La y Si) como notas de ejemplo.
+
+@multitable @columnfractions .02 .31 .67
+@item
+@b{#}
+@tab
+@b{Nombre}
+@tab
+@b{Frase de la entrada}
+
+@item
+a
+@tab
+Punctum
+@tab
+@code{\[ b \]}
+
+@item
+b
+@tab
+Punctum Inclinatum
+@tab
+@code{\[ \inclinatum b \]}
+
+@item
+c
+@tab
+Punctum Auctum@*
+Ascendens
+@tab
+@code{\[ \auctum \ascendens b \]}
+
+@item
+d
+@tab
+Punctum Auctum@*
+Descendens
+@tab
+@code{\[ \auctum \descendens b \]}
+
+@item
+e
+@tab
+Punctum Inclinatum@*
+Auctum
+@tab
+@code{\[ \inclinatum \auctum b \]}
+
+@item
+f
+@tab
+Punctum Inclinatum@*
+Parvum @tab
+@code{\[ \inclinatum \deminutum b \]}
+
+@item
+g
+@tab
+Virga
+@tab
+@code{\[ \virga b \]}
+
+@item
+h
+@tab
+Stropha
+@tab
+@code{\[ \stropha b \]}
+
+@item
+i
+@tab
+Stropha Aucta
+@tab
+@code{\[ \stropha \auctum b \]}
+
+@item
+j
+@tab
+Oriscus
+@tab
+@code{\[ \oriscus b \]}
+
+@item
+k
+@tab
+Clivis vel Flexa
+@tab
+@code{\[ b \flexa g \]}
+
+@item
+l
+@tab
+Clivis Aucta@*
+Descendens
+@tab
+@code{\[ b \flexa \auctum \descendens g \]}
+
+@item
+m
+@tab
+Clivis Aucta@*
+Ascendens
+@tab
+@code{\[ b \flexa \auctum \ascendens g \]}
+
+@item
+n
+@tab
+Cephalicus
+@tab
+@code{\[ b \flexa \deminutum g \]}
+
+@item
+o
+@tab
+Podatus vel Pes
+@tab
+@code{\[ g \pes b \]}
+
+@item
+p
+@tab
+Pes Auctus@*
+Descendens
+@tab
+@code{\[ g \pes \auctum \descendens b \]}
+
+@item
+q
+@tab
+Pes Auctus@*
+Ascendens
+@tab
+@code{\[ g \pes \auctum \ascendens b \]}
+
+@item
+r
+@tab
+Epiphonus
+@tab
+@code{\[ g \pes \deminutum b \]}
+
+@item
+s
+@tab
+Pes Quassus
+@tab
+@code{\[ \oriscus g \pes \virga b \]}
+
+@item
+t
+@tab
+Pes Quassus@*
+Auctus Descendens @tab
+@code{\[ \oriscus g \pes \auctum \descendens b \]}
+
+@item
+u
+@tab
+Quilisma Pes
+@tab
+@code{\[ \quilisma g \pes b \]}
+
+@item
+v
+@tab
+Quilisma Pes@*
+Auctus Descendens
+@tab
+@code{\[ \quilisma g \pes \auctum \descendens b \]}
+
+@item
+w
+@tab
+Pes Initio Debilis
+@tab
+@code{\[ \deminutum g \pes b \]}
+
+@item
+x
+@tab
+Pes Auctus Descendens@*
+Initio Debilis
+@tab
+@code{\[ \deminutum g \pes \auctum \descendens b \]}
+
+@item
+y
+@tab
+Torculus
+@tab
+@code{\[ a \pes b \flexa g \]}
+
+@item
+z
+@tab
+Torculus Auctus@*
+Descendens
+@tab
+@code{\[ a \pes b \flexa \auctum \descendens g \]}
+
+@item
+A
+@tab
+Torculus Deminutus
+@tab
+@code{\[ a \pes b \flexa \deminutum g \]}
+
+@item
+B
+@tab
+Torculus Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa g \]}
+
+@item
+C
+@tab
+Torculus Auctus@*
+Descendens Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
+
+@item
+D
+@tab
+Torculus Deminutus@*
+Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
+
+@item
+E
+@tab
+Porrectus
+@tab
+@code{\[ a \flexa g \pes b \]}
+
+@item
+F
+@tab
+Porrectus Auctus@*
+Descendens
+@tab
+@code{\[ a \flexa g \pes \auctum \descendens b \]}
+
+@item
+G
+@tab
+Porrectus Deminutus
+@tab
+@code{\[ a \flexa g \pes \deminutum b \]}
+
+@item
+H
+@tab
+Climacus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum g \]}
+
+@item
+I
+@tab
+Climacus Auctus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
+
+@item
+J
+@tab
+Climacus Deminutus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
+
+@item
+K
+@tab
+Scandicus
+@tab
+@code{\[ g \pes a \virga b \]}
+
+@item
+L
+@tab
+Scandicus Auctus@*
+Descendens
+@tab
+@code{\[ g \pes a \pes \auctum \descendens b \]}
+
+@item
+M
+@tab
+Scandicus Deminutus
+@tab
+@code{\[ g \pes a \pes \deminutum b \]}
+
+@item
+N
+@tab
+Salicus
+@tab
+@code{\[ g \oriscus a \pes \virga b \]}
+
+@item
+O
+@tab
+Salicus Auctus Descendens
+@tab
+@code{\[ g \oriscus a \pes \auctum \descendens b \]}
+
+@item
+P
+@tab
+Trigonus
+@tab
+@code{\[ \stropha b \stropha b \stropha a \]}
+@end multitable
+
+Las ligaduras que se acaban de relacionar sirven principalmente como un conjunto limitado, pero
+representativo, de ejemplos de ligaduras gregorianas.  Dentro de los delimitadores de ligadura
+@code{\[} y @code{\]}, prácticamente cualquier cantidad de notas
+se pueden acumular para formar una única ligadura, y los prefijos de cabeza como
+@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
+etc. se pueden intermezclar como se desee.  La utilización del conjunto de reglas que subyace
+a la construcción de las ligaduras en la tabla anterior se extrapola de la forma correspondiente.
+De esta manera se pueden crear una cantidad infinita de
+ligaduras diferentes.
+
+Los puntos de aumentación, llamados también @emph{morae}, se escriben con la función
+musical @code{\augmentum}.  Dese cuenta de que @code{\augmentum} está
+programado como una función musical unaria y no como un prefijo principal.  Se
+aplica solamente a la expresión musical que sigue inmediatamente.  Esto es,
+@code{\augmentum \virga c} no tendrá ningún efecto visible.  En su lugar, escriba
+@code{\virga \augmentum c} o @code{\augmentum @{\virga c@}}.  Tenga en cuenta
+también que puede escribir @code{\augmentum @{a g@}} como abreviatura de
+@code{\augmentum a \augmentum g}.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \[ \augmentum a \flexa \augmentum g \]
+    \augmentum g
+  }
+}
+@end lilypond
+
+@refcommands
+
+Están contemplados los siguientes prefijos de cabeza:
+
+@funindex \virga
+@code{\virga},
+@funindex \stropha
+@code{\stropha},
+@funindex \inclinatum
+@code{\inclinatum},
+@funindex \auctum
+@code{\auctum},
+@funindex \descendens
+@code{\descendens},
+@funindex \ascendens
+@code{\ascendens},
+@funindex \oriscus
+@code{\oriscus},
+@funindex \quilisma
+@code{\quilisma},
+@funindex \deminutum
+@code{\deminutum},
+@funindex \cavum
+@code{\cavum},
+@funindex \linea
+@code{\linea}.
+
+Los prefijos de Punctum se pueden acumular entre sí, aunque son de aplicación ciertas restricciones.  Por
+ejemplo, se pueden aplicar @code{\descendens} o bien @code{\ascendens} a una cabeza,
+pero no los dos a la misma.
+
+@funindex \pes
+@funindex \flexa
+Dos cabezas adyacentes se pueden ligar entre sí con las instrucciones infijas @code{\pes} y
+@code{\flexa} para una línea melódica ascendente y descendente,
+respectivamente.
+
+@funindex \augmentum
+Utilice la función musical unaria @code{\augmentum} para escribir puntos de aumentación.
+
+@refbugs
+
+Cuando un punto @code{\augmentum} aparece al final de la última pauta
+dentro de una ligadura, a veces se sitúa verticalmente en un lugar equivocado.  Como solución
+parcial, escriba una nota de salto adicional (e.g. @code{s8}) como la última nota
+de esa pauta.
+
+@code{\augmentum} debería estar programada como un prefijo de cabeza y no como una
+función musical unaria, de forma que @code{\augmentum} pudiera entremezclarse
+con los prefijos de cabeza en un orden arbitrario.
+
+@node Gregorian Chant contexts
+@unnumberedsubsubsec Gregorian Chant contexts
+
+@cindex VaticanaVoiceContext
+@cindex VaticanaStaffContext
+
+El contexto predefinido de voz @code{VaticanaVoiceContext} y el de
+pauta @code{VaticanaStaffContext} se pueden utilizar para grabar una pieza de
+Canto Gregoriano en el estilo de la Editio Vaticana.  Estos contextos
+establecen a unos valores iniciales adecuados todas las propiedades relevantes de los contextos y de los objetos gráficos,
+de forma que pueda inmediatamente comenzar a escribir el canto en sí,
+como lo demuestra el siguiente fragmento
+
+@lilypond[quote,ragged-right,packed,verbatim]
+\include "gregorian-init.ly"
+\score {
+  <<
+    \new VaticanaVoice = "cantus" {
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \]
+      f \divisioMinima
+      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
+      c' \divisioMinima \break
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
+    }
+    \new Lyrics \lyricsto "cantus" {
+      San- ctus, San- ctus, San- ctus
+    }
+  >>
+}
+@end lilypond
+
+
+@node Mensural contexts
+@unnumberedsubsubsec Mensural contexts
+
+@cindex MensuralVoiceContext
+@cindex MensuralStaffContext
+
+Los contextos predefinidos de voz @code{MensuralVoiceContext} y de pauta
+@code{MensuralStaffContext} se pueden usar para grabar una pieza en estilo mensural.
+Estos contextos establecen a unos valores iniciales adecuados todas las propiedades relevantes de los contextos y
+de los objetos gráficos, de manera que pueda comenzar inmediatamente a
+escribir el canto, como lo demuestra el siguiente fragmento
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new MensuralVoice = "discantus" \transpose c c' {
+      \override Score.BarNumber #'transparent = ##t {
+        c'1\melisma bes a g\melismaEnd
+        f\breve
+        \[ f1\melisma a c'\breve d'\melismaEnd \]
+        c'\longa
+        c'\breve\melisma a1 g1\melismaEnd
+        fis\longa^\signumcongruentiae
+      }
+    }
+    \new Lyrics \lyricsto "discantus" {
+      San -- ctus, San -- ctus, San -- ctus
+    }
+  >>
+}
+@end lilypond
+
+@node Musica ficta accidentals
+@unnumberedsubsubsec Musica ficta accidentals
+
+En la música europea de hasta aprox. 1600, se esperaba de los cantantes que
+alterasen cromáticamente ciertas notas de acuerdo con su propia iniciativa. Esto recibe el nombre
+de @q{Musica Ficta}. En las transcripciones modernas, estas alteraciones accidentales se
+imprimen normalmente encima de la nota.
+
+@cindex Accidental, musica ficta
+@cindex Musica ficta
+
+Están contempladas estas alteraciones sugeridas, y se pueden activar
+estableciendo @code{suggestAccidentals} al valor cierto.
+
+@funindex suggestAccidentals
+
+@lilypond[verbatim,fragment,relative=1]
+fis gis
+\set suggestAccidentals = ##t
+ais bis
+@end lilypond
+
+@seealso
+
+Referencia del programa: el grabador @internalsref{Accidental_engraver} y el objeto
+@internalsref{AccidentalSuggestion}.
+
+@node Figured bass
+@unnumberedsubsubsec Figured bass
+
+@cindex Bajo continuo
+
+@c TODO: musicological blurb about FB
+
+
+LilyPond contempla el bajo figurado
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+<<
+  \new Voice { \clef bass dis4 c d ais g fis}
+  \new FiguredBass \figuremode {
+    < 6 >4 < 7\+ >8 < 6+ [_!] >
+    < 6 >4 <6 5 [3+] >
+    < _ >4 < 6 5/>4
+  }
+>>
+@end lilypond
+
+El soporte para el bajo figurado consta de dos partes: hay un modo de entrada,
+que se inicia mediante @code{\figuremode}, en el que puede escribir las cifras del bajo
+como números, y hay un contexto llamado @internalsref{FiguredBass} que se ocupa
+de crear los objetos @internalsref{BassFigure} (cifras del bajo).
+
+En el modo de entrada de cifras, un grupo de cifras del bajo se encuentra delimitado por
+los paréntesis en ángulo @code{<} y @code{>}.  La duración se introduce después del ángulo de cierre @code{>}
+@example
+<4 6>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { <4 6> }
+@end lilypond
+
+Las alteraciones se añaden al escribir @code{-}, @code{!} y @code{+}
+después de los números.  Se añadirá un signo más plus cuando escriba @code{\+}, y las
+quintas y séptimas disminuidas se pueden obtener con @code{5/} y @code{7/}.
+
+@example
+<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@end lilypond
+
+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}.
+
+@example
+< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@end lilypond
+
+
+Además es posible usar líneas de continuación para las cifras que se repiten,
+
+@lilypond[verbatim,relative=1]
+<<
+  \new Staff {
+    \clef bass
+    c4 c c
+  }
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <4 6> <3 6> <3 7>
+  }
+>>
+@end lilypond
+
+@noindent
+En este caso, las líneas de extensión siempre sustituyen a las cifras existentes.
+
+El contexto @code{FiguredBass} no presta atención a la propia línea del
+bajo. Como consecuencia, quizá tenga que insertar cifras adicionales para
+obtener líneas de extensión bajo todas las notas, y puede que necesite añadir @code{\!}
+para evitar que aparezca una línea de extensión, e.g.
+
+@lilypond[relative=1]
+<<
+  \new Voice
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+  }
+  {
+    \clef bass
+    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+  }
+>>
+@end lilypond
+
+Al usar líneas de continuación, las cifras comunes siempre se colocan
+en la misma posición vertical. Si esto no es lo que desea, puede insertar un silencio
+con @code{r}. El silencio borrará cualquier alineación previa.  Por
+ejemplo, puede escribir
+
+@example
+  <4 6>8 r8
+@end example
+
+@noindent
+instead of
+@example
+  <4 6>4
+@end example
+
+Las alteraciones y signos más pueden aparecer antes o después de los números,
+dependiendo de las propiedades dirección de la alteración establecida en @code{figuredBassAlterationDirection} y la
+dirección del signo más establecida en @code{figuredBassPlusDirection}
+
+
+@lilypond
+  \figures {
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassPlusDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #-1
+    <6\+> <5+> <6 4-> r
+  }
+@end lilypond
+
+
+Aunque posiblemente la forma en que está contemplado el bajo figurado se parece superficialmente a los
+acordes, es mucho más simple.  El modo @code{\figuremode} sencillamente
+almacena los números, y el contexto @internalsref{FiguredBass} los imprime
+tal y como se han escrito.  No hay ninguna conversión a alturas de nota ni se reproduce ninguna realización
+del bajo en el archivo MIDI.
+
+Internamente, el código del programa produce elementos de marcado textual.  Puede utilizar cualquiera de las
+propiedades de los elementos de marcado textual para sobreescribir los detalles del formateo.  Por ejemplo, el
+espaciado vertical de las cifras se puede establecer con @code{baseline-skip}.
+
+
+El bajo figurado también se puede añadir a contextos @code{Staff} (de pauta)
+directamente.  En este caso, su posición vertical se ajusta de
+forma automática.
+
+@lilypond[ragged-right,fragment,quote]
+<<
+  \new Staff = someUniqueName
+  \relative c'' {
+    c4 c'8 r8 c,4 c'
+  }
+
+  %% send to existing Staff.
+  \context Staff = someUniqueName 
+  \figuremode {
+    <4>4 <6 10>8 s8
+    
+    \set Staff.useBassFigureExtenders = ##t
+    <4 6>4 <4 6>
+  }
+>>
+@end lilypond
+
+
+@commonprop
+
+Por defecto, este método produce cifras encima de las notas. Para obtener
+cifras por debajo de las notas, utilice
+
+@example
+\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
+@end example
+
+
+@refbugs
+
+Al usar bajos figurados por encima del pentagrama con líneas de extensión y
+@code{implicitBassFigures}, las líneas podrían intercambiarse.
+Es imposible mantener el orden de forma consistente cuando varias cifras
+tienen líneas de extensión que se superponen.  Para evitar este problema, utilice
+@code{stacking-dir} sobre @code{BassFigureAlignment}.
+
+
+@seealso
+
+Referencia del programa: Objetos @internalsref{NewBassFigure},
+@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
+@internalsref{BassFigureBracket} y 
+@internalsref{BassFigureContinuation} y el contexto
+@internalsref{FiguredBass}.
+
+
diff --git a/Documentation/es/user/bagpipes.itely b/Documentation/es/user/bagpipes.itely
new file mode 100644
index 0000000000..b4c5b92b7e
--- /dev/null
+++ b/Documentation/es/user/bagpipes.itely
@@ -0,0 +1,113 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Bagpipes
+@section Bagpipes
+
+This section includes extra information for writing for bagpipes.
+
+@menu 
+* Bagpipe::
+@end menu
+
+
+@node Bagpipe
+@subsection Bagpipe
+
+@menu 
+* Bagpipe definitions::
+* Bagpipe example::
+@end menu
+
+@node Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+LilyPond contiene definiciones especiales para la música de gaita escocesa de las
+tierras altas; para usarlas, escriba
+
+@example
+\include "bagpipe.ly"
+@end example
+
+@noindent
+al principio del archivo de entrada.  De esta forma podrá escribir las notas de adorno especiales
+que son usuales en la música de gaita, mediante instrucciones breves.  Por ejemplo, puede escribir
+@code{\taor} en lugar de
+
+@example
+\grace @{ \small G32[ d G e] @}
+@end example
+
+@code{bagpipe.ly} también contiene definiciones de alturas para las notas de la
+gaita en las octavas adecuadas, de forma que no se tenga que preocupar por
+@code{\relative} o por @code{\transpose}.
+
+@lilypond[ragged-right,verbatim,quote,notime]
+\include "bagpipe.ly"
+{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
+@end lilypond
+
+La música de gaita utiliza siempre la tonalidad de Re mayor (aunque esto no es
+completamente cierto). Sin embargo, puesto que es la única tonalidad que se puede utilizar,
+normalmente la armadura no se escribe. Para configurar esto de forma correcta,
+comience la música siempre con @code{\hideKeySignature} (ocultar armadura). Si, por algún motivo,
+quiere mostrar la armadura, puede usar @code{\showKeySignature}
+en su lugar.
+
+Alguna música moderna utiliza digitaciones cruzadas sobre el Do y el Fa para bemolizar estas notas.
+Se puede indicar esto mediante @code{cflat} o @code{fflat}. De forma parecida, el
+sol agudo piobaireachd se puede escribir @code{gflat} cuando aparece en música
+ligera.
+
+
+@node Bagpipe example
+@unnumberedsubsubsec Bagpipe example
+
+La conocida melodía Amazing Grace tiene este aspecto en notación de
+gaita.
+
+@lilypond[verbatim,quote]
+\include "bagpipe.ly"
+\layout {
+  indent = 0.0\cm
+  \context { \Score \remove "Bar_number_engraver" }
+}
+
+\header {
+  title = "Amazing Grace"
+  meter = "Hymn"
+  arranger = "Trad. arr."
+}
+
+{
+  \hideKeySignature
+  \time 3/4
+  \grg \partial 4 a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg e8. f16
+  \dblA A2 \grg A4
+  \grg A2 f8. A16
+  \grg A2 \hdblf f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 e4
+  \thrwd d2.
+  \slurd d2
+  \bar "|."
+}
+@end lilypond
+
+
diff --git a/Documentation/es/user/basic-notation.itely b/Documentation/es/user/basic-notation.itely
deleted file mode 100644
index 9207211caf..0000000000
--- a/Documentation/es/user/basic-notation.itely
+++ /dev/null
@@ -1,3525 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: 4d9a81ea05bea52229dd9045b9eceecd64dbe61d
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Basic notation
-@chapter Basic notation
-
-Este capítulo explica cómo usar las funcionalidades de notación básica.
-
-@menu
-* Pitches::                     
-* Rhythms::                     
-* Polyphony::                   
-* Staff notation::              
-* Connecting notes::            
-* Expressive marks::            
-* Repeats::                     
-@end menu
-
-
-
-@node Pitches
-@section Pitches
-
-Esta sección trata de cómo especificar la altura de las notas.
-
-@menu
-* Normal pitches::              
-* Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
-* Note names in other languages::  
-* Relative octaves::            
-* Octave check::                
-* Transpose::                   
-* Rests::                       
-* Skips::                       
-@end menu
-
-
-@node Normal pitches
-@subsection Normal pitches
-
-@cindex Nombres de las notas
-@cindex alturas
-
-El nombre de una nota se especifica usando las letras minúsculas de la @code{a} a la @code{g}.
-Una escala ascendente de Do mayor se tipografía con
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef bass
-c d e f g a b c'
-@end lilypond
-
-El nombre de la nota @code{c} se tipografía una octava por debajo del Do central.
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef treble
-c1
-\clef bass
-c1
-@end lilypond
-
-@funindex '
-@funindex ,
-
-La especificación opcional de la octava tiene la forma de una serie de
-comillas simples o apóstrofes (@samp{'}) o bien una serie de comas
-(@samp{,}).  Cada @samp{'} eleva la altura una octava;
-cada @samp{,} baja la altura una octava.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\clef treble
-c' c'' e' g d'' d' d c
-\clef bass
-c, c,, e, g d,, d, d c
-@end lilypond
-
-Se puede usar un método alternativo para declarar en qué octava grabar
-una nota; este método no requiere tantas especificaciones de octava
-(@code{'} y @code{,}).  Consulte
-@ref{Relative octaves}.
-
-
-@node Accidentals
-@subsection Accidentals
-
-@cindex nombres de las notas, holandés
-@cindex nombres de las notas, por omisión
-
-Un sostenido se forma añadiendo @code{-is} al final del nombre de la nota y
-un bemol se forma añadiendo @code{-es}.  Los dobles sostenidos y dobles bemoles
-se obtienen añadiendo @code{-isis} o @code{-eses} al nombre de la nota.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
-@end lilypond
-
-@noindent
-Estos son los nombres de las notas en holandés.  En holandés, @code{aes} se contrae en
-@code{as}, pero las dos formas se aceptan.  De forma similar, se aceptan
-tanto @code{es} como @code{ees}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
-@end lilypond
-
-Un becuadro cancelará el efecto de una alteración accidental o de la armadura.
-Sin embargo, los becuadros no se codifican dentro de la sintaxis del nombre de la nota con un
-sufijo; una nota becuadro se muestra como un simple nombre de nota natural
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a4 aes a2
-@end lilypond
-
-La entrada @code{d e f} se interpreta como @q{imprimir un Re natural,
-Mi natural y Fa natural}, independientemente de la armadura de la tonalidad.
-Para ver más información acerca de la distinción entre
-el contenido musical y la presentación de ese contenido, consulte
-@ref{Accidentals and key signatures}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
-@end lilypond
-
-
-@commonprop
-
-De acuerdo con las reglas estándar del tipografiado, se imprime un signo de becuadro
-antes de un sostenido o un bemol siempre que una alteración anterior tiene que cancelarse.
-Para modificar este comportamiento, utilice
-@code{\set Staff.extraNatural = ##f}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-ceses4 ces cis c
-\set Staff.extraNatural = ##f
-ceses4 ces cis c
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{LedgerLineSpanner},
-@internalsref{NoteHead}.
-
-
-@node Cautionary accidentals
-@subsection Cautionary accidentals
-
-@cindex alteración recordatoria
-@cindex alteración de precaución
-@cindex alteración con paréntesis
-@cindex recordatoria, alteración
-@funindex ?
-@cindex precaución, alteración de
-@cindex paréntesis, alteración con
-@funindex !
-
-Normalmente las alteraciones accidentales se imprimen automáticamente, pero también puede
-imprimirlas manualmente.  Un alteración recordatoria
-se puede forzar añadiendo un signo de admiración @code{!}
-después de la altura de la nota.  Una alteración de precaución
-(o sea, una alteración entre paréntesis) se puede obtener añadiendo el
-signo de interrogación @samp{?} después del nombre de la nota.  Estas alteraciones adicionales
-se pueden usar también para producir notas con becuadro.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-cis cis cis! cis? c c? c! c
-@end lilypond
-
-
-@seealso
-
-La producción automática de alteraciones accidentales se puede ajustar de muchas formas.
-Para ver más información, consulte @ref{Automatic accidentals}.
-
-
-@node Micro tones
-@subsection Micro tones
-
-@cindex cuartos de tono
-@cindex semi-bemoles, semi-sostenidos
-
-Los medios bemoles y los medios sostenidos se forman añadiendo @code{-eh} y
-@code{-ih}; a continuación presentamos una serie de DOs cada vez más agudos
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Los microtonos también se exportan al archivo MIDI.
-
-
-@refbugs
-
-No existen estándares reconocidos ampliamente para denotar
-los bemoles de tres cuartos, de manera que los símbolos de LilyPond
-no se ajustan a ningún estándar.
-
-
-@node Note names in other languages
-@subsection Note names in other languages
-
-Existen conjuntos predefinidos de nombres de notas para algunos idiomas
-aparte del inglés.  Para usarlos, incluya el archivo de inicio
-específico del idioma.  Por ejemplo, añada @code{\include "english.ly"}
-al principio del archivo de entrada.  Los archivos de idioma disponibles
-y los nombres de las notas que definen son los siguientes:
-
-@c  Should this be made into a multitable?
-@cindex idiomas, nombres de las notas en otros
-@example
-                     Nombres de las notas      sostenido   bemol       doble        doble
-                                                                      sostenido     bemol
-
-nederlands.ly  c   d   e   f   g   a   bes b   -is         -es       -isis         -eses
-english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat  -ss/-x/       -ff/
-                                                                     -sharpsharp   -flatflat
-deutsch.ly     c   d   e   f   g   a   b   h   -is         -es       -isis         -eses
-norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es  -ississ/-isis -essess/-eses
-svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess      -ississ       -essess
-italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b        -dd           -bb
-catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b        -dd/-ss       -bb
-espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b        -ss           -bb
-@end example
-
-@noindent
-Tenga en cuenta que en holandés, alemán, noruego y sueco, los bemoles
-del @samp{La} como por ejemplo @code{aes} y @code{aeses}
-se contraen normalmente como @code{as} y @code{ases} (o más frecuentemente
-como @code{asas}). Algunas veces se definen sólo estas contracciones
-en los archivos de idioma correspondientes (esto también se aplica a los
-sufijos para cuartos de tono que se ven más abajo).
-
-@noindent
-Algunas músicas utilizan microtonos cuyas alteraciones son fracciones
-de un sostenido o bemol @q{normales}.  Los nombres de nota para cuartos
-de tono que se definen en los distintos archivos de idioma se encuentran
-listados en la tabla siguiente.  Aquí los prefijos @q{semi-} y @q{sesqui-} significan
-@q{medio} y @q{uno y medio} respectivamente.  Para el noruego,
-sueco, catalán y español no se ha definido aún ningún nombre especial.
-@c What about Turkish Maquam music and similar microtonal systems?
-@c
-@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
-@c is actually misleading since the alteration is in fact one and a half
-@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
-
-@example
-                    Nombres de las notas       semi-      semi-  sesqui-    sesqui-
-                                               sostenido  bemol  sostenido  bemol
-
-nederlands.ly  c   d   e   f   g   a   bes b   -ih       -eh     -isih      -eseh
-english.ly     c   d   e   f   g   a   bf  b   -qs       -qf     -tqs       -tqf
-deutsch.ly     c   d   e   f   g   a   b   h   -ih       -eh     -isih      -eseh
-norsk.ly       c   d   e   f   g   a   b   h   
-svenska.ly     c   d   e   f   g   a   b   h   
-italiano.ly    do  re  mi  fa  sol la  sib si  -sd       -sb     -dsd       -bsb
-catalan.ly     do  re  mi  fa  sol la  sib si  
-espanol.ly     do  re  mi  fa  sol la  sib si  
-@end example
-
-
-
-@node Relative octaves
-@subsection Relative octaves
-
-@cindex Relativo
-@cindex Relativas, especificación de octavas
-@funindex \relative
-
-Las octavas se especifican añadiendo @code{'} y @code{,} a los nombres de las notas.
-Cuando copie música existente, es fácil poner por accidente una nota en la octava
-equivocada y luego es difícil encontrar dicho error.  La octava relativa
-previene estos errores haciendo que éstos tengan consecuencias mucho mayores:
-un solo error transporta una octava el resto de la pieza
-
-@example
-\relative @var{altura_inicial} @var{expresión_musical}
-@end example
-
-@noindent
-o bien
-
-@example
-\relative @var{expresión_musical}
-@end example
-
-@noindent
-@code{c'} se usa por defecto si no se define una altura inicial.
-
-La octava de las notas que aparecen dentro de @var{expresión_musical} se calculan como
-sigue: si no se usa ninguna marca de cambio de octava, el intervalo básico
-entre la nota actual y la anterior se toma siempre como si fuera una cuarta o menos.
-Esta distancia se determina independientemente de las alteraciones; un
-@code{fisis} (Fa doble sostenido) después de un @code{ceses} (Do doble bemol) se colocará
-por encima del @code{ceses}.  En otras palabras, una cuarta doble aumentada se considera
-un intervalo menor que una quinta disminuida, incluso aunque la cuarta doble aumentada
-tiene siete semitonos mientras que la quinta disminuida sólo tiene seis semitonos.
-
-Las marcas de cambio de octava @code{'} y @code{,} se pueden añadir para
-elevar o bajar la altura en una octava más.  Al entrar en el modo relativo,
-se puede especificar una altura de inicio absoluta que se comportará como
-la nota precedente a la primera nota de la @var{expresión_musical}.  Si no
-se especifica ninguna altura inicial, se utilizará el Do central como
-comienzo.
-
-Aquí podemos ver el modo relativo en acción:
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-Las marcas de cambio de octava se utilizan para intervalos mayores de la cuarta
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Si el elemento anterior es un acorde, la primera nota del acorde se utiliza para
-determinar la primera nota del siguiente acorde
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-La altura después del @code{\relative} contiene un nombre de nota.
-
-La conversión relativa no afecta a las secciones @code{\transpose},
-@code{\chordmode} o @code{\relative} en su argumento.  Para usar
-el modo relativo dentro de música transportada, se debe escribir 
-un @code{\relative} adicional dentro de @code{\transpose}.
-
-
-@node Octave check
-@subsection Octave check
-
-@cindex Comprobación de octava
-
-Las comprobaciones de octava hacen que los errores de octava sean más
-fáciles de corregir: una nota puede venir seguida de @code{=}@var{comillas}
-lo que indica cuál debería ser su octava absoluta.  En el siguiente ejemplo,
-
-@example
-\relative c'' @{ c='' b=' d,='' @}
-@end example
-
-@noindent
-la @code{d} generará una advertencia, porque se esperaba un @code{d''}
-(a causa de que el intervalo de @code{b'} a @code{d''} es de una tercera solamente),
-pero aparece un @code{d'}.  En la salida, la octava se corrige para que sea un @code{d''} y
-la siguiente nota se calcula de forma relativa a @code{d''} en lugar de a @code{d'}.
-
-También existe una comprobación de octava que no produce ninguna salida visible. La sintaxis
-
-@example
-\octave @var{altura}
-@end example
-
-comprueba que @var{altura} (sin las comillas) produce @var{altura} (con
-las comillas) en modo @code{\relative} comparado con la nota que se da en el
-comando @code{\relative}.  Si no es así, se imprime una advertencia, y la
-octava se corrige.  La @var{altura} no se imprime como una nota.
-
-En el ejemplo que aparece a continuación, la primera comprobación
-se aprueba sin más problema, porque el @code{e} (en modo @code{relative})
-está dentro de una quinta desde @code{a'}.  Sin embargo
-la segunda comprobación produce una advertencia porque el @code{e} no está dentro
-de una quinta del @code{b'}.  Se imprime el mensaje de advertencia y la octava se ajusta
-de modo que las notas siguientes están en la octava correcta
-de nuevo.
-
-@example
-\relative c' @{
-  e
-  \octave a'
-  \octave b'
-@}
-@end example
-
-
-La octava de una nota que sigue a una comprobación de octava
-se determina con respecto a la nota que la precede.  En el siguiente fragmento,
-la última nota es una @code{a'}, por encima del Do central.  Esto
-significa que la comprobación de @code{\octave} se aprueba satisfactoriamente,
-así que la comprobación se puede borrar sin que cambie la salida de la pieza.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octave b
-  a
-}
-@end lilypond
-
-
-@node Transpose
-@subsection Transpose
-
-@cindex Transposición
-@cindex Transposición de alturas
-@funindex \transpose
-
-Una expresión musical se puede transportar mediante @code{\transpose}.  La
-sintaxis es
-@example
-\transpose @var{desde} @var{hacia} @var{expresión_musical}
-@end example
-
-Esto significa que la @var{expresión_musical} se transporta el intervalo
-que hay entre las notas @var{desde} y @var{hacia}: cualquier nota con la altura @code{desde}
-se cambia por @code{hacia}.
-
-Por ejemplo, tomemos una pieza escrita en la tonalidad de Re mayor.
-Si esta pieza es demasiado grave para el ejecutante, se puede transportar
-hacia arriba a Mi mayor con
-@example
-\transpose d e @dots{}
-@end example
-
-Suponga una pieza escrita para el violín (que es un instrumento en Do).  Si
-esta parte se tiene que tocar con un clarinete en La (para el que un La
-se escribe como un Do, y que suena una tercera menor por debajo de lo que
-está escrito), el siguiente transporte producirá la particella correcta:
-
-@example
-\transpose a c @dots{}
-@end example
-
-@code{\transpose} distingue entre notas enarmónicas: tanto
-@code{\transpose c cis} como @code{\transpose c des} transportarán un
-semitono hacia arriba.  La primera versión imprimirá sostenidos y la
-segunda imprimirá bemoles
-
-
-@lilypond[quote,ragged-right,verbatim]
-mus = { \key d \major cis d fis g }
-\new Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
-}
-@end lilypond
-
-@code{\transpose} también se puede usar para introducir notas escritas para un
-instrumento transpositor.  Las alturas se introducen normalmente en LilyPond
-en Do (o en @q{afinación de concierto}), pero se pueden introducir en otra
-tonalidad.  Por ejemplo, al introducir música para una trompeta en Si bemol
-que comienza en un Re de concierto, se puede escribir
-
-@example
-\transpose c bes @{ e4 @dots{} @}
-@end example
-
-Para imprimir esta música en Si bemol de nuevo (o sea, para producir una particella de trompeta
-en vez de una partitura para el director en afinación de concierto), puede envolver la música existente
-con otro @code{transpose}
-
-@example
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
-@end example
-
-
-@seealso
-
-Referencia del programa: @internalsref{TransposedMusic}.
-
-Ejemplo: @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
-
-
-@refbugs
-
-Si quiere usar al mismo tiempo @code{\transpose} y @code{\relative},
-debe escribir @code{\transpose} por fuera de @code{\relative}, porque
-@code{\relative} no tendrá ningún efecto sobre la música que aparezca dentro de un
-@code{\transpose}.
-
-
-@node Rests
-@subsection Rests
-@cindex Silencios
-
-@funindex \rest
-@funindex r
-
-Los silencios se introducen como notas con el nombre @code{r}
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-r1 r2 r4 r8
-@end lilypond
-
-Los silencios de un compás centrados en medio del compás,
-se deben hacer con silencios multicompás.  Se pueden usar para 
-un solo compás así como para muchos compases, y se tratan en
-@ref{Multi measure rests}.
-
-Para especificar explícitamente la posición vertical de un silencio, escriba una nota
-seguida de @code{\rest}.  Se colocará un silencio en la posición en que debería
-aparecer la nota:
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-a'4\rest d'4\rest
-@end lilypond
-
-@noindent
-Esto hace mucho más sencillo el formateo de
-la música polifónica,
-porque el formateador automático de colisiones de silencios se olvidará de ellos.
-
-@seealso
-
-Referencia del programa: @internalsref{Rest}.
-
-
-@node Skips
-@subsection Skips
-
-@cindex Desplazamiento
-@cindex Silencio invisible
-@cindex Nota de espaciado
-@funindex \skip
-@funindex s
-
-Un silencio invisible -- también conocido como @q{skip} (desplazamiento) --
-se puede introducir como una nota con el nombre @samp{s} o con @code{\skip @var{duración}}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a4 a4 s4 a4 \skip 1 a4
-@end lilypond
-
-La sintaxis de @code{s} sólo está disponible en el modo de notas y en el modo de acordes.
-En otras situaciones, por ejemplo, cuando se introduce la letra, debe
-usar el comando @code{\skip}
-
-@lilypond[quote,ragged-right,verbatim]
-<<
-  \relative { a'2 a2 }
-  \new Lyrics \lyricmode { \skip 2 bla2 }
->>
-@end lilypond
-
-El comando skip es un mero contenedor musical vacío.  No produce
-ninguna salida, ni siquiera una salida transparente.
-
-El comando de desplazamiento @code{s} crea un @internalsref{Staff} y una
-@internalsref{Voice} cuando es necesario, de forma similar a los comandos de nota y de silencio.
-Por ejemplo, el fragmento siguiente produce un pentagrama vacío.
-
-@lilypond[quote,ragged-right,verbatim]
-{ s4 }
-@end lilypond
-
-El fragmento @code{@{ \skip 4 @} } produciría una página vacía.
-
-@seealso
-
-Referencia del programa: @internalsref{SkipMusic}.
-
-
-
-@node Rhythms
-@section Rhythms
-
-Esta sección trata los ritmos, duraciones y compases.
-
-@menu
-* Durations::                   
-* Augmentation dots::           
-* Tuplets::                     
-* Scaling durations::           
-* Bar check::                   
-* Barnumber check::             
-* Automatic note splitting::    
-@end menu
-
-
-@node Durations
-@subsection Durations
-
-@cindex duración
-@funindex \longa
-@funindex \breve
-@funindex \maxima
-
-En los modos de Nota, Acorde y Letra, las duraciones se designan
-mediante números y puntos: las duraciones se introducen como sus
-valores recíprocos respecto de la redonda.  Por ejemplo, una negra
-se escribe usando un @code{4} (puesto que es 1/4 de redonda), mientras
-que una blanca se escribe con un @code{2} (por ser 1/2 de redonda).  Para
-notas mayores de la redonda se deben usar los comandos @code{\longa} y @code{\breve}
-
-@example
-c'\breve
-c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
-r\longa r\breve
-r1 r2 r4 r8 r16 r32 r64 r64
-@end example
-
-@lilypond[quote]
-\score {
-\relative c'' {
-    a\breve*1/2 \autoBeamOff
-    a1 a2 a4 a8 a16 a32 a64 a64
-   \bar "empty"
-   \break
-    r\longa*1/4 r\breve *1/2
-    r1 r2 r4 r8 r16 r32 r64 r64
-  }
-  \layout {
-    ragged-right = ##t
-    indent=0\mm
-    \context {
-      \Score
-        \remove "Bar_number_engraver"
-    }
-    \context {
-      \Staff
-        \remove "Clef_engraver"
-        \override StaffSymbol #'transparent = ##t
-        \override TimeSignature #'transparent = ##t
-        \override BarLine #'transparent = ##t
-        \consists "Pitch_squash_engraver"
-    }
-  }
-}
-@end lilypond
-
-Si la duración se omite, su valor será el de la duración de la nota
-anterior.  Por omisión, el valor de la primera nota es el de una negra.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-{ a a a2 a a4 a a1 a }
-@end lilypond
-
-
-@node Augmentation dots
-@subsection Augmentation dots
-
-@funindex .
-
-Para obtener duraciones de notas con puntillo, simplemente escriba un
-punto (@samp{.}) después del número.  Las notas con doble puntillo se consiguen de manera similar.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-a'4 b' c''4. b'8 a'4. b'4.. c''8.
-@end lilypond
-
-@refcommands
-
-Normalmente los puntillos se desplazan hacia arriba para evitar las
-líneas del pentagrama, excepto en situaciones de polifonía.  Se pueden
-utilizar los siguientes comandos para forzar manualmente una dirección en particular
-
-@funindex \dotsUp
-@code{\dotsUp},
-@funindex \dotsDown
-@code{\dotsDown},
-@funindex \dotsNeutral
-@code{\dotsNeutral}.
-
-@seealso
-
-Referencia del programa: @internalsref{Dots} y @internalsref{DotColumn}.
-
-
-@node Tuplets
-@subsection Tuplets
-
-@cindex grupos especiales
-@cindex tresillos
-@funindex \times
-
-Los grupos especiales se obtienen a partir de una expresión musical
-multiplicando todas las duraciones por una fracción:
-
-@example
-\times @var{fracción} @var{expresión_musical}
-@end example
-
-@noindent
-La duración de la @var{expresión _musical} se multiplicará por la
-fracción.  El denominador de la fracción se imprimirá sobre las notas,
-opcionalmente con un corchete.  El grupo especial más común es el
-tresillo, en el que 3 notas tienen el valor de 2, por tanto las notas
-duran 2/3 de su valor escrito
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-g'4 \times 2/3 {c'4 c' c'} d'4 d'4
-@end lilypond
-
-Los grupos pueden anidarse unos dentro de otros, por ejemplo
-
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\override TupletNumber #'text = #tuplet-number::calc-fraction-text
-\times 4/6 {
-  a4 a
-  \times 3/5 { a a a a a }
-}
-@end lilypond
-
-@refcommands
-
-@funindex \tupletUp
-@code{\tupletUp},
-@funindex \tupletDown
-@code{\tupletDown},
-@funindex \tupletNeutral
-@code{\tupletNeutral}.
-
-
-@commonprop
-
-@funindex tupletNumberFormatFunction
-@cindex formateo de los grupos especiales
-
-La propiedad @code{tupletSpannerDuration} (duración del selector de
-grupo) especifica la duración de cada corchete.  Con esto puede hacer
-muchos grupos escribiendo @code{\times} una sola vez, ahorrándose
-mucho trabajo de teclado.  En el siguiente ejemplo se muestran dos
-tresillos, aunque @code{\times} sólo se ha utilizado una vez
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
-
-@noindent
-Para ver más información sobre @code{make-moment}, consulte
-@ref{Time administration}.
-
-El formato del número se determina por medio de la propiedad @code{text} en
-@code{TupletNumber}.  Por defecto se imprime sólo el denominador, pero si
-su valor se establece a la función @code{tuplet-number::calc-fraction-text},
-se imprimirá como @var{numerador}:@var{denominador}
-
-Para que no se impriman los números de los grupos, emplee
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-\override TupletNumber #'transparent = ##t
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-@end lilypond
-
-Utilice la función @code{\tweak} para sobreescribir los grupos anidados que comienzan en el mismo
-instante musical.  En este ejemplo, @code{\tweak} especifica un texto de fracción
-para el
-@code{TupletNumber} exterior y un texto de denominador para el @code{TupletNumber}
-del primero de los tres grupos interiores.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \times 4/3 {
-     \tweak #'text #tuplet-number::calc-denominator-text
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Aquí @code{\tweak} y @code{\override} trabajan conjuntamente para especificar la dirección
-del @code{TupletBracket} (el corchete del grupo).  El primer @code{\tweak} coloca
-el @code{TupletBracket} del grupo 
-exterior por encima del pentagrama.  El segundo @code{\tweak} coloca el
-@code{TupletBracket} del primero de los tres grupos interiores por debajo del
-pentagrama.  Tenga en cuenta que este par de funciones @code{\tweak} afecta solamente
-al grupo exterior y al primero de los tres grupos interiores porque sólo
-esos dos grupos comienzan en el mismo instante musical.  Utilizamos @code{\override}
-de la manera usual para colocar los corchetes @code{TupletBrackets} del
-segundo y tercer grupos interiores por debajo del pentagrama.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \tweak #'direction #up
-  \times 4/3 {
-     \tweak #'direction #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \override TupletBracket #'direction = #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Se puede hacer que los corchetes de grupo abarquen tanto como su duración completa indique o que lleguen hasta justo antes de la nota siguiente
-
-@lilypond[ragged-right]
-\new RhythmicStaff {
-  \set tupletFullLength = ##t
-  \time 4/4
-  \times 4/5 {
-    c4 c1
-  }
-  \set tupletFullLengthNote = ##t
-  \time 2/4
-  \times 2/3 {
-    c4 c c 
-  }
-  \time 3/4
-  c4 
-}
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{TupletBracket},
-@internalsref{TupletNumber} y @internalsref{TimeScaledMusic}.
-
-
-
-@node Scaling durations
-@subsection Scaling durations
-
-Es posible alterar la duración de las figuras en un factor @var{N/M}
-añadiendo @samp{*@var{N/M}} (o @samp{*@var{N}} si @var{M=1}).  Esto no
-afectará a la apariencia de las notas o silencios que se producen.  Se
-pueden combinar en la forma @samp{*M*N}.
-
-En el siguiente ejemplo las tres primeras notas duran exactamente dos
-partes, pero no se imprime ningún corchete de tresillo.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\time 2/4
-a4*2/3 gis4*2/3 a4*2/3
-a4 a4 a4*2
-b16*4 c4
-@end lilypond
-
-
-@seealso
-
-En este manual: @ref{Tuplets}.
-
-
-@node Bar check
-@subsection Bar check
-
-@cindex Compás, comprobación de
-@funindex barCheckSynchronize
-@funindex |
-
-Las comprobaciones de compás ayudan a detectar errores en las duraciones.  Una comprobación de compás se
-escribe usando el símbolo de la barra vertical, @samp{|}.  Cuando se encuentra durante 
-la interpretación, debe caer en el límite entre dos compases.  Si no es así,
-se muestra una advertencia.  En el siguiente ejemplo, la segunda comprobación
-de compás avisará de un error
-@example
-\time 3/4 c2 e4 | g2 |
-@end example
-
-Las comprobaciones de compás también se pueden usar en la letra de las canciones, por ejemplo
-
-@example
-\lyricmode @{
-  \time 2/4
-  Bri -- lla | Bri -- lla 
-@}
-@end example
-
-Las comprobaciones de compás fallidas tienen su origen en la
-introducción incorrecta de las duraciones.  Las duraciones incorrectas
-a menudo desbaratan la partitura completamente, sobre todo si la
-música es polifónica, por ello el mejor sitio para empezar a corregir
-la entrada es hacer un barrido en busca de comprobaciones de compás
-fallidas y duraciones incorrectas.
-
-@funindex |
-@funindex pipeSymbol
-
-También es posible redefinir el significado de @code{|}.  Se hace
-asignando una expresión musical a @code{pipeSymbol},
-
-@lilypond[quote,ragged-right,verbatim]
-pipeSymbol = \bar "||"
-
-{ c'2 c' | c'2 c' }
-@end lilypond
-
-
-@node Barnumber check
-@subsection Barnumber check
-
-Al copiar piezas musicales grandes puede servir de ayuda comprobar que
-el número de compás de LilyPond corresponde al original desde el que está copiando.
-Esto se puede comprobar con @code{\barNumberCheck}, por ejemplo
-
-@verbatim
-\barNumberCheck #123
-@end verbatim
-
-@noindent
-imprimirá una advertencia si el @code{currentBarNumber} (número del
-compás actual) no es 123 cuando se está procesando.
-
-
-@node Automatic note splitting
-@subsection Automatic note splitting
-
-Las notas largas se pueden convertir automáticamente en notas ligadas.
-Se hace mediante la sustitución del @internalsref{Note_heads_engraver}
-por el @internalsref{Completion_heads_engraver}.  En los siguientes
-ejemplos, las notas que atraviesan la barra de compás se dividen y se unen mediante una ligadura.
-
-@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
-\new Voice \with {
-  \remove "Note_heads_engraver"
-  \consists "Completion_heads_engraver"
-} {
-  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
-}
-@end lilypond
-
-Este grabador divide todas las notas largas en la barra de compás e
-inserta ligaduras.  Uno de sus usos es depurar partituras complejas:
-si los compases no están completos, las ligaduras mostrarán
-exactamente cuánto le falta a cada compás.
-
-Si quiere permitir el salto de línea en las barras de compás en las
-que @internalsref{Completion_heads_engraver} divide las notas, debe
-eliminar también @internalsref{Forbid_line_break_engraver}.
-
-
-@refbugs
-
-No todas las duraciones (sobre todo las que contienen grupos
-especiales) se pueden representar exactamente con notas normales y
-puntillos, pero el grabador nunca insertará grupos especiales.
-
-@code{Completion_heads_engraver} afecta sólo a las notas; no divide
-silencios.
-
-
-@seealso
-
-Referencia del programa: @internalsref{Completion_heads_engraver}.
-
-
-@node Polyphony
-@section Polyphony
-
-La polifonía en música hace referencia a tener más de una voz en una
-pieza cualquiera de música.  En LilyPond la polifonía hace referencia
-a tener más de una voz en el mismo pentagrama.
-
-@menu
-* Chords::                      
-* Stems::                       
-* Basic polyphony::             
-* Explicitly instantiating voices::  
-* Collision Resolution::        
-@end menu
-
-
-@node Chords
-@subsection Chords
-
-@cindex Acordes
-
-Un acorde se forma encerrando un conjunto de notas entre @code{<} y
-@code{>}.  Un acorde puede ir seguido de una duración o un conjunto de
-articulaciones, como si fueran simples notas.
-
-@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
-@end lilypond
-
-Para ver más información sobre los acordes, consulte @ref{Chord names}.
-
-
-@c  I don't like having this here, but I can't think of
-@c  anywhere else to put it.  :(   -gp
-@node Stems
-@subsection Stems
-
-Cuando se encuentra con una nota, se crea un objeto
-@internalsref{Stem} (plica) automáticamente.  Para las redondas y los
-silencios, también se crean pero se hacen invisibles.
-
-@refcommands
-
-@funindex \stemUp
-@code{\stemUp},
-@funindex \stemDown
-@code{\stemDown},
-@funindex \stemNeutral
-@code{\stemNeutral}.
-
-
-@commonprop
-
-Para modificar la dirección de las plicas en medio de un pentagrama, utilice
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
-
-
-@node Basic polyphony
-@subsection Basic polyphony
-
-@cindex polyphony
-
-La manera más fácil de escribir fragmentos con más de una voz sobre el mismo pentagrama
-es introducir cada voz como una secuencia (con @code{@{...@}}), y combinarlas
-simultáneamente, separando las voces con @code{\\}
-
-@funindex \\
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  c16 d e f
-  <<
-    { g4 f e | d2 e2 } \\
-    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
-    { s2. | s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-El separador hace que se produzca un nuevo contexto de @internalsref{Voice}@footnote{Las voces polifónicas
-se conocen a veces como @q{capas} en otros programas de edición de partituras.}.
-@cindex capas
-Llevan los nombres @code{"1"}, @code{"2"}, etc.  En cada
-uno de estos contextos, la dirección vertical de las ligaduras, plicas, etc., se establece
-de la manera que corresponda.
-
-Todas estas voces están separadas de la voz que contiene las notas
-justo por fuera de la construcción @code{<< \\ >>}.  Se debe tener
-esto en cuenta cuando haga algún cambio en una voz.  También
-significa que las ligaduras de unión y de expresión no pueden salir de (ni
-entrar en) una construcción @code{<< \\ >>}.  En cambio las voces
-paralelas que están en construcciones @code{<< \\ >>} separadas dentro
-del mismo pentagrama, son la misma voz.  Presentamos a continuación el
-mismo ejemplo, con cabezas y colores distintos para cada voz.  Dese cuenta de
-que el cambio en el estilo de cabezas de nota en la voz principal no
-afecta a las que están dentro de la construcción @code{<< \\ >>}.
-Asimismo, el cambio a la segunda voz en la primera construcción
-@code{<< \\ >>} es efectiva en la segunda @code{<< \\ >>}, y la voz se liga de una construcción a otra.
-
-@cindex cabezas de nota, estilos de
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  <<
-    { g4 f e } \\
-    { \override NoteHead #'style = #'triangle
-      \override NoteHead #'color = #blue
-    r8 e4 d c8 ~ }
-  >> |
-  <<
-    { d2 e2 } \\
-    { c8 b16 a b8 g ~ g2 } \\
-    { \override NoteHead #'style = #'slash 
-      \override NoteHead #'color = #green
-      s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-La polifonía no cambia la relación entre las notas que están dentro de
-un bloque @code{\relative @{ @}}.  Cada una de las notas se calcula
-relativa a la nota inmediatamente anterior.
-
-@example
-\relative @{ notaA << notaB \\ notaC >> notaD @}
-@end example
-
-@code{notaC} es relativa a @code{notaB}, no a @code{notaA};
-@code{notaD} es relativa a @code{notaC}, no a @code{notaB} ni a
-@code{notaA}.
-
-
-@node Explicitly instantiating voices
-@subsection Explicitly instantiating voices
-
-Los contextos de @internalsref{Voice} también se pueden instanciar manualmente
-dentro de un bloque @code{<< >>} para crear música polifónica, usando
-@code{\voiceOne}, hasta @code{\voiceFour} para asignar las direcciones de las plicas
-y un desplazamiento horizontal para cada parte.
-
-Concretamente:
-@example
-<< \superior \\ \inferior >>
-@end example
-
-@noindent
-equivale a
-
-@example
-<<
-  \new Voice = "1" @{ \voiceOne \superior @}
-  \new Voice = "2" @{ \voiceTwo \inferior @}
->>
-@end example
-
-Los comandos @code{\voiceXXX} establecen la dirección de las plicas, ligaduras de expresión y de unión,
-articulaciones, anotaciones de texto, puntillos y digitaciones.
-@code{\voiceOne} y @code{\voiceThree} hacen
-a los mencionados objetos apuntar hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour}
-los hacen apuntar hacia abajo.
-El comando @code{\oneVoice} hace volver a los ajustes normales.
-
-Una expresión que aparece directamente dentro de un @code{<< >>} pertenece a
-la voz principal.  Es útil cuando aparecen voces adicionales al tiempo que está cantando la voz
-principal.  A continuación podemos ver una representación mejor del ejemplo del apartado anterior.
-Las cabezas de color y en forma de cruz demuestran que
-la melodía principal ahora está en un contexto de una voz única.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2 }
-    \new Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. | s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-La definición correcta de las voces permite que la melodía se pueda marcar con ligaduras de expresión.
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Al evitar el separador @code{\\} posibilitamos la escritura de
-construcciones polifónicas anidadas, lo que en algún caso podría constituir
-una forma más natural de tipografiar la música.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ |
-      <<
-        {c8 b16 a b8 g ~ g2}
-        \new Voice { \voiceThree
-          s4 b4 c2
-          \oneVoice
-        }
-      >>
-    \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-En ciertos casos de música polifónica compleja podría ser necesario
-utilizar voces adicionales para evitar colisiones entre las notas.
-Las voces adicionales se añaden definiendo un identificador como se muestra a continuación:
-
-@lilypond[quote,verbatim,ragged-right,relative=2]
-voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
-
-\relative c''' <<
-  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
-  { \voiceThree  b4} \\
-  { \voiceFive d,} \\
-  { \voiceTwo g,}
->>
-@end lilypond
-
-
-@node Collision Resolution
-@subsection Collision Resolution
-
-Normalmente las cabezas de nota con un número de puntillos diferente
-no se mezclan en una sola, pero cuando se le da un valor verdadero a
-la propiedad @code{merge-differently-dotted} en el objeto @internalsref{NoteCollision}, se juntan en una sola:
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice << {
-  g8 g8
-  \override Staff.NoteCollision
-    #'merge-differently-dotted = ##t
-  g8 g8
-} \\ { g8.[ f16] g8.[ f16] } >>
-@end lilypond
-
-De forma similar puede mezclar cabezas de blanca con corcheas,
-ajustando @code{merge-differently-headed}:
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\new Voice << {
-  c8 c4.
-  \override Staff.NoteCollision
-    #'merge-differently-headed = ##t
-c8 c4. } \\ { c2 c2 } >>
-@end lilypond
-
-@noindent
-@code{merge-differently-headed} y @code{merge-differently-dotted}
-se aplican solamente a direcciones de plica opuestas (es decir, a las voces 1 y 2).
-
-LilyPond también desplaza verticalmente los silencios que están en el lado contrario de una plica,
-por ejemplo
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new Voice << c''4 \\ r4 >>
-@end lilypond
-
-Si tres o más notas coinciden verticalmente en la misma columna,
-@code{merge-differently-headed} no puede completar satisfactoriamente
-la mezcla de las dos notas que deberían mezclarse.
-Para hacer posible que la mezcla funcione, aplique un @code{\shift} (desplazamiento) a la nota que no
-debe mezclarse.  En el primer compás del ejemplo siguiente,
-@code{merge-differently-headed} no funciona (la cabeza de la blanca está rellena)
-En el segundo compás, se aplica @code{\shiftOn} para mover horizontalmente el
-@code{g} (Sol) superior, y @code{merge-differently-headed}
-funciona correctamente.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-<<
-  { d=''2 g2 } \\
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-<<
-  { d'=''2 \shiftOn g2 } \\ 
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-@end lilypond
-
-
-@refcommands
-
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
-
-@funindex \shiftOn
-@code{\shiftOn},
-@funindex \shiftOnn
-@code{\shiftOnn},
-@funindex \shiftOnnn
-@code{\shiftOnnn},
-@funindex \shiftOff
-@code{\shiftOff}: estos comandos especifican el grado en que
-se deben desplazar los acordes de la voz en curso.
-Las voces exteriores (normalmente: la voz uno y la voz dos)
-tienen @code{\shiftOff} (desplazamiento desactivado), mientras que las voces interiores (tres y cuatro)
-tienen @code{\shiftOn} (desplazamiento activado).  @code{\shiftOnn} y @code{\shiftOnnn} definen niveles de desplazamiento
-más grandes.
-
-Cuando LilyPond no puede con todo, se pueden usar la propiedad
-@code{force-hshift} (forzar desplazamiento) del objeto @internalsref{NoteColumn}
-y los silencios con altura para sobreescribir las decisiones de tipografía.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative <<
-{
-  <d g>
-  <d g>
-} \\ {
-  <b f'>
-  \once \override NoteColumn #'force-hshift = #1.7
-  <b f'>
-} >>
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: los objetos responsables de resolver las colisiones son
-@internalsref{NoteCollision} y @internalsref{RestCollision}.
-
-
-@refbugs
-
-Cuando se emplea @code{merge-differently-headed} con una corchea (o una nota más corta)
-con la plica hacia arriba, y una blanca con la plica hacia abajo,
-la corchea no tiene el desplazamiento correcto.
-
-No están contemplados los racimos (clusters) donde la misma nota se presenta
-con diferentes alteraciones accidentales dentro del mismo acorde.  En
-este caso se recomienda usar la transcripción enarmónica, o usar la
-notación especial de racimos (ver @ref{Clusters}).
-
-
-
-@node Staff notation
-@section Staff notation
-
-@cindex Notación de los pentagramas
-
-Esta sección describe la notación musical que se produce en el nivel del pentagrama,
-como las armaduras de tonalidad, claves e indicaciones de compás.
-
-@menu
-* Clef::                        
-* Key signature::               
-* Time signature::              
-* Partial measures::            
-* Bar lines::                   
-* Unmetered music::             
-* System start delimiters::     
-* Staff symbol::                
-* Writing music in parallel::   
-@end menu
-
-
-@node Clef
-@subsection Clef
-
-@funindex \clef
-
-La clave indica qué líneas del pentagrama corresponden a qué
-notas.  La clave se establece con el comando @code{\clef} 
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
-@end lilypond
-
-@cindex clave de Sol
-@cindex clave de violín
-@cindex clave de Do en tercera (clave de viola)
-@cindex clave de Do en cuarta (clave de tenor)
-@cindex clave de Fa en cuarta (clave de bajo)
-@cindex clave de Sol en primera (clave de violín francesa)
-@cindex clave de Do en primera (clave de soprano)
-@cindex clave de Do en segunda (clave de mezzosoprano)
-@cindex clave de Do en quinta (clave de barítono)
-@cindex clave de Fa en tercera (clave de varbarítono)
-@cindex clave de Fa en quinta (clave de sub-bajo)
-
-Las claves contempladas son
-
-@multitable @columnfractions .33 .66
-@headitem Clave @tab Posición
-@item @code{treble}, violin, G, G2 @tab
-clave de Sol en 2ª
-@item @code{alto, C} @tab
-clave de Do en 3ª
-@item @code{tenor} @tab
-clave de Do en 4ª
-@item @code{bass, F} @tab
-clave de Fa en 4ª
-@item @code{french} @tab
-clave de Sol en 1ª, conocida también como clave de violín francesa
-@item @code{soprano} @tab
-clave de Do en 1ª
-@item @code{mezzosoprano} @tab
-clave de Do en 2ª
-@item @code{baritone} @tab
-clave de Do en 5ª
-@item @code{varbaritone} @tab
-clave de Fa en 3ª
-@item @code{subbass} @tab
-clave de Fa en 5ª
-@item @code{percussion} @tab
-clave de percusión
-@item @code{tab} @tab
-clave de tablatura
-@end multitable
-
-Al añadir @code{_8} o @code{^8} al nombre de la clave, la clave se transpone
-una octava hacia abajo o hacia arriba, respectivamente, y @code{_15} y
-@code{^15} la transpone dos octavas.  El argumento @var{nombre_de_clave}
-se debe encerrar entre comillas cuando contiene guiones bajos o dígitos.  Por
-ejemplo:
-
-@cindex clave de tenor coral
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\clef "G_8" c4
-@end lilypond
-
-
-@commonprop
-
-El comando @code{\clef "treble_8"} equivale a establecer
-@code{clefGlyph},
-@code{clefPosition} (que controla la posición Y de la clave),
-@code{middleCPosition} y @code{clefOctavation}.  Se imprime una clave
-cuando se cambia cualquiera de estas propiedades.  El siguiente ejemplo muestra
-las posibilidades que se ofrecen estableciendo manualmente las propiedades.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
-@end lilypond
-
-
-@seealso
-
-En el presente manual: @ref{Grace notes}.
-
-Referencia del programa: @internalsref{Clef}.
-
-
-@node Key signature
-@subsection Key signature
-
-@cindex Armadura de la tonalidad
-@funindex \key
-
-La armadura indica la tonalidad en que se toca una pieza.  Está
-denotada por un conjunto de alteraciones (bemoles o sostenidos) al comienzo del
-pentagrama.
-
-El establecimiento o modificación de la armadura se hace con el
-comando @code{\key}
-
-@example
-@code{\key} @var{nota} @var{tipo}
-@end example
-
-@funindex \minor
-@funindex \major
-@funindex \minor
-@funindex \ionian
-@funindex \locrian
-@funindex \aeolian
-@funindex \mixolydian
-@funindex \lydian
-@funindex \phrygian
-@funindex \dorian
-@cindex modos eclesiásticos
-
-Aquí, @var{tipo} debe ser @code{\major} o @code{\minor} para obtener
-la tonalidad @var{nota}-mayor o @var{nota}-menor, respectivamente.  También puede
-usar los nombres estándar de modo (también conocidos como @q{modos eclesiásticos}): @code{\ionian} (jónico),
-@code{\locrian} (locrio), @code{\aeolian} (eolio), @code{\mixolydian} (mixolidio), @code{\lydian} (lidio),
-@code{\phrygian} (frigio) y @code{\dorian} (dórico).
-
-Este comando establece la propiedad de contexto
-@code{Staff.keySignature}.  Se pueden especificar armaduras no estándar
-estableciendo esta propiedad directamente.
-
-Las alteraciones accidentales y las armaduras son una frecuente causa de confusión para los nuevos usuarios,
-porque las notas sin alteración pueden llevar signos de becuadro en función de la armadura.
-Para ver más información, consulte @ref{Accidentals} o @ref{Accidentals and key signatures}.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\key g \major
-f1
-fis
-@end lilypond
-
-
-@commonprop
-
-Se imprime un símbolo de becuadro para cancelar las alteraciones anteriores.  Se puede
-suprimir esto estableciendo la propiedad
-@code{Staff.printKeyCancellation}.
-
-@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-\set Staff.printKeyCancellation = ##f
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{KeyCancellation},
-@internalsref{KeySignature}.
-
-
-@node Time signature
-@subsection Time signature
-
-@cindex Indicación de compás
-@cindex metro, medida
-@funindex \time
-
-La indicación de compás indica el metro de la pieza: su patrón regular de
-partes fuertes y débiles.  Se denota por una fracción al comienzo del
-pentagrama.
-
-La indicación de compás se establece mediante el comando @code{\time}
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 2/4 c'2 \time 3/4 c'2.
-@end lilypond
-
-@commonprop
-
-Se puede personalizar el símbolo que se imprime mediante la propiedad @code{style}.
-Un valor de @code{#'()} produce un estilo de fracción para los compases de 4/4 y
-de 2/2,
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-\time 4/4 c'1
-\time 2/2 c'1
-\override Staff.TimeSignature #'style = #'()
-\time 4/4 c'1
-\time 2/2 c'1
-@end lilypond
-
-Existen otras muchas opciones para su presentación.  Para ver más ejemplos, consulte @ref{Ancient time
-signatures}.
-
-@code{\time} establece las propiedades @code{timeSignatureFraction},
-@code{beatLength} y @code{measureLength} en el contexto @code{Timing},
-cuyo nombre alternativo normalmente es @internalsref{Score}.  La
-propiedad @code{measureLength} determina el lugar en que se deben insertar las barras de compás
-y cómo se generan las barras de corchea automáticas.  La modificación del valor de
-@code{timeSignatureFraction} también provoca que se imprima
-el símbolo.
-
-Están disponibles más opciones a través de la función de Scheme
-@code{set-time-signature}.  En combinación con el grabador
-@internalsref{Measure_grouping_engraver} (agrupación de compases), creará signos de
-@internalsref{MeasureGrouping}.  Estos signos facilitan la lectura de música moderna
-rítmicamente compleja.  En el siguiente ejemplo el compás de 9/8
-se subdivide en 2, 2, 2 y 3.  Esto se pasa a
-@code{set-time-signature} como un tercer argumento con el valor @code{(2 2 2 3)}
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    #(set-time-signature 9 8 '(2 2 2 3))
-    g8[ g] d[ d] g[ g] a8[( bes g]) |
-    #(set-time-signature 5 8 '(3 2))
-    a4. g4
-  }
-  \layout {
-    \context {
-      \Staff
-      \consists "Measure_grouping_engraver"
-    }
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{TimeSignature} y
-@internalsref{Timing_translator}.
-
-Ejemplos: @lsr{contemporary,compound-time-signature.ly}.
-
-
-@refbugs
-
-EL barrado automático no utiliza la agrupación de compases especificada con
-@code{set-time-signature}.
-
-
-@node Partial measures
-@subsection Partial measures
-
-@cindex anacrusa
-@cindex parte al alzar
-@cindex compás parcial
-@cindex parcial, compás
-@cindex acortar compases
-@funindex \partial
-
-Los compases parciales como las anacrusas o partes al alzar se escriben usando la construcción
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\partial 16*5 c16 cis d dis e | a2. c,4 | b2
-@end lilypond
-
-La sintaxis de este comando es la siguiente:
-
-@example
-\partial @var{duración}
-@end example
-
-donde @code{duración} es el valor rítmico que se se debe añadir antes
-del siguiente compás.
-
-Esto se traduce internamente a
-
-@example
-\set Timing.measurePosition = -@var{longitud de la duración}
-@end example
-
-La propiedad @code{measurePosition} contiene un número racional
-que indica qué parte del compás ha transcurrido hasta el momento.
-Observe que es un número negativo; @code{\partial 4} se traduce internamente
-con el significado de @qq{queda un valor de negra en este compás}.
-
-
-@refbugs
-
-Este comando no tiene en cuenta las notas de adorno al comienzo
-de la música.  Cuando una pieza comienza con notas de adorno en la anacrusa,
-el @code{\partial} debe escribirse después de las notas de adorno
-
-@lilypond[verbatim,quote,ragged-right,relative,fragment]
-\grace f16
-\partial 4
-g4
-a2 g2
-@end lilypond
-
-El uso de @code{\partial} está previsto solamente para el comienzo de una
-pieza.  Si se emplea después del comienzo se obtendrán varias advertencias
-desagradables.
-
-
-@node Bar lines
-@subsection Bar lines
-
-@cindex Barras de compás
-@funindex \bar
-@cindex líneas divisorias
-@cindex repetición, barras de
-
-Las líneas divisorias delimitan a los compases pero también se pueden usar
-para indicar las repeticiones.  Normalmente se insertan de manera automática.
-Los saltos de línea solamente pueden producirse sobre las barras de compás.
-
-Se pueden forzar tipos especiales de línea divisoria con 
-el comando @code{\bar}
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-c4 \bar "|:" c4
-@end lilypond
-
-Se encuentran disponibles los siguientes tipos de barra:
-
-@lilypondfile[ragged-right,quote]{bar-lines.ly}
-
-Además se puede especificar @code{"||:"}, que equivale a
-@code{"|:"} excepto en los saltos de línea, en que produce una doble barra
-al final de la línea y una repetición izquierda (de comienzo) al principio de
-la línea siguiente.
-
-Para permitir un salto de línea donde no hay ninguna línea divisoria visible,
-utilice
-
-@example
-\bar ""
-@end example
-
-@noindent
-De esta manera se insertará una barra invisible de compás y se hará posible
-el salto de línea en este punto (sin incrementar el contador de los números de compás).
-
-En las partituras con muchos pentagramas, un comando @code{\bar} en uno de ellos se aplica
-automáticamente a todos los demás.  Las líneas resultantes se conectan entre los distintos pentagramas
-de un @code{StaffGroup}, @code{PianoStaff} o @code{GrandStaff}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-<<
-  \new StaffGroup <<
-    \new Staff {
-      e'4 d'
-      \bar "||"
-      f' e'
-    }
-    \new Staff { \clef bass c4 g e g }
-  >>
-  \new Staff { \clef bass c2 c2 }
->>
-@end lilypond
-
-
-@commonprop
-
-@funindex whichBar
-@funindex repeatCommands
-@funindex defaultBarType
-
-El comando @code{\bar }@var{tipo_de_barra} es una forma corta de hacer
-@code{\set Timing.whichBar = }@var{tipo_de_barra}.  Cuando @code{whichBar}
-se establece con el valor de una cadena, se crea una línea divisoria de ese tipo.
-
-Una línea divisoria se crea cuando se establece la propiedad @code{whichBar}.
-Al comienzo del compás su valor se toma de
-@code{Timing.defaultBarType}.  Los contenidos de los @code{repeatCommands} se
-utilizan para sobreescribir a las barras de compás por omisión.
-
-Le recomendamos que utilice siempre @code{\repeat} para hacer repeticiones.
-Consulte @ref{Repeats}.
-
-
-@seealso
-
-En este manual: @ref{Repeats}, @ref{System start delimiters}.
-
-Referencia del programa: @internalsref{BarLine} (creada al nivel de
-@internalsref{Staff} (pentagrama)), @internalsref{SpanBar} (a través de los pentagramas).
-
-
-@node Unmetered music
-@subsection Unmetered music
-
-@cindex cadencia
-@funindex \cadenzaOn
-@funindex \cadenzaOff
-
-Las líneas divisorias y los números de compás se calculan automáticamente.
-Para música sin compasear (por ejemplo cadencias), esto no es deseable.
-Para desactivar las barras y los números de compás automáticos, utilice los comandos
-@code{\cadenzaOn} y @code{\cadenzaOff}.
-
-@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
-c4 d e d
-\cadenzaOn
-c4 c d8 d d f4 g4.
-\cadenzaOff
-\bar "|"
-d4 e d c
-@end lilypond
-
-
-@refbugs
-
-LilyPond insertará saltos de línea y de página solamente en las barras de compás.
-A menos que la música sin compasear acabe antes del final de la línea del pentagrama,
-tendrá que insertar barras
-de compás invisibles
-
-@example
-\bar ""
-@end example
-
-@noindent
-para indicar dónde se pueden producir los saltos.
-
-
-@node System start delimiters
-@subsection System start delimiters
-
-@cindex comienzo del sistema
-@cindex Pentagramas, varios
-@cindex corchete vertical
-@cindex llave vertical
-@cindex pentagramas de piano
-@cindex pentagramas, grupo de
-@cindex pauta de coro
-
-Muchas partituras constan de más de un pentagrama.  Estos pentagramas se pueden
-unir de cuatro formas distintas:
-
-@itemize @bullet
-@item El grupo comienza con una llave a la izquierda y las líneas de compás
-están conectadas.  Esto se hace con el contexto @internalsref{GrandStaff}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new GrandStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item El grupo comienza con un corchete recto y las líneas de compás están conectadas.
-Esto se hace con el contexto
-@internalsref{StaffGroup}
-
-@lilypond[verbatim,ragged-right,quote]
-\new StaffGroup
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item El grupo comienza con un corchete recto pero las líneas de compás no están conectadas.
-Esto se hace con el contexto @internalsref{ChoirStaff}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new ChoirStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item El grupo comienza con una línea vertical.  Las líneas de compás
-no están conectadas.  Ésta es la opción por defecto para la partitura.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-@end itemize
-
-
-@seealso
-
-Las barras de compás al principio de cada sistema son
-@internalsref{SystemStartBar}, @internalsref{SystemStartBrace} y
-@internalsref{SystemStartBracket}.  En cada contexto solamente se
-crea uno de estos tipos, y ese tipo está determinado por la propiedad
-@code{systemStartDelimiter}.
-
-
-@commonprop
-
-Los delimitadores del comienzo del sistema se pueden anidar muchas veces:
-
-@lilypond[quote,ragged-right,verbatim]
-\new StaffGroup
-\relative <<
-  \set StaffGroup.systemStartDelimiterHierarchy
-    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
->>
-@end lilypond
-
-
-@node Staff symbol
-@subsection Staff symbol
-
-@cindex ajuste del símbolo del pentagrama
-
-Las notas, signos dinámicos, etc. están agrupados con un conjunto de líneas horizontales
-que reciben el nombre de pentagrama o pauta (@q{staff}, en plural @q{staves}).  En
-LilyPond, estas líneas se dibujan utilizando un objeto de presentación separado
-que se llama el @code{staff symbol} (el símbolo del pentagrama).
-
-El símbolo del pentagrama se puede ajustar en el número, grosor
-y separación de las líneas, usando las propiedades.  Esto se demuestra en los archivos de ejemplo
-@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} y
-@lsr{staff,changing-the-staff-size.ly}.
-
-Además, los pentagramas se pueden iniciar e interrumpir libremente.  Esto se
-hace con @code{\startStaff} y @code{\stopStaff}.
-
-@lilypond[verbatim,relative=2,fragment]
-b4 b
-\override Staff.StaffSymbol #'line-count = 2
-\stopStaff \startStaff
-b b
-\revert Staff.StaffSymbol #'line-count
-\stopStaff \startStaff
-b b
-@end lilypond
-
-En combinación con los pentagramas ocultos o franceses,
-esto se puede usar para componer tipográficamente secciones de ossia.  He aquí un ejemplo:
-
-@cindex ossia
-
-@lilypondfile{ossia.ly}
-
-@cindex pentagrama, establecer el número de líneas del
-@cindex pentagrama, establecer el grosor de las líneas del
-@cindex grosor de las líneas del pentagrama, establecer
-@cindex número de líneas del pentagrama, establecer
-
-@seealso
-
-Referencia del programa: @internalsref{StaffSymbol}.
-
-Ejemplos: @lsrdir{staff}
-
-
-@node Writing music in parallel
-@subsection Writing music in parallel
-
-@cindex Escribir música en paralelo
-@cindex Música intercalada
-
-La música para varias partes se puede intercalar
-
-@lilypond[quote,fragment,verbatim]
-\parallelMusic #'(voiceA voiceB) {
-  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
-  c'2                                c'2                                |
-  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
-  c'2                                c'2                                |
-}
-\new StaffGroup <<
-  \new Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
->>
-@end lilypond
-
-Esto funciona bastante bien para música de piano
-
-@lilypond[quote,verbatim]
-music = {
-  \key c \major
-  \time 4/4
-  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
-    % Bar 1
-    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
-e''] |
-    c'2                                 c'2 |
-    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
-    c2                                  c2 |
-
-    % Bar 2
-    a'8 b'      c'' d''    e'' f''    g'' a'' |
-    d'4         d'         d'         d' |
-    c16 d e f   d e f g    e f g a    f g a b |
-    a,4         a,4        a,4        a,4 |
-
-    % Bar 3 ...
-  }
-}
-
-\score {
-  \new PianoStaff <<
-    \music
-    \new Staff <<
-      \voiceA \\
-      \voiceB
-    >>
-    \new Staff {
-      \clef bass
-      <<
-        \voiceC \\
-        \voiceD
-      >>
-    }
-  >>
-}
-@end lilypond
-
-
-@node Connecting notes
-@section Connecting notes
-
-Esta sección trata de la notación que afecta a grupos de notas.
-
-@menu
-* Ties::                        
-* Slurs::                       
-* Phrasing slurs::              
-* Laissez vibrer ties::         
-* Automatic beams::             
-* Manual beams::                
-* Grace notes::                 
-@end menu
-
-
-@node Ties
-@subsection Ties
-
-@cindex ligadura de unión
-@funindex ~
-
-Una ligadura de unión conecta dos notas adyacentes de la misma altura.  La ligadura
-en efecto extiende la longitud de una nota.  No deben confundirse las ligaduras de unión con
-las ligaduras de expresión, que indican articulación, ni con las ligaduras de fraseo, que indican
-el fraseo musical.  Se introduce una ligadura de unión usando el símbolo de la tilde curva @samp{~}
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-e' ~ e' <c' e' g'> ~ <c' e' g'>
-@end lilypond
-
-Cuando se aplica una ligadura de unión a un acorde, se conectan todas las cabezas de las notas cuyas alturas coinciden.
-Si no coincide ningún par de cabezas, no se crea ninguna ligadura.  Los acordes
-se pueden ligar parcialmente colocando la ligadura dentro del acorde,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-<c~ e g~ b> <c e g b>
-@end lilypond
-
-Una ligadura es simplemente una forma de extender la duración de una nota, parecida al
-puntillo.  El ejemplo siguiente muestra dos formas de escribir
-exactamente el mismo concepto:
-
-@lilypond[quote,fragment,ragged-right]
-\time 3/4 c'2. c'2 ~ c'4
-@end lilypond
-
-@noindent
-Se usan ligaduras de expresión bien cuando la nota atraviesa la barra
-de compás o bien cuando no se pueden usar puntillos para denotar el
-ritmo.  Cuando se usan ligaduras, las notas de mayor duración se deben alinear con las subdivisiones del compás, como
-
-@lilypond[fragment,quote,ragged-right]
-\relative {
-  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
-}
-@end lilypond
-
-Si necesita unir muchas notas a través de las líneas divisorias, puede
-resultar más fácil utilizar la división automática de notas (vea
-@ref{Automatic note splitting}).  Este mecanismo divide las notas
-largas de forma automática y las liga a través de las barras de compás.
-
-@funindex \repeatTie
-
-Cuando la segunda vez de una repetición comienza con una nota ligada,
-es necesario repetir la ligadura.  Esto se puede conseguir mediante @code{\repeatTie},
-
-@lilypond[fragment,quote,ragged-right,relative=2]
-r <c e g>\repeatTie
-@end lilypond
-
-@cindex ligaduras de repetición
-@cindex corchetes de repetición de primera y segunda vez y ligaduras
-
-@commonprop
-
-A veces se usan ligaduras para escribir arpegios.  En este caso, dos notas ligadas no
-necesitan ser consecutivas.  Esto se puede conseguir estableciendo la propiedad @code{tieWaitForNote}
-(ligadura - esperar nota) al valor verdadero. La misma funcionalidad puede resultar útil,
-por ejemplo, para ligar un trémolo a un acorde.  Por ejemplo,
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-\set tieWaitForNote = ##t
-\grace { c16[~ e~ g]~ } <c, e g>2
-\repeat tremolo 8 { c32~ c'~ } <c c,>1
-e8~ c~ a~ f~ <e' c a f>2
-@end lilypond
-
-Las ligaduras de pueden grabar manualmente modificando la propiedad
-@code{tie-configuration}.  El primer número indica la distancia desde
-el centro del pentagrama en espacios de pentagrama, y el segundo
-número indica la dirección (1 = hacia arriba, -1 = hacia abajo).
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-<c e g>2~ <c e g> |
-\override TieColumn #'tie-configuration =
-  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
-<c e g>~ <c e g> |
-@end lilypond
-
-
-@refcommands
-
-
-@funindex \tieUp
-@code{\tieUp},
-@funindex \tieDown
-@code{\tieDown},
-@funindex \tieNeutral
-@code{\tieNeutral},
-@funindex \tieDotted
-@code{\tieDotted},
-@funindex \tieDashed
-@code{\tieDashed},
-@funindex \tieSolid
-@code{\tieSolid}.
-
-
-@seealso
-
-En el presente manual: @ref{Automatic note splitting}.
-
-Referencia del programa: @internalsref{Tie}.
-
-
-@refbugs
-
-Un cambio de pentagrama cuando hay una ligadura activa no producirá una ligadura inclinada.
-
-Los cambios de clave o de octava durante una ligadura de unión no
-están bien definidos realmente.  En estos casos puede ser preferible una ligadura de expresión.
-
-
-@node Slurs
-@subsection Slurs
-
-@cindex Ligaduras de expresión
-
-Una ligadura de expresión indica que las notas se deben tocar unidas o
-@emph{legato}.  Se escriben utilizando paréntesis
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-f( g a) a8 b( a4 g2 f4)
-<c e>2( <b d>2)
-@end lilypond
-
-La dirección de una ligadura de expresión se puede especificar con
-@code{\slur@emph{DIRECCIÓN}}, donde @code{@emph{DIRECCIÓN}} es o bien
-@code{Up} (arriba), @code{Down} (abajo), o @code{Neutral}
-(seleccionada automáticamente).
-
-Sin embargo, hay una forma abreviada muy conveniente para forzar las
-direcciones de las ligaduras de expresión.  Escribiendo @code{_} o
-@code{^} antes de los paréntesis de apertura, también se establece la dirección.  Por ejemplo,
-
-@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
-c4_( c) c^( c)
-@end lilypond
-
-Se puede imprimir una sola ligadura cada vez.  Si necesita imprimir
-una ligadura larga por encima de varias ligaduras más cortas, consulte @ref{Phrasing slurs}.
-
-
-@commonprop
-
-Algunos compositores escriben dos ligaduras cuando quieren acordes
-legato.  Esto se consigue en LilyPond mediante el establecimiento de @code{doubleSlurs},
-
-@lilypond[verbatim,ragged-right,relative,fragment,quote]
-\set doubleSlurs = ##t
-<c e>4 ( <d f> <c e> <d f> )
-@end lilypond
-
-
-@refcommands
-
-@funindex \slurUp
-@code{\slurUp},
-@funindex \slurDown
-@code{\slurDown},
-@funindex \slurNeutral
-@code{\slurNeutral},
-@funindex \slurDashed
-@code{\slurDashed},
-@funindex \slurDotted
-@code{\slurDotted},
-@funindex \slurSolid
-@code{\slurSolid}.
-
-@seealso
-
-Referencia del programa: @seeinternals{Slur}.
-
-
-@node Phrasing slurs
-@subsection Phrasing slurs
-
-@cindex ligaduras de fraseo
-@cindex marcas de fraseo
-
-Una ligadura de fraseo (o marca de fraseo) conecta las notas y se
-utiliza para indicar una frase musical.  Se escribe usando @code{\(} y
-@code{\)} respectivamente
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-\time 6/4 c'\( d( e) f( e) d\)
-@end lilypond
-
-Tipográficamente, la ligadura de fraseo se comporta casi exactamente
-igual que una ligadura de expresión normal.  Sin embargo, se tratan
-como objetos diferentes.  Una @code{\slurUp} no tendrá ningún efecto sobre una ligadura de fraseo; utilice en su lugar
-@code{\phrasingSlurUp}, @code{\phrasingSlurDown}, y
-@code{\phrasingSlurNeutral}.
-
-No se pueden tener varias ligaduras de fraseo simultáneas.
-
-
-@refcommands
-
-@funindex \phrasingSlurUp
-@code{\phrasingSlurUp},
-@funindex \phrasingSlurDown
-@code{\phrasingSlurDown},
-@funindex \phrasingSlurNeutral
-@code{\phrasingSlurNeutral}.
-
-
-@seealso
-
-Referencia del programa: @internalsref{PhrasingSlur}.
-
-
-@node Laissez vibrer ties
-@subsection Laissez vibrer ties
-@cindex Laissez vibrer
-@cindex Ligaduras laissez vibrer
-
-Las ligaduras L.v. (laissez vibrer, dejar vibrar) indican que las
-notas no se deben apagar al final.  Se usan en la notación para piano,
-arpa y otros instrumentos de cuerda y percusión.  Se pueden introducir escribiendo @code{\laissezVibrer},
-
-@lilypond[fragment,ragged-right,verbatim,relative=1]
-<c f g>\laissezVibrer
-@end lilypond
-
-@seealso
-
-Referencia del programa:
-@internalsref{LaissezVibrerTie}
-@internalsref{LaissezVibrerTieColumn}
-
-Archivos de ejemplo:
-@lsr{connecting,laissez-vibrer-ties.ly}
-
-
-@node Automatic beams
-@subsection Automatic beams
-
-LilyPond inserta las barras de corchea automáticamente
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
-@end lilypond
-
-Cuando estas decisiones automáticas no son lo bastante buenas, se
-pueden escribir los barrados de forma explícita.  También es posible
-definir patrones de barrado que difieran de los ajustes por defecto.
-Para ver más detalles, consulte @ref{Setting automatic beam behavior}.
-
-Las notas individuales se pueden marcar con @code{\noBeam} para evitar
-que lleven una barra
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c\noBeam c c
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{Beam}.
-
-
-@node Manual beams
-@subsection Manual beams
-
-@cindex barras manuales
-@funindex ]
-@funindex [
-
-En ciertos casos puede ser preciso sobreescribir el algoritmo de
-barrado automático.  Por ejemplo, el barrador automático no escribe
-barras por encima de los silencios o las líneas divisorias.  Tales
-barras se especifican manualmente marcando los puntos de comienzo y final con @code{[} y @code{]}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-  r4 r8[ g' a r8] r8 g[ | a] r8
-}
-@end lilypond
-
-
-@commonprop
-
-@funindex stemLeftBeamCount
-@funindex stemRightBeamCount
-
-
-LilyPond es capaz de determinar automáticamente los patrones de barrado dentro de una barra,
-pero a veces este comportamiento automático puede producir resultados extraños;
-por ello, se pueden usar las propiedades @code{stemLeftBeamCount} y @code{stemRightBeamCount}
-para sobreescribir los valores por defecto.  Si
-se establece con un valor una cualquiera de estas propiedades, dicho valor se utilizará una sola vez, y después
-se borrará.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-   f8[ r16
-      f g a]
-   f8[ r16
-   \set stemLeftBeamCount = #1
-      f g a]
-}
-@end lilypond
-
-Se puede establecer la propiedad @code{subdivideBeams} para subdividir
-todas las barras de semicorchea y de valores inferiores en las
-posiciones de las fracciones o partes, tal y como está definido por parte de la propiedad @code{beatLength}.
-
-@lilypond[fragment,quote,relative=2,verbatim]
-c16[ c c c c c c c]
-\set subdivideBeams = ##t
-c16[ c c c c c c c]
-\set Score.beatLength = #(ly:make-moment 1 8)
-c16[ c c c c c c c]
-@end lilypond
-@funindex subdivideBeams
-
-@noindent
-Para ver más información sobre @code{make-moment}, consulte
-@ref{Time administration}.
-
-Los saltos de línea normalmente están prohibidos cuando las barras
-cruzan las líneas divisorias.  Este comportamiento se puede modificar estableciendo @code{breakable}.
-
-@funindex breakable
-
-@cindex barras de corchea y saltos de línea
-@cindex barras en ángulo
-@cindex ángulo, barras en
-@cindex auto-knee-gap
-
-Se insertan automáticamente barras de corchea en ángulo cuando se
-detecta un desnivel muy grande entre las cabezas de las notas. 
-Este comportamiento se puede ajustar a través del objeto @code{auto-knee-gap}.
-
-
-@refbugs
-
-Las barras que cruzan pentagramas y reciben un ángulo automático no se
-pueden usar conjuntamente con los pentagramas ocultos.  Consulte @ref{Hiding staves}.
-
-@c Is this still true with skyline spacing stuff? -J.Mandereau
-Las barras de corchea no evitan las colisiones con los símbolos que
-rodean las notas, como los textos y las alteraciones.
-
-
-@node Grace notes
-@subsection Grace notes
-
-@funindex \grace
-@cindex ornamentos
-@cindex mordentes
-@cindex appoggiatura
-@cindex acciaccatura
-
-Los mordentes y notas de adorno son ornamentos escritos.  El más común es la
-acciaccatura o mordente de una nota, que se debe tocar muy corta.  Se
-denota mediante una corchea pequeña, ligada, con un corchete tachado o
-atravesado por una barrita.  La appoggiatura es una nota de adorno que
-toma una fracción fija de la nota principal, y se denota como una nota
-pequeña, ligada, sin tachar.  Ambas se introducen con los comandos
-@code{\acciaccatura} y @code{\appoggiatura}, como se muestra en el ejemplo siguiente
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-b4 \acciaccatura d8 c4 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
-@end lilypond
-
-Ambas son formas especiales del comando @code{\grace}.  Al anteponer
-esta palabra a una expresión musical se crea una nueva expresión, que
-se imprime en un tipo más pequeño y no ocupa ningún tiempo lógico en el compás.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2 c4
-@end lilypond
-
-@noindent
-Al contrario que @code{\acciaccatura} y @code{\appoggiatura}, el comando
-@code{\grace} no inicia una ligadura.
-
-@cindex timing, internal
-
-Internamente, la cuenta del tiempo para las notas de adorno se hace
-utilizando un segundo contador, el contador @q{de adorno}.  Cada
-instante en el tiempo comprende dos números racionales: uno denota el tiempo
-lógico, y el otro denota el tiempo de adorno.  El ejemplo anterior se muestra a continuación con vectores de tiempo
-
-@lilypond[quote,ragged-right]
-<<
-  \relative c''{
-    c4 \grace c16 c4 \grace {
-    c16[ d16] } c2 c4
-  }
-  \new Lyrics \lyricmode {
-    \override LyricText #'font-family = #'typewriter
-
-    \markup { (0,0) } 4
-    \grace { \markup {
-      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
-    \markup { (\fraction 1 4 , 0 ) } 4
-    \grace {
-      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
-      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
-    }
-    \markup { ( \fraction 2 4 , 0 ) }
-  }
->>
-@end lilypond
-
-La colocación de las notas de adorno se sincroniza entre los distintos
-pentagramas.  En el siguiente ejemplo, hay dos semicorcheas de adorno
-por cada corchea de adorno
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \grace { c16[ d e f] } e4 }
-   \new Staff { c4 \grace { g8[ b] } c4 } >>
-@end lilypond
-
-@funindex \afterGrace
-
-Si quiere acabar una nota con un adorno, use el comando
-@code{\afterGrace}.  Toma dos argumentos: la nota principal y las
-notas de adorno que siguen a la nota principal.
-
-@lilypond[ragged-right, verbatim,relative=2,fragment]
-c1 \afterGrace d1 { c16[ d] } c4
-@end lilypond
-
-Esto pondrá las notas de adorno después de un @q{espacio} que dura 3/4
-de la longitud de la nota principal.  La fracción 3/4 se puede cambiar
-estableciendo @code{afterGraceFraction}, por ejemplo
-
-@example
-#(define afterGraceFraction (cons 7 8))
-@end example
-
-@noindent
-pondrá la nota de adorno a 7/8 de la nota principal.
-
-Se puede conseguir el mismo efecto de forma manual haciendo
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  << { d1^\trill_( }
-     { s2 \grace { c16[ d] } } >>
-  c4)
-}
-@end lilypond
-
-@noindent
-Ajustando la duración de la nota de desplazamiento (aquí es una
-blanca), se ajusta el espacio entre la nota principal y la de adorno.
-
-Una expresión musical @code{\grace} introduce ajustes de tipografía especiales,
-por ejemplo para producir un tipo más pequeño y para fijar las
-direcciones.  Por ello, cuando se introducen trucos para la
-presentación, deben ir dentro de la expresión de adorno, por ejemplo:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  \acciaccatura {
-    \stemDown
-    f16->
-    \stemNeutral
-  }
-  g4
-}
-@end lilypond
-
-@noindent
-Las sobreescrituras (overrides) también se deben deshacer dentro de la expresión de adorno.
-
-La disposición de las expresiones de adorno se pueden cambiar a lo largo
-de la música usando la función @code{add-grace-property}.  El
-siguiente ejemplo suprime la definición de la dirección de la
-@code{Stem} (plica) para este adorno, y así las plicas no siempre apuntan hacia arriba.
-
-@example
-\new Staff @{
-  #(add-grace-property 'Voice 'Stem 'direction '())
-  @dots{}
-@}
-@end example
-
-@noindent
-Otra opción es modificar las variables @code{startGraceMusic},
-@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
-@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic} y
-@code{stopAppoggiaturaMusic}.  Hay más información en el archivo
-@file{ly/@/grace@/-init@/.ly}.
-
-@noindent
-La barrita que cruza el corchete de las acciaccaturas se puede obtener
-en otras situaciones mediante @code{\override Stem  #'stroke-style = #"grace"}.
-
-
-@commonprop
-
-Se puede forzar que las notas de adorno utilicen espaciado flotante,
-
-@lilypond[relative=2,ragged-right]
-<<
-  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
-  \new Staff {
-     c'4
-     \afterGrace
-     c'4
-     { c'16[ c'8 c'16] }
-     c'4
-  }  
-  \new Staff {
-     c'16[ c'16 c'16 c'16]
-     c'16[ c'16 c'16 c'16]
-     c'4
-  }
->>
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{GraceMusic}.
-
-
-@refbugs
-
-Una partitura que comienza con una expresión @code{\grace} requiere una declaración explícita
-@code{\new Voice} pues en caso contrario la nota principal y la de adorno
-acabarán en pentagramas distintos.
-
-La sincronización de las notas de adorno también puede acarrear sorpresas.  La notación de pentagramas,
-como armaduras, líneas divisorias, etc., se sincronizan también.  Ponga cuidado
-cuando mezcle pentagramas con adornos y sin adornos, por ejemplo
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" d4 } >>
-@end lilypond
-
-@noindent
-Esto se puede remediar insertando desplazamientos de adorno de las
-duraciones correspondientes en los otros pentagramas.  Para el ejemplo anterior
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
-@end lilypond
-
-Las secciones de adorno sólo se deben usar dentro de expresiones de
-música secuenciales.  No están contemplados el anidado ni la
-yuxtaposición de secciones de adorno, y podría producir caídas u otros errores.
-
-
-
-@node Expressive marks
-@section Expressive marks
-
-Las marcas de expresión ayudan al músico a sacar de la música algo más que
-simples notas y ritmos.
-
-@menu
-* Articulations::               
-* Fingering instructions::      
-* Dynamics::                    
-* Breath marks::                
-* Trills::                      
-* Glissando::                   
-* Arpeggio::                    
-* Falls and doits::             
-@end menu
-
-
-@node Articulations
-@subsection Articulations
-
-@cindex Articulaciones
-@cindex guiones
-@cindex ornamentos
-
-Un amplio abanico de símbolos pueden aparecer encima o debajo de las notas
-para indicar distintas características de la ejecución.  Se adjuntan a una
-nota escribiendo un guión y el carácter que significa la articulación.
-Se muestran a continuación:
-
-@lilypondfile[quote,ragged-right]{script-abbreviations.ly}
-
-Los significados de estas abreviaturas se pueden modificar.  Consulte
-@file{ly/@/script@/-init@/.ly} para ver ejemplos.
-
-La indicación se coloca automáticamente, pero la dirección (arriba o abajo)
-se puede también forzar.  Como otros fragmentos de código de LilyPond,
-@code{_} los situará por debajo del pentagrama, y @code{^} los colocará por encima.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c''4^^ c''4_^
-@end lilypond
-
-Se pueden añadir otros símbolos usando la sintaxis
-@var{nota}@code{\}@var{nombre}.  Una vez más, se puede forzar
-que aparezcan por encima o por debajo usando @code{^} y @code{_},
-por ejemplo
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c\fermata c^\fermata c_\fermata
-@end lilypond
-
-@cindex acento
-@cindex marcato
-@cindex staccatissimo
-@cindex espressivo
-@cindex fermata
-@cindex calderón
-@cindex apagado
-@cindex staccato
-@cindex portato
-@cindex tenuto
-@cindex arco arriba
-@cindex arco abajo
-@cindex pedal, indicaciones de
-@cindex órgano, indicaciones de pedal de
-@cindex grupeto circular
-@cindex open
-@cindex flageolet
-@cindex grupeto circular invertido
-@cindex trino
-@cindex semitrino
-@cindex semitrino descendente
-@cindex prallprall
-@cindex prallmordent
-@cindex prall, up
-@cindex prall, down
-@cindex thumb marking
-@cindex segno
-@cindex coda
-@cindex varcoda
-
-He aquí un cuadro que muestra todas las articulaciones disponibles:
-
-@lilypondfile[ragged-right,quote]{script-chart.ly}
-
-
-@commonprop
-
-El orden vertical de las articulaciones se controla con la propiedad
-@code{script-priority}.  Cuanto más bajo es esta número,
-más cerca de la nota se colocará.
-En este ejemplo el @internalsref{TextScript} (el símbolo de sostenido) tiene primero la
-prioridad más baja, así que se coloca en la parte más baja en el primer ejemplo.
-En el segundo, el semitrino (el @internalsref{Script}) tiene la prioridad más baja, por tanto
-se coloca en la parte interior.  Cuando dos objetos tienen la misma prioridad, el orden en que
-se escriben decide cuál de ellos va primero.
-
-@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
-\once \override TextScript #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-
-\once \override Script #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{Script}.
-
-
-@refbugs
-
-Estos signos aparecen en la salida impresa pero no tienen ningún efecto sobre la
-representación de MIDI de la música.
-
-
-@node Fingering instructions
-@subsection Fingering instructions
-
-@cindex digitación
-@cindex cambio de dedo
-
-Las instrucciones de digitación se pueden introducir usando
-@example
-@var{nota}-@var{dígito}
-@end example
-Para los cambios de dedo, utilice marcas de texto.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
-@end lilypond
-
-Puede usar la articulación de pulgar para indicar que una nota se debe tocar con el pulgar
-(p.ej. en música de cello)
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
-@end lilypond
-
-Las digitaciones para los acordes también se pueden añadir a las notas individuales del acorde
-escribiéndolas después de las alturas
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
-@end lilypond
-
-
-@commonprop
-
-Puede ejercer un mayor control sobre la digitación de los acordes
-estableciendo @code{fingeringOrientations}
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-Usando esta funcionalidad, también es posible poner instrucciones de digitación muy cerca de las cabezas 
-de nota en música monofónica,
-
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{Fingering}.
-
-Ejemplos: @lsr{expressive,fingering-chords.ly}
-
-
-@node Dynamics
-@subsection Dynamics
-
-@cindex Dynamics
-@funindex \pppp
-@funindex \ppp
-@funindex \pp
-@funindex \p
-@funindex \mp
-@funindex \mf
-@funindex \f
-@funindex \ff
-@funindex \fff
-@funindex \ffff
-@funindex \fp
-@funindex \sf
-@funindex \sff
-@funindex \sp
-@funindex \spp
-@funindex \sfz
-@funindex \rfz
-
-Las marcas dinámicas de matiz absoluto se especifican usando un comando después de una nota:
-@code{c4\ff}.  Las marcas dinámicas disponibles son @code{\ppppp},
-@code{\pppp}, @code{\ppp},
-@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
-@code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
-@code{\sp}, @code{\spp}, @code{\sfz} y @code{\rfz}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
-c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
-@end lilypond
-
-@funindex \<
-@funindex \>
-@funindex \!
-
-Un regulador de crescendo se comienza con @code{\<} y se termina con
-@code{\!} o con un matiz absoluto.  Un regulador decrescendo comienza con
-@code{\>} y se termina también con @code{\!} o con un matiz dinámico
-absoluto.  Se pueden usar @code{\cr} y @code{\decr} en lugar de
-@code{\<} y @code{\>}.  A causa de que estas marcas se unen a notas, se deben
-usar notas espaciadoras si se necesitan varias marcas durante una nota.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\< c\! d\> e\!
-<< f1 { s4 s4\< s4\! \> s4\! } >>
-@end lilypond
-
-@noindent
-Un regulador comienza normalmente en el borde izquierdo de la nota inicial
-y acaba en el borde derecho de la nota final.  Si la nota
-final cae sobre el principio de un compás,  el regulador finaliza en la línea divisoria
-inmediatamente anterior.  Esto se puede modificar estableciendo la propiedad
-@code{hairpinToBarline},
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set hairpinToBarline = ##f
-c4\< c2. c4\!
-@end lilypond
-
-En algunas situaciones, la marca de articulación @code{\espressivo} puede ser
-apropiada para indicar un crescendo y decrescendo sobre una nota,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c2 b4 a g1\espressivo
-@end lilypond
-
-Esto puede dar lugar a reguladores muy cortos.  Utilice @code{minimum-length}
-dentro de @internalsref{Voice}.@internalsref{Hairpin} para alargarlos, por
-ejemplo
-
-@example
-\override Voice.Hairpin #'minimum-length = #5
-@end example
-
-@cindex al niente
-@cindex niente, al
-
-Los reguladores se pueden imprimir con la punta en círculo (notación
-al niente) estableciendo la propiedad @code{circled-tip},
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override Hairpin #'circled-tip = ##t
-c2\< c\!
-c4\> c\< c2\!
-@end lilypond
-
-
-@cindex crescendo
-@cindex decrescendo
-@cindex diminuendo
-
-También puede usar texto que diga @emph{cresc.} en vez de reguladores
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\setTextCresc
-c\< d e f\!
-\setHairpinCresc
-e\> d c b\!
-\setTextDecresc
-c\> d e f\!
-\setTextDim
-e\> d c b\!
-@end lilypond
-
-Asimismo puede aportar sus propios textos
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\set crescendoText = \markup { \italic "cresc. poco" }
-\set crescendoSpanner = #'dashed-line
-a'2\< a a a\!\mf
-@end lilypond
-
-Para crear nuevas indicaciones dinámicas o texto que se deba alinear
-con los matices, consulte @ref{New dynamic marks}.
-
-El posicionamiento vertical de las expresiones dinámicas se gestiona a
-través de @internalsref{DynamicLineSpanner}.
-
-
-@commonprop
-
-Las expresiones dinámicas que suceden en, comienzan sobre, o acaban
-en, la misma nota se alinearán verticalmente.  Si quiere asegurar que
-las expresiones dinámicas se alinean cuando no suceden sobre la misma
-nota, puede aumentar el valor de la propiedad @code{staff-padding}.
-
-@example
-\override DynamicLineSpanner #'staff-padding = #4
-@end example
-
-También puede utilizar esta propiedad si las expresiones dinámicas
-colisionan con otros elementos de la notación.
-
-Los crescendi y decrescendi que acaban sobre la misma nota de una
-línea nueva no se imprimen.  Para cambiar este comportamiento, utilice
-
-@example
-\override Score.Hairpin #'after-line-breaking = ##t
-@end example
-
-Los cambios dinámicos de tipo texto (como @emph{cresc.} y @emph{dim.})
-se imprimen con una línea de puntos que muestra su alcance.  Para
-evitar que se imprima esta línea, use
-
-@example
-\override DynamicTextSpanner #'dash-period = #-1.0
-@end example
-
-
-@refcommands
-
-@funindex \dynamicUp
-@code{\dynamicUp},
-@funindex \dynamicDown
-@code{\dynamicDown},
-@funindex \dynamicNeutral
-@code{\dynamicNeutral}.
-
-
-@seealso
-
-Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
-El posicionamiento vertical de estos símbolos se maneja por medio de
-@internalsref{DynamicLineSpanner}.
-
-
-@node Breath marks
-@subsection Breath marks
-
-Las marcas de respiración se introducen usando @code{\breathe}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c'4 \breathe d4
-@end lilypond
-
-
-@commonprop
-
-El glifo de la marca de respiración se puede ajustar por medio de la sobreescritura de la propiedad
-@code{text} del objeto de presentación @code{BreathingSign} con cualquier texto de marcado.
-Por ejemplo,
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-c'4
-\override BreathingSign #'text
-  = #(make-musicglyph-markup "scripts.rvarcomma")
-\breathe
-d4
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{BreathingSign}.
-
-Ejemplos: @lsr{expressive,breathing-sign.ly}
-
-
-@node Trills
-@subsection Trills
-
-Los trinos cortos se imprimen como una articulación normal; consulte @ref{Articulations}.
-
-Los trinos largos mantenidos se hacen con @code{\startTrillSpan} y
-@code{\stopTrillSpan},
-
-@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
-\new Voice {
-  << { c1 \startTrillSpan }
-     { s2. \grace { d16[\stopTrillSpan e] } } >>
-  c4 }
-@end lilypond
-
-@cindex Trinos con altura
-
-Los trinos que se tienen que ejecutar sobre notas especificadas
-explícitamente se pueden tipografiar con el comando @code{pitchedTrill},
-
-@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
-\pitchedTrill c4\startTrillSpan fis
-f\stopTrillSpan
-@end lilypond
-
-@noindent
-El primer argumento es la nota principal.  La altura de la segunda se
-imprime como una cabeza de nota sin plica entre paréntesis.
-
-
-@refcommands
-
-@code{\startTrillSpan},
-@funindex \startTrillSpan
-@code{\stopTrillSpan}.
-@funindex \stopTrillSpan
-
-
-@seealso
-
-Referencia del programa: @internalsref{TrillSpanner}.
-
-
-@node Glissando
-@subsection Glissando
-
-@cindex Glissando
-@funindex \glissando
-
-Un glissando es un cambio gradual en la altura.  Se denota por medio
-de una línea o una línea ondulada entre dos notas.  Se llama
-adjuntando @code{\glissando} a una nota
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-c2\glissando c'
-\override Glissando #'style = #'zigzag
-c2\glissando c,
-@end lilypond
-
-
-@commonprop
-
-@lilypond[quote,ragged-right,verbatim]
-I = \once \override NoteColumn #'ignore-collision = ##t
-
-\relative <<
-  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
-  { \oneVoice \I c2 \glissando \I d, }
->>
-@end lilypond
-
-
-
-@seealso
-
-Referencia del programa: @internalsref{Glissando}.
-
-Archivos de ejemplo:
-@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
-
-
-@refbugs
-
-La impresión de texto sobre la línea (como @emph{gliss.}) no está contemplada.
-
-
-@node Arpeggio
-@subsection Arpeggio
-
-@cindex Arpeggio
-@cindex acorde quebrado
-@funindex \arpeggio
-
-Se puede especificar un signo de arpegio (conocido también como acorde quebrado) sobre un
-acorde adjuntando un @code{\arpeggio} a un acorde
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-<c e g c>\arpeggio
-@end lilypond
-
-Un corchete recto a la izquierda indica que el intérprete no tiene que
-arpegiar el acorde
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\arpeggioBracket
-<c' e g c>\arpeggio
-@end lilypond
-
-La dirección del arpegio se denota a veces mediante la adición de una
-punta de flecha a la línea ondulada
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new Voice {
-  \arpeggioUp
-  <c e g c>\arpeggio
-  \arpeggioDown
-  <c e g c>\arpeggio
-}
-@end lilypond
-
-
-@commonprop
-
-Cuando un arpegio cruza uno o varios pentagramas, puede adjuntar un
-arpegio a los acordes en los dos pentagramas y establecer
-@internalsref{PianoStaff}.@code{connectArpeggios}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \set PianoStaff.connectArpeggios = ##t
-  \new Staff { <c' e g c>\arpeggio }
-  \new Staff { \clef bass <c,, e g>\arpeggio }
->>
-@end lilypond
-
-@c TODO: cross-voice arpeggio example?
-@c such an example is already in LSR -J.Mandereau
-
-@refcommands
-
-@code{\arpeggio},
-@funindex \arpeggioUp
-@code{\arpeggioUp},
-@funindex \arpeggioDown
-@code{\arpeggioDown},
-@funindex \arpeggioNeutral
-@code{\arpeggioNeutral},
-@funindex \arpeggioBracket
-@code{\arpeggioBracket}.
-
-
-@seealso
-
-Manual de notación: @ref{Ties}, para escribir arpegios explícitamente.
-
-Referencia del programa: @internalsref{Arpeggio}.
-
-
-@refbugs
-
-No es posible mezclar arpegios conectados y no conectados en un
-@internalsref{PianoStaff} en el mismo instante de tiempo.
-
-
-@node Falls and doits
-@subsection Falls and doits
-
-Se pueden expresar caídas y subidas de tono (falls y doits) añadidas a
-las notas mediante el comando @code{\bendAfter},
-
-@lilypond[fragment,ragged-right,relative=2]
-\override Score.SpacingSpanner #'shortest-duration-space = #3.0
-c4-\bendAfter #+5
-c4-\bendAfter #-3
-@end lilypond
-
-
-@node Repeats
-@section Repeats
-
-La repetición es un concepto fundamental en música, y existen varios
-tipos de notación para las repeticiones.
-
-@menu
-* Repeat types::                
-* Repeat syntax::               
-* Repeats and MIDI::            
-* Manual repeat commands::      
-* Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
-@end menu
-
-
-@node Repeat types
-@subsection Repeat types
-
-@cindex repeticiones
-
-Están contemplados los siguientes tipos de repetición
-
-@table @code
-@item desplegada
-Las música repetida está completamente escrita (e interpretada).  Es
-útil cuando se introduce música repetitiva.  Éste es el único tipo de
-repetición que se incluye en la salida MIDI.
-
-@item volta (primera y segunda vez)
-Las repeticiones no están desarrolladas, pero se imprimen finales
-alternativos (volte) de izquierda a derecha con corchetes.  Ésta es la
-notación estándar para las repeticiones con alternativas.  Por omisión
-no se reproducen en la salida MIDI.
-
-
-@item trémolo
-Hacen barras de trémolo.  Por omisión no se reproducen en la salida MIDI.
-
-@item porcentaje
-Hacen repeticiones de compases o parte de ellos.  Tienen un aspecto
-semejante a un signo de porcentaje.  Por omisión no se reproducen en
-la salida MIDI.  Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
-
-@end table
-
-
-@node Repeat syntax
-@subsection Repeat syntax
-
-@cindex volta
-@cindex prima volta
-@cindex seconda volta
-@funindex \repeat
-
-LilyPond tiene una construcción sintáctica para especificar distintos
-tipos de repetición.  La sintaxis es
-
-@example
-\repeat @var{variante} @var{número_de_repeticiones} @var{cuerpo_de_la_repetición}
-@end example
-
-Si tiene finales alternativos, puede añadir
-@funindex \alternative
-@example
-\alternative @{
-  @var{alternativa1}
-  @var{alternativa2}
-  @var{alternativa3}
-  @dots{}
-@}
-@end example
-
-@noindent
-donde cada @var{alternativa} es una expresión musical.  Si no da un
-número de alternativas suficiente para todas las repeticiones, se
-supondrá que la primera alternativa se interpreta más de una vez.
-
-Las repeticiones estándar se usan de esta forma:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
-@end lilypond
-
-Con finales alternativos
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
-@end lilypond
-
-Se pueden crear repeticiones con anacrusa.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 e |
-  \repeat volta 4 { c2 d2 | e2 f2 | }
-  \alternative { { g4 g g e } { a a a a | b2. } }
-}
-@end lilypond
-
-@noindent
-o bien
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 
-  \repeat volta 4 { e | c2 d2 | e2 f2 | }
-  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
-}
-@end lilypond
-
-
-
-@funindex \repeatTie
-
-Se pueden añadir ligaduras de unión al segundo final,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
-@end lilypond
-
-Es posible acortar los corchetes de primera y segunda vez
-estableciendo @code{voltaSpannerDuration}.  En el ejemplo siguiente, el
-corchete sólo dura un compás, lo que supone una duración de 3/4.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c''{
-  \time 3/4
-  c c c
-  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
-  \repeat volta 5 { d d d }
-  \alternative { { e e e f f f }
-  { g g g } }
-}
-@end lilypond
-
-Si quiere comenzar una repetición al principio de una línea y tiene una
-doble barra al final de la línea anterior, utilice
-@example
-@dots{} \bar "||:" \break 
-\repeat volta 2 @{ @dots{} 
-@end example
-consulte @ref{Bar lines} para ver más información.
-
-@seealso
-
-Referencia del programa: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} y
-@internalsref{UnfoldedRepeatedMusic}.
-
-Ejemplos:
-
-Normalmente los corchetes para la repetición sólo se imprimen sobre el
-pentagrama superior.  Esto se puede ajustar moviendo @code{Volta_engraver} al contexto
-Staff donde quiera que aparezcan los corchetes;
-consulte @ref{Modifying context plug-ins} y
-
-@lsr{repeats,volta@/-multi@/-staff@/.ly}.
-
-
-@refbugs
-
-@cindex repetición ambigua
-
-Una repetición anidada como
-
-@example
-\repeat @dots{}
-\repeat @dots{}
-\alternative
-@end example
-
-@noindent
-es ambigua porque no está claro a qué @code{\repeat} pertenece la
-@code{\alternative}.  Esta ambigüedad se resuelve haciendo que la
-@code{\alternative} pertenezca siempre a la @code{\repeat} más
-interna.  Para más claridad, se recomienda usar llaves en tales situaciones.
-
-La información del contador de tiempo no se recuerda al comienzo de una alternativa,
-por ello después de una repetición la información de la cuenta de tiempo se debe reajustar
-manualmente; por ejemplo, estableciendo el valor de @code{Score.measurePosition} o
-introduciendo @code{\partial}.  De forma similar, las ligaduras de expresión o de unión tampoco se repiten.
-
-Los corchetes de primera y segunda vez no se alinean verticalmente.
-
-
-@node Repeats and MIDI
-@subsection Repeats and MIDI
-
-@cindex expansión de repeticiones
-@funindex \unfoldRepeats
-
-Con un poco de trucaje, todos los tipos de repeticiones pueden estar
-presentes en la salida MIDI.  Se consigue por medio de la aplicación
-de la función musical @code{\unfoldRepeats}.  Esta función transforma
-todas las repeticiones en repeticiones desarrolladas o desplegadas.
-
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
-  \repeat tremolo 8 {c'32 e' }
-  \repeat percent 2 { c''8 d'' }
-  \repeat volta 2 {c'4 d' e' f'}
-  \alternative {
-    { g' a' a' g' }
-    {f' e' d' c' }
-  }
-}
-\bar "|."
-@end lilypond
-
-Cuando se elabora un archivo de partitura que utiliza @code{\unfoldRepeats} para el MIDI,
-es necesario hacer dos bloques @code{\score}: uno para el MIDI (con las repeticiones desplegadas)
-y otro para la notación (con primera y segunda vez, trémolo y repeticiones de porcentaje).
-Por ejemplo,
-
-@example
-\score @{
-  @var{..música..}
-  \layout @{ .. @}
-@}
-\score @{
-  \unfoldRepeats @var{..música..}
-  \midi @{ .. @}
-@}
-@end example
-
-
-@node Manual repeat commands
-@subsection Manual repeat commands
-
-@funindex repeatCommands
-
-Se puede usar la propiedad @code{repeatCommands} para controlar la
-disposición de las repeticiones.  Su valor es una lista de Scheme de comandos de repetición.
-
-@table @asis
-@item @code{start-repeat}
-Imprimir una barra de compás @code{|:}
-
-@item @code{end-repeat}
-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,
-porque el tipo por defecto para los números no contiene caracteres alfabéticos;
-
-@item @code{(volta #f)}
-Detener un corchete de volta mantenido.
-@end table
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c4
-  \set Score.repeatCommands = #'((volta "93") end-repeat)
-c4 c4
-  \set Score.repeatCommands = #'((volta #f))
-c4 c4
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic} y
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-@node Tremolo repeats
-@subsection Tremolo repeats
-
-@cindex barras de trémolo
-
-Para colocar marcas de trémolo entre las notas, use @code{\repeat} con el
-estilo tremolo
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
-}
-@end lilypond
-
-Las marcas de trémolo también se pueden poner sobre una nota única.  En este caso, la
-nota no debe estar encerrada entre llaves.
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
-@end lilypond
-
-Se obtiene una salida similar usando la subdivisión del trémolo, que se describe en
-@ref{Tremolo subdivisions}.
-
-
-@seealso
-
-En el presente manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
-
-Referencia del programa: @internalsref{Beam}, @internalsref{StemTremolo}.
-
-
-@node Tremolo subdivisions
-@subsection Tremolo subdivisions
-
-@cindex marcas de trémolo
-@funindex tremoloFlags
-
-Las marcas de trémolo se pueden imprimir sobre una nota única escribiendo
-@q{@code{:}[@var{número}]} después de la nota.  El número indica la
-duración de la subdivisión, y debe ser al menos 8.  Un valor de
-@var{longitud} de 8 produce una línea tachando la plica de la nota.  Si se
-omite la longitud,
-se utiliza el último valor (almacenado en @code{tremoloFlags})
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
-@end lilypond
-
-
-@refbugs
-
-Los trémolos escritos de esta forma no se trasladan a la salida MIDI.
-
-
-@seealso
-
-En el presente manual: @ref{Tremolo repeats}.
-
-En otros lugares: @internalsref{StemTremolo}.
-
-
-@node Measure repeats
-@subsection Measure repeats
-
-@cindex porcentaje, repeticiones de
-@cindex compás, repeticiones de
-
-En el estilo @code{percent} (porcentaje), se puede hacer que se repita un patrón de notas.  Se
-imprime una sola vez, y luego el patrón se sustituye con un símbolo especial.
-Los patrones de uno y dos compases se sustituyen por símbolos parecidos a un porcentaje,
-y los patrones que dividen a la duración de un compás se sustituyen por barras inclinadas.
-Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Las repeticiones de compás de más de 2 compases llevan un contador, si
-se activa la propiedad @code{countPercentRepeats},
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat percent 4 { c1 }
-}
-@end lilypond
-
-
-
-También se pueden imprimir porcentajes aislados.  Esto se hace
-mediante la colocación de un silencio multicompás con una función de impresión distinta,
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
-@end lilypond
-
-
-
-
-@seealso
-
-Referencia del programa: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
-
-
-
diff --git a/Documentation/es/user/changing-defaults.itely b/Documentation/es/user/changing-defaults.itely
index c0c1c3b31e..54cd806818 100644
--- a/Documentation/es/user/changing-defaults.itely
+++ b/Documentation/es/user/changing-defaults.itely
@@ -717,7 +717,7 @@ consulte
 @internalsref{Contexts}.
 @end ifhtml
 @ifnothtml
-Traducción @arrow{} Contexto.
+Traducción @expansion{} Contexto.
 @end ifnothtml
 
 @c [TODO: describe propagation]
@@ -982,7 +982,7 @@ véase
 @internalsref{Tunable context properties}.
 @end ifhtml
 @ifnothtml
-Traducción @arrow{} propiedades de contexto ajustables.
+Traducción @expansion{} propiedades de contexto ajustables.
 @end ifnothtml
 
 
@@ -1001,14 +1001,14 @@ Para ver una descripción completa de cada uno de los añadidos, consulte
 @internalsref{Engravers}.
 @end ifhtml
 @ifnothtml
-Referencia del programa @arrow Traducción @arrow{} Grabadores.
+Referencia del programa @expansion Traducción @expansion{} Grabadores.
 @end ifnothtml
 cada uno de los contextos descritos en
 @ifhtml
 @internalsref{Contexts}
 @end ifhtml
 @ifnothtml
-Referencia del programa @arrow Traducción @arrow{} Contexto.
+Referencia del programa @expansion Traducción @expansion{} Contexto.
 @end ifnothtml
 relaciona los grabadores utilizados para ese contexto.
 
@@ -1055,7 +1055,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 @ref{Common tweaks}.
+sofisticado de borrar objetos se muestra en @rlearning{Common tweaks}.
 
 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
@@ -1726,7 +1726,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
-@ref{Default files})
+@rlearning{Default files})
 @file{scm/@/define@/-grobs@/.scm} muestra el alma del @q{objeto},
 
 @example
diff --git a/Documentation/es/user/chords.itely b/Documentation/es/user/chords.itely
new file mode 100644
index 0000000000..334dedce33
--- /dev/null
+++ b/Documentation/es/user/chords.itely
@@ -0,0 +1,390 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Chords Blah
+@section Chords Blah
+
+Intro text.
+
+@menu 
+* TODO chords fix::
+@end menu 
+
+
+@node TODO chords fix
+@subsection TODO chords fix
+
+@menu
+* Introducing chord names::     
+* Chords mode::                 
+* Printing chord names::        
+@end menu
+
+
+@c  awkward name; awkward section name.
+@c  still, the Basic "chords" seems like a good name...  :(
+@node Introducing chord names
+@unnumberedsubsubsec Introducing chord names
+@cindex acordes, nombres
+
+LilyPond tiene la capacidad de imprimir nombres de acordes.  Los acordes se pueden introducir
+en notación musical de acordes, es decir: @code{< .. >}, pero también se pueden
+introducir por su nombre.  Internamente los acordes se representan como un conjunto de
+notas, así que se pueden transportar
+
+
+@lilypond[quote,ragged-right,verbatim,ragged-right]
+twoWays = \transpose c c' {
+  \chordmode {
+    c1 f:sus4 bes/f
+  }
+  <c e g>
+  <f bes c'>
+  <f bes d'>
+}
+
+<< \new ChordNames \twoWays
+   \new Voice \twoWays >>
+@end lilypond
+
+Este ejemplo también muestra que las rutinas de impresión de acordes no tratan de
+ser inteligentes.  El último acorde (@code{f bes d}) no se interpreta como
+una inversión.
+
+Tenga en cuenta que la duración de los acordes se debe especificar fuera de los
+@code{<>}.
+
+@example
+<c e g>2
+@end example
+
+
+@node Chords mode
+@unnumberedsubsubsec Chords mode
+@cindex Acordes, modo de
+
+En el modo de acordes, se introducen conjuntos de notas o acordes con sus nombres usuales.
+Un acorde se introduce por su fundamental, que se escribe como una
+nota normal
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { es4. d8 c2 }
+@end lilypond
+
+@noindent
+El modo se inicia mediante la palabra clave @code{\chordmode}.
+
+@cindex acordes, introducción
+@cindex acordes, modo de
+
+Otros acordes se pueden escribir añadiendo al final dos puntos e introduciendo un
+modificador (que puede incluir un número si se desea)
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { e1:m e1:7 e1:m7 }
+@end lilypond
+
+El primer número que sigue a la fundamental se toma como el @q{tipo} de
+acorde, las terceras se añaden a la fundamental hasta que se alcanza el número
+especificado. La excepción es @code{c:13}, para el que se omite el 11.
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@end lilypond
+
+@cindex fundamental de un acorde
+@cindex adiciones, en acordes
+@cindex omisiones, en acordes
+
+También se pueden construir acordes más complejos añadiendo elementos separados
+a un acorde.  Las adiciones se escriben después del número que sigue
+a los dos puntos y van separadas por puntos
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+@end lilypond
+
+Los elementos de un acorde se pueden alterar añadiendo un signo de @code{-} ó @code{+}
+al número
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+@end lilypond
+
+Las omisiones se especifican de forma similar y se escriben mediante un circunflejo.  Deben
+ir después de las adiciones
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c^3 c:7^5 c:9^3.5 }
+@end lilypond
+
+Se pueden usar modificadores para cambiar la altura de las notas.  Están previstos los siguientes
+modificadores
+
+@table @code
+@item m
+El acorde menor.  Este modificador baja la tercera y (si está presente) la séptima.
+
+@item dim
+El acorde disminuido.  Este modificador baja la tercera, la quinta y (si está presente)
+la séptima.
+
+@item aug
+El acorde aumentado.  Este modificador eleva la quinta.
+
+@item maj
+El acorde de séptima mayor.  Este modificador eleva la séptima si está presente.
+
+@item sus
+El acorde suspendido de cuarta o de segunda.  Este modificador suprime la tercera.
+Escriba @code{2} ó @code{4} para añadir la segunda o la cuarta al
+acorde.
+@end table
+
+Se pueden mezclar modificadores con adiciones
+@lilypond[quote,verbatim,fragment]
+  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+@end lilypond
+
+@cindex modificadores, en acordes
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex sus
+@funindex m
+
+Puesto que una 11ª sin alterar no suena bien cuando se combina con una
+13ª sin alterar, la 11ª se suprime en este caso (a no ser que se añada de forma
+explícita)
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c:13 c:13.11 c:m13 }
+@end lilypond
+
+@funindex /
+
+Se puede especificar una inversión (colocar en el bajo una nota del acorde), así como
+notas del bajo, añadiendo
+@code{/}@var{pitch} al acorde
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/g c/f }
+@end lilypond
+@funindex /+
+
+Un bajo se puede añadir en lugar de moverlo dentro del mismo acorde,
+mediante @code{/+}@var{pitch}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/+g c/+f }
+@end lilypond
+
+El modo de acordes es similar a @code{\lyricmode} y demás.  La mayoría de
+los comandos siguen funcionando, por ejemplo se pueden usar @code{r} y
+@code{\skip} para insertar silencios y espacios, y las instrucciones
+de propiedades se pueden usar para modificar ciertos valores.
+
+
+
+@refbugs
+
+Cada nota sólo se puede presentar una vez dentro del acorde.  Lo siguiente
+simplemente produce el acorde aumentado, ya que el @code{5+} se interpreta en
+último lugar
+@cindex racimos (clusters)
+@lilypond[quote,ragged-right,verbatim,fragment]
+\chordmode { c:5.5-.5+ }
+@end lilypond
+
+
+@node Printing chord names
+@unnumberedsubsubsec Printing chord names
+
+@cindex impresión de los nombres de acorde
+@cindex acordes, nombres de
+@cindex acordes
+
+Para la presentación de los nombres de acordes impresos utilice el contexto @internalsref{ChordNames}.
+Los acordes se puede introducir o bien usando la notación
+descrita anteriormente, o directamente usando @code{<} y @code{>}
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = {
+  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+}
+<<
+  \new ChordNames \harmonies
+  \new Staff \harmonies
+>>
+@end lilypond
+
+Puede hacer que los cambios de acorde se hagan notar, estableciendo
+@internalsref{ChordNames}.@code{chordChanges} al valor verdadero.  Esto sólo 
+mostrará los nombres de los acordes cuando ocurra un cambio en la estructura de acordes y al comienzo
+de una línea
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = \chordmode {
+  c1:m c:m \break c:m c:m d
+}
+<<
+  \new ChordNames {
+    \set chordChanges = ##t
+    \harmonies }
+  \new Staff \transpose c c' \harmonies
+>>
+@end lilypond
+
+Todos los ejemplos anteriores muestran los acordes sobre una pauta.  Esto no es
+necesario.  Los acordes también se pueden imprimir por separado.  Puede ser necesario
+añadir @internalsref{Volta_engraver} y @internalsref{Bar_engraver}
+para mostrar las repeticiones.
+
+@lilypond[ragged-right,verbatim]
+\new ChordNames \with {
+  \override BarLine #'bar-size = #4
+  \consists Bar_engraver
+  \consists "Volta_engraver"
+}
+\chordmode { \repeat volta 2 {
+  f1:maj7 f:7 bes:7
+  c:maj7
+} \alternative {
+  es e
+}
+}
+@end lilypond
+
+
+La disposición por defecto de los nombres de acorde en la página es una pauta para el Jazz, propuesta por
+Klaus Ignatzek (véase @ref{Literature list}).  Se puede modificar a través de las
+siguientes propiedades
+
+@table @code
+@funindex chordNameExceptions
+@item chordNameExceptions
+He aquí una lista de los acordes que tienen un formateo especial.
+
+La lista de excepciones se debe codificar como
+@example
+@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
+@end example
+
+La incorporación de esta información dentro de @code{chordNameExceptions} requiere algunas
+maniobras.  El código siguiente transforma @code{chExceptionMusic}
+(que es música secuencial) en una lista de excepciones.
+@example
+(sequential-music-to-chord-exceptions chExceptionMusic #t)
+@end example
+Después,
+@example
+(append
+ (sequential-music-to-chord-exceptions chExceptionMusic #t)
+ ignatzekExceptions)
+@end example
+añade las nuevas excepciones a las que existen de fábrica, que se encuentran definidas en
+@file{ly/@/chord@/-modifier@/-init@/.ly}.
+
+Para ver un ejemplo de cómo modificar esta propiedad, véase también
+@lsr{chords,chord@/-name@/-exceptions@/.ly}
+@cindex excepciones, nombres de acordes.
+
+
+@funindex majorSevenSymbol
+@item majorSevenSymbol
+Esta propiedad contiene el objeto de marcado usado para la séptima, cuando
+es mayor.  Las opciones predefinidas son @code{whiteTriangleMarkup} y
+@code{blackTriangleMarkup}.  Consulte
+@lsr{chords,chord@/-name@/-major7@/.ly} para ver un ejemplo.
+
+@funindex chordNameSeparator
+@item chordNameSeparator
+Las distintas partes de un acorde están separadas normalmente por una barra
+inclinada.  Estableciendo @code{chordNameSeparator}, puede especificar otros
+separadores, p.ej.
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new ChordNames \chordmode {
+  c:7sus4
+  \set chordNameSeparator
+    = \markup { \typewriter "|" }
+  c:7sus4
+}
+@end lilypond
+
+@funindex chordRootNamer
+@item chordRootNamer
+La fundamental de un acorde se imprime normalmente como una letra con una alteración
+opcional.  La transformación de nota a letra se hace por medio de esta función.
+Los nombres de nota especiales (por ejemplo, la @q{H} alemana para un
+acorde de Si) se puede producir almacenando una nueva función dentro de esta propiedad.
+
+@funindex chordNoteNamer
+@item chordNoteNamer
+La opción por defecto es imprimir una sola nota, p.ej. el bajo, usando el
+@code{chordRootNamer}.  La propiedad @code{chordNoteNamer} se puede establecer
+a una función especializada para cambiar este comportamiento.  Por ejemplo, la
+nota base se puede imprimir en minúsculas.
+
+@funindex chordPrefixSpacer
+@item chordPrefixSpacer
+La @q{m} que de nota a los acordes menores se imprime normalmente justo después de la fundamental
+del acorde. Estableciendo @code{chordPrefixSpacer}, puede insertar un separador
+entre la fundamental y la @q{m}. El separador no se usa cuando la fundamental 
+está alterada.
+
+@end table
+
+Las variables predefinidas @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} y @code{\frenchChords}
+establecen estas variables.  El efecto se muestra
+a continuación:
+
+@lilypondfile[ragged-right]{chord-names-languages.ly}
+
+También se encuentran implementados otros dos esquemas de nombres de acorde: una
+notación de acordes alternativa para Jazz, y un esquema sistemático llamado acordes de Banter.  La
+notación alternativa de Jazz se muestra también en el cuadro @ref{Chord name
+chart}.  El resultado de la activación de estos estilos se muestra en
+@lsr{chords,chord-names-jazz.ly}.
+
+@cindex Banter
+@cindex jazz, acordes de
+@cindex acordes de jazz
+
+
+@refcommands
+
+@funindex \germanChords
+@code{\germanChords},
+@funindex \semiGermanChords
+@code{\semiGermanChords}.
+@funindex \italianChords
+@code{\italianChords}.
+@funindex \frenchChords
+@code{\frenchChords}.
+
+
+
+
+@seealso
+
+Ejemplos:
+@lsrdir{chords}
+
+Archivos de inicio: @file{scm/@/chords@/-ignatzek@/.scm} y
+@file{scm/@/chord@/-entry@/.scm}.
+
+
+@refbugs
+
+Los nombres de acorde se determinan exclusivamente a partir de la lista de notas.  No se identifican
+las inversiones de acorde ni las notas del bajo añadidas.  Esto puede
+dar como resultado nombres de acorde extraños cuando éstos se introducen con la
+sintaxis @code{< .. >}.
+
+
diff --git a/Documentation/es/user/converters.itely b/Documentation/es/user/converters.itely
index 7036c7f949..77cd18ef17 100644
--- a/Documentation/es/user/converters.itely
+++ b/Documentation/es/user/converters.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/educational.itely b/Documentation/es/user/educational.itely
new file mode 100644
index 0000000000..42d5ebcb9d
--- /dev/null
+++ b/Documentation/es/user/educational.itely
@@ -0,0 +1,546 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Educational use
+@section Educational use
+
+@menu
+* Note heads::                  
+* Inside the staff::            
+* Outside the staff::           
+@end menu
+
+
+@node Note heads
+@subsection Note heads
+
+@menu
+* Easy notation note heads::    
+* Shape note heads::            
+* Improvisation::               
+* Special noteheads::           
+@end menu
+
+@node Easy Notation note heads
+@unnumberedsubsubsec Easy Notation note heads
+
+@cindex notas, cabezas de, estudio
+@cindex notas, cabezas de, notación simplificada
+@cindex simplificada, notación
+@cindex Hal Leonard
+
+Las cabezas @q{easy play} (fáciles de tocar) tienen el nombre de la nota (en inglés) dentro de la cabeza.  Se usa
+en la música para principiantes
+
+@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
+  \setEasyHeads
+  c'2 e'4 f' | g'1
+@end lilypond
+
+La orden @code{\setEasyHeads} sobreescribe los ajustes del objeto
+@internalsref{NoteHead}.  Para que las letras sean legibles, se tienen que imprimir
+en un tamaño grande de la tipografía.  Para imprimir con un tamaño de tipografía mayor, consulte
+@ref{Setting the staff size}.
+
+@refcommands
+
+@funindex \setEasyHeads
+@code{\setEasyHeads}
+
+
+@node Shape note heads
+@unnumberedsubsubsec Shape note heads
+
+@cindex notas, cabezas de, con formas
+
+En notación de cabezas con forma, la forma de la cabeza corresponde
+a la función armónica de una nota dentro de la escala. Esta notación se hizo popular
+en los libros americanos de canciones durante el s.XIX.
+
+Las cabezas con formas se pueden producir estableciendo @code{\aikenHeads} o
+@code{\sacredHarpHeads}, según el estilo deseado.
+
+@lilypond[verbatim,relative=1,fragment]
+  \aikenHeads
+  c8 d4 e8 a2 g1
+  \sacredHarpHeads
+  c8 d4. e8 a2 g1
+@end lilypond
+
+Las formas se determinan en función del grado de la escala, donde la tónica
+está determinada por la instrucción @code{\key}
+
+@funindex \key
+@funindex shapeNoteStyles
+@funindex \aikenHeads
+@funindex \sacredHarpHeads
+
+Las cabezas con formas están programadas a través de la propiedad @code{shapeNoteStyles}.
+Su valor es un vector de símbolos.  El elemento en el lugar k indica qué estilo
+usa el grado k de la escala.  Son posibles las combinaciones
+arbitrarias, p.ej.:
+
+@lilypond[verbatim,relative=1,fragment]
+  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
+  c8 d4. e8 a2 g1
+@end lilypond
+
+
+@node Improvisation
+@unnumberedsubsubsec Improvisation
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Special noteheads
+@unnumberedsubsubsec Special noteheads
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Inside the staff
+@subsection Inside the staff
+
+
+@menu
+* Selecting notation font size::  
+* Fingering instructions::      
+* Hidden notes::                
+* Coloring objects::            
+* Parentheses::                 
+* Ambitus::                     
+* Stems::                       
+@end menu
+
+@node Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Fingering instructions
+@unnumberedsubsubsec Fingering instructions
+
+@cindex digitación
+@cindex cambio de dedo
+
+Las instrucciones de digitación se pueden introducir usando
+@example
+@var{nota}-@var{dígito}
+@end example
+Para los cambios de dedo, utilice marcas de texto.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+c4-1 c-2 c-3 c-4
+c^\markup { \finger "2 - 3" }
+@end lilypond
+
+Puede usar la articulación de pulgar para indicar que una nota se debe tocar con el pulgar
+(p.ej. en música de cello)
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+<a_\thumb a'-3>8 <b_\thumb b'-3>
+@end lilypond
+
+Las digitaciones para los acordes también se pueden añadir a las notas individuales del acorde
+escribiéndolas después de las alturas
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+< c-1 e-2 g-3 b-5 >4
+@end lilypond
+
+
+@commonprop
+
+Puede ejercer un mayor control sobre la digitación de los acordes
+estableciendo @code{fingeringOrientations}
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+\set fingeringOrientations = #'(left down)
+<c-1 es-2 g-4 bes-5 > 4
+\set fingeringOrientations = #'(up right down)
+<c-1 es-2 g-4 bes-5 > 4
+@end lilypond
+
+Usando esta funcionalidad, también es posible poner instrucciones de digitación muy cerca de las cabezas 
+de nota en música monofónica,
+
+@lilypond[verbatim,ragged-right,quote,fragment]
+\set fingeringOrientations = #'(right)
+<es'-2>4
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{Fingering}.
+
+Ejemplos: @lsr{expressive,fingering-chords.ly}
+
+
+@node Hidden notes
+@unnumberedsubsubsec Hidden notes
+
+@cindex ocultas, notas
+@cindex invisibles, notas
+@cindex transparentes, notas
+
+@funindex \hideNotes
+@funindex \unHideNotes
+Las notas ocultas (o invisibles, o transparentes) pueden ser de utilidad en la preparación de ejercicios
+de teoría o de composición.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+c4 d4
+\hideNotes
+e4 f4
+\unHideNotes
+g4 a
+@end lilypond
+
+
+@node Coloring objects
+@unnumberedsubsubsec Coloring objects
+
+Se pueden asignar colores a los objetos individuales.  Podemos usar los nombres de color
+que se relacionan en la @ref{List of colors}.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\override NoteHead #'color = #red
+c4 c
+\override NoteHead #'color = #(x11-color 'LimeGreen)
+d
+\override Stem #'color = #blue
+e
+@end lilypond
+
+Se puede acceder al espectro completo de colores definido para X11 usando la función
+de Scheme x11-color.  Esta función acepta un argumento que puede ser un
+símbolo
+
+@example
+\override Beam #'color = #(x11-color 'MediumTurquoise)
+@end example
+
+o una cadena
+
+@example
+\override Beam #'color = #(x11-color "MediumTurquoise")
+@end example
+
+La primera forma es más rápida de escribir y más eficiente.  Sin embargo,
+es posible usar la segunda forma para acceder a los colores de X11 a través de la variante del
+nombre que tiene varias palabras
+
+@example
+\override Beam #'color = #(x11-color "medium turquoise")
+@end example
+
+Si el parámetro no tiene sentido para x11-color, el color por defecto que se devuelve
+es el negro.  Debería ser obvio, a la vista de la partitura resultante, que algo está
+mal.
+
+Este ejemplo ilustra el uso de x11-color.  Tenga en cuenta que el color de la plica
+sigue siendo negro después de haberlo establecido a (x11-color 'Boggle), que es un color sin sentido
+escrito a propósito.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
+  \time 2/4
+  gis''8 a''
+  \override Beam #'color = #(x11-color "medium turquoise")
+  gis'' a''
+  \override NoteHead #'color = #(x11-color "LimeGreen")
+  gis'' a''
+  \override Stem #'color = #(x11-color 'Boggle)
+  gis'' a''
+}
+@end lilypond
+
+
+@seealso
+
+Apéndice: @ref{List of colors}.
+
+
+@refbugs
+En un navegador de web, no todos los colores de x11 se distinguen entre sí.  Para su utilización en la
+web se recomiendan los colores normales.
+
+Un color de x11 no es necesariamente de la misma tonalidad que un color normal
+con un nombre similar.
+
+Las notas de un acorde no se pueden colorear con @code{\override}; en su lugar utilice
+@code{\tweak}.  Consulte @ref{Objects connected to the input}
+para ver más detalles.
+
+
+@node Parentheses
+@unnumberedsubsubsec Parentheses
+
+@cindex fantasma, notas
+@cindex notas fantasma
+@cindex notas entre paréntesis
+
+Los objetos se pueden encerrar entre paréntesis anteponiendo @code{\parenthesize} al evento
+musical,
+
+@lilypond[relative=2,fragment,verbatim,ragged-right]
+<
+  c
+  \parenthesize d
+  g
+>4-\parenthesize -.
+@end lilypond
+
+Esto sólo funciona dentro de los acordes, incluso para notas sueltas
+
+@example
+< \parenthesize NOTA>
+@end example
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+El término @emph{ambitus} o ámbito, denota el rango de notas que abarca una voz dada
+en una parte musical.  También puede denotar el margen de notas que es capaz de tocar
+un determinado instrumento musical.  Los ámbitos se imprimen en las partes vocales de tal manera que
+los intérpretes puedan determinar con facilidad si cumplen con sus propias posibilidades.
+
+Los ámbitos se presentan al comienzo de la pieza junto a la clave inicial.
+El rango se especifica gráficamente mediante dos cabezas de nota que representan a las
+notas inferior y superior.  Para imprimir el ámbito, añada el grabador
+@internalsref{Ambitus_engraver} al contexto @internalsref{Voice},
+por ejemplo
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+Lo que da como resultado la siguiente salida:
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \consists Ambitus_engraver
+  }
+}
+
+\relative \new Staff {
+  as'' c e2 cis,2
+}
+@end lilypond
+
+Si tiene varias voces en un pentagrama único y quiere tener una sola indicación de ámbito
+por pentagrama en lugar de una por cada voz, añada el grabador
+@internalsref{Ambitus_engraver} al contexto @internalsref{Staff}
+y no al contexto @internalsref{Voice}.  He aquí un ejemplo:
+
+@lilypond[verbatim,ragged-right,quote]
+\new Staff \with {
+  \consists "Ambitus_engraver"
+}
+<<
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c'' {
+    \override Ambitus #'X-offset = #-1.0
+    \voiceOne
+    c4 a d e f2
+  }
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c' {
+    \voiceTwo
+    es4 f g as b2
+  }
+>>
+@end lilypond
+
+@noindent
+Este ejemplo utiliza una capacidad avanzada,
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@noindent
+Este código mueve el ámbito a la izquierda.  Se podría haber conseguido el mismo
+efecto con @code{extra-offset}, pero en tal caso el sistema de formateo no
+reservaría espacio para el objeto que se ha movido.
+
+@seealso
+
+Referencia del programa: @internalsref{Ambitus},
+@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
+@internalsref{AmbitusAccidental}.
+
+Ejemplos:
+@lsr{vocal,ambitus@/.ly}.
+
+@refbugs
+
+No se efectúa un tratamiento de las posibles colisiones en caso de varias indicaciones de ámbito
+simultáneas en distintas voces.
+
+
+@node Stems
+@unnumberedsubsubsec Stems
+
+Cuando se encuentra con una nota, se crea un objeto
+@internalsref{Stem} (plica) automáticamente.  Para las redondas y los
+silencios, también se crean pero se hacen invisibles.
+
+@refcommands
+
+@funindex \stemUp
+@code{\stemUp},
+@funindex \stemDown
+@code{\stemDown},
+@funindex \stemNeutral
+@code{\stemNeutral}.
+
+
+@commonprop
+
+Para modificar la dirección de las plicas en medio de un pentagrama, utilice
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+a4 b c b
+\override Stem #'neutral-direction = #up
+a4 b c b
+\override Stem #'neutral-direction = #down
+a4 b c b
+@end lilypond
+
+
+@node Outside the staff
+@subsection Outside the staff
+
+
+@menu
+* Balloon help::                
+* Grid lines::                  
+* Blank music sheet::           
+@end menu
+
+@node Balloon help
+@unnumberedsubsubsec Balloon help
+
+Los elementos de notación se pueden marcar y nombrar con la ayuda de un cartel o globo de ayuda
+rectangular.  El propósito principal de esta funcionalidad es la explicación de la notación.
+
+El ejemplo siguiente presenta una demostración de su uso.
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+  \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
+  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
+}
+@end lilypond
+
+@noindent
+Existen dos funciones musicales, @code{balloonText} y
+@code{balloonGrobText}. Este último toma su nombre del objeto gráfico que se adorna,
+mientras que el primero se puede usar como una articulación sobre una nota.
+Los otros argumentos son el desplazamiento y el texto de la etiqueta.
+
+@cindex globo
+@cindex notación, explicaciones
+
+@seealso
+
+Referencia del programa: @internalsref{text-balloon-interface}.
+
+
+@node Grid lines
+@unnumberedsubsubsec Grid lines
+
+Se pueden dibujar líneas verticales, sincronizadas con las notas, entre
+pentagramas.
+
+@lilypond[ragged-right,quote,verbatim]
+\layout {
+  \context {
+    \Staff
+    \consists "Grid_point_engraver" %% sets of grid
+    gridInterval = #(ly:make-moment 1 4)
+  }
+}
+
+\new Score \with {
+  \consists "Grid_line_span_engraver"
+  %% centers grid lines  horizontally below noteheads
+  \override NoteColumn #'X-offset = #-0.5
+}
+
+\new ChoirStaff <<
+  \new Staff {
+    \stemUp
+    \relative {
+      c'4. d8 e8 f g4
+    }
+  }
+  \new Staff {
+    %% centers grid lines  vertically
+    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
+    \stemDown
+    \clef bass
+    \relative c {
+      c4  g'  f  e
+    }
+  }
+>>
+@end lilypond
+
+Ejemplos: @lsrdir{education}
+
+
+@node Blank music sheet
+@unnumberedsubsubsec Blank music sheet
+
+@cindex papel de música vacío
+@cindex Pentagramas, hoja en blanco
+
+También se pueden producir hojas de papel de música en blanco utilizando notas invisibles y
+suprimiendo el grabador @code{Bar_number_engraver}.
+
+
+@lilypond[quote,verbatim]
+\layout{ indent = #0 }
+emptymusic = {
+  \repeat unfold 2 % Change this for more lines.
+  { s1\break }
+  \bar "|."
+}
+\new Score \with {
+  \override TimeSignature #'transparent = ##t
+% un-comment this line if desired
+%  \override Clef #'transparent = ##t
+  defaultBarType = #""
+  \remove Bar_number_engraver
+} <<
+
+% modify these to get the staves you want
+  \new Staff \emptymusic
+  \new TabStaff \emptymusic
+>>
+@end lilypond
+
+
diff --git a/Documentation/es/user/expressive.itely b/Documentation/es/user/expressive.itely
new file mode 100644
index 0000000000..a364289841
--- /dev/null
+++ b/Documentation/es/user/expressive.itely
@@ -0,0 +1,796 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Expressive marks
+@section Expressive marks
+
+@menu
+* Attached to notes::           
+* Curves::                      
+* Lines::                       
+@end menu
+
+
+@node Attached to notes
+@subsection Attached to notes
+
+
+@menu
+* Articulations::               
+* Dynamics::                    
+@end menu
+
+@node Articulations
+@unnumberedsubsubsec Articulations
+
+@cindex Articulaciones
+@cindex guiones
+@cindex ornamentos
+
+Un amplio abanico de símbolos pueden aparecer encima o debajo de las notas
+para indicar distintas características de la ejecución.  Se adjuntan a una
+nota escribiendo un guión y el carácter que significa la articulación.
+Se muestran a continuación:
+
+@c @l ilypondfile[quote,ragged-right]{script-abbreviations.ly}
+
+Los significados de estas abreviaturas se pueden modificar.  Consulte
+@file{ly/@/script@/-init@/.ly} para ver ejemplos.
+
+La indicación se coloca automáticamente, pero la dirección (arriba o abajo)
+se puede también forzar.  Como otros fragmentos de código de LilyPond,
+@code{_} los situará por debajo del pentagrama, y @code{^} los colocará por encima.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c''4^^ c''4_^
+@end lilypond
+
+Se pueden añadir otros símbolos usando la sintaxis
+@var{nota}@code{\}@var{nombre}.  Una vez más, se puede forzar
+que aparezcan por encima o por debajo usando @code{^} y @code{_},
+por ejemplo
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\fermata c^\fermata c_\fermata
+@end lilypond
+
+@cindex acento
+@cindex marcato
+@cindex staccatissimo
+@cindex espressivo
+@cindex fermata
+@cindex calderón
+@cindex apagado
+@cindex staccato
+@cindex portato
+@cindex tenuto
+@cindex arco arriba
+@cindex arco abajo
+@cindex pedal, indicaciones de
+@cindex órgano, indicaciones de pedal de
+@cindex grupeto circular
+@cindex open
+@cindex flageolet
+@cindex grupeto circular invertido
+@cindex trino
+@cindex semitrino
+@cindex semitrino descendente
+@cindex prallprall
+@cindex prallmordent
+@cindex prall, up
+@cindex prall, down
+@cindex thumb marking
+@cindex segno
+@cindex coda
+@cindex varcoda
+
+He aquí un cuadro que muestra todas las articulaciones disponibles:
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+
+@commonprop
+
+El orden vertical de las articulaciones se controla con la propiedad
+@code{script-priority}.  Cuanto más bajo es esta número,
+más cerca de la nota se colocará.
+En este ejemplo el @internalsref{TextScript} (el símbolo de sostenido) tiene primero la
+prioridad más baja, así que se coloca en la parte más baja en el primer ejemplo.
+En el segundo, el semitrino (el @internalsref{Script}) tiene la prioridad más baja, por tanto
+se coloca en la parte interior.  Cuando dos objetos tienen la misma prioridad, el orden en que
+se escriben decide cuál de ellos va primero.
+
+@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
+\once \override TextScript #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+
+\once \override Script #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{Script}.
+
+
+@refbugs
+
+Estos signos aparecen en la salida impresa pero no tienen ningún efecto sobre la
+representación de MIDI de la música.
+
+
+@node Dynamics
+@unnumberedsubsubsec Dynamics
+
+@cindex Dynamics
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
+
+Las marcas dinámicas de matiz absoluto se especifican usando un comando después de una nota:
+@code{c4\ff}.  Las marcas dinámicas disponibles son @code{\ppppp},
+@code{\pppp}, @code{\ppp},
+@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
+@code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
+@code{\sp}, @code{\spp}, @code{\sfz} y @code{\rfz}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
+c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
+@end lilypond
+
+@funindex \<
+@funindex \>
+@funindex \!
+
+Un regulador de crescendo se comienza con @code{\<} y se termina con
+@code{\!} o con un matiz absoluto.  Un regulador decrescendo comienza con
+@code{\>} y se termina también con @code{\!} o con un matiz dinámico
+absoluto.  Se pueden usar @code{\cr} y @code{\decr} en lugar de
+@code{\<} y @code{\>}.  A causa de que estas marcas se unen a notas, se deben
+usar notas espaciadoras si se necesitan varias marcas durante una nota.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\< c\! d\> e\!
+<< f1 { s4 s4\< s4\! \> s4\! } >>
+@end lilypond
+
+@noindent
+Un regulador comienza normalmente en el borde izquierdo de la nota inicial
+y acaba en el borde derecho de la nota final.  Si la nota
+final cae sobre el principio de un compás,  el regulador finaliza en la línea divisoria
+inmediatamente anterior.  Esto se puede modificar estableciendo la propiedad
+@code{hairpinToBarline},
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set hairpinToBarline = ##f
+c4\< c2. c4\!
+@end lilypond
+
+En algunas situaciones, la marca de articulación @code{\espressivo} puede ser
+apropiada para indicar un crescendo y decrescendo sobre una nota,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c2 b4 a g1\espressivo
+@end lilypond
+
+Esto puede dar lugar a reguladores muy cortos.  Utilice @code{minimum-length}
+dentro de @internalsref{Voice}.@internalsref{Hairpin} para alargarlos, por
+ejemplo
+
+@example
+\override Voice.Hairpin #'minimum-length = #5
+@end example
+
+@cindex al niente
+@cindex niente, al
+
+Los reguladores se pueden imprimir con la punta en círculo (notación
+al niente) estableciendo la propiedad @code{circled-tip},
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
+@cindex crescendo
+@cindex decrescendo
+@cindex diminuendo
+
+También puede usar texto que diga @emph{cresc.} en vez de reguladores
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\setTextCresc
+c\< d e f\!
+\setHairpinCresc
+e\> d c b\!
+\setTextDecresc
+c\> d e f\!
+\setTextDim
+e\> d c b\!
+@end lilypond
+
+Asimismo puede aportar sus propios textos
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\set crescendoText = \markup { \italic "cresc. poco" }
+\set crescendoSpanner = #'dashed-line
+a'2\< a a a\!\mf
+@end lilypond
+
+Para crear nuevas indicaciones dinámicas o texto que se deba alinear
+con los matices, consulte @ref{New dynamic marks}.
+
+El posicionamiento vertical de las expresiones dinámicas se gestiona a
+través de @internalsref{DynamicLineSpanner}.
+
+
+@commonprop
+
+Las expresiones dinámicas que suceden en, comienzan sobre, o acaban
+en, la misma nota se alinearán verticalmente.  Si quiere asegurar que
+las expresiones dinámicas se alinean cuando no suceden sobre la misma
+nota, puede aumentar el valor de la propiedad @code{staff-padding}.
+
+@example
+\override DynamicLineSpanner #'staff-padding = #4
+@end example
+
+También puede utilizar esta propiedad si las expresiones dinámicas
+colisionan con otros elementos de la notación.
+
+Los crescendi y decrescendi que acaban sobre la misma nota de una
+línea nueva no se imprimen.  Para cambiar este comportamiento, utilice
+
+@example
+\override Score.Hairpin #'after-line-breaking = ##t
+@end example
+
+Los cambios dinámicos de tipo texto (como @emph{cresc.} y @emph{dim.})
+se imprimen con una línea de puntos que muestra su alcance.  Para
+evitar que se imprima esta línea, use
+
+@example
+\override DynamicTextSpanner #'dash-period = #-1.0
+@end example
+
+
+@refcommands
+
+@funindex \dynamicUp
+@code{\dynamicUp},
+@funindex \dynamicDown
+@code{\dynamicDown},
+@funindex \dynamicNeutral
+@code{\dynamicNeutral}.
+
+
+@seealso
+
+Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
+El posicionamiento vertical de estos símbolos se maneja por medio de
+@internalsref{DynamicLineSpanner}.
+
+
+@node Curves
+@subsection Curves
+
+@menu
+* Ties::                        
+* Slurs::                       
+* Phrasing slurs::              
+* Laissez vibrer ties::         
+* Breath marks::                
+* Falls and doits::             
+@end menu
+
+@node Ties
+@unnumberedsubsubsec Ties
+
+@cindex ligadura de unión
+@funindex ~
+
+Una ligadura de unión conecta dos notas adyacentes de la misma altura.  La ligadura
+en efecto extiende la longitud de una nota.  No deben confundirse las ligaduras de unión con
+las ligaduras de expresión, que indican articulación, ni con las ligaduras de fraseo, que indican
+el fraseo musical.  Se introduce una ligadura de unión usando el símbolo de la tilde curva @samp{~}
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+e' ~ e' <c' e' g'> ~ <c' e' g'>
+@end lilypond
+
+Cuando se aplica una ligadura de unión a un acorde, se conectan todas las cabezas de las notas cuyas alturas coinciden.
+Si no coincide ningún par de cabezas, no se crea ninguna ligadura.  Los acordes
+se pueden ligar parcialmente colocando la ligadura dentro del acorde,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+<c~ e g~ b> <c e g b>
+@end lilypond
+
+Una ligadura es simplemente una forma de extender la duración de una nota, parecida al
+puntillo.  El ejemplo siguiente muestra dos formas de escribir
+exactamente el mismo concepto:
+
+@lilypond[quote,fragment,ragged-right]
+\time 3/4 c'2. c'2 ~ c'4
+@end lilypond
+
+@noindent
+Se usan ligaduras de expresión bien cuando la nota atraviesa la barra
+de compás o bien cuando no se pueden usar puntillos para denotar el
+ritmo.  Cuando se usan ligaduras, las notas de mayor duración se deben alinear con las subdivisiones del compás, como
+
+@lilypond[fragment,quote,ragged-right]
+\relative {
+  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
+}
+@end lilypond
+
+Si necesita unir muchas notas a través de las líneas divisorias, puede
+resultar más fácil utilizar la división automática de notas (vea
+@ref{Automatic note splitting}).  Este mecanismo divide las notas
+largas de forma automática y las liga a través de las barras de compás.
+
+@funindex \repeatTie
+
+Cuando la segunda vez de una repetición comienza con una nota ligada,
+es necesario repetir la ligadura.  Esto se puede conseguir mediante @code{\repeatTie},
+
+@lilypond[fragment,quote,ragged-right,relative=2]
+r <c e g>\repeatTie
+@end lilypond
+
+@cindex ligaduras de repetición
+@cindex corchetes de repetición de primera y segunda vez y ligaduras
+
+@commonprop
+
+A veces se usan ligaduras para escribir arpegios.  En este caso, dos notas ligadas no
+necesitan ser consecutivas.  Esto se puede conseguir estableciendo la propiedad @code{tieWaitForNote}
+(ligadura - esperar nota) al valor verdadero. La misma funcionalidad puede resultar útil,
+por ejemplo, para ligar un trémolo a un acorde.  Por ejemplo,
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+\set tieWaitForNote = ##t
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat tremolo 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
+@end lilypond
+
+Las ligaduras de pueden grabar manualmente modificando la propiedad
+@code{tie-configuration}.  El primer número indica la distancia desde
+el centro del pentagrama en espacios de pentagrama, y el segundo
+número indica la dirección (1 = hacia arriba, -1 = hacia abajo).
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+<c e g>2~ <c e g> |
+\override TieColumn #'tie-configuration =
+  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
+<c e g>~ <c e g> |
+@end lilypond
+
+
+@refcommands
+
+
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
+
+
+@seealso
+
+En el presente manual: @ref{Automatic note splitting}.
+
+Referencia del programa: @internalsref{Tie}.
+
+
+@refbugs
+
+Un cambio de pentagrama cuando hay una ligadura activa no producirá una ligadura inclinada.
+
+Los cambios de clave o de octava durante una ligadura de unión no
+están bien definidos realmente.  En estos casos puede ser preferible una ligadura de expresión.
+
+
+@node Slurs
+@unnumberedsubsubsec Slurs
+
+@cindex Ligaduras de expresión
+
+Una ligadura de expresión indica que las notas se deben tocar unidas o
+@emph{legato}.  Se escriben utilizando paréntesis
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+f( g a) a8 b( a4 g2 f4)
+<c e>2( <b d>2)
+@end lilypond
+
+La dirección de una ligadura de expresión se puede especificar con
+@code{\slur@emph{DIRECCIÓN}}, donde @code{@emph{DIRECCIÓN}} es o bien
+@code{Up} (arriba), @code{Down} (abajo), o @code{Neutral}
+(seleccionada automáticamente).
+
+Sin embargo, hay una forma abreviada muy conveniente para forzar las
+direcciones de las ligaduras de expresión.  Escribiendo @code{_} o
+@code{^} antes de los paréntesis de apertura, también se establece la dirección.  Por ejemplo,
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_( c) c^( c)
+@end lilypond
+
+Se puede imprimir una sola ligadura cada vez.  Si necesita imprimir
+una ligadura larga por encima de varias ligaduras más cortas, consulte @ref{Phrasing slurs}.
+
+
+@commonprop
+
+Algunos compositores escriben dos ligaduras cuando quieren acordes
+legato.  Esto se consigue en LilyPond mediante el establecimiento de @code{doubleSlurs},
+
+@lilypond[verbatim,ragged-right,relative,fragment,quote]
+\set doubleSlurs = ##t
+<c e>4 ( <d f> <c e> <d f> )
+@end lilypond
+
+
+@refcommands
+
+@funindex \slurUp
+@code{\slurUp},
+@funindex \slurDown
+@code{\slurDown},
+@funindex \slurNeutral
+@code{\slurNeutral},
+@funindex \slurDashed
+@code{\slurDashed},
+@funindex \slurDotted
+@code{\slurDotted},
+@funindex \slurSolid
+@code{\slurSolid}.
+
+@seealso
+
+Referencia del programa: @internalsref{Slur}.
+
+
+@node Phrasing slurs
+@unnumberedsubsubsec Phrasing slurs
+
+@cindex ligaduras de fraseo
+@cindex marcas de fraseo
+
+Una ligadura de fraseo (o marca de fraseo) conecta las notas y se
+utiliza para indicar una frase musical.  Se escribe usando @code{\(} y
+@code{\)} respectivamente
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+\time 6/4 c'\( d( e) f( e) d\)
+@end lilypond
+
+Tipográficamente, la ligadura de fraseo se comporta casi exactamente
+igual que una ligadura de expresión normal.  Sin embargo, se tratan
+como objetos diferentes.  Una @code{\slurUp} no tendrá ningún efecto sobre una ligadura de fraseo; utilice en su lugar
+@code{\phrasingSlurUp}, @code{\phrasingSlurDown}, y
+@code{\phrasingSlurNeutral}.
+
+No se pueden tener varias ligaduras de fraseo simultáneas.
+
+
+@refcommands
+
+@funindex \phrasingSlurUp
+@code{\phrasingSlurUp},
+@funindex \phrasingSlurDown
+@code{\phrasingSlurDown},
+@funindex \phrasingSlurNeutral
+@code{\phrasingSlurNeutral}.
+
+
+@seealso
+
+Referencia del programa: @internalsref{PhrasingSlur}.
+
+
+@node Laissez vibrer ties
+@unnumberedsubsubsec Laissez vibrer ties
+@cindex Laissez vibrer
+@cindex Ligaduras laissez vibrer
+
+Las ligaduras L.v. (laissez vibrer, dejar vibrar) indican que las
+notas no se deben apagar al final.  Se usan en la notación para piano,
+arpa y otros instrumentos de cuerda y percusión.  Se pueden introducir escribiendo @code{\laissezVibrer},
+
+@lilypond[fragment,ragged-right,verbatim,relative=1]
+<c f g>\laissezVibrer
+@end lilypond
+
+@seealso
+
+Referencia del programa:
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+Archivos de ejemplo:
+@lsr{connecting,laissez-vibrer-ties.ly}
+
+
+@node Breath marks
+@unnumberedsubsubsec Breath marks
+
+Las marcas de respiración se introducen usando @code{\breathe}
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c'4 \breathe d4
+@end lilypond
+
+
+@commonprop
+
+El glifo de la marca de respiración se puede ajustar por medio de la sobreescritura de la propiedad
+@code{text} del objeto de presentación @code{BreathingSign} con cualquier texto de marcado.
+Por ejemplo,
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+c'4
+\override BreathingSign #'text
+  = #(make-musicglyph-markup "scripts.rvarcomma")
+\breathe
+d4
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{BreathingSign}.
+
+Ejemplos: @lsr{expressive,breathing-sign.ly}
+
+
+@node Falls and doits
+@unnumberedsubsubsec Falls and doits
+
+Se pueden expresar caídas y subidas de tono (falls y doits) añadidas a
+las notas mediante el comando @code{\bendAfter},
+
+@lilypond[fragment,ragged-right,relative=2]
+\override Score.SpacingSpanner #'shortest-duration-space = #3.0
+c4-\bendAfter #+5
+c4-\bendAfter #-3
+@end lilypond
+
+
+@node Lines
+@subsection Lines
+
+@menu
+* Glissando::                   
+* Arpeggio::                    
+* Trills::                      
+* Analysis brackets::           
+@end menu
+
+@node Glissando
+@unnumberedsubsubsec Glissando
+
+@cindex Glissando
+@funindex \glissando
+
+Un glissando es un cambio gradual en la altura.  Se denota por medio
+de una línea o una línea ondulada entre dos notas.  Se llama
+adjuntando @code{\glissando} a una nota
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+c2\glissando c'
+\override Glissando #'style = #'zigzag
+c2\glissando c,
+@end lilypond
+
+
+@commonprop
+
+@lilypond[quote,ragged-right,verbatim]
+I = \once \override NoteColumn #'ignore-collision = ##t
+
+\relative <<
+  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
+  { \oneVoice \I c2 \glissando \I d, }
+>>
+@end lilypond
+
+
+
+@seealso
+
+Referencia del programa: @internalsref{Glissando}.
+
+Archivos de ejemplo:
+@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
+
+
+@refbugs
+
+La impresión de texto sobre la línea (como @emph{gliss.}) no está contemplada.
+
+
+@node Arpeggio
+@unnumberedsubsubsec Arpeggio
+
+@cindex Arpeggio
+@cindex acorde quebrado
+@funindex \arpeggio
+
+Se puede especificar un signo de arpegio (conocido también como acorde quebrado) sobre un
+acorde adjuntando un @code{\arpeggio} a un acorde
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+<c e g c>\arpeggio
+@end lilypond
+
+Un corchete recto a la izquierda indica que el intérprete no tiene que
+arpegiar el acorde
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\arpeggioBracket
+<c' e g c>\arpeggio
+@end lilypond
+
+La dirección del arpegio se denota a veces mediante la adición de una
+punta de flecha a la línea ondulada
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new Voice {
+  \arpeggioUp
+  <c e g c>\arpeggio
+  \arpeggioDown
+  <c e g c>\arpeggio
+}
+@end lilypond
+
+
+@commonprop
+
+Cuando un arpegio cruza uno o varios pentagramas, puede adjuntar un
+arpegio a los acordes en los dos pentagramas y establecer
+@internalsref{PianoStaff}.@code{connectArpeggios}
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \set PianoStaff.connectArpeggios = ##t
+  \new Staff { <c' e g c>\arpeggio }
+  \new Staff { \clef bass <c,, e g>\arpeggio }
+>>
+@end lilypond
+
+@c TODO: cross-voice arpeggio example?
+@c such an example is already in LSR -J.Mandereau
+
+@refcommands
+
+@code{\arpeggio},
+@funindex \arpeggioUp
+@code{\arpeggioUp},
+@funindex \arpeggioDown
+@code{\arpeggioDown},
+@funindex \arpeggioNeutral
+@code{\arpeggioNeutral},
+@funindex \arpeggioBracket
+@code{\arpeggioBracket}.
+
+
+@seealso
+
+Manual de notación: @ref{Ties}, para escribir arpegios explícitamente.
+
+Referencia del programa: @internalsref{Arpeggio}.
+
+
+@refbugs
+
+No es posible mezclar arpegios conectados y no conectados en un
+@internalsref{PianoStaff} en el mismo instante de tiempo.
+
+
+@node Trills
+@unnumberedsubsubsec Trills
+
+Los trinos cortos se imprimen como una articulación normal; consulte @ref{Articulations}.
+
+Los trinos largos mantenidos se hacen con @code{\startTrillSpan} y
+@code{\stopTrillSpan},
+
+@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
+\new Voice {
+  << { c1 \startTrillSpan }
+     { s2. \grace { d16[\stopTrillSpan e] } } >>
+  c4 }
+@end lilypond
+
+@cindex Trinos con altura
+
+Los trinos que se tienen que ejecutar sobre notas especificadas
+explícitamente se pueden tipografiar con el comando @code{pitchedTrill},
+
+@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
+\pitchedTrill c4\startTrillSpan fis
+f\stopTrillSpan
+@end lilypond
+
+@noindent
+El primer argumento es la nota principal.  La altura de la segunda se
+imprime como una cabeza de nota sin plica entre paréntesis.
+
+
+@refcommands
+
+@code{\startTrillSpan},
+@funindex \startTrillSpan
+@code{\stopTrillSpan}.
+@funindex \stopTrillSpan
+
+
+@seealso
+
+Referencia del programa: @internalsref{TrillSpanner}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+@cindex corchetes
+@cindex fraseo, corchetes de
+@cindex musicológico, análisis
+@cindex notas, corchetes de agrupación de
+
+Los corchetes se usan en análisis musical para indicar las estructuras presentes en las piezas
+musicales.  LilyPond contempla una forma básica de corchetes horizontales anidados.
+Para usarlos, añada el grabador @internalsref{Horizontal_bracket_engraver}
+al contexto @internalsref{Staff}.  Un corchete se abre con
+@code{\startGroup} y se cierra con @code{\stopGroup}
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    c4\startGroup\startGroup
+    c4\stopGroup
+    c4\startGroup
+    c4\stopGroup\stopGroup
+  }
+  \layout {
+    \context {
+      \Staff \consists "Horizontal_bracket_engraver"
+}}}
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{HorizontalBracket}.
+
+
diff --git a/Documentation/es/user/fundamental.itely b/Documentation/es/user/fundamental.itely
new file mode 100644
index 0000000000..faf922b632
--- /dev/null
+++ b/Documentation/es/user/fundamental.itely
@@ -0,0 +1,40 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond-learning.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Fundamental concepts
+@chapter Fundamental concepts
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* File structure (introduction)::
+* How LilyPond files work::
+* Score is a single musical expression::
+@end menu 
+@node File structure (introduction)
+@section File structure (introduction)
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node How LilyPond files work
+@section How LilyPond files work
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Score is a single musical expression
+@section Score is a single musical expression
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+-- SKELETON FILE --
+When you actually translate this file, please remove these lines as
+well as all `UNTRANSLATED NODE: IGNORE ME' lines.
diff --git a/Documentation/es/user/guitar.itely b/Documentation/es/user/guitar.itely
new file mode 100644
index 0000000000..783a1704cf
--- /dev/null
+++ b/Documentation/es/user/guitar.itely
@@ -0,0 +1,356 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Guitar
+@section Guitar
+
+@cindex tablatura
+@cindex guitarra, tablatura de
+
+@menu 
+* Guitar TODO::
+@end menu
+
+@node Guitar TODO
+@subsection Guitar TODO
+
+@menu
+* String number indications::   
+* Tablatures basic::            
+* Non-guitar tablatures::       
+* Banjo tablatures::            
+* Fret diagrams::               
+* Right hand fingerings::       
+* Other guitar issues::         
+@end menu
+
+@node String number indications
+@unnumberedsubsubsec String number indications
+
+@cindex Cuerda, número de la
+
+Los números de cuerda se pueden añadir a los acordes especificándolos mediante
+@code{\}@var{número},
+
+@lilypond[relative,relative=1,ragged-right,fragment]
+<c\1 e\2 g\3>
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.
+
+
+@node Tablatures basic
+@unnumberedsubsubsec Tablatures basic
+@cindex Tablatura, principios básicos
+
+La notación de tablatura se utiliza para la notación de música de instrumentos de cuerda
+pulsada.  Las alturas no se denotan mediante cabezas de nota, sino mediante
+números que indican sobre qué cuerda y traste se debe tocar la nota.  LilyPond
+contempla las tablaturas de forma limitada.
+
+El número de cuerda asociado a una nota se proporciona en la forma de una barra invertida
+seguida por un número, p.ej. @code{c4\3} es un Do negra sobre la tercera cuerda.
+Por defecto, la cuerda 1 es la más aguda, y la afinación normal
+es la afinación estándar de guitarra (con 6 cuerdas).  Las notas
+se imprimen como tablatura, usando lo contextos @internalsref{TabStaff} y
+@internalsref{TabVoice}
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff {
+  a,4\5 c'\2 a\3 e'\1
+  e\4 c'\2 a\3 e'\1
+}
+@end lilypond
+
+@funindex minimumFret
+@cindex traste
+
+Cuando no se especifica ninguna cuerda, se selecciona la primera cuerda que no da un
+número de traste menor de @code{minimumFret} (traste mínimo).  El valor por defecto
+de @code{minimumFret} es cero
+
+
+@example
+e16 fis gis a b4
+\set TabStaff.minimumFret = #8
+e16 fis gis a b4
+@end example
+@lilypond[quote,ragged-right]
+frag = {
+  \key e \major
+  e16 fis gis a b4
+  \set TabStaff.minimumFret = #8
+  e16 fis gis a b4
+}
+  \new StaffGroup <<
+    \new Staff { \clef "G_8" \frag }
+    \new TabStaff { \frag }
+  >>
+@end lilypond
+
+
+@commonprop
+
+Para imprimir tablaturas con las plicas hacia abajo y barras horizontales,
+inicialice el @code{TabStaff} (pentagrama de tablatura) con el código siguiente:
+
+@example
+\stemDown
+\override Beam #'damping = #100000
+@end example
+
+@seealso
+
+Referencia del programa: @internalsref{TabStaff}, @internalsref{TabVoice}.
+
+@refbugs
+
+Los acordes no se tratan de una manera especial, de aquí que el
+selector automático de cuerdas podría fácilmente seleccionar la misma cuerda para dos notas
+dentro del mismo acorde.
+
+Para manejar @code{\partcombine}, una pauta de tablatura @code{TabStaff} debe usar
+voces creadas especialmente:
+
+@lilypond[quote,ragged-right,verbatim]
+melodia = \partcombine { e4 g g g }{ e4 e e e }
+<<
+  \new TabStaff <<
+    \new TabVoice = "one" s1
+    \new TabVoice = "two" s1
+    \new TabVoice = "shared" s1
+    \new TabVoice = "solo" s1
+    { \melodia }
+  >>
+>>
+@end lilypond
+
+
+@node Non-guitar tablatures
+@unnumberedsubsubsec Non-guitar tablatures
+@cindex Tablaturas para instr. distintos de la guitarra
+
+Puede cambiar la afinación de las cuerdas. Una afinación de cuerdas se da como
+una lista en lenguaje Scheme con un número entero para cada cuerda, donde el número
+es la altura (medida en semitonos desde el Do central) de una
+cuerda al aire.  Los números especificados para @code{stringTunings} son la
+cantidad de semitonos que se deben restar o añadir, comenzando por la altura especificada
+que por defecto es el Do central, y en el orden de las cuerdas.  LilyPond calcula automáticamente
+el número de cuerdas leyendo @code{stringTunings}.
+
+En el ejemplo siguiente,
+@code{stringTunings} se establece a los valores Mi, La, Re y Sol
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
+  {
+    a,4 c' a e' e c' a e'
+  }
+>>
+@end lilypond
+
+LilyPond tiene afinaciones predefinidas para el banjo, la mandolina, la guitarra
+y el bajo eléctrico.
+
+@example
+\set TabStaff.stringTunings = #bass-tuning
+@end example
+
+La afinación por omisión es @code{guitar-tuning} (la afinación estándar
+Mi-La-Re-Sol-Si-Mi).
+Otras afinaciones predefinidas son @code{guitar-open-g-tuning} (Sol Mayor al aire, Re-Sol-Re-Sol-Si-Re),
+@code{mandolin-tuning} (mandolina) y @code{banjo-open-g-tuning} (banjo con Sol Mayor al aire).
+
+@seealso
+
+El archivo @file{scm/@/output@/-lib@/.scm} contiene las afinaciones predefinidas
+de las cuerdas.
+Referencia del programa: @internalsref{Tab_note_heads_engraver}.
+
+@refbugs
+
+No se ha implementado ningún efecto especial de guitarra.
+
+
+
+@node Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
+@cindex Banjo, tablaturas de
+
+LilyPond contempla el banjo de cinco cuerdas de una manera básica.  Cuando haga tablaturas
+para banjo de cinco cuerdas, utilice la función de formato de tablatura de banjo para obtener
+los números correctos
+de los trastes para la quinta cuerda:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
+  \set TabStaff.stringTunings = #banjo-open-g-tuning
+  {
+    \stemDown
+    g8 d' g'\5 a b g e d' |
+    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
+    g4
+  }
+>>
+@end lilypond
+
+En LilyPond se encuentran predefinidas varias afinaciones comunes para el banjo:
+@code{banjo-c-tuning} (sol-Do-Sol-Si-Re), @code{banjo-modal-tuning} (sol-Re-Sol-Do-Re),
+@code{banjo-open-d-tuning} (Re Mayor al aire, la-Re-Fa#-La-Re) y @code{banjo-open-dm-tuning}
+(Re menor al aire, la-Re-Fa-La-Re).
+
+Estas afinaciones se pueden convertir a afinaciones para bajo de cuatro cuerdas utilizando la
+función @code{four-string-banjo}:
+
+@example
+\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
+@end example
+
+@seealso
+
+El archivo @file{scm/@/output@/-lib@/.scm} contiene las afinaciones predefinidas para el banjo.
+
+
+@node Fret diagrams
+@unnumberedsubsubsec Fret diagrams
+@cindex trastes, diagramas de
+@cindex acordes, diagramas de
+
+Se pueden añadir diagramas de trastes a la música como elementos de marcado sobre la nota deseada.  El
+marcado contiene información sobre el diagrama de trastes deseado, tal y como se  muestra en el
+ejemplo siguiente
+
+@lilypond[verbatim, ragged-right, quote]
+\new Voice {
+  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d' d' d'
+  fis'^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  fis' fis' fis'
+  c'^\markup \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+  c' c' c'
+}
+@end lilypond
+
+
+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}.
+
+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
+@internalsref{fret-diagram-interface}.
+
+
+@seealso
+
+Ejemplos: @lsrdir{guitar}
+
+
+@node Right hand fingerings
+@unnumberedsubsubsec Right hand fingerings
+
+Se pueden introducir las digitaciones de la mano derecha de los acordes, usando
+@code{@var{nota}-\rightHandFinger @var{dedo}}
+
+@lilypond[verbatim,fragment,relative=2]
+  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+@end lilypond
+
+Por brevedad, es posible abreviar @code{\rightHandFinger} como algo más corto,
+como por ejemplo @code{RH},
+
+@example
+#(define RH rightHandFinger)
+@end example
+
+@cindex digitaciones, mano derecha, de guitarra
+@cindex mano derecha, digitaciones para guitarra
+ 
+@commonprop
+
+Puede ejercer un mayor control sobre las digitaciones de la mano derecha estableciendo
+@code{strokeFingerOrientations},
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(up down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+  \set strokeFingerOrientations = #'(up right down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+}
+@end lilypond
+
+Las letras utilizadas para las digitaciones se encuentran contenidas dentro de la propiedad
+@code{digit-names} (nombres de los dedos), pero también se pueden fijar individualmente aportando a
+@code{\rightHandFinger} un argumento de cadena, como en el ejemplo siguiente
+
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(right)
+  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
+  <c-\RH #5 >4
+  <c-\RH "@">4  
+}
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{StrokeFinger}
+
+
+
+@node Other guitar issues
+@unnumberedsubsubsec Other guitar issues
+
+Este ejemplo muestra cómo incluir indicaciones de posición y cejilla
+de guitarra:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
+\clef "G_8"
+b16 d16 g16 b16 e16
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text = #"XII "
+  g16\startTextSpan
+  b16 e16 g16 e16 b16 g16\stopTextSpan
+e16 b16 g16 d16
+@end lilypond
+
+
+Las cabezas en aspa (X) se utilizan en la música de guitarra para indicar el lugar donde el
+guitarrista debe tocar una determinada nota o acorde, con sus dedos apenas
+tocando las cuerdas en lugar de pisarlas por completo.  Esto produce en el sonido un carácter
+percusivo y ruidoso, sin perder la altura de la nota
+original.  Su notación se realiza con cabezas en equis; se muestra
+en @ref{Special noteheads}.
+
+
diff --git a/Documentation/es/user/instrument-notation.itely b/Documentation/es/user/instrument-notation.itely
deleted file mode 100644
index 430449d79e..0000000000
--- a/Documentation/es/user/instrument-notation.itely
+++ /dev/null
@@ -1,4757 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: 90541cc59a99d0b53baccedc0327748b760fce68
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Instrument-specific notation
-@chapter Instrument-specific notation
-
-Este capítulo explica cómo hacer notación para instrumentos específicos.
-
-@menu
-* Piano music::                 
-* Chord names::                 
-* Vocal music::                 
-* Rhythmic music::              
-* Guitar::                      
-* Bagpipe::                     
-* Ancient notation::            
-* Other instrument specific notation::  
-@end menu
-
-
-
-@node Piano music
-@section Piano music
-
-Los sistemas de piano son dos pentagramas normales agrupados mediante una llave.  Los pentagramas
-son hasta cierto punto independientes, pero a veces las voces pueden cruzarse entre los
-dos pentagramas.  También se utiliza esta notación para otros instrumentos de teclado y para el
-arpa.  El @internalsref{PianoStaff} está preparado especialmente para
-manejar este comportamiento de cruce de pentagramas.  En esta sección trataremos el
-@internalsref{PianoStaff} y alguna que otra peculiaridad pianística.
-
-@menu
-* Automatic staff changes::     
-* Manual staff switches::       
-* Pedals::                      
-* Staff switch lines::          
-* Cross staff stems::           
-@end menu
-
-@refbugs
-
-Los matices no se colocan centrados, pero se pueden utilizar ciertas alternativas.  Consulte la
-plantilla @q{piano con matices centrados} que está en @ref{Piano templates}.
-
-@cindex plica de pentagrama cruzado
-@cindex pentagrama cruzado, plica de
-@cindex distancia entre pentagramas en música de piano
-
-
-@node Automatic staff changes
-@subsection Automatic staff changes
-@cindex Cambio automático de pentagrama
-
-Se puede hacer que las voces cambien automáticamente entre los pentagramas inferior y
-superior.  La sintaxis para conseguir esto es
-
-@quotation
-@example
-\autochange @dots{}@var{música}@dots{}
-@end example
-@end quotation
-
-@noindent
-Esto creará dos pentagramas dentro del PianoStaff actual, llamados
-@code{up} (arriba) y @code{down} (abajo).  El pentagrama inferior estará en clave de Fa por
-omisión.
-
-Una sección marcada @code{\relative} que se encuentra fuera de @code{\autochange} no tiene
-efecto sobre las notas de la @var{música}, por tanto, en caso necesario escriba
-@code{\relative} dentro de @code{\autochange}, como en
-
-@quotation
-@example
-\autochange \relative @dots{} @dots{}
-@end example
-@end quotation
-
-
-El cambiador automático hace el cambio basándose en la altura (el Do central es el punto
-de inflexión), y se adelanta saltando sobre los silencios para hacer cambios por
-adelantado.  He aquí un ejemplo práctico
-
-@lilypond[quote,verbatim,ragged-right]
-\new PianoStaff
-  \autochange \relative c'
-  {
-    g4 a b c d r4 a g
-  }
-@end lilypond
-
-
-@seealso
-
-En este manual: @ref{Manual staff switches}.
-
-Referencia del programa: @internalsref{AutoChangeMusic}.
-
-
-
-@refbugs
-
-Los cambios de pentagrama pueden no acabar en lugares óptimos.  Para conseguir
-una salida de alta calidad es mejor especificar manualmente los cambios de pentagrama.
-
-
-@code{\autochange} no puede estar dentro de @code{\times}.
-
-
-@node Manual staff switches
-@subsection Manual staff switches
-
-@cindex manual, cambio de pentagrama
-@cindex pentagrama, cambios manuales de
-
-Las voces se pueden cambiar de pentagrama manualmente usando la instrucción
-@example
-\change Staff = @var{nombre_del_pentagrama} @var{música}
-@end example
-
-@noindent
-La cadena @var{nombre_del_pentagrama} es el nombre del pentagrama.  Cambia la
-voz actual de su pentagrama en curso al pentagrama de nombre
-@var{nombre_del_pentagrama}.  Por lo común @var{nombre_del_pentagrama} es @code{"up"} o
-@code{"down"}.  El @context{Staff} referido debe existir previamente, por ello
-normalmente la preparación de una partitura empezará por la preparación de los pentagramas,
-
-@example
-<<
-  \new Staff = "up" @{
-    \skip 1 * 10  % @emph{mantener vivo el pentagrama}
-    @}
-  \new Staff = "down" @{
-    \skip 1 * 10  % @emph{ídem}
-    @}
->>
-@end example
-
-
-y la @context{Voice} se inserta con posterioridad
-
-@example
-\context Staff = down
-  \new Voice @{ @dots{} \change Staff = up @dots{} @}
-@end example
-
-
-@node Pedals
-@subsection Pedals
-@cindex Pedales
-
-El piano tiene pedales que alteran la forma en que se produce el sonido.  Generalmente un
-piano tiene tres pedales: derecho, una corda y tonal (en inglés: sustain, una corda y sostenuto).
-
-
-Se puede expresar una instrucción de pedal de piano adjuntando
-@code{\sustainDown}, @code{\sustainUp}, @code{\unaCorda},
-@code{\treCorde}, @code{\sostenutoDown} y @code{\sostenutoUp} a una
-nota o acorde
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c'4\sustainDown c'4\sustainUp
-@end lilypond
-
-Es posible modificar lo que se imprime estableciendo @code{pedal@var{X}Strings},
-donde @var{X} es uno de los tipos de pedal: @code{Sustain},
-@code{Sostenuto} o @code{UnaCorda}.  Consulte
-@internalsref{SustainPedal} dentro de la referencia del programa para más
-información.
-
-Los pedales se pueden indicar también mediante una secuencia de corchetes, estableciendo la
-propiedad @code{pedalSustainStyle} a objetos corchete
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'bracket
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-Un tercer estilo de notación de pedal es una mezcla de texto y corchetes,
-que se obtiene estableciendo la propiedad @code{pedalSustainStyle} a
-@code{mixed}
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'mixed
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-El estilo por defecto @q{*Ped.} para los pedales derecho y una corda corresponde al
-estilo @code{#'text}.  El pedal tonal usa el estilo @code{mixed} por
-defecto.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-Para hacer un ajuste fino del aspecto de un corchete de pedal, se pueden modificar las propiedades
-@code{edge-width}, @code{edge-height} y @code{shorten-pair} de los
-objetos @code{PianoPedalBracket} (véase
-@internalsref{PianoPedalBracket} en la Referencia del programa).
-Por ejemplo, el corchete se puede extender hasta el borde derecho de la
-cabeza de la nota
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-@seealso
-
-En este manual: @ref{Laissez vibrer ties}.
-
-@node Staff switch lines
-@subsection Staff switch lines
-
-
-@cindex seguimiento de voz
-@cindex pentagrama, cambio
-@cindex cruce de pentagramas
-
-@funindex followVoice
-
-Cuando una voz cambia a otro pentagrama, se puede imprimir automáticamente una línea
-que conecte las notas.  Esto se activa estableciendo
-@code{followVoice} a verdadero
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \new Staff="one" {
-    \set followVoice = ##t
-    c1
-    \change Staff=two
-    b2 a
-  }
-  \new Staff="two" { \clef bass \skip 1*2 }
->>
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{VoiceFollower}.
-
-@refcommands
-
-@funindex \showStaffSwitch
-@code{\showStaffSwitch},
-@funindex \hideStaffSwitch
-@code{\hideStaffSwitch}.
-
-
-@node Cross staff stems
-@subsection Cross staff stems
-
-Los acordes que cruzan pentagramas se pueden producir mediante el incremento de la longitud
-de la plica en el pentagrama inferior, de manera que alcance a la plica que está en el pentagrama
-superior, y viceversa.
-
-@lilypond[ragged-right,verbatim,quote]
-stemExtend = {
-  \once \override Stem #'length = #10
-  \once \override Stem #'cross-staff = ##t
-}
-noFlag = \once \override Stem #'flag-style = #'no-flag
-\new PianoStaff <<
-  \new Staff {
-    \stemDown \stemExtend
-    f'4
-    \stemExtend \noFlag
-    f'8
-  }
-  \new Staff {
-    \clef bass
-    a4 a8
-  }
->>
-@end lilypond
-
-
-
-@node Chord names
-@section Chord names
-
-@menu
-* Introducing chord names::     
-* Chords mode::                 
-* Printing chord names::        
-@end menu
-
-
-@c  awkward name; awkward section name.
-@c  still, the Basic "chords" seems like a good name...  :(
-@node Introducing chord names
-@subsection Introducing chord names
-@cindex acordes, nombres
-
-LilyPond tiene la capacidad de imprimir nombres de acordes.  Los acordes se pueden introducir
-en notación musical de acordes, es decir: @code{< .. >}, pero también se pueden
-introducir por su nombre.  Internamente los acordes se representan como un conjunto de
-notas, así que se pueden transportar
-
-
-@lilypond[quote,ragged-right,verbatim,ragged-right]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
-
-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
-@end lilypond
-
-Este ejemplo también muestra que las rutinas de impresión de acordes no tratan de
-ser inteligentes.  El último acorde (@code{f bes d}) no se interpreta como
-una inversión.
-
-Tenga en cuenta que la duración de los acordes se debe especificar fuera de los
-@code{<>}.
-
-@example
-<c e g>2
-@end example
-
-
-@node Chords mode
-@subsection Chords mode
-@cindex Acordes, modo de
-
-En el modo de acordes, se introducen conjuntos de notas o acordes con sus nombres usuales.
-Un acorde se introduce por su fundamental, que se escribe como una
-nota normal
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { es4. d8 c2 }
-@end lilypond
-
-@noindent
-El modo se inicia mediante la palabra clave @code{\chordmode}.
-
-@cindex acordes, introducción
-@cindex acordes, modo de
-
-Otros acordes se pueden escribir añadiendo al final dos puntos e introduciendo un
-modificador (que puede incluir un número si se desea)
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
-@end lilypond
-
-El primer número que sigue a la fundamental se toma como el @q{tipo} de
-acorde, las terceras se añaden a la fundamental hasta que se alcanza el número
-especificado. La excepción es @code{c:13}, para el que se omite el 11.
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
-@end lilypond
-
-@cindex fundamental de un acorde
-@cindex adiciones, en acordes
-@cindex omisiones, en acordes
-
-También se pueden construir acordes más complejos añadiendo elementos separados
-a un acorde.  Las adiciones se escriben después del número que sigue
-a los dos puntos y van separadas por puntos
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
-@end lilypond
-
-Los elementos de un acorde se pueden alterar añadiendo un signo de @code{-} ó @code{+}
-al número
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
-@end lilypond
-
-Las omisiones se especifican de forma similar y se escriben mediante un circunflejo.  Deben
-ir después de las adiciones
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c^3 c:7^5 c:9^3.5 }
-@end lilypond
-
-Se pueden usar modificadores para cambiar la altura de las notas.  Están previstos los siguientes
-modificadores
-
-@table @code
-@item m
-El acorde menor.  Este modificador baja la tercera y (si está presente) la séptima.
-
-@item dim
-El acorde disminuido.  Este modificador baja la tercera, la quinta y (si está presente)
-la séptima.
-
-@item aug
-El acorde aumentado.  Este modificador eleva la quinta.
-
-@item maj
-El acorde de séptima mayor.  Este modificador eleva la séptima si está presente.
-
-@item sus
-El acorde suspendido de cuarta o de segunda.  Este modificador suprime la tercera.
-Escriba @code{2} ó @code{4} para añadir la segunda o la cuarta al
-acorde.
-@end table
-
-Se pueden mezclar modificadores con adiciones
-@lilypond[quote,verbatim,fragment]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
-@end lilypond
-
-@cindex modificadores, en acordes
-@funindex aug
-@funindex dim
-@funindex maj
-@funindex sus
-@funindex m
-
-Puesto que una 11ª sin alterar no suena bien cuando se combina con una
-13ª sin alterar, la 11ª se suprime en este caso (a no ser que se añada de forma
-explícita)
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
-@end lilypond
-
-@funindex /
-
-Se puede especificar una inversión (colocar en el bajo una nota del acorde), así como
-notas del bajo, añadiendo
-@code{/}@var{pitch} al acorde
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/g c/f }
-@end lilypond
-@funindex /+
-
-Un bajo se puede añadir en lugar de moverlo dentro del mismo acorde,
-mediante @code{/+}@var{pitch}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/+g c/+f }
-@end lilypond
-
-El modo de acordes es similar a @code{\lyricmode} y demás.  La mayoría de
-los comandos siguen funcionando, por ejemplo se pueden usar @code{r} y
-@code{\skip} para insertar silencios y espacios, y las instrucciones
-de propiedades se pueden usar para modificar ciertos valores.
-
-
-
-@refbugs
-
-Cada nota sólo se puede presentar una vez dentro del acorde.  Lo siguiente
-simplemente produce el acorde aumentado, ya que el @code{5+} se interpreta en
-último lugar
-@cindex racimos (clusters)
-@lilypond[quote,ragged-right,verbatim,fragment]
-\chordmode { c:5.5-.5+ }
-@end lilypond
-
-
-@node Printing chord names
-@subsection Printing chord names
-
-@cindex impresión de los nombres de acorde
-@cindex acordes, nombres de
-@cindex acordes
-
-Para la presentación de los nombres de acordes impresos utilice el contexto @internalsref{ChordNames}.
-Los acordes se puede introducir o bien usando la notación
-descrita anteriormente, o directamente usando @code{<} y @code{>}
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
-}
-<<
-  \new ChordNames \harmonies
-  \new Staff \harmonies
->>
-@end lilypond
-
-Puede hacer que los cambios de acorde se hagan notar, estableciendo
-@internalsref{ChordNames}.@code{chordChanges} al valor verdadero.  Esto sólo 
-mostrará los nombres de los acordes cuando ocurra un cambio en la estructura de acordes y al comienzo
-de una línea
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
-}
-<<
-  \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
->>
-@end lilypond
-
-Todos los ejemplos anteriores muestran los acordes sobre una pauta.  Esto no es
-necesario.  Los acordes también se pueden imprimir por separado.  Puede ser necesario
-añadir @internalsref{Volta_engraver} y @internalsref{Bar_engraver}
-para mostrar las repeticiones.
-
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-size = #4
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
-}
-}
-@end lilypond
-
-
-La disposición por defecto de los nombres de acorde en la página es una pauta para el Jazz, propuesta por
-Klaus Ignatzek (véase @ref{Literature list}).  Se puede modificar a través de las
-siguientes propiedades
-
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-He aquí una lista de los acordes que tienen un formateo especial.
-
-La lista de excepciones se debe codificar como
-@example
-@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-
-La incorporación de esta información dentro de @code{chordNameExceptions} requiere algunas
-maniobras.  El código siguiente transforma @code{chExceptionMusic}
-(que es música secuencial) en una lista de excepciones.
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Después,
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
-añade las nuevas excepciones a las que existen de fábrica, que se encuentran definidas en
-@file{ly/@/chord@/-modifier@/-init@/.ly}.
-
-Para ver un ejemplo de cómo modificar esta propiedad, véase también
-@lsr{chords,chord@/-name@/-exceptions@/.ly}
-@cindex excepciones, nombres de acordes.
-
-
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Esta propiedad contiene el objeto de marcado usado para la séptima, cuando
-es mayor.  Las opciones predefinidas son @code{whiteTriangleMarkup} y
-@code{blackTriangleMarkup}.  Consulte
-@lsr{chords,chord@/-name@/-major7@/.ly} para ver un ejemplo.
-
-@funindex chordNameSeparator
-@item chordNameSeparator
-Las distintas partes de un acorde están separadas normalmente por una barra
-inclinada.  Estableciendo @code{chordNameSeparator}, puede especificar otros
-separadores, p.ej.
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
-}
-@end lilypond
-
-@funindex chordRootNamer
-@item chordRootNamer
-La fundamental de un acorde se imprime normalmente como una letra con una alteración
-opcional.  La transformación de nota a letra se hace por medio de esta función.
-Los nombres de nota especiales (por ejemplo, la @q{H} alemana para un
-acorde de Si) se puede producir almacenando una nueva función dentro de esta propiedad.
-
-@funindex chordNoteNamer
-@item chordNoteNamer
-La opción por defecto es imprimir una sola nota, p.ej. el bajo, usando el
-@code{chordRootNamer}.  La propiedad @code{chordNoteNamer} se puede establecer
-a una función especializada para cambiar este comportamiento.  Por ejemplo, la
-nota base se puede imprimir en minúsculas.
-
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-La @q{m} que de nota a los acordes menores se imprime normalmente justo después de la fundamental
-del acorde. Estableciendo @code{chordPrefixSpacer}, puede insertar un separador
-entre la fundamental y la @q{m}. El separador no se usa cuando la fundamental 
-está alterada.
-
-@end table
-
-Las variables predefinidas @code{\germanChords},
-@code{\semiGermanChords}, @code{\italianChords} y @code{\frenchChords}
-establecen estas variables.  El efecto se muestra
-a continuación:
-
-@lilypondfile[ragged-right]{chord-names-languages.ly}
-
-También se encuentran implementados otros dos esquemas de nombres de acorde: una
-notación de acordes alternativa para Jazz, y un esquema sistemático llamado acordes de Banter.  La
-notación alternativa de Jazz se muestra también en el cuadro @ref{Chord name
-chart}.  El resultado de la activación de estos estilos se muestra en
-@lsr{chords,chord-names-jazz.ly}.
-
-@cindex Banter
-@cindex jazz, acordes de
-@cindex acordes de jazz
-
-
-@refcommands
-
-@funindex \germanChords
-@code{\germanChords},
-@funindex \semiGermanChords
-@code{\semiGermanChords}.
-@funindex \italianChords
-@code{\italianChords}.
-@funindex \frenchChords
-@code{\frenchChords}.
-
-
-
-
-@seealso
-
-Ejemplos:
-@lsrdir{chords}
-
-Archivos de inicio: @file{scm/@/chords@/-ignatzek@/.scm} y
-@file{scm/@/chord@/-entry@/.scm}.
-
-
-@refbugs
-
-Los nombres de acorde se determinan exclusivamente a partir de la lista de notas.  No se identifican
-las inversiones de acorde ni las notas del bajo añadidas.  Esto puede
-dar como resultado nombres de acorde extraños cuando éstos se introducen con la
-sintaxis @code{< .. >}.
-
-
-
-@node Vocal music
-@section Vocal music
-
-Puesto que los archivos de entrada de LilyPond son de texto, hay un par de cuestiones dignas de
-consideración cuando se trabaja con música vocal:
-
-@itemize @bullet
-@item
-Los textos de las canciones se deben entrar como texto, no como notas.  Por ejemplo,
-la entrada@tie{}@code{d} se debe interpretar como una sílaba de una sola letra, no como la
-nota@tie{}Re.
-
-@item
-Los textos de las canciones se deben alinear con las notas respectivas de la melodía.
-@end itemize
-
-Existen varias formas diferentes de definir la letra; comenzaremos
-examinando el método más simple, y poco a poco iremos aumentando la complejidad.
-
-@menu
-* Setting simple songs::        
-* Entering lyrics::             
-* Aligning lyrics to a melody::  
-* Working with lyrics and identifiers::  
-* Flexibility in placement::    
-* Spacing lyrics::              
-* More about stanzas::          
-* Ambitus::                     
-* Other vocal issues::          
-@end menu
-
-
-@commonprop
-
-Las comprobaciones que aseguran que las indicaciones textuales y las letras se encuentran dentro de los márgenes
-es una tarea computacional relativamente grande.  Para acelerar el procesado, lilypond no realiza
-estos cálculos por defecto; para activarlos, utilice
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-Para hacer que la letra evite las líneas divisorias también, utilice
-@example
-\layout @{
-  \context @{
-    \Lyrics
-      \consists "Bar_engraver"
-      \consists "Separating_line_group_engraver"
-      \override BarLine #'transparent = ##t
-  @}
-@}
-@end example
-
-
-@node Setting simple songs
-@subsection Setting simple songs
-
-@cindex \addlyrics
-
-La manera más fácil de poner letra a una melodía es añadir
-
-@example
-\addlyrics @{ @var{la letra} @}
-@end example
-
-@noindent
-a la melodía.  He aquí un ejemplo:
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
-
-Se pueden añadir más versos mediante la adición de más 
-secciones @code{\addlyrics}
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
-
-La instrucción @code{\addlyrics} no puede manejar situaciones de polifonía.  Para estos
-casos tendrá que usar @code{\lyricsto} y @code{\lyricmode}, tal y como se explicará
-en @ref{Entering lyrics}.
-
-
-
-@node Entering lyrics
-@subsection Entering lyrics
-
-@cindex letra
-@funindex \lyricmode
-@cindex puntuación
-@cindex espacios, en la letra
-@cindex comillas, en la letra
-
-La letra de las canciones se introduce en un modo de entrada especial que se inicia
-mediante la palabra clave @code{\lyricmode}, o bien mediante @code{\addlyrics} ó
-@code{\lyricsto}.  En este modo puede introducir la letra,
-con puntuación y acentos, y el carácter @code{d} no se analiza como
-una nota, sino más bien como una sílaba de una sola letra.  Las sílabas se introducen
-como las notas, pero con texto en lugar de alturas de nota.  Por ejemplo,
-
-@example
-\lyricmode @{ Cam-4 pa-4 ni- ta del- lu- gar2 @}
-@end example
-
-Existen dos métodos principales para especificar la colocación horizontal
-de las sílabas, bien especificando la duración de cada sílaba
-de forma explícita, como en el ejemplo anterior, o bien alineando automáticamente
-la letra a la melodía o a cualquier otra voz, usando @code{\addlyrics}
-o @code{\lyricsto}.
-@c  TODO: broken
-@c For more details see @ref{The Lyrics context}.
-
-Una palabra o sílaba de la letra comienza con un carácter alfabético, y termina
-con
-cualquier espacio o dígito.  Los caracteres que siguen pueden ser cualesquiera excepto
-un dígito o un espacio.
-
-Cualquier carácter excepto un dígito o un espacio en blanco se considera
-parte de una sílaba; esto tiene una importante consecuencia, y es que
-una palabra puede terminar en @code{@}}, lo que con frecuencia conduce al siguiente error:
-
-@example
-\lyricmode @{ la- la@}
-@end example
-
-En este ejemplo, el símbolo @code{@}} se encuentra incluido dentro de la sílaba final, por tanto la
-llave de apertura no se compensa con la correspondiente llave de cierre y el archivo de entrada
-probablemente no se podrá procesar.
-
-
-@funindex \property dentro de \lyricmode
-
-@noindent
-De forma similar, un punto que sigue a una secuencia alfabética queda incluido dentro de
-la cadena resultante.  Como consecuencia, se deben insertar espacios antes y después de los
-comandos de propiedades: @emph{no} escriba
-
-@example
-\override Score.LyricText #'font-shape = #'italic
-@end example
-
-@noindent
-sino lo siguiente:
-
-@example
-\override Score . LyricText #'font-shape = #'italic
-@end example
-
-@funindex _
-@cindex espacios, en la letra
-@cindex comillas, en la letra
-@cindex ligaduras, en la letra
-
-Para asignar más de una sílaba a una única nota, puede
-rodearlas por comillas o usar un carácter @code{_} (guión bajo), para obtener espacios
-entre las sílabas, o usar el símbolo de tilde curva (@code{~}) para obtener una ligadura entre sílabas de la letra.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-La ligadura de texto se construye con el carácter Unicode U+203F, por tanto debe
-asegurarse de que tiene instalada una tipografía (como DejaVuLGC) que incluya este
-glifo.
-
-
-Para escribir letra con caracteres de una lengua no inglesa, o que tenga
-caracteres acentuados o especiales (como el símbolo del corazón o comillas inclinadas),
-introduzca simplemente los caracteres directamente en el archivo de entrada y guárdelo
-con una codificación utf-8.  Consulte @ref{Text encoding}, para ver más información.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative { e4 f e d e f e2 }
-\addlyrics { He said: “Let my peo ple go”. }
-@end lilypond
-
-Para utilizar comillas normales en la letra, escriba una barra invertida antes de las
-comillas.  Por ejemplo,
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
-\addlyrics { "\"I" am so lone- "ly\"" said she }
-@end lilypond
-
-La definición completa del comienzo de una palabra en el modo Lyrics (letra) es algo más
-compleja.
-
-Una palabra en el modo Lyrics comienza por: un carácter alfabético, @code{_},
-@code{?}, @code{!}, @code{:}, @code{'}, los caracteres de control desde @code{^A}
-hasta @code{^F}, desde @code{^Q} hasta @code{^W}, @code{^Y}, @code{^^},
-cualquier carácter de 8 bits con código ASCII por encima del 127, o una combinación de
-dos caracteres consistente en la combinación de una barra invertida seguida por @code{`}, @code{'},
-@code{"} ó @code{^}.
-
-Para definir identificadores que contengan letra, se debe usar la función
-@code{lyricmode}.
-
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
-  <<
-    \new Voice = "one" \relative c'' @{
-      \autoBeamOff
-      \time 2/4
-      c4 b8. a16 g4. f8 e4 d c2
-    @}
-    \addlyrics @{ \verseOne @}
-  >>
-@}
-@end example
-
-
-@seealso
-
-Referencia del programa: @internalsref{LyricText}, @internalsref{LyricSpace}.
-
-
-
-@node Aligning lyrics to a melody
-@subsection Aligning lyrics to a melody
-
-@funindex \lyricmode
-@funindex \addlyrics
-@funindex \lyricsto
-
-
-La letra se imprime a través de su interpretación dentro del contexto llamado
-@internalsref{Lyrics}.
-
-@example
-\new Lyrics \lyricmode @dots{}
-@end example
-
-Existen dos métodos principales para especificar la colocación horizontal
-de las sílabas:
-
-@itemize @bullet
-@item
-alineando automáticamente
-el texto a una melodía o a otra voz, utilizando @code{\addlyrics}
-o @code{\lyricsto}.
-
-@item
-o especificando la duración de cada sílaba
-explícitamente, utilizando @code{\lyricmode}
-@end itemize
-
-@menu
-* Automatic syllable durations::  
-* Another way of entering lyrics::  
-* Assigning more than one syllable to a single note::  
-* More than one note on a single syllable::  
-* Extenders and hyphens::       
-@end menu
-
-@node Automatic syllable durations
-@subsubsection Automatic syllable durations
-
-@cindex duraciones automáticas de las sílabas
-@cindex letra y melodías
-
-La letra se puede alinear automáticamente bajo una melodía
-dada.  Esto se consigue combinando la
-melodía y el texto con la expresión @code{\lyricsto}
-
-@example
-\new Lyrics \lyricsto @var{nombre} @dots{}
-@end example
-
-Esto alinea la letra a las
-notas del contexto de @internalsref{Voice} llamado @var{nombre}, que debe
-existir previamente.  Por ello la @code{Voice} normalmente se especifica en primer lugar, y
-después se especifica la letra con @code{\lyricsto}.  La instrucción
-@code{\lyricsto} cambia automáticamente al modo @code{\lyricmode}, por lo que la
-palabra clave @code{\lyricmode} se puede omitir.
-
-El ejemplo siguiente utiliza comandos diferentes para introducir la letra.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-<<
-  \new Voice = "one" \relative c'' {
-    \autoBeamOff
-    \time 2/4
-    c4 b8. a16 g4. f8 e4 d c2
-  }
-  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
-  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
-  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
->>
-@end lilypond
-
-El segundo verso no está bien alineado porque las duraciones
-no se han especificado.  Una solución para eso sería usar @code{\lyricsto}.
-
-El comando @code{\addlyrics} es realmente tan sólo una forma cómoda de
-escribir una estructura de LilyPond más complicada que establece la
-letra.
-
-@example
-@{ MÚSICA @}
-\addlyrics @{ LETRA @}
-@end example
-
-@noindent
-es lo mismo que
-
-@example
-\new Voice = "blabla" @{ MÚSICA @}
-\new Lyrics \lyricsto "blabla" @{ LETRA @}
-@end example
-
-@node Another way of entering lyrics
-@subsubsection Another way of entering lyrics
-
-El texto también se puede introducir sin @code{\addlyrics} ni
-@code{\lyricsto}.  En este caso,
-las sílabas se escriben como notas (pero con las alturas sustituidas por texto) y la
-duración de cada sílaba se debe escribir explícitamente.  Por ejemplo:
- 
-@example
-play2 the4 game2.
-sink2 or4 swim2.
-@end example
-
-La alineación respecto de una melodía se puede especificar con la
-propiedad @code{associatedVoice},
- 
-@example
-\set associatedVoice = #"lala"
-@end example
-
-@noindent
-El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
-un contexto de @internalsref{Voice}.  Sin este ajuste, las líneas de extensión
-no se formatearán correctamente.
- 
-Presentamos a continuación un ejemplo que muestra el uso de las duraciones manuales de las sílabas del texto:
-
-@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
-<< \new Voice = "melody" {
-    \time 3/4
-    c2 e4 g2.
- }
- \new Lyrics \lyricmode {
-   \set associatedVoice = #"melody"
-   play2 the4 game2.
- } >>
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{Lyrics}.
-
-
-@node Assigning more than one syllable to a single note
-@subsubsection Assigning more than one syllable to a single note
-
-
-@funindex _
-@cindex ligaduras, en el texto
-
-Para asignar más de una sílaba a una sola nota, puede
-encerrarlas entre comillas o utilizar un guión bajo (@code{_}), para dejar espacios
-entre las sílabas, o usar el símbolo de tilde curva (@code{~}) para obtener una ligadura en el
-texto@footnote{Las ligaduras de texto están hechas con el carácter de Unicode
-U+203F, por tanto
-debe asegurarse de tener instalada una tipografía (como DejaVuLGC) que incluya este
-glifo.}.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{LyricCombineMusic}.
-
-@c Here come the section which used to be "Melismata"
-@c the new title might be more self-explanatory
-
-
-@node More than one note on a single syllable
-@subsubsection More than one note on a single syllable
-
-@cindex melisma
-@cindex melismata
-@cindex fraseo, en la letra
-
-A veces, y sobre todo en la música medieval, varias notas se cantan sobre una
-sílaba única; tales vocalizaciones reciben el nombre de melismas, o melismata.
-
-@c this method seems to be the simplest; therefore
-@c it might be better to present it first - vv
-
-Puede definir los melismas completamente dentro de la letra, escribiendo un guión bajo @code{_}
-para cada nota
-que forma parte del melisma.
-
-@lilypond[relative=1,verbatim,fragment,quote]
-{ \set melismaBusyProperties = #'()
- c d( e) f f( e) e e  }
-\addlyrics
- { Ky -- _ _ ri __ _ _ _  e }
-@end lilypond
-
-En este caso, también puede tener ligaduras de unión y de expresión en la melodía, si establece
-@code{melismaBusyProperties}, como se hizo en el ejemplo anterior.
-
-Sin embargo la instrucción @code{\lyricsto} también puede
-detectar los melismas automáticamente: sólo pone una sílaba
-debajo de un grupo de notas unidas mediante ligadura de unión o de expresión.  Si quiere forzar
-que un grupo de notas sin ligadura sea un melisma, inserte @code{\melisma}
-después de la primera nota del grupo, y @code{\melismaEnd} después de la
-última, p.ej.:
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-<<
-  \new Voice = "lala" {
-    \time 3/4
-    f4 g8
-    \melisma
-    f e f
-    \melismaEnd
-    e2
-  }
-  \new Lyrics \lyricsto "lala" {
-    la di __ daah
-  }
->>
-@end lilypond
-
-Además, las notas se consideran un melisma si están unidas manualmente
-mediante una barra, y el barrado automático (véase @ref{Setting automatic beam
-behavior}) está desactivado.
-
-@c TODO: there might be some more relevant place for 
-@c the following link (?)
-
-@cindex SATB
-@cindex coral, partitura
-
-Hay un ejemplo completo de una disposición de partitura SATB en la sección
-@ref{Vocal ensembles}.
-
-
-@refcommands
-
-@code{\melisma}, @code{\melismaEnd}
-@funindex \melismaEnd
-@funindex \melisma
-
-@seealso
-
-Referencia del programa: @internalsref{Melisma_translator}.
-
-@lsr{vocal,lyric@/-combine.ly}.
-
-@refbugs
-
-Los melismas no se detectan automáticamente, y las líneas de extensión se deben
-insertar a mano.
-
-@node Extenders and hyphens
-@subsubsection Extenders and hyphens
-
-@cindex melisma
-@cindex extender
-
-Los melismas se indican mediante una línea horizontal centrada entre una sílaba
-y la siguiente.  Esta línea recibe el nombre de línea de extensión, y se escribe
-como @samp{ __ } (fíjese en los espacios antes y después de los dos guiones
-bajos).
-
-@cindex guiones
-
-Los guiones centrados se escriben como @samp{ -- } entre sílabas de una misma palabra
-(fíjese en los espacios antes y después de los dos guiones).  El guión
-quedará centrado entre las sílabas, y su longitud se ajustará
-en función del espacio que exista entre ellas.
-
-En la música grabada de modo muy apretado, se pueden quitar los guiones.  Se puede
-controlar si esto ocurre o no, mediante la @code{minimum-distance} (distancia
-mínima entre las dos sílabas) y la @code{minimum-length}
-(umbral por debajo del cual se suprimen los guiones).
-
-@seealso
-
-Referencia del programa: @internalsref{LyricExtender},
-@internalsref{LyricHyphen}
-
-
-@node Working with lyrics and identifiers
-@subsection Working with lyrics and identifiers
-@cindex letra, identificadores de
-
-Para definir identificadores que contengan texto, se debe usar la función @code{\lyricmode}.
-Si embargo no tendrá que escribir las duraciones, si añade
-@code{\addlyrics} o @code{\lyricsto}
-en el momento de invocar el identificador.
- 
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
- <<
-   \new Voice = "one" \relative c'' @{
-     \autoBeamOff
-     \time 2/4
-     c4 b8. a16 g4. f8 e4 d c2
-   @}
-   \addlyrics @{ \verseOne @}
- >>
-@}
-@end example
- 
-Para arreglos distintos o más complejos, la mejor forma es preparar previamente la
-jerarquía de pautas y textos, p.ej.:
-@example
-\new ChoirStaff <<
-  \new Voice = "soprano" @{ @emph{música} @}
-  \new Lyrics = "textoSoprano" @{ s1 @}
-  \new Lyrics = "textoTenor" @{ s1 @}
-  \new Voice = "tenor" @{ @emph{música} @}
->>
-@end example
- 
-y después combinar las melodías y líneas de texto apropiadas
- 
-@example
-\context Lyrics = textoSoprano \lyricsto "soprano"
-@emph{el texto}
-@end example
- 
-@noindent
-
-El código de entrada definitivo sería algo como
- 
-@example
-<<\new ChoirStaff << @emph{prepare la música} >>
- \lyricsto "soprano" @emph{etc}
- \lyricsto "alto" @emph{etc}
-@emph{etc}
->>
-@end example
- 
-@seealso
- 
-@c TODO: document \new Staff << Voice \lyricsto >> bug
-Program reference: @internalsref{LyricCombineMusic},
-@internalsref{Lyrics}.  
-
-
-@node Flexibility in placement
-@subsection Flexibility in placement
-
-A menudo se aplican a una melodía distintos versos de una canción de formas ligeramente
-distintas.  Tales variantes pueden aún captarse mediante
-@code{\lyricsto}.
-
-@menu
-* Lyrics to multiple notes of a melisma::  
-* Divisi lyrics::               
-* Switching the melody associated with a lyrics line::  
-* Lyrics independent of notes::  
-@end menu
-
-
-@node Lyrics to multiple notes of a melisma
-@subsubsection Lyrics to multiple notes of a melisma
-
-Existe la posibilidad de que el texto tenga un melisma en un verso, pero
-varias sílabas en otro.  Una solución es hacer que la voz más rápida
-ignore el melisma.  Esto se consigue estableciendo
-@code{ignoreMelismata} en el contexto Lyrics.
-
-Hay un aspecto delicado: el valor de @code{ignoreMelismata}
-se debe establecer una sílaba @emph{antes} de la sílaba no melismática
-del texto, tal y como se muestra a continuación:
-
-@c  FIXME: breaks compile
-@lilypond[verbatim,ragged-right,quote]
-%{
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    \slurDotted
-    f8.[( g16])
-    a4
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    more slow -- ly
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    \set ignoreMelismata = ##t % applies to "fas"
-    go fas -- ter
-    \unset ignoreMelismata
-    still
-  }
->>
-%}
-@end lilypond
-
-
-El @code{ignoreMelismata} se aplica a la sílaba @q{fas}, por ello
-se debe introducir antes de @q{go}.
-
-La inversa también es posible: hacer que una línea de letra sea más lenta que la
-normal.  Esto se puede conseguir insertando @code{\skip}s (desplazamientos) dentro de la
-letra.  Para cada @code{\skip}, el texto se retrasará una nota más.
-Por ejemplo,
-
-@lilypond[verbatim,ragged-right,quote]
-\relative { c c g' }
-\addlyrics {
-  twin -- \skip 4
-  kle
-}
-@end lilypond
-
-
-@node Divisi lyrics
-@subsubsection Divisi lyrics
-
-Puede presentar letras alternativas (o divisi) nombrando contextos de
-voz y aplicando la letra a los mencionados contextos específicos.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" {
-    \relative c' {
-      c4
-      <<
-        { \voiceOne c8 e }
-        \new Voice = "splitpart" { \voiceTwo c4 }
-      >>
-      \oneVoice c4 c | c
-    }
-  }
-  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
-  \new Lyrics \lyricsto "splitpart" { will }
->> }
-@end lilypond
-
-
-Puede usar este truco para presentar las distintas letras de una sección
-que se repite.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" \relative c' {
-    c2 e | g e | c1 |
-    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
-    a2 b | c1}
-  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
-    do mi sol mi do
-    la si do }
-  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
-   do re mi fa sol }
-  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
-   dodo rere mimi fafa solsol }
->>
-}
-@end lilypond
-
-
-
-@node Switching the melody associated with a lyrics line
-@subsubsection Switching the melody associated with a lyrics line
-
-Son posibles variaciones más complejas en la disposición del texto.  Se puede
-cambiar la melodía para una línea de la letra durante el texto.  Esto se hace
-estableciendo la propiedad @code{associatedVoice}.  En el ejemplo
-
-@lilypond[ragged-right,quote]
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    <<
-      \new Voice = "alternative" {
-        \voiceOne
-        \times 2/3 {
-          % show associations clearly.
-          \override NoteColumn #'force-hshift = #-3
-          f8 f g
-        }
-      }
-      {
-        \voiceTwo
-        f8.[ g16]
-        \oneVoice
-      } >>
-    a8( b) c
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    Ju -- ras -- sic Park
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    % Tricky: need to set associatedVoice
-    % one syllable too soon!
-    \set associatedVoice = alternative % applies to "ran"
-    Ty --
-    ran --
-    no --
-    \set associatedVoice = lahlah % applies to "rus"
-    sau -- rus Rex
-  } >>
-@end lilypond
-
-@noindent
-el texto del primer verso se aplica a una melodía llamada @q{lahlah},
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  Ju -- ras -- sic Park
-@}
-@end example
-
-
-El segundo verso se aplica en principio al contexto de @code{lahlah}, pero
-para la sílaba @q{ran}, cambia a una melodía diferente.
-Esto se consigue con
-@example
-\set associatedVoice = alternative
-@end example
-
-@noindent
-Aquí, @code{alternative} es el nombre del contexto de @code{Voice}
-que contiene el tresillo.
-
-Una vez más, la instrucción debe ir una sílaba antes de la cuenta, antes de @q{Ty} en
-este caso.
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  \set associatedVoice = alternative % se aplica al "ran"
-  Ty --
-  ran --
-  no --
-  \set associatedVoice = lahlah % se aplica al "rus"
-  sau -- rus Rex
-@}
-@end example
-
-@noindent
-La disposición se vuelve a cambiar a la situación inicial mediante la asignación de
-@code{lahlah} a @code{associatedVoice}.
-
-
-@node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
-
-En cierta música vocal compleja, podría ser deseable colocar la
-letra de forma totalmente independiente de las notas.  La música que se define
-dentro de @code{lyricrhythm} desaparece dentro del contexto
-@code{Devnull}, pero los valores rítmicos aún se pueden utilizar para
-colocar la letra.
-
-@lilypond[quote,verbatim,ragged-right]
-voice = {
-  c''2
-  \tag #'music { c''2 }
-  \tag #'lyricrhythm { c''4. c''8 }
-  d''1
-}
-
-lyr = \lyricmode { I like my cat! }
-
-<<
-  \new Staff \keepWithTag #'music \voice
-  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
-  \new Lyrics \lyricsto "nowhere" \lyr
-  \new Staff { c'8 c' c' c' c' c' c' c'
-  c' c' c' c' c' c' c' c' }
->>
-@end lilypond
-
-
-@node Spacing lyrics
-@subsection Spacing lyrics
-
-@cindex Spacing lyrics
-@cindex Lyrics, increasing space between
-
-Para aumentar el espaciado entre las sílabas de la letra, establezca la propiedad minimum-distance de
-LyricSpace.
-
-@lilypond[relative,verbatim,fragment,quote,ragged-right]
-{
-  c c c c
-  \override Lyrics.LyricSpace #'minimum-distance = #1.0
-  c c c c
-}
-\addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-}
-@end lilypond
-
-Para que este cambio sea válido para la letra de la partitura completa, establezca la propiedad dentro del
-layout o disposición.
-
-@lilypond[relative,verbatim,quote,ragged-right]
-\score {
-  \relative c' {
-  c c c c
-  c c c c
-  }
-  \addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-  }
-  \layout {
-    \context {
-      \Lyrics
-      \override LyricSpace #'minimum-distance = #1.0
-    }
-  }
-}
-@end lilypond
-
-
-@node More about stanzas
-@subsection More about stanzas
-
-@cindex número de verso
-@subsubsection Adding stanza numbers 
-
-Los números de los versos se pueden añadir estableciendo @code{stanza}, p.ej.,
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set stanza = "1. "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set stanza = "2. "
-  Oh, ché -- ri, je t'aime
-}
-@end lilypond
-
-@noindent
-Estos números aparecerán inmediatamente antes de la primera sílaba.
-
-
-@subsubsection Adding dynamics marks
-
-Los versos que difieren en su fuerza se pueden especificar escribiendo una
-indicación dinámica antes de cada verso.  En Lilypond, todo lo que aparece delante de
-un verso está dentro del objeto @code{StanzaNumber}; las indicaciones dinámicas
-no son diferentes.  Por razones técnicas, tendrá que establecer el valor de la sección stanza (verso)
-fuera de @code{\lyricmode}:
-
-@lilypond[quote,ragged-right,verbatim]
-text = {
-  \set stanza = \markup { \dynamic "ff" "1. " }
-  \lyricmode {
-    Big bang
-  }
-}
-
-<<
-  \new Voice = "tune" {
-    \time 3/4
-    g'4 c'2
-  }
-\new Lyrics \lyricsto "tune" \text
->>
-@end lilypond
-
-@cindex cantor, nombre del
-@cindex nombre del cantor
-@subsubsection Adding singer names
-
-También se pueden poner los nombres de los cantantes.  Se imprimen al comienzo de la
-línea, igual que los nombres de instrumento.  Se crean estableciendo un valor para
-@code{vocalName}.  Se puede definir una versión abreviada como @code{shortVocalName}.
-
-@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set vocalName = "Bert "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set vocalName = "Ernie "
-  Oh, che -- ri, je t'aime
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end 
-
-En ocasiones es conveniente tener un verso ajustado a la música,
-y el resto añadido en forma de estrofa al final
-de la pieza.  Esto se puede conseguir escribiendo
-los versos adicionales dentro de una sección @code{\markup} fuera
-del bloque score principal de la partitura.  Tenga en cuenta que existen dos
-formas distintas de forzar los saltos de línea al utilizar
-@code{\markup}.
-
-@lilypond[ragged-right,verbatim,quote]
-melody = \relative c' {
-e d c d | e e e e |
-d d e d | c1 |
-}
-
-text = \lyricmode {
-\set stanza = "1." Ma- ry had a lit- tle lamb,
-its fleece was white as snow.
-}
-
-\score{ <<
-  \new Voice = "one" { \melody }
-  \new Lyrics \lyricsto "one" \text
->>
-  \layout { }
-}
-\markup { \column{
-  \line{ Verse 2. }
-  \line{ All the children laughed and played }
-  \line{ To see a lamb at school. }
-  }
-}
-\markup{
-  \wordwrap-string #"
-  Verse 3.
-
-  Mary took it home again,
-
-  It was against the rule."
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end in multiple columns 
-
-Cuando una pieza tiene muchos versos, a menudo se imprimen
-en varias columnas a lo largo de toda la página. Con frecuencia un número de verso fuera del margen
-precede a cada verso. El ejemplo siguiente muestra cómo producir dicha salida
-en Lilypond.
-
-@lilypond[ragged-right,quote,verbatim]
-melody = \relative c' {
-  c c c c | d d d d
-}
- 
-text = \lyricmode {
-  \set stanza = "1." This is verse one.
-  It has two lines.
-}
-
-\score{ <<
-    \new Voice = "one" { \melody }
-    \new Lyrics \lyricsto "one" \text
-   >>
-  \layout { }
-}
-
-\markup {
-  \fill-line {
-    \hspace #0.1 % moves the column off the left margin; can be removed if
-        % space on the page is tight
-     \column {
-      \line { \bold "2."
-        \column {
-          "This is verse two."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "3."
-        \column {
-          "This is verse three."
-          "It has two lines."
-        }
-      }
-    }
-    \hspace #0.1  % adds horizontal spacing between columns; if they are
-        % still too close, add more " " pairs until the result 
-        % looks good
-     \column {
-      \line { \bold "4."
-        \column {
-          "This is verse four."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "5."
-        \column {
-          "This is verse five."
-          "It has two lines."
-        }
-      }
-    }
-  \hspace #0.1 % gives some extra space on the right margin; can
-      % be removed if page space is tight
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
-@internalsref{VocalName}.
-
-
-
-@node Ambitus
-@subsection Ambitus
-@cindex ambitus
-
-El término @emph{ambitus} o ámbito, denota el rango de notas que abarca una voz dada
-en una parte musical.  También puede denotar el margen de notas que es capaz de tocar
-un determinado instrumento musical.  Los ámbitos se imprimen en las partes vocales de tal manera que
-los intérpretes puedan determinar con facilidad si cumplen con sus propias posibilidades.
-
-Los ámbitos se presentan al comienzo de la pieza junto a la clave inicial.
-El rango se especifica gráficamente mediante dos cabezas de nota que representan a las
-notas inferior y superior.  Para imprimir el ámbito, añada el grabador
-@internalsref{Ambitus_engraver} al contexto @internalsref{Voice},
-por ejemplo
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-Lo que da como resultado la siguiente salida:
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-Si tiene varias voces en un pentagrama único y quiere tener una sola indicación de ámbito
-por pentagrama en lugar de una por cada voz, añada el grabador
-@internalsref{Ambitus_engraver} al contexto @internalsref{Staff}
-y no al contexto @internalsref{Voice}.  He aquí un ejemplo:
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-Este ejemplo utiliza una capacidad avanzada,
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Este código mueve el ámbito a la izquierda.  Se podría haber conseguido el mismo
-efecto con @code{extra-offset}, pero en tal caso el sistema de formateo no
-reservaría espacio para el objeto que se ha movido.
-
-@seealso
-
-Referencia del programa: @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Ejemplos:
-@lsr{vocal,ambitus@/.ly}.
-
-@refbugs
-
-No se efectúa un tratamiento de las posibles colisiones en caso de varias indicaciones de ámbito
-simultáneas en distintas voces.
-
-
-@node Other vocal issues
-@subsection Other vocal issues
-
-@ignore
-yeah, I'm giving up somewhat by stuffing a bunch of things in
-here.  But at least they're in the manual now; it's easier to
-move them around in the manual once they're already here.
-
-Besides, if users complain about everything stuffed in here, I
-can ask them for specific instructions about where to move these
-examples, and that might get them more involved in the docs.  -gp
-@end ignore
-
-@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
-realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
-@ref{Special noteheads}.
-
-
-
-
-
-@node Rhythmic music
-@section Rhythmic music
-
-La notación rítmica se emplea primordialmente para la percusión y la batería, pero también
-se puede utilizar para mostrar los valores rítmicos una melodía.
-
-@menu
-* Showing melody rhythms::      
-* Entering percussion::         
-* Percussion staves::           
-* Ghost notes::                 
-@end menu
-
-
-@node Showing melody rhythms
-@subsection Showing melody rhythms
-
-En ocasiones podría desear que se muestre sólo el ritmo de una melodía.  Esto
-se puede hacer con la pauta rítmica.  Todas las alturas de las notas en dicha pauta
-se muestran como una barra, y la pauta en sí tiene una sola línea.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new RhythmicStaff {
-  \time 4/4
-  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
-}
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{RhythmicStaff}.
-
-
-@node Entering percussion
-@subsection Entering percussion
-
-@cindex percusión
-@cindex batería
-
-
-Las notas de percusión se pueden escribir en el modo @code{\drummode}, que es similar
-al modo estándar para introducir notas.  Cada elemento de un set de percusión
-lleva un nombre completo y un nombre abreviado, y los dos se pueden usar
-en la entrada
-
-@lilypond[quote,ragged-right,verbatim]
-\drums {
-  hihat hh bassdrum bd
-}
-@end lilypond
-
-La lista completa de nombre de instrumentos de percusión se encuentra en el archivo de inicio
-@file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
-
-@seealso
-
-Referencia del programa: @internalsref{note-event}.
-
-@node Percussion staves
-@subsection Percussion staves
-@cindex percusión
-@cindex batería
-
-Una parte de percusión para más de un instrumento, normalmente utiliza una pauta
-de varias líneas donde cada posición dentro de la pauta se refiere a un elemento
-de percusión.
-
-
-Para tipografiar la música, se deben interpretar las notas dentro de los contextos
-@internalsref{DrumStaff} y @internalsref{DrumVoice}
-
-@lilypond[quote,ragged-right,verbatim]
-up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
-down = \drummode { bassdrum4 snare8 bd r bd sn4 }
-  \new DrumStaff <<
-    \new DrumVoice { \voiceOne \up }
-    \new DrumVoice { \voiceTwo \down }
-  >>
-@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
-las @internalsref{DrumVoice}s se instancian primero a mano.  Por ejemplo,
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
-  \drummode {
-    bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { bd4 sn4 bd4 sn4 }
-    >>
-  }
->>
-@end lilypond
-
-
-También existen otras posibilidades en lo referente a la disposición.  Para usarlas, establezca la
-propiedad @code{drumStyleTable} en el contexto @internalsref{DrumVoice}.
-Se han predefinido las siguientes variables:
-
-@table @code
-@item drums-style
-Es la opción por defecto.  Tipografía un típico set de percusión sobre una pauta de cinco líneas
-
-@lilypond[quote,line-width=10.0\cm]
-nam = \lyricmode {
-  cymc cyms cymr hh hhc hho hhho hhp
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
-mus = \drummode {
-  cymc cyms cymr hh hhc hho hhho hhp \break
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
-\score {
-  << \new DrumStaff \with {
-       \remove Bar_engraver
-       \remove Time_signature_engraver
-       \override Stem #'transparent = ##t
-       \override Stem #'Y-extent-callback = ##f
-       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
-     } \mus
-     \new Lyrics \nam
-  >>
-  \layout {
-    \context {
-      \Score
-      \override LyricText #'font-family = #'typewriter
-      \override BarNumber #'transparent =##T
-    }
-  }
-}
-@end lilypond
-
-El esquema de percusión contempla seis tambores graves (toms) distintos.  Cuando haya menos toms,
-sencillamente seleccione aquellos que producen el resultado deseado, es decir, para tener toms
-en las tres líneas centrales utilizará @code{tommh}, @code{tomml} y
-@code{tomfh}.
-
-@item timbales-style
-Esto tipografía timbales en una pauta de dos líneas
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { timh ssh timl ssl cb }
-mus = \drummode { timh ssh timl ssl cb s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-    \override StaffSymbol #'line-count = #2
-    \override StaffSymbol #'staff-space = #2
-    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
-    drumStyleTable = #timbales-style
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item congas-style
-Esto tipografía congas en una pauta de dos líneas
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
-mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    drumStyleTable = #congas-style
-    \override StaffSymbol #'line-count = #2
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item bongos-style
-Esto tipografía bongos sobre una pauta de dos líneas
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
-mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override StaffSymbol #'line-count = #2
-    drumStyleTable = #bongos-style
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item percussion-style
-Para tipografiar toda clase de percusiones simples sobre pautas de una línea.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
-mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
-
-<<
-  \new DrumStaff \with{
-    \remove Bar_engraver
-    drumStyleTable = #percussion-style
-    \override StaffSymbol #'line-count = #1
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-@end table
-
-Si no le gusta ninguna de las listas predefinidas, puede definir su propia lista
-al principio de su archivo
-
-@lilypond[quote,ragged-right,verbatim]
-#(define mydrums '(
-         (bassdrum     default   #f         -1)
-         (snare        default   #f         0)
-         (hihat        cross     #f         1)
-         (pedalhihat   xcircle   "stopped"  2)
-         (lowtom       diamond   #f         3)))
-up = \drummode { hh8 hh hh hh hhp4 hhp }
-down = \drummode { bd4 sn bd toml8 toml }
-
-\new DrumStaff <<
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
-  \new DrumVoice { \voiceOne \up }
-  \new DrumVoice { \voiceTwo \down }
->>
-@end lilypond
-
-
-@seealso
-
-Archivos de inicio: @file{ly/@/drumpitch@/-init@/.ly}.
-
-Referencia del programa: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
-
-@refbugs
-
-A causa de que el estándar General MIDI no contiene golpes de aro (rim shot), para este propósito se usa
-el golpe lateral de baqueta (sidestick) en su lugar.
-
-
-@c FIXME: check name -gp
-@node Ghost notes
-@subsection Ghost notes
-
-Las notas fantasma para la batería e instrumentos de percusión se pueden crear utilizando la instrucción
-@code{\parenthesize} detallada en @ref{Parentheses}.  Sin embargo,
-el modo por defecto @code{\drummode} no
-incluye el añadido grabador @code{Parenthesis_engraver} que permite
-esto.
-Debe escribir el grabador añadido explícitamente en la definición de contexto tal y como se explica detalladamente
-en @ref{Changing context properties on the fly}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\new DrumStaff \with {
-  \consists "Parenthesis_engraver"
-} <<
-  \context DrumVoice  = "1"  { s1 *2 }
-  \context DrumVoice  = "2" { s1 *2 }
-  \drummode {
-    <<
-      {
-        hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
-      } \\ {
-        bd4 r4 bd8 bd r8 bd
-      }
-    >>
-  }
->>
-@end lilypond
-
-@noindent
-Tenga en cuenta, además, que debe añadir acordes (paréntesis en ángulo @code{< >})
-alrededor de cada una de las instrucciones @code{\parenthesize}.
-
-
-@node Guitar
-@section Guitar
-
-@cindex tablatura
-@cindex guitarra, tablatura de
-
-@menu
-* String number indications::   
-* Tablatures basic::            
-* Non-guitar tablatures::       
-* Banjo tablatures::            
-* Fret diagrams::               
-* Right hand fingerings::       
-* Other guitar issues::         
-@end menu
-
-@node String number indications
-@subsection String number indications
-
-@cindex Cuerda, número de la
-
-Los números de cuerda se pueden añadir a los acordes especificándolos mediante
-@code{\}@var{número},
-
-@lilypond[relative,relative=1,ragged-right,fragment]
-<c\1 e\2 g\3>
-@end lilypond
-
-
-@seealso
-
-Referencia del programa: @internalsref{StringNumber},
-@lsr{guitar/,string-number.ly}.
-
-
-@node Tablatures basic
-@subsection Tablatures basic
-@cindex Tablatura, principios básicos
-
-La notación de tablatura se utiliza para la notación de música de instrumentos de cuerda
-pulsada.  Las alturas no se denotan mediante cabezas de nota, sino mediante
-números que indican sobre qué cuerda y traste se debe tocar la nota.  LilyPond
-contempla las tablaturas de forma limitada.
-
-El número de cuerda asociado a una nota se proporciona en la forma de una barra invertida
-seguida por un número, p.ej. @code{c4\3} es un Do negra sobre la tercera cuerda.
-Por defecto, la cuerda 1 es la más aguda, y la afinación normal
-es la afinación estándar de guitarra (con 6 cuerdas).  Las notas
-se imprimen como tablatura, usando lo contextos @internalsref{TabStaff} y
-@internalsref{TabVoice}
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  a,4\5 c'\2 a\3 e'\1
-  e\4 c'\2 a\3 e'\1
-}
-@end lilypond
-
-@funindex minimumFret
-@cindex traste
-
-Cuando no se especifica ninguna cuerda, se selecciona la primera cuerda que no da un
-número de traste menor de @code{minimumFret} (traste mínimo).  El valor por defecto
-de @code{minimumFret} es cero
-
-
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
-  \key e \major
-  e16 fis gis a b4
-  \set TabStaff.minimumFret = #8
-  e16 fis gis a b4
-}
-  \new StaffGroup <<
-    \new Staff { \clef "G_8" \frag }
-    \new TabStaff { \frag }
-  >>
-@end lilypond
-
-
-@commonprop
-
-Para imprimir tablaturas con las plicas hacia abajo y barras horizontales,
-inicialice el @code{TabStaff} (pentagrama de tablatura) con el código siguiente:
-
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
-
-@seealso
-
-Referencia del programa: @internalsref{TabStaff}, @internalsref{TabVoice}.
-
-@refbugs
-
-Los acordes no se tratan de una manera especial, de aquí que el
-selector automático de cuerdas podría fácilmente seleccionar la misma cuerda para dos notas
-dentro del mismo acorde.
-
-Para manejar @code{\partcombine}, una pauta de tablatura @code{TabStaff} debe usar
-voces creadas especialmente:
-
-@lilypond[quote,ragged-right,verbatim]
-melodia = \partcombine { e4 g g g }{ e4 e e e }
-<<
-  \new TabStaff <<
-    \new TabVoice = "one" s1
-    \new TabVoice = "two" s1
-    \new TabVoice = "shared" s1
-    \new TabVoice = "solo" s1
-    { \melodia }
-  >>
->>
-@end lilypond
-
-
-@node Non-guitar tablatures
-@subsection Non-guitar tablatures
-@cindex Tablaturas para instr. distintos de la guitarra
-
-Puede cambiar la afinación de las cuerdas. Una afinación de cuerdas se da como
-una lista en lenguaje Scheme con un número entero para cada cuerda, donde el número
-es la altura (medida en semitonos desde el Do central) de una
-cuerda al aire.  Los números especificados para @code{stringTunings} son la
-cantidad de semitonos que se deben restar o añadir, comenzando por la altura especificada
-que por defecto es el Do central, y en el orden de las cuerdas.  LilyPond calcula automáticamente
-el número de cuerdas leyendo @code{stringTunings}.
-
-En el ejemplo siguiente,
-@code{stringTunings} se establece a los valores Mi, La, Re y Sol
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
->>
-@end lilypond
-
-LilyPond tiene afinaciones predefinidas para el banjo, la mandolina, la guitarra
-y el bajo eléctrico.
-
-@example
-\set TabStaff.stringTunings = #bass-tuning
-@end example
-
-La afinación por omisión es @code{guitar-tuning} (la afinación estándar
-Mi-La-Re-Sol-Si-Mi).
-Otras afinaciones predefinidas son @code{guitar-open-g-tuning} (Sol Mayor al aire, Re-Sol-Re-Sol-Si-Re),
-@code{mandolin-tuning} (mandolina) y @code{banjo-open-g-tuning} (banjo con Sol Mayor al aire).
-
-@seealso
-
-El archivo @file{scm/@/output@/-lib@/.scm} contiene las afinaciones predefinidas
-de las cuerdas.
-Referencia del programa: @internalsref{Tab_note_heads_engraver}.
-
-@refbugs
-
-No se ha implementado ningún efecto especial de guitarra.
-
-
-
-@node Banjo tablatures
-@subsection Banjo tablatures
-@cindex Banjo, tablaturas de
-
-LilyPond contempla el banjo de cinco cuerdas de una manera básica.  Cuando haga tablaturas
-para banjo de cinco cuerdas, utilice la función de formato de tablatura de banjo para obtener
-los números correctos
-de los trastes para la quinta cuerda:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
-  \set TabStaff.stringTunings = #banjo-open-g-tuning
-  {
-    \stemDown
-    g8 d' g'\5 a b g e d' |
-    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
-    g4
-  }
->>
-@end lilypond
-
-En LilyPond se encuentran predefinidas varias afinaciones comunes para el banjo:
-@code{banjo-c-tuning} (sol-Do-Sol-Si-Re), @code{banjo-modal-tuning} (sol-Re-Sol-Do-Re),
-@code{banjo-open-d-tuning} (Re Mayor al aire, la-Re-Fa#-La-Re) y @code{banjo-open-dm-tuning}
-(Re menor al aire, la-Re-Fa-La-Re).
-
-Estas afinaciones se pueden convertir a afinaciones para bajo de cuatro cuerdas utilizando la
-función @code{four-string-banjo}:
-
-@example
-\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
-@end example
-
-@seealso
-
-El archivo @file{scm/@/output@/-lib@/.scm} contiene las afinaciones predefinidas para el banjo.
-
-
-@node Fret diagrams
-@subsection Fret diagrams
-@cindex trastes, diagramas de
-@cindex acordes, diagramas de
-
-Se pueden añadir diagramas de trastes a la música como elementos de marcado sobre la nota deseada.  El
-marcado contiene información sobre el diagrama de trastes deseado, tal y como se  muestra en el
-ejemplo siguiente
-
-@lilypond[verbatim, ragged-right, quote]
-\new Voice {
-  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
-  d' d' d'
-  fis'^\markup \override #'(size . 0.75) {
-    \override #'(finger-code . below-string) {
-      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
-                               (place-fret 5 4 3) (place-fret 4 4 4)
-                               (place-fret 3 3 2) (place-fret 2 2 1)
-                               (place-fret 1 2 1))
-    }
-  }
-  fis' fis' fis'
-  c'^\markup \override #'(dot-radius . 0.35) {
-    \override #'(finger-code . in-dot) {
-      \override #'(dot-color . white) {
-        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
-      }
-    }
-  }
-  c' c' c'
-}
-@end lilypond
-
-
-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}.
-
-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
-@internalsref{fret-diagram-interface}.
-
-
-@seealso
-
-Ejemplos: @lsrdir{guitar}
-
-
-@node Right hand fingerings
-@subsection Right hand fingerings
-
-Se pueden introducir las digitaciones de la mano derecha de los acordes, usando
-@code{@var{nota}-\rightHandFinger @var{dedo}}
-
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
-@end lilypond
-
-Por brevedad, es posible abreviar @code{\rightHandFinger} como algo más corto,
-como por ejemplo @code{RH},
-
-@example
-#(define RH rightHandFinger)
-@end example
-
-@cindex digitaciones, mano derecha, de guitarra
-@cindex mano derecha, digitaciones para guitarra
- 
-@commonprop
-
-Puede ejercer un mayor control sobre las digitaciones de la mano derecha estableciendo
-@code{strokeFingerOrientations},
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-}
-@end lilypond
-
-Las letras utilizadas para las digitaciones se encuentran contenidas dentro de la propiedad
-@code{digit-names} (nombres de los dedos), pero también se pueden fijar individualmente aportando a
-@code{\rightHandFinger} un argumento de cadena, como en el ejemplo siguiente
-
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
-  <c-\RH #5 >4
-  <c-\RH "@">4  
-}
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{StrokeFinger}
-
-
-
-@node Other guitar issues
-@subsection Other guitar issues
-
-Este ejemplo muestra cómo incluir indicaciones de posición y cejilla
-de guitarra:
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
-\clef "G_8"
-b16 d16 g16 b16 e16
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text = #"XII "
-  g16\startTextSpan
-  b16 e16 g16 e16 b16 g16\stopTextSpan
-e16 b16 g16 d16
-@end lilypond
-
-
-Las cabezas en aspa (X) se utilizan en la música de guitarra para indicar el lugar donde el
-guitarrista debe tocar una determinada nota o acorde, con sus dedos apenas
-tocando las cuerdas en lugar de pisarlas por completo.  Esto produce en el sonido un carácter
-percusivo y ruidoso, sin perder la altura de la nota
-original.  Su notación se realiza con cabezas en equis; se muestra
-en @ref{Special noteheads}.
-
-
-@node Bagpipe
-@section Bagpipe
-
-@cindex Gaita
-
-@menu
-* Bagpipe definitions::         
-* Bagpipe example::             
-@end menu
-
-
-@node Bagpipe definitions
-@subsection Bagpipe definitions
-
-LilyPond contiene definiciones especiales para la música de gaita escocesa de las
-tierras altas; para usarlas, escriba
-
-@example
-\include "bagpipe.ly"
-@end example
-
-@noindent
-al principio del archivo de entrada.  De esta forma podrá escribir las notas de adorno especiales
-que son usuales en la música de gaita, mediante instrucciones breves.  Por ejemplo, puede escribir
-@code{\taor} en lugar de
-
-@example
-\grace @{ \small G32[ d G e] @}
-@end example
-
-@code{bagpipe.ly} también contiene definiciones de alturas para las notas de la
-gaita en las octavas adecuadas, de forma que no se tenga que preocupar por
-@code{\relative} o por @code{\transpose}.
-
-@lilypond[ragged-right,verbatim,quote,notime]
-\include "bagpipe.ly"
-{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
-@end lilypond
-
-La música de gaita utiliza siempre la tonalidad de Re mayor (aunque esto no es
-completamente cierto). Sin embargo, puesto que es la única tonalidad que se puede utilizar,
-normalmente la armadura no se escribe. Para configurar esto de forma correcta,
-comience la música siempre con @code{\hideKeySignature} (ocultar armadura). Si, por algún motivo,
-quiere mostrar la armadura, puede usar @code{\showKeySignature}
-en su lugar.
-
-Alguna música moderna utiliza digitaciones cruzadas sobre el Do y el Fa para bemolizar estas notas.
-Se puede indicar esto mediante @code{cflat} o @code{fflat}. De forma parecida, el
-sol agudo piobaireachd se puede escribir @code{gflat} cuando aparece en música
-ligera.
-
-
-@node Bagpipe example
-@subsection Bagpipe example
-
-La conocida melodía Amazing Grace tiene este aspecto en notación de
-gaita.
-
-@lilypond[verbatim,quote]
-\include "bagpipe.ly"
-\layout {
-  indent = 0.0\cm
-  \context { \Score \remove "Bar_number_engraver" }
-}
-
-\header {
-  title = "Amazing Grace"
-  meter = "Hymn"
-  arranger = "Trad. arr."
-}
-
-{
-  \hideKeySignature
-  \time 3/4
-  \grg \partial 4 a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg e8. f16
-  \dblA A2 \grg A4
-  \grg A2 f8. A16
-  \grg A2 \hdblf f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 e4
-  \thrwd d2.
-  \slurd d2
-  \bar "|."
-}
-@end lilypond
-
-
-@node Ancient notation
-@section Ancient notation
-
-@cindex Vaticana, Editio
-@cindex Medicaea, Editio
-@cindex hufnagel
-@cindex Petrucci
-@cindex mensural
-
-El tratamiento de la notación antigua incluye posibilidades orientadas a la notación mensural
-y de Canto Gregoriano.  También se contempla de forma limitada la notación del
-bajo figurado.
-
-Muchos objetos gráficos ofrecen una propiedad @code{style}, consulte
-@itemize @bullet
-@item
-@ref{Ancient note heads},
-@item
-@ref{Ancient accidentals},
-@item
-@ref{Ancient rests},
-@item
-@ref{Ancient clefs},
-@item
-@ref{Ancient flags},
-@item
-@ref{Ancient time signatures}.
-@end itemize
-
-Al manipular la mencionada propiedad del elemento gráfico, la presentación tipográfica de los
-objetos gráficos afectados se puede acomodar a una variedad de notación específica
-sin necesidad de introducir ningún concepto notacional
-nuevo.
-
-Además de los signos de articulación estándar que se describen en la sección
-@ref{Articulations}, se ofrecen signos de articulación específicos para la notación
-antigua.
-
-@itemize @bullet
-@item
-@ref{Ancient articulations}
-@end itemize
-
-Otros aspectos de la notación antigua no se pueden expresar fácilmente
-en términos de cambiar simplemente una propiedad de estilo de un objeto gráfico o añadir
-símbolos de articulación.  Ciertos conceptos notacionales se introducen específicamente para
-la notación antigua,
-
-@itemize @bullet
-@item
-@ref{Custodes},
-@item
-@ref{Divisiones},
-@item
-@ref{Ligatures}.
-@end itemize
-
-Si todo esto le supone un exceso de documentación, y lo único que desea es
-navegar por el mar de la composición tipográfica sin tener que preocuparse demasiado de los detalles relativos a la
-manera de personalizar un contexto, puede echarles un vistazo a los contextos
-predefinidos.  Úselos para preparar contextos de voz y de pentagrama específicos de un estilo,
-y luego pase directamente a introducir las notas,
-
-@itemize @bullet
-@item
-@ref{Gregorian Chant contexts},
-@item
-@ref{Mensural contexts}.
-@end itemize
-
-Se contempla de forma limitada la notación del bajo figurado que apareció en el
-período barroco.
-
-@itemize @bullet
-@item
-@ref{Figured bass}
-@end itemize
-
-Aquí puede ver de forma resumida todos los apartados relacionados:
-
-@menu
-* Ancient note heads::          
-* Ancient accidentals::         
-* Ancient rests::               
-* Ancient clefs::               
-* Ancient flags::               
-* Ancient time signatures::     
-* Ancient articulations::       
-* Custodes::                    
-* Divisiones::                  
-* Ligatures::                   
-* Gregorian Chant contexts::    
-* Mensural contexts::           
-* Musica ficta accidentals::    
-* Figured bass::                
-@end menu
-
-
-
-@node Ancient note heads
-@subsection Ancient note heads
-
-@cindex cabezas de nota antiguas
-
-Para la notación antigua, se puede elegir un estilo de cabezas de notas distinto al @code{default}
-(estilo por defecto).  Esto se consigue estableciendo la propiedad @code{style}
-del objeto @internalsref{NoteHead} a los valores @code{baroque},
-@code{neomensural}, @code{mensural} o @code{petrucci}.  El estilo
-@code{baroque} se diferencia del estilo por defecto @code{default} únicamente en que usa
-una forma cuadrada para las cabezas de las @code{\breve}.  El estilo
-@code{neomensural} se diferencia del estilo @code{baroque} en que
-usa cabezas romboidales para las redondas y todas las figuras de duración menor.
-Las plicas aparecen centradas sobre las cabezas.  Este estilo es particularmente
-útil al transcribir música mensural, p.ej. para el incipit.  El estilo
-@code{mensural} produce cabezas que imitan el aspecto de aquellas que aparecen en las ediciones impresas
-del siglo XVI.  Finalmente, el estilo
-@code{petrucci} también imita las ediciones históricas, pero utiliza unas cabezas
-mayores.
-
-El ejemplo siguiente muestra el estilo @code{neomensural}
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override NoteHead #'style = #'neomensural
-a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
-@end lilypond
-
-Cuando se tipografía una pieza en notación de Canto Gregoriano, el grabador
-@internalsref{Gregorian_ligature_engraver} selecciona automáticamente
-las cabezas adecuadas, de manera que no es necesario establecer el estilo de las cabezas
-explícitamente.  Aún así, el estilo de las cabezas se puede establecer, p.ej., a
-@code{vaticana_punctum} para producir neumas punctum.  De forma similar, se utiliza un grabador
-@internalsref{Mensural_ligature_engraver} para construir automáticamente
-ligaduras mensurales.  Consulte @ref{Ligatures} para ver cómo funcionan los grabadores
-de las ligaduras.
-
-@seealso
-
-@ref{Note head styles} ofrece una visión de conjunto sobre la totalidad de los estilos de cabeza disponibles.
-
-
-@node Ancient accidentals
-@subsection Ancient accidentals
-
-@cindex alteraciones accidentales
-
-
-Utilice la propiedad @code{glyph-name-alist} del elemento gráfico
-@internalsref{Accidental} y @internalsref{KeySignature} para seleccionar
-los símbolos de alteración de la notación antigua.
-
-@lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \fatText
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
-  }
-}
-@end lilypond
-
-Como se muestra aquí, no todas las alteraciones están contempladas por cada uno de los estilos. Cuando
-trate de acceder a una alteración no contemplada, LilyPond cambiará a un estilo diferente,
-como se muestra en
-@lsr{ancient,ancient-accidentals.ly}.
-
-De forma similar a las alteraciones accidentales, el estilo de la armadura de la tonalidad se puede
-controlar a través de la propiedad @code{glyph-name-alist} del elemento gráfico
-@internalsref{KeySignature}.
-
-@seealso
-
-En el presente manual: @ref{Pitches}, @ref{Cautionary accidentals} y
-@ref{Automatic accidentals} proporcionan una introducción general al uso de las
-alteraciones.  @ref{Key signature} ofrece una introducción general al uso de
-las armaduras de tonalidad.
-
-Referencia del programa: @internalsref{KeySignature}.
-
-Ejemplos: @lsrdir{ancient}
-
-@node Ancient rests
-@subsection Ancient rests
-
-@cindex silencios antiguos
-
-
-Utilice la propiedad @code{style} del elemento gráfico @internalsref{Rest} para seleccionar
-silencios antiguos.  Los estilos contemplados son @code{classical},
-@code{neomensural} y @code{mensural}.  @code{classical} se diferencia
-del estilo por defecto @code{default} solamente en que el silencio de negra parece
-un silencio de corchea invertido horizontalmente.  El estilo @code{neomensural} es adecuado para,
-p.ej., el incipit de una pieza transcrita de música mensural.
-Finalmente, el estilo @code{mensural} reproduce el aspecto de los silencios de las ediciones impresas históricas
-del siglo XVI.
-
-El ejemplo siguiente muestra el estilo @code{neomensural}
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override Rest #'style = #'neomensural
-r\longa r\breve r1 r2 r4 r8 r16
-@end lilypond
-
-No existen silencios de fusa y semifusa específicos para los estilos mensural
-ni neo-mensural.  En su lugar se tomarán los silencios del estilo por defecto.
-Consulte @lsr{pitches,rests} para ver un cuadro de todos los silencios.
-
-No hay silencios en la notación del Canto Gregoriano; en su lugar, se utilizan
-@ref{Divisiones}.
-
-@seealso
-
-En este manual: @ref{Rests} ofrece una introducción general al uso de los
-silencios.
-
-
-@node Ancient clefs
-@subsection Ancient clefs
-
-@cindex claves
-
-
-LilyPond contempla una amplia variedad de claves, muchas de ellas antiguas.
-
-La siguiente tabla presenta todas las claves antiguas que están contempladas a través de la
-instrucción @code{\clef}.  Algunas de las claves usan el mismo glifo, pero
-se diferencian sólo en la línea en que se imprimen.  En tales casos,
-se usa un número añadido al nombre para enumerar dichas claves.
-Aún así, puede forzar manualmente que se escriba un glifo de clave sobre una
-línea arbitraria, como se encuentra descrito en @ref{Clef}.  La nota impresa a la derecha
-de cada clave en la columna de los ejemplos denota la situación del Do central (@code{c'})
-con respecto a dicha clave.
-
-@multitable @columnfractions .4 .4 .2
-@item
-@b{Descripción}
-@tab
-@b{Claves posibles}
-@tab
-@b{Ejemplo}
-
-@item
-clave de Do en estilo mensural moderno
-@tab
-@code{neomensural-c1}, @code{neomensural-c2},@*
-@code{neomensural-c3}, @code{neomensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "neomensural-c2" c
-@end lilypond
-
-@item
-claves de Do mensurales en estilo de Petrucci, para su uso sobre diferentes líneas de la pauta
-(los ejemplos muestran la clave de Do en segunda línea)
-@tab
-@code{petrucci-c1}, @code{petrucci-c2},@*
-@code{petrucci-c3}, @code{petrucci-c4},@*
-@code{petrucci-c5}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Fa mensural en estilo de Petrucci
-@tab
-@code{petrucci-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Sol mensural en estilo de Petrucci
-@tab
-@code{petrucci-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Do mensural en estilo histórico
-@tab
-@code{mensural-c1}, @code{mensural-c2},@*
-@code{mensural-c3}, @code{mensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Fa mensural en estilo histórico
-@tab
-@code{mensural-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Sol mensural de estilo histórico
-@tab
-@code{mensural-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-clave de Do del estilo de la Editio Vaticana
-@tab
-@code{vaticana-do1}, @code{vaticana-do2},@*
-@code{vaticana-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-do2"
-  c
-@end lilypond
-
-@item
-clave de Fa del estilo de la Editio Vaticana
-@tab
-@code{vaticana-fa1}, @code{vaticana-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-fa2"
-  c
-@end lilypond
-
-@item
-clave de Do del estilo de la Editio Medicaea
-@tab
-@code{medicaea-do1}, @code{medicaea-do2},@*
-@code{medicaea-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-do2"
-  c
-@end lilypond
-
-@item
-clave de Fa del estilo de la Editio Medicaea
-@tab
-@code{medicaea-fa1}, @code{medicaea-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-fa2"
-  c
-@end lilypond
-
-@item
-clave de Do hufnagel de estilo histórico
-@tab
-@code{hufnagel-do1}, @code{hufnagel-do2},@*
-@code{hufnagel-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do2"
-  c
-@end lilypond
-
-@item
-clave de Fa hufnagel de estilo histórico
-@tab
-@code{hufnagel-fa1}, @code{hufnagel-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-fa2"
-  c
-@end lilypond
-
-@item
-clave hufnagel de Do y Fa combinados de estilo histórico
-@tab
-@code{hufnagel-do-fa}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do-fa"
-  c
-@end lilypond
-@end multitable
-
-
-
-@emph{Estilo Moderno} significa @qq{como se encuentra tipografiado en las ediciones contemporáneas de
-música mensural transcrita.}
-
-@emph{Estilo de Petrucci} significa @qq{inspirado por las ediciones impresas del famoso
-grabador Petrucci (1466-1539).}
-
-@emph{Estilo Histórico} significa @qq{como se tipografiaba o se escribía en las ediciones
-históricas (aparte de las de Petrucci).}
-
-@emph{Estilo de la Editio XXX} significa @qq{como se imprime o imprimía en la Editio XXX.}
-
-Petrucci usaba claves de Do que tenían barras verticales en el lado izquierdo en un equilibrio variable,
-dependiendo de la línea de la pauta en que se imprimían.
-
-@seealso
-
-En este manual: consulte @ref{Clef}.
-
-@refbugs
-
-La clave mensural de Sol está reasignada a la clave de Sol de Petrucci.
-
-
-
-@node Ancient flags
-@subsection Ancient flags
-
-@cindex corchetes
-
-
-Utilice la propiedad @code{flag-style} del elemento gráfico @internalsref{Stem} para seleccionar
-los corchetes de estilo antiguo.  Aparte del estilo de corchete por defecto @code{default},
-sólo está contemplado el estilo @code{mensural}
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\override Stem #'flag-style = #'mensural
-\override Stem #'thickness = #1.0
-\override NoteHead #'style = #'mensural
-\autoBeamOff
-c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
-c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
-@end lilypond
-
-Dese cuenta de que la bandera más interna de cada uno de los corchetes mensurales siempre
-se alinea verticalmente con una línea de la pauta.
-
-No existe un estilo particular de corchete para la notación neo-mensural.  Por ello,
-cuando tipografíe el incipit de una pieza transcrita de música mensural,
-debe usar el estilo de corchete por defecto.  No existen corchetes en la notación
-del Canto Gregoriano.
-
-@refbugs
-
-La unión de los corchetes antiguos a las plicas está ligeramente desviada a causa de un
-cambio en la antigua versión 2.3.x.
-
-La alineación vertical de cada uno de los corchetes con una línea de la pauta da por supuesto que las plicas
-siempre terminan exactamente encima o bien exactamente en el medio de dos líneas de la
-pauta.  Esto puede no ser siempre cierto cuando se utilizan las posibilidades de disposición
-avanzadas de la notación clásica (que, de todas formas, por lo común se encuentra fuera del ámbito de la
-notación mensural).
-
-@node Ancient time signatures
-@subsection Ancient time signatures
-
-@cindex compás, indicación de
-
-
-Las indicaciones de compás mensurales están contempladas de forma limitada.  Los
-glifos están configurados de forma fija para determinadas fracciones de tiempo.  En otras palabras,
-para obtener un glifo de compás mensural determinado con la instrucción @code{\time n/m},
-se tienen que escoger @code{n} y @code{m} según la siguiente
-tabla
-
-@lilypond[quote,ragged-right]
-\layout {
-  indent = 0.0
-  \context {
-    \Staff
-    \remove Staff_symbol_engraver
-    \remove Clef_engraver
-    \remove Time_signature_engraver
-  }
-}
-{
-  \set Score.timing = ##f
-  \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural44" }
-  s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural22" }
-  s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural64" }
-  s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural68" }
-  \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural32" }
-  s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural34" }
-  s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural94" }
-  s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural98" }
-  \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural48" }
-  s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural24" }
-}
-@end lilypond
-
-Utilice la propiedad @code{style} del elemento gráfico @internalsref{TimeSignature} para
-seleccionar las indicaciones de compás de la música antigua.  Los estilos contemplados son
-@code{neomensural} y @code{mensural}.  La tabla anterior utiliza el
-estilo @code{neomensural}.  Este estilo es adecuado para el
-incipit de las transcripciones de piezas mensurales.  El estilo @code{mensural}
-reproduce el aspecto de las ediciones impresas históricas del s. XVI.
-
-Los ejemplos siguientes muestran las diferencias que existen entre los estilos:
-
-@lilypond[ragged-right,fragment,relative=1,quote]
-{
-  \fatText
-
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter default }
-
-  \override Staff.TimeSignature #'style = #'numbered
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter numbered }
-
-  \override Staff.TimeSignature #'style = #'mensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter mensural }
-
-  \override Staff.TimeSignature #'style = #'neomensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter neomensural }
-  \override Staff.TimeSignature #'style = #'single-digit
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter single-digit }
-}
-@end lilypond
-
-@seealso
-
-En el presente manual: @ref{Time signature} ofrece una introducción general al
-uso de las indicaciones de compás.
-
-@refbugs
-
-Las relaciones de duración de las notas no se modifican cuando cambia la indicación de compás.  Por
-ejemplo, la razón de 1 breve = 3 semibreves (tiempo perfecto) se debe
-hacer a mano mediante el establecimiento de
-
-@example
-breveTP = #(ly:make-duration -1 0 3 2)
-@dots{}
-@{ c\breveTP f1 @}
-@end example
-
-@noindent
-Esto fija un valor para @code{breveTP} de 3/2 multiplicado por 2 = 3 veces una redonda.
-
-El símbolo @code{old6/8alt} (alternativo al símbolo de 6/8) no se puede
-seleccionar directamente con @code{\time}.  En su lugar, utilice un elemento de marcado @code{\markup}.
-
-@node Ancient articulations
-@subsection Ancient articulations
-
-@cindex articulaciones
-
-Además de los signos de articulación estándar que se hallan descritos en la sección
-@ref{Articulations}, se proveen signos de articulación para la notación
-antigua.  Éstos están pensados específicamente para utilizarlos con la notación del estilo
-Editio Vaticana.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \override TextScript #'font-family = #'typewriter
-    \override TextScript #'font-shape = #'upright
-    \override Script #'padding = #-0.1
-    a\ictus_"ictus" \break
-    a\circulus_"circulus" \break
-    a\semicirculus_"semicirculus" \break
-    a\accentus_"accentus" \break
-    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
-  }
-}
-@end lilypond
-
-@refbugs
-
-Ciertas articulaciones se colocan demasiado cerca verticalmente de las
-cabezas de nota correspondientes.
-
-La línea episemática no se muestra en muchos casos.  Si se presenta,
-el extremo derecho de la línea episemática se encuentra a menudo demasiado lejos hacia la derecha.
-
-@node Custodes
-@subsection Custodes
-
-@cindex custos
-@cindex custodias
-
-Un @emph{custos} (en plural: @emph{custodias}, que en latín significa @q{guarda}) es un
-símbolo que aparece al final de una pauta.  Anticipa la altura
-de la primera o primeras notas de la línea siguiente, ayudando al intérprete con
-los saltos de línea durante la ejecución.
-
-Las custodias se utilizaron mucho en la notación musical hasta el siglo XVII.
-En nuestros días, sobreviven sólo en algunas formas particulares
-de notación musical como las ediciones contemporáneas de Canto Gregoriano
-como la @emph{editio vaticana}.  Hay distintos glifos para el custos
-que se utilizan en las diferentes variaciones de estilo notacional.
-
-Para tipografiar las custodias, simplemente coloque un grabador @internalsref{Custos_engraver} dentro del contexto
-@internalsref{Staff} (el contexto del pentagrama) al declarar el bloque de @code{\layout} (el bloque de disposición de la página),
-como se muestra en el ejemplo siguiente:
-
-@example
-\layout @{
-  \context @{
-    \Staff
-    \consists Custos_engraver
-    Custos \override #'style = #'mensural
-  @}
-@}
-@end example
-
-El resultado tendrá el aspecto siguiente:
-
-@lilypond[quote,ragged-right]
-\score {
-{
-  a'1
-  \override Staff.Custos #'style = #'mensural
-  \break
-  g'
-}
-\layout {
-  \context { \Staff \consists Custos_engraver }
-  }
-}
-@end lilypond
-
-El glifo del custos se selecciona mediante la propiedad @code{style}.  Los estilos
-contemplados son @code{vaticana}, @code{medicaea}, @code{hufnagel} y
-@code{mensural}.  Se muestran en el siguiente fragmento:
-
-@lilypond[quote,ragged-right,fragment]
-\new Lyrics \lyricmode {
-  \markup { \column {
-    \typewriter "vaticana"
-    \line { " " \musicglyph #"custodes.vaticana.u0" }
-  } }
-  \markup { \column {
-    \typewriter "medicaea"
-    \line { " " \musicglyph #"custodes.medicaea.u0" }
-  }}
-  \markup { \column {
-    \typewriter "hufnagel"
-    \line { " " \musicglyph #"custodes.hufnagel.u0" }
-  }}
-  \markup { \column {
-    \typewriter "mensural"
-    \line { " " \musicglyph #"custodes.mensural.u0" }
-  }}
-}
-@end lilypond
-
-@seealso
-
-Referencia del programa: @internalsref{Custos}.
-
-Ejemplos:
-@lsr{ancient,custodes@/.ly}.
-
-
-@node Divisiones
-@subsection Divisiones
-
-@cindex divisio
-@cindex divisiones
-@cindex finalis
-
-Una @emph{divisio} (en plural: @emph{divisiones}, que en latín significa
-@q{división}) es un símbolo del contexto del pentagrama que se usa para estructurar
-la música Gregoriana en frases y secciones.  El significado musical de
-@emph{divisio minima}, @emph{divisio maior} y @emph{divisio maxima}
-se podrían caracterizar como una pausa corta, media y larga (respectivamente), algo así como
-las marcas de respiración de @ref{Breath marks}.  El signo de @emph{finalis} no sólo
-marca el final de un canto, sino que se usa también con frecuencia dentro de un único
-canto antifonal o responsorial para marcar el final de cada una de las secciones.
-
-
-Para usar divisiones, incluya el archivo @file{gregorian@/-init@/.ly}.  Contiene
-definiciones que podrá aplicar con tan sólo escribir
-@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima}
-y @code{\finalis} en los lugares adecuados de la entrada.  Algunas ediciones usan
-@emph{virgula} o @emph{caesura} en vez de divisio minima.
-Por ello, @file{gregorian@/-init@/.ly} define también las instrucciones @code{\virgula} y
-@code{\caesura}
-
-@lilypondfile[quote,ragged-right]{divisiones.ly}
-
-@refcommands
-
-@funindex \virgula
-@code{\virgula},
-@funindex \caesura
-@code{\caesura},
-@funindex \divisioMinima
-@code{\divisioMinima},
-@funindex \divisioMaior
-@code{\divisioMaior},
-@funindex \divisioMaxima
-@code{\divisioMaxima},
-@funindex \finalis
-@code{\finalis}.
-
-@seealso
-
-En el presente manual: @ref{Breath marks}.
-
-Referencia del programa: @internalsref{BreathingSign}.
-
-Ejemplos: @lsr{expressive,breathing-sign.ly}.
-
-
-@node Ligatures
-@subsection Ligatures
-
-@cindex Ligaduras
-
-@c TODO: Should double check if I recalled things correctly when I wrote
-@c down the following paragraph by heart.
-
-Una ligadura es un símbolo gráfico que representa al menos dos notas
-distintas.  Las ligaduras aparecieron originalmente en los manuscritos de la notación del
-Canto Gregoriano para denotar secuencias de notas ascendentes o descendentes.
-
-Las ligaduras se escriben encerrándolas dentro de un par @code{\[} y @code{\]}.
-Ciertos estilos de ligadura podrían necesitar una sintaxis de entrada adicional específica para
-este tipo de ligadura en particular.  Por defecto, el grabador
-@internalsref{LigatureBracket} se limita a colocar un corchete recto
-sobre la ligadura
-
-@lilypond[quote,ragged-right,verbatim]
-\transpose c c' {
-  \[ g c a f d' \]
-  a g f
-  \[ e f a g \]
-}
-@end lilypond
-
-Para seleccionar un estilo de ligaduras específico, se debe añadir el grabador adecuado
-al contexto @internalsref{Voice}, tal y como se explica en los 
-sub-apartados siguientes.   Solamente están contempladas las ligaduras mensurales
-blancas con ciertas limitaciones.
-
-
-
-@refbugs
-
-Las ligaduras necesitan un espaciado especial que aún no se ha desarrollado.  Como
-consecuencia, la mayor parte del tiempo existe una separación excesiva entre las ligaduras,
-y a menudo los cortes de línea no son satisfactorios.  Además, la letra de los cantos no se alinea
-correctamente con las ligaduras.
-
-Las alteraciones accidentales no se deben imprimir dentro de las ligaduras, sino que deben
-reunirse e imprimirse juntas delante de ellas.
-
-La sintaxis todavía utiliza el obsoleto estilo infijo @code{\[ música expresión
-\]}.  Por motivos de consistencia, esto cambiará algún día al estilo
-postfijo @code{nota\[ ... nota\]}.  De forma alternativa, puede incluirse el archivo
-@file{gregorian@/-init@/.ly}; proporciona una función de
-Scheme
-@example
-\ligature @var{música expresión}
-@end example
-que causa el mismo efecto y se supone que es lo bastante estable.
-
-@menu
-* White mensural ligatures::    
-* Gregorian square neumes ligatures::  
-@end menu
-
-@node White mensural ligatures
-@subsubsection White mensural ligatures
-
-@cindex ligaduras mensurales
-@cindex ligaduras mensurales blancas
-
-Las ligaduras mensurales blancas están contempladas de forma limitada.
-
-Para grabar ligaduras mensurales blancas, en el bloque layout o de disposición de la página coloque el grabador
-@internalsref{Mensural_ligature_engraver} dentro del contexto
-@internalsref{Voice}, y elimine el grabador
-@internalsref{Ligature_bracket_engraver}, de la siguiente manera:
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \remove Ligature_bracket_engraver
-    \consists Mensural_ligature_engraver
-  @}
-@}
-@end example
-
-No existe ningún lenguaje de entrada adicional para describir la forma de una
-ligadura mensural blanca.  Más bien la forma se determina exclusivamente a partir
-de la altura y duración de las notas comprendidas.  Si bien este enfoque podría
-hacer que un usuario con poca experiencia tardase un tiempo en acostumbrarse a él, tiene la gran ventaja de que
-toda la información musical de la ligadura se conoce internamente.
-Esto no se requiere solamente para una salida MIDI correcta, sino que también permite la
-transcripción automática de las ligaduras.
-
-Por ejemplo,
-
-@example
-\set Score.timing = ##f
-\set Score.defaultBarType = "empty"
-\override NoteHead #'style = #'neomensural
-\override Staff.TimeSignature #'style = #'neomensural
-\clef "petrucci-g"
-\[ c'\maxima g \]
-\[ d\longa c\breve f e d \]
-\[ c'\maxima d'\longa \]
-\[ e'1 a g\breve \]
-@end example
-@lilypond[quote,ragged-right]
-\score {
-  \transpose c c' {
-    \set Score.timing = ##f
-    \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'neomensural
-    \override Staff.TimeSignature #'style = #'neomensural
-    \clef "petrucci-g"
-    \[ c'\maxima g \]
-    \[ d\longa c\breve f e d \]
-    \[ c'\maxima d'\longa \]
-    \[ e'1 a g\breve \]
-  }
-  \layout {
-    \context {
-      \Voice
-      \remove Ligature_bracket_engraver
-      \consists Mensural_ligature_engraver
-    }
-  }
-}
-@end lilypond
-
-Si no se sustituye el grabador @internalsref{Ligature_bracket_engraver} por el
-@internalsref{Mensural_ligature_engraver}, la misma música se transcribe
-de la siguiente manera:
-
-@lilypond[quote,ragged-right]
-\transpose c c' {
-  \set Score.timing = ##f
-  \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'neomensural
-  \override Staff.TimeSignature #'style = #'neomensural
-  \clef "petrucci-g"
-  \[ c'\maxima g \]
-  \[ d\longa c\breve f e d \]
-  \[ c'\maxima d'\longa \]
-  \[ e'1 a g\breve \]
-}
-@end lilypond
-
-@refbugs
-
-El espaciado horizontal es pobre.
-
-@node Gregorian square neumes ligatures
-@subsubsection Gregorian square neumes ligatures
-
-@cindex ligaduras de neumas cuadrados
-@cindex ligaduras gregorianas de neumas cuadrados
-
-La notación de neumas cuadrados gregorianos está contemplada de forma limitada
-(siguiendo el estilo de la Editio Vaticana).  El núcleo principal del conjunto de las ligaduras
-ya se pueden tipografiar, pero aún faltan aspectos esenciales para una composición tipográfica seria,
-como (entre otros) la alineación horizontal de varias ligaduras,
-la alineación de la letra y un correcto manejo de las alteraciones accidentales.
-
-
-La tabla siguiente contiene los neumas extendidos del segundo
-volumen del Antiphonale Romanum (@emph{Liber Hymnarius}), publicado
-en el año 1983 por los monjes de Solesmes.
-
-@multitable @columnfractions .4 .2 .2 .2
-
-@item
-@b{Neuma aut@*
-Neumarum Elementa}
-@tab
-@b{Figurae@*
-Rectae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Auctae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Deminutae}
-
-@c TODO: \layout block is identical in all of the below examples.
-@c Therefore, it should somehow be included rather than duplicated all
-@c the time. --jr
-
-@c why not make identifiers in ly/engraver-init.ly? --hwn
-
-@c Because it's just used to typeset plain notes without
-@c a staff for demonstration purposes rather than something
-@c special of Gregorian chant notation. --jr
-
-@item
-@code{1. Punctum}
-@tab
-@lilypond[staffsize=26,line-width=1.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum
-    \[ b \]
-    \noBreak s^\markup {"a"} \noBreak
-
-    % Punctum Inclinatum
-    \[ \inclinatum b \]
-    \noBreak s^\markup {"b"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Auctum Ascendens
-    \[ \auctum \ascendens b \]
-    \noBreak s^\markup {"c"} \noBreak
-
-    % Punctum Auctum Descendens
-    \[ \auctum \descendens b \]
-    \noBreak s^\markup {"d"} \noBreak
-
-    % Punctum Inclinatum Auctum
-    \[ \inclinatum \auctum b \]
-    \noBreak s^\markup {"e"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Inclinatum Parvum
-    \[ \inclinatum \deminutum b \]
-    \noBreak s^\markup {"f"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{2. Virga}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Virga
-    \[ \virga b \]
-    \noBreak s^\markup {"g"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{3. Apostropha vel Stropha}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha
-    \[ \stropha b \]
-    \noBreak s^\markup {"h"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha Aucta
-    \[ \stropha \auctum b \]
-    \noBreak s^\markup {"i"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{4. Oriscus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Oriscus
-    \[ \oriscus b \]
-    \noBreak s^\markup {"j"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{5. Clivis vel Flexa}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis vel Flexa
-    \[ b \flexa g \]
-    s^\markup {"k"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis Aucta Descendens
-    \[ b \flexa \auctum \descendens g \]
-    \noBreak s^\markup {"l"} \noBreak
-
-    % Clivis Aucta Ascendens
-    \[ b \flexa \auctum \ascendens g \]
-    \noBreak s^\markup {"m"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Cephalicus
-    \[ b \flexa \deminutum g \]
-    s^\markup {"n"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{6. Podatus vel Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Podatus vel Pes
-    \[ g \pes b \]
-    s^\markup {"o"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens
-    \[ g \pes \auctum \descendens b \]
-    \noBreak s^\markup {"p"} \noBreak
-
-    % Pes Auctus Ascendens
-    \[ g \pes \auctum \ascendens b \]
-    \noBreak s^\markup {"q"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Epiphonus
-    \[ g \pes \deminutum b \]
-    s^\markup {"r"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{7. Pes Quassus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus
-    \[ \oriscus g \pes \virga b \]
-    s^\markup {"s"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus Auctus Descendens
-    \[ \oriscus g \pes \auctum \descendens b \]
-    s^\markup {"t"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{8. Quilisma Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes
-    \[ \quilisma g \pes b \]
-    s^\markup {"u"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes Auctus Descendens
-    \[ \quilisma g \pes \auctum \descendens b \]
-    s^\markup {"v"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{9. Podatus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Initio Debilis
-    \[ \deminutum g \pes b \]
-    s^\markup {"w"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens Initio Debilis
-    \[ \deminutum g \pes \auctum \descendens b \]
-    s^\markup {"x"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{10. Torculus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus
-    \[ a \pes b \flexa g \]
-    s^\markup {"y"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens
-    \[ a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"z"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus
-    \[ a \pes b \flexa \deminutum g \]
-    s^\markup {"A"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{11. Torculus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Initio Debilis
-    \[ \deminutum a \pes b \flexa g \]
-    s^\markup {"B"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens Initio Debilis
-    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"C"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus Initio Debilis
-    \[ \deminutum a \pes b \flexa \deminutum g \]
-    s^\markup {"D"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{12. Porrectus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus
-    \[ a \flexa g \pes b \]
-    s^\markup {"E"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Auctus Descendens
-    \[ a \flexa g \pes \auctum \descendens b \]
-    s^\markup {"F"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Deminutus
-    \[ a \flexa g \pes \deminutum b \]
-    s^\markup {"G"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{13. Climacus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus
-    \[ \virga b \inclinatum a \inclinatum g \]
-    s^\markup {"H"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Auctus
-    \[ \virga b \inclinatum a \inclinatum \auctum g \]
-    s^\markup {"I"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Deminutus
-    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
-    s^\markup {"J"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{14. Scandicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus
-    \[ g \pes a \virga b \]
-    s^\markup {"K"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Auctus Descendens
-    \[ g \pes a \pes \auctum \descendens b \]
-    s^\markup {"L"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Deminutus
-    \[ g \pes a \pes \deminutum b \]
-    s^\markup {"M"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{15. Salicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus
-    \[ g \oriscus a \pes \virga b \]
-    s^\markup {"N"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus Auctus Descendens
-    \[ g \oriscus a \pes \auctum \descendens b \]
-    s^\markup {"O"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{16. Trigonus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Trigonus
-    \[ \stropha b \stropha b \stropha a \]
-    s^\markup {"P"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@tab
-
-@end multitable
-
-
-Al contrario que la mayor parte de los otros sistemas de notación de neumas, el lenguaje de entrada
-para los neumas no refleja la apariencia tipográfica, sino que está pensado para
-mantener la atención sobre el significado musical.  Por ejemplo, @code{\[ a \pes b
-\flexa g \]} produce un Torculus que consiste en tres cabezas de Punctum,
-mientras que @code{\[ a \flexa g \pes b \]} produce un Porrectus con una forma
-de flexa curvada y una sola cabeza de Punctum.  No existe ninguna instrucción para
-tipografiar explícitamente la forma de flexa curvada; la decisión de
-cuándo tipografiar una forma de flexa curvada está basada en la entrada
-musical.  La idea de este enfoque es separar los aspectos musicales
-de la entrada, del estilo de notación de la salida.  De esta forma, la misma
-entrada se puede reutilizar para tipografiar la misma música en un estilo diferente
-de notación de Canto Gregoriano.
-
-La tabla siguiente muestra los fragmentos de código que producen las
-ligaduras en la anterior tabla de neumas.  La letra de la primera columna
-de cada línea en la tabla siguiente, indica a qué ligadura de la tabla anterior se refiere.
-La segunda columna da el nombre de la
-ligadura.  La tercera columna muestra el fragmento de código que produce esta ligadura,
-utilizando @code{g}, @code{a} @code{b} (Sol, La y Si) como notas de ejemplo.
-
-@multitable @columnfractions .02 .31 .67
-@item
-@b{#}
-@tab
-@b{Nombre}
-@tab
-@b{Frase de la entrada}
-
-@item
-a
-@tab
-Punctum
-@tab
-@code{\[ b \]}
-
-@item
-b
-@tab
-Punctum Inclinatum
-@tab
-@code{\[ \inclinatum b \]}
-
-@item
-c
-@tab
-Punctum Auctum@*
-Ascendens
-@tab
-@code{\[ \auctum \ascendens b \]}
-
-@item
-d
-@tab
-Punctum Auctum@*
-Descendens
-@tab
-@code{\[ \auctum \descendens b \]}
-
-@item
-e
-@tab
-Punctum Inclinatum@*
-Auctum
-@tab
-@code{\[ \inclinatum \auctum b \]}
-
-@item
-f
-@tab
-Punctum Inclinatum@*
-Parvum @tab
-@code{\[ \inclinatum \deminutum b \]}
-
-@item
-g
-@tab
-Virga
-@tab
-@code{\[ \virga b \]}
-
-@item
-h
-@tab
-Stropha
-@tab
-@code{\[ \stropha b \]}
-
-@item
-i
-@tab
-Stropha Aucta
-@tab
-@code{\[ \stropha \auctum b \]}
-
-@item
-j
-@tab
-Oriscus
-@tab
-@code{\[ \oriscus b \]}
-
-@item
-k
-@tab
-Clivis vel Flexa
-@tab
-@code{\[ b \flexa g \]}
-
-@item
-l
-@tab
-Clivis Aucta@*
-Descendens
-@tab
-@code{\[ b \flexa \auctum \descendens g \]}
-
-@item
-m
-@tab
-Clivis Aucta@*
-Ascendens
-@tab
-@code{\[ b \flexa \auctum \ascendens g \]}
-
-@item
-n
-@tab
-Cephalicus
-@tab
-@code{\[ b \flexa \deminutum g \]}
-
-@item
-o
-@tab
-Podatus vel Pes
-@tab
-@code{\[ g \pes b \]}
-
-@item
-p
-@tab
-Pes Auctus@*
-Descendens
-@tab
-@code{\[ g \pes \auctum \descendens b \]}
-
-@item
-q
-@tab
-Pes Auctus@*
-Ascendens
-@tab
-@code{\[ g \pes \auctum \ascendens b \]}
-
-@item
-r
-@tab
-Epiphonus
-@tab
-@code{\[ g \pes \deminutum b \]}
-
-@item
-s
-@tab
-Pes Quassus
-@tab
-@code{\[ \oriscus g \pes \virga b \]}
-
-@item
-t
-@tab
-Pes Quassus@*
-Auctus Descendens @tab
-@code{\[ \oriscus g \pes \auctum \descendens b \]}
-
-@item
-u
-@tab
-Quilisma Pes
-@tab
-@code{\[ \quilisma g \pes b \]}
-
-@item
-v
-@tab
-Quilisma Pes@*
-Auctus Descendens
-@tab
-@code{\[ \quilisma g \pes \auctum \descendens b \]}
-
-@item
-w
-@tab
-Pes Initio Debilis
-@tab
-@code{\[ \deminutum g \pes b \]}
-
-@item
-x
-@tab
-Pes Auctus Descendens@*
-Initio Debilis
-@tab
-@code{\[ \deminutum g \pes \auctum \descendens b \]}
-
-@item
-y
-@tab
-Torculus
-@tab
-@code{\[ a \pes b \flexa g \]}
-
-@item
-z
-@tab
-Torculus Auctus@*
-Descendens
-@tab
-@code{\[ a \pes b \flexa \auctum \descendens g \]}
-
-@item
-A
-@tab
-Torculus Deminutus
-@tab
-@code{\[ a \pes b \flexa \deminutum g \]}
-
-@item
-B
-@tab
-Torculus Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa g \]}
-
-@item
-C
-@tab
-Torculus Auctus@*
-Descendens Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
-
-@item
-D
-@tab
-Torculus Deminutus@*
-Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
-
-@item
-E
-@tab
-Porrectus
-@tab
-@code{\[ a \flexa g \pes b \]}
-
-@item
-F
-@tab
-Porrectus Auctus@*
-Descendens
-@tab
-@code{\[ a \flexa g \pes \auctum \descendens b \]}
-
-@item
-G
-@tab
-Porrectus Deminutus
-@tab
-@code{\[ a \flexa g \pes \deminutum b \]}
-
-@item
-H
-@tab
-Climacus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum g \]}
-
-@item
-I
-@tab
-Climacus Auctus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
-
-@item
-J
-@tab
-Climacus Deminutus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
-
-@item
-K
-@tab
-Scandicus
-@tab
-@code{\[ g \pes a \virga b \]}
-
-@item
-L
-@tab
-Scandicus Auctus@*
-Descendens
-@tab
-@code{\[ g \pes a \pes \auctum \descendens b \]}
-
-@item
-M
-@tab
-Scandicus Deminutus
-@tab
-@code{\[ g \pes a \pes \deminutum b \]}
-
-@item
-N
-@tab
-Salicus
-@tab
-@code{\[ g \oriscus a \pes \virga b \]}
-
-@item
-O
-@tab
-Salicus Auctus Descendens
-@tab
-@code{\[ g \oriscus a \pes \auctum \descendens b \]}
-
-@item
-P
-@tab
-Trigonus
-@tab
-@code{\[ \stropha b \stropha b \stropha a \]}
-@end multitable
-
-Las ligaduras que se acaban de relacionar sirven principalmente como un conjunto limitado, pero
-representativo, de ejemplos de ligaduras gregorianas.  Dentro de los delimitadores de ligadura
-@code{\[} y @code{\]}, prácticamente cualquier cantidad de notas
-se pueden acumular para formar una única ligadura, y los prefijos de cabeza como
-@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
-etc. se pueden intermezclar como se desee.  La utilización del conjunto de reglas que subyace
-a la construcción de las ligaduras en la tabla anterior se extrapola de la forma correspondiente.
-De esta manera se pueden crear una cantidad infinita de
-ligaduras diferentes.
-
-Los puntos de aumentación, llamados también @emph{morae}, se escriben con la función
-musical @code{\augmentum}.  Dese cuenta de que @code{\augmentum} está
-programado como una función musical unaria y no como un prefijo principal.  Se
-aplica solamente a la expresión musical que sigue inmediatamente.  Esto es,
-@code{\augmentum \virga c} no tendrá ningún efecto visible.  En su lugar, escriba
-@code{\virga \augmentum c} o @code{\augmentum @{\virga c@}}.  Tenga en cuenta
-también que puede escribir @code{\augmentum @{a g@}} como abreviatura de
-@code{\augmentum a \augmentum g}.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \[ \augmentum a \flexa \augmentum g \]
-    \augmentum g
-  }
-}
-@end lilypond
-
-@refcommands
-
-Están contemplados los siguientes prefijos de cabeza:
-
-@funindex \virga
-@code{\virga},
-@funindex \stropha
-@code{\stropha},
-@funindex \inclinatum
-@code{\inclinatum},
-@funindex \auctum
-@code{\auctum},
-@funindex \descendens
-@code{\descendens},
-@funindex \ascendens
-@code{\ascendens},
-@funindex \oriscus
-@code{\oriscus},
-@funindex \quilisma
-@code{\quilisma},
-@funindex \deminutum
-@code{\deminutum},
-@funindex \cavum
-@code{\cavum},
-@funindex \linea
-@code{\linea}.
-
-Los prefijos de Punctum se pueden acumular entre sí, aunque son de aplicación ciertas restricciones.  Por
-ejemplo, se pueden aplicar @code{\descendens} o bien @code{\ascendens} a una cabeza,
-pero no los dos a la misma.
-
-@funindex \pes
-@funindex \flexa
-Dos cabezas adyacentes se pueden ligar entre sí con las instrucciones infijas @code{\pes} y
-@code{\flexa} para una línea melódica ascendente y descendente,
-respectivamente.
-
-@funindex \augmentum
-Utilice la función musical unaria @code{\augmentum} para escribir puntos de aumentación.
-
-@refbugs
-
-Cuando un punto @code{\augmentum} aparece al final de la última pauta
-dentro de una ligadura, a veces se sitúa verticalmente en un lugar equivocado.  Como solución
-parcial, escriba una nota de salto adicional (e.g. @code{s8}) como la última nota
-de esa pauta.
-
-@code{\augmentum} debería estar programada como un prefijo de cabeza y no como una
-función musical unaria, de forma que @code{\augmentum} pudiera entremezclarse
-con los prefijos de cabeza en un orden arbitrario.
-
-@node Gregorian Chant contexts
-@subsection Gregorian Chant contexts
-
-@cindex VaticanaVoiceContext
-@cindex VaticanaStaffContext
-
-El contexto predefinido de voz @code{VaticanaVoiceContext} y el de
-pauta @code{VaticanaStaffContext} se pueden utilizar para grabar una pieza de
-Canto Gregoriano en el estilo de la Editio Vaticana.  Estos contextos
-establecen a unos valores iniciales adecuados todas las propiedades relevantes de los contextos y de los objetos gráficos,
-de forma que pueda inmediatamente comenzar a escribir el canto en sí,
-como lo demuestra el siguiente fragmento
-
-@lilypond[quote,ragged-right,packed,verbatim]
-\include "gregorian-init.ly"
-\score {
-  <<
-    \new VaticanaVoice = "cantus" {
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \]
-      f \divisioMinima
-      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
-      c' \divisioMinima \break
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
-    }
-    \new Lyrics \lyricsto "cantus" {
-      San- ctus, San- ctus, San- ctus
-    }
-  >>
-}
-@end lilypond
-
-
-@node Mensural contexts
-@subsection Mensural contexts
-
-@cindex MensuralVoiceContext
-@cindex MensuralStaffContext
-
-Los contextos predefinidos de voz @code{MensuralVoiceContext} y de pauta
-@code{MensuralStaffContext} se pueden usar para grabar una pieza en estilo mensural.
-Estos contextos establecen a unos valores iniciales adecuados todas las propiedades relevantes de los contextos y
-de los objetos gráficos, de manera que pueda comenzar inmediatamente a
-escribir el canto, como lo demuestra el siguiente fragmento
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  <<
-    \new MensuralVoice = "discantus" \transpose c c' {
-      \override Score.BarNumber #'transparent = ##t {
-        c'1\melisma bes a g\melismaEnd
-        f\breve
-        \[ f1\melisma a c'\breve d'\melismaEnd \]
-        c'\longa
-        c'\breve\melisma a1 g1\melismaEnd
-        fis\longa^\signumcongruentiae
-      }
-    }
-    \new Lyrics \lyricsto "discantus" {
-      San -- ctus, San -- ctus, San -- ctus
-    }
-  >>
-}
-@end lilypond
-
-@node Musica ficta accidentals
-@subsection Musica ficta accidentals
-
-En la música europea de hasta aprox. 1600, se esperaba de los cantantes que
-alterasen cromáticamente ciertas notas de acuerdo con su propia iniciativa. Esto recibe el nombre
-de @q{Musica Ficta}. En las transcripciones modernas, estas alteraciones accidentales se
-imprimen normalmente encima de la nota.
-
-@cindex Accidental, musica ficta
-@cindex Musica ficta
-
-Están contempladas estas alteraciones sugeridas, y se pueden activar
-estableciendo @code{suggestAccidentals} al valor cierto.
-
-@funindex suggestAccidentals
-
-@lilypond[verbatim,fragment,relative=1]
-fis gis
-\set suggestAccidentals = ##t
-ais bis
-@end lilypond
-
-@seealso
-
-Referencia del programa: el grabador @internalsref{Accidental_engraver} y el objeto
-@internalsref{AccidentalSuggestion}.
-
-@node Figured bass
-@subsection Figured bass
-
-@cindex Bajo continuo
-
-@c TODO: musicological blurb about FB
-
-
-LilyPond contempla el bajo figurado
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-<<
-  \new Voice { \clef bass dis4 c d ais g fis}
-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
-  }
->>
-@end lilypond
-
-El soporte para el bajo figurado consta de dos partes: hay un modo de entrada,
-que se inicia mediante @code{\figuremode}, en el que puede escribir las cifras del bajo
-como números, y hay un contexto llamado @internalsref{FiguredBass} que se ocupa
-de crear los objetos @internalsref{BassFigure} (cifras del bajo).
-
-En el modo de entrada de cifras, un grupo de cifras del bajo se encuentra delimitado por
-los paréntesis en ángulo @code{<} y @code{>}.  La duración se introduce después del ángulo de cierre @code{>}
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { <4 6> }
-@end lilypond
-
-Las alteraciones se añaden al escribir @code{-}, @code{!} y @code{+}
-después de los números.  Se añadirá un signo más plus cuando escriba @code{\+}, y las
-quintas y séptimas disminuidas se pueden obtener con @code{5/} y @code{7/}.
-
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
-@end lilypond
-
-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}.
-
-@example
-< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
-@end lilypond
-
-
-Además es posible usar líneas de continuación para las cifras que se repiten,
-
-@lilypond[verbatim,relative=1]
-<<
-  \new Staff {
-    \clef bass
-    c4 c c
-  }
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
-  }
->>
-@end lilypond
-
-@noindent
-En este caso, las líneas de extensión siempre sustituyen a las cifras existentes.
-
-El contexto @code{FiguredBass} no presta atención a la propia línea del
-bajo. Como consecuencia, quizá tenga que insertar cifras adicionales para
-obtener líneas de extensión bajo todas las notas, y puede que necesite añadir @code{\!}
-para evitar que aparezca una línea de extensión, e.g.
-
-@lilypond[relative=1]
-<<
-  \new Voice
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
-  }
-  {
-    \clef bass
-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
-  }
->>
-@end lilypond
-
-Al usar líneas de continuación, las cifras comunes siempre se colocan
-en la misma posición vertical. Si esto no es lo que desea, puede insertar un silencio
-con @code{r}. El silencio borrará cualquier alineación previa.  Por
-ejemplo, puede escribir
-
-@example
-  <4 6>8 r8
-@end example
-
-@noindent
-instead of
-@example
-  <4 6>4
-@end example
-
-Las alteraciones y signos más pueden aparecer antes o después de los números,
-dependiendo de las propiedades dirección de la alteración establecida en @code{figuredBassAlterationDirection} y la
-dirección del signo más establecida en @code{figuredBassPlusDirection}
-
-
-@lilypond
-  \figures {
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
-  }
-@end lilypond
-
-
-Aunque posiblemente la forma en que está contemplado el bajo figurado se parece superficialmente a los
-acordes, es mucho más simple.  El modo @code{\figuremode} sencillamente
-almacena los números, y el contexto @internalsref{FiguredBass} los imprime
-tal y como se han escrito.  No hay ninguna conversión a alturas de nota ni se reproduce ninguna realización
-del bajo en el archivo MIDI.
-
-Internamente, el código del programa produce elementos de marcado textual.  Puede utilizar cualquiera de las
-propiedades de los elementos de marcado textual para sobreescribir los detalles del formateo.  Por ejemplo, el
-espaciado vertical de las cifras se puede establecer con @code{baseline-skip}.
-
-
-El bajo figurado también se puede añadir a contextos @code{Staff} (de pauta)
-directamente.  En este caso, su posición vertical se ajusta de
-forma automática.
-
-@lilypond[ragged-right,fragment,quote]
-<<
-  \new Staff = someUniqueName
-  \relative c'' {
-    c4 c'8 r8 c,4 c'
-  }
-
-  %% send to existing Staff.
-  \context Staff = someUniqueName 
-  \figuremode {
-    <4>4 <6 10>8 s8
-    
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
-  }
->>
-@end lilypond
-
-
-@commonprop
-
-Por defecto, este método produce cifras encima de las notas. Para obtener
-cifras por debajo de las notas, utilice
-
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
-
-
-@refbugs
-
-Al usar bajos figurados por encima del pentagrama con líneas de extensión y
-@code{implicitBassFigures}, las líneas podrían intercambiarse.
-Es imposible mantener el orden de forma consistente cuando varias cifras
-tienen líneas de extensión que se superponen.  Para evitar este problema, utilice
-@code{stacking-dir} sobre @code{BassFigureAlignment}.
-
-
-@seealso
-
-Referencia del programa: Objetos @internalsref{NewBassFigure},
-@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
-@internalsref{BassFigureBracket} y 
-@internalsref{BassFigureContinuation} y el contexto
-@internalsref{FiguredBass}.
-
-
-
-@node Other instrument specific notation
-@section Other instrument specific notation
-
-Esta sección incluye información adicional para la escritura de partituras destinadas a instrumentos.
-
-@menu
-* Artificial harmonics (strings)::  
-@end menu
-
-@node Artificial harmonics (strings)
-@subsection Artificial harmonics (strings)
-
-@cindex armónicos artificiales
-
-Los armónicos artificiales se tipografían con un estilo de cabeza distinto.  Se
-introducen marcando la nota que es un armónico mediante @code{\harmonic}.
-
-@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
-<c g'\harmonic>4
-@end lilypond
-
diff --git a/Documentation/es/user/introduction.itely b/Documentation/es/user/introduction.itely
index cd14247abe..5a5bbd79da 100644
--- a/Documentation/es/user/introduction.itely
+++ b/Documentation/es/user/introduction.itely
@@ -744,6 +744,8 @@ Este libro explica todas las instrucciones de LilyPond que producen notación im
 por supuesto que el lector está familiarizado con los conceptos del manual
 de aprendizaje.
 
+@c  we need to completely rewrite this after GDP.  -gp
+@ignore
 @itemize @bullet
 
 @item
@@ -866,7 +868,7 @@ en el mismo paquete que el propio LilyPond, y convierten una amplia variedad de
 música al formato @code{.ly}.
 
 @end itemize
-
+@end ignore
 
 
 @subsubheading Other information
diff --git a/Documentation/es/user/lilypond-book.itely b/Documentation/es/user/lilypond-book.itely
index 2227ba7bd6..9238216b23 100644
--- a/Documentation/es/user/lilypond-book.itely
+++ b/Documentation/es/user/lilypond-book.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/lilypond-learning.tely b/Documentation/es/user/lilypond-learning.tely
new file mode 100644
index 0000000000..6e625330bc
--- /dev/null
+++ b/Documentation/es/user/lilypond-learning.tely
@@ -0,0 +1,220 @@
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: e9a620b6e7e1c0a1bf39b7063ff1744ad61efb08
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+@setfilename lilypond-learning.info
+@settitle GNU LilyPond Learning Manual
+@documentencoding UTF-8
+@documentlanguage es
+@c TRANSLATE ME
+
+@iftex
+@afourpaper
+@c don't replace quotes with directed quotes
+@tex
+\gdef\SETtxicodequoteundirected{Foo}
+\gdef\SETtxicodequotebacktick{Bla}
+@end tex
+@end iftex
+
+
+@c don't remove this comment.
+@ignore
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
+@omfdescription User manual of the LilyPond music engraving system
+@omftype program usage
+@omfcategory Applications|Publishing
+@omflanguage Spanish
+@end ignore
+
+
+@ifhtml
+Este documento también está disponible como
+@uref{source/Documentation/user/lilypond-learning.es.pdf,PDF} y como
+@uref{source/Documentation/user/lilypond-learning-big-page.html,una sola página enorme}.
+@end ifhtml
+
+
+@c  This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
+
+
+@finalout
+
+@titlepage
+@title LilyPond
+@subtitle El tipografiador de música
+@titlefont{Learning Manual}
+@author El equipo de desarrollo de LilyPond
+
+
+Copyright @copyright{} 1999--2007 por los autores
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{La traducción de la siguiente nota de copyright se ofrece como
+cortesía para las personas de habla no inglesa, pero únicamente la
+nota en inglés tiene validez legal.}
+
+@quotation
+Se otorga permiso para copiar, distribuir y/o modificar este documento
+bajo los términos de la Licencia de Documentación Libre de GNU, versión 1.1
+o cualquier versión posterior publicada por la Free Software Foundation;
+sin ninguna de las secciones invariantes.
+Se incluye una copia de esta licencia dentro de la sección titulada ``Licencia
+de Documentación Libre de GNU''.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+
+@vskip 20pt
+
+@lilypond[ragged-right]
+\score {
+  \context Lyrics {
+    \override Score.RehearsalMark #'self-alignment-X = #LEFT
+    \override Score.RehearsalMark #'font-size = #-2
+    \mark #(ly:export (string-append
+      "(For LilyPond version " (lilypond-version) ")"))
+    s2
+  }
+  \layout {
+    indent = 0.0\pt
+  }
+}
+@end lilypond
+
+@end titlepage
+
+@copying
+Copyright @copyright{} 1999--2007 por los autores
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{La traducción de la siguiente nota de copyright se ofrece como
+cortesía para las personas de habla no inglesa, pero únicamente la
+nota en inglés tiene validez legal.}
+
+@quotation
+Se otorga permiso para copiar, distribuir y/o modificar este documento
+bajo los términos de la Licencia de Documentación Libre de GNU, versión 1.1
+o cualquier versión posterior publicada por la Free Software Foundation;
+sin ninguna de las secciones invariantes.
+Se incluye una copia de esta licencia dentro de la sección titulada ``Licencia
+de Documentación Libre de GNU''.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end copying
+
+@c TRANSLATE ME
+@ifnottex
+This file documents GNU LilyPond program usage.
+
+Copyright @copyright{} 1999--2007 por los autores
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{La traducción de la siguiente nota de copyright se ofrece como
+cortesía para las personas de habla no inglesa, pero únicamente la
+nota en inglés tiene validez legal.}
+
+@quotation
+Se otorga permiso para copiar, distribuir y/o modificar este documento
+bajo los términos de la Licencia de Documentación Libre de GNU, versión 1.1
+o cualquier versión posterior publicada por la Free Software Foundation;
+sin ninguna de las secciones invariantes.
+Se incluye una copia de esta licencia dentro de la sección titulada ``Licencia
+de Documentación Libre de GNU''.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end ifnottex
+
+@c TRANSLATE ME
+@ifnottex
+@node Top
+@top GNU LilyPond --- learning manual
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
+
+This is the program usage manual for GNU LilyPond 2.11.x series.
+@ifhtml
+(See the bottom of this page for the exact version number).
+@end ifhtml
+
+@cindex web site
+@cindex URL
+
+More information can be found at
+@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
+of this and other documentation.
+
+@menu
+* Preface::                        Prefacio.
+* Introduction::                   Qué, por qué y cómo.
+* Tutorial::                       Introducción en forma de tutorial.
+* Putting it all together::        Más explicaciones sobre conceptos de
+LilyPond.
+* Working on LilyPond projects::   Sobre la utilización en el mundo
+real.
+* Tweaking output::                Introducción a las modificaciones de
+la salida.
+
+Apéndices
+
+* GNU Free Documentation License:: License of this document.
+* LilyPond index::
+@end menu
+@end ifnottex
+
+@contents
+
+
+@include macros.itexi
+
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include putting.itely
+@include working.itely
+@include tweaks.itely
+
+@include fdl.itexi
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
+
+@bye
diff --git a/Documentation/es/user/lilypond.tely b/Documentation/es/user/lilypond.tely
index b548f3976c..debfe8bec0 100644
--- a/Documentation/es/user/lilypond.tely
+++ b/Documentation/es/user/lilypond.tely
@@ -1,6 +1,6 @@
 \input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 60aab78a243fd94c15c01a9b2b84e5d484f1689b
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -208,21 +208,11 @@ de la presente documentación y de otras.
 
 @include dedication.itely
 
+@c TRANSLATE ME
 @menu
-Manual de aprendizaje
-
-* Preface::                        Prefacio.
-* Introduction::                   Qué, por qué y cómo.
-* Tutorial::                       Introducción en forma de tutorial.
-* Putting it all together::        Más explicaciones sobre conceptos de LilyPond.
-* Working on LilyPond projects::   Sobre la utilización en el mundo real.
-* Tweaking output::                Introducción a las modificaciones de la salida.
-
-Referencia de la notación
-
-* Basic notation::                 Notación musical estándar.
-* Instrument-specific notation::   Notaciones especiales.
-* Advanced notation::              Notación que se utiliza con menos frecuencia.
+* Musical notation::               Musical notation.
+* Specialist notation::            Notation which is only used for
+specicific purposes.
 * Changing defaults::              Ajuste fino de la salida.
 * Non-musical notation::           Salida que no es notación musical.
 * Spacing issues::                 Presentación de la salida sobre papel.
@@ -245,16 +235,10 @@ Apéndices
 
 
 @include macros.itexi
-@include preface.itely
-@include introduction.itely
-@include tutorial.itely
-@include putting.itely
-@include working.itely
-@include tweaks.itely
-
-@include basic-notation.itely
-@include instrument-notation.itely
-@include advanced-notation.itely
+
+@include notation.itely
+@include specialist.itely
+
 @include changing-defaults.itely
 @include non-music.itely
 @include spacing.itely
diff --git a/Documentation/es/user/macros.itexi b/Documentation/es/user/macros.itexi
index ff07b7a6b8..1882e26bcd 100644
--- a/Documentation/es/user/macros.itexi
+++ b/Documentation/es/user/macros.itexi
@@ -1,29 +1,75 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 17e8e47bc1e57c3633c15ed08edcf4977f3aa298
+    Translation of GIT committish: d30aabb4adc9e13c7a5a99a22230e97a0f164255
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c **** all formats ****
 
-@macro refbugs
-@noindent
-@subsubheading Bugs
+@c   ***** Displaying text *****
 
+@c we need this since @q{\} doesn't work with makeinfo 4.8 --
+@c say @q{@value{backslash}} instead
+@set backslash \
+
+@c to get decent quotes in `foo' and ``foo''
+@c  these need to be split up so that "@qq{foo}." looks nice.  :(
+@iftex
+@macro q{TEXT}
+`\TEXT\'
 @end macro
 
-@macro moreinfo
-@subheading More information
+@macro qq{TEXT}
+``\TEXT\''
+@end macro
+@end iftex
 
+
+@ifinfo
+@macro q{TEXT}
+`\TEXT\'
 @end macro
 
-@macro seealso
-@noindent
-@subsubheading See also
+@macro qq{TEXT}
+``\TEXT\''
+@end macro
+@end ifinfo
+
+
+@ifhtml
+@macro q{TEXT}
+@html
+&lsquo;\TEXT\&rsquo;
+@end html
+@end macro
 
+@macro qq{TEXT}
+@html
+&ldquo;\TEXT\&rdquo;
+@end html
 @end macro
+@end ifhtml
+
+
+@ifdocbook
+@macro q{TEXT}
+@xml
+&lsquo;\TEXT\&rsquo;
+@end xml
+@end macro
+
+@macro qq{TEXT}
+@xml
+&ldquo;\TEXT\&rdquo;
+@end xml
+@end macro
+@end ifdocbook
+
+
+
+
+@c   **** Headings in a doc subsection ****
 
 @macro refcommands
 @noindent
@@ -31,104 +77,109 @@
 
 @end macro
 
-@macro context{NAME}
-@vindex \NAME\
-@code{\NAME\}@c should use internalsref
+@macro commonprop
+@noindent
+@subsubheading Commonly tweaked properties
+
 @end macro
 
-@macro refcommand{WHAT}
-@vindex \WHAT\
-@code{\WHAT\}
+@macro seealso
+@noindent
+@subsubheading See also
+
 @end macro
 
-@macro commonprop
+@macro refbugs
 @noindent
-@subsubheading Commonly tweaked properties
+@subsubheading Bugs
+
+@end macro
+
 
+@macro context{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}@c should use internalsref
 @end macro
 
-@macro funindex {WORD}
-@findex \WORD\
-@kindex \WORD\
+@macro refcommand{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
+@macro funindex {TEXT}
+@findex \TEXT\
+@kindex \TEXT\
+@end macro
 
 
-@c  *** Macros with variable output ***
+
+@c   **** Links and references ****
 
 @c usage: @lsr{ancient,custodes.ly}
-@macro lsr{DIR,NAME}
+@macro lsr{DIR,TEXT}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
+@uref{source/input/lsr/\DIR\/collated-files.html#\TEXT\,@file{\DIR\/\TEXT\}}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\/\NAME\}
+@file{\DIR\/\TEXT\}
 @end ifnothtml
 @end macro
 
 @macro lsrdir{DIR}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
+@uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\}
+@file{\DIR\}
 @end ifnothtml
 @end macro
 
 
 
 
-@macro arrow{}
-@iftex
-@tex $\\Rightarrow$ @end tex@c
-@end iftex
-@ifhtml
-@html
-&rarr;
-@end html
-@end ifhtml
-@ifinfo
--->
-@end ifinfo
-@end macro
-
-
-@c we need this since @q{\} doesn't work with makeinfo 4.8 --
-@c say @q{@value{backslash}} instead
-@set backslash \
-
+@c  Definitions for references:
+@c     @internalsref
+@c     @rglos
+@c     @rprogram
+@c     @ruser
+@c     @rlearning
 
 @ifhtml
 @c ***** HTML *****
 
 @c makeinfo-4.7 encodes html names, which means that nodes that
 @c contain nonalphanum characters will be broken links on the website.
-@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
+@c @uref{../lilypond-internals/\TEXT\.html,\TEXT\}@c
 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
 @c better than a broken link.
-@c @inforef{\NAME\,,lilypond-internals}@c
+@c @inforef{\TEXT\,,lilypond-internals}@c
 @c using @ref without punctuation is OK without for formats other than info
 
 @ifset bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals-big-page}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals-big-page}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary-big-page}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary-big-page}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program-big-page}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program-big-page}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-big-page}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-big-page}
+@end macro
+
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning-big-page}
 @end macro
 
 @end ifset
@@ -136,42 +187,32 @@
 
 @ifclear bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@end ifclear
-
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@html
-&lsquo;\TEXT\&rsquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-@html
-&ldquo;\TEXT\&rdquo;
-@end html
-@end macro
+@end ifclear
 
 @end ifhtml
 
@@ -179,38 +220,29 @@
 @ifdocbook
 @c ***** DOCBOOK-XML *****
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
-@end macro
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@xml
-&lsquo;\TEXT\&rsquo;
-@end xml
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-@xml
-&ldquo;\TEXT\&rdquo;
-@end xml
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifdocbook
@@ -226,31 +258,22 @@
 
 @macro rglos{NAME}
 @vindex \NAME\
-@inforef{\NAME\,,,music-glossary}
-@end macro
-
-@macro usermanref{NAME}
-@inforef{\NAME\}
-@end macro
-
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@inforef{\NAME\,,music-glossary}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-``\TEXT\''
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifinfo
@@ -259,57 +282,29 @@
 @c **** TEX ****
 @iftex
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@code{\NAME\}
-@end macro
-
-@macro rglos {NAME}
-@vindex \NAME\
-@code{\NAME\}
-@end macro
-
-@macro seeinternals{NAME}
-el documento de funcionamiento interno, @internalsref{\NAME\}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro usermanref{NAME}
-el manual del usuario, @internalsref{\NAME\}
+@macro rglos {TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro rprogram{NAME}
-el manual de utilización del programa, @internalsref{\NAME\}
+@macro rprogram{TEXT}
+el manual de utilización del programa, @internalsref{\TEXT\}
 @end macro
 
-@alias ruser=usermanref
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
+@macro ruser{TEXT}
+el manual del usuario, @internalsref{\TEXT\}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-``\TEXT\''
+@macro rlearning{TEXT}
+el manual de aprendizaje, @internalsref{\TEXT\}
 @end macro
 
 @end iftex
 
 
-@ifnottex
-@c **** not TEX ****
-
-@macro seeinternals{NAME}
-@internalsref{\NAME\}
-@end macro
-
-@ifnotinfo
-@macro usermanref{NAME}
-@ref{\NAME\}
-@end macro
-@end ifnotinfo
-
-@end ifnottex
-
-
 @c EOF
diff --git a/Documentation/es/user/non-music.itely b/Documentation/es/user/non-music.itely
index b5e500c235..5245c0d41f 100644
--- a/Documentation/es/user/non-music.itely
+++ b/Documentation/es/user/non-music.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
@@ -27,19 +27,14 @@ UNTRANSLATED NODE: IGNORE ME
 UNTRANSLATED NODE: IGNORE ME
 
 @menu 
-* File structure (introduction)::
 * File structure::
 * A single music expression::
 * Multiple scores in a book::
 * Extracting fragments of notation::
 * Including LilyPond files::
 * Text encoding::
+* Different editions from one source::
 @end menu 
-@node File structure (introduction)
-@subsection File structure (introduction)
-
-UNTRANSLATED NODE: IGNORE ME
-
 @node File structure
 @subsection File structure
 
@@ -70,6 +65,11 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
+@node Different editions from one source
+@subsection Different editions from one source
+
+UNTRANSLATED NODE: IGNORE ME
+
 @node Titles and headers
 @section Titles and headers
 
diff --git a/Documentation/es/user/notation.itely b/Documentation/es/user/notation.itely
new file mode 100644
index 0000000000..93fddb97cc
--- /dev/null
+++ b/Documentation/es/user/notation.itely
@@ -0,0 +1,33 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Musical notation
+@chapter Musical notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Pitches::            Writing and display the pitches of notes.
+* Rhythms::            Writing and displaying the durations of notes.
+* Expressive marks::   Adding expression to notes.
+* Repeats::            Repeat music.
+* Simultaneous notes:: More than one note at once.
+* Staff notation::     Displaying staves.
+* Educational use::    Special notation to increase legibility.
+* Text::               Adding text to scores.
+@end menu
+
+@include pitches.itely
+@include rhythms.itely
+@include expressive.itely
+@include repeats.itely
+@include simultaneous.itely
+@include staff.itely
+@include educational.itely
+@include text.itely
+
diff --git a/Documentation/es/user/percussion.itely b/Documentation/es/user/percussion.itely
new file mode 100644
index 0000000000..ad137d8068
--- /dev/null
+++ b/Documentation/es/user/percussion.itely
@@ -0,0 +1,329 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Percussion
+@section Percussion
+
+@menu 
+* TODO percussion node fix::
+@end menu
+
+@node TODO percussion node fix
+@subsection TODO percussion node fix
+
+La notación rítmica se emplea primordialmente para la percusión y la batería, pero también
+se puede utilizar para mostrar los valores rítmicos una melodía.
+
+@menu
+* Showing melody rhythms::      
+* Entering percussion::         
+* Percussion staves::           
+* Ghost notes::                 
+@end menu
+
+
+@node Showing melody rhythms
+@unnumberedsubsubsec Showing melody rhythms
+
+En ocasiones podría desear que se muestre sólo el ritmo de una melodía.  Esto
+se puede hacer con la pauta rítmica.  Todas las alturas de las notas en dicha pauta
+se muestran como una barra, y la pauta en sí tiene una sola línea.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new RhythmicStaff {
+  \time 4/4
+  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
+}
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{RhythmicStaff}.
+
+
+@node Entering percussion
+@unnumberedsubsubsec Entering percussion
+
+@cindex percusión
+@cindex batería
+
+
+Las notas de percusión se pueden escribir en el modo @code{\drummode}, que es similar
+al modo estándar para introducir notas.  Cada elemento de un set de percusión
+lleva un nombre completo y un nombre abreviado, y los dos se pueden usar
+en la entrada
+
+@lilypond[quote,ragged-right,verbatim]
+\drums {
+  hihat hh bassdrum bd
+}
+@end lilypond
+
+La lista completa de nombre de instrumentos de percusión se encuentra en el archivo de inicio
+@file{ly/@/drumpitch@/-init@/.ly}.
+@c TODO: properly document this.
+
+@seealso
+
+Referencia del programa: @internalsref{note-event}.
+
+@node Percussion staves
+@unnumberedsubsubsec Percussion staves
+@cindex percusión
+@cindex batería
+
+Una parte de percusión para más de un instrumento, normalmente utiliza una pauta
+de varias líneas donde cada posición dentro de la pauta se refiere a un elemento
+de percusión.
+
+
+Para tipografiar la música, se deben interpretar las notas dentro de los contextos
+@internalsref{DrumStaff} y @internalsref{DrumVoice}
+
+@lilypond[quote,ragged-right,verbatim]
+up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
+down = \drummode { bassdrum4 snare8 bd r bd sn4 }
+  \new DrumStaff <<
+    \new DrumVoice { \voiceOne \up }
+    \new DrumVoice { \voiceTwo \down }
+  >>
+@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
+las @internalsref{DrumVoice}s se instancian primero a mano.  Por ejemplo,
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new DrumStaff <<
+  \new DrumVoice = "1" { s1 *2 }
+  \new DrumVoice = "2" { s1 *2 }
+  \drummode {
+    bd4 sn4 bd4 sn4
+    <<
+      { \repeat unfold 16 hh16 }
+      \\
+      { bd4 sn4 bd4 sn4 }
+    >>
+  }
+>>
+@end lilypond
+
+
+También existen otras posibilidades en lo referente a la disposición.  Para usarlas, establezca la
+propiedad @code{drumStyleTable} en el contexto @internalsref{DrumVoice}.
+Se han predefinido las siguientes variables:
+
+@table @code
+@item drums-style
+Es la opción por defecto.  Tipografía un típico set de percusión sobre una pauta de cinco líneas
+
+@lilypond[quote,line-width=10.0\cm]
+nam = \lyricmode {
+  cymc cyms cymr hh hhc hho hhho hhp
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
+mus = \drummode {
+  cymc cyms cymr hh hhc hho hhho hhp \break
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
+\score {
+  << \new DrumStaff \with {
+       \remove Bar_engraver
+       \remove Time_signature_engraver
+       \override Stem #'transparent = ##t
+       \override Stem #'Y-extent-callback = ##f
+       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
+     } \mus
+     \new Lyrics \nam
+  >>
+  \layout {
+    \context {
+      \Score
+      \override LyricText #'font-family = #'typewriter
+      \override BarNumber #'transparent =##T
+    }
+  }
+}
+@end lilypond
+
+El esquema de percusión contempla seis tambores graves (toms) distintos.  Cuando haya menos toms,
+sencillamente seleccione aquellos que producen el resultado deseado, es decir, para tener toms
+en las tres líneas centrales utilizará @code{tommh}, @code{tomml} y
+@code{tomfh}.
+
+@item timbales-style
+Esto tipografía timbales en una pauta de dos líneas
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { timh ssh timl ssl cb }
+mus = \drummode { timh ssh timl ssl cb s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+    \override StaffSymbol #'line-count = #2
+    \override StaffSymbol #'staff-space = #2
+    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
+    drumStyleTable = #timbales-style
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item congas-style
+Esto tipografía congas en una pauta de dos líneas
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
+mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    drumStyleTable = #congas-style
+    \override StaffSymbol #'line-count = #2
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item bongos-style
+Esto tipografía bongos sobre una pauta de dos líneas
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
+mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override StaffSymbol #'line-count = #2
+    drumStyleTable = #bongos-style
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item percussion-style
+Para tipografiar toda clase de percusiones simples sobre pautas de una línea.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
+mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
+
+<<
+  \new DrumStaff \with{
+    \remove Bar_engraver
+    drumStyleTable = #percussion-style
+    \override StaffSymbol #'line-count = #1
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+@end table
+
+Si no le gusta ninguna de las listas predefinidas, puede definir su propia lista
+al principio de su archivo
+
+@lilypond[quote,ragged-right,verbatim]
+#(define mydrums '(
+         (bassdrum     default   #f         -1)
+         (snare        default   #f         0)
+         (hihat        cross     #f         1)
+         (pedalhihat   xcircle   "stopped"  2)
+         (lowtom       diamond   #f         3)))
+up = \drummode { hh8 hh hh hh hhp4 hhp }
+down = \drummode { bd4 sn bd toml8 toml }
+
+\new DrumStaff <<
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+  \new DrumVoice { \voiceOne \up }
+  \new DrumVoice { \voiceTwo \down }
+>>
+@end lilypond
+
+
+@seealso
+
+Archivos de inicio: @file{ly/@/drumpitch@/-init@/.ly}.
+
+Referencia del programa: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
+
+@refbugs
+
+A causa de que el estándar General MIDI no contiene golpes de aro (rim shot), para este propósito se usa
+el golpe lateral de baqueta (sidestick) en su lugar.
+
+
+@c FIXME: check name -gp
+@node Ghost notes
+@unnumberedsubsubsec Ghost notes
+
+Las notas fantasma para la batería e instrumentos de percusión se pueden crear utilizando la instrucción
+@code{\parenthesize} detallada en @ref{Parentheses}.  Sin embargo,
+el modo por defecto @code{\drummode} no
+incluye el añadido grabador @code{Parenthesis_engraver} que permite
+esto.
+Debe escribir el grabador añadido explícitamente en la definición de contexto tal y como se explica detalladamente
+en @ref{Changing context properties on the fly}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\new DrumStaff \with {
+  \consists "Parenthesis_engraver"
+} <<
+  \context DrumVoice  = "1"  { s1 *2 }
+  \context DrumVoice  = "2" { s1 *2 }
+  \drummode {
+    <<
+      {
+        hh8[ hh] <hh sn> hh16
+        < \parenthesize sn > hh < \parenthesize
+        sn > hh8 <hh sn> hh
+      } \\ {
+        bd4 r4 bd8 bd r8 bd
+      }
+    >>
+  }
+>>
+@end lilypond
+
+@noindent
+Tenga en cuenta, además, que debe añadir acordes (paréntesis en ángulo @code{< >})
+alrededor de cada una de las instrucciones @code{\parenthesize}.
+
+
diff --git a/Documentation/es/user/piano.itely b/Documentation/es/user/piano.itely
new file mode 100644
index 0000000000..cac3f1bfce
--- /dev/null
+++ b/Documentation/es/user/piano.itely
@@ -0,0 +1,276 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Piano music
+@section Piano music
+
+@menu 
+* TODO piano node fix::
+@end menu 
+
+@node TODO piano node fix
+@subsection TODO piano node fix
+
+Los sistemas de piano son dos pentagramas normales agrupados mediante una llave.  Los pentagramas
+son hasta cierto punto independientes, pero a veces las voces pueden cruzarse entre los
+dos pentagramas.  También se utiliza esta notación para otros instrumentos de teclado y para el
+arpa.  El @internalsref{PianoStaff} está preparado especialmente para
+manejar este comportamiento de cruce de pentagramas.  En esta sección trataremos el
+@internalsref{PianoStaff} y alguna que otra peculiaridad pianística.
+
+@menu
+* Automatic staff changes::     
+* Manual staff switches::       
+* Pedals::                      
+* Staff switch lines::          
+* Cross staff stems::           
+@end menu
+
+@refbugs
+
+Los matices no se colocan centrados, pero se pueden utilizar ciertas alternativas.  Consulte la
+plantilla @q{piano con matices centrados} que está en @ref{Piano templates}.
+
+@cindex plica de pentagrama cruzado
+@cindex pentagrama cruzado, plica de
+@cindex distancia entre pentagramas en música de piano
+
+
+@node Automatic staff changes
+@unnumberedsubsubsec Automatic staff changes
+@cindex Cambio automático de pentagrama
+
+Se puede hacer que las voces cambien automáticamente entre los pentagramas inferior y
+superior.  La sintaxis para conseguir esto es
+
+@quotation
+@example
+\autochange @dots{}@var{música}@dots{}
+@end example
+@end quotation
+
+@noindent
+Esto creará dos pentagramas dentro del PianoStaff actual, llamados
+@code{up} (arriba) y @code{down} (abajo).  El pentagrama inferior estará en clave de Fa por
+omisión.
+
+Una sección marcada @code{\relative} que se encuentra fuera de @code{\autochange} no tiene
+efecto sobre las notas de la @var{música}, por tanto, en caso necesario escriba
+@code{\relative} dentro de @code{\autochange}, como en
+
+@quotation
+@example
+\autochange \relative @dots{} @dots{}
+@end example
+@end quotation
+
+
+El cambiador automático hace el cambio basándose en la altura (el Do central es el punto
+de inflexión), y se adelanta saltando sobre los silencios para hacer cambios por
+adelantado.  He aquí un ejemplo práctico
+
+@lilypond[quote,verbatim,ragged-right]
+\new PianoStaff
+  \autochange \relative c'
+  {
+    g4 a b c d r4 a g
+  }
+@end lilypond
+
+
+@seealso
+
+En este manual: @ref{Manual staff switches}.
+
+Referencia del programa: @internalsref{AutoChangeMusic}.
+
+
+
+@refbugs
+
+Los cambios de pentagrama pueden no acabar en lugares óptimos.  Para conseguir
+una salida de alta calidad es mejor especificar manualmente los cambios de pentagrama.
+
+
+@code{\autochange} no puede estar dentro de @code{\times}.
+
+
+@node Manual staff switches
+@unnumberedsubsubsec Manual staff switches
+
+@cindex manual, cambio de pentagrama
+@cindex pentagrama, cambios manuales de
+
+Las voces se pueden cambiar de pentagrama manualmente usando la instrucción
+@example
+\change Staff = @var{nombre_del_pentagrama} @var{música}
+@end example
+
+@noindent
+La cadena @var{nombre_del_pentagrama} es el nombre del pentagrama.  Cambia la
+voz actual de su pentagrama en curso al pentagrama de nombre
+@var{nombre_del_pentagrama}.  Por lo común @var{nombre_del_pentagrama} es @code{"up"} o
+@code{"down"}.  El @context{Staff} referido debe existir previamente, por ello
+normalmente la preparación de una partitura empezará por la preparación de los pentagramas,
+
+@example
+<<
+  \new Staff = "up" @{
+    \skip 1 * 10  % @emph{mantener vivo el pentagrama}
+    @}
+  \new Staff = "down" @{
+    \skip 1 * 10  % @emph{ídem}
+    @}
+>>
+@end example
+
+
+y la @context{Voice} se inserta con posterioridad
+
+@example
+\context Staff = down
+  \new Voice @{ @dots{} \change Staff = up @dots{} @}
+@end example
+
+
+@node Pedals
+@unnumberedsubsubsec Pedals
+@cindex Pedales
+
+El piano tiene pedales que alteran la forma en que se produce el sonido.  Generalmente un
+piano tiene tres pedales: derecho, una corda y tonal (en inglés: sustain, una corda y sostenuto).
+
+
+Se puede expresar una instrucción de pedal de piano adjuntando
+@code{\sustainDown}, @code{\sustainUp}, @code{\unaCorda},
+@code{\treCorde}, @code{\sostenutoDown} y @code{\sostenutoUp} a una
+nota o acorde
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c'4\sustainDown c'4\sustainUp
+@end lilypond
+
+Es posible modificar lo que se imprime estableciendo @code{pedal@var{X}Strings},
+donde @var{X} es uno de los tipos de pedal: @code{Sustain},
+@code{Sostenuto} o @code{UnaCorda}.  Consulte
+@internalsref{SustainPedal} dentro de la referencia del programa para más
+información.
+
+Los pedales se pueden indicar también mediante una secuencia de corchetes, estableciendo la
+propiedad @code{pedalSustainStyle} a objetos corchete
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'bracket
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+Un tercer estilo de notación de pedal es una mezcla de texto y corchetes,
+que se obtiene estableciendo la propiedad @code{pedalSustainStyle} a
+@code{mixed}
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'mixed
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+El estilo por defecto @q{*Ped.} para los pedales derecho y una corda corresponde al
+estilo @code{#'text}.  El pedal tonal usa el estilo @code{mixed} por
+defecto.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+Para hacer un ajuste fino del aspecto de un corchete de pedal, se pueden modificar las propiedades
+@code{edge-width}, @code{edge-height} y @code{shorten-pair} de los
+objetos @code{PianoPedalBracket} (véase
+@internalsref{PianoPedalBracket} en la Referencia del programa).
+Por ejemplo, el corchete se puede extender hasta el borde derecho de la
+cabeza de la nota
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+@seealso
+
+En este manual: @ref{Laissez vibrer ties}.
+
+@node Staff switch lines
+@unnumberedsubsubsec Staff switch lines
+
+
+@cindex seguimiento de voz
+@cindex pentagrama, cambio
+@cindex cruce de pentagramas
+
+@funindex followVoice
+
+Cuando una voz cambia a otro pentagrama, se puede imprimir automáticamente una línea
+que conecte las notas.  Esto se activa estableciendo
+@code{followVoice} a verdadero
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \new Staff="one" {
+    \set followVoice = ##t
+    c1
+    \change Staff=two
+    b2 a
+  }
+  \new Staff="two" { \clef bass \skip 1*2 }
+>>
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{VoiceFollower}.
+
+@refcommands
+
+@funindex \showStaffSwitch
+@code{\showStaffSwitch},
+@funindex \hideStaffSwitch
+@code{\hideStaffSwitch}.
+
+
+@node Cross staff stems
+@unnumberedsubsubsec Cross staff stems
+
+Los acordes que cruzan pentagramas se pueden producir mediante el incremento de la longitud
+de la plica en el pentagrama inferior, de manera que alcance a la plica que está en el pentagrama
+superior, y viceversa.
+
+@lilypond[ragged-right,verbatim,quote]
+stemExtend = {
+  \once \override Stem #'length = #10
+  \once \override Stem #'cross-staff = ##t
+}
+noFlag = \once \override Stem #'flag-style = #'no-flag
+\new PianoStaff <<
+  \new Staff {
+    \stemDown \stemExtend
+    f'4
+    \stemExtend \noFlag
+    f'8
+  }
+  \new Staff {
+    \clef bass
+    a4 a8
+  }
+>>
+@end lilypond
+
+
diff --git a/Documentation/es/user/pitches.itely b/Documentation/es/user/pitches.itely
new file mode 100644
index 0000000000..26b9eaf241
--- /dev/null
+++ b/Documentation/es/user/pitches.itely
@@ -0,0 +1,780 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Pitches
+@section Pitches
+
+This section discusses how to specify the pitch of notes.
+
+@menu
+* Writing pitches::             
+* Changing multiple pitches::   
+* Displaying pitches::          
+@end menu
+
+
+@node Writing pitches
+@subsection Writing pitches
+
+Into text.
+
+@menu
+* Normal pitches::              
+* Accidentals::                 
+* Cautionary accidentals::      
+* Micro tones::                 
+* Note names in other languages::  
+@end menu
+
+@node Normal pitches
+@unnumberedsubsubsec Normal pitches
+
+@cindex Nombres de las notas
+@cindex alturas
+
+El nombre de una nota se especifica usando las letras minúsculas de la @code{a} a la @code{g}.
+Una escala ascendente de Do mayor se tipografía con
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef bass
+c d e f g a b c'
+@end lilypond
+
+El nombre de la nota @code{c} se tipografía una octava por debajo del Do central.
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef treble
+c1
+\clef bass
+c1
+@end lilypond
+
+@funindex '
+@funindex ,
+
+La especificación opcional de la octava tiene la forma de una serie de
+comillas simples o apóstrofes (@samp{'}) o bien una serie de comas
+(@samp{,}).  Cada @samp{'} eleva la altura una octava;
+cada @samp{,} baja la altura una octava.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\clef treble
+c' c'' e' g d'' d' d c
+\clef bass
+c, c,, e, g d,, d, d c
+@end lilypond
+
+Se puede usar un método alternativo para declarar en qué octava grabar
+una nota; este método no requiere tantas especificaciones de octava
+(@code{'} y @code{,}).  Consulte
+@ref{Relative octaves}.
+
+
+@node Accidentals
+@unnumberedsubsubsec Accidentals
+
+@cindex nombres de las notas, holandés
+@cindex nombres de las notas, por omisión
+
+Un sostenido se forma añadiendo @code{-is} al final del nombre de la nota y
+un bemol se forma añadiendo @code{-es}.  Los dobles sostenidos y dobles bemoles
+se obtienen añadiendo @code{-isis} o @code{-eses} al nombre de la nota.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a2 ais a aes
+a2 aisis a aeses
+@end lilypond
+
+@noindent
+Estos son los nombres de las notas en holandés.  En holandés, @code{aes} se contrae en
+@code{as}, pero las dos formas se aceptan.  De forma similar, se aceptan
+tanto @code{es} como @code{ees}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a2 as e es
+@end lilypond
+
+Un becuadro cancelará el efecto de una alteración accidental o de la armadura.
+Sin embargo, los becuadros no se codifican dentro de la sintaxis del nombre de la nota con un
+sufijo; una nota becuadro se muestra como un simple nombre de nota natural
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a4 aes a2
+@end lilypond
+
+La entrada @code{d e f} se interpreta como @q{imprimir un Re natural,
+Mi natural y Fa natural}, independientemente de la armadura de la tonalidad.
+Para ver más información acerca de la distinción entre
+el contenido musical y la presentación de ese contenido, consulte
+@rlearning{Accidentals and key signatures}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+\key d \major
+d e f g
+d e fis g
+@end lilypond
+
+
+@commonprop
+
+De acuerdo con las reglas estándar del tipografiado, se imprime un signo de becuadro
+antes de un sostenido o un bemol siempre que una alteración anterior tiene que cancelarse.
+Para modificar este comportamiento, utilice
+@code{\set Staff.extraNatural = ##f}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+ceses4 ces cis c
+\set Staff.extraNatural = ##f
+ceses4 ces cis c
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{LedgerLineSpanner},
+@internalsref{NoteHead}.
+
+
+@node Cautionary accidentals
+@unnumberedsubsubsec Cautionary accidentals
+
+@cindex alteración recordatoria
+@cindex alteración de precaución
+@cindex alteración con paréntesis
+@cindex recordatoria, alteración
+@funindex ?
+@cindex precaución, alteración de
+@cindex paréntesis, alteración con
+@funindex !
+
+Normalmente las alteraciones accidentales se imprimen automáticamente, pero también puede
+imprimirlas manualmente.  Un alteración recordatoria
+se puede forzar añadiendo un signo de admiración @code{!}
+después de la altura de la nota.  Una alteración de precaución
+(o sea, una alteración entre paréntesis) se puede obtener añadiendo el
+signo de interrogación @samp{?} después del nombre de la nota.  Estas alteraciones adicionales
+se pueden usar también para producir notas con becuadro.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+cis cis cis! cis? c c? c! c
+@end lilypond
+
+
+@seealso
+
+La producción automática de alteraciones accidentales se puede ajustar de muchas formas.
+Para ver más información, consulte @ref{Automatic accidentals}.
+
+
+@node Micro tones
+@unnumberedsubsubsec Micro tones
+
+@cindex cuartos de tono
+@cindex semi-bemoles, semi-sostenidos
+
+Los medios bemoles y los medios sostenidos se forman añadiendo @code{-eh} y
+@code{-ih}; a continuación presentamos una serie de DOs cada vez más agudos
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Los microtonos también se exportan al archivo MIDI.
+
+
+@refbugs
+
+No existen estándares reconocidos ampliamente para denotar
+los bemoles de tres cuartos, de manera que los símbolos de LilyPond
+no se ajustan a ningún estándar.
+
+
+@node Note names in other languages
+@unnumberedsubsubsec Note names in other languages
+
+Existen conjuntos predefinidos de nombres de notas para algunos idiomas
+aparte del inglés.  Para usarlos, incluya el archivo de inicio
+específico del idioma.  Por ejemplo, añada @code{\include "english.ly"}
+al principio del archivo de entrada.  Los archivos de idioma disponibles
+y los nombres de las notas que definen son los siguientes:
+
+@c  Should this be made into a multitable?
+@cindex idiomas, nombres de las notas en otros
+@example
+                     Nombres de las notas      sostenido   bemol       doble        doble
+                                                                      sostenido     bemol
+
+nederlands.ly  c   d   e   f   g   a   bes b   -is         -es       -isis         -eses
+english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat  -ss/-x/       -ff/
+                                                                     -sharpsharp   -flatflat
+deutsch.ly     c   d   e   f   g   a   b   h   -is         -es       -isis         -eses
+norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es  -ississ/-isis -essess/-eses
+svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess      -ississ       -essess
+italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b        -dd           -bb
+catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b        -dd/-ss       -bb
+espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b        -ss           -bb
+@end example
+
+@noindent
+Tenga en cuenta que en holandés, alemán, noruego y sueco, los bemoles
+del @samp{La} como por ejemplo @code{aes} y @code{aeses}
+se contraen normalmente como @code{as} y @code{ases} (o más frecuentemente
+como @code{asas}). Algunas veces se definen sólo estas contracciones
+en los archivos de idioma correspondientes (esto también se aplica a los
+sufijos para cuartos de tono que se ven más abajo).
+
+@noindent
+Algunas músicas utilizan microtonos cuyas alteraciones son fracciones
+de un sostenido o bemol @q{normales}.  Los nombres de nota para cuartos
+de tono que se definen en los distintos archivos de idioma se encuentran
+listados en la tabla siguiente.  Aquí los prefijos @q{semi-} y @q{sesqui-} significan
+@q{medio} y @q{uno y medio} respectivamente.  Para el noruego,
+sueco, catalán y español no se ha definido aún ningún nombre especial.
+@c What about Turkish Maquam music and similar microtonal systems?
+@c
+@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
+@c is actually misleading since the alteration is in fact one and a half
+@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
+
+@example
+                    Nombres de las notas       semi-      semi-  sesqui-    sesqui-
+                                               sostenido  bemol  sostenido  bemol
+
+nederlands.ly  c   d   e   f   g   a   bes b   -ih       -eh     -isih      -eseh
+english.ly     c   d   e   f   g   a   bf  b   -qs       -qf     -tqs       -tqf
+deutsch.ly     c   d   e   f   g   a   b   h   -ih       -eh     -isih      -eseh
+norsk.ly       c   d   e   f   g   a   b   h   
+svenska.ly     c   d   e   f   g   a   b   h   
+italiano.ly    do  re  mi  fa  sol la  sib si  -sd       -sb     -dsd       -bsb
+catalan.ly     do  re  mi  fa  sol la  sib si  
+espanol.ly     do  re  mi  fa  sol la  sib si  
+@end example
+
+
+@node Changing multiple pitches
+@subsection Changing multiple pitches
+
+@menu
+* Relative octaves::            
+* Octave check::                
+* Transpose::                   
+@end menu
+
+
+@node Relative octaves
+@unnumberedsubsubsec Relative octaves
+
+@cindex Relativo
+@cindex Relativas, especificación de octavas
+@funindex \relative
+
+Las octavas se especifican añadiendo @code{'} y @code{,} a los nombres de las notas.
+Cuando copie música existente, es fácil poner por accidente una nota en la octava
+equivocada y luego es difícil encontrar dicho error.  La octava relativa
+previene estos errores haciendo que éstos tengan consecuencias mucho mayores:
+un solo error transporta una octava el resto de la pieza
+
+@example
+\relative @var{altura_inicial} @var{expresión_musical}
+@end example
+
+@noindent
+o bien
+
+@example
+\relative @var{expresión_musical}
+@end example
+
+@noindent
+@code{c'} se usa por defecto si no se define una altura inicial.
+
+La octava de las notas que aparecen dentro de @var{expresión_musical} se calculan como
+sigue: si no se usa ninguna marca de cambio de octava, el intervalo básico
+entre la nota actual y la anterior se toma siempre como si fuera una cuarta o menos.
+Esta distancia se determina independientemente de las alteraciones; un
+@code{fisis} (Fa doble sostenido) después de un @code{ceses} (Do doble bemol) se colocará
+por encima del @code{ceses}.  En otras palabras, una cuarta doble aumentada se considera
+un intervalo menor que una quinta disminuida, incluso aunque la cuarta doble aumentada
+tiene siete semitonos mientras que la quinta disminuida sólo tiene seis semitonos.
+
+Las marcas de cambio de octava @code{'} y @code{,} se pueden añadir para
+elevar o bajar la altura en una octava más.  Al entrar en el modo relativo,
+se puede especificar una altura de inicio absoluta que se comportará como
+la nota precedente a la primera nota de la @var{expresión_musical}.  Si no
+se especifica ninguna altura inicial, se utilizará el Do central como
+comienzo.
+
+Aquí podemos ver el modo relativo en acción:
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+Las marcas de cambio de octava se utilizan para intervalos mayores de la cuarta
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Si el elemento anterior es un acorde, la primera nota del acorde se utiliza para
+determinar la primera nota del siguiente acorde
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+La altura después del @code{\relative} contiene un nombre de nota.
+
+La conversión relativa no afecta a las secciones @code{\transpose},
+@code{\chordmode} o @code{\relative} en su argumento.  Para usar
+el modo relativo dentro de música transportada, se debe escribir 
+un @code{\relative} adicional dentro de @code{\transpose}.
+
+
+@node Octave check
+@unnumberedsubsubsec Octave check
+
+@cindex Comprobación de octava
+
+Las comprobaciones de octava hacen que los errores de octava sean más
+fáciles de corregir: una nota puede venir seguida de @code{=}@var{comillas}
+lo que indica cuál debería ser su octava absoluta.  En el siguiente ejemplo,
+
+@example
+\relative c'' @{ c='' b=' d,='' @}
+@end example
+
+@noindent
+la @code{d} generará una advertencia, porque se esperaba un @code{d''}
+(a causa de que el intervalo de @code{b'} a @code{d''} es de una tercera solamente),
+pero aparece un @code{d'}.  En la salida, la octava se corrige para que sea un @code{d''} y
+la siguiente nota se calcula de forma relativa a @code{d''} en lugar de a @code{d'}.
+
+También existe una comprobación de octava que no produce ninguna salida visible. La sintaxis
+
+@example
+\octave @var{altura}
+@end example
+
+comprueba que @var{altura} (sin las comillas) produce @var{altura} (con
+las comillas) en modo @code{\relative} comparado con la nota que se da en el
+comando @code{\relative}.  Si no es así, se imprime una advertencia, y la
+octava se corrige.  La @var{altura} no se imprime como una nota.
+
+En el ejemplo que aparece a continuación, la primera comprobación
+se aprueba sin más problema, porque el @code{e} (en modo @code{relative})
+está dentro de una quinta desde @code{a'}.  Sin embargo
+la segunda comprobación produce una advertencia porque el @code{e} no está dentro
+de una quinta del @code{b'}.  Se imprime el mensaje de advertencia y la octava se ajusta
+de modo que las notas siguientes están en la octava correcta
+de nuevo.
+
+@example
+\relative c' @{
+  e
+  \octave a'
+  \octave b'
+@}
+@end example
+
+
+La octava de una nota que sigue a una comprobación de octava
+se determina con respecto a la nota que la precede.  En el siguiente fragmento,
+la última nota es una @code{a'}, por encima del Do central.  Esto
+significa que la comprobación de @code{\octave} se aprueba satisfactoriamente,
+así que la comprobación se puede borrar sin que cambie la salida de la pieza.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' {
+  e
+  \octave b
+  a
+}
+@end lilypond
+
+
+@node Transpose
+@unnumberedsubsubsec Transpose
+
+@cindex Transposición
+@cindex Transposición de alturas
+@funindex \transpose
+
+Una expresión musical se puede transportar mediante @code{\transpose}.  La
+sintaxis es
+@example
+\transpose @var{desde} @var{hacia} @var{expresión_musical}
+@end example
+
+Esto significa que la @var{expresión_musical} se transporta el intervalo
+que hay entre las notas @var{desde} y @var{hacia}: cualquier nota con la altura @code{desde}
+se cambia por @code{hacia}.
+
+Por ejemplo, tomemos una pieza escrita en la tonalidad de Re mayor.
+Si esta pieza es demasiado grave para el ejecutante, se puede transportar
+hacia arriba a Mi mayor con
+@example
+\transpose d e @dots{}
+@end example
+
+Suponga una pieza escrita para el violín (que es un instrumento en Do).  Si
+esta parte se tiene que tocar con un clarinete en La (para el que un La
+se escribe como un Do, y que suena una tercera menor por debajo de lo que
+está escrito), el siguiente transporte producirá la particella correcta:
+
+@example
+\transpose a c @dots{}
+@end example
+
+@code{\transpose} distingue entre notas enarmónicas: tanto
+@code{\transpose c cis} como @code{\transpose c des} transportarán un
+semitono hacia arriba.  La primera versión imprimirá sostenidos y la
+segunda imprimirá bemoles
+
+
+@lilypond[quote,ragged-right,verbatim]
+mus = { \key d \major cis d fis g }
+\new Staff {
+  \clef "F" \mus
+  \clef "G"
+  \transpose c g' \mus
+  \transpose c f' \mus
+}
+@end lilypond
+
+@code{\transpose} también se puede usar para introducir notas escritas para un
+instrumento transpositor.  Las alturas se introducen normalmente en LilyPond
+en Do (o en @q{afinación de concierto}), pero se pueden introducir en otra
+tonalidad.  Por ejemplo, al introducir música para una trompeta en Si bemol
+que comienza en un Re de concierto, se puede escribir
+
+@example
+\transpose c bes @{ e4 @dots{} @}
+@end example
+
+Para imprimir esta música en Si bemol de nuevo (o sea, para producir una particella de trompeta
+en vez de una partitura para el director en afinación de concierto), puede envolver la música existente
+con otro @code{transpose}
+
+@example
+\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
+@end example
+
+
+@seealso
+
+Referencia del programa: @internalsref{TransposedMusic}.
+
+Ejemplo: @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
+
+
+@refbugs
+
+Si quiere usar al mismo tiempo @code{\transpose} y @code{\relative},
+debe escribir @code{\transpose} por fuera de @code{\relative}, porque
+@code{\relative} no tendrá ningún efecto sobre la música que aparezca dentro de un
+@code{\transpose}.
+
+
+@node Displaying pitches
+@subsection Displaying pitches
+
+@menu
+* Clef::                        
+* Key signature::               
+* Ottava brackets::             
+* Instrument transpositions::   
+@end menu
+
+@node Clef
+@unnumberedsubsubsec Clef
+
+@funindex \clef
+
+La clave indica qué líneas del pentagrama corresponden a qué
+notas.  La clave se establece con el comando @code{\clef} 
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+{ c''2 \clef alto g'2 }
+@end lilypond
+
+@cindex clave de Sol
+@cindex clave de violín
+@cindex clave de Do en tercera (clave de viola)
+@cindex clave de Do en cuarta (clave de tenor)
+@cindex clave de Fa en cuarta (clave de bajo)
+@cindex clave de Sol en primera (clave de violín francesa)
+@cindex clave de Do en primera (clave de soprano)
+@cindex clave de Do en segunda (clave de mezzosoprano)
+@cindex clave de Do en quinta (clave de barítono)
+@cindex clave de Fa en tercera (clave de varbarítono)
+@cindex clave de Fa en quinta (clave de sub-bajo)
+
+Las claves contempladas son
+
+@multitable @columnfractions .33 .66
+@headitem Clave @tab Posición
+@item @code{treble}, violin, G, G2 @tab
+clave de Sol en 2ª
+@item @code{alto, C} @tab
+clave de Do en 3ª
+@item @code{tenor} @tab
+clave de Do en 4ª
+@item @code{bass, F} @tab
+clave de Fa en 4ª
+@item @code{french} @tab
+clave de Sol en 1ª, conocida también como clave de violín francesa
+@item @code{soprano} @tab
+clave de Do en 1ª
+@item @code{mezzosoprano} @tab
+clave de Do en 2ª
+@item @code{baritone} @tab
+clave de Do en 5ª
+@item @code{varbaritone} @tab
+clave de Fa en 3ª
+@item @code{subbass} @tab
+clave de Fa en 5ª
+@item @code{percussion} @tab
+clave de percusión
+@item @code{tab} @tab
+clave de tablatura
+@end multitable
+
+Al añadir @code{_8} o @code{^8} al nombre de la clave, la clave se transpone
+una octava hacia abajo o hacia arriba, respectivamente, y @code{_15} y
+@code{^15} la transpone dos octavas.  El argumento @var{nombre_de_clave}
+se debe encerrar entre comillas cuando contiene guiones bajos o dígitos.  Por
+ejemplo:
+
+@cindex clave de tenor coral
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\clef "G_8" c4
+@end lilypond
+
+
+@commonprop
+
+El comando @code{\clef "treble_8"} equivale a establecer
+@code{clefGlyph},
+@code{clefPosition} (que controla la posición Y de la clave),
+@code{middleCPosition} y @code{clefOctavation}.  Se imprime una clave
+cuando se cambia cualquiera de estas propiedades.  El siguiente ejemplo muestra
+las posibilidades que se ofrecen estableciendo manualmente las propiedades.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \set Staff.clefGlyph = #"clefs.F"
+  \set Staff.clefPosition = #2
+  c'4
+  \set Staff.clefGlyph = #"clefs.G"
+  c'4
+  \set Staff.clefGlyph = #"clefs.C"
+  c'4
+  \set Staff.clefOctavation = #7
+  c'4
+  \set Staff.clefOctavation = #0
+  \set Staff.clefPosition = #0
+  c'4
+  \clef "bass"
+  c'4
+  \set Staff.middleCPosition = #4
+  c'4
+}
+@end lilypond
+
+
+@seealso
+
+En el presente manual: @ref{Grace notes}.
+
+Referencia del programa: @internalsref{Clef}.
+
+
+@node Key signature
+@unnumberedsubsubsec Key signature
+
+@cindex Armadura de la tonalidad
+@funindex \key
+
+La armadura indica la tonalidad en que se toca una pieza.  Está
+denotada por un conjunto de alteraciones (bemoles o sostenidos) al comienzo del
+pentagrama.
+
+El establecimiento o modificación de la armadura se hace con el
+comando @code{\key}
+
+@example
+@code{\key} @var{nota} @var{tipo}
+@end example
+
+@funindex \minor
+@funindex \major
+@funindex \minor
+@funindex \ionian
+@funindex \locrian
+@funindex \aeolian
+@funindex \mixolydian
+@funindex \lydian
+@funindex \phrygian
+@funindex \dorian
+@cindex modos eclesiásticos
+
+Aquí, @var{tipo} debe ser @code{\major} o @code{\minor} para obtener
+la tonalidad @var{nota}-mayor o @var{nota}-menor, respectivamente.  También puede
+usar los nombres estándar de modo (también conocidos como @q{modos eclesiásticos}): @code{\ionian} (jónico),
+@code{\locrian} (locrio), @code{\aeolian} (eolio), @code{\mixolydian} (mixolidio), @code{\lydian} (lidio),
+@code{\phrygian} (frigio) y @code{\dorian} (dórico).
+
+Este comando establece la propiedad de contexto
+@code{Staff.keySignature}.  Se pueden especificar armaduras no estándar
+estableciendo esta propiedad directamente.
+
+Las alteraciones accidentales y las armaduras son una frecuente causa de confusión para los nuevos usuarios,
+porque las notas sin alteración pueden llevar signos de becuadro en función de la armadura.
+Para ver más información, consulte @ref{Accidentals} o @rlearning{Accidentals and key signatures}.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\key g \major
+f1
+fis
+@end lilypond
+
+
+@commonprop
+
+Se imprime un símbolo de becuadro para cancelar las alteraciones anteriores.  Se puede
+suprimir esto estableciendo la propiedad
+@code{Staff.printKeyCancellation}.
+
+@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+\set Staff.printKeyCancellation = ##f
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{KeyCancellation},
+@internalsref{KeySignature}.
+
+@node Ottava brackets
+@unnumberedsubsubsec Ottava brackets
+
+Los corchetes de @q{Ottava} introducen un trasporte adicional de una octava para el pentagrama.
+Se crean por medio de la invocación de la función
+@code{set-octavation}
+
+@cindex ottava
+@cindex 15ma
+@cindex octavación
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c''' {
+  a2 b
+  #(set-octavation 1)
+  a b
+  #(set-octavation 0)
+  a b
+}
+@end lilypond
+
+La función @code{set-octavation} también admite los valores -1 (para 8va bassa), 2@tie{}(para 15ma) y
+-2 (para 15ma bassa) como argumentos.  Internamente, la función establece las propiedades
+@code{ottavation} (p.ej., para @code{"8va"} o @code{"8vb"}) y
+@code{centralCPosition}.  Para sobreescribir el texto del corchete, establezca
+@code{ottavation} después de invocar a @code{set-octavation}, es decir
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  #(set-octavation 1)
+  \set Staff.ottavation = #"8"
+  c'''
+}
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{OttavaBracket}.
+
+
+@refbugs
+
+@code{set-octavation} se confundirá cuando se produzcan cambios de clave
+en el interior de un corchete de octavación.
+
+
+@node Instrument transpositions
+@unnumberedsubsubsec Instrument transpositions
+
+@cindex transposición de MIDI
+@cindex transposición instrumental
+
+También se puede especificar el tono de un instrumento transpositor.  Esto se
+aplica a muchos instrumentos de viento, por ejemplo: los clarinetes (en Si bemol, La y
+Mi bemol), la trompa (en Fa) y la trompeta (en Si bemol, Do, Re y Mi bemol).
+
+La transposición se escribe después de la palabra clave @code{\transposition}
+
+@example
+\transposition bes   %% clarinete en Si bemol
+@end example
+
+@noindent
+Esta instrucción establece la propiedad @code{instrumentTransposition}.  El valor de esta
+propiedad se utiliza para la salida MIDI y para las citas guía.  No afecta
+a la forma en que se imprimen las notas en el pentagrama en curso.  Para cambiar la salida impresa,
+véase @ref{Transpose}.
+
+El tono usado para @code{\transposition} debe corresponderse con el sonido
+real que se oye cuando el instrumento transpositor interpreta un Do central @code{c'} escrito en el
+pentagrama.  Por ejemplo, cuando escribimos una partitura en afinación de
+concierto, normalmente todas las voces se escriben en Do, por lo que
+se introducen como
+
+@example
+clarinet = @{
+  \transposition c'
+  ...
+@}
+saxophone = @{
+  \transposition c'
+  ...
+@}
+@end example
+
+La orden @code{\transposition} se debe usar cuando la música se escribe a partir de una
+particella orquestal (transportada).  Por ejemplo, en
+particellas clásicas para trompa, el tono del instrumento con frecuencia se modifica
+durante la pieza.  Al copiar las notas de la particella, utilice
+@code{\transposition}, p.ej.,
+
+@example
+\transposition d'
+c'4^"en Re"
+...
+\transposition g'
+c'4^"en Sol"
+...
+@end example
+
diff --git a/Documentation/es/user/programming-interface.itely b/Documentation/es/user/programming-interface.itely
index 87c1cf52af..2c0986d571 100644
--- a/Documentation/es/user/programming-interface.itely
+++ b/Documentation/es/user/programming-interface.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/putting.itely b/Documentation/es/user/putting.itely
index 8f30b38a21..c8841ca5df 100644
--- a/Documentation/es/user/putting.itely
+++ b/Documentation/es/user/putting.itely
@@ -217,7 +217,7 @@ mucha flexibilidad para estructurar sus archivos de la forma que deseen.
 Sin embargo, toda esta flexibilidad puede hacer que las cosas se vuelvan confusas para
 los nuevos usuarios.  Esta sección le va a explicar parte de esta estructura, pero
 puede obviar ciertos detalles en aras de la simplicidad.  Para ver una
-descripción completa del formato de entrada, consulte @ref{File structure}.
+descripción completa del formato de entrada, consulte @ruser{File structure}.
 
 Casi todos los ejemplos del presente manual con pequeños fragmentos de código.  Por ejemplo
 
@@ -316,16 +316,16 @@ nombres -- puede ser @code{melodia}, @code{global},
 @code{manoderechadelpiano}, o @code{fulanomengano} --.  Puede
 usar el nombre de variable que desee.  Para ver más
 detalles, consulte
-@ref{Saving typing with identifiers and functions}.
+@ruser{Saving typing with identifiers and functions}.
 
 Para ver una definición completa
-del formato de entrada, consulte @ref{File structure}.
+del formato de entrada, consulte @ruser{File structure}.
 
 
 @node Score is a single musical expression
 @section Score is a single musical expression
 
-En la sección anterior, @ref{How LilyPond files work},
+En la sección anterior, @ruser{How LilyPond files work},
 pudimos 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
@@ -341,7 +341,7 @@ todo:
 
 @noindent
 Quizá encuentre útil dar un repaso a
-@ref{Music expressions explained}.  En esta sección, vimos
+@ruser{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
@@ -448,7 +448,7 @@ inferior = @{ @}
 @noindent
 Recuerde que puede usar casi cualquier nombre que se le antoje.  Las
 limitaciones impuestas a los nombres de identificador se detallan en
-@ref{File structure}.
+@ruser{File structure}.
 
 Cuando escriba una sección @code{\score} o cuando la esté
 leyendo, hágalo despacio y con cuidado.  Comience por
@@ -585,10 +585,10 @@ lo que nos lleva a
 @end lilypond
 
 Se puede encontrar una información más profunda sobre cómo preparar particellas y partituras
-en el manual de notación; consulte @ref{Orchestral music}.
+en el manual de notación; consulte @ruser{Orchestral music}.
 
 El establecimiento de variables en tiempo de ejecución (@q{propiedades}) se trata en
-@ref{Changing context properties on the fly}.
+@ruser{Changing context properties on the fly}.
 
 
 
diff --git a/Documentation/es/user/repeats.itely b/Documentation/es/user/repeats.itely
new file mode 100644
index 0000000000..5723354b08
--- /dev/null
+++ b/Documentation/es/user/repeats.itely
@@ -0,0 +1,413 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Repeats
+@section Repeats
+
+La repetición es un concepto fundamental en música, y existen varios
+tipos de notación para las repeticiones.
+
+@menu
+* Writing repeats::             
+* Other repeats::               
+@end menu
+
+@node Writing repeats
+@subsection Writing repeats
+
+@menu
+* Repeat types::                
+* Repeat syntax::               
+* Manual repeat commands::      
+* Repeats and MIDI::            
+@end menu
+
+@node Repeat types
+@unnumberedsubsubsec Repeat types
+
+@cindex repeticiones
+
+Están contemplados los siguientes tipos de repetición
+
+@table @code
+@item desplegada
+Las música repetida está completamente escrita (e interpretada).  Es
+útil cuando se introduce música repetitiva.  Éste es el único tipo de
+repetición que se incluye en la salida MIDI.
+
+@item volta (primera y segunda vez)
+Las repeticiones no están desarrolladas, pero se imprimen finales
+alternativos (volte) de izquierda a derecha con corchetes.  Ésta es la
+notación estándar para las repeticiones con alternativas.  Por omisión
+no se reproducen en la salida MIDI.
+
+
+@item trémolo
+Hacen barras de trémolo.  Por omisión no se reproducen en la salida MIDI.
+
+@item porcentaje
+Hacen repeticiones de compases o parte de ellos.  Tienen un aspecto
+semejante a un signo de porcentaje.  Por omisión no se reproducen en
+la salida MIDI.  Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
+
+@end table
+
+
+@node Repeat syntax
+@unnumberedsubsubsec Repeat syntax
+
+@cindex volta
+@cindex prima volta
+@cindex seconda volta
+@funindex \repeat
+
+LilyPond tiene una construcción sintáctica para especificar distintos
+tipos de repetición.  La sintaxis es
+
+@example
+\repeat @var{variante} @var{número_de_repeticiones} @var{cuerpo_de_la_repetición}
+@end example
+
+Si tiene finales alternativos, puede añadir
+@funindex \alternative
+@example
+\alternative @{
+  @var{alternativa1}
+  @var{alternativa2}
+  @var{alternativa3}
+  @dots{}
+@}
+@end example
+
+@noindent
+donde cada @var{alternativa} es una expresión musical.  Si no da un
+número de alternativas suficiente para todas las repeticiones, se
+supondrá que la primera alternativa se interpreta más de una vez.
+
+Las repeticiones estándar se usan de esta forma:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 { c4 d e f }
+\repeat volta 2 { f e d c }
+@end lilypond
+
+Con finales alternativos
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f}
+\alternative { {d2 d} {f f,} }
+@end lilypond
+
+Se pueden crear repeticiones con anacrusa.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 e |
+  \repeat volta 4 { c2 d2 | e2 f2 | }
+  \alternative { { g4 g g e } { a a a a | b2. } }
+}
+@end lilypond
+
+@noindent
+o bien
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 
+  \repeat volta 4 { e | c2 d2 | e2 f2 | }
+  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+}
+@end lilypond
+
+
+
+@funindex \repeatTie
+
+Se pueden añadir ligaduras de unión al segundo final,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f ~ }
+\alternative { {f2 d} {f\repeatTie f,} }
+@end lilypond
+
+Es posible acortar los corchetes de primera y segunda vez
+estableciendo @code{voltaSpannerDuration}.  En el ejemplo siguiente, el
+corchete sólo dura un compás, lo que supone una duración de 3/4.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c''{
+  \time 3/4
+  c c c
+  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
+  \repeat volta 5 { d d d }
+  \alternative { { e e e f f f }
+  { g g g } }
+}
+@end lilypond
+
+Si quiere comenzar una repetición al principio de una línea y tiene una
+doble barra al final de la línea anterior, utilice
+@example
+@dots{} \bar "||:" \break 
+\repeat volta 2 @{ @dots{} 
+@end example
+consulte @ref{Bar lines} para ver más información.
+
+@seealso
+
+Referencia del programa: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic} y
+@internalsref{UnfoldedRepeatedMusic}.
+
+Ejemplos:
+
+Normalmente los corchetes para la repetición sólo se imprimen sobre el
+pentagrama superior.  Esto se puede ajustar moviendo @code{Volta_engraver} al contexto
+Staff donde quiera que aparezcan los corchetes;
+consulte @ref{Modifying context plug-ins} y
+
+@lsr{repeats,volta@/-multi@/-staff@/.ly}.
+
+
+@refbugs
+
+@cindex repetición ambigua
+
+Una repetición anidada como
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+es ambigua porque no está claro a qué @code{\repeat} pertenece la
+@code{\alternative}.  Esta ambigüedad se resuelve haciendo que la
+@code{\alternative} pertenezca siempre a la @code{\repeat} más
+interna.  Para más claridad, se recomienda usar llaves en tales situaciones.
+
+La información del contador de tiempo no se recuerda al comienzo de una alternativa,
+por ello después de una repetición la información de la cuenta de tiempo se debe reajustar
+manualmente; por ejemplo, estableciendo el valor de @code{Score.measurePosition} o
+introduciendo @code{\partial}.  De forma similar, las ligaduras de expresión o de unión tampoco se repiten.
+
+Los corchetes de primera y segunda vez no se alinean verticalmente.
+
+
+@node Manual repeat commands
+@unnumberedsubsubsec Manual repeat commands
+
+@funindex repeatCommands
+
+Se puede usar la propiedad @code{repeatCommands} para controlar la
+disposición de las repeticiones.  Su valor es una lista de Scheme de comandos de repetición.
+
+@table @asis
+@item @code{start-repeat}
+Imprimir una barra de compás @code{|:}
+
+@item @code{end-repeat}
+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,
+porque el tipo por defecto para los números no contiene caracteres alfabéticos;
+
+@item @code{(volta #f)}
+Detener un corchete de volta mantenido.
+@end table
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c4
+  \set Score.repeatCommands = #'((volta "93") end-repeat)
+c4 c4
+  \set Score.repeatCommands = #'((volta #f))
+c4 c4
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic} y
+@internalsref{UnfoldedRepeatedMusic}.
+
+
+@node Repeats and MIDI
+@unnumberedsubsubsec Repeats and MIDI
+
+@cindex expansión de repeticiones
+@funindex \unfoldRepeats
+
+Con un poco de trucaje, todos los tipos de repeticiones pueden estar
+presentes en la salida MIDI.  Se consigue por medio de la aplicación
+de la función musical @code{\unfoldRepeats}.  Esta función transforma
+todas las repeticiones en repeticiones desarrolladas o desplegadas.
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+  \repeat tremolo 8 {c'32 e' }
+  \repeat percent 2 { c''8 d'' }
+  \repeat volta 2 {c'4 d' e' f'}
+  \alternative {
+    { g' a' a' g' }
+    {f' e' d' c' }
+  }
+}
+\bar "|."
+@end lilypond
+
+Cuando se elabora un archivo de partitura que utiliza @code{\unfoldRepeats} para el MIDI,
+es necesario hacer dos bloques @code{\score}: uno para el MIDI (con las repeticiones desplegadas)
+y otro para la notación (con primera y segunda vez, trémolo y repeticiones de porcentaje).
+Por ejemplo,
+
+@example
+\score @{
+  @var{..música..}
+  \layout @{ .. @}
+@}
+\score @{
+  \unfoldRepeats @var{..música..}
+  \midi @{ .. @}
+@}
+@end example
+
+
+@node Other repeats
+@subsection Other repeats
+
+@menu
+* Tremolo repeats::             
+* Tremolo subdivisions::        
+* Measure repeats::             
+@end menu
+
+@node Tremolo repeats
+@unnumberedsubsubsec Tremolo repeats
+
+@cindex barras de trémolo
+
+Para colocar marcas de trémolo entre las notas, use @code{\repeat} con el
+estilo tremolo
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat tremolo 8 { c16 d16 }
+  \repeat tremolo 4 { c16 d16 }
+  \repeat tremolo 2 { c16 d16 }
+}
+@end lilypond
+
+Las marcas de trémolo también se pueden poner sobre una nota única.  En este caso, la
+nota no debe estar encerrada entre llaves.
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
+@end lilypond
+
+Se obtiene una salida similar usando la subdivisión del trémolo, que se describe en
+@ref{Tremolo subdivisions}.
+
+
+@seealso
+
+En el presente manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
+
+Referencia del programa: @internalsref{Beam}, @internalsref{StemTremolo}.
+
+
+@node Tremolo subdivisions
+@unnumberedsubsubsec Tremolo subdivisions
+
+@cindex marcas de trémolo
+@funindex tremoloFlags
+
+Las marcas de trémolo se pueden imprimir sobre una nota única escribiendo
+@q{@code{:}[@var{número}]} después de la nota.  El número indica la
+duración de la subdivisión, y debe ser al menos 8.  Un valor de
+@var{longitud} de 8 produce una línea tachando la plica de la nota.  Si se
+omite la longitud,
+se utiliza el último valor (almacenado en @code{tremoloFlags})
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+c'2:8 c':32 | c': c': |
+@end lilypond
+
+
+@refbugs
+
+Los trémolos escritos de esta forma no se trasladan a la salida MIDI.
+
+
+@seealso
+
+En el presente manual: @ref{Tremolo repeats}.
+
+En otros lugares: @internalsref{StemTremolo}.
+
+
+@node Measure repeats
+@unnumberedsubsubsec Measure repeats
+
+@cindex porcentaje, repeticiones de
+@cindex compás, repeticiones de
+
+En el estilo @code{percent} (porcentaje), se puede hacer que se repita un patrón de notas.  Se
+imprime una sola vez, y luego el patrón se sustituye con un símbolo especial.
+Los patrones de uno y dos compases se sustituyen por símbolos parecidos a un porcentaje,
+y los patrones que dividen a la duración de un compás se sustituyen por barras inclinadas.
+Las repeticiones de porcentaje se deben declarar dentro de un contexto @code{Voice}.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
+}
+@end lilypond
+
+Las repeticiones de compás de más de 2 compases llevan un contador, si
+se activa la propiedad @code{countPercentRepeats},
+
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+  \repeat percent 4 { c1 }
+}
+@end lilypond
+
+
+
+También se pueden imprimir porcentajes aislados.  Esto se hace
+mediante la colocación de un silencio multicompás con una función de impresión distinta,
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+  = #ly:multi-measure-rest::percent
+R1
+@end lilypond
+
+
+
+
+@seealso
+
+Referencia del programa: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
+
+
+
diff --git a/Documentation/es/user/rhythms.itely b/Documentation/es/user/rhythms.itely
new file mode 100644
index 0000000000..a765418703
--- /dev/null
+++ b/Documentation/es/user/rhythms.itely
@@ -0,0 +1,1447 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Rhythms
+@section Rhythms
+
+This section discusses rhythms, durations, and bars.
+
+@menu
+* Writing rhythms::             
+* Writing rests::               
+* Displaying rhythms::          
+* Beams::                       
+* Bars::                        
+* Special rhythmic concerns::   
+@end menu
+
+
+@node Writing rhythms
+@subsection Writing rhythms
+
+@menu
+* Durations::                   
+* Augmentation dots::           
+* Tuplets::                     
+* Scaling durations::           
+@end menu
+
+@node Durations
+@unnumberedsubsubsec Durations
+
+@cindex duración
+@funindex \longa
+@funindex \breve
+@funindex \maxima
+
+En los modos de Nota, Acorde y Letra, las duraciones se designan
+mediante números y puntos: las duraciones se introducen como sus
+valores recíprocos respecto de la redonda.  Por ejemplo, una negra
+se escribe usando un @code{4} (puesto que es 1/4 de redonda), mientras
+que una blanca se escribe con un @code{2} (por ser 1/2 de redonda).  Para
+notas mayores de la redonda se deben usar los comandos @code{\longa} y @code{\breve}
+
+@example
+c'\breve
+c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
+r\longa r\breve
+r1 r2 r4 r8 r16 r32 r64 r64
+@end example
+
+@lilypond[quote]
+\score {
+\relative c'' {
+    a\breve*1/2 \autoBeamOff
+    a1 a2 a4 a8 a16 a32 a64 a64
+   \bar "empty"
+   \break
+    r\longa*1/4 r\breve *1/2
+    r1 r2 r4 r8 r16 r32 r64 r64
+  }
+  \layout {
+    ragged-right = ##t
+    indent=0\mm
+    \context {
+      \Score
+        \remove "Bar_number_engraver"
+    }
+    \context {
+      \Staff
+        \remove "Clef_engraver"
+        \override StaffSymbol #'transparent = ##t
+        \override TimeSignature #'transparent = ##t
+        \override BarLine #'transparent = ##t
+        \consists "Pitch_squash_engraver"
+    }
+  }
+}
+@end lilypond
+
+Si la duración se omite, su valor será el de la duración de la nota
+anterior.  Por omisión, el valor de la primera nota es el de una negra.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+{ a a a2 a a4 a a1 a }
+@end lilypond
+
+
+@node Augmentation dots
+@unnumberedsubsubsec Augmentation dots
+
+@funindex .
+
+Para obtener duraciones de notas con puntillo, simplemente escriba un
+punto (@samp{.}) después del número.  Las notas con doble puntillo se consiguen de manera similar.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+a'4 b' c''4. b'8 a'4. b'4.. c''8.
+@end lilypond
+
+@refcommands
+
+Normalmente los puntillos se desplazan hacia arriba para evitar las
+líneas del pentagrama, excepto en situaciones de polifonía.  Se pueden
+utilizar los siguientes comandos para forzar manualmente una dirección en particular
+
+@funindex \dotsUp
+@code{\dotsUp},
+@funindex \dotsDown
+@code{\dotsDown},
+@funindex \dotsNeutral
+@code{\dotsNeutral}.
+
+@seealso
+
+Referencia del programa: @internalsref{Dots} y @internalsref{DotColumn}.
+
+
+@node Tuplets
+@unnumberedsubsubsec Tuplets
+
+@cindex grupos especiales
+@cindex tresillos
+@funindex \times
+
+Los grupos especiales se obtienen a partir de una expresión musical
+multiplicando todas las duraciones por una fracción:
+
+@example
+\times @var{fracción} @var{expresión_musical}
+@end example
+
+@noindent
+La duración de la @var{expresión _musical} se multiplicará por la
+fracción.  El denominador de la fracción se imprimirá sobre las notas,
+opcionalmente con un corchete.  El grupo especial más común es el
+tresillo, en el que 3 notas tienen el valor de 2, por tanto las notas
+duran 2/3 de su valor escrito
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+g'4 \times 2/3 {c'4 c' c'} d'4 d'4
+@end lilypond
+
+Los grupos pueden anidarse unos dentro de otros, por ejemplo
+
+@lilypond[fragment,ragged-right,verbatim,relative=2]
+\override TupletNumber #'text = #tuplet-number::calc-fraction-text
+\times 4/6 {
+  a4 a
+  \times 3/5 { a a a a a }
+}
+@end lilypond
+
+@refcommands
+
+@funindex \tupletUp
+@code{\tupletUp},
+@funindex \tupletDown
+@code{\tupletDown},
+@funindex \tupletNeutral
+@code{\tupletNeutral}.
+
+
+@commonprop
+
+@funindex tupletNumberFormatFunction
+@cindex formateo de los grupos especiales
+
+La propiedad @code{tupletSpannerDuration} (duración del selector de
+grupo) especifica la duración de cada corchete.  Con esto puede hacer
+muchos grupos escribiendo @code{\times} una sola vez, ahorrándose
+mucho trabajo de teclado.  En el siguiente ejemplo se muestran dos
+tresillos, aunque @code{\times} sólo se ha utilizado una vez
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\set tupletSpannerDuration = #(ly:make-moment 1 4)
+\times 2/3 { c8 c c c c c }
+@end lilypond
+
+@noindent
+Para ver más información sobre @code{make-moment}, consulte
+@ref{Time administration}.
+
+El formato del número se determina por medio de la propiedad @code{text} en
+@code{TupletNumber}.  Por defecto se imprime sólo el denominador, pero si
+su valor se establece a la función @code{tuplet-number::calc-fraction-text},
+se imprimirá como @var{numerador}:@var{denominador}
+
+Para que no se impriman los números de los grupos, emplee
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+\override TupletNumber #'transparent = ##t
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+@end lilypond
+
+Utilice la función @code{\tweak} para sobreescribir los grupos anidados que comienzan en el mismo
+instante musical.  En este ejemplo, @code{\tweak} especifica un texto de fracción
+para el
+@code{TupletNumber} exterior y un texto de denominador para el @code{TupletNumber}
+del primero de los tres grupos interiores.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \times 4/3 {
+     \tweak #'text #tuplet-number::calc-denominator-text
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Aquí @code{\tweak} y @code{\override} trabajan conjuntamente para especificar la dirección
+del @code{TupletBracket} (el corchete del grupo).  El primer @code{\tweak} coloca
+el @code{TupletBracket} del grupo 
+exterior por encima del pentagrama.  El segundo @code{\tweak} coloca el
+@code{TupletBracket} del primero de los tres grupos interiores por debajo del
+pentagrama.  Tenga en cuenta que este par de funciones @code{\tweak} afecta solamente
+al grupo exterior y al primero de los tres grupos interiores porque sólo
+esos dos grupos comienzan en el mismo instante musical.  Utilizamos @code{\override}
+de la manera usual para colocar los corchetes @code{TupletBrackets} del
+segundo y tercer grupos interiores por debajo del pentagrama.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \tweak #'direction #up
+  \times 4/3 {
+     \tweak #'direction #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \override TupletBracket #'direction = #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Se puede hacer que los corchetes de grupo abarquen tanto como su duración completa indique o que lleguen hasta justo antes de la nota siguiente
+
+@lilypond[ragged-right]
+\new RhythmicStaff {
+  \set tupletFullLength = ##t
+  \time 4/4
+  \times 4/5 {
+    c4 c1
+  }
+  \set tupletFullLengthNote = ##t
+  \time 2/4
+  \times 2/3 {
+    c4 c c 
+  }
+  \time 3/4
+  c4 
+}
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{TupletBracket},
+@internalsref{TupletNumber} y @internalsref{TimeScaledMusic}.
+
+
+
+@node Scaling durations
+@unnumberedsubsubsec Scaling durations
+
+Es posible alterar la duración de las figuras en un factor @var{N/M}
+añadiendo @samp{*@var{N/M}} (o @samp{*@var{N}} si @var{M=1}).  Esto no
+afectará a la apariencia de las notas o silencios que se producen.  Se
+pueden combinar en la forma @samp{*M*N}.
+
+En el siguiente ejemplo las tres primeras notas duran exactamente dos
+partes, pero no se imprime ningún corchete de tresillo.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\time 2/4
+a4*2/3 gis4*2/3 a4*2/3
+a4 a4 a4*2
+b16*4 c4
+@end lilypond
+
+
+@seealso
+
+En este manual: @ref{Tuplets}.
+
+
+@node Writing rests
+@subsection Writing rests
+
+@menu
+* Rests::                       
+* Skips::                       
+* Multi measure rests::         
+@end menu
+
+@node Rests
+@unnumberedsubsubsec Rests
+@cindex Silencios
+
+@funindex \rest
+@funindex r
+
+Los silencios se introducen como notas con el nombre @code{r}
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+r1 r2 r4 r8
+@end lilypond
+
+Los silencios de un compás centrados en medio del compás,
+se deben hacer con silencios multicompás.  Se pueden usar para 
+un solo compás así como para muchos compases, y se tratan en
+@ref{Multi measure rests}.
+
+Para especificar explícitamente la posición vertical de un silencio, escriba una nota
+seguida de @code{\rest}.  Se colocará un silencio en la posición en que debería
+aparecer la nota:
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+a'4\rest d'4\rest
+@end lilypond
+
+@noindent
+Esto hace mucho más sencillo el formateo de
+la música polifónica,
+porque el formateador automático de colisiones de silencios se olvidará de ellos.
+
+@seealso
+
+Referencia del programa: @internalsref{Rest}.
+
+
+@node Skips
+@unnumberedsubsubsec Skips
+
+@cindex Desplazamiento
+@cindex Silencio invisible
+@cindex Nota de espaciado
+@funindex \skip
+@funindex s
+
+Un silencio invisible -- también conocido como @q{skip} (desplazamiento) --
+se puede introducir como una nota con el nombre @samp{s} o con @code{\skip @var{duración}}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a4 a4 s4 a4 \skip 1 a4
+@end lilypond
+
+La sintaxis de @code{s} sólo está disponible en el modo de notas y en el modo de acordes.
+En otras situaciones, por ejemplo, cuando se introduce la letra, debe
+usar el comando @code{\skip}
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+  \relative { a'2 a2 }
+  \new Lyrics \lyricmode { \skip 2 bla2 }
+>>
+@end lilypond
+
+El comando skip es un mero contenedor musical vacío.  No produce
+ninguna salida, ni siguiera una salida transparente.
+
+El comando de desplazamiento @code{s} crea una @internalsref{Staff} y una
+@internalsref{Voice} cuando es necesario, de forma similar a los comandos de nota y de silencio.
+Por ejemplo, el fragmento siguiente produce un pentagrama vacío.
+
+@lilypond[quote,ragged-right,verbatim]
+{ s4 }
+@end lilypond
+
+El fragmento @code{@{ \skip 4 @} } produciría una página vacía.
+
+@seealso
+
+Referencia del programa: @internalsref{SkipMusic}.
+
+
+@node Multi measure rests
+@unnumberedsubsubsec Multi measure rests
+
+@cindex multicompás, silencios
+@cindex compás completo, silencios de
+@cindex Silencios multicompás
+@cindex Silencios de compás completo
+@cindex redonda, silencios de, para un compás completo
+@funindex R
+
+Los silencios de un compás completo (o muchos compases) se escriben como @samp{R}.  Esto está
+indicado específicamente para silencios de compás completo y para escribir particellas: el silencio
+se puede expandir de forma que rellene una partitura con silencios, o se puede imprimir como un solo silencio multicompás.
+Esta expansión se controla por medio de la propiedad
+@code{Score.skipBars}.  Si está establecido al valor true, los compases vacíos no se
+expandirán, y se añadirá automáticamente el número correspondiente
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
+\set Score.skipBars = ##t R1*17 R1*4
+@end lilypond
+
+El número @code{1} de @code{R1} es similar a la notación de la duración que se usa para las
+notas.  De aquí que para indicaciones de compás distintas al 4/4, tengamos que escribir
+otras duraciones.  Esto se puede hacer con puntillos de prolongación o con fracciones
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+\time 3/4
+R2. | R2.*2
+\time 13/8
+R1*13/8
+R1*13/8*12 |
+\time 10/8 R4*5*4 |
+@end lilypond
+
+Una @code{R} que dura un solo compás se imprime como un silencio de redonda o breve,
+centrado en el compás independientemente de la indicación de compás.
+
+Si hay sólo algunos compases de silencio, LilyPond imprime @q{silencios eclesiásticos}
+(un conjunto de pequeños rectángulos) en el pentagrama.  Para sustituirlos con silencios ordinarios,
+utilice @code{MultiMeasureRest.expand-limit}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+R1*2 | R1*5 | R1*9
+\override MultiMeasureRest #'expand-limit = 1
+R1*2 | R1*5 | R1*9
+@end lilypond
+
+@cindex texto sobre silencios multicompás
+@cindex textual, inscripción, sobre silencios multicompás
+@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}.
+Hay una variable (@code{\fermataMarkup}) para añadir
+calderones
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\set Score.skipBars = ##t
+\time 3/4
+R2.*10^\markup { \italic "ad lib." }
+R2.^\fermataMarkup
+@end lilypond
+
+¡Advertencia!  Este texto se crea por parte de @code{MultiMeasureRestText}, no de
+@code{TextScript}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\override TextScript #'padding = #5
+R1^"low"
+\override MultiMeasureRestText #'padding = #5
+R1^"high"
+@end lilypond
+
+Si queremos poner texto a la izquierda de un silencio multicompás,
+adjuntamos el texto a una nota de salto de longitud cero, esto es
+
+@example
+s1*0^"Allegro"
+R1*4
+@end example
+
+
+@seealso
+
+Referencia del programa: @internalsref{MultiMeasureRestMusicGroup},
+@internalsref{MultiMeasureRest}.
+
+El objeto de presentación @internalsref{MultiMeasureRestNumber} es para el número
+por defecto, y @internalsref{MultiMeasureRestText} para los textos
+definidos por el usuario.
+
+
+@refbugs
+
+No se pueden usar digitaciones (p.ej. @code{R1-4}) para poner números
+encima de los silencios multicompás.  Y la altura de los silencios multicompás (o
+silencios centrados en el pentagrama) no se puede modificar.
+
+@cindex silencios condensados
+
+No hay ninguna forma de condensar automáticamente muchos silencios en un solo
+silencio multicompás.  Los silencios multicompás no toman parte en las comprobaciones de colisión de
+silencios.
+
+Tenga cuidado al escribir silencios multicompás seguidos por redondas.
+El código siguiente introduce dos notas que tienen una duración de cuatro compases cada una
+@example
+R1*4 cis cis
+@end example
+Cuando @code{skipBars} esté establecido, el aspecto del resultado será correcto, pero la numeración
+de los compases estará desactivada.
+
+
+@node Displaying rhythms
+@subsection Displaying rhythms
+
+@menu
+* Time signature::              
+* Upbeats::                     
+* Unmetered music::             
+* Polymetric notation::         
+* Automatic note splitting::    
+@end menu
+
+@node Time signature
+@unnumberedsubsubsec Time signature
+
+@cindex Indicación de compás
+@cindex metro, medida
+@funindex \time
+
+La indicación de compás indica el metro de la pieza: su patrón regular de
+partes fuertes y débiles.  Se denota por una fracción al comienzo del
+pentagrama.
+
+La indicación de compás se establece mediante el comando @code{\time}
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 2/4 c'2 \time 3/4 c'2.
+@end lilypond
+
+@commonprop
+
+Se puede personalizar el símbolo que se imprime mediante la propiedad @code{style}.
+Un valor de @code{#'()} produce un estilo de fracción para los compases de 4/4 y
+de 2/2,
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+\time 4/4 c'1
+\time 2/2 c'1
+\override Staff.TimeSignature #'style = #'()
+\time 4/4 c'1
+\time 2/2 c'1
+@end lilypond
+
+Existen otras muchas opciones para su presentación.  Para ver más ejemplos, consulte @ref{Ancient time
+signatures}.
+
+@code{\time} establece las propiedades @code{timeSignatureFraction},
+@code{beatLength} y @code{measureLength} en el contexto @code{Timing},
+cuyo nombre alternativo normalmente es @internalsref{Score}.  La
+propiedad @code{measureLength} determina el lugar en que se deben insertar las barras de compás
+y cómo se generan las barras de corchea automáticas.  La modificación del valor de
+@code{timeSignatureFraction} también provoca que se imprima
+el símbolo.
+
+Están disponibles más opciones a través de la función de Scheme
+@code{set-time-signature}.  En combinación con el grabador
+@internalsref{Measure_grouping_engraver} (agrupación de compases), creará signos de
+@internalsref{MeasureGrouping}.  Estos signos facilitan la lectura de música moderna
+rítmicamente compleja.  En el siguiente ejemplo el compás de 9/8
+se subdivide en 2, 2, 2 y 3.  Esto se pasa a
+@code{set-time-signature} como un tercer argumento con el valor @code{(2 2 2 3)}
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    #(set-time-signature 9 8 '(2 2 2 3))
+    g8[ g] d[ d] g[ g] a8[( bes g]) |
+    #(set-time-signature 5 8 '(3 2))
+    a4. g4
+  }
+  \layout {
+    \context {
+      \Staff
+      \consists "Measure_grouping_engraver"
+    }
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{TimeSignature} y
+@internalsref{Timing_translator}.
+
+Ejemplos: @lsr{contemporary,compound-time-signature.ly}.
+
+
+@refbugs
+
+EL barrado automático no utiliza la agrupación de compases especificada con
+@code{set-time-signature}.
+
+
+@node Upbeats
+@unnumberedsubsubsec Upbeats
+
+@cindex anacrusa
+@cindex parte al alzar
+@cindex compás parcial
+@cindex parcial, compás
+@cindex acortar compases
+@funindex \partial
+
+Los compases parciales como las anacrusas o partes al alzar se escriben usando la construcción
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\partial 16*5 c16 cis d dis e | a2. c,4 | b2
+@end lilypond
+
+La sintaxis de este comando es la siguiente:
+
+@example
+\partial @var{duración}
+@end example
+
+donde @code{duración} es el valor rítmico que se se debe añadir antes
+del siguiente compás.
+
+Esto se traduce internamente a
+
+@example
+\set Timing.measurePosition = -@var{longitud de la duración}
+@end example
+
+La propiedad @code{measurePosition} contiene un número racional
+que indica qué parte del compás ha transcurrido hasta el momento.
+Observe que es un número negativo; @code{\partial 4} se traduce internamente
+con el significado de @qq{queda un valor de negra en este compás}.
+
+
+@refbugs
+
+Este comando no tiene en cuenta las notas de adorno al comienzo
+de la música.  Cuando una pieza comienza con notas de adorno en la anacrusa,
+el @code{\partial} debe escribirse después de las notas de adorno
+
+@lilypond[verbatim,quote,ragged-right,relative,fragment]
+\grace f16
+\partial 4
+g4
+a2 g2
+@end lilypond
+
+El uso de @code{\partial} está previsto solamente para el comienzo de una
+pieza.  Si se emplea después del comienzo se obtendrán varias advertencias
+desagradables.
+
+
+@node Unmetered music
+@unnumberedsubsubsec Unmetered music
+
+@cindex cadencia
+@funindex \cadenzaOn
+@funindex \cadenzaOff
+
+Las líneas divisorias y los números de compás se calculan automáticamente.
+Para música sin compasear (por ejemplo cadencias), esto no es deseable.
+Para desactivar las barras y los números de compás automáticos, utilice los comandos
+@code{\cadenzaOn} y @code{\cadenzaOff}.
+
+@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
+c4 d e d
+\cadenzaOn
+c4 c d8 d d f4 g4.
+\cadenzaOff
+\bar "|"
+d4 e d c
+@end lilypond
+
+
+@refbugs
+
+LilyPond insertará saltos de línea y de página solamente en las barras de compás.
+A menos que la música sin compasear acabe antes del final de la línea del pentagrama,
+tendrá que insertar barras
+de compás invisibles
+
+@example
+\bar ""
+@end example
+
+@noindent
+para indicar dónde se pueden producir los saltos.
+
+
+@node Polymetric notation
+@unnumberedsubsubsec Polymetric notation
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Automatic note splitting
+@unnumberedsubsubsec Automatic note splitting
+
+Las notas largas se pueden convertir automáticamente en notas ligadas.
+Se hace mediante la sustitución del @internalsref{Note_heads_engraver}
+por el @internalsref{Completion_heads_engraver}.  En los siguientes
+ejemplos, las notas que atraviesan la barra de compás se dividen y se unen mediante una ligadura.
+
+@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
+\new Voice \with {
+  \remove "Note_heads_engraver"
+  \consists "Completion_heads_engraver"
+} {
+  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
+}
+@end lilypond
+
+Este grabador divide todas las notas largas en la barra de compás e
+inserta ligaduras.  Uno de sus usos es depurar partituras complejas:
+si los compases no están completos, las ligaduras mostrarán
+exactamente cuánto le falta a cada compás.
+
+Si quiere permitir el salto de línea en las barras de compás en las
+que @internalsref{Completion_heads_engraver} divide las notas, debe
+eliminar también @internalsref{Forbid_line_break_engraver}.
+
+
+@refbugs
+
+No todas las duraciones (sobre todo las que contienen grupos
+especiales) se pueden representar exactamente con notas normales y
+puntillos, pero el grabador nunca insertará grupos especiales.
+
+@code{Completion_heads_engraver} afecta sólo a las notas; no divide
+silencios.
+
+
+@seealso
+
+Referencia del programa: @internalsref{Completion_heads_engraver}.
+
+
+@node Beams
+@subsection Beams
+
+@menu
+* Automatic beams::             
+* Manual beams::                
+* Feathered beams::             
+@end menu
+
+@node Automatic beams
+@unnumberedsubsubsec Automatic beams
+
+LilyPond inserta las barras de corchea automáticamente
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
+@end lilypond
+
+Cuando estas decisiones automáticas no son lo bastante buenas, se
+pueden escribir los barrados de forma explícita.  También es posible
+definir patrones de barrado que difieran de los ajustes por defecto.
+Para ver más detalles, consulte @ref{Setting automatic beam behavior}.
+
+Las notas individuales se pueden marcar con @code{\noBeam} para evitar
+que lleven una barra
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c\noBeam c c
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{Beam}.
+
+
+@node Manual beams
+@unnumberedsubsubsec Manual beams
+
+@cindex barras manuales
+@funindex ]
+@funindex [
+
+En ciertos casos puede ser preciso sobreescribir el algoritmo de
+barrado automático.  Por ejemplo, el barrador automático no escribe
+barras por encima de los silencios o las líneas divisorias.  Tales
+barras se especifican manualmente marcando los puntos de comienzo y final con @code{[} y @code{]}
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+  r4 r8[ g' a r8] r8 g[ | a] r8
+}
+@end lilypond
+
+
+@commonprop
+
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
+
+
+LilyPond es capaz de determinar automáticamente los patrones de barrado dentro de una barra,
+pero a veces este comportamiento automático puede producir resultados extraños;
+por ello, se pueden usar las propiedades @code{stemLeftBeamCount} y @code{stemRightBeamCount}
+para sobreescribir los valores por defecto.  Si
+se establece con un valor una cualquiera de estas propiedades, dicho valor se utilizará una sola vez, y después
+se borrará.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+   f8[ r16
+      f g a]
+   f8[ r16
+   \set stemLeftBeamCount = #1
+      f g a]
+}
+@end lilypond
+
+Se puede establecer la propiedad @code{subdivideBeams} para subdividir
+todas las barras de semicorchea y de valores inferiores en las
+posiciones de las fracciones o partes, tal y como está definido por parte de la propiedad @code{beatLength}.
+
+@lilypond[fragment,quote,relative=2,verbatim]
+c16[ c c c c c c c]
+\set subdivideBeams = ##t
+c16[ c c c c c c c]
+\set Score.beatLength = #(ly:make-moment 1 8)
+c16[ c c c c c c c]
+@end lilypond
+@funindex subdivideBeams
+
+@noindent
+Para ver más información sobre @code{make-moment}, consulte
+@ref{Time administration}.
+
+Los saltos de línea normalmente están prohibidos cuando las barras
+cruzan las líneas divisorias.  Este comportamiento se puede modificar estableciendo @code{breakable}.
+
+@funindex breakable
+
+@cindex barras de corchea y saltos de línea
+@cindex barras en ángulo
+@cindex ángulo, barras en
+@cindex auto-knee-gap
+
+Se insertan automáticamente barras de corchea en ángulo cuando se
+detecta un desnivel muy grande entre las cabezas de las notas. 
+Este comportamiento se puede ajustar a través del objeto @code{auto-knee-gap}.
+
+
+@refbugs
+
+Las barras que cruzan pentagramas y reciben un ángulo automático no se
+pueden usar conjuntamente con los pentagramas ocultos.  Consulte @ref{Hiding staves}.
+
+@c Is this still true with skyline spacing stuff? -J.Mandereau
+Las barras de corchea no evitan las colisiones con los símbolos que
+rodean las notas, como los textos y las alteraciones.
+
+
+@node Feathered beams
+@unnumberedsubsubsec Feathered beams
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Bars
+@subsection Bars
+
+
+@menu
+* Bar check::                   
+* Bar lines::                   
+* Bar numbers::                 
+* Barnumber check::             
+* Rehearsal marks::             
+@end menu
+
+@node Bar check
+@unnumberedsubsubsec Bar check
+
+@cindex Compás, comprobación de
+@funindex barCheckSynchronize
+@funindex |
+
+Las comprobaciones de compás ayudan a detectar errores en las duraciones.  Una comprobación de compás se
+escribe usando el símbolo de la barra vertical, @samp{|}.  Cuando se encuentra durante 
+la interpretación, debe caer en el límite entre dos compases.  Si no es así,
+se muestra una advertencia.  En el siguiente ejemplo, la segunda comprobación
+de compás avisará de un error
+@example
+\time 3/4 c2 e4 | g2 |
+@end example
+
+Las comprobaciones de compás también se pueden usar en la letra de las canciones, por ejemplo
+
+@example
+\lyricmode @{
+  \time 2/4
+  Bri -- lla | Bri -- lla 
+@}
+@end example
+
+Las comprobaciones de compás fallidas tienen su origen en la
+introducción incorrecta de las duraciones.  Las duraciones incorrectas
+a menudo desbaratan la partitura completamente, sobre todo si la
+música es polifónica, por ello el mejor sitio para empezar a corregir
+la entrada es hacer un barrido en busca de comprobaciones de compás
+fallidas y duraciones incorrectas.
+
+@funindex |
+@funindex pipeSymbol
+
+También es posible redefinir el significado de @code{|}.  Se hace
+asignando una expresión musical a @code{pipeSymbol},
+
+@lilypond[quote,ragged-right,verbatim]
+pipeSymbol = \bar "||"
+
+{ c'2 c' | c'2 c' }
+@end lilypond
+
+
+@node Bar lines
+@unnumberedsubsubsec Bar lines
+
+@cindex Barras de compás
+@funindex \bar
+@cindex líneas divisorias
+@cindex repetición, barras de
+
+Las líneas divisorias delimitan a los compases pero también se pueden usar
+para indicar las repeticiones.  Normalmente se insertan de manera automática.
+Los saltos de línea solamente pueden producirse sobre las barras de compás.
+
+Se pueden forzar tipos especiales de línea divisoria con 
+el comando @code{\bar}
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+c4 \bar "|:" c4
+@end lilypond
+
+Se encuentran disponibles los siguientes tipos de barra:
+
+@c @lilypondfile[ragged-right,quote]{bar-lines.ly}
+
+Además se puede especificar @code{"||:"}, que equivale a
+@code{"|:"} excepto en los saltos de línea, en que produce una doble barra
+al final de la línea y una repetición izquierda (de comienzo) al principio de
+la línea siguiente.
+
+Para permitir un salto de línea donde no hay ninguna línea divisoria visible,
+utilice
+
+@example
+\bar ""
+@end example
+
+@noindent
+De esta manera se insertará una barra invisible de compás y se hará posible
+el salto de línea en este punto (sin incrementar el contador de los números de compás).
+
+En las partituras con muchos pentagramas, un comando @code{\bar} en uno de ellos se aplica
+automáticamente a todos los demás.  Las líneas resultantes se conectan entre los distintos pentagramas
+de un @code{StaffGroup}, @code{PianoStaff} o @code{GrandStaff}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+  \new StaffGroup <<
+    \new Staff {
+      e'4 d'
+      \bar "||"
+      f' e'
+    }
+    \new Staff { \clef bass c4 g e g }
+  >>
+  \new Staff { \clef bass c2 c2 }
+>>
+@end lilypond
+
+
+@commonprop
+
+@funindex whichBar
+@funindex repeatCommands
+@funindex defaultBarType
+
+El comando @code{\bar }@var{tipo_de_barra} es una forma corta de hacer
+@code{\set Timing.whichBar = }@var{tipo_de_barra}.  Cuando @code{whichBar}
+se establece con el valor de una cadena, se crea una línea divisoria de ese tipo.
+
+Una línea divisoria se crea cuando se establece la propiedad @code{whichBar}.
+Al comienzo del compás su valor se toma de
+@code{Timing.defaultBarType}.  Los contenidos de los @code{repeatCommands} se
+utilizan para sobreescribir a las barras de compás por omisión.
+
+Le recomendamos que utilice siempre @code{\repeat} para hacer repeticiones.
+Consulte @ref{Repeats}.
+
+
+@seealso
+
+En este manual: @ref{Repeats}, @ref{System start delimiters}.
+
+Referencia del programa: @internalsref{BarLine} (creada al nivel de
+@internalsref{Staff} (pentagrama)), @internalsref{SpanBar} (a través de los pentagramas).
+
+
+@node Bar numbers
+@unnumberedsubsubsec Bar numbers
+
+@cindex Compás, números de
+@cindex números de compás
+@funindex currentBarNumber
+
+Por defecto, los números de compás se imprimen al principio de la línea.  El
+número propiamente dicho se almacena en la propiedad @code{currentBarNumber}, que normalmente
+se actualiza automáticamente para cada compás.
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\repeat unfold 4 {c4 c c c} \break
+\set Score.currentBarNumber = #50
+\repeat unfold 4 {c4 c c c}
+@end lilypond
+
+Los números de compás sólo se pueden imprimir en las líneas divisorias; para imprimir un número de
+compás al principio de la pieza, se debe añadir una línea divisoria
+vacía
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\set Score.currentBarNumber = #50
+\bar ""
+\repeat unfold 4 {c4 c c c} \break
+\repeat unfold 4 {c4 c c c}
+@end lilypond
+
+Los números de compás se pueden tipografiar a intervalos regulares en vez de al principio de cada
+línea.  Esto queda ilustrado en el ejemplo siguiente,
+cuyo código fuente se encuentra disponible como
+@lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
+
+@c @lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
+
+Los números de compás se pueden suprimir completamente quitando el grabador de números de compás
+de la partitura.
+
+@lilypond[verbatim,ragged-right,quote]
+\layout {
+  \context {
+    \Score
+    \remove "Bar_number_engraver"
+  }
+}
+\relative c''{
+c4 c c c \break
+c4 c c c
+}
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{BarNumber}.
+
+Ejemplos: @lsrdir{staff}
+
+
+@refbugs
+
+Los números de compás pueden colisionar con el corchete @internalsref{StaffGroup}, si hay uno
+en la parte de arriba.  Para solucionarlo, se puede usar la propiedad de relleno
+@code{padding} de @internalsref{BarNumber} para
+colocar el número correctamente.
+
+
+@node Barnumber check
+@unnumberedsubsubsec Barnumber check
+
+Al copiar piezas musicales grandes puede servir de ayuda comprobar que
+el número de compás de LilyPond corresponde al original desde el que está copiando.
+Esto se puede comprobar con @code{\barNumberCheck}, por ejemplo
+
+@verbatim
+\barNumberCheck #123
+@end verbatim
+
+@noindent
+imprimirá una advertencia si el @code{currentBarNumber} (número del
+compás actual) no es 123 cuando se está procesando.
+
+
+@node Rehearsal marks
+@unnumberedsubsubsec Rehearsal marks
+
+@cindex Ensayo, letras de
+@funindex \mark
+
+Para imprimir una letra de ensayo, utilice la orden @code{\mark}
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1 \mark \default
+c1 \mark \default
+c1 \mark #8
+c1 \mark \default
+c1 \mark \default
+@end lilypond
+
+@noindent
+La letra@tie{}@q{I} se salta de acuerdo con las tradiciones de grabado.
+Si quiere incluir la letra @q{I}, use
+
+@example
+\set Score.markFormatter = #format-mark-alphabet
+@end example
+
+La letra de ensayo se incrementa automáticamente si usa @code{\mark
+\default}, pero también puede utilizar un número entero como argumento para establecer la indicación manualmente.
+El valor que se utilizará se almacena dentro de la propiedad
+@code{rehearsalMark}.
+
+El estilo se define por medio de la propiedad @code{markFormatter}.  Es una función
+que toma como argumentos la marca en curso (un número entero) y el contexto actual.
+Debe devolver un objeto de marcado.  En el ejemplo
+siguiente, se establece @code{markFormatter} con el valor de un procedimiento enlatado.  Después de
+algunos compases, se establece con el valor de una función que produce un número encerrado en una caja.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\set Score.markFormatter = #format-mark-numbers
+c1 \mark \default
+c1 \mark \default
+\set Score.markFormatter = #format-mark-box-numbers
+c1 \mark \default
+c1 \mark \default
+c1
+@end lilypond
+
+El archivo @file{scm/@/translation@/-functions@/.scm} contiene las definiciones de
+@code{format-mark-numbers} (el formato por omisión),
+@code{format-mark-box-numbers},
+@code{format-mark-letters} y @code{format-mark-box-letters}.
+Se pueden usar éstos como inspiración para otras funciones de formateo.
+
+Podemos utilizar @code{format-mark-barnumbers}, @code{format-mark-box-barnumbers}
+y @code{format-mark-circle-barnumbers} para obtener números de compás en lugar de
+números o letras secuenciales.
+
+Otros estilos de marca de ensayo se pueden especificar de forma manual
+
+@example
+\mark "A1"
+@end example
+
+@noindent
+@code{Score.markFormatter} no afecta a las marcas que se especifican de esta forma.
+Sin embargo, es posible aplicar un elemento @code{\markup} a la cadena.
+
+@example
+\mark \markup@{ \box A1 @}
+@end example
+
+@cindex segno
+@cindex coda
+@cindex D.S al Fine
+
+Los glifos musicales (como el segno) se pueden imprimir dentro de un elemento
+@code{\mark}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+c1 \mark \markup { \musicglyph #"scripts.segno" }
+c1 \mark \markup { \musicglyph #"scripts.coda" }
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+Consulte @ref{The Feta font} para ver una lista de los símbolos que se pueden imprimir
+con @code{\musicglyph}.
+
+Para ver formas comunes de trucar la colocación de las marcas de ensayo, consulte @ref{Text marks}.
+
+@seealso
+
+En este manual: @ref{Text marks}.
+
+Referencia del programa: @internalsref{RehearsalMark}.
+
+Archivos de inicio: @file{scm/@/translation@/-functions@/.scm} contiene la definición
+de @code{format-mark-numbers} y de
+@code{format-mark-letters}.  Se pueden usar como inspiración para escribir otras
+funciones de formateo.
+
+Ejemplos: @lsr{parts,rehearsal-mark-numbers.ly}
+
+
+@node Special rhythmic concerns
+@subsection Special rhythmic concerns
+
+
+@menu
+* Grace notes::                 
+* Aligning to cadenzas::        
+* Time administration::         
+* Proportional notation (introduction)::  
+@end menu
+
+@node Grace notes
+@unnumberedsubsubsec Grace notes
+
+@funindex \grace
+@cindex ornamentos
+@cindex mordentes
+@cindex appoggiatura
+@cindex acciaccatura
+
+Los mordentes y notas de adorno son ornamentos escritos.  El más común es la
+acciaccatura o mordente de una nota, que se debe tocar muy corta.  Se
+denota mediante una corchea pequeña, ligada, con un corchete tachado o
+atravesado por una barrita.  La appoggiatura es una nota de adorno que
+toma una fracción fija de la nota principal, y se denota como una nota
+pequeña, ligada, sin tachar.  Ambas se introducen con los comandos
+@code{\acciaccatura} y @code{\appoggiatura}, como se muestra en el ejemplo siguiente
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+b4 \acciaccatura d8 c4 \appoggiatura e8 d4
+\acciaccatura { g16[ f] } e4
+@end lilypond
+
+Ambas son formas especiales del comando @code{\grace}.  Al anteponer
+esta palabra a una expresión musical se crea una nueva expresión, que
+se imprime en un tipo más pequeño y no ocupa ningún tiempo lógico en el compás.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+c4 \grace c16 c4
+\grace { c16[ d16] } c2 c4
+@end lilypond
+
+@noindent
+Al contrario que @code{\acciaccatura} y @code{\appoggiatura}, el comando
+@code{\grace} no inicia una ligadura.
+
+@cindex timing, internal
+
+Internamente, la cuenta del tiempo para las notas de adorno se hace
+utilizando un segundo contador, el contador @q{de adorno}.  Cada
+instante en el tiempo comprende dos números racionales: uno denota el tiempo
+lógico, y el otro denota el tiempo de adorno.  El ejemplo anterior se muestra a continuación con vectores de tiempo
+
+@lilypond[quote,ragged-right]
+<<
+  \relative c''{
+    c4 \grace c16 c4 \grace {
+    c16[ d16] } c2 c4
+  }
+  \new Lyrics \lyricmode {
+    \override LyricText #'font-family = #'typewriter
+
+    \markup { (0,0) } 4
+    \grace { \markup {
+      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
+    \markup { (\fraction 1 4 , 0 ) } 4
+    \grace {
+      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
+      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
+    }
+    \markup { ( \fraction 2 4 , 0 ) }
+  }
+>>
+@end lilypond
+
+La colocación de las notas de adorno se sincroniza entre los distintos
+pentagramas.  En el siguiente ejemplo, hay dos semicorcheas de adorno
+por cada corchea de adorno
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \grace { c16[ d e f] } e4 }
+   \new Staff { c4 \grace { g8[ b] } c4 } >>
+@end lilypond
+
+@funindex \afterGrace
+
+Si quiere acabar una nota con un adorno, use el comando
+@code{\afterGrace}.  Toma dos argumentos: la nota principal y las
+notas de adorno que siguen a la nota principal.
+
+@lilypond[ragged-right, verbatim,relative=2,fragment]
+c1 \afterGrace d1 { c16[ d] } c4
+@end lilypond
+
+Esto pondrá las notas de adorno después de un @q{espacio} que dura 3/4
+de la longitud de la nota principal.  La fracción 3/4 se puede cambiar
+estableciendo @code{afterGraceFraction}, por ejemplo
+
+@example
+#(define afterGraceFraction (cons 7 8))
+@end example
+
+@noindent
+pondrá la nota de adorno a 7/8 de la nota principal.
+
+Se puede conseguir el mismo efecto de forma manual haciendo
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  << { d1^\trill_( }
+     { s2 \grace { c16[ d] } } >>
+  c4)
+}
+@end lilypond
+
+@noindent
+Ajustando la duración de la nota de desplazamiento (aquí es una
+blanca), se ajusta el espacio entre la nota principal y la de adorno.
+
+Una expresión musical @code{\grace} introduce ajustes de tipografía especiales,
+por ejemplo para producir un tipo más pequeño y para fijar las
+direcciones.  Por ello, cuando se introducen trucos para la
+presentación, deben ir dentro de la expresión de adorno, por ejemplo:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  \acciaccatura {
+    \stemDown
+    f16->
+    \stemNeutral
+  }
+  g4
+}
+@end lilypond
+
+@noindent
+Las sobreescrituras (overrides) también se deben deshacer dentro de la expresión de adorno.
+
+La disposición de las expresiones de adorno se pueden cambiar a lo largo
+de la música usando la función @code{add-grace-property}.  El
+siguiente ejemplo suprime la definición de la dirección de la
+@code{Stem} (plica) para este adorno, y así las plicas no siempre apuntan hacia arriba.
+
+@example
+\new Staff @{
+  #(add-grace-property 'Voice 'Stem 'direction '())
+  @dots{}
+@}
+@end example
+
+@noindent
+Otra opción es modificar las variables @code{startGraceMusic},
+@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
+@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic} y
+@code{stopAppoggiaturaMusic}.  Hay más información en el archivo
+@file{ly/@/grace@/-init@/.ly}.
+
+@noindent
+La barrita que cruza el corchete de las acciaccaturas se puede obtener
+en otras situaciones mediante @code{\override Stem  #'stroke-style = #"grace"}.
+
+
+@commonprop
+
+Se puede forzar que las notas de adorno utilicen espaciado flotante,
+
+@lilypond[relative=2,ragged-right]
+<<
+  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
+  \new Staff {
+     c'4
+     \afterGrace
+     c'4
+     { c'16[ c'8 c'16] }
+     c'4
+  }  
+  \new Staff {
+     c'16[ c'16 c'16 c'16]
+     c'16[ c'16 c'16 c'16]
+     c'4
+  }
+>>
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{GraceMusic}.
+
+
+@refbugs
+
+Una partitura que comienza con una expresión @code{\grace} requiere una declaración explícita
+@code{\new Voice} pues en caso contrario la nota principal y la de adorno
+acabarán en pentagramas distintos.
+
+La sincronización de las notas de adorno también puede acarrear sorpresas.  La notación de pentagramas,
+como armaduras, líneas divisorias, etc., se sincronizan también.  Ponga cuidado
+cuando mezcle pentagramas con adornos y sin adornos, por ejemplo
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" d4 } >>
+@end lilypond
+
+@noindent
+Esto se puede remediar insertando desplazamientos de adorno de las
+duraciones correspondientes en los otros pentagramas.  Para el ejemplo anterior
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
+@end lilypond
+
+Las secciones de adorno sólo se deben usar dentro de expresiones de
+música secuenciales.  No están contemplados el anidado ni la
+yuxtaposición de secciones de adorno, y podría producir caídas u otros errores.
+
+
+
+@node Aligning to cadenzas
+@unnumberedsubsubsec Aligning to cadenzas
+
+En un contexto orquestal, las cadenzas presentan un problema especial:
+al construir una partitura que tiene una cadenza, todos los demás instrumentos
+deben saltar tantas notas como la longitud de la cadenza,
+pues en caso contrario empezarán demasiado pronto o tarde.
+
+Una solución a este problema son las funciones @code{mmrest-of-length}
+y @code{skip-of-length}.  Estas funciones de Scheme toman un fragmento de música
+como argumento y generan un @code{\skip} o silencio multicompás, de la longitud exacta
+del fragmento.  El uso de @code{mmrest-of-length} se muestra
+en el ejemplo siguiente.
+
+@lilypond[verbatim,ragged-right,quote]
+cadenza = \relative c' {
+  c4 d8 << { e f g } \\ { d4. } >>
+  g4 f2 g4 g
+}
+
+\new GrandStaff <<
+  \new Staff { \cadenza c'4 }
+  \new Staff {
+    #(ly:export (mmrest-of-length cadenza))
+    c'4
+  }
+>>
+@end lilypond
+
+
+@node Time administration
+@unnumberedsubsubsec Time administration
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Proportional notation (introduction)
+@unnumberedsubsubsec Proportional notation (introduction)
+
+UNTRANSLATED NODE: IGNORE ME
+
diff --git a/Documentation/es/user/running.itely b/Documentation/es/user/running.itely
index b287c3f9cc..d19dc8d41a 100644
--- a/Documentation/es/user/running.itely
+++ b/Documentation/es/user/running.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/scheme-tutorial.itely b/Documentation/es/user/scheme-tutorial.itely
index f12683dcf1..69812f48c1 100644
--- a/Documentation/es/user/scheme-tutorial.itely
+++ b/Documentation/es/user/scheme-tutorial.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/simultaneous.itely b/Documentation/es/user/simultaneous.itely
new file mode 100644
index 0000000000..f406f37a30
--- /dev/null
+++ b/Documentation/es/user/simultaneous.itely
@@ -0,0 +1,546 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Simultaneous notes
+@section Simultaneous notes
+
+La polifonía en música hace referencia a tener más de una voz en una
+pieza cualquiera de música.  En LilyPond la polifonía hace referencia
+a tener más de una voz en el mismo pentagrama.
+
+@menu
+* Single voice::                
+* Multiple voices::             
+@end menu
+
+
+@node Single voice
+@subsection Single voice
+
+@menu
+* Chords::                      
+* Clusters::                    
+@end menu
+
+@node Chords
+@unnumberedsubsubsec Chords
+
+@cindex Acordes
+
+Un acorde se forma encerrando un conjunto de notas entre @code{<} y
+@code{>}.  Un acorde puede ir seguido de una duración o un conjunto de
+articulaciones, como si fueran simples notas.
+
+@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
+<c e g>4 <c>8
+@end lilypond
+
+Para ver más información sobre los acordes, consulte @ref{Chord names}.
+
+
+@node Clusters
+@unnumberedsubsubsec Clusters
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+@node Multiple voices
+@subsection Multiple voices
+
+@menu
+* Basic polyphony::             
+* Explicitly instantiating voices::  
+* Collision Resolution::        
+* Automatic part combining::    
+* Writing music in parallel::   
+@end menu
+
+@node Basic polyphony
+@unnumberedsubsubsec Basic polyphony
+
+@cindex polyphony
+
+La manera más fácil de escribir fragmentos con más de una voz sobre el mismo pentagrama
+es introducir cada voz como una secuencia (con @code{@{...@}}), y combinarlas
+simultáneamente, separando las voces con @code{\\}
+
+@funindex \\
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  c16 d e f
+  <<
+    { g4 f e | d2 e2 } \\
+    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
+    { s2. | s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+El separador hace que se produzca un nuevo contexto de @internalsref{Voice}@footnote{Las voces polifónicas
+se conocen a veces como @q{capas} en otros programas de edición de partituras.}.
+@cindex capas
+Llevan los nombres @code{"1"}, @code{"2"}, etc.  En cada
+uno de estos contextos, la dirección vertical de las ligaduras, plicas, etc., se establece
+de la manera que corresponda.
+
+Todas estas voces están separadas de la voz que contiene las notas
+justo por fuera de la construcción @code{<< \\ >>}.  Se debe tener
+esto en cuenta cuando haga algún cambio en una voz.  También
+significa que las ligaduras de unión y de expresión no pueden salir de (ni
+entrar en) una construcción @code{<< \\ >>}.  En cambio las voces
+paralelas que están en construcciones @code{<< \\ >>} separadas dentro
+del mismo pentagrama, son la misma voz.  Presentamos a continuación el
+mismo ejemplo, con cabezas y colores distintos para cada voz.  Dese cuenta de
+que el cambio en el estilo de cabezas de nota en la voz principal no
+afecta a las que están dentro de la construcción @code{<< \\ >>}.
+Asimismo, el cambio a la segunda voz en la primera construcción
+@code{<< \\ >>} es efectiva en la segunda @code{<< \\ >>}, y la voz se liga de una construcción a otra.
+
+@cindex cabezas de nota, estilos de
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  <<
+    { g4 f e } \\
+    { \override NoteHead #'style = #'triangle
+      \override NoteHead #'color = #blue
+    r8 e4 d c8 ~ }
+  >> |
+  <<
+    { d2 e2 } \\
+    { c8 b16 a b8 g ~ g2 } \\
+    { \override NoteHead #'style = #'slash 
+      \override NoteHead #'color = #green
+      s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+La polifonía no cambia la relación entre las notas que están dentro de
+un bloque @code{\relative @{ @}}.  Cada una de las notas se calcula
+relativa a la nota inmediatamente anterior.
+
+@example
+\relative @{ notaA << notaB \\ notaC >> notaD @}
+@end example
+
+@code{notaC} es relativa a @code{notaB}, no a @code{notaA};
+@code{notaD} es relativa a @code{notaC}, no a @code{notaB} ni a
+@code{notaA}.
+
+
+@node Explicitly instantiating voices
+@unnumberedsubsubsec Explicitly instantiating voices
+
+Los contextos de @internalsref{Voice} también se pueden instanciar manualmente
+dentro de un bloque @code{<< >>} para crear música polifónica, usando
+@code{\voiceOne}, hasta @code{\voiceFour} para asignar las direcciones de las plicas
+y un desplazamiento horizontal para cada parte.
+
+Concretamente:
+@example
+<< \superior \\ \inferior >>
+@end example
+
+@noindent
+equivale a
+
+@example
+<<
+  \new Voice = "1" @{ \voiceOne \superior @}
+  \new Voice = "2" @{ \voiceTwo \inferior @}
+>>
+@end example
+
+Los comandos @code{\voiceXXX} establecen la dirección de las plicas, ligaduras de expresión y de unión,
+articulaciones, anotaciones de texto, puntillos y digitaciones.
+@code{\voiceOne} y @code{\voiceThree} hacen
+a los mencionados objetos apuntar hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour}
+los hacen apuntar hacia abajo.
+El comando @code{\oneVoice} hace volver a los ajustes normales.
+
+Una expresión que aparece directamente dentro de un @code{<< >>} pertenece a
+la voz principal.  Es útil cuando aparecen voces adicionales al tiempo que está cantando la voz
+principal.  A continuación podemos ver una representación mejor del ejemplo del apartado anterior.
+Las cabezas de color y en forma de cruz demuestran que
+la melodía principal ahora está en un contexto de una voz única.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2 }
+    \new Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. | s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+La definición correcta de las voces permite que la melodía se pueda marcar con ligaduras de expresión.
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Al evitar el separador @code{\\} posibilitamos la escritura de
+construcciones polifónicas anidadas, lo que en algún caso podría constituir
+una forma más natural de tipografiar la música.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ |
+      <<
+        {c8 b16 a b8 g ~ g2}
+        \new Voice { \voiceThree
+          s4 b4 c2
+          \oneVoice
+        }
+      >>
+    \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+En ciertos casos de música polifónica compleja podría ser necesario
+utilizar voces adicionales para evitar colisiones entre las notas.
+Las voces adicionales se añaden definiendo un identificador como se muestra a continuación:
+
+@lilypond[quote,verbatim,ragged-right,relative=2]
+voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
+
+\relative c''' <<
+  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
+  { \voiceThree  b4} \\
+  { \voiceFive d,} \\
+  { \voiceTwo g,}
+>>
+@end lilypond
+
+
+@node Collision Resolution
+@unnumberedsubsubsec Collision Resolution
+
+Normalmente las cabezas de nota con un número de puntillos diferente
+no se mezclan en una sola, pero cuando se le da un valor verdadero a
+la propiedad @code{merge-differently-dotted} en el objeto @internalsref{NoteCollision}, se juntan en una sola:
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice << {
+  g8 g8
+  \override Staff.NoteCollision
+    #'merge-differently-dotted = ##t
+  g8 g8
+} \\ { g8.[ f16] g8.[ f16] } >>
+@end lilypond
+
+De forma similar puede mezclar cabezas de blanca con corcheas,
+ajustando @code{merge-differently-headed}:
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\new Voice << {
+  c8 c4.
+  \override Staff.NoteCollision
+    #'merge-differently-headed = ##t
+c8 c4. } \\ { c2 c2 } >>
+@end lilypond
+
+@noindent
+@code{merge-differently-headed} y @code{merge-differently-dotted}
+se aplican solamente a direcciones de plica opuestas (es decir, a las voces 1 y 2).
+
+LilyPond también desplaza verticalmente los silencios que están en el lado contrario de una plica,
+por ejemplo
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new Voice << c''4 \\ r4 >>
+@end lilypond
+
+Si tres o más notas coinciden verticalmente en la misma columna,
+@code{merge-differently-headed} no puede completar satisfactoriamente
+la mezcla de las dos notas que deberían mezclarse.
+Para hacer posible que la mezcla funcione, aplique un @code{\shift} (desplazamiento) a la nota que no
+debe mezclarse.  En el primer compás del ejemplo siguiente,
+@code{merge-differently-headed} no funciona (la cabeza de la blanca está rellena)
+En el segundo compás, se aplica @code{\shiftOn} para mover horizontalmente el
+@code{g} (Sol) superior, y @code{merge-differently-headed}
+funciona correctamente.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.NoteCollision #'merge-differently-headed = ##t
+<<
+  { d=''2 g2 } \\
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+<<
+  { d'=''2 \shiftOn g2 } \\ 
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+@end lilypond
+
+
+@refcommands
+
+@funindex \oneVoice
+@code{\oneVoice},
+@funindex \voiceOne
+@code{\voiceOne},
+@funindex \voiceTwo
+@code{\voiceTwo},
+@funindex \voiceThree
+@code{\voiceThree},
+@funindex \voiceFour
+@code{\voiceFour}.
+
+@funindex \shiftOn
+@code{\shiftOn},
+@funindex \shiftOnn
+@code{\shiftOnn},
+@funindex \shiftOnnn
+@code{\shiftOnnn},
+@funindex \shiftOff
+@code{\shiftOff}: estos comandos especifican el grado en que
+se deben desplazar los acordes de la voz en curso.
+Las voces exteriores (normalmente: la voz uno y la voz dos)
+tienen @code{\shiftOff} (desplazamiento desactivado), mientras que las voces interiores (tres y cuatro)
+tienen @code{\shiftOn} (desplazamiento activado).  @code{\shiftOnn} y @code{\shiftOnnn} definen niveles de desplazamiento
+más grandes.
+
+Cuando LilyPond no puede con todo, se pueden usar la propiedad
+@code{force-hshift} (forzar desplazamiento) del objeto @internalsref{NoteColumn}
+y los silencios con altura para sobreescribir las decisiones de tipografía.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative <<
+{
+  <d g>
+  <d g>
+} \\ {
+  <b f'>
+  \once \override NoteColumn #'force-hshift = #1.7
+  <b f'>
+} >>
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: los objetos responsables de resolver las colisiones son
+@internalsref{NoteCollision} y @internalsref{RestCollision}.
+
+
+@refbugs
+
+Cuando se emplea @code{merge-differently-headed} con una corchea (o una nota más corta)
+con la plica hacia arriba, y una blanca con la plica hacia abajo,
+la corchea no tiene el desplazamiento correcto.
+
+No están contemplados los racimos (clusters) donde la misma nota se presenta
+con diferentes alteraciones accidentales dentro del mismo acorde.  En
+este caso se recomienda usar la transcripción enarmónica, o usar la
+notación especial de racimos (ver @ref{Clusters}).
+
+
+@node Automatic part combining
+@unnumberedsubsubsec Automatic part combining
+@cindex particellas, combinación automática
+@cindex particellas, combinador de
+
+La combinación automática de particellas se usa para mezclar dos partes musicales sobre un pentagrama.
+Tiene como objetivo el tipografiado de partituras orquestales.  Cuando las dos partes
+son idénticas durante un período de tiempo, sólo se presenta una de ellas.  En los lugares
+en que las dos partes son diferentes, se tipografían como voces separadas,
+y las direcciones de las plicas se establecen de forma automática.  También las partes de solo
+y @emph{a due} quedan identificadas y es posible marcarlas.
+
+La sintaxis para la combinación de las partes es
+
+@example
+\partcombine @var{expresión_musical_1} @var{expresión_musical_2}
+@end example
+
+
+El ejemplo siguiente ejemplifica la funcionalidad básica del combinador de
+partes: poner las partes en un solo pentagrama, y establecer las direcciones de las plicas y la
+polifonía
+
+@lilypond[quote,verbatim,ragged-right,fragment]
+\new Staff \partcombine
+  \relative g' { g g a( b) c c r r }
+  \relative g' { g g r4 r e e g g }
+@end lilypond
+
+El primer Sol (@code{g}) aparece una sola vez, aunque se especificaba
+dos veces (una en cada parte).  Las direcciones de las plicas, ligaduras de expresión y ligaduras de unión se
+establecen automáticamente, dependiendo de si es un solo o un unísono.  La primera
+parte (la que tiene el contexto llamado @code{one}) siempre tiene las plicas para arriba, y
+@q{Solo}, mientras que la segunda (llamada @code{two}) siempre tiene las plicas para abajo y
+@q{Solo II}.
+
+Si queremos sólo las partes mezcladas y no las marcas textuales, podemos
+establecer la propiedad @code{printPartCombineTexts} al valor false
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Staff.printPartCombineTexts = ##f
+  \partcombine
+    \relative g' { g a( b) r }
+    \relative g' { g r4 r f }
+>>
+@end lilypond
+
+Para cambiar el texto que se imprime para los solos o la fusión, podemos
+establecer las propiedades @code{soloText}, @code{soloIIText} y
+@code{aDueText}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Score.soloText = #"ichi"
+  \set Score.soloIIText = #"ni"
+  \set Score.aDueText = #"tachi"
+  \partcombine
+    \relative g' { g4 g a( b) r }
+    \relative g' { g4 g r r f }
+>>
+@end lilypond
+
+Los dos argumentos de @code{\partcombine} se interpretan como contextos de
+@internalsref{Voice}.  Si se están usando octavas relativas,
+se debe especificar @code{\relative} para ambas expresiones musicales, es decir
+
+@example
+\partcombine
+  \relative @dots{} @var{expresión_musical_1}
+  \relative @dots{} @var{expresión_musical_2}
+@end example
+
+@noindent
+Una sección @code{\relative} que se encuentra fuera de @code{\partcombine} no tiene ningún
+efecto sobre las notas de @var{expresión_musical_1} y @var{expresión_musical_2}.
+
+@seealso
+
+Referencia del programa: @internalsref{PartCombineMusic}.
+
+@refbugs
+
+Si @code{printPartCombineTexts} está establecido, cuando las dos voces tocan y terminan las mismas notas,
+el combinador de partes puede tipografiar @code{a2} más
+de una vez en el mismo compás.
+
+@code{\partcombine} no puede estar dentro de @code{\times}.
+
+@code{\partcombine} no puede estar dentro de @code{\relative}.
+
+Internamente, el @code{\partcombine} interpreta los dos argumentos como
+@code{Voice}s llamadas @code{one} y @code{two}, y después decide cuándo se pueden combinar
+las partes.  Como consecuencia, si los argumentos cambian a
+contextos de @internalsref{Voice} con nombres diferentes, los eventos que contienen
+se ignorarán.
+
+
+@node Writing music in parallel
+@unnumberedsubsubsec Writing music in parallel
+
+@cindex Escribir música en paralelo
+@cindex Música intercalada
+
+La música para varias partes se puede intercalar
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
+  c'2                                c'2                                |
+  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
+  c'2                                c'2                                |
+}
+\new StaffGroup <<
+  \new Staff \new Voice \voiceA
+  \new Staff \new Voice \voiceB
+>>
+@end lilypond
+
+Esto funciona bastante bien para música de piano
+
+@lilypond[quote,verbatim]
+music = {
+  \key c \major
+  \time 4/4
+  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
+    % Bar 1
+    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
+e''] |
+    c'2                                 c'2 |
+    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
+    c2                                  c2 |
+
+    % Bar 2
+    a'8 b'      c'' d''    e'' f''    g'' a'' |
+    d'4         d'         d'         d' |
+    c16 d e f   d e f g    e f g a    f g a b |
+    a,4         a,4        a,4        a,4 |
+
+    % Bar 3 ...
+  }
+}
+
+\score {
+  \new PianoStaff <<
+    \music
+    \new Staff <<
+      \voiceA \\
+      \voiceB
+    >>
+    \new Staff {
+      \clef bass
+      <<
+        \voiceC \\
+        \voiceD
+      >>
+    }
+  >>
+}
+@end lilypond
+
+
diff --git a/Documentation/es/user/spacing.itely b/Documentation/es/user/spacing.itely
index d31a673763..273655ba1e 100644
--- a/Documentation/es/user/spacing.itely
+++ b/Documentation/es/user/spacing.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/es/user/specialist.itely b/Documentation/es/user/specialist.itely
new file mode 100644
index 0000000000..66edc579f2
--- /dev/null
+++ b/Documentation/es/user/specialist.itely
@@ -0,0 +1,34 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Specialist notation
+@chapter Specialist notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Vocal music:: a
+* Chords Blah:: b
+* Piano music:: c
+* Percussion:: d
+* Guitar:: e
+* Orchestral strings::
+* Bagpipes::
+* Ancient notation:: g
+@end menu
+
+@include vocal.itely
+@include chords.itely
+@include piano.itely
+@include percussion.itely
+@include guitar.itely
+@include strings.itely
+@include bagpipes.itely
+@include ancient.itely
+
+
diff --git a/Documentation/es/user/staff.itely b/Documentation/es/user/staff.itely
new file mode 100644
index 0000000000..71428077c2
--- /dev/null
+++ b/Documentation/es/user/staff.itely
@@ -0,0 +1,593 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Staff notation
+@section Staff notation
+
+staff = singular, staves = plural
+
+@menu
+* Displaying staves::           
+* Writing parts::               
+@end menu
+
+
+@node Displaying staves
+@subsection Displaying staves
+
+@menu
+* System start delimiters::     
+* Staff symbol::                
+* Hiding staves::               
+@end menu
+
+@node System start delimiters
+@unnumberedsubsubsec System start delimiters
+
+@cindex comienzo del sistema
+@cindex Pentagramas, varios
+@cindex corchete vertical
+@cindex llave vertical
+@cindex pentagramas de piano
+@cindex pentagramas, grupo de
+@cindex pauta de coro
+
+Muchas partituras constan de más de un pentagrama.  Estos pentagramas se pueden
+unir de cuatro formas distintas:
+
+@itemize @bullet
+@item El grupo comienza con una llave a la izquierda y las líneas de compás
+están conectadas.  Esto se hace con el contexto @internalsref{GrandStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new GrandStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item El grupo comienza con un corchete recto y las líneas de compás están conectadas.
+Esto se hace con el contexto
+@internalsref{StaffGroup}
+
+@lilypond[verbatim,ragged-right,quote]
+\new StaffGroup
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item El grupo comienza con un corchete recto pero las líneas de compás no están conectadas.
+Esto se hace con el contexto @internalsref{ChoirStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new ChoirStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item El grupo comienza con una línea vertical.  Las líneas de compás
+no están conectadas.  Ésta es la opción por defecto para la partitura.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+@end itemize
+
+
+@seealso
+
+Las barras de compás al principio de cada sistema son
+@internalsref{SystemStartBar}, @internalsref{SystemStartBrace} y
+@internalsref{SystemStartBracket}.  En cada contexto solamente se
+crea uno de estos tipos, y ese tipo está determinado por la propiedad
+@code{systemStartDelimiter}.
+
+
+@commonprop
+
+Los delimitadores del comienzo del sistema se pueden anidar muchas veces:
+
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup
+\relative <<
+  \set StaffGroup.systemStartDelimiterHierarchy
+    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+>>
+@end lilypond
+
+
+@node Staff symbol
+@unnumberedsubsubsec Staff symbol
+
+@cindex ajuste del símbolo del pentagrama
+
+Las notas, signos dinámicos, etc. están agrupados con un conjunto de líneas horizontales
+que reciben el nombre de pentagrama o pauta (@q{staff}, en plural @q{staves}).  En
+LilyPond, estas líneas se dibujan utilizando un objeto de presentación separado
+que se llama el @code{staff symbol} (el símbolo del pentagrama).
+
+El símbolo del pentagrama se puede ajustar en el número, grosor
+y separación de las líneas, usando las propiedades.  Esto se demuestra en los archivos de ejemplo
+@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} y
+@lsr{staff,changing-the-staff-size.ly}.
+
+Además, los pentagramas se pueden iniciar e interrumpir libremente.  Esto se
+hace con @code{\startStaff} y @code{\stopStaff}.
+
+@lilypond[verbatim,relative=2,fragment]
+b4 b
+\override Staff.StaffSymbol #'line-count = 2
+\stopStaff \startStaff
+b b
+\revert Staff.StaffSymbol #'line-count
+\stopStaff \startStaff
+b b
+@end lilypond
+
+En combinación con los pentagramas ocultos o franceses,
+esto se puede usar para componer tipográficamente secciones de ossia.  He aquí un ejemplo:
+
+@cindex ossia
+
+@c @lilypondfile{ossia.ly}
+
+@cindex pentagrama, establecer el número de líneas del
+@cindex pentagrama, establecer el grosor de las líneas del
+@cindex grosor de las líneas del pentagrama, establecer
+@cindex número de líneas del pentagrama, establecer
+
+@seealso
+
+Referencia del programa: @internalsref{StaffSymbol}.
+
+Ejemplos: @lsrdir{staff}
+
+
+@node Hiding staves
+@unnumberedsubsubsec Hiding staves
+
+@cindex Francesa, partituras a la
+@cindex Ocultación de pentagramas
+
+En las partituras orquestales, generalmente se eliminan las líneas de pauta que contienen sólo silencios;
+así se ahorra espacio.  Este estilo se llama @q{Partitura francesa}.
+Para @internalsref{Lyrics},
+@internalsref{ChordNames} y @internalsref{FiguredBass}, esta opción está
+activada por defecto.  Cuando las líneas de estos contextos resultan vacías
+después del proceso de cálculo de los saltos de línea, se eliminan.
+
+Para las pautas normales hay un contexto especializado @internalsref{Staff}, que
+hace lo mismo: las pautas que no contienen nada (o solamente
+silencios multicompás) se quitan.  La definición de contexto se almacena dentro de la variable
+@code{\RemoveEmptyStaffContext}.  Observe cómo el segundo pentagrama del siguiente ejemplo
+desaparece en la segunda línea
+
+@lilypond[quote,ragged-right,verbatim]
+\layout {
+  \context { \RemoveEmptyStaffContext }
+}
+
+{
+  \relative c' <<
+    \new Staff { e4 f g a \break c1 }
+    \new Staff { c4 d e f \break R1 }
+  >>
+}
+@end lilypond
+
+El primer sistema muestra todos los pentagramas al completo.  Si queremos que los pentagramas vacíos se
+quiten también del primer sistema, podemos establecer @code{remove-first} al valor true en
+@internalsref{VerticalAxisGroup}.
+
+@example
+\override Score.VerticalAxisGroup #'remove-first = ##t
+@end example
+
+Para quitar otros tipos de contextos, utilice @code{\AncientRemoveEmptyStaffContext}
+o @code{\RemoveEmptyRhythmicStaffContext}.
+
+Otra aplicación es hacer secciones de ossia, es decir, melodías alternativas
+sobre un trozo de pentagrama separado, con la ayuda de los pentagramas a la
+francesa.
+
+
+@node Writing parts
+@subsection Writing parts
+
+@menu
+* Metronome marks::             
+* Instrument names::            
+* Quoting other voices::        
+* Formatting cue notes::        
+@end menu
+
+@node Metronome marks
+@unnumberedsubsubsec Metronome marks
+
+@cindex Tempo
+@cindex pulsos por minuto
+@cindex metrónomo, indicación de
+
+Las indicaciones metronómicas se pueden escribir como sigue
+@example
+\tempo @var{duración} = @var{pulsos_por_minuto}
+@end example
+
+En la salida MIDI, se interpretan como un cambio de tempo.  En la salida
+visual, se imprime una indicación metronómica
+@funindex \tempo
+@lilypond[quote,ragged-right,verbatim,fragment]
+\tempo 8.=120 c''1
+@end lilypond
+
+
+@commonprop
+
+Para cambiar el tempo en la salida MIDI sin imprimir nada en la salida visual, haga invisible
+la indicación metronómica
+@example
+\once \override Score.MetronomeMark #'transparent = ##t
+@end example
+
+Para imprimir otras indicaciones metronómicas, use estas instrucciones de marcado
+@lilypond[quote,ragged-right,verbatim,relative,fragment]
+c4^\markup {
+  (
+  \smaller \general-align #Y #DOWN \note #"16." #1
+  =
+  \smaller \general-align #Y #DOWN \note #"8" #1
+  ) }
+@end lilypond
+
+@noindent
+Consulte @ref{Text markup} para ver más detalles.
+
+
+@seealso
+
+Referencia del programa: @internalsref{MetronomeMark}.
+
+
+@refbugs
+
+No se comprueba la existencia de colisiones.  Si tenemos notas por encima de la línea superior del pentagrama
+(o notas con articulaciones, ligaduras, texto, etc), la indicación metronómica
+se podría imprimir encima de los símbolos musicales.  Si esto ocurre,
+aumente el relleno adicional de la indicación metronómica para colocarla
+más lejos del pentagrama.
+
+@example
+\override Score.MetronomeMark #'padding = #2.5
+@end example
+
+
+@node Instrument names
+@unnumberedsubsubsec Instrument names
+
+En una partitura orquestal, los nombres de los instrumentos se imprimen en el lado izquierdo
+de los pentagramas.
+
+Esto se puede conseguir estableciendo @internalsref{Staff}.@code{instrumentName}
+y @internalsref{Staff}.@code{shortInstrumentName}, o bien
+@internalsref{PianoStaff}.@code{instrumentName} y
+@internalsref{PianoStaff}.@code{shortInstrumentName}.  Esto
+imprimirá el texto antes del
+principio del pentagrama.  Para el primer pentagrama se usa @code{instrumentName},
+y para los siguientes se usa @code{shortInstrumentName}.
+
+@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
+\set Staff.instrumentName = "Ploink "
+\set Staff.shortInstrumentName = "Plk "
+c1
+\break
+c''
+@end lilypond
+
+También podemos usar elementos de marcado de texto para construir nombres de instrumento más complicados,
+por ejemplo
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\set Staff.instrumentName = \markup {
+  \column { "Clarinetti"
+            \line { "in B" \smaller \flat } } }
+c''1
+@end lilypond
+
+Si queremos centrar los nombres de instrumento, hemos de centrarlos todos
+
+@lilypond[quote,verbatim,ragged-right]
+{ <<
+\new Staff {
+  \set Staff.instrumentName = \markup {
+    \center-align { "Clarinetti"
+      \line { "in B" \smaller \flat } } }
+  c''1
+}
+\new Staff {
+  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
+  c''1
+}
+>>
+}
+@end lilypond
+
+Para nombres de instrumento más largos, puede ser útil aumentar el valor de
+@code{indent} dentro del bloque @code{\layout}.
+
+Para centrar los nombres de instrumento y al mismo tiempo dejar espacio adicional a la derecha,
+
+@lilypond[quote,verbatim,ragged-right]
+\new StaffGroup \relative
+<<
+  \new Staff {
+    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
+    c1 c1
+  }
+  \new Staff {
+    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
+    c1 c1
+  }
+>>
+@end lilypond
+
+Para añadir nombres de instrumento a otros contextos (como @code{GrandStaff},
+@code{ChoirStaff} o @code{StaffGroup}), debemos añadir el grabador
+a dicho contexto.
+
+@example
+\layout@{
+  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
+@}
+@end example
+
+@noindent
+Se puede encontrar más información sobre cómo añadir y suprimir grabadores
+en @ref{Modifying context plug-ins}.
+
+Los nombres de instrumento se pueden cambiar en mitad de una pieza,
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\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
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{InstrumentName}.
+
+
+@node Quoting other voices
+@unnumberedsubsubsec Quoting other voices
+
+@cindex guías
+
+Con las citas, se pueden insertar fragmentos de otras partes directamente dentro de una
+parte.  Antes de que una parte pueda ser citada, se debe marcar especialmente como
+citable.  Esto se hace con la instrucción @code{\addQuote}.
+
+@example
+\addQuote @var{nombre} @var{música}
+@end example
+
+
+@noindent
+Aquí, @var{nombre} es una cadena identificativa.  La @var{música} es cualquier tipo
+de música.  He aquí un ejemplo de @code{\addQuote}
+
+@example
+\addQuote clarinete \relative c' @{
+  f4 fis g gis
+@}
+@end example
+
+Esta orden se debe escribir en el nivel más alto, es decir, fuera de cualquier bloque de
+música.
+
+Después de la llamada a @code{\addQuote}, la cita se puede hacer con
+@code{\quoteDuring} o con @code{\cueDuring},
+
+@example
+\quoteDuring #@var{nombre} @var{música}
+@end example
+
+En el transcurso de una parte, un fragmento de música se puede citar con la instrucción
+@code{\quoteDuring}.
+
+@example
+\quoteDuring #"clarinete" @{ s2. @}
+@end example
+
+Esto citaría tres negras (la duración de la blanca con puntillo @code{s2.})  de la voz
+@code{clarinete} que se escribió previamente.
+
+
+De manera más precisa, toma el paso de tiempo actual de la parte que se está imprimiendo,
+y extrae las notas en el punto correspondiente de la voz
+@code{\addQuote}ada.  Por tanto, el argumento de @code{\addQuote}
+debe ser la parte completa de la voz que se va a citar, incluidos los silencios
+del principio, si los hay.
+
+Las citas tienen en cuenta tanto la transposición del instrumento origen como la del de destino,
+si se han especificado utilizando la instrucción @code{\transposition}.
+
+@lilypond[quote,ragged-right,verbatim]
+\addQuote clarinet \relative c' {
+  \transposition bes
+  f4 fis g gis
+}
+
+{
+  e'8 f'8 \quoteDuring #"clarinet" { s2 }
+}
+@end lilypond
+
+Los tipos de eventos que aparecen en las notas guía se pueden recortar con
+la propiedad @code{quotedEventTypes}.  El valor por defecto es
+@code{(note-event rest-event)}, lo que significa que sólo las notas y los silencios
+de la voz citada acaban en el @code{\quoteDuring}.
+Al establecer
+
+@example
+\set Staff.quotedEventTypes =
+       #'(note-event articulation-event dynamic-event)
+@end example
+
+@noindent
+se citarán las notas (pero no los silencios), además de las inscripciones textuales y de dinámica.
+
+@refbugs
+
+Sólo los contenidos de la primera @internalsref{Voice} que aparece dentro de una
+instrucción @code{\addQuote} se tendrán en consideración para su cita, así que
+@var{música} no puede contener sentencias @code{\new} y @code{\context Voice}
+que podrían producir el cambio a una Voz diferente.
+
+La cita de notas de adorno es defectuosa e incluso puede causar una caída del programa LilyPond.
+
+La cita de tresillos anidados puede dar como resultado una notación pobre.
+
+
+@seealso
+
+En este manual: @ref{Instrument transpositions}.
+
+Ejemplos: @lsr{parts,quote.ly}, @lsr{parts,quote-transportation.ly}
+
+Referencia del programa: @internalsref{QuoteMusic}.
+
+
+@node Formatting cue notes
+@unnumberedsubsubsec Formatting cue notes
+
+@cindex guía, formateo de las notas
+
+La sección anterior trata de la inserción de notas que proceden de otra voz.
+Hay una función musical más avanzada que se llama @code{\cueDuring},
+que facilita el formateo de las notas guía.
+
+La sintaxis es
+
+@example
+  \cueDuring #@var{nombre} #@var{arriba_abajo} @var{música}
+@end example
+
+Esto insertará las notas de la parte @var{nombre} en una
+@internalsref{Voice} llamada @code{cue}.  Esto ocurre de forma simultánea
+con @var{música}, que por lo general es un silencio.  Cuando comienzan las notas guía,
+el pentagrama se hace polifónico por un momento.  El argumento
+@var{arriba_abajo} determina si las notas guía se deben tipografiar como
+primera o como segunda voz.
+
+
+@lilypond[verbatim,ragged-right]
+smaller = {
+  \set fontSize = #-2
+  \override Stem #'length-fraction = #0.8
+  \override Beam #'thickness = #0.384
+  \override Beam #'length-fraction = #0.8
+}
+
+\addQuote clarinet \relative {
+  R1*20
+  r2 r8 c' f f
+}
+
+\new Staff \relative  <<
+
+  % setup a context for cue notes.
+  \new Voice = "cue" { \smaller \skip 1*21 }
+
+  \set Score.skipBars = ##t
+
+  \new Voice {
+    R1*20
+    \cueDuring #"clarinet" #UP {
+      R1
+    }
+    g4 g2.
+  }
+>>
+@end lilypond
+
+
+Presentamos a continuación un par de consejos para culminar con éxito la escritura de notas guía.
+
+@itemize @bullet
+@item
+Las notas guía tienen un tamaño tipográfico menor.
+@item
+ la parte citada se marca con el instrumento que toca la cita.
+@item
+ cuando la parte original vuelve, se debe marcar con el nombre del instrumento
+ original.
+
+@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
+
+@c Yes, this is good practice.  Otherwise, the start of the original
+@c part can only be seen from the font size.  This is not good enough
+@c for sight-reading.  It is possilbe to use other
+@c markers (e.g. a big close-bracket over the staff) to indicate the cue
+@c   notes are
+@c finished.
+@c -hwn
+
+
+Además cualquier otro cambio introducido por la parte citada se debe deshacer.
+Por ejemplo, si el instrumento citado toca en una clave distinta,
+la clave original se debe hacer constar de nuevo.
+
+@end itemize
+
+La macroinstrucción @code{\transposedCueDuring} es
+útil para añadir notas guía a instrumentos que utilizan un rango de octava completamente distinto
+(por ejemplo, tener una cita del piccolo dentro de la parte de
+contrafagot).
+
+@lilypond[verbatim,ragged-right,quote]
+picc = \relative c''' {
+  \clef "treble^8"
+  R1 |
+  c8 c c e g2 |
+  a4 g g2 |
+}
+\addQuote "picc" { \picc }
+
+cbsn = \relative c, {
+  \clef "bass_8"
+  c4 r g r
+  \transposedCueDuring #"picc" #UP c,, { R1 } |
+  c4 r g r |
+}
+
+<<
+  \context Staff = "picc" \picc
+  \context Staff = "cbsn" \cbsn
+>>
+@end lilypond
+
+
diff --git a/Documentation/es/user/strings.itely b/Documentation/es/user/strings.itely
new file mode 100644
index 0000000000..cb997dfc61
--- /dev/null
+++ b/Documentation/es/user/strings.itely
@@ -0,0 +1,41 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Orchestral strings
+@section Orchestral strings
+
+This section includes extra information for writing for orchestral
+strings.
+
+@menu 
+* Orchestral strings TODO::
+@end menu
+
+@node Orchestral strings TODO
+@subsection Orchestral strings TODO
+
+
+@menu 
+* Artificial harmonics (strings)::
+@end menu
+
+@node Artificial harmonics (strings)
+@unnumberedsubsubsec Artificial harmonics (strings)
+
+@cindex armónicos artificiales
+
+Los armónicos artificiales se tipografían con un estilo de cabeza distinto.  Se
+introducen marcando la nota que es un armónico mediante @code{\harmonic}.
+
+@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
+<c g'\harmonic>4
+@end lilypond
+
+
diff --git a/Documentation/es/user/text.itely b/Documentation/es/user/text.itely
new file mode 100644
index 0000000000..7d2160bbd6
--- /dev/null
+++ b/Documentation/es/user/text.itely
@@ -0,0 +1,807 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Text
+@section Text
+
+Esta sección explica cómo incluir texto (con diversos estilos de formateo) en las
+partituras.
+
+@cindex Texto, en otros idiomas
+Para escribir texto con caracteres acentuados y especiales (como los de idiomas distintos del inglés),
+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::                 
+@end menu
+
+
+@node Writing text
+@subsection Writing text
+
+@menu
+* Text scripts::                
+* Text and line spanners::      
+* Text spanners::               
+* Text marks::                  
+* New dynamic marks::           
+@end menu
+
+@node Text scripts
+@unnumberedsubsubsec Text scripts
+
+@cindex Texto, inscripciones de
+@cindex texto, elementos no vacíos de
+@cindex no vacíos, textos
+
+Es posible colocar cadenas de texto arbitrarias o @ref{Text markup},
+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{\fatText}, las anchuras se tendrán en cuenta
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+c4^"longtext" \fatText c4_"longlongtext" c4
+@end lilypond
+
+@noindent
+Para evitar que el texto influya sobre el espaciado, utilice @code{\emptyText}.
+
+También se pueden añadir a una nota textos con un formato más complejo utilizando la
+orden markup (marcado),
+
+@lilypond[fragment,ragged-right,verbatim,quote]
+c'4^\markup { bla \bold bla }
+@end lilypond
+
+La instrucción @code{\markup} se describe con más detalle en
+@ref{Text markup}.
+
+
+@refcommands
+
+@funindex \fatText
+@code{\fatText},
+@funindex \emptyText
+@code{\emptyText}.
+
+
+@commonprop
+
+La comprobación (por parte del programa) que asegura que las inscripciones de texto y la letra se encuentran dentro de los márgenes, es
+una tarea computacional relativamente grande.  Para acelerar el procesado, lilypond de entrada no realiza
+dichos cálculos; para habilitarlo, utilice
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+
+@seealso
+
+En este manual: @ref{Text markup}.
+
+Referencia del programa: @internalsref{TextScript}.
+
+
+@node Text and line spanners
+@unnumberedsubsubsec Text and line spanners
+
+Ciertas indicaciones de ejecución, p.ej., @i{rallentando},
+@i{accelerando} y los @i{trinos} se escriben como texto y se extienden
+sobre muchos compases mediante líneas, a veces punteadas u onduladas.
+
+Todos ellos usan las mismas rutinas que el glissando para dibujar los textos y las líneas,
+y por ello el ajuste fino de su comportamiento se hace de la
+misma manera. Se hace con un spanner (un objeto de extensión), y la rutina responsable
+de dibujar los objetos de extensión es @code{ly:line-interface::print}. Esta
+rutina determina la colocación exacta de los dos @i{extremos del
+objeto de extensión} y dibuja una línea entre ellos, en el estilo solicitado.
+
+He aquí un ejemplo de los distintos estilos de línea disponibles, y cómo
+aplicarles ajustes finos.
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+d2 \glissando d'2
+\once \override Glissando #'dash-fraction = #0.5
+d,2 \glissando d'2
+\override Glissando #'style = #'dotted-line
+d,2 \glissando d'2
+\override Glissando #'style = #'zigzag
+d,2 \glissando d'2
+\override Glissando #'style = #'trill
+d,2 \glissando d'2
+@end lilypond
+
+La información que determina los puntos extremos se calcula al vuelo
+para cada objeto gráfico, pero es posible sobreescribirlos.
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+e2 \glissando f
+\once \override Glissando #'bound-details #'right #'Y = #-2
+e2 \glissando f
+@end lilypond
+
+El objeto @code{Glissando}, como cualquier otro que use la rutina
+@code{ly:line-interface::print}, conlleva una lista asociativa
+anidada. En la instrucción anterior, el valor de @code{Y}
+se establece a @code{-2} para la lista asociativa correspondiente al extremo final de la
+derecha. Por supuesto, también es posible ajustar el extremo de la izquierda con
+@code{left} en vez de @code{right}.
+
+Si no se establece el valor de @code{Y}, se calcula a partir de la posición
+vertical del punto de anclaje derecho del objeto de extensión.
+
+En el caso de un salto de línea, los valores de los puntos extremos se extienden
+con los contenidos de las sublistas @code{left-broken} y @code{right-broken},
+por ejemplo
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+\override Glissando #'breakable = ##T 
+\override Glissando #'bound-details #'right-broken #'Y = #-3
+c1 \glissando \break
+f1
+@end lilypond
+
+Las siguientes propiedades se pueden usar para el ajuste fino de los objetos de extensión:
+
+@table @code
+@item Y
+Establece la coordenada Y del punto extremo, en espacios de pentagrama.  Por
+omisión, es el centro del objeto con que enlaza.  Así, para un glissando
+apuntaría al centro vertical de la cabeza de la nota.
+
+Para objetos de extensión horizontales, como el de texto y los trinos, tiene el valor
+fijo de cero.
+
+@item attach-dir
+Determina el lugar donde la línea comienza y acaba en la dirección X,
+relativo al objeto al que se enlaza.  Así, un valor de @code{-1} (o
+@code{LEFT}) hace que la línea comience o acabe en el lado izquierdo de la cabeza de la nota
+a la que el objeto se encuentra adjuntado.
+
+@item X
+Es la coordenada absoluta del extremo final. Normalmente
+se calcula al vuelo y no tiene mucho sentido sobreescribirlo.
+
+@item stencil
+Los objetos extensores de línea pueden tener símbolos al principio o al final, que se encuentra contenido
+dentro de esta subpropiedad.  Es para uso interno y se recomienda
+usar @code{text}.
+
+@item text
+Es un elemento de marcado que se evalúa para generar la propiedad stencil anterior. Se usa
+para poner @i{cresc.} y @i{tr} sobre los objetos de extensión horizontales.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override TextSpanner #'bound-details #'left #'text
+   = \markup { \small \bold Slower }
+c2\startTextSpan b c a\stopTextSpan
+@end lilypond
+
+@item stencil-align-dir-y
+@item stencil-offset
+Sin un valor establecido para esto, el stencil se coloca simplemente sobre el extremo del final,
+tal y como se encuentra definido por las subpropiedades @code{X} e @code{Y}.
+La asignación de un valor para @code{stencil-align-dir-y} o para @code{stencil-offset}
+desplaza el símbolo del extremo de forma relativa al extremo de la línea
+
+@lilypond[relative=1,fragment,verbatim]
+\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
+\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
+
+\override TextSpanner #'bound-details #'left #'text = #"gggg"
+\override TextSpanner #'bound-details #'right #'text = #"hhhh"
+c4^\startTextSpan c c c \stopTextSpan
+@end lilypond
+
+@item arrow (flecha)
+El establecimiento de esta subpropiedad al valor de @code{#t} produce una cabeza de flecha al final de la
+línea.
+
+@item padding (relleno)
+Esta subpropiedad controla el espacio entre el punto extremo de la línea especificado
+y el extremo real.  Sin relleno, un glissando empezaría
+y acabaría en el centro de las cabezas de las notas.
+
+@end table
+
+@seealso
+
+Referencia del programa: @internalsref{TextSpanner},
+@internalsref{Glissando}, @internalsref{VoiceFollower},
+@internalsref{TrillSpanner}, @internalsref{line-spanner-interface}.
+
+Ejemplos: @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
+
+
+@node Text spanners
+@unnumberedsubsubsec Text spanners
+
+@cindex Texto, objetos de extensión de
+
+Algunas indicaciones de interpretación, p.ej., @i{rallentando} o @i{accelerando},
+se escriben como texto y se extienden sobre varios compases con líneas de puntos.
+Estos textos se crean mediante objetos de extensión; añada
+@code{\startTextSpan} y @code{\stopTextSpan} a la primera y última
+notas del intervalo abarcado por el objeto de extensión.
+
+La cadena de caracteres que se imprime, así como el estilo, se establecen a través de las
+propiedades de objeto
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c1
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \upright "rall" } 
+c2\startTextSpan b c\stopTextSpan a
+\break
+\textSpannerUp
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \italic "rit" } 
+c2\startTextSpan b c\stopTextSpan a
+@end lilypond
+
+@refcommands
+
+@funindex textSpannerUp
+@code{\textSpannerUp},
+@funindex textSpannerDown
+@code{\textSpannerDown},
+@funindex textSpannerNeutral
+@code{\textSpannerNeutral}.
+
+
+@commonprop
+
+Para imprimir una línea continua, use
+
+@example
+\override TextSpanner #'dash-fraction = #'()
+@end example
+
+
+@seealso
+
+Referencia del programa: @internalsref{TextSpanner}.
+
+
+@node Text marks
+@unnumberedsubsubsec Text marks
+
+@cindex coda sobre la línea divisoria
+@cindex segno sobre la línea divisoria
+@cindex calderón sobre la línea divisoria
+@cindex líneas divisorias, símbolos sobre las
+@funindex \mark
+
+La instrucción @code{\mark} (llamada de ensayo) se usa principalmente para
+@ref{Rehearsal marks},
+pero también se puede usar para poner símbolos como coda,
+segno y calderón encima de una línea divisoria.  Utilice @code{\markup} para
+acceder al símbolo apropiado (los símbolos se encuentran relacionados en
+@ref{The Feta font}).
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+@code{\mark} se tipografía solamente sobre el pentagrama superior de la partitura.  Si
+especifica la instrucción @code{\mark} en una línea divisoria, la llamada resultante
+se coloca encima de la barra.  Si lo especifica en medio de un compás
+la llamada resultante se coloca entre las notas.  Si se especifica
+antes del comienzo de una línea de la partitura, se coloca
+antes de la primera nota de esta línea.  Por último, si la marca se produce en un salto
+de línea, se imprimirá al principio
+de la línea siguiente.
+@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
+@c  delete this sentence.   -gp
+Si no hay ninguna línea después de la actual, la llamada no se imprimirá en absoluto.
+
+
+@commonprop
+
+Para imprimir la llamada al final de la línea actual, utilice
+
+@example
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+@end example
+
+Con frecuencia, @code{\mark} se utiliza para añadir texto al final de un compás.  En tales
+casos es muy útil cambiar el @code{#'self-alignment}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+c1 c c c4 c c c
+\once \override Score.RehearsalMark #'self-alignment-X = #right
+\mark "D.S. al Fine "
+@end lilypond
+
+Las llamadas de texto se pueden alinear con otros objetos de notación además de las líneas
+divisorias,
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\relative {
+  c1
+  \key cis \major
+  \clef alto
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  \mark "on key"
+  cis
+  \key ces \major
+  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
+  \clef treble
+  \mark "on clef"
+  ces
+  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
+  \key d \minor
+  \clef tenor
+  \time 3/4
+  \mark "on time"
+  c
+}
+@end lilypond
+
+Los símbolos posibles para la lista @code{break-align-symbols} son
+@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
+@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
+@code{key-signature} y @code{time-signature}.
+
+Las llamadas de texto, por omisión se alinearán con el punto medio del objeto de notación,
+pero esto se puede cambiar sobreescribiendo las propiedades
+@code{break-align-anchor-alignment} y
+@code{break-align-anchor} para el objeto gráfico apropiado.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+{
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  c1
+  \key cis \major
+
+  % the RehearsalMark will be aligned with the left edge of the KeySignature
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
+  \mark \default
+  cis1
+  \key ces \major
+
+  % the RehearsalMark will be aligned with the right edge of the KeySignature
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
+  \mark \default
+  ces1
+  \key cis \major
+
+  % the RehearsalMark will be aligned with the left edge of the KeySignature
+  % and then shifted right by 2 units.
+  \once \override Staff.KeySignature #'break-align-anchor = #2
+  \mark \default
+  ces1
+}
+@end lilypond
+
+Aunque normalmente las llamadas textuales se imprimen sólo encima del pentagrama superior,
+podemos alterar este comportamiento para que se impriman sobre todos los pentagramas,
+
+@lilypond[quote,ragged-right,verbatim,relative=2]
+{
+  \new Score \with {
+    \remove "Mark_engraver"
+  }
+  <<
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c''1 \mark "foo" c'' }
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c'1 \mark "foo" c' }
+  >>
+}
+@end lilypond
+
+
+@seealso
+
+Referencia del programa: @internalsref{RehearsalMark}.
+
+
+@node New dynamic marks
+@unnumberedsubsubsec New dynamic marks
+
+Es posible imprimir nuevas indicaciones de dinámica o texto que debe ir alineado
+con ellas.  Utilice @code{make-dynamic-script} para crear estas
+indicaciones.  Tenga en cuenta que la tipografía de dinámica contiene solamente los caracteres
+@code{f,m,p,r,s} y @code{z}.
+
+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
+ver más detalles.
+
+@cindex make-dynamic-script
+
+@lilypond[quote,verbatim,ragged-right]
+sfzp = #(make-dynamic-script "sfzp")
+\relative c' {
+  c4 c c\sfzp c
+}
+@end lilypond
+
+@cindex dinámica, indicaciones, editoriales
+@cindex dinámica, indicaciones, paréntesis
+
+También es posible imprimir las indicaciones de dinámica entre paréntesis redondos o entre corchetes rectos.
+Éstos se usan con frecuencia para añadir indicaciones de dinámica editoriales.
+
+@lilypond[quote,verbatim,ragged-right]
+rndf = \markup{ \center-align {\line { \bold{\italic (}
+  \dynamic f \bold{\italic )} }} }
+boxf = \markup{ \bracket { \dynamic f } }
+{ c'1_\rndf c'1_\boxf }
+@end lilypond
+
+
+
+@node Text markup
+@subsection Text markup
+
+@menu
+* Text markup introduction::    
+* Nested scores::               
+* Page wrapping text::          
+* Font selection::              
+@end menu
+
+@node Text markup introduction
+@unnumberedsubsubsec Text markup introduction
+
+@cindex marcado
+@cindex texto, marcado de
+@cindex marcado de texto
+@cindex tipografiar texto
+
+Utilice @code{\markup} para tipografiar texto.  Las instrucciones se escriben con la barra
+invertida @code{\}.  Para escribir @code{\} and @code{#}, utilice
+comillas dobles.
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { hello }
+c1_\markup { hi there }
+c1^\markup { hi \bold there, is \italic {anyone home?} }
+c1_\markup { "\special {weird} #characters" }
+@end lilypond
+
+@noindent
+Consulte @ref{Overview of text markup commands}, para ver una lista de todas las
+instrucciones.
+
+@code{\markup} se usa principalmente para indicaciones del tipo @internalsref{TextScript},
+pero también se pueden usar en cualquier lugar donde se requiere texto en lilypond
+
+@lilypond[quote,verbatim]
+\header{ title = \markup{ \bold { foo \italic { bar! } } } }
+\score{
+  \relative c'' {
+    \override Score.RehearsalMark
+      #'break-visibility = #begin-of-line-invisible
+    \override Score.RehearsalMark #'self-alignment-X = #right
+
+    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
+    c2^\markup{ don't be \flat }
+    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
+    b2\startTextSpan
+    a2\mark \markup{ \large \bold Fine }
+    r2\stopTextSpan
+    \bar "||"
+  }
+  \addlyrics { bar, foo \markup{ \italic bar! } }
+}
+@end lilypond
+
+Una orden @code{\markup} también se puede poner por sí misma, fuera de cualquier bloque
+@code{\score}, véase @ref{Multiple scores in a book}.
+
+@lilypond[quote,ragged-right,verbatim]
+\markup{ Here is some text. }
+@end lilypond
+
+@cindex cambio de tipografía
+
+El elemento de marcado en el ejemplo presenta un ejemplo de las instrucciones de cambio de tipografía.  Las órdenes
+@code{\bold} e @code{\italic} se aplican sólo a la siguiente palabra;
+para aplicar una orden a más de una palabra, encierre las palabras
+entre llaves,
+
+@example
+\markup @{ \bold @{ buenos días @} @}
+@end example
+
+@noindent
+Para mayor claridad, también puede hacerlo para argumentos de una sola palabra, p.ej.
+
+@example
+\markup @{ ¿hay \italic @{ alguien @} ahí? @}
+@end example
+
+En el modo de marcado puede componer expresiones, similares a las expresiones
+matemáticas, documentos XML y expresiones musicales.  Podemos apilar
+las expresiones en grupos verticales con la instrucción @code{\column}.
+De forma similar, @code{\center-align} alinea textos por sus líneas medias:
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { \column { a bbbb \line { c d } } }
+c1^\markup { \center-align { a bbbb c } }
+c1^\markup { \line { a b c } }
+@end lilypond
+
+Las listas sin una instrucción previa no se mantienen separadas.  La expresión
+
+@example
+\center-align @{ @{ a b @} @{ c d @} @}
+@end example
+
+@noindent
+
+equivale a
+
+@example
+\center-align @{ a b c d @}
+@end example
+
+@noindent
+
+Para dejar separadas las listas de palabras, podemos utilizar comillas @code{"} o la
+orden @code{\line}
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c4^\markup{ \center-align { on three lines } }
+c4^\markup{ \center-align { "all one line" } }
+c4^\markup{ \center-align { { on three lines } } }
+c4^\markup{ \center-align { \line { on one line } } }
+@end lilypond
+
+Los elementos de marcado se pueden almacenar dentro de variables, y estas variables se pueden adjuntar a notas,
+como en
+@example
+allegro = \markup @{ \bold \large @{ Allegro @} @}
+ @{ a^\allegro b c d @}
+@end example
+
+Ciertos objetos tienen procedimientos de alineación propios, que cancelan
+cualquier efecto de las alineaciones aplicadas a sus argumentos de marcado en su conjunto.
+Por ejemplo la @internalsref{RehearsalMark} se centra
+horizontalmente, por lo que usar @code{\mark \markup @{ \left-align .. @}} no tiene
+ningún efecto.
+
+Además, la colocación vertical se realiza después de crear el objeto
+de marcado de texto.  Si queremos mover un elemento de marcado completo,
+tenemos que usar la propiedad de relleno #'padding o crear un punto de @q{anclaje}
+dentro del elemento de marcado (generalmente con @code{\hspace #0}).
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c'4^\markup{ \raise #5 "not raised" }
+\once \override TextScript #'padding = #3
+c'4^\markup{ raised }
+c'4^\markup{ \hspace #0 \raise #1.5 raised }
+@end lilypond
+
+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}
+para ver más detalles.
+
+
+@seealso
+
+En el presente manual: @ref{Overview of text markup commands}.
+
+Referencia del programa: @internalsref{TextScript}.
+
+Archivos de inicio: @file{scm/@/new@/-markup@/.scm}.
+
+
+@refbugs
+
+El «kerning» y la generación de ligaduras de texto se hacen sólo cuando se usa el «backend» o fundamento de @TeX{}.
+En este caso, LilyPond no se encarga de ellos y así los textos
+quedarán espaciados ligeramente más separados.
+
+Los errores de sintaxis para el modo de marcado son confusos.
+
+
+@node Nested scores
+@unnumberedsubsubsec Nested scores
+
+Es posible anidar música dentro de los elementos de marcado, añadiendo un bloque @code{\score}
+a una expresión de marcado.  Dicha partitura debe contener un bloque
+@code{\layout}.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  c4 d^\markup {
+    \score {
+      \relative { c4 d e f }
+      \layout { }
+    }
+  }
+  e f
+}
+@end lilypond
+
+@node Page wrapping text
+@unnumberedsubsubsec 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:
+
+@verbatim
+\markuplines {
+  \justified-lines {
+    Un texto muy largo de líneas justificadas.
+    ...
+  }
+  \justified-lines {
+    Otro párrafo muy largo.
+    ...
+  }
+  ...
+}
+@end verbatim
+
+@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}.
+
+@seealso
+
+En este manual: @ref{Overview of text markup list commands}, 
+@ref{New markup list command definition}.
+
+@refcommands
+
+@funindex \markuplines
+@code{\markuplines}
+
+@node Font selection
+@unnumberedsubsubsec Font selection
+
+@cindex fuente tipográfica, selección de la
+@cindex fuente tipográfica, ampliación
+@funindex font-interface
+
+Estableciendo las propiedades de objetos que se describen más abajo, puede seleccionar
+una fuente tipográfica de entre las familias tipográficas preconfiguradas.  LilyPond contempla por defecto
+la tipografía musical feta. Las tipografías del texto se seleccionan a través de
+Pango/FontConfig. La fuente tipográfica con serifa por defecto es New Century Schoolbook,
+las tipografías sans y tipo máquina de escribir son por defecto las que correspondan a la instalación
+de Pango.
+
+
+@itemize @bullet
+@item @code{font-encoding}
+es un símbolo que establece la disposición de los glifos.  Se debe ajustar solamente para
+seleccionar distintos tipos de tipografías no textuales, p.ej.:
+
+@code{fetaBraces} para las llaves de sistemas de piano, @code{fetaMusic} la
+tipografía estándar de música, incluyendo los glifos de la música antigua, @code{fetaDynamic} para
+indicaciones dinámicas y @code{fetaNumber} para la tipografía de números.
+
+@item @code{font-family}
+es un símbolo que indica la clase general de la tipografía.  Están contemplados
+@code{roman} (Computer Modern), @code{sans} y @code{typewriter} (monoespaciado).
+
+@item @code{font-shape}
+es un símbolo que indica la forma de la tipografía.  Normalmente están disponibles varias
+formas de tipografía para cada familia.  Se puede elegir entre
+@code{italic} (cursiva), @code{caps} (versalitas) y @code{upright} (recta).
+
+@item @code{font-series}
+es un símbolo que indica la serie de la tipografía.  Normalmente cada familia y forma de
+tipografía tiene varias series.  Se puede elegir entre
+@code{medium} (normal) y @code{bold} (negrita).
+
+@end itemize
+
+Las tipografías seleccionadas de la forma que se acaba de esquematizar, vienen con una hoja de estilos predefinida.
+Si quiere usar una tipografía desde fuera de la hoja de estilos,
+ajuste la propiedad
+@code{font-name},
+
+@lilypond[fragment,verbatim]
+{
+  \override Staff.TimeSignature #'font-name = #"Charter"
+  \override Staff.TimeSignature #'font-size = #2
+  \time 3/4
+  c'1_\markup {
+    \override #'(font-name . "Vera Bold")
+      { This text is in Vera Bold }
+  }
+}
+@end lilypond
+
+@noindent
+Se puede usar cualquier tipografía en la medida en que esté disponible por parte de Pango/FontConfig.
+Para conseguir una lista completa de todas las tipografías que están disponibles, ejecute la orden
+@example
+lilypond -dshow-available-fonts blabla
+@end example
+(el último argumento de la instrucción puede ser cualquier cosa, pero debe estar presente).
+
+
+El tamaño de la tipografía se puede establecer con la propiedad @code{font-size}.
+El tamaño resultante se toma como relativo al tamaño
+@code{text-font-size} tal y como está definido en el bloque @code{\paper}.
+
+@cindex fuente tipográfica, tamaño de la
+@cindex fuente tipográfica, aumento
+
+
+También es posible cambiar la familia por defecto de la tipografía para todo el
+documento.  Esto se hace llamando al árbol @code{make-pango-font-tree} desde
+dentro del bloque @code{\paper}. La función toma los nombres de las familias tipográficas
+que se deseen utilizar para el texto en estilo roman, sans serif y monoespaciado.  Por
+ejemplo,
+
+
+@cindex fuentes tipográficas, establecer la familia de las
+@cindex Pango
+
+
+@lilypond[verbatim]
+\paper  {
+  myStaffSize = #20
+
+  #(define fonts
+    (make-pango-font-tree "Times New Roman"
+                          "Nimbus Sans"
+                          "Luxi Mono"
+                           (/ myStaffSize 20)))
+}
+
+{
+  c'^\markup { roman: foo \sans bla \typewriter bar }
+}
+@end lilypond
+
+@c we don't do Helvetica / Courier, since GS incorrectly loads
+@c Apple TTF fonts
+
+
+
+@seealso
+
+Ejemplos: @lsr{text,font@/-family@/-override.ly}.
+
+
diff --git a/Documentation/es/user/tutorial.itely b/Documentation/es/user/tutorial.itely
index e40ab3ad2d..3f0b57adc5 100644
--- a/Documentation/es/user/tutorial.itely
+++ b/Documentation/es/user/tutorial.itely
@@ -58,7 +58,7 @@ Pruébelo sobre esta imagen:
 Cortando y pegando todo lo que se encuentra dentro de la sección @qq{ly snippet} (fragmento de tipo ly), tendrá una
 plantilla inicial para sus experimentos.  Si le agrada esta forma de aprender,
 probablemente quiera imprimir o añadir a sus favoritos la dirección de la
-@ref{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes
+@ruser{Cheat sheet}, que es una relación en forma de tabla de las instrucciones más comunes
 de manera que sirvan de referencia rápida.
 @end ifhtml
 
@@ -366,17 +366,17 @@ He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos:
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Introducir alturas y duraciones
-véase @ref{Pitches} y @ref{Durations}.
+véase @ruser{Pitches} y @ruser{Durations}.
 @item Silencios
-véase @ref{Rests}.
+véase @ruser{Rests}.
 @item Indicaciones de compás y otras instrucciones de tiempo
-véase @ref{Time signature}.
+véase @ruser{Time signature}.
 @item Claves
-véase @ref{Clef}.
+véase @ruser{Clef}.
 @end table
 @end quotation
 
@@ -459,13 +459,13 @@ ignora (pero los comentarios no pueden incluir otros comentarios).  El siguiente
 @end itemize
 
 Hay más trucos para elaborar archivos de entrada en
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
 
 
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-Como vimos en @ref{Working on text files}, la entrada de LilyPond debe estar
+Como vimos en @ruser{Working on text files}, la entrada de LilyPond debe estar
 rodeada de llaves @{ @} o de @code{\relative c'' @{ ... @}}.  Durante el
 resto del presente manual, la mayor parte de los ejemplos omitirán las llaves.
 
@@ -509,9 +509,9 @@ o un pentagrama.
 @node Relative note names
 @subsection Relative note names
 
-Como hemos visto en @ref{Simple notation}, LilyPond calcula la altura de
+Como hemos visto en @ruser{Simple notation}, LilyPond calcula la altura de
 cada nota de forma relativa respecto de la nota anterior@footnote{Existe otra forma de
-introducir las alturas, @ref{Absolute note names}, pero en la práctica el modo
+introducir las alturas, @ruser{Absolute note names}, pero en la práctica el modo
 relativo es mucho más cómodo y seguro de utilizar.}.  Si no se añade ninguna marca de octava
 (@code{'} y @code{,}), se supone que cada altura se encuentra dentro de una
 cuarta desde la nota anterior.
@@ -526,13 +526,13 @@ c2 fis
 c2 ges
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Octavas relativas
-ver @ref{Relative octaves}.
+ver @ruser{Relative octaves}.
 @item Comprobación de octava
-ver @ref{Octave check}.
+ver @ruser{Octave check}.
 @end table
 @end quotation
 
@@ -549,7 +549,7 @@ ha podido adivinar, un @rglos{double sharp} o @rglos{double flat} se hace
 añadiendo @samp{isis} o @samp{eses}@footnote{Esta sintaxis
 derivó de las convenciones de las lenguas nórdicas y germánicas para nombrar las notas
 como el alemán y el holandés.  Para utilizar otros nombres para las alteraciones accidentales, vea
-@ref{Note names in other languages}.}
+@ruser{Note names in other languages}.}
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 cis1 ees fisis, aeses
@@ -611,16 +611,16 @@ e
 Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo
 al teclear, pero la ventaja es que la transposición es más fácil, y las
 alteraciones se pueden imprimir siguiendo varias convenciones distintas.  Consulte
-@ref{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
+@ruser{Automatic accidentals} para ver ejemplos de cómo se pueden imprimir las alteraciones
 de acuerdo a reglas diferentes.
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Alteraciones accidentales
-ver @ref{Accidentals} y @ref{Automatic accidentals}.
+ver @ruser{Accidentals} y @ruser{Automatic accidentals}.
 @item Armadura de la tonalidad
-ver @ref{Key signature}.
+ver @ruser{Key signature}.
 @end table
 @end quotation
 
@@ -676,15 +676,15 @@ se pueden anidar unas dentro de otras.
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Ligaduras de unión
-ver @ref{Ties}.
+ver @ruser{Ties}.
 @item Ligaduras de expresión
-ver @ref{Slurs}.
+ver @ruser{Slurs}.
 @item Ligaduras de fraseo
-ver @ref{Phrasing slurs}.
+ver @ruser{Phrasing slurs}.
 @end table
 @end quotation
 
@@ -742,15 +742,15 @@ Los crescendi y decrescendi comienzan con las órdenes @code{\<} y
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Articulaciones
-ver @ref{Articulations}.
+ver @ruser{Articulations}.
 @item Digitaciones
-ver @ref{Fingering instructions}.
+ver @ruser{Fingering instructions}.
 @item Matices
-ver @ref{Dynamics}.
+ver @ruser{Dynamics}.
 @end table
 @end quotation
 
@@ -774,13 +774,13 @@ con @samp{]}.
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Barras automáticas
-ver @ref{Automatic beams}.
+ver @ruser{Automatic beams}.
 @item Barras manuales
-ver @ref{Manual beams}.
+ver @ruser{Manual beams}.
 @end table
 @end quotation
 
@@ -833,15 +833,15 @@ c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Notas de adorno
-ver @ref{Grace notes},
+ver @ruser{Grace notes},
 @item Grupos especiales
-ver @ref{Tuplets},
+ver @ruser{Tuplets},
 @item Anacrusas
-ver @ref{Partial measures}.
+ver @ruser{Partial measures}.
 @end table
 @end quotation
 
@@ -964,7 +964,7 @@ para músicas complejas como las partituras polifónicas.
 @node Multiple staves
 @subsection Multiple staves
 
-Como ya hemos visto en @ref{Music expressions explained}, los archivos de entrada para LilyPond
+Como ya hemos visto en @ruser{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.
@@ -1000,7 +1000,7 @@ menos de las matemáticas.  La fórmula @math{(4+5)} es una expresión, por tant
 
 Las indicaciones de compás escritas en un pentagrama afectan al
 resto de ellos@footnote{Este comportamiento se puede cambiar si uno lo desea; consulte
-@ref{Polymetric notation} para ver más detalles.}. En cambio,
+@ruser{Polymetric notation} para ver más detalles.}. En cambio,
 la armadura de la tonalidad de un pentagrama @emph{no} afecta a los otros
 pentagramas.
 
@@ -1022,7 +1022,7 @@ pentagramas.
 @cindex salto de pentagrama, establecimiento manual
 @cindex voz de pentagrama cruzado, establecimiento manual
 La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de
-este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ref{Multiple staves},
+este sistema de pentagramas se parece al ejemplo polifónico que aparece en @ruser{Multiple staves},
 pero en esta ocasión la expresión completa se coloca dentro de un @code{PianoStaff}:
 
 @example
@@ -1043,9 +1043,9 @@ He aquí un pequeño ejemplo:
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Ver @ref{Piano music}.
+Ver @ruser{Piano music}.
 @end quotation
 
 @node Combining notes into chords
@@ -1121,9 +1121,9 @@ Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Ver @ref{Basic polyphony}.
+Ver @ruser{Basic polyphony}.
 @end quotation
 
 
@@ -1196,10 +1196,10 @@ dando como resultado unas líneas cortas entre cada dos sílabas:
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 Otras posibilidades como poner varios versos debajo de una melodía, se
-discuten en @ref{Vocal music}.
+discuten en @ruser{Vocal music}.
 @end quotation
 
 
@@ -1252,10 +1252,10 @@ una hoja de canción con acordes (@q{lead sheet}):
 @end lilypond
 
 
-@moreinfo
+@seealso
 @quotation
 Puede ver una lista completa de los modificadores y otras opciones de presentación
-en @ref{Chords}.
+en @ruser{Chords}.
 @end quotation
 
 
@@ -1302,7 +1302,7 @@ Los cambios en la sintaxis se tratan mediante un programa especial,
 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
-@ref{Version number}.
+@ruser{Version number}.
 
 @example
 \version "2.11.23"
@@ -1318,7 +1318,7 @@ principal; el bloque @code{\header} normalmente se sitúa por debajo del
 @end example
 
 Cuando se procesa el archivo, el título y el autor se imprimen por encima
-de la música.  Puede obtener más información sobre los títulos en @ref{Creating
+de la música.  Puede obtener más información sobre los títulos en @ruser{Creating
 titles}.
 
 
@@ -1458,12 +1458,12 @@ lugares.  El siguiente ejemplo utiliza las variables anteriores:
 @subsection After the tutorial
 
 Después de terminar el tutorial, quizá debería probar a escribir una o dos
-piezas.  Comience con una de las @ref{Templates} y añada algunas
+piezas.  Comience con una de las @ruser{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
-@ref{Basic notation}.  Si quiere escribir música para un conjunto
+@ruser{Basic notation}.  Si quiere escribir música para un conjunto
 instrumental que no está cubierto por ninguna plantilla,
-consulte @ref{Extending the templates}.
+consulte @ruser{Extending the templates}.
 
 Una vez que ha escrito algunas piezas cortas, lea el resto del
 Manual de aprendizaje (capítulos 3 al 5).  ¡Por supuesto, no pasa nada por
@@ -1476,7 +1476,7 @@ y volver a ellos cuando haya adquirido más experiencia.
 @node How to read the manual
 @subsection How to read the manual
 
-Como ya vimos en @ref{How to read the tutorial}, muchos ejemplos del
+Como ya vimos en @ruser{How to read the tutorial}, muchos ejemplos del
 tutorial omitían el @code{\relative c'' @{ ... @}} alrededor del ejemplo
 mostrado.
 
@@ -1495,5 +1495,5 @@ y pulse con el ratón sobre la imagen de la música.  De esta forma se mostrará
 exacta que LilyPond usó para generar este manual.
 
 Para informarse sobre la estructura que tiene el resto del manual, consulte
-@ref{About this manual}.
+@ruser{About this manual}.
 
diff --git a/Documentation/es/user/tweaks.itely b/Documentation/es/user/tweaks.itely
index e3c99f814f..3c47819a87 100644
--- a/Documentation/es/user/tweaks.itely
+++ b/Documentation/es/user/tweaks.itely
@@ -135,7 +135,7 @@ tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando a
 siguiente fragmento de texto).  Para cambiar el comportamiento permanentemente a partir
 del comando, omita el @code{\once}.  Para detener este truco, use
 @code{\revert} (revertir).  Todo esto se explica en profundidad en
-@ref{The \override command}.
+@ruser{The \override command}.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
@@ -157,20 +157,20 @@ c4^"piu mosso" d e f
 
 @seealso
 
-En el presente manual: @ref{The \override command}, @ref{Common tweaks}.
+En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
 
 
 @node Fixing overlapping notation
 @section Fixing overlapping notation
 
-En @ref{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
+En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
 El mismo mecanismo se puede usar para mover otros tipos de
 objetos; simplemente sustituya @code{TextScript} con el nombre de
 otro objeto.
 
 Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
 final de la página relevante dentro de la documentación.  Por ejemplo, al
-final de @ref{Dynamics}, vemos
+final de @ruser{Dynamics}, vemos
 
 @quotation
 @seealso
@@ -247,7 +247,7 @@ Observe en el segundo ejemplo cuán importante es determinar qué contexto
 maneja un objeto determinado.  Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
 se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
 contexto @code{Voice} no se tendrán en cuenta.  Para ver más detalles, consulte
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
 
 @cindex extra-offset (desplazamiento adicional)
 
@@ -378,7 +378,7 @@ espacio suficiente en ellas.
 Al investigar asuntos relacionados con la presentación, la herramienta
 @code{annotate-spacing} (anotar el espaciado) no tiene precio.
 Este comando imprime los valores de algunos comandos de espaciado;
-consulte @ref{Displaying spacing} para ver más detalles.  A partir de
+consulte @ruser{Displaying spacing} para ver más detalles.  A partir de
 la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
 
 Aparte de los márgenes, existen otras opciones para ahorrar espacio:
@@ -431,7 +431,7 @@ Otro ejemplo es desplazar las expresiones dinámicas que se
 
 @item
 Altere el espaciado horizontal por medio de @code{SpacingSpanner}.  Consulte
-@ref{Changing horizontal spacing} para ver más detalles.
+@ruser{Changing horizontal spacing} para ver más detalles.
 
 @lilypond[verbatim,quote]
 \score {
@@ -461,8 +461,8 @@ Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profund
 comandos como
 @code{\override TextScript #'extra-offset = ( 1 . -1)}.  Pero
 tenemos un potencial incluso mayor si utilizamos Scheme.  Para ver una explicación completa
-de esto, consulte el @ref{Scheme tutorial} e
-@ref{Interfaces for programmers}.
+de esto, consulte el @ruser{Scheme tutorial} e
+@ruser{Interfaces for programmers}.
 
 Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
 
diff --git a/Documentation/es/user/vocal.itely b/Documentation/es/user/vocal.itely
new file mode 100644
index 0000000000..e0ed6f8111
--- /dev/null
+++ b/Documentation/es/user/vocal.itely
@@ -0,0 +1,1070 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Vocal music
+@section Vocal music
+
+Puesto que los archivos de entrada de LilyPond son de texto, hay un par de cuestiones dignas de
+consideración cuando se trabaja con música vocal:
+
+@itemize @bullet
+@item
+Los textos de las canciones se deben entrar como texto, no como notas.  Por ejemplo,
+la entrada@tie{}@code{d} se debe interpretar como una sílaba de una sola letra, no como la
+nota@tie{}Re.
+
+@item
+Los textos de las canciones se deben alinear con las notas respectivas de la melodía.
+@end itemize
+
+Existen varias formas diferentes de definir la letra; comenzaremos
+examinando el método más simple, y poco a poco iremos aumentando la complejidad.
+
+@menu
+* TODO subsection vocal music::  
+@end menu
+
+
+@commonprop
+
+Las comprobaciones que aseguran que las indicaciones textuales y las letras se encuentran dentro de los márgenes
+es una tarea computacional relativamente grande.  Para acelerar el procesado, lilypond no realiza
+estos cálculos por defecto; para activarlos, utilice
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+Para hacer que la letra evite las líneas divisorias también, utilice
+@example
+\layout @{
+  \context @{
+    \Lyrics
+      \consists "Bar_engraver"
+      \consists "Separating_line_group_engraver"
+      \override BarLine #'transparent = ##t
+  @}
+@}
+@end example
+
+
+@node TODO subsection vocal music
+@subsection TODO subsection vocal music
+
+@menu
+* Setting simple songs::        
+* Entering lyrics::             
+* Aligning lyrics to a melody::  
+* Automatic syllable durations::  
+* Another way of entering lyrics::  
+* Assigning more than one syllable to a single note::  
+* More than one note on a single syllable::  
+* Extenders and hyphens::       
+* Working with lyrics and identifiers::  
+* Flexibility in placement::    
+* Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Lyrics independent of notes::  
+* Spacing lyrics::              
+* More about stanzas::          
+* Other vocal issues::          
+@end menu
+
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+La manera más fácil de poner letra a una melodía es añadir
+
+@example
+\addlyrics @{ @var{la letra} @}
+@end example
+
+@noindent
+a la melodía.  He aquí un ejemplo:
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+Se pueden añadir más versos mediante la adición de más 
+secciones @code{\addlyrics}
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+La instrucción @code{\addlyrics} no puede manejar situaciones de polifonía.  Para estos
+casos tendrá que usar @code{\lyricsto} y @code{\lyricmode}, tal y como se explicará
+en @ref{Entering lyrics}.
+
+
+
+@node Entering lyrics
+@unnumberedsubsubsec Entering lyrics
+
+@cindex letra
+@funindex \lyricmode
+@cindex puntuación
+@cindex espacios, en la letra
+@cindex comillas, en la letra
+
+La letra de las canciones se introduce en un modo de entrada especial que se inicia
+mediante la palabra clave @code{\lyricmode}, o bien mediante @code{\addlyrics} ó
+@code{\lyricsto}.  En este modo puede introducir la letra,
+con puntuación y acentos, y el carácter @code{d} no se analiza como
+una nota, sino más bien como una sílaba de una sola letra.  Las sílabas se introducen
+como las notas, pero con texto en lugar de alturas de nota.  Por ejemplo,
+
+@example
+\lyricmode @{ Cam-4 pa-4 ni- ta del- lu- gar2 @}
+@end example
+
+Existen dos métodos principales para especificar la colocación horizontal
+de las sílabas, bien especificando la duración de cada sílaba
+de forma explícita, como en el ejemplo anterior, o bien alineando automáticamente
+la letra a la melodía o a cualquier otra voz, usando @code{\addlyrics}
+o @code{\lyricsto}.
+@c  TODO: broken
+@c For more details see @ref{The Lyrics context}.
+
+Una palabra o sílaba de la letra comienza con un carácter alfabético, y termina
+con
+cualquier espacio o dígito.  Los caracteres que siguen pueden ser cualesquiera excepto
+un dígito o un espacio.
+
+Cualquier carácter excepto un dígito o un espacio en blanco se considera
+parte de una sílaba; esto tiene una importante consecuencia, y es que
+una palabra puede terminar en @code{@}}, lo que con frecuencia conduce al siguiente error:
+
+@example
+\lyricmode @{ la- la@}
+@end example
+
+En este ejemplo, el símbolo @code{@}} se encuentra incluido dentro de la sílaba final, por tanto la
+llave de apertura no se compensa con la correspondiente llave de cierre y el archivo de entrada
+probablemente no se podrá procesar.
+
+
+@funindex \property dentro de \lyricmode
+
+@noindent
+De forma similar, un punto que sigue a una secuencia alfabética queda incluido dentro de
+la cadena resultante.  Como consecuencia, se deben insertar espacios antes y después de los
+comandos de propiedades: @emph{no} escriba
+
+@example
+\override Score.LyricText #'font-shape = #'italic
+@end example
+
+@noindent
+sino lo siguiente:
+
+@example
+\override Score . LyricText #'font-shape = #'italic
+@end example
+
+@funindex _
+@cindex espacios, en la letra
+@cindex comillas, en la letra
+@cindex ligaduras, en la letra
+
+Para asignar más de una sílaba a una única nota, puede
+rodearlas por comillas o usar un carácter @code{_} (guión bajo), para obtener espacios
+entre las sílabas, o usar el símbolo de tilde curva (@code{~}) para obtener una ligadura entre sílabas de la letra.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+La ligadura de texto se construye con el carácter Unicode U+203F, por tanto debe
+asegurarse de que tiene instalada una tipografía (como DejaVuLGC) que incluya este
+glifo.
+
+
+Para escribir letra con caracteres de una lengua no inglesa, o que tenga
+caracteres acentuados o especiales (como el símbolo del corazón o comillas inclinadas),
+introduzca simplemente los caracteres directamente en el archivo de entrada y guárdelo
+con una codificación utf-8.  Consulte @ref{Text encoding}, para ver más información.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative { e4 f e d e f e2 }
+\addlyrics { He said: “Let my peo ple go”. }
+@end lilypond
+
+Para utilizar comillas normales en la letra, escriba una barra invertida antes de las
+comillas.  Por ejemplo,
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
+\addlyrics { "\"I" am so lone- "ly\"" said she }
+@end lilypond
+
+La definición completa del comienzo de una palabra en el modo Lyrics (letra) es algo más
+compleja.
+
+Una palabra en el modo Lyrics comienza por: un carácter alfabético, @code{_},
+@code{?}, @code{!}, @code{:}, @code{'}, los caracteres de control desde @code{^A}
+hasta @code{^F}, desde @code{^Q} hasta @code{^W}, @code{^Y}, @code{^^},
+cualquier carácter de 8 bits con código ASCII por encima del 127, o una combinación de
+dos caracteres consistente en la combinación de una barra invertida seguida por @code{`}, @code{'},
+@code{"} ó @code{^}.
+
+Para definir identificadores que contengan letra, se debe usar la función
+@code{lyricmode}.
+
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+  <<
+    \new Voice = "one" \relative c'' @{
+      \autoBeamOff
+      \time 2/4
+      c4 b8. a16 g4. f8 e4 d c2
+    @}
+    \addlyrics @{ \verseOne @}
+  >>
+@}
+@end example
+
+
+@seealso
+
+Referencia del programa: @internalsref{LyricText}, @internalsref{LyricSpace}.
+
+
+
+@node Aligning lyrics to a melody
+@unnumberedsubsubsec Aligning lyrics to a melody
+
+@funindex \lyricmode
+@funindex \addlyrics
+@funindex \lyricsto
+
+
+La letra se imprime a través de su interpretación dentro del contexto llamado
+@internalsref{Lyrics}.
+
+@example
+\new Lyrics \lyricmode @dots{}
+@end example
+
+Existen dos métodos principales para especificar la colocación horizontal
+de las sílabas:
+
+@itemize @bullet
+@item
+alineando automáticamente
+el texto a una melodía o a otra voz, utilizando @code{\addlyrics}
+o @code{\lyricsto}.
+
+@item
+o especificando la duración de cada sílaba
+explícitamente, utilizando @code{\lyricmode}
+@end itemize
+
+@menu
+* Automatic syllable durations::  
+* Another way of entering lyrics::  
+* Assigning more than one syllable to a single note::  
+* More than one note on a single syllable::  
+* Extenders and hyphens::       
+@end menu
+
+@node Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
+
+@cindex duraciones automáticas de las sílabas
+@cindex letra y melodías
+
+La letra se puede alinear automáticamente bajo una melodía
+dada.  Esto se consigue combinando la
+melodía y el texto con la expresión @code{\lyricsto}
+
+@example
+\new Lyrics \lyricsto @var{nombre} @dots{}
+@end example
+
+Esto alinea la letra a las
+notas del contexto de @internalsref{Voice} llamado @var{nombre}, que debe
+existir previamente.  Por ello la @code{Voice} normalmente se especifica en primer lugar, y
+después se especifica la letra con @code{\lyricsto}.  La instrucción
+@code{\lyricsto} cambia automáticamente al modo @code{\lyricmode}, por lo que la
+palabra clave @code{\lyricmode} se puede omitir.
+
+El ejemplo siguiente utiliza comandos diferentes para introducir la letra.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+<<
+  \new Voice = "one" \relative c'' {
+    \autoBeamOff
+    \time 2/4
+    c4 b8. a16 g4. f8 e4 d c2
+  }
+  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
+  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
+  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
+>>
+@end lilypond
+
+El segundo verso no está bien alineado porque las duraciones
+no se han especificado.  Una solución para eso sería usar @code{\lyricsto}.
+
+El comando @code{\addlyrics} es realmente tan sólo una forma cómoda de
+escribir una estructura de LilyPond más complicada que establece la
+letra.
+
+@example
+@{ MÚSICA @}
+\addlyrics @{ LETRA @}
+@end example
+
+@noindent
+es lo mismo que
+
+@example
+\new Voice = "blabla" @{ MÚSICA @}
+\new Lyrics \lyricsto "blabla" @{ LETRA @}
+@end example
+
+@node Another way of entering lyrics
+@unnumberedsubsubsec Another way of entering lyrics
+
+El texto también se puede introducir sin @code{\addlyrics} ni
+@code{\lyricsto}.  En este caso,
+las sílabas se escriben como notas (pero con las alturas sustituidas por texto) y la
+duración de cada sílaba se debe escribir explícitamente.  Por ejemplo:
+ 
+@example
+play2 the4 game2.
+sink2 or4 swim2.
+@end example
+
+La alineación respecto de una melodía se puede especificar con la
+propiedad @code{associatedVoice},
+ 
+@example
+\set associatedVoice = #"lala"
+@end example
+
+@noindent
+El valor de la propiedad (aquí: @code{"lala"}) ha de ser el nombre de
+un contexto de @internalsref{Voice}.  Sin este ajuste, las líneas de extensión
+no se formatearán correctamente.
+ 
+Presentamos a continuación un ejemplo que muestra el uso de las duraciones manuales de las sílabas del texto:
+
+@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
+<< \new Voice = "melody" {
+    \time 3/4
+    c2 e4 g2.
+ }
+ \new Lyrics \lyricmode {
+   \set associatedVoice = #"melody"
+   play2 the4 game2.
+ } >>
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{Lyrics}.
+
+
+@node Assigning more than one syllable to a single note
+@unnumberedsubsubsec Assigning more than one syllable to a single note
+
+
+@funindex _
+@cindex ligaduras, en el texto
+
+Para asignar más de una sílaba a una sola nota, puede
+encerrarlas entre comillas o utilizar un guión bajo (@code{_}), para dejar espacios
+entre las sílabas, o usar el símbolo de tilde curva (@code{~}) para obtener una ligadura en el
+texto@footnote{Las ligaduras de texto están hechas con el carácter de Unicode
+U+203F, por tanto
+debe asegurarse de tener instalada una tipografía (como DejaVuLGC) que incluya este
+glifo.}.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+@seealso
+
+Referencia del programa: @internalsref{LyricCombineMusic}.
+
+@c Here come the section which used to be "Melismata"
+@c the new title might be more self-explanatory
+
+
+@node More than one note on a single syllable
+@unnumberedsubsubsec More than one note on a single syllable
+
+@cindex melisma
+@cindex melismata
+@cindex fraseo, en la letra
+
+A veces, y sobre todo en la música medieval, varias notas se cantan sobre una
+sílaba única; tales vocalizaciones reciben el nombre de melismas, o melismata.
+
+@c this method seems to be the simplest; therefore
+@c it might be better to present it first - vv
+
+Puede definir los melismas completamente dentro de la letra, escribiendo un guión bajo @code{_}
+para cada nota
+que forma parte del melisma.
+
+@lilypond[relative=1,verbatim,fragment,quote]
+{ \set melismaBusyProperties = #'()
+ c d( e) f f( e) e e  }
+\addlyrics
+ { Ky -- _ _ ri __ _ _ _  e }
+@end lilypond
+
+En este caso, también puede tener ligaduras de unión y de expresión en la melodía, si establece
+@code{melismaBusyProperties}, como se hizo en el ejemplo anterior.
+
+Sin embargo la instrucción @code{\lyricsto} también puede
+detectar los melismas automáticamente: sólo pone una sílaba
+debajo de un grupo de notas unidas mediante ligadura de unión o de expresión.  Si quiere forzar
+que un grupo de notas sin ligadura sea un melisma, inserte @code{\melisma}
+después de la primera nota del grupo, y @code{\melismaEnd} después de la
+última, p.ej.:
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+<<
+  \new Voice = "lala" {
+    \time 3/4
+    f4 g8
+    \melisma
+    f e f
+    \melismaEnd
+    e2
+  }
+  \new Lyrics \lyricsto "lala" {
+    la di __ daah
+  }
+>>
+@end lilypond
+
+Además, las notas se consideran un melisma si están unidas manualmente
+mediante una barra, y el barrado automático (véase @ref{Setting automatic beam
+behavior}) está desactivado.
+
+@c TODO: there might be some more relevant place for 
+@c the following link (?)
+
+@cindex SATB
+@cindex coral, partitura
+
+Hay un ejemplo completo de una disposición de partitura SATB en la sección
+@ref{Vocal ensembles}.
+
+
+@refcommands
+
+@code{\melisma}, @code{\melismaEnd}
+@funindex \melismaEnd
+@funindex \melisma
+
+@seealso
+
+Referencia del programa: @internalsref{Melisma_translator}.
+
+@lsr{vocal,lyric@/-combine.ly}.
+
+@refbugs
+
+Los melismas no se detectan automáticamente, y las líneas de extensión se deben
+insertar a mano.
+
+@node Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens
+
+@cindex melisma
+@cindex extender
+
+Los melismas se indican mediante una línea horizontal centrada entre una sílaba
+y la siguiente.  Esta línea recibe el nombre de línea de extensión, y se escribe
+como @samp{ __ } (fíjese en los espacios antes y después de los dos guiones
+bajos).
+
+@cindex guiones
+
+Los guiones centrados se escriben como @samp{ -- } entre sílabas de una misma palabra
+(fíjese en los espacios antes y después de los dos guiones).  El guión
+quedará centrado entre las sílabas, y su longitud se ajustará
+en función del espacio que exista entre ellas.
+
+En la música grabada de modo muy apretado, se pueden quitar los guiones.  Se puede
+controlar si esto ocurre o no, mediante la @code{minimum-distance} (distancia
+mínima entre las dos sílabas) y la @code{minimum-length}
+(umbral por debajo del cual se suprimen los guiones).
+
+@seealso
+
+Referencia del programa: @internalsref{LyricExtender},
+@internalsref{LyricHyphen}
+
+
+@node Working with lyrics and identifiers
+@unnumberedsubsubsec Working with lyrics and identifiers
+@cindex letra, identificadores de
+
+Para definir identificadores que contengan texto, se debe usar la función @code{\lyricmode}.
+Si embargo no tendrá que escribir las duraciones, si añade
+@code{\addlyrics} o @code{\lyricsto}
+en el momento de invocar el identificador.
+ 
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+ <<
+   \new Voice = "one" \relative c'' @{
+     \autoBeamOff
+     \time 2/4
+     c4 b8. a16 g4. f8 e4 d c2
+   @}
+   \addlyrics @{ \verseOne @}
+ >>
+@}
+@end example
+ 
+Para arreglos distintos o más complejos, la mejor forma es preparar previamente la
+jerarquía de pautas y textos, p.ej.:
+@example
+\new ChoirStaff <<
+  \new Voice = "soprano" @{ @emph{música} @}
+  \new Lyrics = "textoSoprano" @{ s1 @}
+  \new Lyrics = "textoTenor" @{ s1 @}
+  \new Voice = "tenor" @{ @emph{música} @}
+>>
+@end example
+ 
+y después combinar las melodías y líneas de texto apropiadas
+ 
+@example
+\context Lyrics = textoSoprano \lyricsto "soprano"
+@emph{el texto}
+@end example
+ 
+@noindent
+
+El código de entrada definitivo sería algo como
+ 
+@example
+<<\new ChoirStaff << @emph{prepare la música} >>
+ \lyricsto "soprano" @emph{etc}
+ \lyricsto "alto" @emph{etc}
+@emph{etc}
+>>
+@end example
+ 
+@seealso
+ 
+@c TODO: document \new Staff << Voice \lyricsto >> bug
+Program reference: @internalsref{LyricCombineMusic},
+@internalsref{Lyrics}.  
+
+
+@node Flexibility in placement
+@unnumberedsubsubsec Flexibility in placement
+
+A menudo se aplican a una melodía distintos versos de una canción de formas ligeramente
+distintas.  Tales variantes pueden aún captarse mediante
+@code{\lyricsto}.
+
+@menu
+* Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Lyrics independent of notes::  
+@end menu
+
+
+@node Lyrics to multiple notes of a melisma
+@unnumberedsubsubsec Lyrics to multiple notes of a melisma
+
+Existe la posibilidad de que el texto tenga un melisma en un verso, pero
+varias sílabas en otro.  Una solución es hacer que la voz más rápida
+ignore el melisma.  Esto se consigue estableciendo
+@code{ignoreMelismata} en el contexto Lyrics.
+
+Hay un aspecto delicado: el valor de @code{ignoreMelismata}
+se debe establecer una sílaba @emph{antes} de la sílaba no melismática
+del texto, tal y como se muestra a continuación:
+
+@c  FIXME: breaks compile
+@lilypond[verbatim,ragged-right,quote]
+%{
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    \slurDotted
+    f8.[( g16])
+    a4
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    more slow -- ly
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    \set ignoreMelismata = ##t % applies to "fas"
+    go fas -- ter
+    \unset ignoreMelismata
+    still
+  }
+>>
+%}
+@end lilypond
+
+
+El @code{ignoreMelismata} se aplica a la sílaba @q{fas}, por ello
+se debe introducir antes de @q{go}.
+
+La inversa también es posible: hacer que una línea de letra sea más lenta que la
+normal.  Esto se puede conseguir insertando @code{\skip}s (desplazamientos) dentro de la
+letra.  Para cada @code{\skip}, el texto se retrasará una nota más.
+Por ejemplo,
+
+@lilypond[verbatim,ragged-right,quote]
+\relative { c c g' }
+\addlyrics {
+  twin -- \skip 4
+  kle
+}
+@end lilypond
+
+
+@node Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
+
+Puede presentar letras alternativas (o divisi) nombrando contextos de
+voz y aplicando la letra a los mencionados contextos específicos.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" {
+    \relative c' {
+      c4
+      <<
+        { \voiceOne c8 e }
+        \new Voice = "splitpart" { \voiceTwo c4 }
+      >>
+      \oneVoice c4 c | c
+    }
+  }
+  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
+  \new Lyrics \lyricsto "splitpart" { will }
+>> }
+@end lilypond
+
+
+Puede usar este truco para presentar las distintas letras de una sección
+que se repite.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" \relative c' {
+    c2 e | g e | c1 |
+    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
+    a2 b | c1}
+  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
+    do mi sol mi do
+    la si do }
+  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
+   do re mi fa sol }
+  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
+   dodo rere mimi fafa solsol }
+>>
+}
+@end lilypond
+
+
+
+@node Switching the melody associated with a lyrics line
+@unnumberedsubsubsec Switching the melody associated with a lyrics line
+
+Son posibles variaciones más complejas en la disposición del texto.  Se puede
+cambiar la melodía para una línea de la letra durante el texto.  Esto se hace
+estableciendo la propiedad @code{associatedVoice}.  En el ejemplo
+
+@lilypond[ragged-right,quote]
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    <<
+      \new Voice = "alternative" {
+        \voiceOne
+        \times 2/3 {
+          % show associations clearly.
+          \override NoteColumn #'force-hshift = #-3
+          f8 f g
+        }
+      }
+      {
+        \voiceTwo
+        f8.[ g16]
+        \oneVoice
+      } >>
+    a8( b) c
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    Ju -- ras -- sic Park
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    % Tricky: need to set associatedVoice
+    % one syllable too soon!
+    \set associatedVoice = alternative % applies to "ran"
+    Ty --
+    ran --
+    no --
+    \set associatedVoice = lahlah % applies to "rus"
+    sau -- rus Rex
+  } >>
+@end lilypond
+
+@noindent
+el texto del primer verso se aplica a una melodía llamada @q{lahlah},
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  Ju -- ras -- sic Park
+@}
+@end example
+
+
+El segundo verso se aplica en principio al contexto de @code{lahlah}, pero
+para la sílaba @q{ran}, cambia a una melodía diferente.
+Esto se consigue con
+@example
+\set associatedVoice = alternative
+@end example
+
+@noindent
+Aquí, @code{alternative} es el nombre del contexto de @code{Voice}
+que contiene el tresillo.
+
+Una vez más, la instrucción debe ir una sílaba antes de la cuenta, antes de @q{Ty} en
+este caso.
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  \set associatedVoice = alternative % se aplica al "ran"
+  Ty --
+  ran --
+  no --
+  \set associatedVoice = lahlah % se aplica al "rus"
+  sau -- rus Rex
+@}
+@end example
+
+@noindent
+La disposición se vuelve a cambiar a la situación inicial mediante la asignación de
+@code{lahlah} a @code{associatedVoice}.
+
+
+@node Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
+
+En cierta música vocal compleja, podría ser deseable colocar la
+letra de forma totalmente independiente de las notas.  La música que se define
+dentro de @code{lyricrhythm} desaparece dentro del contexto
+@code{Devnull}, pero los valores rítmicos aún se pueden utilizar para
+colocar la letra.
+
+@lilypond[quote,verbatim,ragged-right]
+voice = {
+  c''2
+  \tag #'music { c''2 }
+  \tag #'lyricrhythm { c''4. c''8 }
+  d''1
+}
+
+lyr = \lyricmode { I like my cat! }
+
+<<
+  \new Staff \keepWithTag #'music \voice
+  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
+  \new Lyrics \lyricsto "nowhere" \lyr
+  \new Staff { c'8 c' c' c' c' c' c' c'
+  c' c' c' c' c' c' c' c' }
+>>
+@end lilypond
+
+
+@node Spacing lyrics
+@unnumberedsubsubsec Spacing lyrics
+
+@cindex Spacing lyrics
+@cindex Lyrics, increasing space between
+
+Para aumentar el espaciado entre las sílabas de la letra, establezca la propiedad minimum-distance de
+LyricSpace.
+
+@lilypond[relative,verbatim,fragment,quote,ragged-right]
+{
+  c c c c
+  \override Lyrics.LyricSpace #'minimum-distance = #1.0
+  c c c c
+}
+\addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+}
+@end lilypond
+
+Para que este cambio sea válido para la letra de la partitura completa, establezca la propiedad dentro del
+layout o disposición.
+
+@lilypond[relative,verbatim,quote,ragged-right]
+\score {
+  \relative c' {
+  c c c c
+  c c c c
+  }
+  \addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+  }
+  \layout {
+    \context {
+      \Lyrics
+      \override LyricSpace #'minimum-distance = #1.0
+    }
+  }
+}
+@end lilypond
+
+
+@node More about stanzas
+@unnumberedsubsubsec More about stanzas
+
+@cindex número de verso
+@unnumberedsubsubsec Adding stanza numbers 
+
+Los números de los versos se pueden añadir estableciendo @code{stanza}, p.ej.,
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set stanza = "1. "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set stanza = "2. "
+  Oh, ché -- ri, je t'aime
+}
+@end lilypond
+
+@noindent
+Estos números aparecerán inmediatamente antes de la primera sílaba.
+
+
+@unnumberedsubsubsec Adding dynamics marks
+
+Los versos que difieren en su fuerza se pueden especificar escribiendo una
+indicación dinámica antes de cada verso.  En Lilypond, todo lo que aparece delante de
+un verso está dentro del objeto @code{StanzaNumber}; las indicaciones dinámicas
+no son diferentes.  Por razones técnicas, tendrá que establecer el valor de la sección stanza (verso)
+fuera de @code{\lyricmode}:
+
+@lilypond[quote,ragged-right,verbatim]
+text = {
+  \set stanza = \markup { \dynamic "ff" "1. " }
+  \lyricmode {
+    Big bang
+  }
+}
+
+<<
+  \new Voice = "tune" {
+    \time 3/4
+    g'4 c'2
+  }
+\new Lyrics \lyricsto "tune" \text
+>>
+@end lilypond
+
+@cindex cantor, nombre del
+@cindex nombre del cantor
+@unnumberedsubsubsec Adding singer names
+
+También se pueden poner los nombres de los cantantes.  Se imprimen al comienzo de la
+línea, igual que los nombres de instrumento.  Se crean estableciendo un valor para
+@code{vocalName}.  Se puede definir una versión abreviada como @code{shortVocalName}.
+
+@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set vocalName = "Bert "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set vocalName = "Ernie "
+  Oh, che -- ri, je t'aime
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end 
+
+En ocasiones es conveniente tener un verso ajustado a la música,
+y el resto añadido en forma de estrofa al final
+de la pieza.  Esto se puede conseguir escribiendo
+los versos adicionales dentro de una sección @code{\markup} fuera
+del bloque score principal de la partitura.  Tenga en cuenta que existen dos
+formas distintas de forzar los saltos de línea al utilizar
+@code{\markup}.
+
+@lilypond[ragged-right,verbatim,quote]
+melody = \relative c' {
+e d c d | e e e e |
+d d e d | c1 |
+}
+
+text = \lyricmode {
+\set stanza = "1." Ma- ry had a lit- tle lamb,
+its fleece was white as snow.
+}
+
+\score{ <<
+  \new Voice = "one" { \melody }
+  \new Lyrics \lyricsto "one" \text
+>>
+  \layout { }
+}
+\markup { \column{
+  \line{ Verse 2. }
+  \line{ All the children laughed and played }
+  \line{ To see a lamb at school. }
+  }
+}
+\markup{
+  \wordwrap-string #"
+  Verse 3.
+
+  Mary took it home again,
+
+  It was against the rule."
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns 
+
+Cuando una pieza tiene muchos versos, a menudo se imprimen
+en varias columnas a lo largo de toda la página. Con frecuencia un número de verso fuera del margen
+precede a cada verso. El ejemplo siguiente muestra cómo producir dicha salida
+en Lilypond.
+
+@lilypond[ragged-right,quote,verbatim]
+melody = \relative c' {
+  c c c c | d d d d
+}
+ 
+text = \lyricmode {
+  \set stanza = "1." This is verse one.
+  It has two lines.
+}
+
+\score{ <<
+    \new Voice = "one" { \melody }
+    \new Lyrics \lyricsto "one" \text
+   >>
+  \layout { }
+}
+
+\markup {
+  \fill-line {
+    \hspace #0.1 % moves the column off the left margin; can be removed if
+        % space on the page is tight
+     \column {
+      \line { \bold "2."
+        \column {
+          "This is verse two."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "3."
+        \column {
+          "This is verse three."
+          "It has two lines."
+        }
+      }
+    }
+    \hspace #0.1  % adds horizontal spacing between columns; if they are
+        % still too close, add more " " pairs until the result 
+        % looks good
+     \column {
+      \line { \bold "4."
+        \column {
+          "This is verse four."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "5."
+        \column {
+          "This is verse five."
+          "It has two lines."
+        }
+      }
+    }
+  \hspace #0.1 % gives some extra space on the right margin; can
+      % be removed if page space is tight
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
+@internalsref{VocalName}.
+
+
+
+@node Other vocal issues
+@unnumberedsubsubsec Other vocal issues
+
+@ignore
+yeah, I'm giving up somewhat by stuffing a bunch of things in
+here.  But at least they're in the manual now; it's easier to
+move them around in the manual once they're already here.
+
+Besides, if users complain about everything stuffed in here, I
+can ask them for specific instructions about where to move these
+examples, and that might get them more involved in the docs.  -gp
+@end ignore
+
+@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
+realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
+@ref{Special noteheads}.
+
+
diff --git a/Documentation/es/user/working.itely b/Documentation/es/user/working.itely
index e51d17064e..3d14b2e9c7 100644
--- a/Documentation/es/user/working.itely
+++ b/Documentation/es/user/working.itely
@@ -77,8 +77,8 @@ intentar recordar el número de versión de LilyPond que estaba usando hace unos
 @code{convert-ly} requiere que declare
 qué versión de LilyPond utilizó.
 
-@item @strong{Incluya comprobaciones}: @ref{Bar check}, @ref{Octave check} y
-@ref{Barnumber check}.  Si
+@item @strong{Incluya comprobaciones}: @ruser{Bar check}, @ruser{Octave check} y
+@ruser{Barnumber check}.  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 sólo una o dos veces.  Para
@@ -110,8 +110,8 @@ e identificadores.  Si especifica @code{c4 d e} al principio de una frase
 si reelabora la música más tarde.
 
 @item @strong{Separe los trucos} de las definiciones musicales.  Consulte
-@ref{Saving typing with identifiers and functions} y
-@ref{Style sheets}.
+@ruser{Saving typing with identifiers and functions} y
+@ruser{Style sheets}.
 
 @end itemize
 
@@ -128,7 +128,7 @@ de música ya impresa),
 la práctica de escribir un compás por línea de texto), y
 compruebe cada sistema cuando lo haya terminado.  Puede usar el comando
 @code{showLastLength} para acelerar el proceso -- ver
-@ref{Skipping corrected music} -- .
+@ruser{Skipping corrected music} -- .
 
 @item Defina @code{mBreak = @{ \break @}} e inserte @code{\mBreak}
 dentro del archivo de entrada donde el manuscrito tenga un saldo de línea.  De esta forma
@@ -170,7 +170,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Separe los trucos de las definiciones musicales}.  Ya se mencionó
-en @ref{General suggestions}, pero para proyectos
+en @ruser{General suggestions}, pero para proyectos
 grandes es vital.  Quizá tengamos que cambiar la
 definición de @code{fthenp}, pero en ese caso sólo lo tendremos que
 hacer una vez, y aún podremos evitar tocar nada
@@ -284,9 +284,9 @@ padText =
 @end lilypond
 
 La utilización de identificadores también es una buena forma de reducir el trabajo si
-la sintaxis de entrada de LilyPond cambia (ver @ref{Updating old files}).  Si
+la sintaxis de entrada de LilyPond cambia (ver @ruser{Updating old files}).  Si
 tiene una sola definición (como p.ej. @code{\dolce}) para todos sus
-archivos (ver @ref{Style sheets}), y después la sintaxis se modifica, sólo tendrá
+archivos (ver @ruser{Style sheets}), y después la sintaxis se modifica, sólo tendrá
 que actualizar su definición @code{\dolce} única,
 en lugar de tener que hacer cambios en cada uno de los archivos @code{.ly}.
 
@@ -295,14 +295,14 @@ en lugar de tener que hacer cambios en cada uno de los archivos @code{.ly}.
 @section Style sheets
 
 La salida que produce LilyPond se puede modificar profundamente; consulte
-@ref{Tweaking output} para leer detalles sobre este asunto.  Pero ¿qué ocurre si tiene muchos
+@ruser{Tweaking output} para leer detalles sobre este asunto.  Pero ¿qué ocurre si tiene muchos
 archivos a los que les quiere aplicar sus propios trucos?  O ¿qué ocurre si, sencillamente,
 quiere separar los trucos de la propia música?  Todo esto
 es bastante fácil de conseguir.
 
 Veamos un ejemplo.  No se preocupe si no entiende
 las partes que tienen todos los @code{#()}.  Esto se explicará en
-@ref{Advanced tweaks with Scheme}.
+@ruser{Advanced tweaks with Scheme}.
 
 @lilypond[quote,verbatim,ragged-right]
 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@@ -323,7 +323,7 @@ tempoMark = #(define-music-function (parser location markp) (string?)
 @end lilypond
 
 Existen varios problemas con la salida que se superpone; los arreglaremos utilizando
-las técnicas descritas en @ref{Moving objects}.  Pero también haremos algo respecto a
+las técnicas descritas en @ruser{Moving objects}.  Pero también haremos algo respecto a
 las definiciones @code{mpdolce} y @code{tempoMark}.  Éstas producen la salida que
 deseamos, pero quizá las querríamos utilizar en otra pieza.
 Podríamos simplemente copiarlas y pegarlas al principio de cada archivo,
@@ -626,7 +626,7 @@ Ahora empiece poco a poco descomentando cada vez más fracciones de la
 parte del @code{bajo} hasta que encuentre la línea del problema.
 
 Otra técnica de depuración muy útil es la construcción de
-@ref{Minimal examples}.
+@ruser{Minimal examples}.
 
 
 @node Minimal examples
diff --git a/Documentation/fr/index.html.in b/Documentation/fr/index.html.in
index ed4ec1704f..bab9de5aaa 100644
--- a/Documentation/fr/index.html.in
+++ b/Documentation/fr/index.html.in
@@ -49,7 +49,7 @@
 	  <ul>
 	    <li>
 	    <a class="title"
-	      href="user/lilypond/Tutorial.fr.html">Tutoriel</a>
+	      href="user/lilypond-learning/index.fr.html">Tutoriel</a>
 	      <br>&mdash; commencer ici
 	    <li><a class="title" href="user/music-glossary/index.html">Glossaire</a>
 	      multilingue<br>(aussi en
diff --git a/Documentation/fr/user/advanced-notation.itely b/Documentation/fr/user/advanced-notation.itely
index 5e5ad2821b..5031cd1484 100644
--- a/Documentation/fr/user/advanced-notation.itely
+++ b/Documentation/fr/user/advanced-notation.itely
@@ -1,1529 +1,99 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of ../user/lilypond.tely
 @ignore
-    Translation of GIT committish: a4cf6aed7bf79f3cc1892dbc92b642b2514c1674
-
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c NOTE: dummy committish
+@c the stuff below is still to be moved -J.Mandereau
 
-@node Advanced notation
-@chapter Advanced notation
-
-Ce chapitre traite de fonctions avancées ou moins usuelles de la notation.
-
-@menu
-* Text::                        
-* Preparing parts::             
-* Orchestral music::            
-* Contemporary notation::       
-* Educational use::             
-@end menu
-
-
-
-@node Text
-@section Text
-
-Nous allons voir ici comment insérer du texte, selon différents
-formatages, dans vos partitions.
-
-@cindex Texte, autres langues
-Pour écrire des accents et autres caractères spéciaux, il suffit de
-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
-* Text scripts::                
-* Text and line spanners::      
-* Text spanners::               
-* Text marks::                  
-* Text markup::                 
-* Nested scores::               
-* Page wrapping text::          
-* Overview of text markup commands::  
-* Overview of text markup list commands::  
-* Font selection::              
-* New dynamic marks::           
-@end menu
-
-
-@node Text scripts
-@subsection Text scripts
-
-@c I'm not fond of this "étiquette" wording of yours Jean-Charles;
-@c j'utiliserais simplement l'expression "bloc \markup" afin
-@c d'éviter toute confusion avec les \tags (qui méritent davantage
-@c le titre d'étiquette, stricto sensu) -vv
-
-@cindex Étiquette de texte
-@cindex blocs de texte
-@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
-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{\fatText}.
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c4^"longtext" \fatText c4_"longlongtext" c4
-@end lilypond
-
-@noindent
-Pour revenir à l'espacement par défaut, utilisez @code{\emptyText}.
-
-Des constructions plus élaborées d'étiquette peuvent être obtenues en
-ayant recours à la commande @emph{markup} :
-
-@lilypond[fragment,ragged-right,verbatim,quote]
-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}.
-
-
-@refcommands
-
-@funindex \fatText
-@code{\fatText},
-@funindex \emptyText
-@code{\emptyText}.
-
-
-@commonprop
-
-S'assurer que tous les éléments textuels et les paroles respectent
-les marges du document requiert des calculs relativement lourds ; c'est
-la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
-Vous pouvez cependant l'y forcer en définissant
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-
-@seealso
-
-Dans ce manuel : @ref{Text markup}.
-
-Référence du programme : @internalsref{TextScript}.
-
-
-@node Text and line spanners
-@subsection Text and line spanners
-
-Certaines indications d'interprétation comme @i{rallentando}, 
-@i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
-prolongent sur plusieurs mesures à l'aide d'une ligne pleine, pointillée
-ou ondulée.
-
-Les routines chargées de matérialiser un @emph{glissando} sont tout à
-fait adaptées à une gestion précise, à la fois du placement du texte, et
-du calcul de l'envergure de sa ligne d'extension.  La routine
-@code{ly:line-interface::print} est plus particulièrement en charge de
-déterminer les points d'ancrage de la ligne et de la dessiner selon le
-style requis.
-  
-Voici un exemple qui illustre les différents styles de ligne
-disponibles, ainsi que la manière de les personnaliser.
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-d2 \glissando d'2
-\once \override Glissando #'dash-fraction = #0.5
-d,2 \glissando d'2
-\override Glissando #'style = #'dotted-line
-d,2 \glissando d'2
-\override Glissando #'style = #'zigzag
-d,2 \glissando d'2
-\override Glissando #'style = #'trill
-d,2 \glissando d'2
-@end lilypond
-
-L'information qui va déterminer les extrémités est calculée à la
-volée pour chaque objet graphique.  Il est tout à fait possible de les
-régler vous-même :
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-e2 \glissando f
-\once \override Glissando #'bound-details #'right #'Y = #-2
-e2 \glissando f
-@end lilypond
-
-L'objet @code{Glissando}, comme tous ceux qui utilisent la routine
-@code{ly:line-interface::print}, comporte une liste 
-d'associations.  Dans le code ci-dessus, la valeur de @code{Y} est
-fixée, dans la liste d'associations, à @code{-2} pour l'ancrage à
-droite.  Vous pouvez naturellement ajuster l'extrémité gauche en
-remplaçant @code{right} (pour @code{droite}) par @code{left}.
-
-Si @code{Y} n'est pas fixé, sa valeur sera calculée en fonction de la
-hauteur du point de référence droite de la ligne.
-
-Lorsque survient un saut de ligne, la liste des ancrages est
-augmentée d'une liste complémentaire contenant @code{left-broken}
-(brisure à gauche) et @code{right-broken} (brisure à droite), comme
-dans l'exemple suivant :
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-\override Glissando #'breakable = ##T 
-\override Glissando #'bound-details #'right-broken #'Y = #-3
-c1 \glissando \break
-f1
-@end lilypond
-
-Vous disposez des propriétés suivantes :
-
-@table @code
-@item Y
-Fixe l'ordonnée (coordonnée-Y) de l'extrémité, mesurée en taille de
-portée.  Il s'agit par défaut du centre de l'objet de rattachement ;
-pour un glissando, ce sera le milieu de la tête de note.
-
-Pour des marques horizontales, telles du texte ou le trait d'un
-trille, cette valeur est figée à 0.
-
-@item attach-dir
-Détermine l'endroit où la ligne commence et finit, relativement à
-l'objet de rattachement. Autrement dit, une valeur de @code{-1} (ou
-@code{LEFT} pour gauche) fera commencer ou finir la ligne du côté
-gauche de la tête de note de référence.
-
-@item X
-Coordonnée absolue du point final. Dans la mesure où elle est calculée
-à la volée, il n'y a pas vraiment de raison de l'outrepasser.
-
-@item stencil
-Sous-propriété contenant les éventuels symboles présents avant ou
-après la ligne. Destinée à un usage interne, nous vous recommendons
-d'utiliser plutôt @code{text}.
-
-@item text
-Marqueur qui sera analysé pour alimenter @code{stencil}.  On y trouve
-habituellement les @i{cresc.} ou @i{tr} des extenseurs horizontaux.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override TextSpanner #'bound-details #'left #'text
-   = \markup { \small \bold Slower }
-c2\startTextSpan b c a\stopTextSpan
-@end lilypond
-
-@item stencil-align-dir-y
-@item stencil-offset
-Lorsqu'ils ne sont pas définis, le tracé est tout simplement
-positionné conformément aux sous-propriétés @code{X} et @code{Y}.  En
-fixant soit @code{stencil-align-dir-y}, soit @code{stencil-offset},
-vous pouvez décaler le coin du marqueur par rapport à l'extrémité de
-la ligne.
-
-@lilypond[relative=1,fragment,verbatim]
-\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
-\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
-
-\override TextSpanner #'bound-details #'left #'text = #"gggg"
-\override TextSpanner #'bound-details #'right #'text = #"hhhh"
-c4^\startTextSpan c c c \stopTextSpan
-@end lilypond
-
-@item arrow
-Assigner à cette sous-propriété la valeur @code{vrai} (@code{#t})
-produira une terminaison en pointe de flèche.
-
-@item padding
-Cette sous-propriété contrôle l'espace entre les extrémités de la
-ligne, telles que définies, et la réalité.  Sans ce léger décalage, le
-début et la fin d'un glissando seraient en plein milieu des têtes de note.
-
-@end table
-
-@seealso
-
-Référence du programme : @internalsref{TextSpanner},
-@internalsref{Glissando}, @internalsref{VoiceFollower},
-@internalsref{TrillSpanner}, @internalsref{line-spanner-interface}.
-
-Exemples : @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
-
-
-@node Text spanners
-@subsection Text spanners
+@node Overview of text markup commands
+@subsection Overview of text markup commands
 
-@cindex Prolongateurs de texte
+Vous pouvez utiliser les commandes suivantes au sein d'un bloc
+@code{\markup @{ @}}.
 
-Certaines indications d'interprétation comme @i{rallentando} ou 
-@i{accelerando} s'incrivent en toutes lettres et se prolongent sur
-plusieurs mesures grâce à une ligne pointillée.  Les commandes
-@code{\startTextSpan} et @code{\stopTextSpan}, respectivement
-attachées à la première et à la dernière note qu'elles concernent,
-déterminent l'envergure de ces prolongateurs, ou extenseurs.
+@include markup-commands.tely
 
-La chaîne à imprimer, ainsi que son style, sont définis par des
-propriétés, comme ici :
+@node Overview of text markup list commands
+@subsection Overview of text markup list commands
 
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c1
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \upright "rall" } 
-c2\startTextSpan b c\stopTextSpan a
-\break
-\textSpannerUp
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \italic "rit" } 
-c2\startTextSpan b c\stopTextSpan a
-@end lilypond
+Vous pouvez utiliser les commandes suivantes avec @code{\markuplines}.
 
-@refcommands
+@include markup-list-commands.tely
 
-@funindex textSpannerUp
-@code{\textSpannerUp},
-@funindex textSpannerDown
-@code{\textSpannerDown},
-@funindex textSpannerNeutral
-@code{\textSpannerNeutral}.
+@node Different editions from one source
+@subsection Different editions from one source
 
+@funindex \tag
+@cindex tag
 
-@commonprop
+La commande @code{\tag} affecte un nom à des expressions musicales.
+Les expressions ainsi balisées pourront être filtrées par la suite.
+Ce mécanisme permet d'obtenir différentes versions à partir d'une même
+source musicale. 
 
-Pour obtenir une ligne pleine, utilisez
+Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
+l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
+comportera les ornements. 
 
 @example
-\override TextSpanner #'dash-fraction = #'()
-@end example
-
-
-@seealso
-
-Référence du programme : @internalsref{TextSpanner}.
-
-
-@node Text marks
-@subsection Text marks
-
-@cindex coda sur une barre de mesure
-@cindex segno sur une barre de mesure
-@cindex point d'orgue sur une barre de mesure
-@cindex barres de mesure, symboles au dessus de
-@funindex \mark
-
-La commande @code{\mark} est tout d'abord conçue pour les
-@ref{Rehearsal marks}.  Elle peut néanmoins servir à insérer des
-signes de coda ou de segno, ou bien un point d'orgue, au dessus d'une
-barre de mesure.  Couplez-la alors à la commande @code{\markup} pour
-avoir accès au symbole approprié (ils sont répertoriés dans 
-@ref{The Feta font}).
-
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
 c1
-@end lilypond
-
-@noindent
-Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
-d'un système.  Si vous introduisez la commande @code{\mark} au moment
-d'une barre de mesure, la marque se placera au dessus de la barre.  Si
-vous y faites appel au milieu d'une mesure, cette marque sera
-positionnée entre les notes.  Si elle intervient en début de ligne,
-elle sera placée juste avant la première note de cette portée.  Enfin,
-une marque qui tomberait sur un saut de ligne sera imprimée au début
-de la ligne suivante.
-@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
-@c  delete this sentence.   -gp
-Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
-
-
-@commonprop
-
-Pour imprimer une marque à la fin de la portée en cours, procédez
-ainsi :
-
-@example
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-@end example
-
-@code{\mark} est souvent bien utile pour porter une indication à la
-fin d'une mesure.  Pensez alors à modifier la propriété
-@code{#'self-alignment}.  
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-c1 c c c4 c c c
-\once \override Score.RehearsalMark #'self-alignment-X = #right
-\mark "D.S. al Fine "
-@end lilypond
-
-Les indications textuelles peuvent s'aligner par rapport à d'autres
-objets que des barres de mesure, tels que l'armure, la clé ou le chiffre de
-mesure : 
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\relative {
-  c1
-  \key cis \major
-  \clef alto
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  \mark "on key"
-  cis
-  \key ces \major
-  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
-  \clef treble
-  \mark "on clef"
-  ces
-  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
-  \key d \minor
-  \clef tenor
-  \time 3/4
-  \mark "on time"
-  c
-}
-@end lilypond
-
-Les symboles pris en charge par @code{break-align-symbols} sont :
-@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
-@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
-@code{key-signature}, et @code{time-signature}.
-
-Par défaut, les indications textuelles sont alignées avec le milieu
-des objets de notation. Bien entendu, vous pouvez modifier les
-propriétés @code{break-align-anchor-alignment} ou
-@code{break-align-anchor} des objets en question pour obtenir un autre
-résultat.
-
-@c KEEP LY
-@lilypond[fragment,quote,ragged-right,verbatim]
-{
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  c1
-  \key cis \major
-
-  % La marque sera alignée sur le côté gauche de l'armure
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
-  \mark \default
-  cis1
-  \key ces \major
-
-  % La marque sera alignée sur le côté droit de l'armure
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
-  \mark \default
-  ces1
-  \key cis \major
-
-  %  La marque sera alignée sur le côté gauche de l'armure,
-  % puis décalée vers la droite de 2 unités.
-  \once \override Staff.KeySignature #'break-align-anchor = #2
-  \mark \default
-  ces1
-}
-@end lilypond
-
-Bien que ces indications textuelles ne soient habituellement imprimées
-qu'au niveau de la portée supérieure, vous pouvez forcer leur
-affectation à chacune des portées :
-
-@lilypond[quote,ragged-right,verbatim,relative=2]
-{
-  \new Score \with {
-    \remove "Mark_engraver"
-  }
-  <<
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c''1 \mark "foo" c'' }
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c'1 \mark "foo" c' }
+<<
+  \tag #'partie <<
+    R1 \\
+    @{
+      \set fontSize = #-1
+      c4_"cue" f2 g4 @}
   >>
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{RehearsalMark}.
-
-
-@node Text markup
-@subsection Text markup
-
-@cindex étiquette
-@cindex commentaire textuel
-@cindex étiquette textuelle
-@cindex texte ajouté
-
-La commande @code{\markup} permet d'ajouter du texte.  Vous pouvez y
-inclure des commandes, précédées d'un antislash @code{\} ; les
-caractères @code{\} et @code{#} doivent être encadrés de guillemets
-informatiques @code{"}.
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { hello }
-c1_\markup { hi there }
-c1^\markup { hi \bold there, is \italic {anyone home?} }
-c1_\markup { "\special {weird} #characters" }
-@end lilypond
-
-@noindent
-Pour une liste des différentes commandes disponibles, consultez
-@ref{Overview of text markup commands}. 
-
-
-@code{\markup} est avant tout conçu pour gérer les
-@internalsref{TextScript}s, mais rien ne s'oppose à son utilisation
-pour traiter du texte avec LilyPond.
-
-@lilypond[quote,verbatim]
-\header{ title = \markup{ \bold { foo \italic { bar! } } } }
-\score{
-  \relative c'' {
-    \override Score.RehearsalMark
-      #'break-visibility = #begin-of-line-invisible
-    \override Score.RehearsalMark #'self-alignment-X = #right
-
-    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
-    c2^\markup{ don't be \flat }
-    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
-    b2\startTextSpan
-    a2\mark \markup{ \large \bold Fine }
-    r2\stopTextSpan
-    \bar "||"
-  }
-  \addlyrics { bar, foo \markup{ \italic bar! } }
-}
-@end lilypond
-
-La commande @code{\markup} peut intervenir à tout moment, y compris en
-dehors d'un bloc @code{\score}. Voir à ce sujet 
-@ref{Multiple scores in a book}. 
-
-@lilypond[quote,ragged-right,verbatim]
-\markup{ Here is some text. }
-@end lilypond
-
-@cindex changer de police
-
-Le @emph{markup} de l'exemple précédent montre comment utiliser les
-commandes de changement de police. Les commandes @code{\bold} et
-@code{\italic} n'affectent que le premier mot qui les suit ; encadrez
-les par des accolades si vous désirez que ces commandent s'appliquent
-à plusieurs mots.
-
-@example
-\markup @{ \bold @{ c'est moi @} @}
+  \tag #'conducteur R1
+>>
+c1
 @end example
 
-@noindent
-Une bonne habitude à prendre consiste à utiliser des accolades même
-pour un seul mot, comme ici :
+Ce principe peut s'appliquer aux articulations, textes, etc.  Il
+suffit de positionner 
 @example
-\markup @{ qui \italic @{ est @} là ? @}
+-\tag #@var{votre-balise}
 @end example
-
-En mode @emph{markup}, vous pouvez composer des expressions comme
-en mathématiques, des documents XML ou bien les expressions musicales.
-Vous pouvez empiler ces expressions grâce à la commande
-@code{\column}, ou les centrer par rapport à leur milieu avec
-@code{\center-align}. 
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { \column { a bbbb \line { c d } } }
-c1^\markup { \center-align { a bbbb c } }
-c1^\markup { \line { a b c } }
-@end lilypond
-
-Des listes non précédées de commande ne sont pas isolées. Ainsi, 
+avant l'articulation, comme ici :
 @example
-\center-align @{ @{ a b @} @{ c d @} @}
+c1-\tag #'part ^4
 @end example
 
-@noindent
-
-est la même expression que
+Ceci définira une note avec une indication de doigté conditionnelle.
 
+@cindex keepWithTag
+@cindex removeWithTag
+C'est grâce aux commandes @code{\keepWithTag} et @code{\removeWithTag}
+que vous filtrerez les expressions balisées.  Par exemple :
 @example
-\center-align @{ a b c d @}
+<<
+  @var{de la musique}
+  \keepWithTag #'score @var{de la musique}
+  \keepWithTag #'part @var{de la musique}
+>>
 @end example
+donnerait :
 
-@noindent
-
-L'utilisation des @code{"} ou de la commande @code{\line} permet de
-différencier les listes de mots.
+@lilypondfile[ragged-right,quote]{tag-filter.ly}
 
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c4^\markup{ \center-align { on three lines } }
-c4^\markup{ \center-align { "all one line" } }
-c4^\markup{ \center-align { { on three lines } } }
-c4^\markup{ \center-align { \line { on one line } } }
-@end lilypond
+Les arguments de la commande @code{\tag} doivent être un symbole (tel
+que @code{#'score} ou @code{#'part}), suivi d'une expression musicale.
+Vous pouvez utiliser de multiples balises dans un morceau en
+saisissant plusieurs @code{\tag}.
 
-Vous pouvez stocker les étiquettes textuelles en tant que variables,
-et attacher ces identificateurs à des notes, comme
 @example
-allegro = \markup @{ \bold \large @{ Allegro @} @}
- @{ a^\allegro b c d @}
+  \tag #'original-part \tag #'transposed-part @dots{}
 @end example
 
-Certains objets possèdent leurs propres procédures d'alignement, qui
-annuleront toute spécification d'alignement que vous pourriez affecter
-à un argument de type @emph{markup} que vous leur auriez fourni.  Par
-exemple, les @internalsref{RehearsalMark} sont centrées
-horizontalement ; de fait, utiliser 
-@code{\mark \markup @{ \left-align .. @}} sera sans effet.
-
-Par ailleurs, le placement vertical n'est effectué qu'après la
-création de l'objet @emph{étiquette textuelle}. Si donc vous souhaitez
-déplacer une étiquette, il vous faudra utiliser la propriété
-@code{#'padding} ou créer un @qq{point d'ancrage} à l'intérieur même
-de l'étiquette (généralement avec @code{\hspace #0}).
-
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c'4^\markup{ \raise #5 "not raised" }
-\once \override TextScript #'padding = #3
-c'4^\markup{ raised }
-c'4^\markup{ \hspace #0 \raise #1.5 raised }
-@end lilypond
-
-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}. 
-
 
 @seealso
 
-Dans ce manuel : @ref{Overview of text markup commands}.
-
-Référence du programme : @internalsref{TextScript}.
-
-Fichiers d'initialisation : @file{scm/@/new@/-markup@/.scm}.
-
-
-@refbugs
-
-Le crénage ou la génération de ligatures ne sont accessibles que lors
-d'un retraitement par @TeX{}.  Dans ce cas, LilyPond n'en tient pas
-compte, et l'espacement de tels textes sera trop large.
-
-Les erreurs de syntaxe sont peu loquaces.
-
-
-@node Nested scores
-@subsection Nested scores
-
-Rien ne s'oppose à ce qu'une étiquette ne comporte de la musique.  Il
-suffit que l'expression en question contienne un bloc @code{\score} et
-un bloc @code{\layout}.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative {
-  c4 d^\markup {
-    \score {
-      \relative { c4 d e f }
-      \layout { }
-    }
-  }
-  e f
-}
-@end lilypond
-
-@node Page wrapping text
-@subsection Page wrapping text
-Alors que @code{\markup} s'utilise pour traiter un bloc de texte
-insécable, @code{\markuplines} permet, employé en tête de partition,
-d'obtenir un bloc de lignes réparties différemment et au cas où sur
-plusieurs pages.
-
-@verbatim
-\markuplines {
-  \justified-lines {
-    Un long texte constitué de lignes justifiées.
-    ...
-  }
-  \justified-lines {
-    Un autre grand paragraphe justifié.
-    ...
-  }
-  ...
-}
-@end verbatim
-
-@code{\markuplines} prend en argument une liste de lignes de texte,
-qui peut elle-même consister en une suite de commandes générant à leur
-tour des lignes de texte, comme ici :
-
-@verbatim
-\markuplines {
-  \line { ... }    % une ligne alignée à gauche
-  \fill-line { \line { ... } } % une ligne centrée
-  \wordwrap-lines { ... } % une liste de lignes alignées à gauche
-  \justified-lines { ... } % une liste de lignes justifiées
-}
-@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}.
-
-@seealso
-
-Dans ce manuel : @ref{Overview of text markup list commands}, 
-@ref{New markup list command definition}.
-
-@refcommands
-
-@funindex \markuplines
-@code{\markuplines}
-
-@node Overview of text markup commands
-@subsection Overview of text markup commands
-
-Vous pouvez utiliser les commandes suivantes au sein d'un bloc
-@code{\markup @{ @}}.
-
-@include markup-commands.tely
-
-@node Overview of text markup list commands
-@subsection Overview of text markup list commands
-
-Vous pouvez utiliser les commandes suivantes avec @code{\markuplines}.
-
-@include markup-list-commands.tely
-
-@node Font selection
-@subsection Font selection
-
-@cindex sélection de polices
-@cindex grossissement des polices
-@funindex font-interface
-
-C'est en jouant sur les propriétés des objets décrites ci-après que
-vous pourrez sélectionner une police parmi les familles de fontes
-préconfigurées.  LilyPond utilise par défaut la police musicale feta.
-Pour le texte, les polices sont sélectionnées par Pango/Fontconfig.
-C'est New Century Schoolbook qui sert de police sérif par défaut, et
-celles définies lors de l'installation de Pango pour ce qui est du
-sans-serif et du @q{typewriter}.
-
-
-@itemize @bullet
-@item @code{font-encoding}
-symbolise le tracé des glyphes. N'utilisez cette propriété que pour
-traiter des éléments non textuels, comme :
-
-
-@code{fetaBraces} pour les accolades de partition pianistique,
-@code{fetaMusic} pour de la musique (y compris musique ancienne),
-@code{fetaDynamic} pour les nuances et @code{fetaNumber} pour les
-chiffres. 
-
-@item @code{font-family}
-symbolise les différentes familles de police : @code{roman} (Computer
-Modern), @code{sans}-serif et @code{typewriter} (espacement fixe).
-
-@item @code{font-shape}
-symbolise le style des caractères. En pratique, chaque famille de
-police dispose de @code{italic}, @code{caps} (petites capitales) ou
-@code{upright} (droit).
-
-@item @code{font-series}
-symbolise le niveau de gras des caractères. Chaque style dispose, pour
-chaque famille, de @code{medium} et @code{bold} (gras).
-
-@end itemize
-
-Les variantes ci-dessus mentionnées font référence à une feuille de
-style prédéfinie.  Vous pouvez cependant faire appel à une autre
-police, en utilisant la propriété @code{font-name} :
-
-@lilypond[fragment,verbatim]
-{
-  \override Staff.TimeSignature #'font-name = #"Charter"
-  \override Staff.TimeSignature #'font-size = #2
-  \time 3/4
-  c'1_\markup {
-    \override #'(font-name . "Vera Bold")
-      { This text is in Vera Bold }
-  }
-}
-@end lilypond
-
-@noindent
-Vous pouvez utiliser n'importe quelle police, du moment qu'elle est
-accessible par Pango/Fontconfig.  Pour obtenir la liste de toutes
-les polices disponibles sur votre machine, lancez
-@example
-lilypond -dshow-available-fonts blabla
-@end example
-(quel qu'il soit, le dernier argument est obligatoire).
-
-
-La propriété @code{font-size} permet de régler la taille de la police.
-La taille effective que vous obtiendrez dépend de
-@code{text-font-size} tel que défini dans le bloc @code{\paper}.
-
-@cindex taille de police
-@cindex police, augmenter la taille
-
-
-Vous pouvez aussi changer la police par défaut au niveau du document.
-Il suffit alors de faire appel à @code{make-pango-font-tree} au sein
-du bloc @code{paper}.  Vous définirez alors la police à utiliser pour
-du texte respectivement en roman, sans serif et monospace, comme ici : 
-
-@cindex polices, définir 
-@cindex Pango
-
-
-@lilypond[verbatim]
-\paper  {
-  myStaffSize = #20
-
-  #(define fonts
-    (make-pango-font-tree "Times New Roman"
-                          "Nimbus Sans"
-                          "Luxi Mono"
-                           (/ myStaffSize 20)))
-}
-
-{
-  c'^\markup { roman: foo \sans bla \typewriter bar }
-}
-@end lilypond
-
-@c we don't do Helvetica / Courier, since GS incorrectly loads
-@c Apple TTF fonts
-
-
-
-@seealso
-
-Exemples : @lsr{text,font@/-family@/-override.ly}.
-
-
-@node New dynamic marks
-@subsection New dynamic marks
-
-Grâce à la commande @code{make-dynamic-script}, vous pouvez créer de
-nouvelles marques textuelles de nuances que vous combinerez
-éventuellement avec les signes de nuances.
-Notez bien que la police des nuances en contient que les caractères
-@code{f,m,p,r,s} and @code{z}. 
-
-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.
-
-@cindex make-dynamic-script
-
-@lilypond[quote,verbatim,ragged-right]
-sfzp = #(make-dynamic-script "sfzp")
-\relative c' {
-  c4 c c\sfzp c
-}
-@end lilypond
-
-@cindex Nuances éditoriales
-@cindex Nuances, entre parenthèses
-
-Vous pouvez aussi encadrer les nuances entre parenthèses ou entre
-crochets.  Ceci est souvent utilisé pour ajouter des nuances propres à
-une édition donnée.
-
-@lilypond[quote,verbatim,ragged-right]
-rndf = \markup{ \center-align {\line { \bold{\italic (}
-  \dynamic f \bold{\italic )} }} }
-boxf = \markup{ \bracket { \dynamic f } }
-{ c'1_\rndf c'1_\boxf }
-@end lilypond
-
-
-
-@node Preparing parts
-@section Preparing parts
-
-Cette section décrit plusieurs fonctions qui permettent de préparer
-un matériel d'orchestre, autrement dit une partition par pupitre.
-
-@menu
-* Multi measure rests::         
-* Metronome marks::             
-* Rehearsal marks::             
-* Bar numbers::                 
-* Instrument names::            
-* Instrument transpositions::   
-* Ottava brackets::             
-* Different editions from one source::  
-@end menu
-
-
-@node Multi measure rests
-@subsection Multi measure rests
-
-@cindex mesures à compter
-@cindex mesure entière de silence
-@cindex Silences, multi-mesures
-@cindex Silences, mesure entère
-@cindex une pause par mesure
-@funindex R
-
-Un silence valant une ou plusieurs mesures entières s'entre avec un
-@samp{R} majuscule.  Ceci ne peut être utile que pour une mesure complètement
-vide, et pour générer des parties séparées : ce silence sera alors
-répété sur autant de mesures que nécessaire, ou bien imprimé une seule
-fois.  La répétition est contrôlée par la propriété
-@code{Score.skipBars}.  Au cas où ce commutateur est défini comme
-vrai (lettre @code{##t} pour @q{true}), les mesures vides ne seront pas répétées, et le nombre exact de
-mesures sera ajouté.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
-\set Score.skipBars = ##t R1*17 R1*4
-@end lilypond
-
-Le @code{1} de @code{R1} est le même que celui utilisé pour la durée
-des notes.  Vous devrez donc, si le morceau n'est pas à 4/4, stipuler
-un autre durée, qui pourra contenir des points d'augmentation ou être
-libellé sous forme de fraction :
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-\time 3/4
-R2. | R2.*2
-\time 13/8
-R1*13/8
-R1*13/8*12 |
-\time 10/8 R4*5*4 |
-@end lilypond
-
-Un @code{R} qui s'étend sur une seule mesure s'imprime tantôt comme
-une pause, tantôt comme une brève, et sera centré sur la mesure
-quelle que soit la métrique.
-
-Dans le cas où ce silence ne dure que quelques mesures, LilyPond
-imprime sur la portée des @qq{ silences d'église }, simple suite de
-rectangles.  La propriété @code{MultiMeasureRest.expand-limit} permet
-d'obtenir un silence unique.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-R1*2 | R1*5 | R1*9
-\override MultiMeasureRest #'expand-limit = 1
-R1*2 | R1*5 | R1*9
-@end lilypond
-
-@cindex texte et silence multi-mesures
-@cindex script et silence multi-mesures
-@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
-variable @code{\fermataMarkup} permet d'ajouter un point d'orgue.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\set Score.skipBars = ##t
-\time 3/4
-R2.*10^\markup { \italic "ad lib." }
-R2.^\fermataMarkup
-@end lilypond
-
-Attention !  c'est @code{MultiMeasureRestText} qui créera le texte, et
-non @code{TextScript}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\override TextScript #'padding = #5
-R1^"low"
-\override MultiMeasureRestText #'padding = #5
-R1^"high"
-@end lilypond
-
-Pour aligner votre texte sur le début de la mesure, rattachez-le à un
-silence invisible de longueur zéro comme ceci :
-
-@example
-s1*0^"Allegro"
-R1*4
-@end example
-
-
-@seealso
-
-Référence du programme : @internalsref{MultiMeasureRestMusic},
-@internalsref{MultiMeasureRest}.
-
-L'objet de rendu @internalsref{MultiMeasureRestNumber} traite les
-nombres, et @internalsref{MultiMeasureRestText} le texte ajouté par
-l'utilisateur. 
-
-
-@refbugs
-
-Vous ne pouvez pas utiliser de doigtés (p.ex. @code{R1-4}) pour
-positionner des nombres au dessus d'un silence multi-mesures, ni
-modifier la hauteur.
-
-@cindex condenser les silences
-
-Condenser plusieurs silences en un unique silence multi-mesures ne peut 
-être automatisé.  Les silences multi-mesures peuvent générer des
-collisions avec d'autres silences.
-
-Pensez à indiquer explicitement la durée de la note qui suit un
-silence multi-mesures, car elle sera par défaut égale à la durée totale
-des mesures à compter. Ainsi, dans l'exemple ci-après, les deux do
-dièses vaudront chacun quatre mesures à 4/4.
-@example
-R1*4 cis cis
-@end example
-Lorsque @code{skipBars} est activé, le résultat semblera correct, mais
-la numérotation des mesures sera suspendue. 
-
-
-
-@node Metronome marks
-@subsection Metronome marks
-
-@cindex Tempo
-@cindex battements par minute
-@cindex indication métronomique
-
-Le métronome se règle de la manière suivante,
-@example
-\tempo @var{durée} = @var{par minute}
-@end example
-
-Les indications métronomiques seront interprétées, dans le fichier
-MIDI, comme des changements de tempo.  Ils seront imprimés sur la
-partition comme ici :
-@funindex \tempo
-@lilypond[quote,ragged-right,verbatim,fragment]
-\tempo 8.=120 c''1
-@end lilypond
-
-
-@commonprop
-
-Vous pouvez indiquer un changement de tempo pour le fichier MIDI sans
-pour autant l'imprimer.  Il suffit alors de le rendre invisible pour
-l'impression :
-@example
-\once \override Score.MetronomeMark #'transparent = ##t
-@end example
-
-Vous pouvez imprimer d'autres indications métronomiques, telles que
-des équivalences, en utilisant ce type d'étiquette textuelle :
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-c4^\markup {
-  (
-  \smaller \general-align #Y #DOWN \note #"16." #1
-  =
-  \smaller \general-align #Y #DOWN \note #"8" #1
-  ) }
-@end lilypond
-
-@noindent
-Pour plus de détails, voir @ref{Text markup}.
-
-
-@seealso
-
-Référence du programme : @internalsref{MetronomeMark}.
-
-
-@refbugs
-
-Les risques de collision ne sont pas vérifiés.  Dans le cas où il y
-aurait des notes au dessus de la portée ou d'autres objets
-(articulations, liaisons, texte, etc), l'indication métronomique peut
-venir en surimpression.  Augmentez alors le décalage de cette
-indication par rapport à la portée :
-
-@example
-\override Score.MetronomeMark #'padding = #2.5
-@end example
-
-
-@node Rehearsal marks
-@subsection Rehearsal marks
-
-@cindex Repères, indication de
-@funindex \mark
-
-Indiquer un repère s'obtient grâce à la commande @code{\mark}.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1 \mark \default
-c1 \mark \default
-c1 \mark #8
-c1 \mark \default
-c1 \mark \default
-@end lilypond
-
-@noindent
-La lettre@tie{}@q{I} n'est pas utilisée, conformément aux usages de la
-gravure.  Cependant, vous pourrez intégrer la lettre @q{I} en utilisant
-
-@example
-\set Score.markFormatter = #format-mark-alphabet
-@end example
-
-Lorsque vous utilisez @code{\mark \default}, le repère s'incrémente
-automatiquement ; toutefois donner un nombre en argument permet de
-spécifier manuellement le repère en question.  La valeur à utiliser
-est enregistrée dans la propriété @code{rehearsalMark}.
-
-Le style du repère est déterminé par la propriété
-@code{markFormatter}.  Il s'agit d'une fonction qui prend en arguments
-le repère en cours (un entier) ainsi que le contexte en cours, et
-retournera un objet de type étiquette.  Dans l'exemple qui suit,
-@code{markFormatter} est réglé pour une procédure type. Quelques
-mesure plus loin, son comportement est modifié pour imprimer un
-repère encadré.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\set Score.markFormatter = #format-mark-numbers
-c1 \mark \default
-c1 \mark \default
-\set Score.markFormatter = #format-mark-box-numbers
-c1 \mark \default
-c1 \mark \default
-c1
-@end lilypond
-
-Le fichier @file{scm/@/translation@/-functions@/.scm} comporte les
-définitions de @code{format-mark-numbers} (comportement par défaut), 
-@code{format-mark-box-numbers},
-@code{format-mark-letters} et @code{format-mark-box-letters}.  Vous
-pouvez vous en inspirer pour d'autres fonctions de formatage.
-
-@code{format-mark-barnumbers}, @code{format-mark-box-barnumbers} et 
-@code{format-mark-circle-barnumbers}  permettent d'imprimer le numéro
-de mesure au lieu des compteurs alphabétique ou numérique.
-
-On peut aussi spécifier manuellement une marque de repère :
-
-@example
-\mark "A1"
-@end example
-
-@noindent
-@code{Score.markFormatter} sera sans effet sur des repères ainsi
-définis.  Un @code{\markup} peut néanmoins s'utiliser en argument.
-
-@example
-\mark \markup@{ \box A1 @}
-@end example
-
-@cindex segno
-@cindex coda
-@cindex D.S al Fine
-
-Un @code{\mark} peut contenir un glype musical tel que le signe
-@emph{segno}.  
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-c1 \mark \markup { \musicglyph #"scripts.segno" }
-c1 \mark \markup { \musicglyph #"scripts.coda" }
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
-c1
-@end lilypond
-
-@noindent
-Pour connaître les différents symboles accessibles par
-@code{\musicglyph}, consultez @ref{The Feta font}.
-
-Pour affiner le positionnement des repères, veuillez vous référer à
-@ref{Text marks}.
-
-@seealso
-
-Dans ce manuel : @ref{Text marks}.
-
-Référence du programme : @internalsref{RehearsalMark}.
-
-Fichiers d'initialisation : @file{scm/@/translation@/-functions@/.scm}
-contient les définitions de @code{format-mark-numbers} et
-@code{format-mark-letters}.  Elles seront source d'inspiration pour
-d'autres fonctions de formatage.
-
-Exemples : @lsr{parts,rehearsal-mark-numbers.ly}
-
-
-@node Bar numbers
-@subsection Bar numbers
-
-@cindex Mesure, numéro de
-@cindex numéros de mesure
-@funindex currentBarNumber
-
-Les numéros de mesure sont imprimés par défaut à chaque début de
-ligne.  Ce nombre est stocké par la propriété @code{currentBarNumber}
-qui sera mis à jour à chaque mesure.
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\repeat unfold 4 {c4 c c c} \break
-\set Score.currentBarNumber = #50
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-L'impression d'un numéro de mesure ne peut intervenir que s'il y a une
-barre.  Aussi, pour pouvoir le faire au début d'un morceau,
-devrez-vous ajouter une barre vide :
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\set Score.currentBarNumber = #50
-\bar ""
-\repeat unfold 4 {c4 c c c} \break
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-Vous pouvez imprimer un numéro de mesure à intervalles réguliers plutôt
-qu'en tête de chaque ligne.  C'est ce qu'illustre l'exemple suivant,
-dont la source complète est 
-@lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
-
-@lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
-
-Désactiver le graveur concerné --- @code{Bar_number_engraver} ---
-donnera une partition sans numéros de mesure.
-
-@lilypond[verbatim,ragged-right,quote]
-\layout {
-  \context {
-    \Score
-    \remove "Bar_number_engraver"
-  }
-}
-\relative c''{
-c4 c c c \break
-c4 c c c
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{BarNumber}.
-
-Exemples : @lsrdir{staff}
-
-
-@refbugs
-
-Les numéros de mesure peuvent entrer en collision avec les crochets de
-@internalsref{StaffGroup}. La propriété @code{padding} --- décalage
---- de l'objet @internalsref{BarNumber} permet alors d'ajuster leur
-positionnement. 
-
-
-@node Instrument names
-@subsection Instrument names
-
-Dans un conducteur, les noms d'instrument sont portés en regard de
-chacune des portées.
-
-Ce résultat s'obtient en spécifiant
-@internalsref{Staff}.@code{instrumentName} et
-@internalsref{Staff}.@code{shortInstrumentName}, ou
-@internalsref{PianoStaff}.@code{instrumentName} et 
-@internalsref{PianoStaff}.@code{shortInstrumentName}.  L'argument
-textuel apparaîtra avant le début de la portée.  La première ligne
-affichera @code{instrumentName}, et les suivantes
-@code{shortInstrumentName}. 
-
-@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-\set Staff.instrumentName = "Ploink "
-\set Staff.shortInstrumentName = "Plk "
-c1
-\break
-c''
-@end lilypond
-
-Le recours à la commande @code{\markup} permet de construire des noms
-d'instruments particuliers, tels que
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c''1
-@end lilypond
-
-Si vous centrez le nom d'un instrument, il faudra le faire pour tous
-
-@lilypond[quote,verbatim,ragged-right]
-{ <<
-\new Staff {
-  \set Staff.instrumentName = \markup {
-    \center-align { "Clarinetti"
-      \line { "in B" \smaller \flat } } }
-  c''1
-}
-\new Staff {
-  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
-  c''1
-}
->>
-}
-@end lilypond
-
-Losque le nom d'un instrument est relativement long, il est judicieux
-d'augmenter le retrait --- @code{indent} --- au sein du bloc
-@code{\layout}. 
-
-Procédez comme suit pour centrer des noms d'instruments tout en
-préservant un décalage par rapport à la portée :
-
-@lilypond[quote,verbatim,ragged-right]
-\new StaffGroup \relative
-<<
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
-    c1 c1
-  }
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
-    c1 c1
-  }
->>
-@end lilypond
-
-Des noms d'instruments peuvent s'utiliser dans d'autres contextes, tels
-que @code{GrandStaff}, @code{ChoirStaff}, ou @code{StaffGroup}, à
-condition de leur affecter le graveur approprié :
-
-@example
-\layout@{
-  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
-@}
-@end example
-
-@noindent
-Pour de plus amples informations sur la manière d'activer ou
-désactiver un graveur, voir @ref{Modifying context plug-ins}.
-
-Vous pouvez changer d'instrument en cours de morceau :
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\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
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{InstrumentName}.
-
-
-
-@node Instrument transpositions
-@subsection Instrument transpositions
-
-@cindex transposition, MIDI
-@cindex transposition, instrument
-
-Vous pouvez spécifier la tonalité d'un instrument transpositeur, ce
-qui est le cas pour de nombreux instruments à vent comme la clarinette
-(si bémol, la ou mi bémol), le cor (fa), ou la trompette (si bémol,
-ut, ré ou mi bémol).
-
-Cette transposition s'indique après le mot-clé @code{\transposition}.
-
-@example
-\transposition bes   %% clarinette en si bémol
-@end example
-
-@noindent
-Cette commande détermine la propriété @code{instrumentTransposition},
-dont la valeur sera utilisée pour le fichier MIDI et en cas de
-citation.  Elle n'affecte en rien la manière dont les notes seront
-imprimées sur la portée.  Référez-vous à la section @ref{Transpose}
-pour obtenir un autre résultat.
-
-La hauteur donnée en argument à @code{\transposition} doit
-correspondre à la note entendue lorsqu'un @code{do} écrit sur la
-portée est joué par l'instrument transpositeur.  Par exemple, lorsque
-vous saisissez une partition en notes réelles, toutes les voix
-devraient être en ut ; pour les instruments transpositeurs, il faudra
-procéder de cette manière : 
-
-@example
-clarinet = @{
-  \transposition c'
-  ...
-@}
-saxophone = @{
-  \transposition c'
-  ...
-@}
-@end example
-
-Lorsque vous entrez de la musique à partir d'une partie transposée,
-utilisez la commande @code{\transposition}.  Si l'on prend l'exemple
-des parties de cor, leur tonalité change souvent au cours d'un morceau ;
-en recopiant cette partie, utilisez @code{\transposition} ainsi :
-
-@example
-\transposition d'
-c'4^"en RÉ"
-...
-\transposition g'
-c'4^"en SOL"
-...
-@end example
-
-
-@node Ottava brackets
-@subsection Ottava brackets
-
-Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
-transposition spécifique d'une octave pour la portée en cours.  C'est
-la fonction @code{set-octavation} qui s'en charge.
-
-@cindex ottava
-@cindex 15ma
-@cindex octaviation
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c''' {
-  a2 b
-  #(set-octavation 1)
-  a b
-  #(set-octavation 0)
-  a b
-}
-@end lilypond
-
-La fonction @code{set-octavation} peut aussi prendre en argument les
-valeurs -1@tie{}(pour 8va bassa), 2@tie{}(pour 15ma --- 2 octaves) ou
--2@tie{}(pour 15ma bassa).   En interne, cette fonction détermine les
-propriétés @code{ottavation} (p.ex. en @code{"8va"} ou @code{"8vb"})
-et @code{centralCPosition}.  Vous pouvez modifier le texte d'une marque
-d'octaviation en définissant @code{ottavation} après avoir fait appel
-à @code{set-octavation} :
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  #(set-octavation 1)
-  \set Staff.ottavation = #"8"
-  c'''
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{OttavaBracket}.
-
-
-@refbugs
-
-@code{set-octavation} gère difficilement les changements de clé qui
-pourraient intervenir alors qu'elle est effective.
-
-
-@node Different editions from one source
-@subsection Different editions from one source
-
-@funindex \tag
-@cindex tag
-
-La commande @code{\tag} affecte un nom à des expressions musicales.
-Les expressions ainsi balisées pourront être filtrées par la suite.
-Ce mécanisme permet d'obtenir différentes versions à partir d'une même
-source musicale. 
-
-Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
-l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
-comportera les ornements. 
-
-@example
-c1
-<<
-  \tag #'partie <<
-    R1 \\
-    @{
-      \set fontSize = #-1
-      c4_"cue" f2 g4 @}
-  >>
-  \tag #'conducteur R1
->>
-c1
-@end example
-
-Ce principe peut s'appliquer aux articulations, textes, etc.  Il
-suffit de positionner 
-@example
--\tag #@var{votre-balise}
-@end example
-avant l'articulation, comme ici :
-@example
-c1-\tag #'part ^4
-@end example
-
-Ceci définira une note avec une indication de doigté conditionnelle.
-
-@cindex keepWithTag
-@cindex removeWithTag
-C'est grâce aux commandes @code{\keepWithTag} et @code{\removeWithTag}
-que vous filtrerez les expressions balisées.  Par exemple :
-@example
-<<
-  @var{de la musique}
-  \keepWithTag #'score @var{de la musique}
-  \keepWithTag #'part @var{de la musique}
->>
-@end example
-donnerait :
-
-@lilypondfile[ragged-right,quote]{tag-filter.ly}
-
-Les arguments de la commande @code{\tag} doivent être un symbole (tel
-que @code{#'score} ou @code{#'part}), suivi d'une expression musicale.
-Vous pouvez utiliser de multiples balises dans un morceau en
-saisissant plusieurs @code{\tag}.
-
-@example
-  \tag #'original-part \tag #'transposed-part @dots{}
-@end example
-
-
-@seealso
-
-Exemples : @lsr{parts,tag@/-filter@/.ly}
+Exemples : @lsr{parts,tag@/-filter@/.ly}
 
 
 @refbugs
@@ -1532,1242 +102,3 @@ Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
 si vous imprimez une partition avec les deux sections balisées.
 
 
-@node Orchestral music
-@section Orchestral music
-
-La musique pour orchestre implique certaines spécificités, que ce soit
-au niveau du conducteur --- la partition du chef --- ou pour les
-partitions de chaque pupitre.  Cette section vous apprendra à gérer
-certains problèmes courants de la musique orchestrale.
-
-@menu 
-* Automatic part combining::
-* Hiding staves::
-* Quoting other voices::
-* Formatting cue notes::
-* Aligning to cadenzas::
-@end menu 
-
-
-
-@node Automatic part combining
-@subsection Automatic part combining
-@cindex regroupement automatique de parties
-@cindex parties, combiner des
-
-Le regroupement automatique de parties vous permet de fusionner deux
-pupitres sur une seule portée, ceci dans le but de créer des
-partitions d'orchestre.  Lorsque les deux parties sont identiques sur
-une certaine durée, une seule s'affiche.  Lorsqu'elles diffèrent, 
-deux voix séparées apparaissent, avec des hampes dont la direction est
-gérée automatiquement.  Vous pouvez aussi identifier et faire
-ressortir les solos et parties @emph{a due}.
-
-Voici la syntaxe qui permet de combiner des parties :
-
-@example
-\partcombine @var{musicexpr1} @var{musicexpr2}
-@end example
-
-
-L'exemple suivant illustre les fonctionnalités élémentaires du
-combinateur de parties : positionner les parties sur une portée, gérer
-la direction des hampes et de la polyphonie.
-
-@lilypond[quote,verbatim,ragged-right,fragment]
-\new Staff \partcombine
-  \relative g' { g g a( b) c c r r }
-  \relative g' { g g r4 r e e g g }
-@end lilypond
-
-Le premier @code{sol} n'apparaît qu'une seule fois, alors qu'il a été
-spécifié deux fois (une fois dans chacune des parties).  La direction
-des hampes et des liaisons de tenue ou de phrasé est gérée
-automatiquement, selon qu'il s'agisse d'un solo ou d'un unisson.  La
-première partie, dont le contexte s'appellera @code{one}, aura toujours
-ses hampes dirigées vers le haut et sera notée @q{Solo}, alors que la
-deuxième, appelée @code{two}, aura des hampes vers le bas et sera
-notée @q{Solo@tie{}II}.
-
-Si votre intention n'est que de fusionner les parties, sans ajouter de
-texte, assignez faux à la propriété @code{printPartCombineTexts}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Staff.printPartCombineTexts = ##f
-  \partcombine
-    \relative g' { g a( b) r }
-    \relative g' { g r4 r f }
->>
-@end lilypond
-
-Le texte imprimé pour les sections solo ou à l'unisson se règle par
-les propriétés @code{soloText}, @code{soloIIText}, et @code{aDueText}. 
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Score.soloText = #"ichi"
-  \set Score.soloIIText = #"ni"
-  \set Score.aDueText = #"tachi"
-  \partcombine
-    \relative g' { g4 g a( b) r }
-    \relative g' { g4 g r r f }
->>
-@end lilypond
-
-LilyPond interprète dans un contexte @internalsref{Voice} les
-arguments fournis à @code{\partcombine}.  Si vous travaillez avec des
-octaves relatives, spécifiez @code{\relative} dans chacune des
-expressions musicales, comme ceci :
-
-@example
-\partcombine
-  \relative @dots{} @var{musicexpr1}
-  \relative @dots{} @var{musicexpr2}
-@end example
-
-@noindent
-Une section @code{\relative} en dehors de @code{\partcombine} sera
-sans effet sur les hauteurs de @var{musicexpr1} et @var{musicexpr2}.
-
-@seealso
-
-Référence du programme : @internalsref{PartCombineMusic}.
-
-@refbugs
-
-Lorsque @code{printPartCombineTexts} est actif et que les deux voix
-jouent souvent les mêmes notes, le combinateur peut afficher @code{a2}
-plus d'une fois par mesure.
-
-@code{\partcombine} ne peut s'inscrire dans un bloc @code{\times}.
-
-@code{\partcombine} ne peut s'inscrire dans un bloc @code{\relative}.
-
-En interne, @code{\partcombine} interprète les deux arguments en tant
-que @code{Voice}s, dénommées @code{one} et @code{two}, puis décide de
-quand les parties seront fusionnées.  Par conséquent, si les arguments
-changent pour d'autres noms de contexte @internalsref{Voice}, les
-événements qu'ils contiendraient seront ignorés. 
-
-
-@node Hiding staves
-@subsection Hiding staves
-
-@cindex Frenched scores
-@cindex Masquer des portées
-
-Dans les partitions d'orchestre, les portées qui n'ont que des
-silences sont habituellement masquées afin de gagner de la place.  Ce
-style d'édition s'appelle en anglais @qq{French Score}.
-Cette fonctionnalité est activée par défaut dans les contextes 
-@internalsref{Lyrics}, @internalsref{ChordNames} et
-@internalsref{FiguredBass}.  Lorsque des lignes appartenant à ces
-contextes se retrouvent vides après placement des sauts de ligne,
-elles sont effacées.
-
-En ce qui concerne les portées normales, il existe un contexte
-@internalsref{Staff} spécifique qui permet d'arriver à ce résultat :
-les portées ne contenant rien ou uniquement des silences multi-mesures
-seront retirées.  La définition de ce contexte est enregistrée dans la
-variable @code{\RemoveEmptyStaffContext}.  Voyez comment la deuxième
-portée disparaît du deuxième système :
-
-@lilypond[quote,ragged-right,verbatim]
-\layout {
-  \context { \RemoveEmptyStaffContext }
-}
-
-{
-  \relative c' <<
-    \new Staff { e4 f g a \break c1 }
-    \new Staff { c4 d e f \break R1 }
-  >>
-}
-@end lilypond
-
-Le premier système comportera absolument toutes les portées.  Si vous
-voulez masquer les portées vides y compris pour le premier système,
-vous devrez assigner vrai à la propriété @code{remove-first} dans
-@internalsref{VerticalAxisGroup}. 
-
-@example
-\override Score.VerticalAxisGroup #'remove-first = ##t
-@end example
-
-Pour masquer d'autres types de contextes, vous pouvez utiliser 
-@code{\AncientRemoveEmptyStaffContext} ou
-@code{\RemoveEmptyRhythmicStaffContext}. 
-
-Une application particulière de cette fonctionnalité est la création
-d'une @emph{ossia} --- variante d'une partie de la mélodie --- affichée à
-l'aide d'une portée supplémentaire.
-
-
-@node Quoting other voices
-@subsection Quoting other voices
-
-@cindex cues
-@cindex citation
-
-Grâce aux citations de répliques, vous pouvez insérer directement dans une partie
-des fragments d'une autre partie.  Avant qu'une partie ne puisse être
-mentionnée ailleurs, elle doit être considérée comme reproductible.
-C'est le but de la commande @code{\addQuote}.
-
-@example
-\addQuote @var{nom} @var{musique}
-@end example
-
-
-@noindent
-Ici, @var{nom} représente une chaîne d'identification, et
-@var{musique} n'importe quelle musique.  Voici un exemple de
-@code{\addQuote} :
-
-@example
-\addQuote clarinet \relative c' @{
-  f4 fis g gis
-@}
-@end example
-
-Vous devez placer cette commande au niveau le plus haut, c'est à dire
-en dehors de tout bloc de musique.
-
-Après avoir fait appel à @code{\addquote}, la citation interviendra
-en utilisant @code{\quoteDuring} ou @code{\cueDuring} :
-
-@example
-\quoteDuring #@var{nom} @var{musique}
-@end example
-
-Au cours d'une partie, des extraits de répliques peuvent être cités en
-utilisant la commande @code{\quoteDuring}.
-
-@example
-\quoteDuring #"clarinet" @{ s2. @}
-@end example
-
-Cela citera trois noires (la durée de @code{s2.}) appartenant à la
-voix @code{clarinette} précédemment générée.
-
-Plus précisément, on s'arrête à cet instant de la partie en cours
-d'impression, et l'on extrait les notes à ce même instant dans la voix
-citée --- celle qui contient @code{\addQuote}.  C'est la raison pour
-laquelle l'argument de @code{\addQuote} doit englober toute la voix en
-question, y compris les éventuels silences à son début.
-
-Les citations tiennent compte des transpositions, aussi bien celle de
-l'instrument d'origine que celle de la partie où elle intervient, dans
-la mesure où elles sont spécifiées par la commande @code{\transposition}.
-
-@lilypond[quote,ragged-right,verbatim]
-\addQuote clarinet \relative c' {
-  \transposition bes
-  f4 fis g gis
-}
-
-{
-  e'8 f'8 \quoteDuring #"clarinet" { s2 }
-}
-@end lilypond
-
-Le type d'événements pris en charge pour la citation peut se régler
-avec la propriété @code{quotedEventTypes}.  Par défaut, sa valeur est
-fixée à @code{(note-event rest-event)}, ce qui signifie que seuls les
-notes et silences seront mentionnés par @code{\quoteDuring}.
-Définir
-
-@example
-\set Staff.quotedEventTypes =
-       #'(note-event articulation-event dynamic-event)
-@end example
-
-@noindent
-reproduira les notes (mais pas les silences), ainsi que les scripts
-et nuances.
-
-@refbugs
-
-Seul le contenu de la première @internalsref{Voice} rencontrée dans la
-partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
-voie de conséquence, @code{music} ne saurait comprendre de @code{\new}
-ou une instance @code{context Voice} qui la ferait passer à une autre voix.
-
-Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
-un blocage de LilyPond.
-
-Citer des triolets imbriqués peut entraîner un résultat de médiocre qualité.
-
-
-@seealso
-
-Dans ce manuel : @ref{Instrument transpositions}.
-
-Exemples : @lsr{parts,quote.ly}, @lsr{parts,quote-transportation.ly}
-
-Référence du programme : @internalsref{QuoteMusic}.
-
-
-@node Formatting cue notes
-@subsection Formatting cue notes
-
-@cindex petites notes, formater des
-
-La section précédente indiquait comment insérer des notes d'une autre
-voix.  Nous allons maintenant voir une fonction musicale avancée,
-@code{\cueDuring}, qui facilite le formatage des petites notes.
-
-Sa syntaxe est :
-
-@example
-  \cueDuring #@var{nom} #@var{updown} @var{musique}
-@end example
-
-Des notes issues de la partie @var{nom} s'insèreront dans une
-@internalsref{Voice} nommée @code{cue}, simultanément avec
-@var{musique} --- habituellement un silence.  L'apparition des petites
-notes initialise une polyphonie temporaire pour la portée concernée.  
-L'argument @var{updown} détermine si ces petites notes seront
-attachées à la première ou à la seconde voix.
-
-
-@lilypond[verbatim,ragged-right]
-smaller = {
-  \set fontSize = #-2
-  \override Stem #'length-fraction = #0.8
-  \override Beam #'thickness = #0.384
-  \override Beam #'length-fraction = #0.8
-}
-
-\addQuote clarinet \relative {
-  R1*20
-  r2 r8 c' f f
-}
-
-\new Staff \relative  <<
-
-  % setup a context for cue notes.
-  \new Voice = "cue" { \smaller \skip 1*21 }
-
-  \set Score.skipBars = ##t
-
-  \new Voice {
-    R1*20
-    \cueDuring #"clarinet" #UP {
-      R1
-    }
-    g4 g2.
-  }
->>
-@end lilypond
-
-
-Quelques indications pour une citation efficace :
-
-@itemize @bullet
-@item
- Les notes de la citation sont dans une police plus petite.
-@item
- La citation comporte une étiquette indiquant l'instrument qui joue.
-@item
- Lorsque la partie originale reprend sa place, rappeler l'instrument.
-
-@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
-
-@c Yes, this is good practice.  Otherwise, the start of the original
-@c part can only be seen from the font size.  This is not good enough
-@c for sight-reading.  It is possilbe to use other
-@c markers (e.g. a big close-bracket over the staff) to indicate the cue
-@c   notes are
-@c finished.
-@c -hwn
-
-
-Tout autre modification introduite par la citation devrait être
-annulée.  Par exemple, si l'instrument cité utilise une autre clé, il
-faudra revenir à la clé habituelle.
-
-@end itemize
-
-La macro @code{\transposedCueDuring} est particulièrement adaptée pour
-des instrument ayant une tessiture éloignée, comme dans le cas d'un
-piccolo cité dans une partie de contrebasson.
-
-@lilypond[verbatim,ragged-right,quote]
-picc = \relative c''' {
-  \clef "treble^8"
-  R1 |
-  c8 c c e g2 |
-  a4 g g2 |
-}
-\addQuote "picc" { \picc }
-
-cbsn = \relative c, {
-  \clef "bass_8"
-  c4 r g r
-  \transposedCueDuring #"picc" #UP c,, { R1 } |
-  c4 r g r |
-}
-
-<<
-  \context Staff = "picc" \picc
-  \context Staff = "cbsn" \cbsn
->>
-@end lilypond
-
-
-
-@node Aligning to cadenzas
-@subsection Aligning to cadenzas
-
-Dans un contexte orchestral, une cadence constitue un problème
-spécifique.  Lors du montage d'une partition contenant une cadence,
-tous les autres instruments doivent sauter autant de notes que ce
-qu'en comporte la cadence, faute de quoi il démarreraient trop tôt ou
-trop tard. 
-
-Les fonctions @code{mmrest-of-length} ou @code{skip-of-length}
-permettent de résoudre ce problème.  Ces fonctions Scheme prennent en
-argument un fragment de musique, et génèrent un @code{\skip} ou un
-silence multi-mesures d'une durée correspondant à ce fragment.
-L'exemple qui suit illustre l'utilisation de @code{mmrest-of-length}. 
-
-@lilypond[verbatim,ragged-right,quote]
-cadenza = \relative c' {
-  c4 d8 << { e f g } \\ { d4. } >>
-  g4 f2 g4 g
-}
-
-\new GrandStaff <<
-  \new Staff { \cadenza c'4 }
-  \new Staff {
-    #(ly:export (mmrest-of-length cadenza))
-    c'4
-  }
->>
-@end lilypond
-
-
-
-
-@node Contemporary notation
-@section Contemporary notation
-
-Les compositeurs du XXe siècle ont largement étendu le vocabulaire
-musical.  Face à cette expansion, de nombreuses innovations ont été
-tentées en matière de notation musicale.  L'ouvrage de Kurt Stone,
-@q{Music Notation in the 20th century} (cf. @ref{Literature
-list}), nous en propose une vue d'ensemble.
-
-Cette section aborde des aspects que l'on ne rencontre pas en notation
-traditionnelle, tels que hauteurs, ligatures de triolets ou
-articulations.  Pour tout ce qui relève de la notation traditionnelle
-au sein de la musique contemporaine, comme les microintervalles, les
-n-olets imbriqués ou les points d'orgue inhabituels, référez-vous aux
-sections appropriées de la documentation.
-
-@menu 
-* Polymetric notation::
-* Time administration::
-* Proportional notation (introduction)::
-* Clusters::
-* Special noteheads::
-* Feathered beams::
-* Improvisation::
-* Selecting notation font size::
-@end menu 
-
-
-@node Polymetric notation
-@subsection Polymetric notation
-
-@cindex métrique composite
-@cindex composite, métrique
-@cindex métrique polymétrique
-@cindex polymétrie
-
-LilyPond ne gère pas les métriques composites de manière explicite,
-mais on peut contourner ce problème.  Dans l'exemple suivant,
-l'indicateur de métrique est obtenu grâce à une étiquette textuelle.
-Cette étiquette vient s'insérer dans l'objet graphique (@emph{grob})
-@internalsref{TimeSignature}.  Voir aussi
-@lsr{contemporary,compound-time-signature}. 
-
-
-@lilypond[verbatim,ragged-right]
-% create 2/4 + 5/8
-tsMarkup =\markup {
-  \override #'(baseline-skip . 2) \number {
-    \column { "2" "4" }
-    \vcenter "+"
-    \bracket \column { "5" "8" }
-  }
-}
-
-{
-  \override Staff.TimeSignature #'stencil = #ly:text-interface::print
-  \override Staff.TimeSignature #'text = #tsMarkup
-  \time 3/2
-  c'2 \bar ":" c'4 c'4.
-}
-@end lilypond
-
-Il arrive aussi que chaque portée ait sa propre métrique.  Vous y
-parviendrez en déplaçant le @internalsref{Timing_translator} dans le
-contexte @internalsref{Staff}.
-
-@example
-\layout @{
-  \context @{ \Score
-     \remove "Timing_translator"
-     \remove "Default_bar_line_engraver"
-  @}
-  \context @{
-    \Staff
-    \consists "Timing_translator"
-    \consists "Default_bar_line_engraver"
-  @}
-
-@}
-@end example
-
-
-Maintenant, chacune des portées dispose de sa propre métrique.
-@example
-<<
-  \new Staff @{
-    \time 3/4
-    c4 c c | c c c |
-  @}
-  \new Staff @{
-    \time 2/4
-    c4 c | c c | c c
-  @}
-  \new Staff @{
-    \time 3/8
-    c4. c8 c c c4. c8 c c
-  @}
->>
-@end example
-
-@lilypond[quote,ragged-right]
-\layout{
-  \context{
-     \Score
-     \remove "Timing_translator"
-     \remove "Default_bar_line_engraver"
-    }
-  \context{ \Staff
-    \consists "Timing_translator"
-    \consists "Default_bar_line_engraver"
-  }
-}
-
-\relative c' <<
-  \new Staff {
-    \time 3/4
-    c4 c c | c c c |
-  }
-  \new Staff {
-    \time 2/4
-    c4 c | c c | c c
-  }
-  \new Staff {
-    \time 3/8
-    c4. c8 c c c4. c8 c c
-  }
->>
-@end lilypond
-
-
-Une autre forme de notation polymétrique consiste dans le fait que des
-notes aient une durée relative différente selon la portée.  
-
-Vous pouvez créer une telle notation en définissant une métrique
-commune à toutes les portées,  que vous proratiserez manuellement
-selon le cas en utilisant @code{timeSignatureFraction} pour obtenir la
-division adéquate pour chaque portée.  Les durées, dans chacune des
-portées, seront alors échelonnées par rapport à la métrique commune.
-L'échelle de représentation se règle avec @code{\compressMusic} ---
-qui fonctionne comme @code{\times}, sans toutefois créer de crochet.
-La syntaxe appropriée est :
-@example
-\compressMusic #'(@var{numérateur} . @var{dénominateur}) @var{exprmusicale}
-@end example
-
-
-L'exemple suivant utilise parallèlement des mesures à 3/4, 9/8 et
-10/8.  Pour la deuxième portée, les durées sont multipliées par 2/3,
-de telle sorte que @w{2/3 * 9/8 = 3/4} ; pour la troisième, elles sont
-multipliées par 3/5, de telle sorte que @w{3/5 * 10/8 = 3/4}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' { <<
-  \new Staff {
-    \time 3/4
-    c4 c c | c c c |
-  }
-  \new Staff {
-    \time 3/4
-    \set Staff.timeSignatureFraction = #'(9 . 8)
-    \compressMusic #'(2 . 3)
-      \repeat unfold 6 { c8[ c c] }
-  }
-  \new Staff {
-    \time 3/4
-    \set Staff.timeSignatureFraction = #'(10 . 8)
-    \compressMusic #'(3 . 5) {
-      \repeat unfold 2 { c8[ c c] }
-      \repeat unfold 2 { c8[ c] }
-      | c4. c4. \times 2/3 { c8 c c } c4
-    }
-  }
->> }
-@end lilypond
-
-
-
-
-@refbugs
-
-L'utilisation de métriques différentes en parallèle entraine un
-alignement vertical.  De ce fait, les barres de mesure ont tendance à
-fausser l'espacement régulier.
-
-
-@node Time administration
-@subsection Time administration
-
-@cindex Temps, gestion du
-
-Le temps est administré par le @internalsref{Time_signature_engraver},
-qui réside en principe dans le contexte @internalsref{Score}.  Sa
-gestion traite les variables suivantes :
-
-@table @code
-@item currentBarNumber
-Le numéro de mesure.
-
-@item measureLength
-La longueur de la mesure, dans la métrique en cours.  Pour une mesure
-à 4/4, elle est de@tie{}1, et de 3/4 pour une mesure à 6/8.
-
-@item measurePosition
-Le moment où l'on en est dans la mesure en cours.  Cette quantité est
-remise à@tie{}0 dès lors qu'on dépasse @code{measureLength} ; la variable
-@code{currentBarNumber} est alors incrémentée.  
-
-@item timing
-Lorsqu'on lui assigne la valeur @emph{vrai}, les valeurs ci-dessus
-mentionnées sont mises à jour à chaque pas.  Fixée à @emph{faux}, le
-graveur restera indéfiniment dans la mesure en cours.
-@end table
-
-Le calage peut être modifié en réglant explicitement l'une de ces
-variables.  Dans l'exemple qui suit, nous réglons la métrique à 4/4,
-tout en fixant @code{measureLength} à 5/4.  Un peu plus loin, nous
-raccourcissons la mesure de 1/8, en assignant 7/8 à
-@code{measurePosition}, alors que nous en sommes à 2/4 dans la
-mesure ; la barre de mesure tombera donc à @w{2/4 + 3/8}.  Les 3/8
-résultent du fait que 5/4 équivaut à 10/8, mais nous nous sommes recalés
-à 7/8 de la mesure ;  donc @w{10/8 @minus{} 7/8 = 3/8}.
-
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-\set Score.measureLength = #(ly:make-moment 5 4)
-c1 c4
-c1 c4
-c4 c4
-\set Score.measurePosition = #(ly:make-moment 7 8)
-b8 b b
-c4 c1
-@end lilypond
-
-@noindent
-Comme le montre cet exemple, @code{ly:make-moment n m} construit une
-durée de n/m fois une ronde.  
-Par conséquent, @code{ly:make-moment 1 8} correspond à une croche, et
-@code{ly:make-moment 7 16} à la durée de sept doubles croches.
-
-
-@node Proportional notation (introduction)
-@subsection Proportional notation (introduction)
-@cindex Notation proportionnelle
-
-Voir @ref{Proportional notation}.
-
-
-@c À faire : supprimer tout ça ?
-
-Les notes peuvent s'espacer proportionnellement en assignant une durée
-à @code{proportionalNotationDuration}
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-<<
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
-  \new Staff { c8[ c c c c c]  c4 c2 r2 }
-  \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
->>
-@end lilypond
-
-Manipuler cette propriété affectera l'espacement idéal uniquement pour
-des notes consécutives.  Pour obtenir une véritable notation
-proportionnelle, vous devrez tenir compte des réglages suivants :
-
-@itemize @bullet
-
-@item La véritable notation proportionnelle exige que des symboles
-puissent en écraser d'autres.  Pour y parvenir, il faut retirer le
-@internalsref{Separating_line_group_engraver} du contexte
-@internalsref{Staff}. 
-
-@item L'influence en matière d'espacement induite par le formatage
-(clés, barres de mesure, etc) s'annule en assignant
-@emph{vrai}@tie{}(#t) à la propriété @code{strict-note-spacing} de
-l'objet @internalsref{SpacingSpanner}.
-
-@item Les affinages optiques se règlent en assignant @emph{vrai} à la
-propriété @code{uniform-stretching} du @internalsref{SpacingSpanner}. 
-
-
-@end itemize
-
-@seealso
-
-Exemples : @lsr{spacing,proportional@/-spacing@/.ly}, 
-@lsr{spacing,proportional@/-strict@/-grace@/-notes@/.ly}, et
-@lsr{spacing,proportional@/-strict@/-notespacing@/.ly}
-
-Le fichier @file{input/proportional.ly} illustre la notation
-proportionnelle stricte.
-
-
-@node Clusters
-@subsection Clusters
-
-@cindex cluster
-
-Un cluster indique un agrégat de sons.  On peut le représenter par une
-plage limitée par un ambitus (notes extrêmes).  On obtient une telle notation en
-appliquant la fonction @code{makeClusters} à une séquence d'accords,
-comme  
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-\makeClusters { <c e > <b f'> }
-@end lilypond
-
-Des notes ordinaires et des clusters peuvent cohabiter sur une même
-portée, y compris simultanément --- en pareil cas, rien ne sera fait
-pour tenter d'empécher les chevauchements entre notes et clusters.
-
-@seealso
-
-Référence du programme : @internalsref{ClusterSpanner},
-@internalsref{ClusterSpannerBeacon},
-@internalsref{Cluster_spanner_engraver}.
-
-Exemples : @lsr{contemporary,cluster@/.ly}.
-
-@refbugs
-
-Les expressions musicales du type @code{<< @{ g8 e8 @} a4 >>} ne
-seront pas imprimées de façon acceptable.  utilisez plutôt 
-@code{<g a>8 <e a>8} . 
-
-
-@node Special noteheads
-@subsection Special noteheads
-
-@cindex têtes de note, spéciales
-
-Certains instruments utilisent des têtes de note différentes à des
-fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
-notes étouffées des guitares ; des losanges pour les harmoniques des
-cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
-losange ; pour les autres styles de tête, il vous faudra jouer avec la
-propriété @code{NoteHead}.
-
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-c4 d
-\override NoteHead #'style = #'cross
-e f
-\revert NoteHead #'style
-e d <c f\harmonic> <d a'\harmonic>
-@end lilypond
-
-@noindent
-Pour une liste exhaustive des styles de tête de note, consultez 
-@ref{Note head styles}.
-
-
-@seealso
-
-Référence du programme : @internalsref{NoteHead}.
-
-
-@node Feathered beams
-@subsection Feathered beams
-
-Les ligatures en soufflet s'obtiennent en définissant la propriété
-@code{grow-direction} d'une barre de ligature.  La fonction
-@code{\featherDurations} sert à ajuster la durée des notes.
-
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-\override Beam #'grow-direction = #LEFT
-\featherDurations #(ly:make-moment 5 4) 
-{
-  c16[ c c c c c c]
-}
-@end lilypond
-
-@refbugs
-
-La commande @code{\featherDurations} ne permet de traiter que de très
-courts extraits.
-
-@node Improvisation
-@subsection Improvisation
-
-L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
-allongée (@emph{slash}).  Ces têtes de notes sont créées  par
-l'adjonction du graveur @internalsref{Pitch_squash_engraver} au
-contexte @internalsref{Voice}, de telle sorte que la commande
-
-@example
-\set squashedPosition = #0
-\override NoteHead #'style = #'slash
-@end example
-
-@noindent
-active les notes penchées.
-
-Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
-@code{\improvisationOff} pour cette séquence, comme l'illustre
-l'exemple ci dessous.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Voice \with {
-  \consists Pitch_squash_engraver
-} \transpose c c' {
-  e8 e g a a16(bes)(a8) g \improvisationOn
-  e8
-  ~e2~e8 f4 fis8
-  ~fis2 \improvisationOff a16(bes) a8 g e
-}
-@end lilypond
-
-
-@node Selecting notation font size
-@subsection Selecting notation font size
-
-Le plus sûr moyen de régler la taille de la police, quelque soit le
-contexte, consiste à définir la propriété @code{fontSize}.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g
-@end lilypond
-
-@noindent
-Ceci ne modifiera en rien la taille des différents symboles tels que
-ligatures ou liaisons.
-
-En interne, la propriété @code{fontSize} d'un contexte aura pour effet
-de définir la propriété @code{font-size} pour tous les objets de
-rendu.  La valeur de @code{font-size} est un entier représentant la
-taille proportionnellement à la hauteur standard de la portée en
-cours.  Chaque incrément correspond à une augmentation d'environ
-12@tie{}% de la taille de la police. Un pas de six aboutit exactement
-au doublement de la taille.  La fonction Scheme @code{magstep}
-convertit le nombre affecté à @code{font-size} en facteur d'échelle.
-Vous pouvez aussi définir directement la propriété @code{font-size} de
-manière à n'affecter seulement que certains objets de rendu.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g
-@end lilypond
-
-Pour changer la taille des symboles musicaux (police Feta), LilyPond met
-à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
-cf. @ref{Setting the staff size}.  La taille standard, pour laquelle
-@code{font-size} vaut 0, dépend de la hauteur de la portée.  À une
-portée de 20 points correspond une police de 10 points.
-
-La propriété @code{font-size} ne peut intervenir que pour les objets
-qui utilisent des polices, autrement dit ceux qui disposent de
-l'interface de rendu @internalsref{font-interface}.
-
-@refcommands
-
-Les commandes suivantes définissent @code{fontSize} pour la voix en
-cours :
-
-@funindex \tiny
-@code{\tiny},
-@funindex \small
-@code{\small},
-@funindex \normalsize
-@code{\normalsize}.
-
-
-
-@node Educational use
-@section Educational use
-
-Grâce aux nombreux contrôles dont LilyPond dispose, il est tout à fait
-possible de générer du matériel éducatif d'une qualité comparable aux
-grandes partitions.
-
-@menu
-* Balloon help::                
-* Blank music sheet::           
-* Hidden notes::                
-* Shape note heads::            
-* Easy Notation note heads::    
-* Analysis brackets::           
-* Coloring objects::            
-* Parentheses::                 
-* Grid lines::                  
-@end menu
-
-@node Balloon help
-@subsection Balloon help
-
-Vous pouvez marquer et nommer des éléments de notation à l'aide de
-bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
-notation. 
-
-En voici un exemple :
-@c KEEP LY
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice \with { \consists "Balloon_engraver" }
-{
-  \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
-  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
-}
-@end lilypond
-
-@noindent
-Vous disposez de deux fonctions musicales, @code{balloonText} et
-@code{balloonGrobText}.  @code{balloonGrobText} prend en argument
-l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
-comme une simple articulation.  Les autres arguments sont le décalage
-et le texte de la bulle.
-
-@cindex bulles
-@cindex notation, expliquer
-
-@seealso
-
-Référence du programme : @internalsref{text-balloon-interface}.
-
-
-
-
-@node Blank music sheet
-@subsection Blank music sheet
-
-@cindex Papier musique
-@cindex Portées, feuille blanche
-
-Une feuille de papier musique s'obtient en utilisant des notes
-invisibles, et en invalidant le @code{Bar_number_engraver}.
-
-@c KEEP LY
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
-  \repeat unfold 2 % À modifier pour plus de lignes.
-  { s1\break }
-  \bar "|."
-}
-\new Score \with {
-  \override TimeSignature #'transparent = ##t
-% décommenter la  ligne suivante selon besoin
-%  \override Clef #'transparent = ##t
-  defaultBarType = #""
-  \remove Bar_number_engraver
-} <<
-
-% à adapter selon les portées désirées
-  \new Staff \emptymusic
-  \new TabStaff \emptymusic
->>
-@end lilypond
-
-
-@node Hidden notes
-@subsection Hidden notes
-
-@cindex Masquées, notes
-@cindex Invisibles, notes
-@cindex Transparentes, notes
-
-@funindex \hideNotes
-@funindex \unHideNotes
-Les notes masquées --- ou invisibles ou encore transparentes --- sont
-utiles dans le cadre d'exercices de théorie ou de composition.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-c4 d4
-\hideNotes
-e4 f4
-\unHideNotes
-g4 a
-@end lilypond
-
-
-@node Shape note heads
-@subsection Shape note heads
-
-@cindex tête de note, allure
-
-En notation profilée, le profil d'une tête de note correspond à la
-fonction harmonique de cette note dans la gamme.  Ce style de notation
-était très en vogue dans les recueils de chansons américains du XIXe
-siècle. 
-
-Des notes profilées sont produites après activation de
-@code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
-
-@lilypond[verbatim,relative=1,fragment]
-  \aikenHeads
-  c8 d4 e8 a2 g1
-  \sacredHarpHeads
-  c8 d4. e8 a2 g1
-@end lilypond
-
-Les profils sont déterminés par la hauteur dans la gamme, le premier
-degré étant défini par la commande @code{\key}. 
-
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
-
-Les notes profilées sont mises en œuvre par la propriété
-@code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
-de symboles.  Le n-ième élément indique le style à utiliser pour le
-n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
-
-@lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
-  c8 d4. e8 a2 g1
-@end lilypond
-
-
-@node Easy Notation note heads
-@subsection Easy Notation note heads
-
-@cindex tête de note, apprentissage
-@cindex notation facile
-@cindex Hal Leonard
-
-Les notes @q{easy play} comportent le nom de la note à l'intérieur de
-la tête.  On l'utilise dans des partitions pour débutants.
-
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
-  \setEasyHeads
-  c'2 e'4 f' | g'1
-@end lilypond
-
-La commande @code{\setEasyHeads} remplace tous les réglages de l'objet
-@internalsref{NoteHead}.  L'impression doit être de plus grande
-taille, afin que les lettres soient lisibles.  Voir à ce propos
-@ref{Setting the staff size}.
-
-@refcommands
-
-@funindex \setEasyHeads
-@code{\setEasyHeads}
-
-
-@node Analysis brackets
-@subsection Analysis brackets
-@cindex crochets
-@cindex crochets de phrasé
-@cindex analyse musicologique
-@cindex crochet de regroupement de notes
-
-On utilise des crochets en analyse musicale, pour indiquer la
-structure d'une pièce.  LilyPond permet d'utiliser une forme
-simplifiée de crochets horizontaux imbriqués, dans la mesure où le
-contexte @internalsref{Staff} comporte le graveur
-@internalsref{Horizontal_bracket_engraver}.  Un crochet s'ouvre avec
-@code{\startGroup}, et se ferme avec @code{\stopGroup}.
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\stopGroup
-  }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{HorizontalBracket}.
-
-
-@node Coloring objects
-@subsection Coloring objects
-
-Des objets peuvent être colorisés individuellement.  Une listes des
-noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\override NoteHead #'color = #red
-c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
-d
-\override Stem #'color = #blue
-e
-@end lilypond
-
-L'intégralité de la palette des couleurs définies pour X11 est
-accessible par la fonction Scheme x11-color.  Cette fonction prend
-en argument une expression symbolique
-
-@example
-\override Beam #'color = #(x11-color 'MediumTurquoise)
-@end example
-
-ou une chaîne de caractères
-
-@example
-\override Beam #'color = #(x11-color "MediumTurquoise")
-@end example
-
-La première formulation est à la fois plus rapide à écrire et aussi
-plus efficace.  Néanmoins, la deuxième forme permet d'accéder aux noms
-composés des couleurs de X11.
-
-@example
-\override Beam #'color = #(x11-color "medium turquoise")
-@end example
-
-Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
-revient à la couleur par défaut, le noir.  Le problème ressort de
-façon évidente au vu de la partition finale.
-
-L'exemple suivant illustre l'utilisation de la fonction
-@code{x11-color}.  Notez que, après avoir été définie à (x11-color
-'Boggle), la couleur des hampes repasse au noir.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-  \set Staff.instrumentName = \markup {
-    \with-color #(x11-color 'navy) "Clarinet"
-  }
-  \time 2/4
-  gis''8 a''
-  \override Beam #'color = #(x11-color "medium turquoise")
-  gis'' a''
-  \override NoteHead #'color = #(x11-color "LimeGreen")
-  gis'' a''
-  \override Stem #'color = #(x11-color 'Boggle)
-  gis'' a''
-}
-@end lilypond
-
-
-@seealso
-
-Annexes : @ref{List of colors}.
-
-
-@refbugs
-Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
-internet.  Aussi nous vous recommandons, dans le cadre d'une
-présentation multimedia, d'utiliser des couleurs de base.
-
-Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
-normale ayant un nom similaire.
-
-Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
-@code{\override}. si besoin est, utilisez @code{\tweak}.  
-Pour plus de détails, consultez @ref{Objects connected to the input}.
-
-
-@node Parentheses
-@subsection Parentheses
-
-@cindex fantômes, notes
-@cindex notes fantômes
-@cindex parenthèses, notes entre
-
-Des objets peuvent être mis entre parenthèses en saisissant
-@code{\parenthesize} juste avant l'événement musical.
-
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
-  c
-  \parenthesize d
-  g
->4-\parenthesize -.
-@end lilypond
-
-Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
-comprendre qu'une seule note.
-
-@example
-< \parenthesize NOTE>
-@end example
-
-
-@node Grid lines
-@subsection Grid lines
-
-Vous pouvez tracer des lignes entre les portées, synchronisées avec
-les notes.
-@c KEEP LY
-@lilypond[ragged-right,quote,verbatim]
-\layout {
-  \context {
-    \Staff
-    \consists "Grid_point_engraver" %% active les guides
-    gridInterval = #(ly:make-moment 1 4)
-  }
-}
-
-\new Score \with {
-  \consists "Grid_line_span_engraver"
-  %% centre les lignes guides horizontalement sous les notes
-  \override NoteColumn #'X-offset = #-0.5
-}
-
-\new ChoirStaff <<
-  \new Staff {
-    \stemUp
-    \relative {
-      c'4. d8 e8 f g4
-    }
-  }
-  \new Staff {
-    %% centre les lignes guides verticalement
-    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
-    \stemDown
-    \clef bass
-    \relative c {
-      c4  g'  f  e
-    }
-  }
->>
-@end lilypond
-
-Exemples : @lsrdir{education}
-
-
diff --git a/Documentation/fr/user/ancient.itely b/Documentation/fr/user/ancient.itely
new file mode 100644
index 0000000000..32ec87c76d
--- /dev/null
+++ b/Documentation/fr/user/ancient.itely
@@ -0,0 +1,2236 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Ancient notation
+@section Ancient notation
+
+@cindex Vaticana, Editio
+@cindex Medicaea, Editio
+@cindex hufnagel
+@cindex Petrucci
+@cindex mensural
+
+La gestion par LilyPond des formes de notation ancienne inclut des
+fonctionnalités spécifiques à la notation mensurale et au chant
+grégorien.  La basse chiffrée est également partiellement prise en
+charge.
+
+De nombreux objets graphiques --- @qq{grobs} dans le jargon de LilyPond
+--- disposent d'une propriété @code{style}, comme nous le verrons dans
+@itemize @bullet
+@item
+@ref{Ancient note heads},
+@item
+@ref{Ancient accidentals},
+@item
+@ref{Ancient rests},
+@item
+@ref{Ancient clefs},
+@item
+@ref{Ancient flags},
+@item
+@ref{Ancient time signatures}.
+@end itemize
+
+Manipuler cette propriété permet d'adapter l'aspect typographique des
+grobs à une forme de notation particulière, ce qui évite la création de
+nouveaux concepts de notation.
+
+En plus des signes d'articulation standards décrits à la section
+@ref{Articulations}, la notation ancienne dispose de signes particuliers.
+
+@itemize @bullet
+@item
+@ref{Ancient articulations}
+@end itemize
+
+D'autres aspects de la notation ancienne ne peuvent pas être gérés
+aussi simplement qu'en jouant sur les propriétés d'un style appliqué à
+un objet graphique ou en lui ajoutant des articulations.  Certains
+concepts sont spécifiques à la notation ancienne.
+
+@itemize @bullet
+@item
+@ref{Custodes},
+@item
+@ref{Divisiones},
+@item
+@ref{Ligatures}.
+@end itemize
+
+Si tout cela vous dépasse et que vous désirez plonger dans le vif du
+sujet sans trop vous préoccuper d'ajuster des contextes, consultez les
+pages dédiées aux contextes prédéfinis.  Ils vous permettront d'adapter
+vos contextes de voix et de portée, et vous n'aurez plus qu'à saisir les
+notes.
+
+@itemize @bullet
+@item
+@ref{Gregorian Chant contexts},
+@item
+@ref{Mensural contexts}.
+@end itemize
+
+LilyPond gère partiellement la représentation de basses chiffrées,
+typiques de l'époque baroque, mais également employées de nos jours en
+harmonie et en analyse.
+
+@itemize @bullet
+@item
+@ref{Figured bass}
+@end itemize
+
+Voici les points que nous allons aborder :
+
+@menu
+* Ancient TODO::                
+@end menu
+
+@node Ancient TODO
+@subsection Ancient TODO
+
+@menu
+* Ancient note heads::          
+* Ancient accidentals::         
+* Ancient rests::               
+* Ancient clefs::               
+* Ancient flags::               
+* Ancient time signatures::     
+* Ancient articulations::       
+* Custodes::                    
+* Divisiones::                  
+* Ligatures::                   
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+* Gregorian Chant contexts::    
+* Mensural contexts::           
+* Musica ficta accidentals::    
+* Figured bass::                
+@end menu
+
+
+
+@node Ancient note heads
+@unnumberedsubsubsec Ancient note heads
+
+@cindex têtes de note, musique ancienne
+
+Pour de la musique ancienne, vous disposez de plusieurs styles de tête
+de note, en plus du style par défaut @code{default}.  Vous pouvez
+affecter à la propriété @code{style} de l'objet @internalsref{NoteHead}
+les valeurs @code{baroque}, @code{neomensural}, @code{mensural} ou
+@code{petrucci}.  En style @code{baroque}, la seule différence par
+rapport au style @code{default} concerne la @code{\breve} qui sera
+carrée et non pas ovoïde.  Le style @code{neomensural} ajoute au
+@code{baroque} le fait que les notes de durée inférieure ou égale à une
+ronde sont en forme de losange, et les hampes centrées sur la tête.  Ce
+style est particulièrement adapté à la transcription de la musique
+mesurée dans les incipits.  Le style @code{mensural} permet de
+reproduire les têtes de note telles qu'imprimées au XVIe siècle.  Enfin,
+le style @code{petrucci} imite des partitions historiques, bien
+qu'il utilise de plus grosses têtes de note.
+
+L'exemple suivant illustre le style @code{neomensural}.
+
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override NoteHead #'style = #'neomensural
+a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
+@end lilypond
+
+Si vous écrivez en notation grégorienne, le
+@internalsref{Gregorian_ligature_engraver} se chargera de sélectionner
+les têtes de note appropriées ; il est donc inutile de spécifier le
+style à utiliser.  Vous pouvez cependant spécifier par exemple le style
+@code{vaticana_punctum} pour obtenir des neumes punctums.  De même,
+c'est le @internalsref{Mensural_ligature_engraver} qui se chargera des
+ligatures mensurales.  Consultez la section @ref{Ligatures} pour savoir
+comment fonctionnent les graveurs de ligature.
+
+@seealso
+
+Pour un aperçu de toutes les possibilités,
+consultez @ref{Note head styles}.
+
+
+@node Ancient accidentals
+@unnumberedsubsubsec Ancient accidentals
+
+@cindex altérations
+
+
+Pour utiliser les formes anciennes d'altération, utilisez la propriété
+@code{glyph-name-alist} des objets graphiques @internalsref{Accidental}
+et @internalsref{KeySignature}.
+
+@lilypond[quote,ragged-right,staffsize=26]
+\score {
+{
+  \fatText
+  s^\markup {
+    \column {
+      "vaticana"
+      \line { " " \musicglyph #"accidentals.vaticana-1"
+        " " \musicglyph #"accidentals.vaticana0" }
+    }
+    \column {
+      "medicaea"
+      \line { " " \musicglyph #"accidentals.medicaea-1" }
+    }
+    \column {
+      "hufnagel"
+      \line { " " \musicglyph #"accidentals.hufnagel-1" }
+    }
+    \column {
+      "mensural"
+      \line { " " \musicglyph #"accidentals.mensural-1"
+        " " \musicglyph #"accidentals.mensural1" }
+    }
+  }
+}
+\layout {
+  interscoreline = 1
+  \context { \Score \remove "Bar_number_engraver" }
+  \context { \Staff
+      \remove "Clef_engraver"
+      \remove "Key_engraver"
+      \remove "Time_signature_engraver"
+      \remove "Staff_symbol_engraver"
+      \override VerticalAxisGroup #'minimum-Y-extent = ##f
+    }
+  }
+}
+@end lilypond
+
+Vous noterez que chacun de ces styles ne comporte pas toutes les
+altérations.  LilyPond changera de style s'il y a besoin d'une
+altération indisponible dans le style utilisé, comme vous pouvez le
+constater dans @lsr{ancient,ancient-accidentals.ly}.
+
+À l'instar des altérations accidentelles, le style d'armure est géré
+par la propriété @code{glyph-name-alist} de l'objet
+@internalsref{KeySignature}. 
+
+@seealso
+
+Dans ce manuel : @ref{Pitches}, @ref{Cautionary accidentals}, et
+@ref{Automatic accidentals}, pour les principes généraux d'utilisation
+des altérations ; @ref{Key signature} pour les armures.
+
+Référence du programme : @internalsref{KeySignature}.
+
+Exemples : @lsrdir{ancient}
+
+
+@node Ancient rests
+@unnumberedsubsubsec Ancient rests
+
+@cindex silences, musique ancienne
+
+La propriété @code{style} de l'objet @internalsref{Rest} permet
+d'obtenir des silences de type ancien.  Vous disposez des styles
+@code{classical}, @code{neomensural} et @code{mensural}.  Le style
+@code{classical} ne se distingue du style @code{default} que par le
+soupir (demi-soupir en miroir). Le style @code{neomensural} convient
+tout à fait à l'incipit lors de la transcription de musique mensurale.
+Le style @code{mensural}, enfin, imite la gravure des silences dans
+certaines éditions du XVIe siècle.
+
+L'exemple suivant illustre le style @code{neomensural}.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override Rest #'style = #'neomensural
+r\longa r\breve r1 r2 r4 r8 r16
+@end lilypond
+
+Les styles @code{mensural} et @code{neomensural} ne disposent pas des 8e
+et 16e de soupir ; LilyPond utilise dans de tels cas le style par
+défaut.  @lsr{pitches,rests} donne une liste exhaustive des silences.
+
+Les silences sont absents de la notation grégorienne ; par contre, cette
+notation utilise des @ref{Divisiones}.
+
+@seealso
+
+Dans ce manuel : @ref{Rests} expose les principes généraux sur
+l'utilisation des silences.
+
+
+@node Ancient clefs
+@unnumberedsubsubsec Ancient clefs
+
+@cindex clefs
+@cindex clés
+
+Avec LilyPond, de nombreuses clés sont disponibles, dont certaines sont
+dédiées à la musique ancienne.
+
+Le tableau suivant présente les différentes clés anciennes que vous
+pouvez sélectionner avec la commande @code{\clef}.  Certaines de ces
+clés utilisent le même glyphe, attaché à l'une ou l'autre des lignes
+de la portée.  Le chiffre porté en suffixe permet alors de les
+différencier.  Vous pouvez néanmoins forcer le positionnement du
+glyphe sur une ligne, comme expliqué à la section @ref{Clef}.  Dans la
+colonne exemple, la note suivant la clé montre le do médium.
+
+@multitable @columnfractions .4 .4 .2
+@item
+@b{Description}
+@tab
+@b{Clé disponible}
+@tab
+@b{Exemple}
+
+@item
+Clé d'ut, style mensural moderne
+@tab
+@code{neomensural-c1}, @code{neomensural-c2},@*
+@code{neomensural-c3}, @code{neomensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "neomensural-c2" c
+@end lilypond
+
+@item
+Clé d'ut, style mensural Petrucci, positionnable sur différentes
+lignes (clé d'ut seconde pour l'exemple)
+@tab
+@code{petrucci-c1}, @code{petrucci-c2},@*
+@code{petrucci-c3}, @code{petrucci-c4},@*
+@code{petrucci-c5}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé de fa, style mensural Petrucci
+@tab
+@code{petrucci-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé de sol, style mensural Petrucci
+@tab
+@code{petrucci-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé d'ut, style mensural historique
+@tab
+@code{mensural-c1}, @code{mensural-c2},@*
+@code{mensural-c3}, @code{mensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé de fa, style mensural historique
+@tab
+@code{mensural-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé de sol, style mensural historique
+@tab
+@code{mensural-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Clé d'ut, style Editio Vaticana
+@tab
+@code{vaticana-do1}, @code{vaticana-do2},@*
+@code{vaticana-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-do2"
+  c
+@end lilypond
+
+@item
+Clé de fa, style Editio Vaticana
+@tab
+@code{vaticana-fa1}, @code{vaticana-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-fa2"
+  c
+@end lilypond
+
+@item
+Clé d'ut, style Editio Medicaea
+@tab
+@code{medicaea-do1}, @code{medicaea-do2},@*
+@code{medicaea-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-do2"
+  c
+@end lilypond
+
+@item
+Clé de fa, style Editio Medicaea
+@tab
+@code{medicaea-fa1}, @code{medicaea-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-fa2"
+  c
+@end lilypond
+
+@item
+Clé d'ut, style historique Hufnagel
+@tab
+@code{hufnagel-do1}, @code{hufnagel-do2},@*
+@code{hufnagel-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do2"
+  c
+@end lilypond
+
+@item
+Clé de fa, style historique Hufnagel
+@tab
+@code{hufnagel-fa1}, @code{hufnagel-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-fa2"
+  c
+@end lilypond
+
+@item
+Clé combinée ut/fa, style historique Hufnagel
+@tab
+@code{hufnagel-do-fa}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do-fa"
+  c
+@end lilypond
+@end multitable
+
+
+
+@emph{Moderne} signifie @qq{gravé comme dans les transcriptions
+contemporaines de musique mesurée.}
+
+@emph{Petrucci} signifie @qq{inspiré des éditions réalisées par le
+maître graveur Petrucci (1466-1539).}
+
+@emph{Historique} signifie @qq{gravé comme dans les éditions
+historiques, manuscrites ou non, autres que celles de Petrucci.}
+
+@emph{Editio XXX} signifie @qq{gravé comme dans les ouvrages estampillés
+Editio XXX.}
+
+Les clés d'ut de Petrucci avaient une hampe gauche différente selon
+leur ligne de rattachement.
+
+@seealso
+
+Dans ce manuel : voir @ref{Clef}.
+
+@refbugs
+
+La clé de sol mensurale est calquée sur celle de Petrucci.
+
+
+
+@node Ancient flags
+@unnumberedsubsubsec Ancient flags
+
+@cindex crochets
+
+Le réglage de la propriété @code{flag-style} de l'objet hampe
+(@internalsref{Stem}) donne accès aux crochets de style ancien.  Les
+seuls styles actuellement pris en charge sont @code{default} et
+@code{mensural}.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\override Stem #'flag-style = #'mensural
+\override Stem #'thickness = #1.0
+\override NoteHead #'style = #'mensural
+\autoBeamOff
+c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
+c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
+@end lilypond
+
+Notez que pour chaque crochet mensural, l'extrémité la plus proche de
+la tête de note sera toujours attachée à une ligne de la portée.
+
+Il n'existe pas de crochet spécifique au style néo-mensural.  Nous vous
+conseillons donc, lorsque vous réalisez l'incipit d'une transcription,
+d'utiliser le style par défaut.  Les crochets n'existent pas en notation
+grégorienne.
+
+@refbugs
+
+Les crochets anciens s'attachent aux hampes avec un léger décalage,
+suite à des modifications intervenues au début de la série 2.3.
+
+L'alignement vertical des crochets par rapport aux lignes de la portée
+sous-entend que les hampes se terminent toujours soit sur une ligne,
+soit à l'exact milieu d'un interligne.  Ceci n'est pas toujours
+réalisable, surtout si vous faites appel à des fonctionnalités avancées
+de présentation de la notation classique, qui, par définition, ne sont
+pas prévues pour être appliquées à la notation mensurale.
+
+
+@node Ancient time signatures
+@unnumberedsubsubsec Ancient time signatures
+
+@cindex métrique
+
+Les chiffrages de métrique mensurale sont partiellement pris en charge.
+Les glyphes ne font que représenter des métriques particulières.  En
+d'autres termes, pour obtenir le glyphe correspondant à une métrique
+mensurale particulière à l'aide de la commande @code{\time n/m}, vous
+devez choisir la paire @code{(n,m)} parmi les valeurs suivantes :
+
+@lilypond[quote,ragged-right]
+\layout {
+  indent = 0.0
+  \context {
+    \Staff
+    \remove Staff_symbol_engraver
+    \remove Clef_engraver
+    \remove Time_signature_engraver
+  }
+}
+{
+  \set Score.timing = ##f
+  \set Score.barAlways = ##t
+  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural44" }
+  s
+  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural22" }
+  s
+  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural64" }
+  s
+  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural68" }
+  \break
+  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural32" }
+  s
+  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural34" }
+  s
+  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural94" }
+  s
+  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural98" }
+  \break
+  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural48" }
+  s
+  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural24" }
+}
+@end lilypond
+
+La propriété @code{style} de l'objet @internalsref{TimeSignature} permet
+d'accéder aux indicateurs de métrique anciens.  Les styles
+@code{neomensural} et @code{mensural} sont disponibles.  Vous avez vu
+ci-dessus le style @code{neomensural}, particulièrement utilisé pour
+l'incipit des transcriptions.  Le style @code{mensural} imite l'aspect
+de certaines éditions du XVIe siècle.
+
+Voici les différences entre les styles :
+
+@lilypond[ragged-right,fragment,relative=1,quote]
+{
+  \fatText
+
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter default }
+
+  \override Staff.TimeSignature #'style = #'numbered
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter numbered }
+
+  \override Staff.TimeSignature #'style = #'mensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter mensural }
+
+  \override Staff.TimeSignature #'style = #'neomensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter neomensural }
+  \override Staff.TimeSignature #'style = #'single-digit
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter single-digit }
+}
+@end lilypond
+
+@seealso
+
+Dans ce manuel : @ref{Time signature} expose les principes généraux sur
+l'utilisation des indications de métrique.
+
+@refbugs
+
+Les équivalences de durées de note ne sont pas modifiées par un
+changement de métrique.  Par exemple, l'équivalence 1 brève pour 3
+semi-brèves (tempus perfectum) doit s'effectuer à la main en entrant :
+
+@example
+breveTP = #(ly:make-duration -1 0 3 2)
+@dots{}
+@{ c\breveTP f1 @}
+@end example
+
+@noindent
+Ce qui définira @code{breveTP} à 3/2 fois 2 = 3 fois une ronde.
+
+Le symbole @code{old6/8alt} --- symbole alternatif pour la métrique 6/8
+--- ne peut être utilisé grâce à une commande @code{\time}.  Utilisez
+plutôt un @code{\markup}.
+
+
+@node Ancient articulations
+@unnumberedsubsubsec Ancient articulations
+
+@cindex articulations
+
+En plus des signes d'articulation standards décrits à la section
+@ref{Articulations}, LilyPond fournit des articulations pour la musique
+ancienne.  Elles sont spécifiquement destinées au style Editio Vaticana.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \override TextScript #'font-family = #'typewriter
+    \override TextScript #'font-shape = #'upright
+    \override Script #'padding = #-0.1
+    a\ictus_"ictus" \break
+    a\circulus_"circulus" \break
+    a\semicirculus_"semicirculus" \break
+    a\accentus_"accentus" \break
+    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
+  }
+}
+@end lilypond
+
+@refbugs
+
+Certaines articulations sont verticalement trop proches de leurs têtes
+de note.
+
+Le trait d'un episem n'est bien souvent pas apparent et, lorsqu'il
+l'est, son extension à droite est trop longue.
+
+@node Custodes
+@unnumberedsubsubsec Custodes
+
+@cindex custos
+@cindex custodes
+@cindex guidon
+
+Un guidon --- @emph{custos}, pluriel @emph{custodes} en latin --- est un
+symbole qui apparaît à la fin d'une portée.  Il montre la hauteur de la
+ou des premières notes de la portée suivante, donnant une indication
+judicieuse à l'exécutant.
+
+Les guidons étaient couramment utilisés jusqu'au XVIIe siècle.  De nos
+jours, on les retrouve uniquement dans quelques formes particulières de
+notation telles que les éditions contemporaines de chant grégorien comme
+les @emph{editio vaticana}.  Différents glyphes existent selon le style
+de notation.
+
+L'impression de guidons s'obtient en affectant, dans un bloc
+@code{\layout}, le @internalsref{Custos_engraver} au contexte
+@code{Staff}, comme le montre l'exemple suivant.
+
+@example
+\layout @{
+  \context @{
+    \Staff
+    \consists Custos_engraver
+    Custos \override #'style = #'mensural
+  @}
+@}
+@end example
+
+Le résultat ressemblera à
+
+@lilypond[quote,ragged-right]
+\score {
+{
+  a'1
+  \override Staff.Custos #'style = #'mensural
+  \break
+  g'
+}
+\layout {
+  \context { \Staff \consists Custos_engraver }
+  }
+}
+@end lilypond
+
+Le glyphe du guidon est déterminé par la propriété @code{style}.  Les
+styles disponibles sont @code{vaticana}, @code{medicaea},
+@code{hufnagel} et @code{mensural}.  En voici un aperçu :
+
+@lilypond[quote,ragged-right,fragment]
+\new Lyrics \lyricmode {
+  \markup { \column {
+    \typewriter "vaticana"
+    \line { " " \musicglyph #"custodes.vaticana.u0" }
+  } }
+  \markup { \column {
+    \typewriter "medicaea"
+    \line { " " \musicglyph #"custodes.medicaea.u0" }
+  }}
+  \markup { \column {
+    \typewriter "hufnagel"
+    \line { " " \musicglyph #"custodes.hufnagel.u0" }
+  }}
+  \markup { \column {
+    \typewriter "mensural"
+    \line { " " \musicglyph #"custodes.mensural.u0" }
+  }}
+}
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{Custos}.
+
+Exemples : @lsr{ancient,custodes@/.ly}.
+
+
+@node Divisiones
+@unnumberedsubsubsec Divisiones
+
+@cindex divisio
+@cindex divisiones
+@cindex finalis
+
+Une division --- @emph{divisio}, pluriel @emph{divisiones} en latin ---
+est un symbole ajouté à la portée et utilisé en chant grégorien pour
+séparer les phrases ou parties.  @emph{Divisio minima}, @emph{divisio
+maior} et @emph{divisio maxima} peuvent respectivement s'interpréter
+comme une pauses courte, moyenne ou longue, à l'image des marques de
+respiration --- cf. @ref{Breath marks}.  Le signe @emph{finalis} n'est
+pas uniquement une marque de fin de chant ; il sert aussi à indiquer la
+fin de chaque partie dans une structure verset/répons.
+
+Les divisions sont disponibles après inclusion du fichier
+@file{gregorian@/-init@/.ly}.  Ce fichier définit les commandes
+@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima} et
+@code{\finalis}.  Certaines éditions utilisent @emph{virgula} ou
+@emph{caesura} en lieu et place de @emph{divisio minima} ; c'est
+pourquoi @file{gregorian@/-init@/.ly} définit aussi @code{\virgula} et
+@code{\caesura}.
+
+@lilypondfile[quote,ragged-right]{divisiones.ly}
+
+@refcommands
+
+@funindex \virgula
+@code{\virgula},
+@funindex \caesura
+@code{\caesura},
+@funindex \divisioMinima
+@code{\divisioMinima},
+@funindex \divisioMaior
+@code{\divisioMaior},
+@funindex \divisioMaxima
+@code{\divisioMaxima},
+@funindex \finalis
+@code{\finalis}.
+
+@seealso
+
+Dans ce manuel : @ref{Breath marks}.
+
+Référence du programme : @internalsref{BreathingSign}.
+
+Exemples : @lsr{expressive,breathing-sign.ly}.
+
+
+@node Ligatures
+@unnumberedsubsubsec Ligatures
+
+@cindex Ligatures
+
+@c TODO: Should double check if I recalled things correctly when I wrote
+@c down the following paragraph by heart.
+
+Une ligature est un symbole graphique qui représente un groupe d'au
+moins deux notes.  Les ligatures ont commencé à apparaître dans les
+manuscrits de chant grégorien, pour indiquer des suites ascendantes ou
+descendantes de notes.
+
+Les ligatures s'indiquent par une inclusion entre @code{\[} et 
+@code{\]}.  Certains styles de ligature peuvent demander un complément
+de syntaxe spécifique.  Par défaut, le graveur
+@internalsref{LigatureBracket} place un simple crochet au dessus de
+la ligature :
+
+@lilypond[quote,ragged-right,verbatim]
+\transpose c c' {
+  \[ g c a f d' \]
+  a g f
+  \[ e f a g \]
+}
+@end lilypond
+
+Selon le style de ligature désiré, il faut ajouter au contexte
+@internalsref{Voice} le graveur de ligature approprié, comme nous le
+verrons plus loin.  Seules sont disponibles les ligatures mensurales
+blanches, avec quelques limitations.
+
+
+@refbugs
+
+La gestion de l'espacement spécifique aux ligatures n'est à ce jour
+pas implémentée.  En conséquence, les ligatures sont trop espacées les
+unes des autres et les sauts de ligne mal ajustés. De plus, les
+paroles ne s'alignent pas de manière satisfaisante en présence de ligatures.
+
+Les altérations ne pouvant être imprimées à l'intérieur d'une
+ligature, il faut les rassembler et les imprimer juste avant.
+
+La syntaxe utilisée correspond à l'ancienne convention de préfixage
+@code{\[ expr. musicale\]}.  Pour des raisons d'uniformité, nous
+opterons probablement pour le style en suffixe (postfix)  @code{note\[
+... note\]}. 
+En attendant, vous pouvez inclure le fichier
+@file{gregorian@/-init@/.ly}, qui fournit une fonction Scheme 
+@example
+\ligature @var{expr. musicale}
+@end example
+qui produit le même résultat, et dont la pérennité est assurée.
+
+@menu
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+@end menu
+
+@node White mensural ligatures
+@unnumberedsubsubsec White mensural ligatures
+
+@cindex Ligatures mensurales
+@cindex Ligatures mensurales blanches
+
+Les ligatures mensurales blanches sont prises en charge, avec des
+limitations.
+
+La gravure des ligatures mensurales blanches s'obtient après avoir
+ajouté le @internalsref{Mensural_ligature_engraver} et enlevé le
+@internalsref{Ligature_bracket_engraver} dans le contexte
+@internalsref{Voice}, comme ici :
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \remove Ligature_bracket_engraver
+    \consists Mensural_ligature_engraver
+  @}
+@}
+@end example
+
+Lorsque le code ci-dessus est employé, l'aspect d'une ligature mensurale
+blanche est déterminé à partir des hauteurs et durées des notes qui la
+composent.  Bien que cela demande un temps d'adaptation au nouvel
+utilisateur, cette méthode offre l'avantage que toute l'information
+musicale incluse dans la ligature est connue en interne.  Ceci est non
+seulement important pour le rendu MIDI, mais aussi pour des questions de
+transcription automatisée d'une ligature.
+
+Par exemple,
+
+@example
+\set Score.timing = ##f
+\set Score.defaultBarType = "empty"
+\override NoteHead #'style = #'neomensural
+\override Staff.TimeSignature #'style = #'neomensural
+\clef "petrucci-g"
+\[ c'\maxima g \]
+\[ d\longa c\breve f e d \]
+\[ c'\maxima d'\longa \]
+\[ e'1 a g\breve \]
+@end example
+@lilypond[quote,ragged-right]
+\score {
+  \transpose c c' {
+    \set Score.timing = ##f
+    \set Score.defaultBarType = "empty"
+    \override NoteHead #'style = #'neomensural
+    \override Staff.TimeSignature #'style = #'neomensural
+    \clef "petrucci-g"
+    \[ c'\maxima g \]
+    \[ d\longa c\breve f e d \]
+    \[ c'\maxima d'\longa \]
+    \[ e'1 a g\breve \]
+  }
+  \layout {
+    \context {
+      \Voice
+      \remove Ligature_bracket_engraver
+      \consists Mensural_ligature_engraver
+    }
+  }
+}
+@end lilypond
+
+Si on ne remplace pas le @internalsref{Ligature_bracket_engraver}
+par le @internalsref{Mensural_ligature_engraver}, on obtient
+
+@lilypond[quote,ragged-right]
+\transpose c c' {
+  \set Score.timing = ##f
+  \set Score.defaultBarType = "empty"
+  \override NoteHead #'style = #'neomensural
+  \override Staff.TimeSignature #'style = #'neomensural
+  \clef "petrucci-g"
+  \[ c'\maxima g \]
+  \[ d\longa c\breve f e d \]
+  \[ c'\maxima d'\longa \]
+  \[ e'1 a g\breve \]
+}
+@end lilypond
+
+@refbugs
+
+L'espacement horizontal n'est pas des meilleurs.
+
+
+@node Gregorian square neumes ligatures
+@unnumberedsubsubsec Gregorian square neumes ligatures
+
+@cindex neumes carrés et ligatures
+@cindex grégorien, ligatures de neumes carrés
+
+Les neumes grégoriens conformément au style des Editio Vaticana sont
+pris en charge de façon assez limitée.  Les ligatures élémentaires sont
+déjà disponibles, mais beaucoup de règles typographiques ne sont pas
+encore implémentées, notamment l'espacement horizontal des enchaînements
+de ligatures, l'alignement des paroles ou une gestion convenable des
+altérations.
+
+Le tableau ci-dessous inventorie les différents neumes contenus dans
+le second tome de l'Antiphonale Romanum (@emph{Liber Hymnarius}) publié
+par l'abbaye de Solesmes en 1983.
+
+@multitable @columnfractions .4 .2 .2 .2
+
+@item
+@b{Neuma aut@*
+Neumarum Elementa}
+@tab
+@b{Figurae@*
+Rectae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Auctae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Deminutae}
+
+@c TODO: \layout block is identical in all of the below examples.
+@c Therefore, it should somehow be included rather than duplicated all
+@c the time. --jr
+
+@c why not make identifiers in ly/engraver-init.ly? --hwn
+
+@c Because it's just used to typeset plain notes without
+@c a staff for demonstration purposes rather than something
+@c special of Gregorian chant notation. --jr
+
+@item
+@code{1. Punctum}
+@tab
+@lilypond[staffsize=26,line-width=1.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum
+    \[ b \]
+    \noBreak s^\markup {"a"} \noBreak
+
+    % Punctum Inclinatum
+    \[ \inclinatum b \]
+    \noBreak s^\markup {"b"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Auctum Ascendens
+    \[ \auctum \ascendens b \]
+    \noBreak s^\markup {"c"} \noBreak
+
+    % Punctum Auctum Descendens
+    \[ \auctum \descendens b \]
+    \noBreak s^\markup {"d"} \noBreak
+
+    % Punctum Inclinatum Auctum
+    \[ \inclinatum \auctum b \]
+    \noBreak s^\markup {"e"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Inclinatum Parvum
+    \[ \inclinatum \deminutum b \]
+    \noBreak s^\markup {"f"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{2. Virga}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Virga
+    \[ \virga b \]
+    \noBreak s^\markup {"g"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{3. Apostropha vel Stropha}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha
+    \[ \stropha b \]
+    \noBreak s^\markup {"h"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha Aucta
+    \[ \stropha \auctum b \]
+    \noBreak s^\markup {"i"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{4. Oriscus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Oriscus
+    \[ \oriscus b \]
+    \noBreak s^\markup {"j"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{5. Clivis vel Flexa}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis vel Flexa
+    \[ b \flexa g \]
+    s^\markup {"k"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis Aucta Descendens
+    \[ b \flexa \auctum \descendens g \]
+    \noBreak s^\markup {"l"} \noBreak
+
+    % Clivis Aucta Ascendens
+    \[ b \flexa \auctum \ascendens g \]
+    \noBreak s^\markup {"m"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Cephalicus
+    \[ b \flexa \deminutum g \]
+    s^\markup {"n"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{6. Podatus vel Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Podatus vel Pes
+    \[ g \pes b \]
+    s^\markup {"o"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens
+    \[ g \pes \auctum \descendens b \]
+    \noBreak s^\markup {"p"} \noBreak
+
+    % Pes Auctus Ascendens
+    \[ g \pes \auctum \ascendens b \]
+    \noBreak s^\markup {"q"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Epiphonus
+    \[ g \pes \deminutum b \]
+    s^\markup {"r"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{7. Pes Quassus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus
+    \[ \oriscus g \pes \virga b \]
+    s^\markup {"s"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus Auctus Descendens
+    \[ \oriscus g \pes \auctum \descendens b \]
+    s^\markup {"t"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{8. Quilisma Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes
+    \[ \quilisma g \pes b \]
+    s^\markup {"u"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes Auctus Descendens
+    \[ \quilisma g \pes \auctum \descendens b \]
+    s^\markup {"v"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{9. Podatus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Initio Debilis
+    \[ \deminutum g \pes b \]
+    s^\markup {"w"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens Initio Debilis
+    \[ \deminutum g \pes \auctum \descendens b \]
+    s^\markup {"x"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{10. Torculus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus
+    \[ a \pes b \flexa g \]
+    s^\markup {"y"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens
+    \[ a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"z"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus
+    \[ a \pes b \flexa \deminutum g \]
+    s^\markup {"A"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{11. Torculus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Initio Debilis
+    \[ \deminutum a \pes b \flexa g \]
+    s^\markup {"B"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens Initio Debilis
+    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"C"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus Initio Debilis
+    \[ \deminutum a \pes b \flexa \deminutum g \]
+    s^\markup {"D"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{12. Porrectus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus
+    \[ a \flexa g \pes b \]
+    s^\markup {"E"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Auctus Descendens
+    \[ a \flexa g \pes \auctum \descendens b \]
+    s^\markup {"F"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Deminutus
+    \[ a \flexa g \pes \deminutum b \]
+    s^\markup {"G"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{13. Climacus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus
+    \[ \virga b \inclinatum a \inclinatum g \]
+    s^\markup {"H"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Auctus
+    \[ \virga b \inclinatum a \inclinatum \auctum g \]
+    s^\markup {"I"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Deminutus
+    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
+    s^\markup {"J"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{14. Scandicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus
+    \[ g \pes a \virga b \]
+    s^\markup {"K"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Auctus Descendens
+    \[ g \pes a \pes \auctum \descendens b \]
+    s^\markup {"L"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Deminutus
+    \[ g \pes a \pes \deminutum b \]
+    s^\markup {"M"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{15. Salicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus
+    \[ g \oriscus a \pes \virga b \]
+    s^\markup {"N"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus Auctus Descendens
+    \[ g \oriscus a \pes \auctum \descendens b \]
+    s^\markup {"O"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{16. Trigonus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Trigonus
+    \[ \stropha b \stropha b \stropha a \]
+    s^\markup {"P"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@tab
+
+@end multitable
+
+
+Contrairement à la majorité des autres systèmes de notation neumatique,
+la manière de saisir les neumes n'a rien à voir avec leur apparence
+typographique ; elle se concentre plutôt sur le sens musical.  Ainsi,
+@code{\[ a \pes b \flexa g \]} produit un @emph{torculus} constitué de
+trois @emph{punctums}, alors que @code{\[ a \flexa g \pes b \]} produit
+un @emph{porrectus} avec une flexe incurvée et un seul @emph{punctum}.
+Il n'existe pas de commande à proprement parler qui permette de
+spécifier la courbe d'une flexe ; c'est la source musicale qui va le
+déterminer.  Le fondement d'une telle approche réside dans la
+distinction que nous faisons entre les aspects musicaux de la source et
+le style de notation que nous voulons obtenir.  De ce fait, la même
+source pourra être utilisée pour imprimer dans un autre style de
+notation grégorienne.
+
+Le tableau suivant présente les fragments de code qui ont permis de
+générer les neumes ligaturés du tableau précédent.  Les lettres de la
+première colonne renvoient aux ligatures ci-dessus.  La seconde
+colonne énumère le nom des ligatures, et la troisième le code ayant
+permis de les générer, se basant ici sur sol, la, si.
+
+@multitable @columnfractions .02 .31 .67
+@item
+@b{#}
+@tab
+@b{Nom}
+@tab
+@b{Code source}
+
+@item
+a
+@tab
+Punctum
+@tab
+@code{\[ b \]}
+
+@item
+b
+@tab
+Punctum Inclinatum
+@tab
+@code{\[ \inclinatum b \]}
+
+@item
+c
+@tab
+Punctum Auctum@*
+Ascendens
+@tab
+@code{\[ \auctum \ascendens b \]}
+
+@item
+d
+@tab
+Punctum Auctum@*
+Descendens
+@tab
+@code{\[ \auctum \descendens b \]}
+
+@item
+e
+@tab
+Punctum Inclinatum@*
+Auctum
+@tab
+@code{\[ \inclinatum \auctum b \]}
+
+@item
+f
+@tab
+Punctum Inclinatum@*
+Parvum @tab
+@code{\[ \inclinatum \deminutum b \]}
+
+@item
+g
+@tab
+Virga
+@tab
+@code{\[ \virga b \]}
+
+@item
+h
+@tab
+Stropha
+@tab
+@code{\[ \stropha b \]}
+
+@item
+i
+@tab
+Stropha Aucta
+@tab
+@code{\[ \stropha \auctum b \]}
+
+@item
+j
+@tab
+Oriscus
+@tab
+@code{\[ \oriscus b \]}
+
+@item
+k
+@tab
+Clivis vel Flexa
+@tab
+@code{\[ b \flexa g \]}
+
+@item
+l
+@tab
+Clivis Aucta@*
+Descendens
+@tab
+@code{\[ b \flexa \auctum \descendens g \]}
+
+@item
+m
+@tab
+Clivis Aucta@*
+Ascendens
+@tab
+@code{\[ b \flexa \auctum \ascendens g \]}
+
+@item
+n
+@tab
+Cephalicus
+@tab
+@code{\[ b \flexa \deminutum g \]}
+
+@item
+o
+@tab
+Podatus vel Pes
+@tab
+@code{\[ g \pes b \]}
+
+@item
+p
+@tab
+Pes Auctus@*
+Descendens
+@tab
+@code{\[ g \pes \auctum \descendens b \]}
+
+@item
+q
+@tab
+Pes Auctus@*
+Ascendens
+@tab
+@code{\[ g \pes \auctum \ascendens b \]}
+
+@item
+r
+@tab
+Epiphonus
+@tab
+@code{\[ g \pes \deminutum b \]}
+
+@item
+s
+@tab
+Pes Quassus
+@tab
+@code{\[ \oriscus g \pes \virga b \]}
+
+@item
+t
+@tab
+Pes Quassus@*
+Auctus Descendens @tab
+@code{\[ \oriscus g \pes \auctum \descendens b \]}
+
+@item
+u
+@tab
+Quilisma Pes
+@tab
+@code{\[ \quilisma g \pes b \]}
+
+@item
+v
+@tab
+Quilisma Pes@*
+Auctus Descendens
+@tab
+@code{\[ \quilisma g \pes \auctum \descendens b \]}
+
+@item
+w
+@tab
+Pes Initio Debilis
+@tab
+@code{\[ \deminutum g \pes b \]}
+
+@item
+x
+@tab
+Pes Auctus Descendens@*
+Initio Debilis
+@tab
+@code{\[ \deminutum g \pes \auctum \descendens b \]}
+
+@item
+y
+@tab
+Torculus
+@tab
+@code{\[ a \pes b \flexa g \]}
+
+@item
+z
+@tab
+Torculus Auctus@*
+Descendens
+@tab
+@code{\[ a \pes b \flexa \auctum \descendens g \]}
+
+@item
+A
+@tab
+Torculus Deminutus
+@tab
+@code{\[ a \pes b \flexa \deminutum g \]}
+
+@item
+B
+@tab
+Torculus Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa g \]}
+
+@item
+C
+@tab
+Torculus Auctus@*
+Descendens Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
+
+@item
+D
+@tab
+Torculus Deminutus@*
+Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
+
+@item
+E
+@tab
+Porrectus
+@tab
+@code{\[ a \flexa g \pes b \]}
+
+@item
+F
+@tab
+Porrectus Auctus@*
+Descendens
+@tab
+@code{\[ a \flexa g \pes \auctum \descendens b \]}
+
+@item
+G
+@tab
+Porrectus Deminutus
+@tab
+@code{\[ a \flexa g \pes \deminutum b \]}
+
+@item
+H
+@tab
+Climacus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum g \]}
+
+@item
+I
+@tab
+Climacus Auctus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
+
+@item
+J
+@tab
+Climacus Deminutus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
+
+@item
+K
+@tab
+Scandicus
+@tab
+@code{\[ g \pes a \virga b \]}
+
+@item
+L
+@tab
+Scandicus Auctus@*
+Descendens
+@tab
+@code{\[ g \pes a \pes \auctum \descendens b \]}
+
+@item
+M
+@tab
+Scandicus Deminutus
+@tab
+@code{\[ g \pes a \pes \deminutum b \]}
+
+@item
+N
+@tab
+Salicus
+@tab
+@code{\[ g \oriscus a \pes \virga b \]}
+
+@item
+O
+@tab
+Salicus Auctus Descendens
+@tab
+@code{\[ g \oriscus a \pes \auctum \descendens b \]}
+
+@item
+P
+@tab
+Trigonus
+@tab
+@code{\[ \stropha b \stropha b \stropha a \]}
+@end multitable
+
+Les ligatures que nous venons de voir, bien que rudimentaires, donnent
+un aperçu des possibilités de former des ligatures grégoriennes.  En
+théorie, vous pouvez inclure entre les délimiteurs @code{\[} et
+@code{\]}, autant de sons que nécessaires à la ligature, ainsi que de
+préfixes tels que @code{\pes}, @code{\flexa}, @code{\virga},
+@code{\inclinatum}, @dots{} Bien sûr, les règles de construction
+présentées ci-dessus peuvent se combiner, ce qui permet la création
+d'une infinité de ligatures.
+
+Les points d'@emph{augmentum}, ou @emph{morae}, s'obtiennent avec la
+fonction @code{\augmentum}.  Notez que cette fonction @code{\augmentum}
+est implémentée en tant que fonction unaire plutôt que comme un préfixe
+de note.  Par conséquent, @code{\augmentum \virga c} ne donnera rien de
+particulier.  Il faut l'utiliser avec la syntaxe @code{\virga \augmentum
+c} ou @code{\augmentum @{\virga c@}}.  Par ailleurs, l'expression
+@code{\augmentum @{a g@}} constitue une forme abrégée de
+@code{\augmentum a \augmentum g}.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \[ \augmentum a \flexa \augmentum g \]
+    \augmentum g
+  }
+}
+@end lilypond
+
+@refcommands
+
+LilyPond dispose des préfixes suivants :
+
+@funindex \virga
+@code{\virga},
+@funindex \stropha
+@code{\stropha},
+@funindex \inclinatum
+@code{\inclinatum},
+@funindex \auctum
+@code{\auctum},
+@funindex \descendens
+@code{\descendens},
+@funindex \ascendens
+@code{\ascendens},
+@funindex \oriscus
+@code{\oriscus},
+@funindex \quilisma
+@code{\quilisma},
+@funindex \deminutum
+@code{\deminutum},
+@funindex \cavum
+@code{\cavum},
+@funindex \linea
+@code{\linea}.
+
+Les préfixes de note peuvent s'agglutiner, modulo quelques restrictions.
+Par exemple, on peut appliquer un @code{\descendens} ou un
+@code{\ascendens} à une note, mais pas les deux simultanément à une même
+note.
+
+@funindex \pes
+@funindex \flexa
+Deux notes adjacentes peuvent être reliées grâce aux commandes
+@code{\pes} ou @code{\flexa} pour marquer une ligne mélodique
+respectivement ascendante ou descendante.
+
+@funindex \augmentum
+Utilisez la fonction musicale unaire @code{\augmentum} pour ajouter
+des points d'augmentum.
+
+@refbugs
+
+Lorsqu'un @code{\augmentum} apparaît dans une ligature en fin de
+portée, son placement vertical peut être erroné.  Pour y remédier,
+ajoutez un silence invisible, @code{s8} par exemple, comme dernière note de
+cette portée.
+
+L'@code{\augmentum} devrait être implémenté en tant que préfixe plutôt
+qu'en tant que fonction unaire, afin qu'@code{\augmentum} puisse
+s'intégrer avec d'autres préfixes dans n'importe quel ordre.
+
+
+@node Gregorian Chant contexts
+@unnumberedsubsubsec Gregorian Chant contexts
+
+@cindex VaticanaVoiceContext
+@cindex VaticanaStaffContext
+
+Les contextes @code{VaticanaVoiceContext} et
+@code{VaticanaStaffContext} permettent de graver le chant grégorien
+dans le style des éditions vaticanes.  Ces contextes initialisent
+les propriétés de tous les autres contextes et objets graphiques à des
+valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
+lancer dans la saisie de votre chant, comme ci-dessous :
+
+@lilypond[quote,ragged-right,packed,verbatim]
+\include "gregorian-init.ly"
+\score {
+  <<
+    \new VaticanaVoice = "cantus" {
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \]
+      f \divisioMinima
+      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
+      c' \divisioMinima \break
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
+    }
+    \new Lyrics \lyricsto "cantus" {
+      San- ctus, San- ctus, San- ctus
+    }
+  >>
+}
+@end lilypond
+
+
+@node Mensural contexts
+@unnumberedsubsubsec Mensural contexts
+
+@cindex MensuralVoiceContext
+@cindex MensuralStaffContext
+
+Les contextes @code{MensuralVoiceContext} et
+@code{MensuralStaffContext} permettent de graver des chants
+dans le style mesuré.  Ces contextes initialisent
+les propriétés de tous les autres contextes et objets graphiques à des
+valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
+lancer dans la saisie de votre chant comme ci-après :
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new MensuralVoice = "discantus" \transpose c c' {
+      \override Score.BarNumber #'transparent = ##t {
+        c'1\melisma bes a g\melismaEnd
+        f\breve
+        \[ f1\melisma a c'\breve d'\melismaEnd \]
+        c'\longa
+        c'\breve\melisma a1 g1\melismaEnd
+        fis\longa^\signumcongruentiae
+      }
+    }
+    \new Lyrics \lyricsto "discantus" {
+      San -- ctus, San -- ctus, San -- ctus
+    }
+  >>
+}
+@end lilypond
+
+
+@node Musica ficta accidentals
+@unnumberedsubsubsec Musica ficta accidentals
+
+Dans la musique européenne antérieure au XVIIe siècle, les chanteurs
+étaient censés altérer les notes de leur propre initiative.  On appelait
+cela @emph{musica ficta}.  Dans les transcriptions modernes, on a
+l'habitude de placer ces altérations au-dessus de la note concernée.
+
+@cindex altérations, musica ficta
+@cindex musica ficta
+
+De telles altérations suggérées sont disponibles et peuvent être
+activées en assignant à la propriété @code{suggestAccidentals} la valeur
+vrai (@code{#t} pour @q{true}).
+
+@funindex suggestAccidentals
+
+@lilypond[verbatim,fragment,relative=1]
+fis gis
+\set suggestAccidentals = ##t
+ais bis
+@end lilypond
+
+@seealso
+
+Référence du programme : le graveur @internalsref{Accidental_engraver}
+et l'objet @internalsref{AccidentalSuggestion}.
+
+
+@node Figured bass
+@unnumberedsubsubsec Figured bass
+
+@cindex basse continue
+@cindex basse chiffrée
+
+@c TODO: musicological blurb about FB
+@c librement adapté de
+@c http://en.wikipedia.org/wiki/Basso_continuo#Basso_continuo
+Les parties de basse continue étaient très répandues dans la musique
+baroque et jusqu'à la fin du XVIIIe siècle.  Comme son nom
+l'indique, le @emph{continuo} constitue une partie à lui seul, qui
+se déroule tout au long de l'œuvre pour en donner la structure harmonique. 
+
+Les musiciens du @emph{continuo} jouent des claviers (clavecin,
+orgue) ou de tout autre instrument pouvant réaliser des accords.  Leur
+partie est constituée d'une portée de basse aux notes agrémentées de
+combinaisons de chiffres et signes indiquant le développement des
+accords à jouer, ainsi que leur éventuel renversement.  Cette notation
+était avant tout un guide, invitant le musicien à improviser de
+lui-même l'accompagnement.
+
+LilyPond gère la basse chiffrée. 
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+<<
+  \new Voice { \clef bass dis4 c d ais g fis}
+  \new FiguredBass \figuremode {
+    < 6 >4 < 7\+ >8 < 6+ [_!] >
+    < 6 >4 <6 5 [3+] >
+    < _ >4 < 6 5/>4
+  }
+>>
+@end lilypond
+
+La gestion de la basse chiffrée se décompose en deux parties.  Dans un
+premier temps, le mode @code{\figuremode} permet de saisir les accords
+sous forme chiffrée.  Le contexte @internalsref{FiguredBass} s'occupera
+ensuite de gérer les objets @internalsref{BassFigure}.
+
+En mode de saisie, un chiffrage est délimité par @code{<} et
+@code{>}.  La  durée est indiquée après le @code{>} :
+
+@example
+<4 6>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { <4 6> }
+@end lilypond
+
+Les altérations s'obtiennent en ajoutant aux chiffres les caractères
+@code{-}, @code{!} ou @code{+}. Un signe plus s'obtient grâce à
+@code{\+}, et une quinte ou septième diminuée par @code{5/} ou
+@code{7/} respectivement.
+
+@example
+<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@end lilypond
+
+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
+markup commands}.
+
+@example
+<[4 6] 8 [_! 12] > <5 \markup @{ \number 6 \super (1) @} >
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@end lilypond
+
+
+Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
+prolongation. 
+
+@lilypond[verbatim,relative=1]
+<<
+  \new Staff {
+    \clef bass
+    c4 c c
+  }
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <4 6> <3 6> <3 7>
+  }
+>>
+@end lilypond
+
+@noindent
+En pareil cas, la ligne de prolongation masquera toujours le chiffre
+qu'elle rappelle dans le chiffrage suivant.
+
+Le contexte @code{FiguredBass} ne tient aucun compte de la ligne de
+basse.  Par conséquent, il vous faudra peut être insérer des chiffrages
+supplémentaires pour imprimer les prolongations, ou utiliser des
+@code{\!} pour les éviter, comme dans l'exemple suivant :
+
+@lilypond[relative=1]
+<<
+  \new Voice
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+  }
+  {
+    \clef bass
+    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+  }
+>>
+@end lilypond
+
+Lorsque vous utilisez des lignes de prolongation, les chiffres communs
+seront verticalement alignés.  Pour l'éviter, insérez un silence avec
+@code{r} afin de réinitialiser l'alignement.  Par exemple, saisissez
+
+@example
+  <4 6>8 r8
+@end example
+
+@noindent
+au lieu de
+@example
+  <4 6>4
+@end example
+
+On peut choisir d'impriemr les altérations et signes plus aussi bien
+avant qu'après les chiffres, en réglant les propriétés
+@code{figuredBassAlterationDirection} et
+@code{figuredBassPlusDirection}.
+
+@lilypond
+  \figures {
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassPlusDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #-1
+    <6\+> <5+> <6 4-> r
+  }
+@end lilypond
+
+
+Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
+des accords, elle est beaucoup plus simpliste.  Le mode
+@code{\figuremode} ne fait que stocker des chiffres que le contexte
+@internalsref{FiguredBass} se chargera d'imprimer tels quels.  En
+aucune manière ils ne sont transformés en son, et ils ne sont pas
+rendus dans un fichier MIDI.
+
+En interne, ce code produit des étiquettes de texte que vous
+pouvez formater à votre convenance grâce aux propriétés des
+étiquettes.  Par exemple, l'espacement vertical des chiffrages est
+déterminé par la propriété @code{baseline-skip}.
+
+
+On peut également ajouter une basse chiffrée directement à un contexte
+@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.
+
+@lilypond[ragged-right,fragment,quote]
+<<
+  \new Staff = someUniqueName
+  \relative c'' {
+    c4 c'8 r8 c,4 c'
+  }
+
+  %% send to existing Staff.
+  \context Staff = someUniqueName 
+  \figuremode {
+    <4>4 <6 10>8 s8
+    
+    \set Staff.useBassFigureExtenders = ##t
+    <4 6>4 <4 6>
+  }
+>>
+@end lilypond
+
+
+@commonprop
+
+Par défaut, les chiffres sont imprimés au-dessus de la portée.  Pour les
+imprimer dessous, ajoutez
+
+@example
+\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
+@end example
+
+
+@refbugs
+
+Si vous positionnez la basse chiffrée au dessus de la portée en ayant
+recours aux lignes d'extension et @code{implicitBassFigures}, les lignes
+peuvent se mélanger.  Préserver l'ordre des prolongateurs peut s'avérer
+impossible lorsque plusieurs chiffrages qui se chevauchent en possèdent.
+Ce problème peut être contourné en jouant sur l'empilement, avec la
+propriété @code{stacking-dir} de l'objet @code{BassFigureAlignment}.
+
+
+@seealso
+
+Référence du programme : les objets @internalsref{NewBassFigure},
+@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
+@internalsref{BassFigureBracket} et
+@internalsref{BassFigureContinuation}, ainsi que le contexte
+@internalsref{FiguredBass}.
+
+
diff --git a/Documentation/fr/user/bagpipes.itely b/Documentation/fr/user/bagpipes.itely
new file mode 100644
index 0000000000..51d80c000b
--- /dev/null
+++ b/Documentation/fr/user/bagpipes.itely
@@ -0,0 +1,117 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Bagpipes
+@section Bagpipes
+
+This section includes extra information for writing for bagpipes.
+
+@menu 
+* Bagpipe::
+@end menu
+
+
+@node Bagpipe
+@subsection Bagpipe
+
+@menu 
+* Bagpipe definitions::
+* Bagpipe example::
+@end menu
+
+@node Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+LilyPond inclut des définitions spécifiques destinées à la notation pour
+cornemuse écossaise ; pour les utiliser, il suffit d'ajouter
+
+@example
+\include "bagpipe.ly"
+@end example
+
+@noindent
+en début de fichier.  Ainsi, vous bénéficierez de commandes courtes pour
+les appogiatures spéciales et idiomatiques de la cornemuse.  Par
+exemple, @code{\taor} est un raccourci pour
+
+@example
+\grace @{ \small G32[ d G e] @}
+@end example
+
+@code{bagpipe.ly} prend également en charge les définitions de hauteurs
+pour la cornemuse ; vous n'avez donc pas à vous soucier d'employer
+@code{\relative} ou @code{\transpose}.
+
+@lilypond[ragged-right,verbatim,quote,notime]
+\include "bagpipe.ly"
+{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
+@end lilypond
+
+La musique pour cornemuse est traditionnellement écrite en ré majeur.
+Dans la mesure où c'est la seule tonalité possible, l'usage est de ne
+pas indiquer l'armure explicitement. À cet effet, pensez à commencer
+votre partition par @code{\hideKeySignature} -- ou bien
+@code{\showKeySignature} si, pour une raison ou pour une autre, vous
+tenez à afficher l'armure.
+
+Des compositions actuelles peuvent ne pas respecter cette tonalité
+traditionnelle, auquel cas les do et fa devraient être abaissés en
+utilisant @code{cflat} ou @code{fflat} ; ils seront représenté par une
+note en forme de croix.
+
+Lorsqu'on joue des œuvres moins cérémonieuses que pour une parade
+ou un défilé, peut survenir un sol aigu, au doux nom de
+@qq{piobaireachd}, et que l'on indiquera par @code{gflat}.
+
+
+@node Bagpipe example
+@unnumberedsubsubsec Bagpipe example
+
+Et voici en guise d'exemple, à quoi ressemble le chant populaire
+@emph{Amazing Grace}, noté dans l'idiome de la cornemuse.
+
+@lilypond[verbatim,quote]
+\include "bagpipe.ly"
+\layout {
+  indent = 0.0\cm
+  \context { \Score \remove "Bar_number_engraver" }
+}
+
+\header {
+  title = "Amazing Grace"
+  meter = "Hymn"
+  arranger = "Trad. arr."
+}
+
+{
+  \hideKeySignature
+  \time 3/4
+  \grg \partial 4 a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg e8. f16
+  \dblA A2 \grg A4
+  \grg A2 f8. A16
+  \grg A2 \hdblf f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 e4
+  \thrwd d2.
+  \slurd d2
+  \bar "|."
+}
+@end lilypond
+
+
diff --git a/Documentation/fr/user/basic-notation.itely b/Documentation/fr/user/basic-notation.itely
deleted file mode 100644
index 8ba46f8cfe..0000000000
--- a/Documentation/fr/user/basic-notation.itely
+++ /dev/null
@@ -1,3631 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Basic notation
-@chapter Basic notation
-
-De l'utilisation des fonctions de notation de base.
-
-
-@menu
-* Pitches::
-* Rhythms::
-* Polyphony::
-* Staff notation::
-* Connecting notes::
-* Expressive marks::
-* Repeats::
-@end menu
-
-
-@node Pitches
-@section Pitches
-
-De la manière de spécifier les hauteurs de notes.
-
-@menu
-* Normal pitches::
-* Accidentals::
-* Cautionary accidentals::
-* Micro tones::
-* Note names in other languages::
-* Relative octaves::
-* Octave check::
-* Transpose::
-* Rests::
-* Skips::
-@end menu
-
-
-@node Normal pitches
-@subsection Normal pitches
-
-@cindex noms de note
-@cindex hauteurs
-
-La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
-notation anglaise, en utilisant les lettres @code{a} à @code{g}.
-Une gamme ascendante de do majeur s'écrit
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef bass
-c d e f g a b c'
-@end lilypond
-
-La note @code{c} est écrite une octave sous le do central.
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef treble
-c1
-\clef bass
-c1
-@end lilypond
-
-@funindex '
-@funindex ,
-
-L'octave peut être précisée sous forme d'une série d'apostrophes
-@samp{'} ou d'une série de virgules @samp{,}.  Chaque @samp{'} hausse la
-note d'une octave, chaque @samp{,} baisse la note d'une octave.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\clef treble
-c' c'' e' g d'' d' d c
-\clef bass
-c, c,, e, g d,, d, d c
-@end lilypond
-
-Il existe une autre méthode pour préciser à quelle octave se situe la
-note à graver ; cette méthode demande moins d'indications d'octave
-(@code{'} ou @code{,}) --- voir @ref{Relative octaves}.
-
-
-@node Accidentals
-@subsection Accidentals
-
-@cindex noms de note, hollandais
-@cindex noms de note, par défaut
-
-Dans la notation par défaut, un dièse est formé en ajoutant @code{-is}
-après le nom de note, un bémol en ajoutant @code{-es}.  Les
-double-dièses et double-bémols sont obtenus en ajoutant @code{-isis}
-ou @code{-eses} au nom de note.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
-@end lilypond
-
-@noindent
-Ce sont les noms de note hollandais.  En hollandais, on élide @code{aes}
-pour écrire @code{as}, mais les deux formes sont acceptées.  De manière
-similaire, on accepte aussi bien @code{es} que @code{ees}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
-@end lilypond
-
-Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
-ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
-bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
-donnera une note bécarre.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a4 aes a2
-@end lilypond
-
-LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
-naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
-Pour plus d'information à propos de la distinction entre le contenu
-musical et sa représentation, voir @ref{Accidentals and key signatures}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
-@end lilypond
-
-
-@commonprop
-
-En accord avec les règles standards de l'écriture musicale, on imprime
-un bécarre avant un dièse ou un bémol si on a besoin d'annuler une
-altération précédente.  Pour modifier ce comportement, spécifiez
-@code{\set Staff.extraNatural = ##f}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-ceses4 ces cis c
-\set Staff.extraNatural = ##f
-ceses4 ces cis c
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{LedgerLineSpanner},
-@internalsref{NoteHead}.
-
-
-@node Cautionary accidentals
-@subsection Cautionary accidentals
-
-@cindex altération, de précaution
-@cindex altération, entre parenthèses
-@cindex altération de précaution
-@funindex ?
-@cindex altération entre parenthèses
-@funindex !
-
-Normalement, les altérations sont imprimées automatiquement, mais il se
-peut que vous vouliez les imprimer manuellement.  On peut forcer
-l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
-point d'exclamation @samp{!} après la hauteur de note.  Une altération
-entre parenthèses peut être obtenue en ajoutant un point d'interrogation
-@samp{?} après la hauteur de note.  Ces signes peuvent aussi être
-utilisés pour imprimer des bécarres.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-cis cis cis! cis? c c? c! c
-@end lilypond
-
-
-@seealso
-
-L'impression automatique des altérations peut être affinée de plusieurs
-manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
-
-
-@node Micro tones
-@subsection Micro tones
-
-@cindex quarts de ton
-@cindex demi-bémols, demi-dièses
-
-Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
-@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
-croissantes :
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Les micro-intervalles sont aussi exportés dans le fichier MIDI.
-
-@refbugs
-
-Il n'y a pas de standard universellement accepté pour noter le bémol et
-demi (qui abaisse la hauteur trois quarts de ton), le symbole de
-LilyPond n'est donc conforme à aucun standard.
-
-
-@node Note names in other languages
-@subsection Note names in other languages
-
-Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
-langues.  Pour les utiliser, incluez le fichier d'initialisation
-spécifique à la langue voulue.  Par exemple, pour les langues romanes,
-ajoutez @code{\include "italiano.ly"} au début du fichier source.  Les
-fichiers de langues disponibles ainsi que les noms de notes utilisés
-sont les suivants :
-
-@cindex noms de note, autres langues
-@example
-                       Noms de note              dièse       bémol      double          double
-                                                                        dièse           bémol
-nederlands.ly  c   d   e   f   g   a   bes b   -is         -es          -isis           -eses
-english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat     -ss/-x/         -ff/
-                                                                        -sharpshsarp    -flatflat
-deutsch.ly     c   d   e   f   g   a   b   h   -is         -es          -isis           -eses
-norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es     -ississ/-isis   -essess/-eses
-svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess         -ississ         -essess
-italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b           -dd             -bb
-catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b           -dd/-ss         -bb
-espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b           -ss             -bb
-@end example
-
-@noindent
-Notez qu'en hollandais, en allemand, en norvégien et en suédois, un
-@samp{la} altéré de bemol se note @code{aes} et @code{aeses}.  Ces
-formes sont contractées en @code{as} et @code{ases} (ou plus communément
-@code{asas}).  Dans certains fichiers linguistiques, seules ces formes
-abrégées ont été définies ; ceci s'applique aussi aux suffixes pour les
-quarts de ton.
-
-@noindent
-Certaines musiques utilisent des microtonalités, pour lesquelles les
-altérations sont des fractions de dièse ou bémol @qq{normaux}.  Le
-tableau suivant répertorie les noms de note en quart de ton, tels que
-définis dans plusieurs fichiers linguistiques. Les préfixes @q{semi-} et
-@q{sesqui-} correspondent au @q{demi-} et @q{trois demis}.  À noter
-qu'aucune définition n'existe à ce jour pour le norvégien, le suédois,
-le catalan et l'espagnol.
-
-@c What about Turkish Maquam music and similar microtonal systems?
-@c
-@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
-@c is actually misleading since the alteration is in fact one and a half
-@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
-
-@example
-                        Noms de note           semi-   semi-  sesqui-  sesqui-
-                                               dièse   bémol  dièse    bémol
-
-nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
-english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
-deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
-norsk.ly       c   d   e   f   g   a   b   h   
-svenska.ly     c   d   e   f   g   a   b   h   
-italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
-catalan.ly     do  re  mi  fa  sol la  sib si  
-espanol.ly     do  re  mi  fa  sol la  sib si  
-@end example
-
-
-
-@node Relative octaves
-@subsection Relative octaves
-
-@cindex relatif
-@cindex indication d'octave relative
-@funindex \relative
-
-On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
-hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
-à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
-Le mode d'écriture \relative prévient ces erreurs dans la mesure où
-elles deviennent beaucoup plus évidentes : une seule erreur décale le
-reste de la pièce à une mauvaise octave.
-
-
-@example
-\relative @var{startpitch} @var{musicexpr}
-@end example
-
-@noindent
-ou
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
-définie.
-
-L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
-la manière suivante : si aucun signe de changement d'octave n'est
-utilisé, l'intervalle de base entre la note actuelle et la précédente
-sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
-tenir compte des altérations ; ainsi un @code{fisis} après un
-@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
-une quarte doublement augmentée demeure considérée comme un intervavlle
-plus petit qu'une quinte diminuée, bien que la quarte doublement
-augmentée soit de sept demi-tons et la quinte diminuée de seulement six
-demi-tons.
-
-Les signes de changement d'octave @code{'} et @code{,} peuvent être
-ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
-Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
-départ peut être spécifiée, et agira dès lors comme si elle précédait la
-première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
-spécifiée, le do central sert de point de départ.
-
-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-On utilise les signes de changement d'octave pour les intervalles
-dépassant la quarte.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Si l'expression précédente est un accord, c'est la première note de
-l'accord qui détermine l'emplacement de la première note du prochain
-accord.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-La hauteur après @code{\relative} contient un nom de note.
-
-La conversion en mode \relative n'affectera pas les sections @code{\transpose},
-@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
-utiliser \relative dans de la musique transposée, un code
-@code{\relative} additionnel doit être placé dans @code{\transpose}.
-
-
-@node Octave check
-@subsection Octave check
-
-@cindex vérification d'octave
-
-Les tests d'octave rendent la correction d'erreurs d'octave plus facile
-dans le mode d'octave @code{relative} : une note peut être suivie de
-@code{=}@var{apostrophes/virgules} pour indiquer à quelle octave absolue
-elle devrait être.  Dans l'exemple suivant,
-
-@example
-\relative c'' @{ c='' b=' d,='' @}
-@end example
-
-@noindent
-le @code{d} générera un avertissement, puisqu'on attend un @code{d''}
-mais qu'on obtient un @code{d'} --- il n'y a qu'une tierce entre
-@code{b'} et @code{d''}.  Sur la partition, l'octave sera corrigée pour
-donner un @code{d''} et la prochaine note sera calculée en fonction de
-@code{d''} et non de @code{d'}.
-
-Il existe aussi une vérification d'octave qui ne produit pas de musique
-imprimée, ayant pour syntaxe
-
-@example
-\octave @var{hauteur}
-@end example
-
-Cette commande vérifie que la @var{hauteur} considérée sans apostrophe
-ni virgule et comme hauteur relative, est la même que la @var{hauteur}
-absolue considérée avec ses éventuelles apostrophes ou virgules.  Sinon,
-un avertissement est émis et l'octave est corrigée.  La @var{hauteur}
-n'est pas considérée comme une note, et donc n'est pas imprimée.
-
-Dans l'exemple ci-dessous, le premier test réussit, puisque le @code{e}
---- dans le mode @code{relative} --- est au plus à une quarte de
-@code{a'}.  Cependant, le deuxième test produit un avertissement,
-puisque le @code{e} est à quinte de @code{b'}.  Le message
-d'avertissement est émis, et l'octave est corrigée afin que les notes
-suivantes soient à nouveau à la bonne octave.
-
-@example
-\relative c' @{
-  e
-  \octave a'
-  \octave b'
-@}
-@end example
-
-L'octave d'une note qui suit un test d'octave est déterminée selon la
-note précédente.  Dans l'exemple suivant, la dernière note est un
-@code{a'}, au-dessus du do central.  Cela veut dire que le test
-@code{\octave} réussit, et peut donc être enlevé sans changer le
-résultat sur la partition.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octave b
-  a
-}
-@end lilypond
-
-
-@node Transpose
-@subsection Transpose
-
-@cindex transposition
-@cindex transposition des hauteurs
-@funindex \transpose
-
-Une expression musicale peut être transposée avec @code{\transpose}.
-Voici la syntaxe :
-@example
-\transpose @var{note_de départ} @var{note_d_arrivée} @var{musicexpr}
-@end example
-
-Cela signifie que @var{musicexpr} est transposé d'un intervalle entre
-les notes @var{note_de_départ} et @var{note_d_arrivée} : toute note
-dont la hauteur était @code{note_de_départ}
-est changée en @code{note_d_arrivée}.
-
-Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce est
-un peu trop basse pour l'interprète, elle peut être transposée en mi
-majeur avec
-@example
-\transpose d e @dots{}
-@end example
-
-Regardons maintenant une partie écrite pour violon --- un instrument en
-ut).  Si cette partie doit être jouée par une clarinette en la (écrite à
-la tierce mineure supérieure, un do écrit donnant un la réel), la
-transposition suivante créera la partie appropriée.
-
-@example
-\transpose a c @dots{}
-@end example
-
-@code{\transpose} fait la distinction entre les notes enharmoniques :
-@code{\transpose c cis} et @code{\transpose c des} transposeront la
-pièce un demi-ton plus haut.  Mais la première version écrira des
-dièses et la deuxième des bémols.
-
-@lilypond[quote,ragged-right,verbatim]
-mus = { \key d \major cis d fis g }
-\new Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
-}
-@end lilypond
-
-On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
-pour un instrument transpositeur.  Normalement, les hauteurs dans
-LilyPond sont écrites en ut, i.e. en sons réels, mais elles peuvent être
-écrites dans un autre ton.  Quand, par exemple, on écrit pour une
-trompette en si bémol, commençant sur ré note réelle, on pourrait écrire
-@example
-\transpose c bes @{ e4 @dots{} @}
-@end example
-
-Pour imprimer cette musique en si bémol à nouveau --- et de ce fait
-produire une partie de trompette, au lieu d'un conducteur en notes
-réelles, on utilisera un deuxième @code{transpose}
-
-@example
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
-@end example
-
-
-@seealso
-
-Référence du programme : @internalsref{TransposedMusic}.
-
-Exemple : @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
-
-
-@refbugs
-
-Si vous voulez utiliser en même temps @code{\transpose} et
-@code{\relative}, vous devez mettre @code{\transpose} en dehors de
-@code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
-musique apparaissant dans un @code{\transpose}.
-
-
-@node Rests
-@subsection Rests
-@cindex silences
-
-@funindex \rest
-@funindex r
-
-Les silences sont écrits comme des notes avec le nom de note @code{r}.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-r1 r2 r4 r8
-@end lilypond
-
-Les pauses d'une mesure complète, qui sont placées au centre de la
-mesure, doivent être entrées comme des mesures de silence.  Elles
-peuvent être utilisées pour une seule mesure comme pour plusieurs, et
-leur utilisation est expliquée dans la section
-@ref{Multi measure rests}.
-
-Pour spécifier explicitement la position verticale d'un silence, écrivez
-une note suivie de @code{\rest}.  Un silence sera placé à la position où
-serait imprimée la note.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-a'4\rest d'4\rest
-@end lilypond
-
-@noindent
-Cela rend plus facile la mise en place de la musique polyphonique,
-puisque le formateur automatique de collision des silences laissera ces
-silences tranquilles.
-
-@seealso
-
-Référence du programme : @internalsref{Rest}.
-
-
-@node Skips
-@subsection Skips
-
-@cindex sauts de durée
-@cindex silences invisibles
-@cindex silences d'espacement
-@funindex \skip
-@funindex s
-
-Un silence invisible --- que l'on pourrait appeler un @qq{saut} ---
-peut être entré comme une note avec le nom de note `@samp{s}' ou avec
-@code{\skip @var{durée}}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a4 a4 s4 a4 \skip 1 a4
-@end lilypond
-
-La syntaxe @code{s} est seulement disponible pour les modes d'entrée
-de notes et d'accords.  Dans d'autres situations, pour l'entrée de
-paroles par exemple, vous devrez utiliser la commande @code{\skip}.
-
-@lilypond[quote,ragged-right,verbatim]
-<<
-  \relative { a'2 a2 }
-  \new Lyrics \lyricmode { \skip 2 bla2 }
->>
-@end lilypond
-
-La commande de saut génère simplement une case musicale vide.  Elle ne
-produit rien sur la partition, pas même un symbole transparent.  Le code
-de saut @code{s} crée tout de même une @internalsref{Staff} et une
-@internalsref{Voice} lorsque nécessaire, tout comme les commandes de
-note et de silence.  Ainsi, le code suivant aboutit à une portée vide.
-
-@lilypond[quote,ragged-right,verbatim]
-{ s4 }
-@end lilypond
-
-Le fragment @code{@{ \skip 4 @} } produirait une page vide.
-
-@seealso
-
-Référence du programme : @internalsref{SkipMusic}.
-
-
-
-@node Rhythms
-@section Rhythms
-
-Des rythmes, durées et mesures.
-
-@menu
-* Durations::
-* Augmentation dots::
-* Tuplets::
-* Scaling durations::
-* Bar check::
-* Barnumber check::
-* Automatic note splitting::
-@end menu
-
-
-@node Durations
-@subsection Durations
-
-@cindex durées
-@funindex \longa
-@funindex \breve
-@funindex \maxima
-
-Dans les modes de notes, d'accords et de paroles, les durées sont
-écrites avec des chiffres et des points : les durées sont indiquées par
-leur valeur fractionnaire par rapport à la durée d'une ronde.  Une
-noire, par exemple, qui équivaut à un 1/4 de ronde --- @qq{quarter note}
-en anglais --- s'écrit @code{4}, alors qu'une blanche ---
-@qq{half-note}, 1/2 ronde --- s'écrit @code{2}.  Pour des notes plus
-longues qu'une ronde, vous devrez utiliser les commandes @code{\longa}
-pour une longue, et @code{\breve} pour une brève, aussi appelée carrée.
-
-@example
-c'\breve
-c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
-r\longa r\breve
-r1 r2 r4 r8 r16 r32 r64 r64
-@end example
-
-@lilypond[quote]
-\score {
-\relative c'' {
-    a\breve*1/2 \autoBeamOff
-    a1 a2 a4 a8 a16 a32 a64 a64
-   \bar "empty"
-   \break
-    r\longa*1/4 r\breve *1/2
-    r1 r2 r4 r8 r16 r32 r64 r64
-  }
-  \layout {
-    ragged-right = ##t
-    indent=0\mm
-    \context {
-      \Score
-        \remove "Bar_number_engraver"
-    }
-    \context {
-      \Staff
-        \remove "Clef_engraver"
-        \override StaffSymbol #'transparent = ##t
-        \override TimeSignature #'transparent = ##t
-        \override BarLine #'transparent = ##t
-        \consists "Pitch_squash_engraver"
-    }
-  }
-}
-@end lilypond
-
-Si la durée n'est pas précisée, elle est alors assimilée à la durée
-précédente.  La valeur par défaut pour la première note est une noire
-(4).
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-{ a a a2 a a4 a a1 a }
-@end lilypond
-
-
-@node Augmentation dots
-@subsection Augmentation dots
-
-@funindex .
-
-Pour obtenir des notes pointées, ajoutez simplement un point
-(@samp{.}) au chiffre.  Les notes doublement pointées sont créées de
-la même façon.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-a'4 b' c''4. b'8 a'4. b'4.. c''8.
-@end lilypond
-
-@refcommands
-
-Les points sont normalement haussés pour éviter les lignes de portées,
-sauf dans certaines polyphonies.  Les commandes suivantes peuvent être
-utilisées pour demander manuellement une orientation particulière des
-points.
-
-@funindex \dotsUp
-@code{\dotsUp},
-@funindex \dotsDown
-@code{\dotsDown},
-@funindex \dotsNeutral
-@code{\dotsNeutral}.
-
-@seealso
-
-Référence du programme : @internalsref{Dots}, @internalsref{DotColumn}.
-
-
-@node Tuplets
-@subsection Tuplets
-
-@cindex nolets
-@cindex triolets
-@funindex \times
-
-Les nolets --- triolets, quintolets, etc. --- sont obtenus en
-multipliant toutes les durées d'une expression musicale par une
-fraction.
-
-@example
-\times @var{fraction} @var{expr_musique}
-@end example
-
-@noindent
-La durée de @var{expr_musique} sera multipliée par la fraction.  Le
-dénominateur de la fraction sera imprimé au-dessus des notes, parfois
-avec un crochet.  Le nolet le plus courant est le triolet, dans lequel 3
-notes ont la durée de 2, et où les notes durent donc 2/3 de leur valeur
-écrite.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-g'4 \times 2/3 {c'4 c' c'} d'4 d'4
-@end lilypond
-
-Les nolets peuvent être imbriqués ; par exemple,
-
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\override TupletNumber #'text = #tuplet-number::calc-fraction-text
-\times 4/6 {
-  a4 a
-  \times 3/5 { a a a a a }
-}
-@end lilypond
-
-@refcommands
-
-@funindex \tupletUp
-@code{\tupletUp},
-@funindex \tupletDown
-@code{\tupletDown},
-@funindex \tupletNeutral
-@code{\tupletNeutral}.
-
-
-@commonprop
-
-@funindex tupletNumberFormatFunction
-@cindex nolets, formatage
-
-La propriété @code{tupletSpannerDuration} spécifie la longueur voulue de
-chaque crochet.  Avec elle, vous pouvez faire plusieurs nolets en ne
-tapant @code{\times} qu'une fois, ce qui évite une longue saisie.  Dans
-le prochain exemple, deux triolets sont imprimés avec une seule fonction
-@code{\times}.
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
-
-@noindent
-Pour plus d'information sur @code{make-moment}, voir
-@ref{Time administration}.
-
-L'apparence du chiffre est déterminée par la propriété @code{text} dans
-@code{TupletNumber}.  La valeur par défaut imprime seulement le
-dénominateur, mais si elle est définie par la fonction
-@code{tuplet-number::calc-fraction-text}, la fraction entière
-@var{num}:@var{den} sera imprimée à la place.
-
-Pour éviter d'imprimer les chiffres des nolets, utilisez
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-\override TupletNumber #'transparent = ##t
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-@end lilypond
-
-Utilisez la fonction @code{\tweak} pour définir une priorité dans le cas
-de nolets imbriqués débutant au même moment.  Dans cet exemple,
-@code{\tweak} spécifie un texte sous forme de fraction pour le
-@code{TupletNumber} externe et de dénominateur pour les trois triolets
-internes.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \times 4/3 {
-     \tweak #'text #tuplet-number::calc-denominator-text
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Ici, @code{\tweak} et @code{\override} agissent de concert pour
-spécifier le positionnement du @code{TupletBracket}.  Le premier
-@code{\tweak} positionne le @code{TupletBracket} du nolet externe au
-dessus de la portée. Le second @code{\tweak} positionne le
-@code{TupletBracket} du premier triolet interne au dessous de la
-portée.  Notez que cette paire de fonctions @code{\tweak} n'affecte
-que le triolet extérieur et le premier des trois triolets imbriqués
-parce qu'ils commencent au même instant musical.  Nous utilisons
-@code{\override} de manière tout à fait normale, pour forcer le
-positionnement du @code{TupletBracket} des deuxième et troisième
-triolets en dessous de la portée.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \tweak #'direction #up
-  \times 4/3 {
-     \tweak #'direction #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \override TupletBracket #'direction = #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Les crochets de nolets peuvent aller jusqu'aux prémisses de la mesure
-suivante, ou à la prochaine note.
-
-@lilypond[ragged-right]
-\new RhythmicStaff {
-  \set tupletFullLength = ##t
-  \time 4/4
-  \times 4/5 {
-    c4 c1
-  }
-  \set tupletFullLengthNote = ##t
-  \time 2/4
-  \times 2/3 {
-    c4 c c 
-  }
-  \time 3/4
-  c4 
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{TupletBracket},
-@internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
-
-
-
-@node Scaling durations
-@subsection Scaling durations
-
-Vous pouvez altérer la durée des notes en leur joignant une fraction
-@var{N/M}, donnant @q{@code{*}@var{N/M}} --- ou @q{@code{*}@var{N}} si
-@var{M=1}.  Ceci n'affectera pas l'apparence des notes ou silences
-produits.
-
-Dans l'exemple suivant, les trois premières notes prennent exactement
-deux temps, mais aucun triolet n'est imprimé.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\time 2/4
-a4*2/3 gis4*2/3 a4*2/3
-a4 a4 a4*2
-b16*4 c4
-@end lilypond
-
-
-@seealso
-
-Dans ce manuel : @ref{Tuplets}.
-
-
-@node Bar check
-@subsection Bar check
-
-@cindex vérification des limites de mesure
-@cindex mesures, vérification des limites
-@funindex barCheckSynchronize
-@funindex |
-
-Les tests de limites de mesure (ou tests de mesure) aident à détecter
-les erreurs dans les durées.  Un test de mesure s'écrit avec une barre
-verticale, @samp{|}.  Lors du traitement, elle doit correspondre à une
-barre de mesure.  Sinon, un avertissement est émis.  Dans l'exemple
-suivant, le deuxième test de mesure signale une erreur.
-@example
-\time 3/4 c2 e4 | g2 |
-@end example
-
-Le test de mesure peut être aussi utilisé dans les paroles, par exemple :
-@example
-\lyricmode @{
- \time 2/4
- Twin -- kle | Twin -- kle
-@}
-@end example
-
-Des durées incorrectes font échouer les tests de mesure, et peuvent
-souvent mettre la partition sens dessus dessous, particulièrement s'il
-s'agit de musique polyphonique.  Vérifier les tests de mesure qui ont
-échoué et les durées incorrectes est un bon moyen de commencer à
-corriger sa partition.
-
-@funindex |
-@funindex pipeSymbol
-
-Il est aussi possible d'attribuer une autre valeur au symbole
-@code{|}, en assignant une expression musicale à @code{pipeSymbol},
-
-@lilypond[quote,ragged-right,verbatim]
-pipeSymbol = \bar "||"
-
-{ c'2 c' | c'2 c' }
-@end lilypond
-
-
-@node Barnumber check
-@subsection Barnumber check
-
-Lorsque l'on recopie de longues pièces, il peut être utile de vérifier
-que les numéros de mesures de LilyPond correspondent à l'original que
-l'on recopie.  Cela se fait avec @code{\barNumberCheck}.  Par exemple,
-
-@verbatim
-\barNumberCheck #123
-@end verbatim
-
-@noindent
-affiche un avertissement lors du traitement si le numéro de mesure à ce
-point (variable @code{currentBarNumber}) n'est pas 123.
-
-
-@node Automatic note splitting
-@subsection Automatic note splitting
-
-On peut convertir automatiquement les notes longues en notes liées.  Il
-faut pour cela remplacer le graveur @internalsref{Note_heads_engraver}
-par le graveur @internalsref{Completion_heads_engraver}.  Dans les
-exemples suivants, les notes dépassant de la mesure sont divisées et
-liées.
-
-@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
-\new Voice \with {
-  \remove "Note_heads_engraver"
-  \consists "Completion_heads_engraver"
-} {
-  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
-}
-@end lilypond
-
-Ce graveur divise toutes les notes qui sortent de la mesure, et insère
-des liaisons de prolongation.  Une utilisation posible consiste à
-déboguer des partitions complexes : si les mesures ne sont pas
-entièrement remplies, alors les liaisons de prolongation montrent
-exactement la durée des décalages de mesure.
-
-Si vous voulez permettre un saut de ligne aux barres de mesure où
-@internalsref{Completion_heads_engraver} divise les notes, vous devez
-aussi enlever @internalsref{Forbid_line_break_engraver}.
-
-
-@refbugs
-
-Bien que toutes les durées --- particulièrement celles contenant des
-nolets --- ne puissent pas être représentées exactement avec des notes
-normales et des points, le graveur n'insèrera pas de nolets.
-
-@code{Completion_heads_engraver} affecte seulement les notes, il ne
-divise pas les silences.
-
-@seealso
-
-Référence du programme : @internalsref{Completion_heads_engraver}.
-
-
-@node Polyphony
-@section Polyphony
-
-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
-portée.
-
-@menu
-* Chords::
-* Stems::
-* Basic polyphony::
-* Explicitly instantiating voices::
-* Collision Resolution::
-@end menu
-
-
-@node Chords
-@subsection Chords
-
-@cindex accords
-
-Un accord est formé en mettant une série de hauteurs entre @code{<}
-et @code{>}.  Un accord peut être suivi d'une durée et d'indications
-d'articulation, comme une simple note.
-
-@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
-@end lilypond
-
-Pour plus d'information à propos des accords, voir @ref{Chord names}.
-
-
-@node Stems
-@subsection Stems
-
-Dès qu'une note est rencontrée, un objet @internalsref{Stem} se crée
-automatiquement.  Pour les rondes et les silences, ils sont aussi
-créés, mais en mode invisible.
-
-@refcommands
-
-@funindex \stemUp
-@code{\stemUp},
-@funindex \stemDown
-@code{\stemDown},
-@funindex \stemNeutral
-@code{\stemNeutral}.
-
-
-@commonprop
-
-Pour changer la direction des hampes au milieu de la portée, utilisez
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
-
-
-@node Basic polyphony
-@subsection Basic polyphony
-
-@cindex polyphonie
-
-La manière la plus facile d'entrer des fragments avec plus d'une voix
-sur une portée est d'entrer chaque voix comme une suite de notes
---- entre accolades : @code{@{...@}} --- puis de les combiner simultanément,
-en séparant les voix avec @code{\\}
-
-@funindex \\
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  c16 d e f
-  <<
-    { g4 f e | d2 e2 } \\
-    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
-    { s2. | s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-Le séparateur permet aux contextes @internalsref{Voice}@footnote{Ces
-voix polyphoniques sont parfois appelées @qq{couches} ou @qq{calques} dans
-d'autres logiciels de notation.}
-@cindex couches
-@cindex calques
-d'être identifiés.  Les contextes de voix portent les noms @code{"1"},
-@code{"2"}, etc.  Dans chacun de ces contextes, la direction verticale
-des liaisons, hampes, etc. est réglée de manière appropriée.
-
-Ces voix sont toutes distinctes de la voix qui contient les notes en
-dehors de la construction @code{<< \\ >>}.  On doit le prendre en compte
-lorsqu'on fait des changements au niveau des voix.  Cela veut aussi dire
-que les liaisons de prolongation et d'articulation ne peuvent ni entrer
-ni sortir de la construction @code{<< \\ >>}.  À l'inverse, des voix
-parallèles venant de constructions @code{<< \\ >>} séparées sur la même
-portée sont dans les mêmes voix.  Voici le même exemple, avec des
-couleurs et têtes de note différentes pour chaque voix.  Notez que le
-changement de style de tête de note n'affecte pas l'intérieur des
-constructions @code{<< \\ >>}.  Aussi, le changement à la deuxième voix
-dans la première construction @code{<< \\ >>} l'affecte aussi dans la
-deuxième construction @code{<< \\ >>}, et la voix est liée entre les
-deux constructions.
-
-@cindex têtes de note, styles
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  <<
-    { g4 f e } \\
-    { \override NoteHead #'style = #'triangle
-      \override NoteHead #'color = #blue
-    r8 e4 d c8 ~ }
-  >> |
-  <<
-    { d2 e2 } \\
-    { c8 b16 a b8 g ~ g2 } \\
-    { \override NoteHead #'style = #'slash 
-      \override NoteHead #'color = #green
-      s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-La polyphonie ne change pas la relation des notes dans un bloc
-@code{\relative @{ @}}.  Chaque note est calculée en fonction de la note
-qui la précède immédiatement, sans tenir compte des différentes voix.
-
-@example
-\relative @{ noteA << noteB \\ noteC >> noteD @}
-@end example
-
-@code{noteC} est calculé relativement à @code{noteB}, non pas à
-@code{noteA} ; @code{noteD} est calculé relativement à @code{noteC}, non
-pas à @code{noteB} ou @code{noteA}.
-
-
-@node Explicitly instantiating voices
-@subsection Explicitly instantiating voices
-
-Les contextes @internalsref{Voice} peuvent être déclarés manuellement
-dans un bloc @code{<< >>} pour créer de la musique polyphonique, en
-utilisant @code{\voiceOne}, @dots{} jusqu'à @code{\voiceFour} pour
-assigner des directions de hampes et un déplacement horizontal pour
-chaque partie.
-
-En particulier,
-@example
-<< \upper \\ \lower >>
-@end example
-
-@noindent
-équivaut à
-
-@example
-<<
- \new Voice = "1" @{ \voiceOne \upper @}
- \new Voice = "2" @{ \voiceTwo \lower @}
->>
-@end example
-
-Les commandes @code{\voiceXXX} fixent la direction des hampes, des
-liaisons de prolongations et de phrasé, des articulations, des
-annotations, des points d'augmentation des notes pointées et des
-doigtés.  @code{\voiceOne} et @code{\voiceThree} font pointer ces objets
-vers le haut, alors que @code{\voiceTwo} et @code{\voiceFour} les font
-pointer vers le bas.  La commande @code{\oneVoice} les ramène aux
-critères normaux.
-
-Une expression séquentielle qui apparaît en premier dans un @code{<< >>}
-appartient à la voix principale.  Ceci est utile lorsque des voix
-supplémentaires apparaissent pendant que la voix principale est jouée.
-Voici une meilleure réalisation de l'exemple de la section précédente.
-Les notes colorées et en croix mettent en évidence le fait que la mélodie principale
-est maintenant dans un seul contexte de voix.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2 }
-    \new Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. | s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-La définition correcte des voix permet à la mélodie d'être liée.
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Le fait d'éviter le séparateur @code{\\} permet aussi d'imbriquer des
-constructions polyphoniques, ce qui peut être une manière plus naturelle
-de saisir la musique.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ |
-      <<
-        {c8 b16 a b8 g ~ g2}
-        \new Voice { \voiceThree
-          s4 b4 c2
-          \oneVoice
-        }
-      >>
-    \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Dans certaines circonstances de polyphonie complexe, vous pourrez être
-amené à recourir à des voix supplémentaires afin d'éviter des collisions
-de notes.  Ces voix additionnelles s'ajoutent en définissant un
-identificateur, comme le montre l'exemple suivant :
-
-@lilypond[quote,verbatim,ragged-right,relative=2]
-voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
-
-\relative c''' <<
-  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
-  { \voiceThree  b4} \\
-  { \voiceFive d,} \\
-  { \voiceTwo g,}
->>
-@end lilypond
-
-
-@node Collision Resolution
-@subsection Collision Resolution
-
-D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
-fusionnées, mais lorsque la propriété @code{merge-differently-dotted} de
-l'objet @internalsref{NoteCollision} est définie, elles se trouvent
-fusionnées :
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice << {
-  g8 g8
-  \override Staff.NoteCollision
-    #'merge-differently-dotted = ##t
-  g8 g8
-} \\ { g8.[ f16] g8.[ f16] } >>
-@end lilypond
-
-De même, vous pouvez fusionner une tête de blanche avec une tête de
-croche, en définissant @code{merge-differently-headed}
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\new Voice << {
-  c8 c4.
-  \override Staff.NoteCollision
-    #'merge-differently-headed = ##t
-c8 c4. } \\ { c2 c2 } >>
-@end lilypond
-
-LilyPond décale aussi verticalement les silences à l'opposé des hampes,
-par exemple
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new Voice << c''4 \\ r4 >>
-@end lilypond
-
-Lorsque trois notes ou plus s'agglutinent dans un même empilement,
-@code{merge-differently-headed} ne peut mener à bien la fusion des deux
-notes qui devraient l'être.  Pour obtenir une fusion optimale, appliquez
-un décalage (@code{\shift}) à la note qui ne devrait pas s'empiler.
-Dans la première mesure de l'exemple suivant,
-@code{merge-differently-headed} ne fonctionne pas --- la tête de la
-blanche est noire.  Dans la seconde mesure, @code{\shiftOn} s'applique
-pour sortir le sol (@code{g}) de l'alignement, et
-@code{merge-differently-headed} fonctionne correctement.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-<<
-  { d=''2 g2 } \\
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-<<
-  { d'=''2 \shiftOn g2 } \\ 
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-@end lilypond
-
-
-@refcommands
-
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
-
-@funindex \shiftOn
-@code{\shiftOn},
-@funindex \shiftOnn
-@code{\shiftOnn},
-@funindex \shiftOnnn
-@code{\shiftOnnn},
-@funindex \shiftOff
-@code{\shiftOff} : toutes ces commandes précisent le degré de décalage
-des notes de la voix courante.  Les voix externes --- habituellement,
-les voix une et deux --- ont @code{\shiftOff}, alors que les voix
-internes --- trois et quatre --- ont @code{\shiftOn}.  @code{\shiftOnn}
-et @code{\shiftOnnn} sont des niveaux supplémentaires de décalage.
-
-Quand LilyPond est dépassé, la propriété @code{force-hshift} de l'objet
-@internalsref{NoteColumn}, et des silences à hauteur déterminée, peuvent
-s'avérer utiles pour dicter au programme les choix de placement.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative <<
-{
-  <d g>
-  <d g>
-} \\ {
-  <b f'>
-  \once \override NoteColumn #'force-hshift = #1.7
-  <b f'>
-} >>
-@end lilypond
-
-
-@seealso
-Référence du programme : les objets appropriés pour résoudre les
-collisions sont @internalsref{NoteCollision} et
-@internalsref{RestCollision}.
-
-
-@refbugs
-
-Quand @code{merge-differently-headed} est utilisé avec une croche ou
-une valeur plus courte à hampe vers le haut, et une blanche hampe vers
-le bas, la croche se retrouve à la mauvaise place.
-
-Il n'y a aucune prise en charge des agrégats dans lesquels une même note
-apparaît avec différentes altérations.  Il est conseillé d'avoir recours
-aux enharmoniques, ou d'utiliser la notation spécifique de cluster ---
-voir @ref{Clusters}.
-
-
-
-@node Staff notation
-@section Staff notation
-
-@cindex Staff notation
-
-De la notation musicale concernant la portée, comme
-les armures, les clefs ou les chiffres de mesure.
-
-@menu
-* Clef::
-* Key signature::
-* Time signature::
-* Partial measures::
-* Bar lines::
-* Unmetered music::
-* System start delimiters::
-* Staff symbol::
-* Writing music in parallel::
-@end menu
-
-
-@node Clef
-@subsection Clef
-
-@funindex \clef
-
-La clé indique quelles lignes de la portée correspondent à telles
-hauteurs.  Elle est réglée par la commande @code{\clef}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
-@end lilypond
-
-@cindex clé de sol
-@cindex clé de fa
-@cindex clé d'ut
-
-Les clés prises en charge sont
-
-@multitable @columnfractions .33 .66
-@headitem Clef @tab Position
-@item @code{treble}, violin, G, G2 @tab Clé de sol 2e ligne
-@item @code{alto, C} @tab Clé d'ut 3e ligne
-@item @code{tenor} @tab Clé d'ut 4e ligne
-@item @code{bass, F} @tab Clé de fa 4e ligne
-@item @code{french} @tab Clé de sol 1e ligne
-@item @code{soprano} @tab Clé d'ut 1e ligne
-@item @code{mezzosoprano} @tab Clé d'ut 2e ligne
-@item @code{baritone} @tab Clé d'ut 5e ligne
-@item @code{varbaritone} @tab Clé de fa 3e ligne
-@item @code{subbass} @tab Clé de fa 5e ligne
-@item @code{percussion} @tab Clé de percussion
-@item @code{tab} @tab Clé de tablature
-@end multitable
-
-En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
-transposée à l'octave respectivement inférieure ou supérieure, et
-@code{_15} ou @code{^15} la transpose de deux octaves.  L'argument
-@var{clefname} doit être mis entre guillemets lorsqu'il contient un
-caractère @qq{souligné} ou des chiffres.  Par exemple,
-
-
-@cindex choral tenor clef
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\clef "G_8" c4
-@end lilypond
-
-
-@commonprop
-
-La commande @code{\clef "treble_8"} équivaut à définir @code{clefGlyph},
-@code{clefPosition} --- qui contrôle la position verticale de la clé ---
-@code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
-lorsque l'une de ces propriétés est changée.  Les exemples suivant font
-apparaître des possibilités de réglage manuel de ces propriétés.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
-@end lilypond
-
-
-@seealso
-
-Dans ce manuel : @ref{Grace notes}.
-
-Référence du programme : @internalsref{Clef}.
-
-
-@node Key signature
-@subsection Key signature
-
-@cindex armure
-@funindex \key
-
-L'armure indique la tonalité dans laquelle la pièce doit être jouée.
-Elle comprend un ensemble d'altérations (dièses ou bémols) à la clé,
-c'est-à-dire au début de la portée.
-
-On définit ou modifie l'armure avec la commande @code{\key}
-
-@example
-@code{\key} @var{hauteur} @var{type}
-@end example
-
-@funindex \minor
-@funindex \major
-@funindex \minor
-@funindex \ionian
-@funindex \locrian
-@funindex \aeolian
-@funindex \mixolydian
-@funindex \lydian
-@funindex \phrygian
-@funindex \dorian
-@cindex modes anciens
-
-Ici, @var{type} doit être @code{\major} ou @code{\minor} afin d'avoir
-respectivement @var{hauteur}-major ou @var{hauteur}-minor.  Vous pouvez
-aussi avoir recours aux modes anciens que sont @code{\ionian},
-@code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
-@code{\phrygian}, et @code{\dorian}.
-
-Cette commande fixe la propriété de contexte @code{Staff.keySignature}.
-Des armures inhabituelles peuvent être spécifiées en modifiant
-directement cette propriété.
-
-Les nouveaux utilisateurs s'embrouillent souvent dans les altérations et
-les armures, car des notes naturelles prennent ou non un bécarre selon
-l'armure.  Pour plus d'informations, voir @ref{Accidentals} ou
-@ref{Accidentals and key signatures}.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\key g \major
-f1
-fis
-@end lilypond
-
-
-@commonprop
-
-Un bécarre est imprimé pour annuler toute altération précédente.  Ceci
-peut être supprimé en réglant la propriété
-@code{Staff.printKeyCancellation}.
-
-@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-\set Staff.printKeyCancellation = ##f
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{KeyCancellation},
-@internalsref{KeySignature}.
-
-
-@node Time signature
-@subsection Time signature
-
-@cindex chiffrage de mesure
-@cindex chiffre indicateur de mesure
-@cindex métrique
-@funindex \time
-
-Le chiffre de mesure indique le mètre d'une pièce : une alternance
-régulière de temps forts et de temps faibles.  Il est indiqué par une
-fraction au début de la portée.
-
-Le chiffre de mesure est réglé par la commande @code{\time}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 2/4 c'2 \time 3/4 c'2.
-@end lilypond
-
-@commonprop
-
-Le symbole imprimé peut être modifié avec la propriété @code{style}.
-En la réglant sur @code{#'()}, une fraction sera utilisée pour les
-chiffres de mesure 4/4 et 2/2.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-\time 4/4 c'1
-\time 2/2 c'1
-\override Staff.TimeSignature #'style = #'()
-\time 4/4 c'1
-\time 2/2 c'1
-@end lilypond
-
-Il y a bien d'autres options pour sa mise en place.  Voir @ref{Ancient time
-signatures} pour plus d'exemples.
-
-@code{\time} définit les propriétés @code{timeSignatureFraction},
-@code{beatLength} et @code{measureLength} dans le contexte
-@code{Timing}, qui en principe est assimilé à @internalsref{Score}.  La
-propriété @code{measureLength} détermine où des barres de mesure doivent
-être insérées, et comment les groupements de notes doivent être gérés.
-La modification de la valeur de @code{timeSignatureFraction} donne
-également lieu à l'impression d'un symbole.
-
-Plus d'options sont accessibles au moyen de la fonction Scheme
-@code{set-time-signature}.  De concert avec le
-@internalsref{Measure_grouping_engraver}, elle crée les signes de
-@internalsref{MeasureGrouping}, qui facilitent la lecture de musiques
-modernes, complexes rythmiquement.  Dans l'exemple suivant, les mesures
-à 9/8 sont subdivisées en @code{(2 2 2 3)}, ce qui est donné comme
-argument à la commande @code{set-time-signature}, en troisième position.
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    #(set-time-signature 9 8 '(2 2 2 3))
-    g8[ g] d[ d] g[ g] a8[( bes g]) |
-    #(set-time-signature 5 8 '(3 2))
-    a4. g4
-  }
-  \layout {
-    \context {
-      \Staff
-      \consists "Measure_grouping_engraver"
-    }
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{TimeSignature} et
-@internalsref{Timing_translator}.
-
-Exemples : @lsr{contemporary,compound-time-signature.ly}.
-
-
-@refbugs
-
-Le groupement automatique des ligatures n'utilise pas les groupements
-spécifiés par @code{set-time-signature}.
-
-
-@node Partial measures
-@subsection Partial measures
-
-@cindex anacrouse
-@cindex levée
-@cindex mesure incomplète
-@funindex \partial
-
-
-Les mesures incomplètes, telles que les anacrouses ou levées, doivent
-être entrées avec la commande
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\partial 16*5 c16 cis d dis e | a2. c,4 | b2
-@end lilypond
-
-
-La syntaxe de cette commande est
-
-@example
-\partial @var{durée}
-@end example
-
-@code{durée} étant la valeur rythmique devant être ajoutée avant la
-mesure suivante.
-
-Le programme traduit cette commande en
-
-@example
-\set Timing.measurePosition = -@var{durée}
-@end example
-
-
-La propriété @code{measurePosition} contient un nombre rationnel qui
-indique, à ce point précis, où l'on en est de la mesure. Notez qu'il
-peut s'agir d'un nombre négatif ; @code{\partial 4} signifie, pour le
-programme : @qq{Dans cette mesure, il reste juste une noire}.
-
-
-@refbugs
-
-Cette commande ne prend pas en compte les notes d'ornement ou
-appoggiatures au début de la musique. Lorsqu'un morceau commence par une
-levée et avec des petites notes, la commande @code{\partial} devrait être
-placée après celles-ci.
-
-@lilypond[verbatim,quote,ragged-right,relative,fragment]
-\grace f16
-\partial 4
-g4
-a2 g2
-@end lilypond
-
-@code{\partial} n'est destiné à être utilisé qu'en début de pièce.
-Si on l'utilise ailleurs qu'au début, des messages d'erreurs peuvent
-s'afficher.
-
-
-@node Bar lines
-@subsection Bar lines
-
-@cindex barres de mesure
-@funindex \bar
-@cindex barres de reprise
-
-
-Les barres de mesures délimitent les mesures, mais peuvent aussi
-indiquer une reprise. En principe, elles sont insérées automatiquement,
-et les sauts de ligne ne peuvent avoir lieu qu'au niveau de ces barres.
-
-Il est possible de forcer l'impression d'une barre de mesure spéciale,
-avec la commande @code{\bar} :
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-c4 \bar "|:" c4
-@end lilypond
-
-
-Les styles de barres de mesure disponibles sont
-
-@lilypondfile[ragged-right,quote]{bar-lines.ly}
-
-
-En plus de cela, on peut demander @code{"||:"}, qui équivaut à
-@code{"|:"}, mais qui donnera, en cas de saut de ligne, une double barre
-en fin de ligne, et une barre de reprise au début de la ligne suivante.
-
-Il est possible d'autoriser un saut de ligne même s'il n'y a pas
-de barre de mesure visible, en utilisant :
-
-@example
-\bar ""
-@end example
-
-@noindent
-
-
-Ceci insérera une barre de mesure invisible, et permettra de sauter de
-ligne à cet endroit, sans incrémenter le numéro de mesure.
-
-
-Dans une partition comprenant plusieurs portées, la commande @code{\bar}
-placée sur une portée s'applique automatiquement à toutes les
-portées. Les barres de mesure que l'on obtient alors sont d'un seul
-tenant sur les portées d'un @code{StaffGroup}, d'un @code{PianoStaff} ou
-d'un @code{GrandStaff}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-<<
-  \new StaffGroup <<
-    \new Staff {
-      e'4 d'
-      \bar "||"
-      f' e'
-    }
-    \new Staff { \clef bass c4 g e g }
-  >>
-  \new Staff { \clef bass c2 c2 }
->>
-@end lilypond
-
-
-@commonprop
-
-@funindex whichBar
-@funindex repeatCommands
-@funindex defaultBarType
-
-
-La commande @code{\bar }@var{bartype} sert de raccourci pour @code{\set
-Timing.whichBar = }@var{bartype}.  Dès que l'on définit @code{whichBar},
-une barre de mesure est créée selon le style défini.
-
-
-Dès que la propriété @code{whichBar} est définie, une barre de mesure
-est créée.  À chaque début de mesure, elle prend la valeur de
-@code{Timing.defaultBarType}.  La valeur de @code{repeatCommands} sert à
-remplacer les barres de mesure par défaut.
-
-Nous vous invitons à utiliser @code{\repeat} pour indiquer les
-reprises. Voyez à ce sujet @ref{Repeats}.
-
-
-@seealso
-
-Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
-
-Référence du programme : @internalsref{BarLine} (faisant partie du
-contexte @internalsref{Staff}), @internalsref{SpanBar} (sur plusieurs
-portées).
-
-
-@node Unmetered music
-@subsection Unmetered music
-
-@cindex cadence
-@funindex \cadenzaOn
-@funindex \cadenzaOff
-
-
-Les barres de mesure et les numéros de mesure sont calculés
-automatiquement, ce qui n'est pas souhaitable dans le cas d'une musique
-non mesurée --- les cadences, par exemple. Les commandes
-@code{\cadenzaOn} et @code{\cadenzaOff} permettent de désactiver et de
-rétablir la métrique automatique.
-
-@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
-c4 d e d
-\cadenzaOn
-c4 c d8 d d f4 g4.
-\cadenzaOff
-\bar "|"
-d4 e d c
-@end lilypond
-
-
-@refbugs
-
-LilyPond ne change de ligne ou de page qu'au niveau des barres de
-mesure.  Si votre musique non mesurée dure plus d'une ligne, il vous
-faudra insérer des barres de mesure invisibles, pour indiquer à quels
-endroit un saut de ligne peut intervenir.
-
-@example
-\bar ""
-@end example
-
-@noindent
-
-
-@node System start delimiters
-@subsection System start delimiters
-
-@cindex système, début de
-@cindex crochet vertical
-@cindex accolade verticale
-@cindex portée multiple
-@cindex portées, groupe de
-
-De nombreuses partitions sont écrites sur plusieurs portées.  Ces
-portées peuvent être regroupées de quatre manières différentes.
-
-@itemize @bullet
-@item Le groupe de portées est attaché par une accolade sur la gauche,
-et les barres de mesure sont d'un seul tenant. Il s'agit du contexte
-@internalsref{GrandStaff}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new GrandStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item Le groupe de portées est attaché par un crochet, et les barres
-de mesure sont d'un seul tenant. Il s'agit du contexte
-@internalsref{StaffGroup}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new StaffGroup
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-
-
-@item Le groupe de portées est attaché par un crochet, mais les barres
-de mesure sont séparées d'une portée à l'autre. Il s'agit du contexte
-@internalsref{ChoirStaff}.
-
-@lilypond[verbatim,ragged-right,quote]
-\new ChoirStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item Les portées du groupe ne sont pas attachées (hormis par une
-simple ligne verticale). Les barres de mesure sont détachées. Il
-s'agit de l'assemblage par défaut.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-@end itemize
-
-
-@seealso
-
-Les barres de mesure au début de chaque système prennent l'un des styles
-@internalsref{SystemStartBar}, @internalsref{SystemStartBrace},
-@internalsref{SystemStartBracket}.  Dans chaque contexte, seul l'un de
-ces styles est utilisé, et c'est la propriété
-@code{systemStartDelimiter} qui détermine lequel.
-
-@commonprop
-
-Les accolades et crochets délimitant les systèmes peuvent être imbriqués
-en profondeur,
-
-@lilypond[quote,ragged-right,verbatim]
-\new StaffGroup
-\relative <<
-  \set StaffGroup.systemStartDelimiterHierarchy
-    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
->>
-@end lilypond
-
-
-@node Staff symbol
-@subsection Staff symbol
-
-@cindex symbole de portée
-@cindex portée, lignes de
-
-Les notes, nuances, etc. sont regroupés dans un assemblage de lignes
-horizontales, que l'on nomme la portée (en anglais @qq{staff}, et
-@qq{staves} au pluriel).  Dans LilyPond, ces lignes sont dessinées au
-moyen d'un objet de mise en forme à part entière, nommé @code{staff
-symbol} --- symbole de portée.
-
-
-L'aspect du symbole de portée peut être modifié selon différentes
-propriétés, telles que le nombre de lignes, leur épaisseur, ou leur
-éloignement. Vous en trouverez des exemples dans
-@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} et
-@lsr{staff,changing-the-staff-size.ly}.
-
-
-De plus, la portée peut commencer et s'arrêter où l'on veut, grâce aux
-commandes @code{\startStaff} et @code{\stopStaff}.
-
-@lilypond[verbatim,relative=2,fragment]
-b4 b
-\override Staff.StaffSymbol #'line-count = 2
-\stopStaff \startStaff
-b b
-\revert Staff.StaffSymbol #'line-count
-\stopStaff \startStaff
-b b
-@end lilypond
-
-Cette manière de procéder peut être utilisée pour introduire des
-@qq{ossias}, ou dans des partitions à nombre de portées variable,
-comme sur l'exemple suivant :
-
-@cindex ossia
-
-@lilypondfile{ossia.ly}
-
-@cindex lignes de portée, nombre de
-@cindex lignes de portée, épaisseur des
-@cindex épaisseur des lignes de portées
-@cindex nombre de lignes de portée
-
-@seealso
-
-Référence du programme : @internalsref{StaffSymbol}.
-
-D'autres exemples : @lsrdir{staff}.
-
-
-@node Writing music in parallel
-@subsection Writing music in parallel
-
-@cindex écrire la musique en parallèle
-@cindex musique en parallèle
-@cindex musique entremêlée
-
-On peut écrire plusieurs voix de façon entremêlée :
-
-@lilypond[quote,fragment,verbatim]
-\parallelMusic #'(voiceA voiceB) {
-  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
-  c'2                                c'2                                |
-  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
-  c'2                                c'2                                |
-}
-\new StaffGroup <<
-  \new Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
->>
-@end lilypond
-
-Ceci fonctionne bien avec la musique pour piano :
-
-@lilypond[quote,verbatim]
-music = {
-  \key c \major
-  \time 4/4
-  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
-    % Bar 1
-    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
-e''] |
-    c'2                                 c'2 |
-    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
-    c2                                  c2 |
-
-    % Bar 2
-    a'8 b'      c'' d''    e'' f''    g'' a'' |
-    d'4         d'         d'         d' |
-    c16 d e f   d e f g    e f g a    f g a b |
-    a,4         a,4        a,4        a,4 |
-
-    % Bar 3 ...
-  }
-}
-
-\score {
-  \new PianoStaff <<
-    \music
-    \new Staff <<
-      \voiceA \\
-      \voiceB
-    >>
-    \new Staff {
-      \clef bass
-      <<
-        \voiceC \\
-        \voiceD
-      >>
-    }
-  >>
-}
-@end lilypond
-
-
-@node Connecting notes
-@section Connecting notes
-
-De la notation qui affecte des groupes de notes.
-
-@menu
-* Ties::
-* Slurs::
-* Phrasing slurs::
-* Laissez vibrer ties::
-* Automatic beams::
-* Manual beams::
-* Grace notes::
-@end menu
-
-
-@node Ties
-@subsection Ties
-
-@cindex liaison de prolongation
-@funindex ~
-
-Une liaison de tenue (ou de prolongation) relie deux notes adjacentes de
-même hauteur.  Dans les faits, elle prolonge la durée d'une note, et ne
-doit donc pas être confondue avec les liaisons d'articulation ou de
-phrasé.  Une liaison de tenue est indiquée au moyen d'un tilde @samp{~}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-e' ~ e' <c' e' g'> ~ <c' e' g'>
-@end lilypond
-
-
-Quand une liaison de tenue se trouve entre deux accords, toutes les
-notes de même hauteur entre ces deux accords sont reliées.  S'il n'y en
-a aucune, aucune liaison n'est créée.  Il est également possible de lier
-partiellement deux accords, en mettant les liaisons à l'intérieur des
-accords.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-<c~ e g~ b> <c e g b>
-@end lilypond
-
-
-Une liaison de tenue est un moyen parmi d'autres pour prolonger la durée
-d'une note, tout comme les points.  L'exemple suivant montre deux
-manières de matérialiser exactement la même idée :
-
-
-@lilypond[quote,fragment,ragged-right]
-\time 3/4 c'2. c'2 ~ c'4
-@end lilypond
-
-@noindent
-Les liaisons de tenues sont utilisées soit lorsque la note dépasse de la
-mesure, soit quand les points ne suffisent pas à donner la bonne durée.
-Lorsque l'on utilise ces liaisons, les valeurs rythmiques les plus
-longues doivent s'aligner sur les subidivisions de la mesure, comme ici :
-
-@c KEEP LY
-@lilypond[fragment,quote,ragged-right]
-\relative {
-  r8^"oui" c8 ~ c2 r4 | r8^"non" c2 ~ c8 r4
-}
-@end lilypond
-
-
-Lorsque l'on doit lier de nombreuses notes sur plusieurs mesures, il
-devient plus facile d'avoir recours à la division automatique des notes
---- voir @ref{Automatic note splitting}.  Ce procédé divise
-automatiquement les notes trop longues, et les lie par-delà les barres
-de mesure.
-
-@funindex \repeatTie
-
-Lorsqu'une mesure de seconde fois après une reprise commence sur une
-note liée, la liaison doit être répétée. C'est à cela que sert la
-commande @code{\repeatTie} :
-
-@lilypond[fragment,quote,ragged-right,relative=2]
-r <c e g>\repeatTie
-@end lilypond
-
-@cindex liaison de prolongation, répétition
-@cindex reprises avec alternatives et liaisons de prolongation
-
-@commonprop
-
-Les liaisons de tenue servent parfois à rendre un accord arpégé. Dans ce
-cas, les notes liées ne sont pas toutes consécutives. Il faut alors
-assigner à la propriété @code{tieWaitForNote} la valeur @emph{vrai}
-(@q{t} pour @q{true}).  Cette même méthode peut servir, par exemple, à
-lier un trémolo à un accord.
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-\set tieWaitForNote = ##t
-\grace { c16[~ e~ g]~ } <c, e g>2
-\repeat tremolo 8 { c32~ c'~ } <c c,>1
-e8~ c~ a~ f~ <e' c a f>2
-@end lilypond
-
-Il est possible de graver manuellement les liaisons de tenue, en
-modifiant la propriété @code{tie-configuration}.  Pour chaque paire, le
-premier nombre indique la distance à la portée, en espaces de portée, et
-le second la direction (1 pour haut, @minus{}1 pour bas).
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-<c e g>2~ <c e g> |
-\override TieColumn #'tie-configuration =
-  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
-<c e g>~ <c e g> |
-@end lilypond
-
-
-@refcommands
-
-@funindex \tieUp
-@code{\tieUp},
-@funindex \tieDown
-@code{\tieDown},
-@funindex \tieNeutral
-@code{\tieNeutral},
-@funindex \tieDotted
-@code{\tieDotted},
-@funindex \tieDashed
-@code{\tieDashed},
-@funindex \tieSolid
-@code{\tieSolid}.
-
-
-@seealso
-
-Dans ce même manuel : @ref{Automatic note splitting}.
-
-Référence du programme : @internalsref{Tie}.
-
-
-@refbugs
-
-Un changement de portée, lorsqu'une liaison de tenue est active, ne
-peut produire une liaison oblique.
-
-Le changement de clé ou d'octave pendant une liaison de tenue produit un
-résultat indéfini.  Dans ces cas-là, il est préférable d'utiliser un
-legato.
-
-
-@node Slurs
-@subsection Slurs
-
-@cindex legato
-@cindex liaison d'articulation
-
-Une liaison d'articulation indique que les notes doivent être jouées
-liées, ou @emph{legato}.  Ces liaisons s'indiquent au moyen de
-parenthèses.
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-f( g a) a8 b( a4 g2 f4)
-<c e>2( <b d>2)
-@end lilypond
-
-
-On peut indiquer l'orientation des liaisons suivantes avec
-@code{\slur@emph{DIR}}, @code{@emph{DIR}} pouvant être @code{Up} pour
-une liaison vers le haut, @code{Down} pour une liaison vers le bas, ou
-@code{Neutral} pour laisser LilyPond décider.
-
-Il existe également un raccourci pratique pour forcer l'orientation
-d'une seule liaison.  Il suffit pour cela d'ajouter @code{_} ou @code{^}
-avant d'ouvrir une parenthèse.
-
-@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
-c4_( c) c^( c)
-@end lilypond
-
-
-Une seule liaison d'articulation peut être imprimée à la fois.  S'il est
-nécessaire d'imprimer une liaison plus longue, englobant des liaisons
-plus courtes, utilisez des @ref{Phrasing slurs}.
-
-
-@commonprop
-
-Certains auteurs utilisent deux liaisons lorsqu'ils veulent
-lier des accords. Dans LilyPond, il faut pour cela assigner
-@emph{vrai} (@q{true}) la propriété @code{doubleSlurs} :
-
-@lilypond[verbatim,ragged-right,relative,fragment,quote]
-\set doubleSlurs = ##t
-<c e>4 ( <d f> <c e> <d f> )
-@end lilypond
-
-
-@refcommands
-
-@funindex \slurUp
-@code{\slurUp},
-@funindex \slurDown
-@code{\slurDown},
-@funindex \slurNeutral
-@code{\slurNeutral},
-@funindex \slurDashed
-@code{\slurDashed},
-@funindex \slurDotted
-@code{\slurDotted},
-@funindex \slurSolid
-@code{\slurSolid}.
-
-@seealso
-
-Référence du programme : @seeinternals{Slur}.
-
-
-@node Phrasing slurs
-@subsection Phrasing slurs
-
-@cindex liaisons de phrasé
-@cindex phrasé, liaisons de
-
-Une liaison de phrasé relie plusieurs notes en délimitant une phrase
-musicale.  On indique les points de départ et d'arrivée avec @code{\(}
-et @code{\)} respectivement.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-\time 6/4 c'\( d( e) f( e) d\)
-@end lilypond
-
-
-D'un point de vue typographique, rien ne distingue une liaison de phrasé
-d'une liaison d'articulation. Cependant, LilyPond les considère comme
-des objets différents. Une commande @code{\slurUp} n'affectera donc pas
-une liaison de phrasé : il faut plutôt utiliser @code{\phrasingSlurUp},
-@code{\phrasingSlurDown} ou @code{\phrasingSlurNeutral}.
-
-Il n'est pas possible d'avoir plusieurs liaisons de phrasé en même temps.
-
-
-@refcommands
-
-@funindex \phrasingSlurUp
-@code{\phrasingSlurUp},
-@funindex \phrasingSlurDown
-@code{\phrasingSlurDown},
-@funindex \phrasingSlurNeutral
-@code{\phrasingSlurNeutral}.
-
-
-@seealso
-
-Référence du programme : @internalsref{PhrasingSlur}.
-
-
-@node Laissez vibrer ties
-@subsection Laissez vibrer ties
-
-@cindex laissez vibrer
-@cindex liaison, laissez vibrer
-
-Les liaisons @qq{Laissez vibrer} (L.V.) sont utilisées pour le piano, la
-harpe, et certains instruments de percussion.  Elles indiquent à
-l'instrumentiste de laisser sonner la note ou l'accord au lieu de
-l'étouffer.  Cet effet s'obtient avec la commande @code{\laissezVibrer}.
-
-@lilypond[fragment,ragged-right,verbatim,relative=1]
-<c f g>\laissezVibrer
-@end lilypond
-
-@seealso
-
-Référence du programme :
-@internalsref{LaissezVibrerTie}
-@internalsref{LaissezVibrerTieColumn}
-
-D'autres exemples :
-@lsr{connecting,laissez-vibrer-ties.ly}
-
-
-@node Automatic beams
-@subsection Automatic beams
-
-LilyPond décide automatiquement de la manière de grouper les notes et
-d'imprimer les ligatures.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
-@end lilypond
-
-Lorsque ce comportement automatisé n'est pas satisfaisant, on peut
-définir des groupements manuellement --- voir section suivante --- ou
-personnaliser les groupements automatiques --- voir @ref{Setting
-automatic beam behavior}.
-
-La commande @code{\noBeam} peut servir à empêcher des notes
-individuelles d'être rattachées aux autres.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c\noBeam c c
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{Beam}.
-
-
-@node Manual beams
-@subsection Manual beams
-
-@cindex groupements de note manuels
-@cindex ligatures manuelles
-@funindex ]
-@funindex [
-
-Dans certaines situations, il peut s'avérer nécessaire de
-supplanter l'algorithme de groupement automatique des notes, par
-exemple pour prolonger une ligature par-dessus un silence ou une barre
-de mesure.  Le début et la fin de la ligature sont alors indiqués par
-@code{[} et @code{]}.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-  r4 r8[ g' a r8] r8 g[ | a] r8
-}
-@end lilypond
-
-
-@commonprop
-
-@funindex stemLeftBeamCount
-@funindex stemRightBeamCount
-
-LilyPond peut déterminer automatiquement les sous-groupes à
-l'intérieur d'un groupement de notes, bien que le résultat ne soit pas 
-toujours optimal.  Les propriétés @code{stemLeftBeamCount} et
-@code{stemRightBeamCount} permettent alors
-d'ajuster ce comportement.  Lorsque l'une ou l'autre de ces propriétés
-est définie, elle ne s'applique qu'une seule fois, après quoi sa
-définition est effacée.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-   f8[ r16
-      f g a]
-   f8[ r16
-   \set stemLeftBeamCount = #1
-      f g a]
-}
-@end lilypond
-
-La propriété @code{subdivideBeams} sert à grouper les double-croches
-ou les valeurs plus brèves pulsation par pulsation, la pulsation
-étant définie par la propriété @code{beatLength}.
-
-@lilypond[fragment,quote,relative=2,verbatim]
-c16[ c c c c c c c]
-\set subdivideBeams = ##t
-c16[ c c c c c c c]
-\set Score.beatLength = #(ly:make-moment 1 8)
-c16[ c c c c c c c]
-@end lilypond
-@funindex subdivideBeams
-
-@noindent
-Pour plus d'information sur @code{make-moment}, voir
-@ref{Time administration}.
-
-Lorsqu'une ligature franchit une barre de mesure, le saut
-de ligne est en principe interdit à cet endroit.  Ce comportement peut
-être outrepassé en définissant @code{breakable}.
-
-@funindex breakable
-
-@cindex ligatures et sauts de ligne
-@cindex ligatures coudées
-@cindex auto-knee-gap
-
-LilyPond insère automatiquement des ligatures coudées --- certaines
-notes vers le haut, d'autres vers le bas --- lorsqu'il détecte un espace
-important entre des têtes de notes. Ce comportement peut être changé par
-l'intermédiaire de l'objet @code{auto-knee-gap}
-
-
-@refbugs
-
-Les ligatures coudées à cheval sur deux portées ne peuvent être
-employées en même temps que des portées invisibles.  Voir
-@ref{Hiding staves}.
-
-@c Is this still true with skyline spacing stuff? -J.Mandereau
-Les ligatures peuvent entrer en collision avec des symboles entourant
-les notes, contrairement aux textes ou aux altérations.
-
-
-@node Grace notes
-@subsection Grace notes
-
-@funindex \grace
-@cindex ornements
-@cindex notes d'ornement
-@cindex appoggiature
-@cindex accacciature
-@cindex petite note
-
-
-Les petites notes sont des ornements entièrement écrits.  Les plus
-courantes sont les accacciatures, qui doivent se jouer très vite,
-et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
-et liée.  L'appoggiature est une petite note non barrée, qui vole
-une fraction à la durée de la note réelle qui la suit.
-
-Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
-et @code{\appoggiatura}, comme le montre l'exemple suivant :
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-b4 \acciaccatura d8 c4 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
-@end lilypond
-
-
-Ce sont là deux formes spéciales de la commande @code{\grace}, qui prend
-en charge toutes les petites notes. Si on la fait suivre d'une
-expression musicale, un groupe de petites notes sera créé, sans impact
-sur la métrique.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2 c4
-@end lilypond
-
-@noindent
-Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
-commande @code{\grace} ne provoque pas de liaison.
-
-La durée des petites notes est interprétée par le programme en fonction
-d'un deuxième compteur de temps, le chronomètre @code{grace}.  Chaque
-instant est défini par deux nombres rationnels : le premier compte les
-durées réelles, le second compte la durée des petites notes.  Reprenons
-l'exemple ci-dessus en y ajoutant ces couples de nombres :
-
-@lilypond[quote,ragged-right]
-<<
-  \relative c''{
-    c4 \grace c16 c4 \grace {
-    c16[ d16] } c2 c4
-  }
-  \new Lyrics \lyricmode {
-    \override LyricText #'font-family = #'typewriter
-
-    \markup { (0,0) } 4
-    \grace { \markup {
-      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
-    \markup { (\fraction 1 4 , 0 ) } 4
-    \grace {
-      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
-      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
-    }
-    \markup { ( \fraction 2 4 , 0 ) }
-  }
->>
-@end lilypond
-
-Les petites notes se placent de façon synchrone entre les différentes
-portées.  Dans l'exemple suivant, il y a deux petites double-croches
-pour chaque petite croche.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \grace { c16[ d e f] } e4 }
-   \new Staff { c4 \grace { g8[ b] } c4 } >>
-@end lilypond
-
-@funindex \afterGrace
-
-La commande @code{\afterGrace} sert à placer une petite note après une
-note réelle --- et non @emph{avant} comme d'ordinaire.  Cette commande
-requiert deux arguments : la note réelle, et la ou les petites notes qui
-suivent.
-
-@lilypond[ragged-right, verbatim,relative=2,fragment]
-c1 \afterGrace d1 { c16[ d] } c4
-@end lilypond
-
-Les petites notes se placent alors aux 3/4 de la durée de la note
-réelle.  Cette fraction peut être changée en définissant
-@code{afterGraceFraction} ; ainsi,
-
-@example
-#(define afterGraceFraction (cons 7 8))
-@end example
-
-@noindent
-placera la petite note à 7/8 de la note réelle.
-
-On peut obtenir le même effet manuellement, de la façon suivante :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  << { d1^\trill_( }
-     { s2 \grace { c16[ d] } } >>
-  c4)
-}
-@end lilypond
-
-@noindent
-Le silence invisible peut être plus ou moins long --- ici c'est une
-demi-pause --- afin d'ajuster l'espace entre la note réelle et les
-petites notes.
-
-Les expressions @code{\grace} obéissent à des règles typographiques
-particulières, notamment pour régler l'orientation et la taille des
-objets.  De ce fait, toute subtilité de mise en forme devra être
-indiquée @emph{à l'intérieur} de l'expression introduite par
-@code{\grace} :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  \acciaccatura {
-    \stemDown
-    f16->
-    \stemNeutral
-  }
-  g4
-}
-@end lilypond
-
-@noindent
-Tous les réglages ajoutés doivent également être désactivés dans cette
-même expression.
-
-Il est possible de changer globalement la mise en forme des petites
-notes dans un morceau, au moyen de la fonction
-@code{add-grace-property}.  Ici, par exemple, on ôte la définition de
-l'orientation des objets @code{Stem} pour toutes les petites notes, afin
-que les hampes ne soient pas toujours orientées vers le haut.
-
-@example
-\new Staff @{
- #(add-grace-property 'Voice 'Stem 'direction '())
- @dots{}
-@}
-@end example
-
-@noindent
-Il est par ailleurs possible de modifier les variables
-@code{startGraceMusic}, @code{stopGraceMusic},
-@code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
-@code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
-Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
-
-@noindent
-Le trait que l'on trouve sur les hampes des accacciatures peut
-être appliqué dans d'autres situations en définissant @*
-@code{\override Stem  #'stroke-style = #"grace"}.
-
-
-@commonprop
-
-Il est possible de forcer l'élasticité de l'espacement des notes d'agrément.
-
-@lilypond[relative=2,ragged-right]
-<<
-  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
-  \new Staff {
-     c'4
-     \afterGrace
-     c'4
-     { c'16[ c'8 c'16] }
-     c'4
-  }  
-  \new Staff {
-     c'16[ c'16 c'16 c'16]
-     c'16[ c'16 c'16 c'16]
-     c'4
-  }
->>
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{GraceMusic}.
-
-
-@refbugs
-
-Une partition commençant par une expression @code{\grace} doit faire
-intervenir la commande @code{\new Voice}, sans quoi la note réelle et
-la petite note se retrouveront sur des portées différentes.
-
-La synchronisation des petites notes se fait de façon parfois
-surprenante, car les autres objets de la portée --- barres de mesure,
-armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
-mélez des portées comprenant des petites notes et d'autres sans :
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" d4 } >>
-@end lilypond
-
-@noindent
-Il est possible de remédier à cela en insérant sur les autres portées
-des silences invisibles dans une expression précédée de @code{\grace},
-correspondant à la durée des petites notes.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
-@end lilypond
- 
-Seules des expressions musicales séquentielles peuvent être utilisées
-pour des petites notes ; il n'est pas possible d'imbriquer ni de
-juxtaposer des sections de petites notes, faute de quoi le traitement du
-code peut échouer ou produire des erreurs.
-
-
-@node Expressive marks
-@section Expressive marks
-
-Les signes d'interprétation aident les musiciens à faire en sorte que la
-musique soit plus qu'un simple assemblage de notes et de rythmes.
-
-@menu
-* Articulations::
-* Fingering instructions::
-* Dynamics::
-* Breath marks::
-* Trills::
-* Glissando::
-* Arpeggio::
-* Falls and doits::
-@end menu
-
-
-@node Articulations
-@subsection Articulations
-
-@cindex articulations
-@cindex symboles d'ornementation
-@cindex ornementations, symboles
-
-
-Différents symboles peuvent être ajoutés au-dessus ou au-dessous des
-notes pour indiquer des ponctuations ou des modes de jeu différents.
-On les ajoute à chaque note au moyen d'un tiret suivi du caractère
-correspondant à l'articulation désirée.  En voici une démonstration :
-
-@lilypondfile[quote,ragged-right]{script-abbreviations.ly}
-
-Il est possible de changer la signification de ces raccourcis : voir des
-exemples dans @file{ly/@/script@/-init@/.ly}.
-
-Même si LilyPond place automatiquement ces symboles, il est possible de
-l'obliger à les placer au-dessus ou en-dessous de la note, tout comme
-d'autres objets, en utilisant respectivement @code{^} et @code{_}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c''4^^ c''4_^
-@end lilypond
-
-On peut ajouter d'autres symboles, avec la syntaxe
-@var{note}@code{\}@var{symbole}.  Ici encore, on peut forcer leur
-orientation avec @code{^} and @code{_}.
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c\fermata c^\fermata c_\fermata
-@end lilypond
-
-@cindex accent
-@cindex marcato
-@cindex staccatissimo
-@cindex espressivo
-@cindex point d'orgue
-@cindex point d'arrêt
-@cindex staccato
-@cindex portato
-@cindex tenuto
-@cindex tirer l'archet
-@cindex pousser l'archet
-@cindex bouché
-@cindex sourdine
-@cindex orgue, marque de pédale d'
-@cindex grupetto
-@cindex ouvert
-@cindex flageolet
-@cindex trille
-@cindex mordant
-@cindex ornementation baroque
-@cindex baroque, ornementation
-@cindex pouce
-@cindex segno
-@cindex coda
-@cindex varcoda
-
-
-Voici la liste exhaustive des symboles :
-
-@lilypondfile[ragged-right,quote]{script-chart.ly}
-
-@commonprop
-
-Les symboles s'ordonnent verticalement suivant la propriété
-@code{script-priority}. Plus sa valeur numérique est faible, plus le
-symbole sera proche de la note. Dans l'exemple suivant, l'objet
-@internalsref{TextScript} --- le dièse --- a d'abord la propriété la
-plus basse, et il est donc placé plus près de la note ; ensuite c'est
-l'objet @internalsref{Script} qui a la propriété la plus basse, et il se
-place alors sous le dièse.  Lorsque deux objets ont la même priorité,
-c'est l'ordre dans lequel ils sont indiqués qui détermine lequel sera
-placé en premier.
-
-@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
-\once \override TextScript #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-
-\once \override Script #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{Script}.
-
-
-@refbugs
-
-Ces symboles sont présents sur la partition imprimée, mais
-n'ont pas d'effet sur le rendu de la musique en MIDI.
-
-
-@node Fingering instructions
-@subsection Fingering instructions
-
-@cindex doigté
-@cindex substitution de doigt
-
-
-Les doigtés peuvent être indiqués comme suit :
-@example
-@var{note}-@var{chiffre_du_doigt}
-@end example
-Pour les substitutions de doigts, on a recours à une indication
-textuelle (commande @code{\markup}) de doigté
-(commande @code{\finger}).
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
-@end lilypond
-
-
-La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
-dans une partition de violoncelle, si une note doit être jouée avec le
-pouce (@q{thumb} en anglais).
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
-@end lilypond
-
-
-Les doigtés des accords peuvent être saisis note par note,
-en les indiquant après chaque hauteur de note.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
-@end lilypond
-
-
-@commonprop
-
-On peut contrôler précisément les doigtés des accords en réglant
-la propriété @code{fingeringOrientations}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-
-Cette propriété permet également, dans de la musique monophonique,
-d'indiquer des doigtés très proches des têtes de notes.
-
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{Fingering}.
-
-D'autres exemples : @lsr{expressive,fingering-chords.ly}.
-
-
-@node Dynamics
-@subsection Dynamics
-
-@cindex nuances
-@funindex \pppp
-@funindex \ppp
-@funindex \pp
-@funindex \p
-@funindex \mp
-@funindex \mf
-@funindex \f
-@funindex \ff
-@funindex \fff
-@funindex \ffff
-@funindex \fp
-@funindex \sf
-@funindex \sff
-@funindex \sp
-@funindex \spp
-@funindex \sfz
-@funindex \rfz
-
-À chaque nuance absolue correspond une commande, qui peut être indiquée
-après une note : @code{c4\ff} par exemple.  Les commandes de nuances
-disponibles sont @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp},
-@code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
-@code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
-@code{\spp}, @code{\sfz}, et @code{\rfz}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
-c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
-@end lilypond
-
-@funindex \<
-@funindex \>
-@funindex \!
-
-Un crescendo est délimité par @code{\<} et @code{\!}, ou peut se
-terminer par une commande de nuance.  Au lieu de @code{\<}
-ou @code{\>}, on peut aussi utiliser @code{\cr} et @code{\decr}.
-Ces indications sont attachées aux notes ; aussi si l'on veut
-faire se succéder plusieurs nuances pendant une note tenue, il faudra
-avoir recours à des silences invisibles :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\< c\! d\> e\!
-<< f1 { s4 s4\< s4\! \> s4\! } >>
-@end lilypond
-
-@noindent
-En principe, un soufflet --- (de)crescendo imprimé sous forme graphique --
-commence au bord gauche de la note de départ, et se termine au
-bord droit de la note d'arrivée.  Cependant, si la note d'arrivée
-est sur un premier temps, le soufflet s'arrêtera au niveau de la
-barre de mesure qui la précède.  Ce comportement peut être annulé
-en assignant @emph{faux} (lettre @q{f}) à la propriété
-@code{hairpinToBarline} :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set hairpinToBarline = ##f
-c4\< c2. c4\!
-@end lilypond
-
-On peut avoir recours à l'indication @code{\espressivo} pour indiquer un
-crescendo puis un decrescendo sur une seule note.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c2 b4 a g1\espressivo
-@end lilypond
-
-Cependant, ces deux indications graphiques peuvent se trouver très
-comprimées horizontalement.  Pour les rallonger, on peut modifier la
-propriété @code{minimum-length} de
-@code{Voice.Hairpin} --- @internalsref{Voice}
-étant le contexte, et @internalsref{Hairpin} l'objet affecté. Par
-exemple :
-
-@example
-\override Voice.Hairpin #'minimum-length = #5
-@end example
-
-@cindex al niente
-@cindex niente, al
-
-Des crescendos ou decrescendos @emph{al niente} peuvent être indiqués de
-manière graphique, en assignant @emph{vrai} (lettre @q{t}) à la
-propriété @code{circled-tip}, ce qui affiche un cercle à leur extrémité.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override Hairpin #'circled-tip = ##t
-c2\< c\!
-c4\> c\< c2\!
-@end lilypond
-
-
-@cindex crescendo
-@cindex decrescendo
-@cindex diminuendo
-
-Au lieu d'une notation graphique des crescendos, on peut utiliser
-une notation textuelle.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\setTextCresc
-c\< d e f\!
-\setHairpinCresc
-e\> d c b\!
-\setTextDecresc
-c\> d e f\!
-\setTextDim
-e\> d c b\!
-@end lilypond
-
-On peut même définir ses propres indications textuelles :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\set crescendoText = \markup { \italic "cresc. poco" }
-\set crescendoSpanner = #'dashed-line
-a'2\< a a a\!\mf
-@end lilypond
-
-Pour créer des indications de nuances qui restent alignées
-avec les nuances habituelles, voir @ref{New dynamic marks}.
-
-Le positionnement vertical des nuances est géré par le
-@internalsref{DynamicLineSpanner}.
-
-
-@commonprop
-
-Des nuances différentes situées --- ou commençant --- sur une même
-note seront alignées verticalement.  Pour aligner des nuances qui ne
-se situeraient pas sur une même note, il est possible d'augmenter
-la propriété @code{staff-padding}.
-
-@example
-\override DynamicLineSpanner #'staff-padding = #4
-@end example
-
-Cette propriété peut aussi servir à régler des problèmes de
-collision entre des nuances et d'autres objets.
-
-Les crescendos ou decrescendos qui aboutissent sur la première note
-d'une nouvelle ligne ne sont imprimés que jusqu'à la fin de la ligne
-précédente.  Ce comportement peut être outrepassé en définissant :
-
-@example
-\override Score.Hairpin #'after-line-breaking = ##t
-@end example
-
-
-Les crescendos et decrescendos indiqués textuellement --- tels que
-@emph{cresc.} ou @emph{dim.} --- sont suivis de pointillés qui montrent
-leur étendue.  On peut empêcher l'impression de ces pointillés avec :
-
-@example
-\override DynamicTextSpanner #'dash-period = #-1.0
-@end example
-
-
-@refcommands
-
-@funindex \dynamicUp
-@code{\dynamicUp},
-@funindex \dynamicDown
-@code{\dynamicDown},
-@funindex \dynamicNeutral
-@code{\dynamicNeutral}.
-
-
-@seealso
-
-Référence du programme : @internalsref{DynamicText}, @internalsref{Hairpin}.
-
-Le placement vertical de ces éléments graphiques est géré par le
-@internalsref{DynamicLineSpanner}.
-
-
-@node Breath marks
-@subsection Breath marks
-
-Les indications de respiration sont indiquées par la commande @code{\breathe}.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c'4 \breathe d4
-@end lilypond
-
-
-@commonprop
-
-On peut choisir le glyphe imprimé par cette commande, en modifiant la
-propriété @code{text} de l'objet @code{BreathingSign}, pour lui affecter
-n'importe quelle indication textuelle.  Par exemple :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-c'4
-\override BreathingSign #'text
-  = #(make-musicglyph-markup "scripts.rvarcomma")
-\breathe
-d4
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{BreathingSign}.
-
-Exemples : @lsr{expressive,breathing-sign.ly}
-
-
-@node Trills
-@subsection Trills
-
-Les trilles brefs s'indiquent comme n'importe quelle ponctuation :
-voir @ref{Articulations}.
-
-
-Les trilles plus longs sont délimités par @code{\startTrillSpan} et
-@code{\stopTrillSpan} :
-
-@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
-\new Voice {
-  << { c1 \startTrillSpan }
-     { s2. \grace { d16[\stopTrillSpan e] } } >>
-  c4 }
-@end lilypond
-
-@cindex trilles avec hauteur explicite
-
-Les trilles qui font intervenir une hauteur précise peuvent être
-indiqués par la commande @code{pitchedTrill}.
-
-@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
-\pitchedTrill c4\startTrillSpan fis
-f\stopTrillSpan
-@end lilypond
-
-@noindent
-Le premier argument est la note réelle ; le second est une hauteur qui
-sera imprimée comme une tête de note noire entre parenthèses.
-
-
-@refcommands
-
-@code{\startTrillSpan},
-@funindex \startTrillSpan
-@code{\stopTrillSpan}.
-@funindex \stopTrillSpan
-
-
-@seealso
-
-Référence du programme : @internalsref{TrillSpanner}.
-
-
-@node Glissando
-@subsection Glissando
-
-@cindex glissando
-@funindex \glissando
-
-Un glissando relie une hauteur à une autre en passant par chaque hauteur
-intermédiaire.  Il est indiqué graphiquement, par une ligne ou des
-vaguelettes entre ces deux notes. On l'obtient en accolant la commande
-@code{\glissando} à la première note.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-c2\glissando c'
-\override Glissando #'style = #'zigzag
-c2\glissando c,
-@end lilypond
-
-
-@commonprop
-
-@lilypond[quote,ragged-right,verbatim]
-I = \once \override NoteColumn #'ignore-collision = ##t
-
-\relative <<
-  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
-  { \oneVoice \I c2 \glissando \I d, }
->>
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{Glissando}.
-
-D'autres exemples : @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}.
-
-
-@refbugs
-
-Il n'est pas possible d'imprimer un texte (tel que @emph{gliss.})
-le long de la ligne de glissando.
-
-
-@node Arpeggio
-@subsection Arpeggio
-
-@cindex arpège
-@cindex accord arpégé
-@funindex \arpeggio
-
-
-On peut indiquer qu'un accord doit être arpégé en lui accolant la
-commande @code{\arpeggio} :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-<c e g c>\arpeggio
-@end lilypond
-
-
-Pour spécifier qu'un autre accord doit être plaqué et non arpégé, on
-peut remplacer ce signe par un crochet :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\arpeggioBracket
-<c' e g c>\arpeggio
-@end lilypond
-
-
-Le sens de l'arpège est parfois indiqué par une pointe de flèche au bout
-de la vaguelette :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new Voice {
-  \arpeggioUp
-  <c e g c>\arpeggio
-  \arpeggioDown
-  <c e g c>\arpeggio
-}
-@end lilypond
-
-
-@commonprop
-
-Quand un arpège couvre plusieurs portées, il est possible d'indiquer
-l'arpège sur chacune des portées, puis de relier la ligne de vaguelettes
-en assignant @emph{vrai} à la propriété @code{connectArpeggios}, par
-exemple dans le contexte @internalsref{PianoStaff} :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \set PianoStaff.connectArpeggios = ##t
-  \new Staff { <c' e g c>\arpeggio }
-  \new Staff { \clef bass <c,, e g>\arpeggio }
->>
-@end lilypond
-
-
-@refcommands
-
-@code{\arpeggio},
-@funindex \arpeggioUp
-@code{\arpeggioUp},
-@funindex \arpeggioDown
-@code{\arpeggioDown},
-@funindex \arpeggioNeutral
-@code{\arpeggioNeutral},
-@funindex \arpeggioBracket
-@code{\arpeggioBracket}.
-
-
-@seealso
-
-Dans ce même manuel : @ref{Ties}, pour noter explicitement des arpèges.
-
-Référence du programme : @internalsref{Arpeggio}.
-
-
-@refbugs
-
-Il est impossible de mêler au même instant, dans un contexte
-@internalsref{PianoStaff}, des lignes d'arpèges connectées et d'autres
-non connectées.
-
-
-@node Falls and doits
-@subsection Falls and doits
-
-Des indications de désinence peuvent être obtenues au moyen de la
-commande @code{\bendAfter} :
-
-@lilypond[fragment,ragged-right,relative=2]
-\override Score.SpacingSpanner #'shortest-duration-space = #3.0
-c4-\bendAfter #+5
-c4-\bendAfter #-3
-@end lilypond
-
-
-@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.
-
-@menu
-* Repeat types::
-* Repeat syntax::
-* Repeats and MIDI::
-* Manual repeat commands::
-* Tremolo repeats::
-* Tremolo subdivisions::
-* Measure repeats::
-@end menu
-
-
-@node Repeat types
-@subsection Repeat types
-
-@cindex reprises et répétitions
-
-On peut indiquer des répétitions des façons suivantes :
-
-@table @code
-@item unfold
-La musique qui doit être répétée sera entièrement imprimée (et jouée).
-Ceci est particulièrement utile dans de la musique répétitive.  Ce type
-de reprise est le seul pris en compte dans le rendu MIDI.
-
-@item volta
-Le passage répété ne sera pas écrit explicitement, mais il sera encadré
-sur la partition par des barres de reprises, et peut se terminer par
-plusieurs fins alternatives, imprimées de gauche à droite sous des
-crochets.  Il s'agit là de la notation courante des reprises avec des
-fins alternatives.  Ces dernières, par défaut, ne sont pas jouées dans
-le rendu MIDI.
-
-@item tremolo
-Pour réaliser des trémolos.  Ceux-ci, par défaut, ne sont pas joués dans
-le rendu MIDI.
-
-@item percent
-Pour répéter des temps ou des mesures, imprimés sous la forme de signes de
-pourcentage.  Ceux-ci, par défaut, ne sont pas joués dans le rendu MIDI.
-Les répétitions indiquées par ces symboles doivent être déclarées dans
-un contexte @code{Voice}.
-
-@end table
-
-
-@node Repeat syntax
-@subsection Repeat syntax
-
-@cindex volta
-@cindex première fois
-@cindex seconde fois
-@funindex \repeat
-
-Tous les différents types de reprise se spécifient dans
-LilyPond avec une même construction syntaxique, qui est :
-
-
-@example
-\repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{expression_à_répéter}
-@end example
-
-On peut ajouter, pour indiquer une fin alternative :
-@funindex \alternative
-@example
-\alternative @{
- @var{alternative1}
- @var{alternative2}
- @var{alternative3}
- @dots{}
-@}
-@end example
-
-@noindent
-chaque @var{alternative} étant une expression musicale.  Si l'on donne
-trop peu d'alternatives en regard du nombre de fois où le passage doit
-être rejoué, la première alternative sera jouée plusieurs fois.
-
-
-Les reprises courantes s'indiquent comme ceci :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
-@end lilypond
-
-Et avec des fins alternatives :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
-@end lilypond
-
-Il est possible de créer des répétitions avec une levée.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 e |
-  \repeat volta 4 { c2 d2 | e2 f2 | }
-  \alternative { { g4 g g e } { a a a a | b2. } }
-}
-@end lilypond
-
-@noindent
-ou
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 
-  \repeat volta 4 { e | c2 d2 | e2 f2 | }
-  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
-}
-@end lilypond
-
-
-
-@funindex \repeatTie
-Des liaisons de tenue peuvent être ajoutées à toute alternative :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
-@end lilypond
-
-
-On peut raccourcir les crochets indiquant les fins alternatives,
-en définissant la propriété @code{voltaSpannerDuration}.  Dans 
-l'exemple suivant, le crochet ne se prolonge que sur une mesure
-à 3/4.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c''{
-  \time 3/4
-  c c c
-  \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
-  \repeat volta 5 { d d d }
-  \alternative { { e e e f f f }
-  { g g g } }
-}
-@end lilypond
-
-Si l'on souhaite à la fois terminer une ligne par une double barre et
-débuter la ligne suivante avec une section reprise, on peut utiliser
-@example
-@dots{} \bar "||:" \break
-\repeat volta 2 @{ @dots{}
-@end example
-
-Consultez @ref{Bar lines} pour plus d'informations.
-
-@seealso
-
-Program reference: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic}, et
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-Examples
-
-Les crochets précédant une reprise s'impriment d'ordinaire seulement
-au-dessus de la portée du haut.  On peut ajuster cela en déplaçant le
-graveur @code{Volta_engraver} vers les contextes de portée
-(@code{Staff}) qui doivent comporter ces crochets ;
-voir @ref{Modifying context plug-ins} et 
-@lsr{repeats,volta@/-multi@/-staff@/.ly}.
-
-
-@refbugs
-
-@cindex reprises ambigües
-
-Des reprises imbriquées telles que
-
-@example
-\repeat @dots{}
-\repeat @dots{}
-\alternative
-@end example
-
-@noindent
-présentent une ambiguïté, dans la mesure où l'on ne sait à quelle
-section @code{\repeat} attribuer la section @code{\alternative}.  Pour
-résoudre cette ambiguïté, il convient de toujours insérer la commande
-@code{\alternative} à l'intérieur de la section @code{\repeat}.  Il est
-préférable, dans une telle situation, d'utiliser des accolades pour plus
-de clarté.
-
-Lorsqu'une alternative commence, les informations de métrique sont
-perdues, il faut donc les rappeler après une reprise, par exemple
-en définissant @code{Score.measurePosition} ou en invoquant la commande
-@code{\partial}.  De même, aucune liaison (de tenue ou autre)
-n'est répétée.
-
-Les crochets qui indiquent les alternatives ne sont pas alignés 
-verticalement.
-
-
-@node Repeats and MIDI
-@subsection Repeats and MIDI
-
-@cindex reprises développées
-@funindex \unfoldRepeats
-
-Au prix de quelques réglages, les reprises de toutes sortes peuvent être
-rendues dans le fichier MIDI.  Il suffit pour cela de recourir à la
-fonction @code{\unfoldRepeats}, qui développe toutes les reprises.  En
-d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
-en reprises de type @code{unfold}.
-
-
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
-  \repeat tremolo 8 {c'32 e' }
-  \repeat percent 2 { c''8 d'' }
-  \repeat volta 2 {c'4 d' e' f'}
-  \alternative {
-    { g' a' a' g' }
-    {f' e' d' c' }
-  }
-}
-\bar "|."
-@end lilypond
-
-
-Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
-MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI, avec
-des reprises explicites, et l'autre pour la partition, avec des reprises
-notées sous forme de barres de reprise, de trémolo ou de symboles de
-pourcentage.  Par exemple
-
-@example
-\score @{
- @var{..musique..}
- \layout @{ ..  @}
-@}
-\score @{
- \unfoldRepeats @var{..musique..}
- \midi @{ ..  @}
-@}
-@end example
-
-
-@node Manual repeat commands
-@subsection Manual repeat commands
-
-@funindex repeatCommands
-
-La propriété @code{repeatCommands} sert à contrôler la mise en forme des
-reprises.  On la définit par une suite de commandes de reprise Scheme.
-
-@table @asis
-@item @code{start-repeat}
-Pour imprimer une barre de reprise @code{|:}
-
-@item @code{end-repeat}
-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}.
-Attention cependant à changer la police, car la police employée par
-défaut pour les chiffres ne contient aucun caractère alphabétique.
-
-@item @code{(volta #f)}
-Pour terminer un crochet indiquant une alternative.
-@end table
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c4
-  \set Score.repeatCommands = #'((volta "93") end-repeat)
-c4 c4
-  \set Score.repeatCommands = #'((volta #f))
-c4 c4
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic}, et
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-@node Tremolo repeats
-@subsection Tremolo repeats
-
-@cindex ligatures de trémolo
-@cindex trémolo, ligatures de
-
-On peut placer une notation de trémolo entre deux notes, avec la
-commande @code{\repeat} suivie du style trémolo :
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
-}
-@end lilypond
-
-
-On peut aussi indiquer un trémolo sur une seule note, qu'il faudra
-alors laisser sans accolades.
-
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
-@end lilypond
-
-
-La subdivision des trémolos aboutit à un résultat semblable : voir
-@ref{Tremolo subdivisions}.
-
-
-@seealso
-
-Dans ce manuel : @ref{Tremolo subdivisions}, @ref{Repeats}.
-
-Référence du programme : @internalsref{Beam}, @internalsref{StemTremolo}.
-
-
-@node Tremolo subdivisions
-@subsection Tremolo subdivisions
-
-@cindex trémolo, indication de
-@funindex tremoloFlags
-
-Un trémolo peut être indiqué sur une seule note, en la faisant suivre
-de deux points et d'un nombre :
-
-@code{note:}[@var{nombre}]. 
-
-Le nombre en question correspond à la valeur de la subdivision ;
-il doit être au moins de 8, auquel cas la hampe sera barrée par un 
-seul trait de ligature.  Si ce nombre est omis, la dernière valeur ---
-telle que mémorisée dans @code{tremoloFlags} --- sera utilisée.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
-@end lilypond
-
-
-@refbugs
-
-Les trémolos entrés de cette manière ne sont pas rendus dans
-le fichier MIDI.
-
-
-@seealso
-
-Dans ce manuel : @ref{Tremolo repeats}.
-
-Référence du programme : @internalsref{StemTremolo}.
-
-
-@node Measure repeats
-@subsection Measure repeats
-
-@cindex percent repeats
-@cindex measure repeats
-
-Le style de @qq{reprise en pourcent} sert à répéter une séquence de
-notes.  Elle sera imprimée une fois, puis remplacée par un symbole
-spécial.  Les séquences d'une ou deux mesures sont remplacées par un
-symbole qui ressemble au symbole de pourcentage, tandis que les
-séquences inférieures à une mesure sont remplacées par une barre
-oblique.  Toutes ces répétitions doivent être déclarées dans un contexte
-@code{Voice}.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Les répétitions de plus de 2 mesures sont surmontées d'un compteur,
-si l'on assigne @emph{vrai} (lettre @q{t}) à la propriété
-@code{countPercentRepeats}.
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat percent 4 { c1 }
-}
-@end lilypond
-
-Des symboles de pourcentage isolés peuvent aussi être obtenus, au
-moyen d'un silence multi-mesures dont on modifie l'aspect :
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
diff --git a/Documentation/fr/user/changing-defaults.itely b/Documentation/fr/user/changing-defaults.itely
index 7b59cba615..063ce4f6d3 100644
--- a/Documentation/fr/user/changing-defaults.itely
+++ b/Documentation/fr/user/changing-defaults.itely
@@ -706,7 +706,7 @@ référence du programme : voir
 @internalsref{Contexts}.
 @end ifhtml
 @ifnothtml
-Translation @arrow{} Context.
+Translation @expansion{} Context.
 @end ifnothtml
 
 @c [TODO: describe propagation]
@@ -975,7 +975,7 @@ propriétés contexte par contexte : voir
 @internalsref{Tunable context properties}.
 @end ifhtml
 @ifnothtml
-Translation @arrow{} Tunable context properties.
+Translation @expansion{} Tunable context properties.
 @end ifnothtml
 
 
@@ -996,14 +996,14 @@ Vous trouverez une description exhaustive de chaque graveur dans
 @internalsref{Engravers}.
 @end ifhtml
 @ifnothtml
-Program reference @arrow Translation @arrow{} Engravers.
+Program reference @expansion Translation @expansion{} Engravers.
 @end ifnothtml
 Chaque contexte mentionné dans
 @ifhtml
 @internalsref{Contexts}
 @end ifhtml
 @ifnothtml
-Program reference @arrow Translation @arrow{} Context.
+Program reference @expansion Translation @expansion{} Context.
 @end ifnothtml
 répertorie les graveurs mis en œuvre.
 
@@ -1056,7 +1056,7 @@ La clé et le chiffre de mesure ont disparu de la deuxième portée.  C'est une
 quelque peu radicale, puisqu'elle affectera toute la portée jusqu'à la fin de la
 partition.  L'espacement s'en trouve également affecté, ce qui peut être ou non
 l'effet recherché.  Une méthode plus sophistiquée aurait été de rendre ces objets
-transparents (voir @ref{Common tweaks}).
+transparents (voir @rlearning{Common tweaks}).
 
 Dans l'exemple suivant, voici une mise en pratique plus utile.  En temps
 normal, les barres de mesure et la métrique sont synchronisées verticalement
@@ -1752,8 +1752,9 @@ propriétés internes).
 
 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
-son âme même, dans les fichiers source de LilyPond (voir @ref{Default files}), en
-l'occurence le fichier @file{scm/@/define@/-grobs@/.scm} :
+son âme même, dans les fichiers source de LilyPond (voir
+@rlearning{Default files}), en l'occurence le fichier
+@file{scm/@/define@/-grobs@/.scm} :
 
 @example
 (Fingering
diff --git a/Documentation/fr/user/chords.itely b/Documentation/fr/user/chords.itely
new file mode 100644
index 0000000000..288efdb166
--- /dev/null
+++ b/Documentation/fr/user/chords.itely
@@ -0,0 +1,395 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Chords Blah
+@section Chords Blah
+
+Intro text.
+
+@menu 
+* TODO chords fix::
+@end menu
+
+@node TODO chords fix
+@subsection TODO chords fix
+
+
+
+@c  awkward name; awkward section name.
+@c  still, the Basic "chords" seems like a good name...  :(
+@node Introducing chord names
+@unnumberedsubsubsec Introducing chord names
+@cindex accords, chiffrage jazz
+
+LilyPond permet de désigner les accords par leur chiffrage jazz.
+S'il est possible d'entrer un accord sous sa forme musicale, avec
+@code{<.. >}, on peut aussi le saisir par son nom.  Le logiciel traite
+les accords comme des ensembles de hauteurs, donc les accords peuvent
+être transposés.
+
+@lilypond[quote,ragged-right,verbatim,ragged-right]
+twoWays = \transpose c c' {
+  \chordmode {
+    c1 f:sus4 bes/f
+  }
+  <c e g>
+  <f bes c'>
+  <f bes d'>
+}
+
+<< \new ChordNames \twoWays
+   \new Voice \twoWays >>
+@end lilypond
+
+Cet exemple montre également que les jeux d'instructions qui permettent
+à LilyPond d'imprimer des accords ne cherchent pas à se montrer
+intelligents.  Ici, le dernier accord n'est pas interprété comme étant
+renversé.
+
+Notez bien que la valeur rythmique des accords doit être indiquée
+@emph{à l'extérieur} des symboles @code{<>}.
+
+@example
+<c e g>2
+@end example
+
+
+@node Chords mode
+@unnumberedsubsubsec Chords mode
+
+Dans le mode accords, introduit par la commande @code{\chordmode}, les
+accords ne sont indiqués que par leur note fondamentale.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { es4. d8 c2 }
+@end lilypond
+
+@cindex saisir des accords
+@cindex mode accords
+
+On peut cependant obtenir des accords différents, en utilisant le
+caractère deux points (@code{:}).
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { e1:m e1:7 e1:m7 }
+@end lilypond
+
+Le nombre accolé à la note fondamentale est considéré comme chiffrage
+jazz de l'accord, qui est de ce fait construit par un empilement de
+tierces. Notez l'exception que constitue @code{c:13} dans lequel la
+onzième est délibérément omise.
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@end lilypond
+
+@cindex note fondamentale
+@cindex notes ajoutées
+@cindex accords incomplets
+
+Des accords encore plus complexes peuvent être élaborés en plusieurs
+étapes séparées.  Ainsi, on peut enrichir l'accord par des notes
+ajoutées, que l'on indique après le chiffrage principal et que l'on
+sépare par des points :
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+@end lilypond
+
+On peut augmenter ou diminuer certains intervalles au moyen des
+signes @code{-} ou @code{+} :
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+@end lilypond
+
+On peut aussi enlever certaines notes de l'accord, en les spécifiant
+après un signe @code{^} --- les notes ajoutées doivent être indiquées
+@emph{avant} les notes à enlever.
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c^3 c:7^5 c:9^3.5 }
+@end lilypond
+
+Voici les différents chiffrages disponibles, en plus des nombres que
+nous venons de voir :
+
+@table @code
+@item m
+Accord mineur.  Ce chiffrage minorise la tierce, et la septième s'il y
+en a une.
+
+@item dim
+Accord diminué.  Ce chiffrage minorise la tierce, diminue la quinte et
+la septième s'il y en a.
+
+@item aug
+Accord augmenté.  Ce chiffrage augmente la quinte.
+
+@item maj
+Accord de septième majeure. Ce chiffrage majorise la septième s'il y
+en a une (dans le cas d'un accord parfait, ce chiffrage est facultatif).
+
+@item sus
+Accord de suspension. Ce chiffrage supprime la tierce, et y ajoute,
+suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
+quarte.
+@end table
+
+Il est bien sûr possible de mélanger ces chiffrages avec des notes ajoutées.
+@lilypond[quote,verbatim,fragment]
+  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+@end lilypond
+
+@cindex chiffrages des accords
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex sus
+@funindex m
+
+Dans la mesure où un accord de treizième majeure ne sonne pas très bien
+avec la onzième, la onzième est enlevée automatiquement, à moins que
+vous ne le spécifiez explicitement.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c:13 c:13.11 c:m13 }
+@end lilypond
+
+@funindex /
+
+Les accords peuvent être renversés ou combinés avec une note étrangère à
+la basse, au moyen de @code{@var{accord}/}@var{note}
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/g c/f }
+@end lilypond
+@funindex /+
+
+Si la note de basse précisée appartient à l'accord, la doublure
+supérieure sera supprimée.  Pour l'éviter, utilisez la syntaxe
+@code{/+}@var{note}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/+g c/+f }
+@end lilypond
+
+Le mode accords est semblable à @code{\lyricmode} ou autre, c'est-à-dire que
+la plupart des commandes sont encore disponibles ; ainsi, @code{r} ou
+@code{\skip} peuvent servir à insérer des silences ou des silences
+invisibles.  De plus, les propriétés des objets peuvent être ajustées
+ou modifiées.
+
+
+
+@refbugs
+
+Aucun nom de note ne peut être indiqué deux fois dans un accord.  Ainsi, 
+dans l'accord suivant, seule la quinte augmentée est prise en compte,
+car elle est indiquée en dernier :
+
+@cindex agrégats
+@lilypond[quote,ragged-right,verbatim,fragment]
+\chordmode { c:5.5-.5+ }
+@end lilypond
+
+
+@node Printing chord names
+@unnumberedsubsubsec Printing chord names
+
+@cindex chiffrages d'accords
+@cindex accords
+
+Les chiffrages d'accords sont liés au contexte
+@internalsref{ChordNames}.  Les accords peuvent être saisis soit au
+moyen de la notation indiquée ci-dessus, soit directement avec les
+symboles @code{<} et @code{>}.
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = {
+  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+}
+<<
+  \new ChordNames \harmonies
+  \new Staff \harmonies
+>>
+@end lilypond
+
+Vous pouvez faire ressortir les chiffrages d'accords en assignant la
+valeur vrai à la propriété @code{chordChanges} dans le contexte
+@internalsref{ChordNames}.  De cette façon, les chiffrages ne sont
+imprimés qu'aux changements d'accord ou en début de ligne.
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = \chordmode {
+  c1:m c:m \break c:m c:m d
+}
+<<
+  \new ChordNames {
+    \set chordChanges = ##t
+    \harmonies }
+  \new Staff \transpose c c' \harmonies
+>>
+@end lilypond
+
+Les exemples précédents montrent des chiffrages placés au-dessus de la
+portée, mais ce n'est pas obligatoire : les accords peuvent également
+être imprimés séparément -- auquel cas vous aurez peut-être besoin
+d'ajouter le @internalsref{Volta_engraver} et le
+@internalsref{Bar_engraver} afin que les éventuelles barres de reprises
+s'affichent correctement.
+
+@lilypond[ragged-right,verbatim]
+\new ChordNames \with {
+  \override BarLine #'bar-size = #4
+  \consists Bar_engraver
+  \consists "Volta_engraver"
+}
+\chordmode { \repeat volta 2 {
+  f1:maj7 f:7 bes:7
+  c:maj7
+} \alternative {
+  es e
+}
+}
+@end lilypond
+
+Le modèle par défaut des chiffrages d'accord est celui de
+Klaus Ignatzek pour le jazz (cf. @ref{Literature list}).  Il s'agit
+d'une notation anglo-saxonne ; cependant vous pouvez 
+indiquer vos chiffrages en notation française au moyen de
+la commande \frenchChords (voir plus bas).
+
+Il est possible de créer votre propre modèle de chiffrages en
+réglant les propriétés suivantes :
+
+@table @code
+@funindex chordNameExceptions
+@item chordNameExceptions
+C'est la liste des accords mis en forme de manière particulière.
+
+Cette liste d'exceptions s'indique de la façon suivante.
+On commence par créer une expression musicale telle que
+@example
+@code{chExceptionMusic} = @{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
+@end example
+puis on la transforme en liste d'exceptions au moyen du code
+@example
+(sequential-music-to-chord-exceptions chExceptionMusic #t)
+@end example
+Pour qu'elles soient effectives, on ajoute ces exceptions aux exceptions
+par défaut définies dans @file{ly/@/chord@/-modifier@/-init@/.ly} :
+@example
+(append
+ (sequential-music-to-chord-exceptions chExceptionMusic #t)
+ ignatzekExceptions)
+@end example
+
+Exemple de manipulation de cette propriété :
+@lsr{chords/,chord@/-name@/-exceptions@/.ly}
+@cindex exceptions, chiffrages d'accords.
+
+
+@funindex majorSevenSymbol
+@item majorSevenSymbol
+Cette propriété définit l'objet employé pour indiquer une septième
+majeure.  Les options prédéfinies sont @code{whiteTriangleMarkup}
+(triangle blanc) et @code{blackTriangleMarkup} (triangle noir).  Voir aussi
+l'exemple @lsr{chords,chord@/-name@/-major7@/.ly}.
+
+@funindex chordNameSeparator
+@item chordNameSeparator
+Les différents termes d'un chiffrage jazz (par exemple les notes de
+l'accord et la basse) sont habituellement séparés par une barre oblique.
+La propriété @code{chordNameSeparator} permet d'indiquer un autre
+séparateur, par exemple
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new ChordNames \chordmode {
+  c:7sus4
+  \set chordNameSeparator
+    = \markup { \typewriter "|" }
+  c:7sus4
+}
+@end lilypond
+
+@funindex chordRootNamer
+@item chordRootNamer
+Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
+est exprimée par une lettre capitale, parfois suivie d'une altération,
+correspondant à la notation anglo-saxonne de la musique.  Cette
+propriété a pour valeur la fonction qui transforme la hauteur de la note
+foncdamentale en nom de note ; c'est donc en assignant une nouvelle
+fonction à cette propriété que l'on peut produire des noms de note
+spéciaux, adaptés par exemple aux systèmes de notation d'autres pays.
+
+@funindex chordNoteNamer
+@item chordNoteNamer
+Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
+les règles utilisées sont par défaut celles définies par la propriété
+@code{chordRootNamer} ci-dessus.  Cependant, la propriété @code{chordNoteNamer}
+permet de régler cet élément indépendamment, par exemple pour imprimer la basse
+en caractères minuscules.
+
+@funindex chordPrefixSpacer
+@item chordPrefixSpacer
+Le petit @q{m} qui indique un accord mineur est, dans la notation anglo-saxonne,
+attaché à la lettre de l'accord. Cependant il est possible d'ajouter un espace
+en assignant la valeur vrai à la propriété @code{chordPrefixSpacer}.  Cet
+espace sera omis si une altération est présente.
+
+@end table
+
+Les propriétés ci-dessus font l'objet de commandes prédéfinies
+adaptées aux notations de différents pays : @code{\germanChords} et
+@code{\semiGermanChords} pour la notation allemande,
+@code{\italianChords} pour la notation italienne et enfin
+@code{\frenchChords} pour la notation française.
+
+@lilypondfile[ragged-right]{chord-names-languages.ly}
+
+LilyPond intègre également deux autres modèles de chiffrages : une
+notation Jazz alternative, et un modèle systématique appelé système
+Banter.  Voir @ref{Chord name chart} et @lsr{chords,chord-names-jazz.ly}
+pour la mise en œuvre de ces modèles.
+
+@cindex Banter
+@cindex jazz, chiffrages d'accords
+@cindex accords jazz, chiffrage
+
+
+@refcommands
+
+@funindex \germanChords
+@code{\germanChords},
+@funindex \semiGermanChords
+@code{\semiGermanChords}.
+@funindex \italianChords
+@code{\italianChords}.
+@funindex \frenchChords
+@code{\frenchChords}.
+
+
+@seealso
+
+Exemples :
+@lsrdir{chords}
+
+Fichiers internes : @file{scm/@/chords@/-ignatzek@/.scm}, et
+@file{scm/@/chord@/-entry@/.scm}.
+
+
+@refbugs
+
+Les chiffrages d'accords ne sont déterminés que par la succession des
+hauteurs de notes.  En d'autres termes, les accords inversés ne sont pas
+reconnus, ni les notes ajoutées à la basse.  C'est pourquoi les accords
+saisis au moyen de la syntaxe @code{<.. >} peuvent produire des
+chiffrages étranges.
+
+
diff --git a/Documentation/fr/user/educational.itely b/Documentation/fr/user/educational.itely
new file mode 100644
index 0000000000..053819e149
--- /dev/null
+++ b/Documentation/fr/user/educational.itely
@@ -0,0 +1,667 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Educational use
+@section Educational use
+
+@menu
+* Note heads::                  
+* Inside the staff::            
+* Outside the staff::           
+@end menu
+
+
+@node Note heads
+@subsection Note heads
+
+@menu
+* Easy notation note heads::    
+* Shape note heads::            
+* Improvisation::               
+* Special noteheads::           
+@end menu
+
+@node Easy Notation note heads
+@unnumberedsubsubsec Easy Notation note heads
+
+@cindex tête de note, apprentissage
+@cindex notation facile
+@cindex Hal Leonard
+
+Les notes @q{easy play} comportent le nom de la note à l'intérieur de
+la tête.  On l'utilise dans des partitions pour débutants.
+
+@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
+  \setEasyHeads
+  c'2 e'4 f' | g'1
+@end lilypond
+
+La commande @code{\setEasyHeads} remplace tous les réglages de l'objet
+@internalsref{NoteHead}.  L'impression doit être de plus grande
+taille, afin que les lettres soient lisibles.  Voir à ce propos
+@ref{Setting the staff size}.
+
+@refcommands
+
+@funindex \setEasyHeads
+@code{\setEasyHeads}
+
+
+@node Shape note heads
+@unnumberedsubsubsec Shape note heads
+
+@cindex tête de note, allure
+
+En notation profilée, le profil d'une tête de note correspond à la
+fonction harmonique de cette note dans la gamme.  Ce style de notation
+était très en vogue dans les recueils de chansons américains du XIXe
+siècle. 
+
+Des notes profilées sont produites après activation de
+@code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
+
+@lilypond[verbatim,relative=1,fragment]
+  \aikenHeads
+  c8 d4 e8 a2 g1
+  \sacredHarpHeads
+  c8 d4. e8 a2 g1
+@end lilypond
+
+Les profils sont déterminés par la hauteur dans la gamme, le premier
+degré étant défini par la commande @code{\key}. 
+
+@funindex \key
+@funindex shapeNoteStyles
+@funindex \aikenHeads
+@funindex \sacredHarpHeads
+
+Les notes profilées sont mises en œuvre par la propriété
+@code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
+de symboles.  Le n-ième élément indique le style à utiliser pour le
+n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
+
+@lilypond[verbatim,relative=1,fragment]
+  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
+  c8 d4. e8 a2 g1
+@end lilypond
+
+
+@node Improvisation
+@unnumberedsubsubsec Improvisation
+
+L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
+allongée (@emph{slash}).  Ces têtes de notes sont créées  par
+l'adjonction du graveur @internalsref{Pitch_squash_engraver} au
+contexte @internalsref{Voice}, de telle sorte que la commande
+
+@example
+\set squashedPosition = #0
+\override NoteHead #'style = #'slash
+@end example
+
+@noindent
+active les notes penchées.
+
+Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
+@code{\improvisationOff} pour cette séquence, comme l'illustre
+l'exemple ci dessous.
+
+@lilypond[verbatim,ragged-right,quote]
+\new Voice \with {
+  \consists Pitch_squash_engraver
+} \transpose c c' {
+  e8 e g a a16(bes)(a8) g \improvisationOn
+  e8
+  ~e2~e8 f4 fis8
+  ~fis2 \improvisationOff a16(bes) a8 g e
+}
+@end lilypond
+
+
+@node Special noteheads
+@unnumberedsubsubsec Special noteheads
+
+@cindex têtes de note, spéciales
+
+Certains instruments utilisent des têtes de note différentes à des
+fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
+notes étouffées des guitares ; des losanges pour les harmoniques des
+cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
+losange ; pour les autres styles de tête, il vous faudra jouer avec la
+propriété @code{NoteHead}.
+
+@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
+c4 d
+\override NoteHead #'style = #'cross
+e f
+\revert NoteHead #'style
+e d <c f\harmonic> <d a'\harmonic>
+@end lilypond
+
+@noindent
+Pour une liste exhaustive des styles de tête de note, consultez 
+@ref{Note head styles}.
+
+
+@seealso
+
+Référence du programme : @internalsref{NoteHead}.
+
+
+@node Inside the staff
+@subsection Inside the staff
+
+
+@menu
+* Selecting notation font size::  
+* Fingering instructions::      
+* Hidden notes::                
+* Coloring objects::            
+* Parentheses::                 
+* Ambitus::                     
+* Stems::                       
+@end menu
+
+@node Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
+
+Le plus sûr moyen de régler la taille de la police, quelque soit le
+contexte, consiste à définir la propriété @code{fontSize}.
+
+@lilypond[quote,fragment,relative=1,verbatim]
+c8
+\set fontSize = #-4
+c f
+\set fontSize = #3
+g
+@end lilypond
+
+@noindent
+Ceci ne modifiera en rien la taille des différents symboles tels que
+ligatures ou liaisons.
+
+En interne, la propriété @code{fontSize} d'un contexte aura pour effet
+de définir la propriété @code{font-size} pour tous les objets de
+rendu.  La valeur de @code{font-size} est un entier représentant la
+taille proportionnellement à la hauteur standard de la portée en
+cours.  Chaque incrément correspond à une augmentation d'environ
+12@tie{}% de la taille de la police. Un pas de six aboutit exactement
+au doublement de la taille.  La fonction Scheme @code{magstep}
+convertit le nombre affecté à @code{font-size} en facteur d'échelle.
+Vous pouvez aussi définir directement la propriété @code{font-size} de
+manière à n'affecter seulement que certains objets de rendu.
+
+@lilypond[quote,fragment,relative=1,verbatim]
+c8
+\override NoteHead #'font-size = #-4
+c f
+\override NoteHead #'font-size = #3
+g
+@end lilypond
+
+Pour changer la taille des symboles musicaux (police Feta), LilyPond met
+à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
+cf. @ref{Setting the staff size}.  La taille standard, pour laquelle
+@code{font-size} vaut 0, dépend de la hauteur de la portée.  À une
+portée de 20 points correspond une police de 10 points.
+
+La propriété @code{font-size} ne peut intervenir que pour les objets
+qui utilisent des polices, autrement dit ceux qui disposent de
+l'interface de rendu @internalsref{font-interface}.
+
+@refcommands
+
+Les commandes suivantes définissent @code{fontSize} pour la voix en
+cours :
+
+@funindex \tiny
+@code{\tiny},
+@funindex \small
+@code{\small},
+@funindex \normalsize
+@code{\normalsize}.
+
+
+
+@node Fingering instructions
+@unnumberedsubsubsec Fingering instructions
+
+@cindex doigté
+@cindex substitution de doigt
+
+
+Les doigtés peuvent être indiqués comme suit :
+@example
+@var{note}-@var{chiffre_du_doigt}
+@end example
+Pour les substitutions de doigts, on a recours à une indication
+textuelle (commande @code{\markup}) de doigté
+(commande @code{\finger}).
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+c4-1 c-2 c-3 c-4
+c^\markup { \finger "2 - 3" }
+@end lilypond
+
+
+La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
+dans une partition de violoncelle, si une note doit être jouée avec le
+pouce (@q{thumb} en anglais).
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+<a_\thumb a'-3>8 <b_\thumb b'-3>
+@end lilypond
+
+
+Les doigtés des accords peuvent être saisis note par note,
+en les indiquant après chaque hauteur de note.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+< c-1 e-2 g-3 b-5 >4
+@end lilypond
+
+
+@commonprop
+
+On peut contrôler précisément les doigtés des accords en réglant
+la propriété @code{fingeringOrientations}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+\set fingeringOrientations = #'(left down)
+<c-1 es-2 g-4 bes-5 > 4
+\set fingeringOrientations = #'(up right down)
+<c-1 es-2 g-4 bes-5 > 4
+@end lilypond
+
+
+Cette propriété permet également, dans de la musique monophonique,
+d'indiquer des doigtés très proches des têtes de notes.
+
+@lilypond[verbatim,ragged-right,quote,fragment]
+\set fingeringOrientations = #'(right)
+<es'-2>4
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Fingering}.
+
+D'autres exemples : @lsr{expressive,fingering-chords.ly}.
+
+
+@node Hidden notes
+@unnumberedsubsubsec Hidden notes
+
+@cindex Masquées, notes
+@cindex Invisibles, notes
+@cindex Transparentes, notes
+
+@funindex \hideNotes
+@funindex \unHideNotes
+Les notes masquées --- ou invisibles ou encore transparentes --- sont
+utiles dans le cadre d'exercices de théorie ou de composition.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+c4 d4
+\hideNotes
+e4 f4
+\unHideNotes
+g4 a
+@end lilypond
+
+
+@node Coloring objects
+@unnumberedsubsubsec Coloring objects
+
+Des objets peuvent être colorisés individuellement.  Une listes des
+noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\override NoteHead #'color = #red
+c4 c
+\override NoteHead #'color = #(x11-color 'LimeGreen)
+d
+\override Stem #'color = #blue
+e
+@end lilypond
+
+L'intégralité de la palette des couleurs définies pour X11 est
+accessible par la fonction Scheme x11-color.  Cette fonction prend
+en argument une expression symbolique
+
+@example
+\override Beam #'color = #(x11-color 'MediumTurquoise)
+@end example
+
+ou une chaîne de caractères
+
+@example
+\override Beam #'color = #(x11-color "MediumTurquoise")
+@end example
+
+La première formulation est à la fois plus rapide à écrire et aussi
+plus efficace.  Néanmoins, la deuxième forme permet d'accéder aux noms
+composés des couleurs de X11.
+
+@example
+\override Beam #'color = #(x11-color "medium turquoise")
+@end example
+
+Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
+revient à la couleur par défaut, le noir.  Le problème ressort de
+façon évidente au vu de la partition finale.
+
+L'exemple suivant illustre l'utilisation de la fonction
+@code{x11-color}.  Notez que, après avoir été définie à (x11-color
+'Boggle), la couleur des hampes repasse au noir.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
+  \time 2/4
+  gis''8 a''
+  \override Beam #'color = #(x11-color "medium turquoise")
+  gis'' a''
+  \override NoteHead #'color = #(x11-color "LimeGreen")
+  gis'' a''
+  \override Stem #'color = #(x11-color 'Boggle)
+  gis'' a''
+}
+@end lilypond
+
+
+@seealso
+
+Annexes : @ref{List of colors}.
+
+
+@refbugs
+Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
+internet.  Aussi nous vous recommandons, dans le cadre d'une
+présentation multimedia, d'utiliser des couleurs de base.
+
+Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
+normale ayant un nom similaire.
+
+Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
+@code{\override}. si besoin est, utilisez @code{\tweak}.  
+Pour plus de détails, consultez @ref{Objects connected to the input}.
+
+
+@node Parentheses
+@unnumberedsubsubsec Parentheses
+
+@cindex fantômes, notes
+@cindex notes fantômes
+@cindex parenthèses, notes entre
+
+Des objets peuvent être mis entre parenthèses en saisissant
+@code{\parenthesize} juste avant l'événement musical.
+
+@lilypond[relative=2,fragment,verbatim,ragged-right]
+<
+  c
+  \parenthesize d
+  g
+>4-\parenthesize -.
+@end lilypond
+
+Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
+comprendre qu'une seule note.
+
+@example
+< \parenthesize NOTE>
+@end example
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
+partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
+est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
+partitions vocales, afin que les exécutants puissent voir au premier
+coup d'oeil s'ils sont en mesure de tenir la partie en question.
+
+Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
+représentant la hauteur la plus basse et la plus haute.  Pour imprimer
+cet ambitus, il faut ajouter le graveur @internalsref{Ambitus_engraver}
+au contexte @internalsref{Voice}.  Ainsi,
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+@noindent
+donne pour résultat
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \consists Ambitus_engraver
+  }
+}
+
+\relative \new Staff {
+  as'' c e2 cis,2
+}
+@end lilypond
+
+Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
+graveur @internalsref{Ambitus_engraver} au contexte @internalsref{Staff}
+plutôt qu'au contexte @internalsref{Voice} ; l'ambitus affiché sera
+alors celui de toutes les voix cumulées, non d'une seule des voix
+actives.
+
+@lilypond[verbatim,ragged-right,quote]
+\new Staff \with {
+  \consists "Ambitus_engraver"
+}
+<<
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c'' {
+    \override Ambitus #'X-offset = #-1.0
+    \voiceOne
+    c4 a d e f2
+  }
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c' {
+    \voiceTwo
+    es4 f g as b2
+  }
+>>
+@end lilypond
+
+@noindent
+Cet exemple met en œuvre une fonctionnalité avancée :
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@noindent
+Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
+être obtenu avec @code{extra-offset}, mais alors le système de mise en
+forme n'aurait pas attribué d'espace supplémentaire pour l'objet
+déplacé.
+
+@seealso
+
+Référence du programme : @internalsref{Ambitus},
+@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
+@internalsref{AmbitusAccidental}.
+
+Exemples :
+@lsr{vocal,ambitus@/.ly}.
+
+@refbugs
+
+LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
+une même portée.
+
+
+@node Stems
+@unnumberedsubsubsec Stems
+
+Dès qu'une note est rencontrée, un objet @internalsref{Stem} se crée
+automatiquement.  Pour les rondes et les silences, ils sont aussi
+créés, mais en mode invisible.
+
+@refcommands
+
+@funindex \stemUp
+@code{\stemUp},
+@funindex \stemDown
+@code{\stemDown},
+@funindex \stemNeutral
+@code{\stemNeutral}.
+
+
+@commonprop
+
+Pour changer la direction des hampes au milieu de la portée, utilisez
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+a4 b c b
+\override Stem #'neutral-direction = #up
+a4 b c b
+\override Stem #'neutral-direction = #down
+a4 b c b
+@end lilypond
+
+
+@node Outside the staff
+@subsection Outside the staff
+
+
+@menu
+* Balloon help::                
+* Grid lines::                  
+* Blank music sheet::           
+@end menu
+
+@node Balloon help
+@subsection Balloon help
+
+Vous pouvez marquer et nommer des éléments de notation à l'aide de
+bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
+notation. 
+
+En voici un exemple :
+@c KEEP LY
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+  \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
+  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
+}
+@end lilypond
+
+@noindent
+Vous disposez de deux fonctions musicales, @code{balloonText} et
+@code{balloonGrobText}.  @code{balloonGrobText} prend en argument
+l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
+comme une simple articulation.  Les autres arguments sont le décalage
+et le texte de la bulle.
+
+@cindex bulles
+@cindex notation, expliquer
+
+@seealso
+
+Référence du programme : @internalsref{text-balloon-interface}.
+
+
+@node Grid lines
+@subsection Grid lines
+
+Vous pouvez tracer des lignes entre les portées, synchronisées avec
+les notes.
+@c KEEP LY
+@lilypond[ragged-right,quote,verbatim]
+\layout {
+  \context {
+    \Staff
+    \consists "Grid_point_engraver" %% active les guides
+    gridInterval = #(ly:make-moment 1 4)
+  }
+}
+
+\new Score \with {
+  \consists "Grid_line_span_engraver"
+  %% centre les lignes guides horizontalement sous les notes
+  \override NoteColumn #'X-offset = #-0.5
+}
+
+\new ChoirStaff <<
+  \new Staff {
+    \stemUp
+    \relative {
+      c'4. d8 e8 f g4
+    }
+  }
+  \new Staff {
+    %% centre les lignes guides verticalement
+    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
+    \stemDown
+    \clef bass
+    \relative c {
+      c4  g'  f  e
+    }
+  }
+>>
+@end lilypond
+
+Exemples : @lsrdir{education}
+
+
+@node Blank music sheet
+@subsection Blank music sheet
+
+@cindex Papier musique
+@cindex Portées, feuille blanche
+
+Une feuille de papier musique s'obtient en utilisant des notes
+invisibles, et en invalidant le @code{Bar_number_engraver}.
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+\layout{ indent = #0 }
+emptymusic = {
+  \repeat unfold 2 % À modifier pour plus de lignes.
+  { s1\break }
+  \bar "|."
+}
+\new Score \with {
+  \override TimeSignature #'transparent = ##t
+% décommenter la  ligne suivante selon besoin
+%  \override Clef #'transparent = ##t
+  defaultBarType = #""
+  \remove Bar_number_engraver
+} <<
+
+% à adapter selon les portées désirées
+  \new Staff \emptymusic
+  \new TabStaff \emptymusic
+>>
+@end lilypond
+
+
diff --git a/Documentation/fr/user/expressive.itely b/Documentation/fr/user/expressive.itely
new file mode 100644
index 0000000000..f93caa44e5
--- /dev/null
+++ b/Documentation/fr/user/expressive.itely
@@ -0,0 +1,832 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Expressive marks
+@section Expressive marks
+
+@menu
+* Attached to notes::           
+* Curves::                      
+* Lines::                       
+@end menu
+
+
+@node Attached to notes
+@subsection Attached to notes
+
+
+@menu
+* Articulations::               
+* Dynamics::                    
+@end menu
+
+@node Articulations
+@unnumberedsubsubsec Articulations
+
+@cindex articulations
+@cindex symboles d'ornementation
+@cindex ornementations, symboles
+
+
+Différents symboles peuvent être ajoutés au-dessus ou au-dessous des
+notes pour indiquer des ponctuations ou des modes de jeu différents.
+On les ajoute à chaque note au moyen d'un tiret suivi du caractère
+correspondant à l'articulation désirée.  En voici une démonstration :
+
+@c @l ilypondfile[quote,ragged-right]{script-abbreviations.ly}
+
+Il est possible de changer la signification de ces raccourcis : voir des
+exemples dans @file{ly/@/script@/-init@/.ly}.
+
+Même si LilyPond place automatiquement ces symboles, il est possible de
+l'obliger à les placer au-dessus ou en-dessous de la note, tout comme
+d'autres objets, en utilisant respectivement @code{^} et @code{_}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c''4^^ c''4_^
+@end lilypond
+
+On peut ajouter d'autres symboles, avec la syntaxe
+@var{note}@code{\}@var{symbole}.  Ici encore, on peut forcer leur
+orientation avec @code{^} and @code{_}.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c\fermata c^\fermata c_\fermata
+@end lilypond
+
+@cindex accent
+@cindex marcato
+@cindex staccatissimo
+@cindex espressivo
+@cindex point d'orgue
+@cindex point d'arrêt
+@cindex staccato
+@cindex portato
+@cindex tenuto
+@cindex tirer l'archet
+@cindex pousser l'archet
+@cindex bouché
+@cindex sourdine
+@cindex orgue, marque de pédale d'
+@cindex grupetto
+@cindex ouvert
+@cindex flageolet
+@cindex trille
+@cindex mordant
+@cindex ornementation baroque
+@cindex baroque, ornementation
+@cindex pouce
+@cindex segno
+@cindex coda
+@cindex varcoda
+
+
+Voici la liste exhaustive des symboles :
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+@commonprop
+
+Les symboles s'ordonnent verticalement suivant la propriété
+@code{script-priority}. Plus sa valeur numérique est faible, plus le
+symbole sera proche de la note. Dans l'exemple suivant, l'objet
+@internalsref{TextScript} --- le dièse --- a d'abord la propriété la
+plus basse, et il est donc placé plus près de la note ; ensuite c'est
+l'objet @internalsref{Script} qui a la propriété la plus basse, et il se
+place alors sous le dièse.  Lorsque deux objets ont la même priorité,
+c'est l'ordre dans lequel ils sont indiqués qui détermine lequel sera
+placé en premier.
+
+@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
+\once \override TextScript #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+
+\once \override Script #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Script}.
+
+
+@refbugs
+
+Ces symboles sont présents sur la partition imprimée, mais
+n'ont pas d'effet sur le rendu de la musique en MIDI.
+
+
+@node Dynamics
+@unnumberedsubsubsec Dynamics
+
+@cindex nuances
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
+
+À chaque nuance absolue correspond une commande, qui peut être indiquée
+après une note : @code{c4\ff} par exemple.  Les commandes de nuances
+disponibles sont @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp},
+@code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
+@code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
+@code{\spp}, @code{\sfz}, et @code{\rfz}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
+c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
+@end lilypond
+
+@funindex \<
+@funindex \>
+@funindex \!
+
+Un crescendo est délimité par @code{\<} et @code{\!}, ou peut se
+terminer par une commande de nuance.  Au lieu de @code{\<}
+ou @code{\>}, on peut aussi utiliser @code{\cr} et @code{\decr}.
+Ces indications sont attachées aux notes ; aussi si l'on veut
+faire se succéder plusieurs nuances pendant une note tenue, il faudra
+avoir recours à des silences invisibles :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\< c\! d\> e\!
+<< f1 { s4 s4\< s4\! \> s4\! } >>
+@end lilypond
+
+@noindent
+En principe, un soufflet --- (de)crescendo imprimé sous forme graphique --
+commence au bord gauche de la note de départ, et se termine au
+bord droit de la note d'arrivée.  Cependant, si la note d'arrivée
+est sur un premier temps, le soufflet s'arrêtera au niveau de la
+barre de mesure qui la précède.  Ce comportement peut être annulé
+en assignant @emph{faux} (lettre @q{f}) à la propriété
+@code{hairpinToBarline} :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set hairpinToBarline = ##f
+c4\< c2. c4\!
+@end lilypond
+
+On peut avoir recours à l'indication @code{\espressivo} pour indiquer un
+crescendo puis un decrescendo sur une seule note.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c2 b4 a g1\espressivo
+@end lilypond
+
+Cependant, ces deux indications graphiques peuvent se trouver très
+comprimées horizontalement.  Pour les rallonger, on peut modifier la
+propriété @code{minimum-length} de
+@code{Voice.Hairpin} --- @internalsref{Voice}
+étant le contexte, et @internalsref{Hairpin} l'objet affecté. Par
+exemple :
+
+@example
+\override Voice.Hairpin #'minimum-length = #5
+@end example
+
+@cindex al niente
+@cindex niente, al
+
+Des crescendos ou decrescendos @emph{al niente} peuvent être indiqués de
+manière graphique, en assignant @emph{vrai} (lettre @q{t}) à la
+propriété @code{circled-tip}, ce qui affiche un cercle à leur extrémité.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
+@cindex crescendo
+@cindex decrescendo
+@cindex diminuendo
+
+Au lieu d'une notation graphique des crescendos, on peut utiliser
+une notation textuelle.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\setTextCresc
+c\< d e f\!
+\setHairpinCresc
+e\> d c b\!
+\setTextDecresc
+c\> d e f\!
+\setTextDim
+e\> d c b\!
+@end lilypond
+
+On peut même définir ses propres indications textuelles :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\set crescendoText = \markup { \italic "cresc. poco" }
+\set crescendoSpanner = #'dashed-line
+a'2\< a a a\!\mf
+@end lilypond
+
+Pour créer des indications de nuances qui restent alignées
+avec les nuances habituelles, voir @ref{New dynamic marks}.
+
+Le positionnement vertical des nuances est géré par le
+@internalsref{DynamicLineSpanner}.
+
+
+@commonprop
+
+Des nuances différentes situées --- ou commençant --- sur une même
+note seront alignées verticalement.  Pour aligner des nuances qui ne
+se situeraient pas sur une même note, il est possible d'augmenter
+la propriété @code{staff-padding}.
+
+@example
+\override DynamicLineSpanner #'staff-padding = #4
+@end example
+
+Cette propriété peut aussi servir à régler des problèmes de
+collision entre des nuances et d'autres objets.
+
+Les crescendos ou decrescendos qui aboutissent sur la première note
+d'une nouvelle ligne ne sont imprimés que jusqu'à la fin de la ligne
+précédente.  Ce comportement peut être outrepassé en définissant :
+
+@example
+\override Score.Hairpin #'after-line-breaking = ##t
+@end example
+
+
+Les crescendos et decrescendos indiqués textuellement --- tels que
+@emph{cresc.} ou @emph{dim.} --- sont suivis de pointillés qui montrent
+leur étendue.  On peut empêcher l'impression de ces pointillés avec :
+
+@example
+\override DynamicTextSpanner #'dash-period = #-1.0
+@end example
+
+
+@refcommands
+
+@funindex \dynamicUp
+@code{\dynamicUp},
+@funindex \dynamicDown
+@code{\dynamicDown},
+@funindex \dynamicNeutral
+@code{\dynamicNeutral}.
+
+
+@seealso
+
+Référence du programme : @internalsref{DynamicText}, @internalsref{Hairpin}.
+
+Le placement vertical de ces éléments graphiques est géré par le
+@internalsref{DynamicLineSpanner}.
+
+
+@node Curves
+@subsection Curves
+
+@menu
+* Ties::                        
+* Slurs::                       
+* Phrasing slurs::              
+* Laissez vibrer ties::         
+* Breath marks::                
+* Falls and doits::             
+@end menu
+
+@node Ties
+@unnumberedsubsubsec Ties
+
+@cindex liaison de prolongation
+@funindex ~
+
+Une liaison de tenue (ou de prolongation) relie deux notes adjacentes de
+même hauteur.  Dans les faits, elle prolonge la durée d'une note, et ne
+doit donc pas être confondue avec les liaisons d'articulation ou de
+phrasé.  Une liaison de tenue est indiquée au moyen d'un tilde @samp{~}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+e' ~ e' <c' e' g'> ~ <c' e' g'>
+@end lilypond
+
+
+Quand une liaison de tenue se trouve entre deux accords, toutes les
+notes de même hauteur entre ces deux accords sont reliées.  S'il n'y en
+a aucune, aucune liaison n'est créée.  Il est également possible de lier
+partiellement deux accords, en mettant les liaisons à l'intérieur des
+accords.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+<c~ e g~ b> <c e g b>
+@end lilypond
+
+
+Une liaison de tenue est un moyen parmi d'autres pour prolonger la durée
+d'une note, tout comme les points.  L'exemple suivant montre deux
+manières de matérialiser exactement la même idée :
+
+
+@lilypond[quote,fragment,ragged-right]
+\time 3/4 c'2. c'2 ~ c'4
+@end lilypond
+
+@noindent
+Les liaisons de tenues sont utilisées soit lorsque la note dépasse de la
+mesure, soit quand les points ne suffisent pas à donner la bonne durée.
+Lorsque l'on utilise ces liaisons, les valeurs rythmiques les plus
+longues doivent s'aligner sur les subidivisions de la mesure, comme ici :
+
+@c KEEP LY
+@lilypond[fragment,quote,ragged-right]
+\relative {
+  r8^"oui" c8 ~ c2 r4 | r8^"non" c2 ~ c8 r4
+}
+@end lilypond
+
+
+Lorsque l'on doit lier de nombreuses notes sur plusieurs mesures, il
+devient plus facile d'avoir recours à la division automatique des notes
+--- voir @ref{Automatic note splitting}.  Ce procédé divise
+automatiquement les notes trop longues, et les lie par-delà les barres
+de mesure.
+
+@funindex \repeatTie
+
+Lorsqu'une mesure de seconde fois après une reprise commence sur une
+note liée, la liaison doit être répétée. C'est à cela que sert la
+commande @code{\repeatTie} :
+
+@lilypond[fragment,quote,ragged-right,relative=2]
+r <c e g>\repeatTie
+@end lilypond
+
+@cindex liaison de prolongation, répétition
+@cindex reprises avec alternatives et liaisons de prolongation
+
+@commonprop
+
+Les liaisons de tenue servent parfois à rendre un accord arpégé. Dans ce
+cas, les notes liées ne sont pas toutes consécutives. Il faut alors
+assigner à la propriété @code{tieWaitForNote} la valeur @emph{vrai}
+(@q{t} pour @q{true}).  Cette même méthode peut servir, par exemple, à
+lier un trémolo à un accord.
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+\set tieWaitForNote = ##t
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat tremolo 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
+@end lilypond
+
+Il est possible de graver manuellement les liaisons de tenue, en
+modifiant la propriété @code{tie-configuration}.  Pour chaque paire, le
+premier nombre indique la distance à la portée, en espaces de portée, et
+le second la direction (1 pour haut, @minus{}1 pour bas).
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+<c e g>2~ <c e g> |
+\override TieColumn #'tie-configuration =
+  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
+<c e g>~ <c e g> |
+@end lilypond
+
+
+@refcommands
+
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
+
+
+@seealso
+
+Dans ce même manuel : @ref{Automatic note splitting}.
+
+Référence du programme : @internalsref{Tie}.
+
+
+@refbugs
+
+Un changement de portée, lorsqu'une liaison de tenue est active, ne
+peut produire une liaison oblique.
+
+Le changement de clé ou d'octave pendant une liaison de tenue produit un
+résultat indéfini.  Dans ces cas-là, il est préférable d'utiliser un
+legato.
+
+
+@node Slurs
+@unnumberedsubsubsec Slurs
+
+@cindex legato
+@cindex liaison d'articulation
+
+Une liaison d'articulation indique que les notes doivent être jouées
+liées, ou @emph{legato}.  Ces liaisons s'indiquent au moyen de
+parenthèses.
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+f( g a) a8 b( a4 g2 f4)
+<c e>2( <b d>2)
+@end lilypond
+
+
+On peut indiquer l'orientation des liaisons suivantes avec
+@code{\slur@emph{DIR}}, @code{@emph{DIR}} pouvant être @code{Up} pour
+une liaison vers le haut, @code{Down} pour une liaison vers le bas, ou
+@code{Neutral} pour laisser LilyPond décider.
+
+Il existe également un raccourci pratique pour forcer l'orientation
+d'une seule liaison.  Il suffit pour cela d'ajouter @code{_} ou @code{^}
+avant d'ouvrir une parenthèse.
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_( c) c^( c)
+@end lilypond
+
+
+Une seule liaison d'articulation peut être imprimée à la fois.  S'il est
+nécessaire d'imprimer une liaison plus longue, englobant des liaisons
+plus courtes, utilisez des @ref{Phrasing slurs}.
+
+
+@commonprop
+
+Certains auteurs utilisent deux liaisons lorsqu'ils veulent
+lier des accords. Dans LilyPond, il faut pour cela assigner
+@emph{vrai} (@q{true}) la propriété @code{doubleSlurs} :
+
+@lilypond[verbatim,ragged-right,relative,fragment,quote]
+\set doubleSlurs = ##t
+<c e>4 ( <d f> <c e> <d f> )
+@end lilypond
+
+
+@refcommands
+
+@funindex \slurUp
+@code{\slurUp},
+@funindex \slurDown
+@code{\slurDown},
+@funindex \slurNeutral
+@code{\slurNeutral},
+@funindex \slurDashed
+@code{\slurDashed},
+@funindex \slurDotted
+@code{\slurDotted},
+@funindex \slurSolid
+@code{\slurSolid}.
+
+@seealso
+
+Référence du programme : @internalsref{Slur}.
+
+
+@node Phrasing slurs
+@unnumberedsubsubsec Phrasing slurs
+
+@cindex liaisons de phrasé
+@cindex phrasé, liaisons de
+
+Une liaison de phrasé relie plusieurs notes en délimitant une phrase
+musicale.  On indique les points de départ et d'arrivée avec @code{\(}
+et @code{\)} respectivement.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+\time 6/4 c'\( d( e) f( e) d\)
+@end lilypond
+
+
+D'un point de vue typographique, rien ne distingue une liaison de phrasé
+d'une liaison d'articulation. Cependant, LilyPond les considère comme
+des objets différents. Une commande @code{\slurUp} n'affectera donc pas
+une liaison de phrasé : il faut plutôt utiliser @code{\phrasingSlurUp},
+@code{\phrasingSlurDown} ou @code{\phrasingSlurNeutral}.
+
+Il n'est pas possible d'avoir plusieurs liaisons de phrasé en même temps.
+
+
+@refcommands
+
+@funindex \phrasingSlurUp
+@code{\phrasingSlurUp},
+@funindex \phrasingSlurDown
+@code{\phrasingSlurDown},
+@funindex \phrasingSlurNeutral
+@code{\phrasingSlurNeutral}.
+
+
+@seealso
+
+Référence du programme : @internalsref{PhrasingSlur}.
+
+
+@node Laissez vibrer ties
+@unnumberedsubsubsec Laissez vibrer ties
+
+@cindex laissez vibrer
+@cindex liaison, laissez vibrer
+
+Les liaisons @qq{Laissez vibrer} (L.V.) sont utilisées pour le piano, la
+harpe, et certains instruments de percussion.  Elles indiquent à
+l'instrumentiste de laisser sonner la note ou l'accord au lieu de
+l'étouffer.  Cet effet s'obtient avec la commande @code{\laissezVibrer}.
+
+@lilypond[fragment,ragged-right,verbatim,relative=1]
+<c f g>\laissezVibrer
+@end lilypond
+
+@seealso
+
+Référence du programme :
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+D'autres exemples :
+@lsr{connecting,laissez-vibrer-ties.ly}
+
+
+@node Breath marks
+@unnumberedsubsubsec Breath marks
+
+Les indications de respiration sont indiquées par la commande @code{\breathe}.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c'4 \breathe d4
+@end lilypond
+
+
+@commonprop
+
+On peut choisir le glyphe imprimé par cette commande, en modifiant la
+propriété @code{text} de l'objet @code{BreathingSign}, pour lui affecter
+n'importe quelle indication textuelle.  Par exemple :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+c'4
+\override BreathingSign #'text
+  = #(make-musicglyph-markup "scripts.rvarcomma")
+\breathe
+d4
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{BreathingSign}.
+
+Exemples : @lsr{expressive,breathing-sign.ly}
+
+
+@node Falls and doits
+@unnumberedsubsubsec Falls and doits
+
+Des indications de désinence peuvent être obtenues au moyen de la
+commande @code{\bendAfter} :
+
+@lilypond[fragment,ragged-right,relative=2]
+\override Score.SpacingSpanner #'shortest-duration-space = #3.0
+c4-\bendAfter #+5
+c4-\bendAfter #-3
+@end lilypond
+
+
+@node Lines
+@subsection Lines
+
+@menu
+* Glissando::                   
+* Arpeggio::                    
+* Trills::                      
+* Analysis brackets::           
+@end menu
+
+@node Glissando
+@unnumberedsubsubsec Glissando
+
+@cindex glissando
+@funindex \glissando
+
+Un glissando relie une hauteur à une autre en passant par chaque hauteur
+intermédiaire.  Il est indiqué graphiquement, par une ligne ou des
+vaguelettes entre ces deux notes. On l'obtient en accolant la commande
+@code{\glissando} à la première note.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+c2\glissando c'
+\override Glissando #'style = #'zigzag
+c2\glissando c,
+@end lilypond
+
+
+@commonprop
+
+@lilypond[quote,ragged-right,verbatim]
+I = \once \override NoteColumn #'ignore-collision = ##t
+
+\relative <<
+  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
+  { \oneVoice \I c2 \glissando \I d, }
+>>
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Glissando}.
+
+D'autres exemples : @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}.
+
+
+@refbugs
+
+Il n'est pas possible d'imprimer un texte (tel que @emph{gliss.})
+le long de la ligne de glissando.
+
+
+@node Arpeggio
+@unnumberedsubsubsec Arpeggio
+
+@cindex arpège
+@cindex accord arpégé
+@funindex \arpeggio
+
+
+On peut indiquer qu'un accord doit être arpégé en lui accolant la
+commande @code{\arpeggio} :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+<c e g c>\arpeggio
+@end lilypond
+
+
+Pour spécifier qu'un autre accord doit être plaqué et non arpégé, on
+peut remplacer ce signe par un crochet :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\arpeggioBracket
+<c' e g c>\arpeggio
+@end lilypond
+
+
+Le sens de l'arpège est parfois indiqué par une pointe de flèche au bout
+de la vaguelette :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new Voice {
+  \arpeggioUp
+  <c e g c>\arpeggio
+  \arpeggioDown
+  <c e g c>\arpeggio
+}
+@end lilypond
+
+
+@commonprop
+
+Quand un arpège couvre plusieurs portées, il est possible d'indiquer
+l'arpège sur chacune des portées, puis de relier la ligne de vaguelettes
+en assignant @emph{vrai} à la propriété @code{connectArpeggios}, par
+exemple dans le contexte @internalsref{PianoStaff} :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \set PianoStaff.connectArpeggios = ##t
+  \new Staff { <c' e g c>\arpeggio }
+  \new Staff { \clef bass <c,, e g>\arpeggio }
+>>
+@end lilypond
+
+
+@refcommands
+
+@code{\arpeggio},
+@funindex \arpeggioUp
+@code{\arpeggioUp},
+@funindex \arpeggioDown
+@code{\arpeggioDown},
+@funindex \arpeggioNeutral
+@code{\arpeggioNeutral},
+@funindex \arpeggioBracket
+@code{\arpeggioBracket}.
+
+
+@seealso
+
+Dans ce même manuel : @ref{Ties}, pour noter explicitement des arpèges.
+
+Référence du programme : @internalsref{Arpeggio}.
+
+
+@refbugs
+
+Il est impossible de mêler au même instant, dans un contexte
+@internalsref{PianoStaff}, des lignes d'arpèges connectées et d'autres
+non connectées.
+
+
+@node Trills
+@unnumberedsubsubsec Trills
+
+Les trilles brefs s'indiquent comme n'importe quelle ponctuation :
+voir @ref{Articulations}.
+
+
+Les trilles plus longs sont délimités par @code{\startTrillSpan} et
+@code{\stopTrillSpan} :
+
+@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
+\new Voice {
+  << { c1 \startTrillSpan }
+     { s2. \grace { d16[\stopTrillSpan e] } } >>
+  c4 }
+@end lilypond
+
+@cindex trilles avec hauteur explicite
+
+Les trilles qui font intervenir une hauteur précise peuvent être
+indiqués par la commande @code{pitchedTrill}.
+
+@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
+\pitchedTrill c4\startTrillSpan fis
+f\stopTrillSpan
+@end lilypond
+
+@noindent
+Le premier argument est la note réelle ; le second est une hauteur qui
+sera imprimée comme une tête de note noire entre parenthèses.
+
+
+@refcommands
+
+@code{\startTrillSpan},
+@funindex \startTrillSpan
+@code{\stopTrillSpan}.
+@funindex \stopTrillSpan
+
+
+@seealso
+
+Référence du programme : @internalsref{TrillSpanner}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+@cindex crochets
+@cindex crochets de phrasé
+@cindex analyse musicologique
+@cindex crochet de regroupement de notes
+
+On utilise des crochets en analyse musicale, pour indiquer la
+structure d'une pièce.  LilyPond permet d'utiliser une forme
+simplifiée de crochets horizontaux imbriqués, dans la mesure où le
+contexte @internalsref{Staff} comporte le graveur
+@internalsref{Horizontal_bracket_engraver}.  Un crochet s'ouvre avec
+@code{\startGroup}, et se ferme avec @code{\stopGroup}.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    c4\startGroup\startGroup
+    c4\stopGroup
+    c4\startGroup
+    c4\stopGroup\stopGroup
+  }
+  \layout {
+    \context {
+      \Staff \consists "Horizontal_bracket_engraver"
+}}}
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{HorizontalBracket}.
+
+
diff --git a/Documentation/fr/user/fundamental.itely b/Documentation/fr/user/fundamental.itely
new file mode 100644
index 0000000000..3808d10a52
--- /dev/null
+++ b/Documentation/fr/user/fundamental.itely
@@ -0,0 +1,40 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond-learning.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Fundamental concepts
+@chapter Fundamental concepts
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu 
+* File structure (introduction)::
+* How LilyPond files work::
+* Score is a single musical expression::
+@end menu 
+@node File structure (introduction)
+@section File structure (introduction)
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node How LilyPond files work
+@section How LilyPond files work
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Score is a single musical expression
+@section Score is a single musical expression
+
+UNTRANSLATED NODE: IGNORE ME
+
+
+-- SKELETON FILE --
+When you actually translate this file, please remove these lines as
+well as all `UNTRANSLATED NODE: IGNORE ME' lines.
diff --git a/Documentation/fr/user/guitar.itely b/Documentation/fr/user/guitar.itely
new file mode 100644
index 0000000000..62aec56c2e
--- /dev/null
+++ b/Documentation/fr/user/guitar.itely
@@ -0,0 +1,364 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Guitar
+@section Guitar
+
+@cindex tablature
+@cindex tablature de guitare
+
+@menu 
+* Guitar TODO::
+@end menu
+
+@node Guitar TODO
+@subsection Guitar TODO
+
+@menu 
+* String number indications::
+* Tablatures basic::
+* Non-guitar tablatures::
+* Banjo tablatures::
+* Fret diagrams::
+* Right hand fingerings::
+* Other guitar issues::
+@end menu
+
+@node String number indications
+@unnumberedsubsubsec String number indications
+
+@cindex cordes numérotées
+@cindex numéro de corde
+
+On peut ajouter aux accords les numéros de cordes, en les indiquant avec
+@code{\}@var{number} :
+
+@lilypond[relative,relative=1,ragged-right,fragment]
+<c\1 e\2 g\3>
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.
+
+
+@node Tablatures basic
+@unnumberedsubsubsec Tablatures basic
+@cindex tablatures de base
+
+La notation en tablature est utilisée pour certains instruments à cordes
+pincées.  Les hauteurs n'y sont pas indisuées par des têtes de note,
+mais par des chiffres qui indiquent sur quelle corde, et à quelle case
+chaque note doit être jouée.  Dans certaines limites, LilyPond vous
+permet d'écrire des tablatures.
+
+Chaque numéro de corde associé à une note doit être précédé d'une barre
+oblique inverse (ou @qq{antislash}). Ainsi, @code{c4\3} donnera un do
+noire à jouer sur la troisième corde.  Par défaut, la première corde est
+la plus aigüe, et les cordes suivent l'accord traditionnel d'une guitare
+à six cordes.  Les notes sont imprimées sous forme de tablature, dans
+les contextes @internalsref{TabStaff} et @internalsref{TabVoice}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff {
+  a,4\5 c'\2 a\3 e'\1
+  e\4 c'\2 a\3 e'\1
+}
+@end lilypond
+
+@funindex minimumFret
+@cindex cases
+
+Quand aucune corde n'est précisée, LilyPond choisit automatiquement la
+corde où la position est la moins élevée et qui donne un numéro de case
+supérieur à la valeur de la propriété @code{minimumFret}.  On peut
+régler cette propriété, selon qu'on désire une position plus ou moins
+haute.  La valeur par défaut de cette propriété est fixée à 0, ce qui
+correspond à la position la plus basse.
+
+
+@example
+e16 fis gis a b4
+\set TabStaff.minimumFret = #8
+e16 fis gis a b4
+@end example
+@lilypond[quote,ragged-right]
+frag = {
+  \key e \major
+  e16 fis gis a b4
+  \set TabStaff.minimumFret = #8
+  e16 fis gis a b4
+}
+  \new StaffGroup <<
+    \new Staff { \clef "G_8" \frag }
+    \new TabStaff { \frag }
+  >>
+@end lilypond
+
+
+@commonprop
+
+Pour obtenir des tablatures où les hampes seront dirigées vers le bas et 
+les ligatures horizontales, réglez le contexte @code{TabStaff}
+comme suit :
+
+@example
+\stemDown
+\override Beam #'damping = #100000
+@end example
+
+@seealso
+
+Référence du programme : @internalsref{TabStaff}, @internalsref{TabVoice}.
+
+@refbugs
+
+Les accords ne subsissent ausun traitement particulier ; de ce fait, la
+sélection automatique des cordes peut attribuer une même corde pour deux
+notes différentes de l'accord.
+
+Afin que @code{\partcombine} fonctionne avec des tablatures, on doit
+ajouter au contexte @code{TabStaff} des voix fantômes :
+
+@lilypond[quote,ragged-right,verbatim]
+melodia = \partcombine { e4 g g g }{ e4 e e e }
+<<
+  \new TabStaff <<
+    \new TabVoice = "one" s1
+    \new TabVoice = "two" s1
+    \new TabVoice = "shared" s1
+    \new TabVoice = "solo" s1
+    { \melodia }
+  >>
+>>
+@end lilypond
+
+
+@node Non-guitar tablatures
+@unnumberedsubsubsec Non-guitar tablatures
+@cindex tablatures, autres
+
+Vous pouvez bien sûr accorder vos cordes différemment.  Cet accord est
+enregistré dans la propriété @code{stringTunings}.  La valeur de cette
+propriété doit être indiquée sous forme d'une liste en langage Scheme,
+où chaque corde est représentée par un nombre entier qui indique sa
+hauteur à vide, comptée en demi-tons à partir du do central.  Cette
+propriété permet aussi à LilyPond de déterminer le nombre de cordes.
+
+Dans l'exemple suivant, on a réglé @code{stringTunings} pour l'accord de
+la guitare basse, c'est-à-dire mi la ré sol.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
+  {
+    a,4 c' a e' e c' a e'
+  }
+>>
+@end lilypond
+
+Toutefois, LilyPond possède des jeux de cordes prédéfinis pour le banjo,
+la mandoline, la guitare et la guitare basse ; ainsi, l'accord précédent
+peut également s'indiquer par
+
+@example
+\set TabStaff.stringTunings = #bass-tuning
+@end example
+
+Le jeu par défaut est celui de la guitare : @code{guitar-tuning},
+c'est-à-dire le célèbre mi la ré sol si mi. D'autres jeux prédéfinis
+sont @code{guitar-open-g-tuning}, @code{mandolin-tuning} et
+@code{banjo-open-g-tuning}.
+
+@seealso
+
+Vous trouverez une liste complète des jeux prédéfinis dans le fichier
+@file{scm/@/output@/-lib@/.scm}.
+
+Référence du programme : @internalsref{Tab_note_heads_engraver}.
+
+@refbugs
+
+Aucun effet spécial de guitare n'a été implémenté à ce jour.
+
+
+
+@node Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
+@cindex Tablatures de banjo
+
+LilyPond permet d'écrire des tablatures de base pour le banjo à cinq
+cordes.  Pour ce faire, pensez à utiliser le format de tablature pour
+banjo, afin d'avoir le bon nombre de cordes et le bon accord :
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
+  \set TabStaff.stringTunings = #banjo-open-g-tuning
+  {
+    \stemDown
+    g8 d' g'\5 a b g e d' |
+    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
+    g4
+  }
+>>
+@end lilypond
+
+LilyPond connaît un certain nombre de manières d'accorder un banjo :
+@code{banjo-c-tuning} (sol do sol si ré),
+@code{banjo-modal-tuning} (sol ré sol do ré),
+@code{banjo-open-d-tuning} (la ré fa-dièse la ré)
+et @code{banjo-open-dm-tuning} (la ré fa la ré).
+
+Tous ces accords peuvent être convertis en accords pour banjo à quatre
+cordes, si l'on utilise la fonction @code{four-string-banjo} :
+
+@example
+\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
+@end example
+
+@seealso
+
+Vous trouverez une liste complète des jeux de cordes prédéfinis pour le banjo
+dans le fichier @file{scm/@/output@/-lib@/.scm}.
+
+
+@node Fret diagrams
+@unnumberedsubsubsec Fret diagrams
+@cindex schémas d'accords
+@cindex schémas de barrés
+
+On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
+note, en tant qu'objets @code{\markup}. Ces objets donnent toutes
+les informations sur le doigté et les éventuels barrés :
+
+@lilypond[verbatim, ragged-right, quote]
+\new Voice {
+  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d' d' d'
+  fis'^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  fis' fis' fis'
+  c'^\markup \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+  c' c' c'
+}
+@end lilypond
+
+
+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}.
+
+Par ailleurs, plusieurs propriétés permettent d'ajuster le graphisme
+à votre convenance. Vous en trouverez les détails dans
+@internalsref{fret-diagram-interface}. 
+
+
+@seealso
+
+Exemples : @lsrdir{guitar}
+
+
+@node Right hand fingerings
+@unnumberedsubsubsec Right hand fingerings
+
+Les doigtés de la main droite, dans les accords, peuvent être ajoutés au moyen
+de @code{@var{note}-\rightHandFinger @var{doigté}}
+
+@lilypond[verbatim,fragment,relative=2]
+  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+@end lilypond
+
+Pour plus de clarté, vous pouvez traduire ou abréger la commande 
+@code{\rightHandFinger}, par exemple en @code{\doigtMainDroite} ou
+même @code{\MD} :
+
+@example
+#(define MD rightHandFinger)
+@end example
+
+@cindex doigtés, main droite, guitare
+@cindex mains droite, doigtés guitare
+ 
+@commonprop
+
+Pour contrôler plus précisément les doigtés de main droite, réglez la
+propriété @code{strokeFingerOrientations} :
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(up down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+  \set strokeFingerOrientations = #'(up right down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+}
+@end lilypond
+
+Les lettres utilisées dans ces doigtés sont définies par la propriété
+@code{digit-names}, mais on peut bien sûr les changer en utilisant une
+chaîne de caractères comme argument de @code{\rightHandFinger}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(right)
+  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
+  <c-\RH #5 >4
+  <c-\RH "@">4  
+}
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{StrokeFinger}
+
+
+
+@node Other guitar issues
+@unnumberedsubsubsec Other guitar issues
+
+
+Voici comment insérer des indications de position.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
+\clef "G_8"
+b16 d16 g16 b16 e16
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text = #"XII "
+  g16\startTextSpan
+  b16 e16 g16 e16 b16 g16\stopTextSpan
+e16 b16 g16 d16
+@end lilypond
+
+
+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}.
+
+
diff --git a/Documentation/fr/user/install.itely b/Documentation/fr/user/install.itely
index 5b68f7a025..b36d1b9e0b 100644
--- a/Documentation/fr/user/install.itely
+++ b/Documentation/fr/user/install.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/instrument-notation.itely b/Documentation/fr/user/instrument-notation.itely
deleted file mode 100644
index cfc8cfaf91..0000000000
--- a/Documentation/fr/user/instrument-notation.itely
+++ /dev/null
@@ -1,4832 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of ../user/lilypond.tely
-@ignore
-    Translation of GIT committish: a4cf6aed7bf79f3cc1892dbc92b642b2514c1674
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@node Instrument-specific notation
-@chapter Instrument-specific notation
-
-Ce chapitre traite de la notation spécifique à certains instruments.
-
-@menu 
-* Piano music::
-* Chord names::
-* Vocal music::
-* Rhythmic music::
-* Guitar::
-* Bagpipe::
-* Ancient notation::
-* Other instrument specific notation::
-@end menu 
-
-
-@node Piano music
-@section Piano music
-
-Les systèmes de piano comprennent deux portées réunies par une accolade.
-Les portées sont largement autonomes, mais il arrive que des voix passent
-de l'une à l'autre.  Cette notation sert également à la harpe ou à d'autres
-instruments à clavier.  Le contexte @internalsref{PianoStaff} est précisément
-conçu pour gérer la notation spécifique au piano, notamment ces croisements.
-
-@menu
-* Automatic staff changes::
-* Manual staff switches::
-* Pedals::
-* Staff switch lines::
-* Cross staff stems::
-@end menu
-
-@refbugs
-
-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}.
-
-@cindex hampe, enjambement portées
-@cindex distance entre deux portées de piano
-
-
-@node Automatic staff changes
-@subsection Automatic staff changes
-@cindex Changements de portées automatiques
-
-Les voix peuvent passer automatiquement d'une portée à l'autre, au moyen
-de la syntaxe suivante :
-
-@quotation
-@example
-\autochange @dots{}@var{musique}@dots{}
-@end example
-@end quotation
-
-@noindent
-Deux portées seront alors créées au sein du contexte @code{PianoStaff},
-nommées respectivement @code{up} et @code{down}.  La portée du bas, par
-défaut, sera en clé de fa.
-
-Une section en mode @code{\relative} se situant en dehors de la commande
-@code{\autochange} n'aura pas d'effet sur les hauteurs de l'expression
-@var{musique} ; si on utilise @code{\relative}, il est donc préférable
-de mettre @code{\relative} @emph{après} @code{\autochange} et non avant :
-
-@quotation
-@example
-\autochange \relative @dots{} @dots{}
-@end example
-@end quotation
-
-La commande @code{\autochange} bascule les notes d'une portée à l'autre
-en fonction de leur hauteur (le do du milieu servant de charnière), et
-place les silences en fonction des notes qui les suivront. Ainsi :
-
-@lilypond[quote,verbatim,ragged-right]
-\new PianoStaff
-  \autochange \relative c'
-  {
-    g4 a b c d r4 a g
-  }
-@end lilypond
-
-
-@seealso
-
-Dans ce même manuel : @ref{Manual staff switches}.
-
-Référence du programme : @internalsref{AutoChangeMusic}.
-
-
-
-@refbugs
-
-Les changements de portée automatiques n'interviennent pas toujours à
-l'endroit le plus opportun.  Pour un résultat de meilleure qualité, il
-vaut mieux indiquer soi-même ces changements.
-
-
-@code{\autochange} ne peut intervenir à l'intérieur d'une commande
-@code{\times}.
-
-
-@node Manual staff switches
-@subsection Manual staff switches
-
-@cindex changements de portées manuels
-@cindex changement de portée, manuel
-
-Il est possible de passer d'une portée à l'autre de façon manuelle, au
-moyen de la commande
-
-@example
-\change Staff = @var{nomDeLaPortee} @var{musique}
-@end example
-
-@noindent
-La valeur @var{nomDeLaPortee} est le nom de la portée sur laquelle va se
-déplacer la voix courante.  Pour des raisons pratiques, on nomme la portée
-supérieure @code{"haut"} et la portée inférieure @code{"bas"}, donc
-@var{nomDeLaPortee} désigne habituellement @code{"haut"} ou
-@code{"bas"}.  Dans tous les cas, le contexte de portée ainsi utilisé
-doit exister au préalable.  C'est pourquoi il est d'usage de commencer
-par définir les portées
-
-@example
-<<
-  \new Staff = "haut" @{
-    \skip 1 * 10  % @emph{de façon à prolonger la portée}
-    @}
-  \new Staff = "bas" @{
-    \skip 1 * 10  % @emph{idem}
-    @}
->>
-@end example
-
-
-avant d'insérer une mélodie au moyen d'un contexte @context{Voice} :
-
-@example
-\context Staff = bas
-  \new Voice @{ @dots{} \change Staff = haut @dots{} @}
-@end example
-
-
-@node Pedals
-@subsection Pedals
-@cindex Pédales
-
-Le piano possède deux pédales, parfois trois, permettant de modifier
-l'émission du son.  Il est possible d'indiquer précisément chacune
-d'entre elles, en ajoutant à une note ou un accord les commandes
-suivantes :
-@multitable {enfoncerr} {pédale de tenuee} {pédale una cordaa} {\sostenutoDownnnn}
-@item       @tab pédale de tenue @tab pédale @emph{una corda} @tab pédale tonale
-@item enfoncer @tab @code{\sustainDown} @tab @code{\unaCorda} @tab @code{\sostenutoDown}
-@item relâcher @tab @code{\sustainUp}   @tab @code{\treCorde} @tab @code{\sostenutoUp}
-@end multitable
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c'4\sustainDown c'4\sustainUp
-@end lilypond
-
-Les modalités d'impression de ces indications sont définies par la
-propriété @code{pedal@var{X}Strings}, @var{X} étant l'une des trois
-pédales @code{Sustain}, @code{Sostenuto} ou @code{UnaCorda}.  Voyez
-la référence du programme, section @internalsref{SustainPedal}, pour en
-savoir plus.
-
-La propriété @code{pedalSustainStyle} permet différentes notations de
-pédale, en utilisant des crochets
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'bracket
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-@noindent
-ou en mélangeant indications textuelles et crochets
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'mixed
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-@code{text} est le style de notation par défaut pour la pédale de
-tenue --- le traditionnel @q{*Ped.}.  La pédale tonale, en revanche,
-utilise @code{mixed} par défaut.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-Il est possible de d'affiner l'apparence d'un crochet de pédale, au
-moyen des propriétés @code{edge-width}, @code{edge-height}, et
-@code{shorten-pair}, appliquées aux objets @code{PianoPedalBracket} ---
-voir la référence du programme, section
-@internalsref{PianoPedalBracket}. Par exemple, on peut étirer le crochet
-jusqu'à l'extrémité droite de la dernière note :
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-@seealso
-
-Dans ce manuel : @ref{Laissez vibrer ties}.
-
-@node Staff switch lines
-@subsection Staff switch lines
-
-
-@cindex voix entre deux portées
-@cindex changements de portée
-@cindex mélodie d'une portée à une autre
-
-@funindex followVoice
-
-Lorsqu'une voix change de portée, il est possible d'imprimer
-automatiquement une ligne reliant les notes, en attribuant à la variable
-@code{followVoice} la valeur @emph{vrai} :
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \new Staff="one" {
-    \set followVoice = ##t
-    c1
-    \change Staff=two
-    b2 a
-  }
-  \new Staff="two" { \clef bass \skip 1*2 }
->>
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{VoiceFollower}.
-
-@refcommands
-
-@funindex \showStaffSwitch
-@code{\showStaffSwitch},
-@funindex \hideStaffSwitch
-@code{\hideStaffSwitch}.
-
-
-@node Cross staff stems
-@subsection Cross staff stems
-
-Pour écrire des accords qui enjambent deux portées, on allonge la hampe
-de l'accord de l'une des deux portées de façon à ce qu'elle rejoigne celle de
-l'autre portée.
-
-@lilypond[ragged-right,verbatim,quote]
-stemExtend = {
-  \once \override Stem #'length = #10
-  \once \override Stem #'cross-staff = ##t
-}
-noFlag = \once \override Stem #'flag-style = #'no-flag
-\new PianoStaff <<
-  \new Staff {
-    \stemDown \stemExtend
-    f'4
-    \stemExtend \noFlag
-    f'8
-  }
-  \new Staff {
-    \clef bass
-    a4 a8
-  }
->>
-@end lilypond
-
-
-
-@node Chord names
-@section Chord names
-
-@menu
-* Introducing chord names::     
-* Chords mode::                 
-* Printing chord names::        
-@end menu
-
-
-@c  awkward name; awkward section name.
-@c  still, the Basic "chords" seems like a good name...  :(
-@node Introducing chord names
-@subsection Introducing chord names
-@cindex accords, chiffrage jazz
-
-LilyPond permet de désigner les accords par leur chiffrage jazz.
-S'il est possible d'entrer un accord sous sa forme musicale, avec
-@code{<.. >}, on peut aussi le saisir par son nom.  Le logiciel traite
-les accords comme des ensembles de hauteurs, donc les accords peuvent
-être transposés.
-
-@lilypond[quote,ragged-right,verbatim,ragged-right]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
-
-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
-@end lilypond
-
-Cet exemple montre également que les jeux d'instructions qui permettent
-à LilyPond d'imprimer des accords ne cherchent pas à se montrer
-intelligents.  Ici, le dernier accord n'est pas interprété comme étant
-renversé.
-
-Notez bien que la valeur rythmique des accords doit être indiquée
-@emph{à l'extérieur} des symboles @code{<>}.
-
-@example
-<c e g>2
-@end example
-
-
-@node Chords mode
-@subsection Chords mode
-
-Dans le mode accords, introduit par la commande @code{\chordmode}, les
-accords ne sont indiqués que par leur note fondamentale.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { es4. d8 c2 }
-@end lilypond
-
-@cindex saisir des accords
-@cindex mode accords
-
-On peut cependant obtenir des accords différents, en utilisant le
-caractère deux points (@code{:}).
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
-@end lilypond
-
-Le nombre accolé à la note fondamentale est considéré comme chiffrage
-jazz de l'accord, qui est de ce fait construit par un empilement de
-tierces. Notez l'exception que constitue @code{c:13} dans lequel la
-onzième est délibérément omise.
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
-@end lilypond
-
-@cindex note fondamentale
-@cindex notes ajoutées
-@cindex accords incomplets
-
-Des accords encore plus complexes peuvent être élaborés en plusieurs
-étapes séparées.  Ainsi, on peut enrichir l'accord par des notes
-ajoutées, que l'on indique après le chiffrage principal et que l'on
-sépare par des points :
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
-@end lilypond
-
-On peut augmenter ou diminuer certains intervalles au moyen des
-signes @code{-} ou @code{+} :
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
-@end lilypond
-
-On peut aussi enlever certaines notes de l'accord, en les spécifiant
-après un signe @code{^} --- les notes ajoutées doivent être indiquées
-@emph{avant} les notes à enlever.
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c^3 c:7^5 c:9^3.5 }
-@end lilypond
-
-Voici les différents chiffrages disponibles, en plus des nombres que
-nous venons de voir :
-
-@table @code
-@item m
-Accord mineur.  Ce chiffrage minorise la tierce, et la septième s'il y
-en a une.
-
-@item dim
-Accord diminué.  Ce chiffrage minorise la tierce, diminue la quinte et
-la septième s'il y en a.
-
-@item aug
-Accord augmenté.  Ce chiffrage augmente la quinte.
-
-@item maj
-Accord de septième majeure. Ce chiffrage majorise la septième s'il y
-en a une (dans le cas d'un accord parfait, ce chiffrage est facultatif).
-
-@item sus
-Accord de suspension. Ce chiffrage supprime la tierce, et y ajoute,
-suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
-quarte.
-@end table
-
-Il est bien sûr possible de mélanger ces chiffrages avec des notes ajoutées.
-@lilypond[quote,verbatim,fragment]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
-@end lilypond
-
-@cindex chiffrages des accords
-@funindex aug
-@funindex dim
-@funindex maj
-@funindex sus
-@funindex m
-
-Dans la mesure où un accord de treizième majeure ne sonne pas très bien
-avec la onzième, la onzième est enlevée automatiquement, à moins que
-vous ne le spécifiez explicitement.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
-@end lilypond
-
-@funindex /
-
-Les accords peuvent être renversés ou combinés avec une note étrangère à
-la basse, au moyen de @code{@var{accord}/}@var{note}
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/g c/f }
-@end lilypond
-@funindex /+
-
-Si la note de basse précisée appartient à l'accord, la doublure
-supérieure sera supprimée.  Pour l'éviter, utilisez la syntaxe
-@code{/+}@var{note}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/+g c/+f }
-@end lilypond
-
-Le mode accords est semblable à @code{\lyricmode} ou autre, c'est-à-dire que
-la plupart des commandes sont encore disponibles ; ainsi, @code{r} ou
-@code{\skip} peuvent servir à insérer des silences ou des silences
-invisibles.  De plus, les propriétés des objets peuvent être ajustées
-ou modifiées.
-
-
-
-@refbugs
-
-Aucun nom de note ne peut être indiqué deux fois dans un accord.  Ainsi, 
-dans l'accord suivant, seule la quinte augmentée est prise en compte,
-car elle est indiquée en dernier :
-
-@cindex agrégats
-@lilypond[quote,ragged-right,verbatim,fragment]
-\chordmode { c:5.5-.5+ }
-@end lilypond
-
-
-@node Printing chord names
-@subsection Printing chord names
-
-@cindex chiffrages d'accords
-@cindex accords
-
-Les chiffrages d'accords sont liés au contexte
-@internalsref{ChordNames}.  Les accords peuvent être saisis soit au
-moyen de la notation indiquée ci-dessus, soit directement avec les
-symboles @code{<} et @code{>}.
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
-}
-<<
-  \new ChordNames \harmonies
-  \new Staff \harmonies
->>
-@end lilypond
-
-Vous pouvez faire ressortir les chiffrages d'accords en assignant la
-valeur vrai à la propriété @code{chordChanges} dans le contexte
-@internalsref{ChordNames}.  De cette façon, les chiffrages ne sont
-imprimés qu'aux changements d'accord ou en début de ligne.
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
-}
-<<
-  \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
->>
-@end lilypond
-
-Les exemples précédents montrent des chiffrages placés au-dessus de la
-portée, mais ce n'est pas obligatoire : les accords peuvent également
-être imprimés séparément -- auquel cas vous aurez peut-être besoin
-d'ajouter le @internalsref{Volta_engraver} et le
-@internalsref{Bar_engraver} afin que les éventuelles barres de reprises
-s'affichent correctement.
-
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-size = #4
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
-}
-}
-@end lilypond
-
-Le modèle par défaut des chiffrages d'accord est celui de
-Klaus Ignatzek pour le jazz (cf. @ref{Literature list}).  Il s'agit
-d'une notation anglo-saxonne ; cependant vous pouvez 
-indiquer vos chiffrages en notation française au moyen de
-la commande \frenchChords (voir plus bas).
-
-Il est possible de créer votre propre modèle de chiffrages en
-réglant les propriétés suivantes :
-
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-C'est la liste des accords mis en forme de manière particulière.
-
-Cette liste d'exceptions s'indique de la façon suivante.
-On commence par créer une expression musicale telle que
-@example
-@code{chExceptionMusic} = @{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-puis on la transforme en liste d'exceptions au moyen du code
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Pour qu'elles soient effectives, on ajoute ces exceptions aux exceptions
-par défaut définies dans @file{ly/@/chord@/-modifier@/-init@/.ly} :
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
-
-Exemple de manipulation de cette propriété :
-@lsr{chords/,chord@/-name@/-exceptions@/.ly}
-@cindex exceptions, chiffrages d'accords.
-
-
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Cette propriété définit l'objet employé pour indiquer une septième
-majeure.  Les options prédéfinies sont @code{whiteTriangleMarkup}
-(triangle blanc) et @code{blackTriangleMarkup} (triangle noir).  Voir aussi
-l'exemple @lsr{chords,chord@/-name@/-major7@/.ly}.
-
-@funindex chordNameSeparator
-@item chordNameSeparator
-Les différents termes d'un chiffrage jazz (par exemple les notes de
-l'accord et la basse) sont habituellement séparés par une barre oblique.
-La propriété @code{chordNameSeparator} permet d'indiquer un autre
-séparateur, par exemple
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
-}
-@end lilypond
-
-@funindex chordRootNamer
-@item chordRootNamer
-Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
-est exprimée par une lettre capitale, parfois suivie d'une altération,
-correspondant à la notation anglo-saxonne de la musique.  Cette
-propriété a pour valeur la fonction qui transforme la hauteur de la note
-foncdamentale en nom de note ; c'est donc en assignant une nouvelle
-fonction à cette propriété que l'on peut produire des noms de note
-spéciaux, adaptés par exemple aux systèmes de notation d'autres pays.
-
-@funindex chordNoteNamer
-@item chordNoteNamer
-Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
-les règles utilisées sont par défaut celles définies par la propriété
-@code{chordRootNamer} ci-dessus.  Cependant, la propriété @code{chordNoteNamer}
-permet de régler cet élément indépendamment, par exemple pour imprimer la basse
-en caractères minuscules.
-
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-Le petit @q{m} qui indique un accord mineur est, dans la notation anglo-saxonne,
-attaché à la lettre de l'accord. Cependant il est possible d'ajouter un espace
-en assignant la valeur vrai à la propriété @code{chordPrefixSpacer}.  Cet
-espace sera omis si une altération est présente.
-
-@end table
-
-Les propriétés ci-dessus font l'objet de commandes prédéfinies
-adaptées aux notations de différents pays : @code{\germanChords} et
-@code{\semiGermanChords} pour la notation allemande,
-@code{\italianChords} pour la notation italienne et enfin
-@code{\frenchChords} pour la notation française.
-
-@lilypondfile[ragged-right]{chord-names-languages.ly}
-
-LilyPond intègre également deux autres modèles de chiffrages : une
-notation Jazz alternative, et un modèle systématique appelé système
-Banter.  Voir @ref{Chord name chart} et @lsr{chords,chord-names-jazz.ly}
-pour la mise en œuvre de ces modèles.
-
-@cindex Banter
-@cindex jazz, chiffrages d'accords
-@cindex accords jazz, chiffrage
-
-
-@refcommands
-
-@funindex \germanChords
-@code{\germanChords},
-@funindex \semiGermanChords
-@code{\semiGermanChords}.
-@funindex \italianChords
-@code{\italianChords}.
-@funindex \frenchChords
-@code{\frenchChords}.
-
-
-@seealso
-
-Exemples :
-@lsrdir{chords}
-
-Fichiers internes : @file{scm/@/chords@/-ignatzek@/.scm}, et
-@file{scm/@/chord@/-entry@/.scm}.
-
-
-@refbugs
-
-Les chiffrages d'accords ne sont déterminés que par la succession des
-hauteurs de notes.  En d'autres termes, les accords inversés ne sont pas
-reconnus, ni les notes ajoutées à la basse.  C'est pourquoi les accords
-saisis au moyen de la syntaxe @code{<.. >} peuvent produire des
-chiffrages étranges.
-
-
-
-@node Vocal music
-@section Vocal music
-
-Dans la mesure où les fichiers LilyPond sont constitués de texte,
-traiter de la musique vocale demande de prendre en compte deux spécificités :
-
-@itemize @bullet
-@item
-Les paroles sont saisies comme étant du texte, non des notes.
-Ainsi, le code@tie{}@code{d} sera interprété comme une syllabe, et non
-comme la note@tie{}ré (D pour les non latinistes).
-
-@item
-Les paroles doivent s'aligner avec les notes de la mélodie correspondante.
-@end itemize
-
-Plusieurs solutions existent pour ajouter des paroles ; nous les
-examinerons par degré croissant de complexité.
-
-@menu
-* Setting simple songs::        
-* Entering lyrics::             
-* Aligning lyrics to a melody::  
-* Working with lyrics and identifiers::  
-* Flexibility in placement::    
-* Spacing lyrics::              
-* More about stanzas::          
-* Ambitus::                     
-* Other vocal issues::          
-@end menu
-
-
-@commonprop
-
-S'assurer que tous les éléments textuels et les paroles respectent
-les marges du document requiert des calculs relativement lourds ; c'est
-la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
-Vous pouvez cependant l'y forcer en ajoutant le code
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-Pour que les paroles évitent également les barres de mesure, ajoutez
-@example
-\layout @{
-  \context @{
-    \Lyrics
-      \consists "Bar_engraver"
-      \consists "Separating_line_group_engraver"
-      \override BarLine #'transparent = ##t
-  @}
-@}
-@end example
-
-
-@node Setting simple songs
-@subsection Setting simple songs
-
-@cindex \addlyrics
-
-Le plus simple pour ajouter des paroles à une mélodie est d'adjoindre 
-
-@example
-\addlyrics @{ @var{les paroles} @}
-@end example
-
-@noindent
-à la mélodie.  En voici un exemple :
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
-
-On peut ajouter davantage de couplets en multipliant le nombre de
-sections @code{\addlyrics}.
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
-
-Cependant, la commande @code{\addlyrics} ne peut gérer les
-constructions polyphoniques.  Dans ce cas, mieux vaut employer
-@code{\lyricsto} et @code{\lyricmode}, comme nous le verrons dans
-@ref{Entering lyrics}. 
-
-
-
-@node Entering lyrics
-@subsection Entering lyrics
-
-@cindex paroles
-@funindex \lyricmode
-@cindex ponctuation
-@cindex espaces, dans les paroles
-@cindex guillemets, dans les paroles
-
-Il existe un mode de saisie spécialement adapté aux paroles.  On
-l'introduit avec le mot-clé @code{\lyricmode}, ou en utilisant 
-@code{\addlyrics} ou @code{\lyricsto}.  Ce mode vous permet de saisir
-des paroles, ainsi que leur ponctuation, et le caractère @code{d} ne
-sera plus interprété comme une note, mais comme une syllabe.  Les
-syllabes sont saisies comme des notes, mais les hauteurs sont alors
-remplacées par du texte.  Exemple avec une comptine anglaise :
-
-@example
-\lyricmode @{ Twin-4 kle4 twin- kle litt- le star2 @}
-@end example
-
-Ici on a choisi de saisir explicitement la durée de chaque syllabe. Cependant,
-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}.
-
-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
-chiffre).  Toute syllabe doit donc être séparée d'une autre par un
-espace, tout autre caractère étant considéré comme partie intégrante
-de cette même syllabe.  L'exemple suivant comporte une faute de frappe
-évidente :
-
-@example
-\lyricmode @{ lah- lah@}
-@end example
-
-la dernière syllabe contient une @code{@}}, il y a de fait un défaut de
-parité avec l'accolade ouvrante, et la compilation échouera fort
-probablement. 
-
-
-@funindex \property dans \lyricmode
-
-@noindent
-De la même manière, un point concluant une suite de lettres sera
-partie intégrante de la chaîne résultante. Par conséquent, il est
-impératif d'insérer des espaces lorsque vous modifiez les propriétés
-d'une commande.  En d'autres termes, ne saisissez pas
-
-@example
-\override Score.LyricText #'font-shape = #'italic
-@end example
-
-@noindent
-mais plutôt
-
-@example
-\override Score . LyricText #'font-shape = #'italic
-@end example
-
-@funindex _
-@cindex espaces, dans les paroles
-@cindex guillemets, dans les paroles
-@cindex liaisons, dans les paroles
-
-Pour attribuer plus d'une syllabe à une même note, vous pouvez mettre
-ces syllabes entre guillemets, ou bien remplacer l'espace par un
-caractère souligné (@code{_}), ou encore utiliser un tilde (@code{~})
-pour obtenir une liaison entre les syllabes.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-Cette liaison adaptée aux paroles correspond au caractère Unicode
-U+203F, et n'apparaîtra dans la partition que s'il existe une police
-incluant ce symbole (par exemple DejaVuLGC) installée sur le système.
-
-
-Pour utiliser des lettres accentuées ou des caractères spéciaux 
---- cœurs ou guillemets inversés par exemple --- il suffit de les insérer
-dans le fichier et de veiller à sauvegarder ce dernier avec le codage
-utf-8.  Voir à ce sujet @ref{Text encoding} pour plus de détails.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative { e4 f e d e f e2 }
-\addlyrics { He said: “Let my peo ple go”. }
-@end lilypond
-
-Pour utiliser des guillemets informatiques standard, faites-les
-précéder d'une barre oblique inverse :
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
-\addlyrics { "\"I" am so lone- "ly\"" said she }
-@end lilypond
-
-Expliquer exactement comment LilyPond repère le début d'un mot en mode
-paroles (Lyrics) est quelque peu compliqué.
-
-En mode Lyrics, un mot peut commencer par : tout caractère alphabétique,
-@code{_}, @code{?}, @code{!}, @code{:}, @code{'}, un des codes de
-contrôle @code{^A} à @code{^F} et @code{^Q} à @code{^W}, @code{^Y},
-@code{^^}, tout caractère ASCII de code strictement supérieur à 127, ou
-enfin un des symboles @code{`}, @code{'}, @code{"}, ou @code{^}, s'il
-est précédé d'une barre oblique inverse.
-
-Pour définir un identificateur contenant des paroles, il faut utiliser
-la fonction @code{lyricmode}.
-
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
-  <<
-    \new Voice = "one" \relative c'' @{
-      \autoBeamOff
-      \time 2/4
-      c4 b8. a16 g4. f8 e4 d c2
-    @}
-    \addlyrics @{ \verseOne @}
-  >>
-@}
-@end example
-
-
-@seealso
-
-Référence du programme : @internalsref{LyricText}, @internalsref{LyricSpace}.
-
-
-
-@node Aligning lyrics to a melody
-@subsection Aligning lyrics to a melody
-
-@funindex \lyricmode
-@funindex \addlyrics
-@funindex \lyricsto
-
-
-Avant d'être imprimées, les paroles sont interprétées par le programme
-dans le contexte @internalsref{Lyrics}.
-
-@example
-\new Lyrics \lyricmode @dots{}
-@end example
-
-Il y a deux grandes méthodes pour gérer le placement horizontal des
-syllabes :
-
-@itemize @bullet
-@item
-en alignant automatiquement les paroles sur une mélodie ou une autre
-voix, en ayant recours à @code{\addlyrics} ou @code{\lyricsto} ;
-
-@item
-en affectant explicitement à chaque syllabe une durée, au sein du
-contexte @code{\lyricmode}
-@end itemize
-
-@menu
-* Automatic syllable durations::  
-* Another way of entering lyrics::  
-* Assigning more than one syllable to a single note::  
-* More than one note on a single syllable::  
-* Extenders and hyphens::       
-@end menu
-
-@node Automatic syllable durations
-@subsubsection Automatic syllable durations
-
-@cindex durée automatique des syllabes
-@cindex paroles et mélodies
-
-Les paroles peuvent être automatiquement alignées sous
-une mélodie.  Il suffit pour cela de combiner la mélodie et les
-paroles avec la commande @code{\lyricsto}.
-
-@example
-\new Lyrics \lyricsto @var{nom} @dots{}
-@end example
-
-Cette commande adapte les paroles aux notes de la voix (contexte
-@internalsref{Voice} dans le jargon LilyPond) @var{nom}.  Ce contexte
-@code{Voice} doit exister avant l'indication des paroles avec
-@code{\lyricsto}.  La commande @code{\lyricsto} introduit
-automatiquement le mode @code{\lyricmode}, donc dans ce cas vous n'avez
-pas à ajouter vous-même @code{\lyricmode}.
-
-L'exemple suivant récapitule les différentes manières de saisir des paroles.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-<<
-  \new Voice = "one" \relative c'' {
-    \autoBeamOff
-    \time 2/4
-    c4 b8. a16 g4. f8 e4 d c2
-  }
-  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
-  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
-  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
->>
-@end lilypond
-
-Le deuxième couplet n'est pas correctement disposé, aucune durée
-n'ayant été spécifiée. Dans un tel cas, il aurait mieux valu utiliser
-@code{\lyricsto}, comme dans le troisième couplet.
-
-La commande @code{\addlyrics} n'est en fait qu'une simplification de
-la structure employée par LilyPond pour définir les paroles.
-
-@example
-@{ MUSIQUE @}
-\addlyrics @{ PAROLES @}
-@end example
-
-@noindent
-est exactement la même chose que
-
-@example
-\new Voice = "blah" @{ musique @}
-\new Lyrics \lyricsto "blah" @{ PAROLES @}
-@end example
-
-@node Another way of entering lyrics
-@subsubsection Another way of entering lyrics
-
-On peut aussi se passer de @code{\addlyrics} et de @code{\lyricsto} pour
-saisir des paroles.  Dans ce cas, les syllabes sont entrées comme des
-notes --- du texte remplaçant les hauteurs --- ce qui veut dire que vous
-devez définir leur durée explicitement :
- 
-@example
-play2 the4 game2.
-sink2 or4 swim2.
-@end example
- 
-La mélodie associée à ces paroles peut être spécifiée par la propriété
-@code{associatedVoice} :
- 
-@example
-\set associatedVoice = #"lala"
-@end example
- 
-@noindent
-La valeur que vous attribuez à cette propriété (ici @code{"lala"})
-doit désigner un contexte @internalsref{Voice}, sans quoi les mélismes
-ne seront pas imprimés correctement.
- 
-Voici un exemple de cette manière de procéder :
- 
-@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
-<< \new Voice = "melody" {
-    \time 3/4
-    c2 e4 g2.
- }
- \new Lyrics \lyricmode {
-   \set associatedVoice = #"melody"
-   play2 the4 game2.
- } >>
-@end lilypond
-
-@seealso
- 
-Référence du programme : @internalsref{Lyrics}.
-
-
-@node Assigning more than one syllable to a single note
-@subsubsection Assigning more than one syllable to a single note
-
-
-@funindex _
-@cindex liaisons, dans les paroles
-
-Pour attribuer plus d'une syllabe à une même note, vous pouvez les
-mettre entre guillemets, remplacer une espace par un caractère souligné
-(@code{_}) pour obtenir une espace, ou bien encore utiliser un tilde
-(@code{~}) pour obtenir une liaison entre les syllabes@footnote{Une
-liaison adaptée aux paroles correspond au caractère Unicode U+203F, et
-n'apparaîtra dans la partition que si le système dispose d'une police
-installée qui contient ce symbole(par exemple DejaVuLGC).}.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{LyricCombineMusic}.
-
-@c Here come the section which used to be "Melismata"
-@c the new title might be more self-explanatory
-
-
-@node More than one note on a single syllable
-@subsubsection More than one note on a single syllable
-
-@cindex mélisme
-@cindex vocalise
-@c better here
-@cindex phrasé, pour des paroles
-
-
-Parfois, tout particulièrement dans la musique médiévale, plusieurs
-notes correspondent à une même syllabe. Ces vocalises sont appelées mélismes.
-
-@c this method seems to be the simplest; therefore
-@c it might be better to present it first - vv
-
-Il est possible d'indiquer tous les mélismes lors de la saisie des
-paroles. Il suffit pour cela d'utiliser le caractère @code{_} pour
-chaque note du mélisme.
-
-@lilypond[relative=1,verbatim,fragment,quote]
-{ \set melismaBusyProperties = #'()
- c d( e) f f( e) e e  }
-\addlyrics
- { Ky -- _ _ ri __ _ _ _  e }
-@end lilypond
-
-En définissant, comme dans l'exemple ci-dessus, la propriété
-@code{melismaBusyProperties}, vous obtiendrez automatiquement toutes
-les liaisons de tenue et de phrasé requises.
-
-D'autre part, la commande @code{\lyricsto} arrive aussi à détecter
-automatiquement les mélismes : une seule syllabe sera placée sous un
-groupe de notes comprenant des liaisons de tenue ou de phrasé.  Au cas
-où un mélisme doit s'appliquer à des notes non liées, il suffit
-d'adjoindre @code{\melisma} à la première note du groupe, et 
-@code{\melismaEnd} à la dernière :
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-<<
-  \new Voice = "lala" {
-    \time 3/4
-    f4 g8
-    \melisma
-    f e f
-    \melismaEnd
-    e2
-  }
-  \new Lyrics \lyricsto "lala" {
-    la di __ daah
-  }
->>
-@end lilypond
-
-Enfin, lorsque la fonction de ligature automatique (cf.
-@ref{Setting automatic beam behavior}) est désactivée, le fait de les
-connecter manuellement créera un mélisme.
-
-@c TODO: there might be some more relevant place for 
-@c the following link (?)
-
-@cindex SATB
-@cindex choral score
-
-Vous trouverez un exemple complet de partition pour chœur dans la
-section @ref{Vocal ensembles}.
-
-
-@refcommands
-
-@code{\melisma}, @code{\melismaEnd}
-@funindex \melismaEnd
-@funindex \melisma
-
-@seealso
-
-Référence du programme : @internalsref{Melisma_translator}.
-
-@lsr{vocal,lyric@/-combine.ly}.
-
-@refbugs
-
-Certains mélismes ne sont pas détectés automatiquement ; vous devrez
-alors prolonger vous-même les syllabes concernées.
-
-@node Extenders and hyphens
-@subsubsection Extenders and hyphens
-
-@cindex mélisme
-@cindex extenseur
-@cindex prolongateur
-
-Un mélisme est indiqué par une ligne horizontale basse centrée
-entre une syllabe et la suivante.  Une telle ligne, que nous
-appellerons prolongateur ou extenseur, s'obtient en saisissant 
-@samp{ __ } (notez les espaces entourant le souligné double).
-
-@cindex trait d'union
-
-Un trait d'union séparant deux syllabes d'un même mot s'obtient en
-saisissant @samp{ -- } (notez les espaces entourant le tiret double).
-Ce trait d'union sera centré entre les deux syllabes et sa longueur
-sera proportionnelle à l'espace les séparant.
-
-Dans les partitions très serrées, les traits d'union peuvent ne pas être
-imprimés.  Cet inconvénient peut être contrôlé par
-@code{minimum-distance} pour gérer l'espace minimum entre deux syllabes,
-et @code{minimum-length}, seuil en deçà duquel il n'y a pas de trait
-d'union.
-
-@seealso
-
-Référence du programme : @internalsref{LyricExtender},
-@internalsref{LyricHyphen}
-
-
-@node Working with lyrics and identifiers
-@subsection Working with lyrics and identifiers
-@cindex paroles, identificateurs
-
-La fonction @code{\lyricmode} permet de définir un identificateur pour
-les paroles.  Point n'est besoin de spécifier les durées si vous
-utilisez @code{\addlyrics} ou @code{\lyricsto} lorsque vous y faites référence.
- 
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
- <<
-   \new Voice = "one" \relative c'' @{
-     \autoBeamOff
-     \time 2/4
-     c4 b8. a16 g4. f8 e4 d c2
-   @}
-   \addlyrics @{ \verseOne @}
- >>
-@}
-@end example
- 
-Pour une organisation différente ou plus complexe, mieux vaut
-commencer par définir la hiérarchie des portées et des paroles,
-@example
-\new ChoirStaff <<
-  \new Voice = "soprano" @{ @emph{musique} @}
-  \new Lyrics = "sopranoParoles" @{ s1 @}
-  \new Lyrics = "tenorParoles" @{ s1 @}
-  \new Voice = "tenor" @{ @emph{musique} @}
->>
-@end example
- 
-puis combiner correctement les mélodies et les paroles :
- 
-@example
-\context Lyrics = sopranoParoles \lyricsto "soprano"
-@emph{les paroles}
-@end example
- 
-@noindent
-
-Le résultat donnera ainsi quelque chose comme
- 
-@example
-<<\new ChoirStaff << @emph{définition de la musique} >>
- \lyricsto "soprano" @emph{etc}
- \lyricsto "alto" @emph{etc}
-@emph{etc}
->>
-@end example
- 
-@seealso
- 
-@c TODO: document \new Staff << Voice \lyricsto >> bug
-
-Référence du programme : @internalsref{LyricCombineMusic},
-@internalsref{Lyrics}.  
-
-
-@node Flexibility in placement
-@subsection Flexibility in placement
-
-Une même mélodie peut se voir traitée différemment suivant les couplets.
-La commande @code{\lyricsto} permet de prendre en compte ces variantes.
-
-@menu
-* Lyrics to multiple notes of a melisma::  
-* Divisi lyrics::               
-* Switching the melody associated with a lyrics line::  
-* Lyrics independent of notes::  
-@end menu
-
-
-@node Lyrics to multiple notes of a melisma
-@subsubsection Lyrics to multiple notes of a melisma
-
-Il peut survenir que les paroles comportent un mélisme pour l'un des
-couplets, mais plusieurs syllabes pour d'autres. Une solution consiste à
-temporairement ignorer les mélismes dans le couplet ayant plus de
-syllabes.  Il suffit pour cela de définir la propriété
-@code{ignoreMelismata} à l'intérieur du contexte Lyrics.
-
-Petit détail qui a son importance : la définition de
-@code{ignoreMelismata} doit intervenir une syllabe @emph{avant} les
-syllabes auxquelles elle s'appliquera :
-
-@c  FIXME: breaks compile
-@lilypond[verbatim,ragged-right,quote]
-%{
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    \slurDotted
-    f8.[( g16])
-    a4
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    more slow -- ly
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    \set ignoreMelismata = ##t % applies to "fas"
-    go fas -- ter
-    \unset ignoreMelismata
-    still
-  }
->>
-%}
-@end lilypond
-
-
-Ici la fonction @code{ignoreMelismata} concerne la syllabe @q{fas},
-bien qu'elle ait été définie avant la syllabe @q{go}.
-
-L'inverse est aussi possible : prendre une mélodie syllabique pour en
-faire un mélisme.  Il faudra alors insérer des sauts invisibles
-@code{\skip} dans vos paroles. Chaque @code{\skip} décale le texte
-suivant d'une note :
-
-@lilypond[verbatim,ragged-right,quote]
-\relative { c c g' }
-\addlyrics {
-  twin -- \skip 4
-  kle
-}
-@end lilypond
-
-
-@node Divisi lyrics
-@subsubsection Divisi lyrics
-
-En donnant un nom à chaque voix et en leur attribuant spécifiquement
-des paroles, on peut créer des paroles alternatives --- également
-qualifiées de @q{divisi}.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" {
-    \relative c' {
-      c4
-      <<
-        { \voiceOne c8 e }
-        \new Voice = "splitpart" { \voiceTwo c4 }
-      >>
-      \oneVoice c4 c | c
-    }
-  }
-  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
-  \new Lyrics \lyricsto "splitpart" { will }
->> }
-@end lilypond
-
-
-Cette astuce permet de faire varier les paroles lorsqu'une section est reprise.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" \relative c' {
-    c2 e | g e | c1 |
-    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
-    a2 b | c1}
-  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
-    do mi sol mi do
-    la si do }
-  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
-   do re mi fa sol }
-  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
-   dodo rere mimi fafa solsol }
->>
-}
-@end lilypond
-
-
-
-@node Switching the melody associated with a lyrics line
-@subsubsection Switching the melody associated with a lyrics line
-
-On peut créer des variations plus complexes à partir d'une mélodie à
-plusieurs voix.  Les paroles peuvent suivre l'une ou l'autre des
-lignes mélodiques, et même basculer de l'une à l'autre si l'on
-modifie la propriété @code{associatedVoice}.  Dans cet exemple,
-
-@lilypond[ragged-right,quote]
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    <<
-      \new Voice = "alternative" {
-        \voiceOne
-        \times 2/3 {
-          % show associations clearly.
-          \override NoteColumn #'force-hshift = #-3
-          f8 f g
-        }
-      }
-      {
-        \voiceTwo
-        f8.[ g16]
-        \oneVoice
-      } >>
-    a8( b) c
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    Ju -- ras -- sic Park
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    % Tricky: need to set associatedVoice
-    % one syllable too soon!
-    \set associatedVoice = alternative % applies to "ran"
-    Ty --
-    ran --
-    no --
-    \set associatedVoice = lahlah % applies to "rus"
-    sau -- rus Rex
-  } >>
-@end lilypond
-
-@noindent
-le texte du premier couplet s'aligne sur la mélodie nommée
-@q{lahlah},
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  Ju -- ras -- sic Park
-@}
-@end example
-
-
-Le second couplet est tout d'abord rattaché au contexte @code{lahlah},
-mais bascule sur une autre mélodie sur la syllabe @q{ran}.  Pour cela,
-nous utilisons
-@example
-\set associatedVoice = alternative
-@end example
-
-@noindent
-où @code{alternative} désigne le nom du contexte @code{Voice} qui contient
-le triolet.
-
-Encore une fois, cette commande doit être spécifiée une syllabe en
-avance, c'est-à-dire ici avant la syllabe @q{Ty}.
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  \set associatedVoice = alternative % applies to "ran"
-  Ty --
-  ran --
-  no --
-  \set associatedVoice = lahlah % applies to "rus"
-  sau -- rus Rex
-@}
-@end example
-
-@noindent
-Comme vous pouvez le voir, nous revenons ensuite à l'alignement sur la
-mélodie d'origine, en assignant à la propriété @code{associatedVoice}
-la valeur @code{lahlah}.
-
-
-@node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
-
-Dans certaines musiques vocales assez complexes, on peut avoir intérêt à
-imprimer les paroles indépendamment des notes.  La mélodie sur laquelle
-s'aligne les paroles --- marquée par le tag @code{lyricrhythm} dans
-l'exemple suivant --- peut être insérée dans un contexte @code{Devnull},
-ce qui indique à LilyPond de na pas imprimer cette mélodie dans la
-partition.  Seules subsistent alors de cette mélodie les valeurs
-rythmiques, sur lesquelles s'alignent les paroles.
-
-@lilypond[quote,verbatim,ragged-right]
-voice = {
-  c''2
-  \tag #'music { c''2 }
-  \tag #'lyricrhythm { c''4. c''8 }
-  d''1
-}
-
-lyr = \lyricmode { I like my cat! }
-
-<<
-  \new Staff \keepWithTag #'music \voice
-  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
-  \new Lyrics \lyricsto "nowhere" \lyr
-  \new Staff { c'8 c' c' c' c' c' c' c'
-  c' c' c' c' c' c' c' c' }
->>
-@end lilypond
-
-
-@node Spacing lyrics
-@subsection Spacing lyrics
-
-@cindex espacer des paroles
-@cindex paroles, accroître l'espacement
-
-La propriété @code{#'minimum-distance} de l'objet LyricSpace permet
-d'accroître l'espacement des paroles.
-
-@lilypond[relative,verbatim,fragment,quote,ragged-right]
-{
-  c c c c
-  \override Lyrics.LyricSpace #'minimum-distance = #1.0
-  c c c c
-}
-\addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-}
-@end lilypond
-
-Pour que ce réglage s'applique à toute la partition, définissez-le
-dans le bloc @code{\layout}.
-
-@lilypond[relative,verbatim,quote,ragged-right]
-\score {
-  \relative c' {
-  c c c c
-  c c c c
-  }
-  \addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-  }
-  \layout {
-    \context {
-      \Lyrics
-      \override LyricSpace #'minimum-distance = #1.0
-    }
-  }
-}
-@end lilypond
-
-
-@node More about stanzas
-@subsection More about stanzas
-
-@cindex numéro de couplet
-@subsubsection Adding stanza numbers 
-
-On peut ajouter un numéro aux couplets en définissant la variable
-@code{stanza} :
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set stanza = "1. "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set stanza = "2. "
-  Oh, ché -- ri, je t'aime
-}
-@end lilypond
-
-@noindent
-Ces numéros se placeront juste avant le début de la première syllabe.
-
-@subsubsection Adding dynamics marks
-
-Lorsque des couplets ont des nuances différentes, vous pouvez ajouter
-une nuance devant chaque numéro.  L'objet @code{StanzaNumber} contient
-tout ce qui se place au début du couplet.  Pour des raisons techniques,
-vous devrez définir la variable @code{stanza} en dehors du mode
-@code{\lyricmode}.
-
-@lilypond[quote,ragged-right,verbatim]
-text = {
-  \set stanza = \markup { \dynamic "ff" "1. " }
-  \lyricmode {
-    Big bang
-  }
-}
-
-<<
-  \new Voice = "tune" {
-    \time 3/4
-    g'4 c'2
-  }
-\new Lyrics \lyricsto "tune" \text
->>
-@end lilypond
-
-@cindex nom de personnage
-@cindex nom du chanteur
-@subsubsection Adding singer names
-
-On peut également ajouter le nom de chaque rôle ; ils s'imprimeront au
-début de chaque ligne comme les noms d'instruments.  Il faut pour cela
-définir @code{vocalName}, et @code{shortVocalName} pour une version
-abrégée.
-
-@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set vocalName = "Bert "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set vocalName = "Ernie "
-  Oh, che -- ri, je t'aime
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end 
-
-Il peut parfois s'avérer opportun d'aligner un seul couplet sur la
-mélodie, et de présenter tous les autres en bloc à la fin du morceau.
-Ces couplets additionnels peuvent être inclus dans une section
-@code{\markup} en dehors du bloc @code{\score} principal.
-Vous en trouverez un exemple ci-dessous ; notez également les deux
-méthodes différentes employées pour indiquer les sauts de ligne,
-entre les couplets (@q{verses} en anglais) 2 et 3.
-
-@c keeply?
-@lilypond[ragged-right,verbatim,quote]
-melody = \relative c' {
-e d c d | e e e e |
-d d e d | c1 |
-}
-
-text = \lyricmode {
-\set stanza = "1." Ma- ry had a lit- tle lamb,
-its fleece was white as snow.
-}
-
-\score{ <<
-  \new Voice = "one" { \melody }
-  \new Lyrics \lyricsto "one" \text
->>
-  \layout { }
-}
-\markup { \column{
-  \line{ Verse 2. }
-  \line{ All the children laughed and played }
-  \line{ To see a lamb at school. }
-  }
-}
-\markup{
-  \wordwrap-string #"
-  Verse 3.
-
-  Mary took it home again,
-
-  It was against the rule."
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end in multiple columns 
-
-Si les couplets sont vraiment nombreux, il est possible de les imprimer
-sur plusieurs colonnes.  De plus, l'exemple suivant vous montrera
-comment faire en sorte que le numéro du couplet soit en retrait à
-gauche, comme c'est traditionnellement le cas.
-
-@c keeply?
-@lilypond[ragged-right,quote,verbatim]
-melody = \relative c' {
-  c c c c | d d d d
-}
- 
-text = \lyricmode {
-  \set stanza = "1." This is verse one.
-  It has two lines.
-}
-
-\score{ <<
-    \new Voice = "one" { \melody }
-    \new Lyrics \lyricsto "one" \text
-   >>
-  \layout { }
-}
-
-\markup {
-  \fill-line {
-    \hspace #0.1 % moves the column off the left margin; can be removed if
-        % space on the page is tight
-     \column {
-      \line { \bold "2."
-        \column {
-          "This is verse two."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "3."
-        \column {
-          "This is verse three."
-          "It has two lines."
-        }
-      }
-    }
-    \hspace #0.1  % adds horizontal spacing between columns; if they are
-        % still too close, add more " " pairs until the result 
-        % looks good
-     \column {
-      \line { \bold "4."
-        \column {
-          "This is verse four."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "5."
-        \column {
-          "This is verse five."
-          "It has two lines."
-        }
-      }
-    }
-  \hspace #0.1 % gives some extra space on the right margin; can
-      % be removed if page space is tight
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{LyricText},
-@internalsref{StanzaNumber}, @internalsref{VocalName}.
-
-
-
-@node Ambitus
-@subsection Ambitus
-@cindex ambitus
-
-L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
-partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
-est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
-partitions vocales, afin que les exécutants puissent voir au premier
-coup d'oeil s'ils sont en mesure de tenir la partie en question.
-
-Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
-représentant la hauteur la plus basse et la plus haute.  Pour imprimer
-cet ambitus, il faut ajouter le graveur @internalsref{Ambitus_engraver}
-au contexte @internalsref{Voice}.  Ainsi,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-@noindent
-donne pour résultat
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
-graveur @internalsref{Ambitus_engraver} au contexte @internalsref{Staff}
-plutôt qu'au contexte @internalsref{Voice} ; l'ambitus affiché sera
-alors celui de toutes les voix cumulées, non d'une seule des voix
-actives.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors le système de mise en
-forme n'aurait pas attribué d'espace supplémentaire pour l'objet
-déplacé.
-
-@seealso
-
-Référence du programme : @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Exemples :
-@lsr{vocal,ambitus@/.ly}.
-
-@refbugs
-
-LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
-une même portée.
-
-
-@node Other vocal issues
-@subsection Other vocal issues
-
-@ignore
-yeah, I'm giving up somewhat by stuffing a bunch of things in
-here.  But at least they're in the manual now; it's easier to
-move them around in the manual once they're already here.
-
-Besides, if users complain about everything stuffed in here, I
-can ask them for specific instructions about where to move these
-examples, and that might get them more involved in the docs.  -gp
-@end ignore
-
-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}.
-
-
-@node Rhythmic music
-@section Rhythmic music
-
-La notation rythmique sert avant tout aux parties de percussions ou de
-batterie, mais on peut aussi s'en servir à des fins pédagogiques, pour
-montrer le rythme d'une mélodie.
-
-@menu
-* Showing melody rhythms::      
-* Entering percussion::         
-* Percussion staves::           
-* Ghost notes::                 
-@end menu
-
-
-@node Showing melody rhythms
-@subsection Showing melody rhythms
-
-Au moyen d'une portée rythmique -- @q{rhythmic staff} en anglais -- on
-peut montrer seulement le rythme d'une mélodie : toutes les notes sont
-ramenées à la même hauteur, sur une portée d'une seule ligne.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new RhythmicStaff {
-  \time 4/4
-  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
-}
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{RhythmicStaff}.
-
-
-@node Entering percussion
-@subsection Entering percussion
-
-@cindex percussions
-@cindex batterie
-
-Les parties de percussions peuvent être saisies avec le mode @code{\drummode},
-qui est l'équivalent du mode standard utilisé pour les notes à hauteur
-déterminée.  Chaque instrument de percussion peut avoir, dans le
-fichier LilyPond, un nom complet et un nom raccourci.
-
-
-@lilypond[quote,ragged-right,verbatim]
-\drums {
-  hihat hh bassdrum bd
-}
-@end lilypond
-
-Ces noms sont inventoriés dans le fichier d'initialisation 
-@file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
-
-@seealso
-
-Référence du Programme : @internalsref{note-event}.
-
-@node Percussion staves
-@subsection Percussion staves
-@cindex percussions
-@cindex batterie
-
-Une partie de percussions utilisant plusieurs instruments requiert en
-général une portée de plusieurs lignes, où chaque hauteur sur la
-portée représente un instrument à percussion.
-
-Pour saisir cette musique, il faut que les notes soient situées dans
-des contextes @internalsref{DrumStaff} et @internalsref{DrumVoice}.
-
-@lilypond[quote,ragged-right,verbatim]
-up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
-down = \drummode { bassdrum4 snare8 bd r bd sn4 }
-  \new DrumStaff <<
-    \new DrumVoice { \voiceOne \up }
-    \new DrumVoice { \voiceTwo \down }
-  >>
-@end lilypond
-
-L'exemple ci-dessus montre une notation polyphonique détaillée.  La
-notation polyphonique abrégée peut être employée lorsque le contexte
-@internalsref{DrumVoice} est spécifié explicitement :
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
-  \drummode {
-    bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { bd4 sn4 bd4 sn4 }
-    >>
-  }
->>
-@end lilypond
-
-On peut choisir d'autres mises en forme si l'on définit la propriété
-@code{drumStyleTable} dans le contexte @internalsref{DrumVoice}.  
-Quelques variables prédéfinies sont disponibles :
-
-@table @code
-@item drums-style
-La notation par défaut : une batterie standard, sur une portée de cinq lignes.
-
-
-@lilypond[quote,line-width=10.0\cm]
-nam = \lyricmode {
-  cymc cyms cymr hh hhc hho hhho hhp
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
-mus = \drummode {
-  cymc cyms cymr hh hhc hho hhho hhp \break
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
-\score {
-  << \new DrumStaff \with {
-       \remove Bar_engraver
-       \remove Time_signature_engraver
-       \override Stem #'transparent = ##t
-       \override Stem #'Y-extent-callback = ##f
-       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
-     } \mus
-     \new Lyrics \nam
-  >>
-  \layout {
-    \context {
-      \Score
-      \override LyricText #'font-family = #'typewriter
-      \override BarNumber #'transparent =##T
-    }
-  }
-}
-@end lilypond
-
-Le plan de la batterie peut inclure jusqu'à six toms différents.  Bien
-sûr, vous n'êtes pas obligé de tous les utiliser si la musique en
-prévoit moins ; par exemple, les trois toms des lignes du milieu sont
-@code{tommh}, @code{tomml}, et @code{tomfh}.
-
-@item timbales-style
-Ce style permet de saisir une partie de timbales, sur une portée à deux
-lignes.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { timh ssh timl ssl cb }
-mus = \drummode { timh ssh timl ssl cb s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-    \override StaffSymbol #'line-count = #2
-    \override StaffSymbol #'staff-space = #2
-    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
-    drumStyleTable = #timbales-style
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item congas-style
-Ce style produit une portée à deux lignes pour une partie de congas.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
-mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    drumStyleTable = #congas-style
-    \override StaffSymbol #'line-count = #2
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item bongos-style
-Ce style produit une portée à deux lignes pour une partie de bongos.
-
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
-mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override StaffSymbol #'line-count = #2
-    drumStyleTable = #bongos-style
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item percussion-style
-Ce style permet de saisir toute sorte de percussions sur des portées
-d'une ligne.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
-mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
-
-<<
-  \new DrumStaff \with{
-    \remove Bar_engraver
-    drumStyleTable = #percussion-style
-    \override StaffSymbol #'line-count = #1
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-@end table
-
-Cependant, si aucun des styles prédéfinis ne vous convient, il est aisé
-de définir le vôtre en début de fichier.
-
-@lilypond[quote,ragged-right,verbatim]
-#(define mydrums '(
-         (bassdrum     default   #f         -1)
-         (snare        default   #f         0)
-         (hihat        cross     #f         1)
-         (pedalhihat   xcircle   "stopped"  2)
-         (lowtom       diamond   #f         3)))
-up = \drummode { hh8 hh hh hh hhp4 hhp }
-down = \drummode { bd4 sn bd toml8 toml }
-
-\new DrumStaff <<
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
-  \new DrumVoice { \voiceOne \up }
-  \new DrumVoice { \voiceTwo \down }
->>
-@end lilypond
-
-
-@seealso
-
-Fichier d'initialisation : @file{ly/@/drumpitch@/-init@/.ly}.
-
-Référence du programme : @internalsref{DrumStaff}, @internalsref{DrumVoice}.
-
-@refbugs
-
-La bibliothèque MIDI générale ne contient pas les @emph{rimshots} --- coups
-sur le bord de la caisse claire --- donc ils sont remplacés par des
-@emph{sidesticks,} largement équivalents.
-
-
-
-@c FIXME: check name -gp
-@node Ghost notes
-@subsection Ghost notes
-
-Des notes fantômes peuvent être créées pour les parties de percussion,
-grâce à la commande @code{\parenthesize} décrite dans
-@ref{Parentheses}. Cependant, le mode @code{\drummode} n'inclut pas par
-défaut le graveur @code{Parenthesis_engraver} qui permet d'imprimer ces
-signes.  Il faut donc l'ajouter explicitement dans la définition du
-contexte, suivant la manœuvre indiquée dans @ref{Changing context
-properties on the fly}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\new DrumStaff \with {
-  \consists "Parenthesis_engraver"
-} <<
-  \context DrumVoice  = "1"  { s1 *2 }
-  \context DrumVoice  = "2" { s1 *2 }
-  \drummode {
-    <<
-      {
-        hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
-      } \\ {
-        bd4 r4 bd8 bd r8 bd
-      }
-    >>
-  }
->>
-@end lilypond
-
-@noindent
-Notez que les commandes @code{\parenthesize} obligent à ajouter des
-accords --- sous la forme @code{< >} --- autour de chaque élément.
-
-@node Guitar
-@section Guitar
-
-@cindex tablature
-@cindex tablature de guitare
-
-@menu
-* String number indications::   
-* Tablatures basic::            
-* Non-guitar tablatures::       
-* Banjo tablatures::            
-* Fret diagrams::               
-* Right hand fingerings::       
-* Other guitar issues::         
-@end menu
-
-@node String number indications
-@subsection String number indications
-
-@cindex cordes numérotées
-@cindex numéro de corde
-
-On peut ajouter aux accords les numéros de cordes, en les indiquant avec
-@code{\}@var{number} :
-
-@lilypond[relative,relative=1,ragged-right,fragment]
-<c\1 e\2 g\3>
-@end lilypond
-
-
-@seealso
-
-Référence du programme : @internalsref{StringNumber},
-@lsr{guitar/,string-number.ly}.
-
-
-@node Tablatures basic
-@subsection Tablatures basic
-@cindex tablatures de base
-
-La notation en tablature est utilisée pour certains instruments à cordes
-pincées.  Les hauteurs n'y sont pas indisuées par des têtes de note,
-mais par des chiffres qui indiquent sur quelle corde, et à quelle case
-chaque note doit être jouée.  Dans certaines limites, LilyPond vous
-permet d'écrire des tablatures.
-
-Chaque numéro de corde associé à une note doit être précédé d'une barre
-oblique inverse (ou @qq{antislash}). Ainsi, @code{c4\3} donnera un do
-noire à jouer sur la troisième corde.  Par défaut, la première corde est
-la plus aigüe, et les cordes suivent l'accord traditionnel d'une guitare
-à six cordes.  Les notes sont imprimées sous forme de tablature, dans
-les contextes @internalsref{TabStaff} et @internalsref{TabVoice}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  a,4\5 c'\2 a\3 e'\1
-  e\4 c'\2 a\3 e'\1
-}
-@end lilypond
-
-@funindex minimumFret
-@cindex cases
-
-Quand aucune corde n'est précisée, LilyPond choisit automatiquement la
-corde où la position est la moins élevée et qui donne un numéro de case
-supérieur à la valeur de la propriété @code{minimumFret}.  On peut
-régler cette propriété, selon qu'on désire une position plus ou moins
-haute.  La valeur par défaut de cette propriété est fixée à 0, ce qui
-correspond à la position la plus basse.
-
-
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
-  \key e \major
-  e16 fis gis a b4
-  \set TabStaff.minimumFret = #8
-  e16 fis gis a b4
-}
-  \new StaffGroup <<
-    \new Staff { \clef "G_8" \frag }
-    \new TabStaff { \frag }
-  >>
-@end lilypond
-
-
-@commonprop
-
-Pour obtenir des tablatures où les hampes seront dirigées vers le bas et 
-les ligatures horizontales, réglez le contexte @code{TabStaff}
-comme suit :
-
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
-
-@seealso
-
-Référence du programme : @internalsref{TabStaff}, @internalsref{TabVoice}.
-
-@refbugs
-
-Les accords ne subsissent ausun traitement particulier ; de ce fait, la
-sélection automatique des cordes peut attribuer une même corde pour deux
-notes différentes de l'accord.
-
-Afin que @code{\partcombine} fonctionne avec des tablatures, on doit
-ajouter au contexte @code{TabStaff} des voix fantômes :
-
-@lilypond[quote,ragged-right,verbatim]
-melodia = \partcombine { e4 g g g }{ e4 e e e }
-<<
-  \new TabStaff <<
-    \new TabVoice = "one" s1
-    \new TabVoice = "two" s1
-    \new TabVoice = "shared" s1
-    \new TabVoice = "solo" s1
-    { \melodia }
-  >>
->>
-@end lilypond
-
-
-@node Non-guitar tablatures
-@subsection Non-guitar tablatures
-@cindex tablatures, autres
-
-Vous pouvez bien sûr accorder vos cordes différemment.  Cet accord est
-enregistré dans la propriété @code{stringTunings}.  La valeur de cette
-propriété doit être indiquée sous forme d'une liste en langage Scheme,
-où chaque corde est représentée par un nombre entier qui indique sa
-hauteur à vide, comptée en demi-tons à partir du do central.  Cette
-propriété permet aussi à LilyPond de déterminer le nombre de cordes.
-
-Dans l'exemple suivant, on a réglé @code{stringTunings} pour l'accord de
-la guitare basse, c'est-à-dire mi la ré sol.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
->>
-@end lilypond
-
-Toutefois, LilyPond possède des jeux de cordes prédéfinis pour le banjo,
-la mandoline, la guitare et la guitare basse ; ainsi, l'accord précédent
-peut également s'indiquer par
-
-@example
-\set TabStaff.stringTunings = #bass-tuning
-@end example
-
-Le jeu par défaut est celui de la guitare : @code{guitar-tuning},
-c'est-à-dire le célèbre mi la ré sol si mi. D'autres jeux prédéfinis
-sont @code{guitar-open-g-tuning}, @code{mandolin-tuning} et
-@code{banjo-open-g-tuning}.
-
-@seealso
-
-Vous trouverez une liste complète des jeux prédéfinis dans le fichier
-@file{scm/@/output@/-lib@/.scm}.
-
-Référence du programme : @internalsref{Tab_note_heads_engraver}.
-
-@refbugs
-
-Aucun effet spécial de guitare n'a été implémenté à ce jour.
-
-
-
-@node Banjo tablatures
-@subsection Banjo tablatures
-@cindex Tablatures de banjo
-
-LilyPond permet d'écrire des tablatures de base pour le banjo à cinq
-cordes.  Pour ce faire, pensez à utiliser le format de tablature pour
-banjo, afin d'avoir le bon nombre de cordes et le bon accord :
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
-  \set TabStaff.stringTunings = #banjo-open-g-tuning
-  {
-    \stemDown
-    g8 d' g'\5 a b g e d' |
-    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
-    g4
-  }
->>
-@end lilypond
-
-LilyPond connaît un certain nombre de manières d'accorder un banjo :
-@code{banjo-c-tuning} (sol do sol si ré),
-@code{banjo-modal-tuning} (sol ré sol do ré),
-@code{banjo-open-d-tuning} (la ré fa-dièse la ré)
-et @code{banjo-open-dm-tuning} (la ré fa la ré).
-
-Tous ces accords peuvent être convertis en accords pour banjo à quatre
-cordes, si l'on utilise la fonction @code{four-string-banjo} :
-
-@example
-\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
-@end example
-
-@seealso
-
-Vous trouverez une liste complète des jeux de cordes prédéfinis pour le banjo
-dans le fichier @file{scm/@/output@/-lib@/.scm}.
-
-
-@node Fret diagrams
-@subsection Fret diagrams
-@cindex schémas d'accords
-@cindex schémas de barrés
-
-On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
-note, en tant qu'objets @code{\markup}. Ces objets donnent toutes
-les informations sur le doigté et les éventuels barrés :
-
-@lilypond[verbatim, ragged-right, quote]
-\new Voice {
-  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
-  d' d' d'
-  fis'^\markup \override #'(size . 0.75) {
-    \override #'(finger-code . below-string) {
-      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
-                               (place-fret 5 4 3) (place-fret 4 4 4)
-                               (place-fret 3 3 2) (place-fret 2 2 1)
-                               (place-fret 1 2 1))
-    }
-  }
-  fis' fis' fis'
-  c'^\markup \override #'(dot-radius . 0.35) {
-    \override #'(finger-code . in-dot) {
-      \override #'(dot-color . white) {
-        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
-      }
-    }
-  }
-  c' c' c'
-}
-@end lilypond
-
-
-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}.
-
-Par ailleurs, plusieurs propriétés permettent d'ajuster le graphisme
-à votre convenance. Vous en trouverez les détails dans
-@internalsref{fret-diagram-interface}. 
-
-
-@seealso
-
-Exemples : @lsrdir{guitar}
-
-
-@node Right hand fingerings
-@subsection Right hand fingerings
-
-Les doigtés de la main droite, dans les accords, peuvent être ajoutés au moyen
-de @code{@var{note}-\rightHandFinger @var{doigté}}
-
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
-@end lilypond
-
-Pour plus de clarté, vous pouvez traduire ou abréger la commande 
-@code{\rightHandFinger}, par exemple en @code{\doigtMainDroite} ou
-même @code{\MD} :
-
-@example
-#(define MD rightHandFinger)
-@end example
-
-@cindex doigtés, main droite, guitare
-@cindex mains droite, doigtés guitare
- 
-@commonprop
-
-Pour contrôler plus précisément les doigtés de main droite, réglez la
-propriété @code{strokeFingerOrientations} :
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-}
-@end lilypond
-
-Les lettres utilisées dans ces doigtés sont définies par la propriété
-@code{digit-names}, mais on peut bien sûr les changer en utilisant une
-chaîne de caractères comme argument de @code{\rightHandFinger}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
-  <c-\RH #5 >4
-  <c-\RH "@">4  
-}
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{StrokeFinger}
-
-
-
-@node Other guitar issues
-@subsection Other guitar issues
-
-
-Voici comment insérer des indications de position.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
-\clef "G_8"
-b16 d16 g16 b16 e16
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text = #"XII "
-  g16\startTextSpan
-  b16 e16 g16 e16 b16 g16\stopTextSpan
-e16 b16 g16 d16
-@end lilypond
-
-
-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}.
-
-
-@node Bagpipe
-@section Bagpipe
-
-@cindex cornemuse
-
-@menu
-* Bagpipe definitions::         
-* Bagpipe example::             
-@end menu
-
-
-@node Bagpipe definitions
-@subsection Bagpipe definitions
-
-LilyPond inclut des définitions spécifiques destinées à la notation pour
-cornemuse écossaise ; pour les utiliser, il suffit d'ajouter
-
-@example
-\include "bagpipe.ly"
-@end example
-
-@noindent
-en début de fichier.  Ainsi, vous bénéficierez de commandes courtes pour
-les appogiatures spéciales et idiomatiques de la cornemuse.  Par
-exemple, @code{\taor} est un raccourci pour
-
-@example
-\grace @{ \small G32[ d G e] @}
-@end example
-
-@code{bagpipe.ly} prend également en charge les définitions de hauteurs
-pour la cornemuse ; vous n'avez donc pas à vous soucier d'employer
-@code{\relative} ou @code{\transpose}.
-
-@lilypond[ragged-right,verbatim,quote,notime]
-\include "bagpipe.ly"
-{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
-@end lilypond
-
-La musique pour cornemuse est traditionnellement écrite en ré majeur.
-Dans la mesure où c'est la seule tonalité possible, l'usage est de ne
-pas indiquer l'armure explicitement. À cet effet, pensez à commencer
-votre partition par @code{\hideKeySignature} -- ou bien
-@code{\showKeySignature} si, pour une raison ou pour une autre, vous
-tenez à afficher l'armure.
-
-Des compositions actuelles peuvent ne pas respecter cette tonalité
-traditionnelle, auquel cas les do et fa devraient être abaissés en
-utilisant @code{cflat} ou @code{fflat} ; ils seront représenté par une
-note en forme de croix.
-
-Lorsqu'on joue des œuvres moins cérémonieuses que pour une parade
-ou un défilé, peut survenir un sol aigu, au doux nom de
-@qq{piobaireachd}, et que l'on indiquera par @code{gflat}.
-
-
-@node Bagpipe example
-@subsection Bagpipe example
-
-Et voici en guise d'exemple, à quoi ressemble le chant populaire
-@emph{Amazing Grace}, noté dans l'idiome de la cornemuse.
-
-@lilypond[verbatim,quote]
-\include "bagpipe.ly"
-\layout {
-  indent = 0.0\cm
-  \context { \Score \remove "Bar_number_engraver" }
-}
-
-\header {
-  title = "Amazing Grace"
-  meter = "Hymn"
-  arranger = "Trad. arr."
-}
-
-{
-  \hideKeySignature
-  \time 3/4
-  \grg \partial 4 a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg e8. f16
-  \dblA A2 \grg A4
-  \grg A2 f8. A16
-  \grg A2 \hdblf f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 e4
-  \thrwd d2.
-  \slurd d2
-  \bar "|."
-}
-@end lilypond
-
-
-@node Ancient notation
-@section Ancient notation
-
-@cindex Vaticana, Editio
-@cindex Medicaea, Editio
-@cindex hufnagel
-@cindex Petrucci
-@cindex mensural
-
-La gestion par LilyPond des formes de notation ancienne inclut des
-fonctionnalités spécifiques à la notation mensurale et au chant
-grégorien.  La basse chiffrée est également partiellement prise en
-charge.
-
-De nombreux objets graphiques --- @qq{grobs} dans le jargon de LilyPond
---- disposent d'une propriété @code{style}, comme nous le verrons dans
-@itemize @bullet
-@item
-@ref{Ancient note heads},
-@item
-@ref{Ancient accidentals},
-@item
-@ref{Ancient rests},
-@item
-@ref{Ancient clefs},
-@item
-@ref{Ancient flags},
-@item
-@ref{Ancient time signatures}.
-@end itemize
-
-Manipuler cette propriété permet d'adapter l'aspect typographique des
-grobs à une forme de notation particulière, ce qui évite la création de
-nouveaux concepts de notation.
-
-En plus des signes d'articulation standards décrits à la section
-@ref{Articulations}, la notation ancienne dispose de signes particuliers.
-
-@itemize @bullet
-@item
-@ref{Ancient articulations}
-@end itemize
-
-D'autres aspects de la notation ancienne ne peuvent pas être gérés
-aussi simplement qu'en jouant sur les propriétés d'un style appliqué à
-un objet graphique ou en lui ajoutant des articulations.  Certains
-concepts sont spécifiques à la notation ancienne.
-
-@itemize @bullet
-@item
-@ref{Custodes},
-@item
-@ref{Divisiones},
-@item
-@ref{Ligatures}.
-@end itemize
-
-Si tout cela vous dépasse et que vous désirez plonger dans le vif du
-sujet sans trop vous préoccuper d'ajuster des contextes, consultez les
-pages dédiées aux contextes prédéfinis.  Ils vous permettront d'adapter
-vos contextes de voix et de portée, et vous n'aurez plus qu'à saisir les
-notes.
-
-@itemize @bullet
-@item
-@ref{Gregorian Chant contexts},
-@item
-@ref{Mensural contexts}.
-@end itemize
-
-LiliyPond gère partiellement la représentation de basses chiffrées,
-typiques de l'époque baroque, mais également employées de nos jours en
-harmonie et en analyse.
-
-@itemize @bullet
-@item
-@ref{Figured bass}
-@end itemize
-
-Voici les points que nous allons aborder :
-
-@menu
-* Ancient note heads::          
-* Ancient accidentals::         
-* Ancient rests::               
-* Ancient clefs::               
-* Ancient flags::               
-* Ancient time signatures::     
-* Ancient articulations::       
-* Custodes::                    
-* Divisiones::                  
-* Ligatures::                   
-* Gregorian Chant contexts::    
-* Mensural contexts::           
-* Musica ficta accidentals::    
-* Figured bass::                
-@end menu
-
-
-
-@node Ancient note heads
-@subsection Ancient note heads
-
-@cindex têtes de note, musique ancienne
-
-Pour de la musique ancienne, vous disposez de plusieurs styles de tête
-de note, en plus du style par défaut @code{default}.  Vous pouvez
-affecter à la propriété @code{style} de l'objet @internalsref{NoteHead}
-les valeurs @code{baroque}, @code{neomensural}, @code{mensural} ou
-@code{petrucci}.  En style @code{baroque}, la seule différence par
-rapport au style @code{default} concerne la @code{\breve} qui sera
-carrée et non pas ovoïde.  Le style @code{neomensural} ajoute au
-@code{baroque} le fait que les notes de durée inférieure ou égale à une
-ronde sont en forme de losange, et les hampes centrées sur la tête.  Ce
-style est particulièrement adapté à la transcription de la musique
-mesurée dans les incipits.  Le style @code{mensural} permet de
-reproduire les têtes de note telles qu'imprimées au XVIe siècle.  Enfin,
-le style @code{petrucci} imite des partitions historiques, bien
-qu'il utilise de plus grosses têtes de note.
-
-L'exemple suivant illustre le style @code{neomensural}.
-
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override NoteHead #'style = #'neomensural
-a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
-@end lilypond
-
-Si vous écrivez en notation grégorienne, le
-@internalsref{Gregorian_ligature_engraver} se chargera de sélectionner
-les têtes de note appropriées ; il est donc inutile de spécifier le
-style à utiliser.  Vous pouvez cependant spécifier par exemple le style
-@code{vaticana_punctum} pour obtenir des neumes punctums.  De même,
-c'est le @internalsref{Mensural_ligature_engraver} qui se chargera des
-ligatures mensurales.  Consultez la section @ref{Ligatures} pour savoir
-comment fonctionnent les graveurs de ligature.
-
-@seealso
-
-Pour un aperçu de toutes les possibilités,
-consultez @ref{Note head styles}.
-
-
-@node Ancient accidentals
-@subsection Ancient accidentals
-
-@cindex altérations
-
-
-Pour utiliser les formes anciennes d'altération, utilisez la propriété
-@code{glyph-name-alist} des objets graphiques @internalsref{Accidental}
-et @internalsref{KeySignature}.
-
-@lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \fatText
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
-  }
-}
-@end lilypond
-
-Vous noterez que chacun de ces styles ne comporte pas toutes les
-altérations.  LilyPond changera de style s'il y a besoin d'une
-altération indisponible dans le style utilisé, comme vous pouvez le
-constater dans @lsr{ancient,ancient-accidentals.ly}.
-
-À l'instar des altérations accidentelles, le style d'armure est géré
-par la propriété @code{glyph-name-alist} de l'objet
-@internalsref{KeySignature}. 
-
-@seealso
-
-Dans ce manuel : @ref{Pitches}, @ref{Cautionary accidentals}, et
-@ref{Automatic accidentals}, pour les principes généraux d'utilisation
-des altérations ; @ref{Key signature} pour les armures.
-
-Référence du programme : @internalsref{KeySignature}.
-
-Exemples : @lsrdir{ancient}
-
-
-@node Ancient rests
-@subsection Ancient rests
-
-@cindex silences, musique ancienne
-
-La propriété @code{style} de l'objet @internalsref{Rest} permet
-d'obtenir des silences de type ancien.  Vous disposez des styles
-@code{classical}, @code{neomensural} et @code{mensural}.  Le style
-@code{classical} ne se distingue du style @code{default} que par le
-soupir (demi-soupir en miroir). Le style @code{neomensural} convient
-tout à fait à l'incipit lors de la transcription de musique mensurale.
-Le style @code{mensural}, enfin, imite la gravure des silences dans
-certaines éditions du XVIe siècle.
-
-L'exemple suivant illustre le style @code{neomensural}.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override Rest #'style = #'neomensural
-r\longa r\breve r1 r2 r4 r8 r16
-@end lilypond
-
-Les styles @code{mensural} et @code{neomensural} ne disposent pas des 8e
-et 16e de soupir ; LilyPond utilise dans de tels cas le style par
-défaut.  @lsr{pitches,rests} donne une liste exhaustive des silences.
-
-Les silences sont absents de la notation grégorienne ; par contre, cette
-notation utilise des @ref{Divisiones}.
-
-@seealso
-
-Dans ce manuel : @ref{Rests} expose les principes généraux sur
-l'utilisation des silences.
-
-
-@node Ancient clefs
-@subsection Ancient clefs
-
-@cindex clefs
-@cindex clés
-
-Avec LilyPond, de nombreuses clés sont disponibles, dont certaines sont
-dédiées à la musique ancienne.
-
-Le tableau suivant présente les différentes clés anciennes que vous
-pouvez sélectionner avec la commande @code{\clef}.  Certaines de ces
-clés utilisent le même glyphe, attaché à l'une ou l'autre des lignes
-de la portée.  Le chiffre porté en suffixe permet alors de les
-différencier.  Vous pouvez néanmoins forcer le positionnement du
-glyphe sur une ligne, comme expliqué à la section @ref{Clef}.  Dans la
-colonne exemple, la note suivant la clé montre le do médium.
-
-@multitable @columnfractions .4 .4 .2
-@item
-@b{Description}
-@tab
-@b{Clé disponible}
-@tab
-@b{Exemple}
-
-@item
-Clé d'ut, style mensural moderne
-@tab
-@code{neomensural-c1}, @code{neomensural-c2},@*
-@code{neomensural-c3}, @code{neomensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "neomensural-c2" c
-@end lilypond
-
-@item
-Clé d'ut, style mensural Petrucci, positionnable sur différentes
-lignes (clé d'ut seconde pour l'exemple)
-@tab
-@code{petrucci-c1}, @code{petrucci-c2},@*
-@code{petrucci-c3}, @code{petrucci-c4},@*
-@code{petrucci-c5}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé de fa, style mensural Petrucci
-@tab
-@code{petrucci-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé de sol, style mensural Petrucci
-@tab
-@code{petrucci-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé d'ut, style mensural historique
-@tab
-@code{mensural-c1}, @code{mensural-c2},@*
-@code{mensural-c3}, @code{mensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé de fa, style mensural historique
-@tab
-@code{mensural-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé de sol, style mensural historique
-@tab
-@code{mensural-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Clé d'ut, style Editio Vaticana
-@tab
-@code{vaticana-do1}, @code{vaticana-do2},@*
-@code{vaticana-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-do2"
-  c
-@end lilypond
-
-@item
-Clé de fa, style Editio Vaticana
-@tab
-@code{vaticana-fa1}, @code{vaticana-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-fa2"
-  c
-@end lilypond
-
-@item
-Clé d'ut, style Editio Medicaea
-@tab
-@code{medicaea-do1}, @code{medicaea-do2},@*
-@code{medicaea-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-do2"
-  c
-@end lilypond
-
-@item
-Clé de fa, style Editio Medicaea
-@tab
-@code{medicaea-fa1}, @code{medicaea-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-fa2"
-  c
-@end lilypond
-
-@item
-Clé d'ut, style historique Hufnagel
-@tab
-@code{hufnagel-do1}, @code{hufnagel-do2},@*
-@code{hufnagel-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do2"
-  c
-@end lilypond
-
-@item
-Clé de fa, style historique Hufnagel
-@tab
-@code{hufnagel-fa1}, @code{hufnagel-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-fa2"
-  c
-@end lilypond
-
-@item
-Clé combinée ut/fa, style historique Hufnagel
-@tab
-@code{hufnagel-do-fa}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do-fa"
-  c
-@end lilypond
-@end multitable
-
-
-
-@emph{Moderne} signifie @qq{gravé comme dans les transcriptions
-contemporaines de musique mesurée.}
-
-@emph{Petrucci} signifie @qq{inspiré des éditions réalisées par le
-maître graveur Petrucci (1466-1539).}
-
-@emph{Historique} signifie @qq{gravé comme dans les éditions
-historiques, manuscrites ou non, autres que celles de Petrucci.}
-
-@emph{Editio XXX} signifie @qq{gravé comme dans les ouvrages estampillés
-Editio XXX.}
-
-Les clés d'ut de Petrucci avaient une hampe gauche différente selon
-leur ligne de rattachement.
-
-@seealso
-
-Dans ce manuel : voir @ref{Clef}.
-
-@refbugs
-
-La clé de sol mensurale est calquée sur celle de Petrucci.
-
-
-
-@node Ancient flags
-@subsection Ancient flags
-
-@cindex crochets
-
-Le réglage de la propriété @code{flag-style} de l'objet hampe
-(@internalsref{Stem}) donne accès aux crochets de style ancien.  Les
-seuls styles actuellement pris en charge sont @code{default} et
-@code{mensural}.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\override Stem #'flag-style = #'mensural
-\override Stem #'thickness = #1.0
-\override NoteHead #'style = #'mensural
-\autoBeamOff
-c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
-c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
-@end lilypond
-
-Notez que pour chaque crochet mensural, l'extrémité la plus proche de
-la tête de note sera toujours attachée à une ligne de la portée.
-
-Il n'existe pas de crochet spécifique au style néo-mensural.  Nous vous
-conseillons donc, lorsque vous réalisez l'incipit d'une transcription,
-d'utiliser le style par défaut.  Les crochets n'existent pas en notation
-grégorienne.
-
-@refbugs
-
-Les crochets anciens s'attachent aux hampes avec un léger décalage,
-suite à des modifications intervenues au début de la série 2.3.
-
-L'alignement vertical des crochets par rapport aux lignes de la portée
-sous-entend que les hampes se terminent toujours soit sur une ligne,
-soit à l'exact milieu d'un interligne.  Ceci n'est pas toujours
-réalisable, surtout si vous faites appel à des fonctionnalités avancées
-de présentation de la notation classique, qui, par définition, ne sont
-pas prévues pour être appliquées à la notation mensurale.
-
-
-@node Ancient time signatures
-@subsection Ancient time signatures
-
-@cindex métrique
-
-Les chiffrages de métrique mensurale sont partiellement pris en charge.
-Les glyphes ne font que représenter des métriques particulières.  En
-d'autres termes, pour obtenir le glyphe correspondant à une métrique
-mensurale particulière à l'aide de la commande @code{\time n/m}, vous
-devez choisir la paire @code{(n,m)} parmi les valeurs suivantes :
-
-@lilypond[quote,ragged-right]
-\layout {
-  indent = 0.0
-  \context {
-    \Staff
-    \remove Staff_symbol_engraver
-    \remove Clef_engraver
-    \remove Time_signature_engraver
-  }
-}
-{
-  \set Score.timing = ##f
-  \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural44" }
-  s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural22" }
-  s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural64" }
-  s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural68" }
-  \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural32" }
-  s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural34" }
-  s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural94" }
-  s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural98" }
-  \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural48" }
-  s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural24" }
-}
-@end lilypond
-
-La propriété @code{style} de l'objet @internalsref{TimeSignature} permet
-d'accéder aux indicateurs de métrique anciens.  Les styles
-@code{neomensural} et @code{mensural} sont disponibles.  Vous avez vu
-ci-dessus le style @code{neomensural}, particulièrement utilisé pour
-l'incipit des transcriptions.  Le style @code{mensural} imite l'aspect
-de certaines éditions du XVIe siècle.
-
-Voici les différences entre les styles :
-
-@lilypond[ragged-right,fragment,relative=1,quote]
-{
-  \fatText
-
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter default }
-
-  \override Staff.TimeSignature #'style = #'numbered
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter numbered }
-
-  \override Staff.TimeSignature #'style = #'mensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter mensural }
-
-  \override Staff.TimeSignature #'style = #'neomensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter neomensural }
-  \override Staff.TimeSignature #'style = #'single-digit
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter single-digit }
-}
-@end lilypond
-
-@seealso
-
-Dans ce manuel : @ref{Time signature} expose les principes généraux sur
-l'utilisation des indications de métrique.
-
-@refbugs
-
-Les équivalences de durées de note ne sont pas modifiées par un
-changement de métrique.  Par exemple, l'équivalence 1 brève pour 3
-semi-brèves (tempus perfectum) doit s'effectuer à la main en entrant :
-
-@example
-breveTP = #(ly:make-duration -1 0 3 2)
-@dots{}
-@{ c\breveTP f1 @}
-@end example
-
-@noindent
-Ce qui définira @code{breveTP} à 3/2 fois 2 = 3 fois une ronde.
-
-Le symbole @code{old6/8alt} --- symbole alternatif pour la métrique 6/8
---- ne peut être utilisé grâce à une commande @code{\time}.  Utilisez
-plutôt un @code{\markup}.
-
-
-@node Ancient articulations
-@subsection Ancient articulations
-
-@cindex articulations
-
-En plus des signes d'articulation standards décrits à la section
-@ref{Articulations}, LilyPond fournit des articulations pour la musique
-ancienne.  Elles sont spécifiquement destinées au style Editio Vaticana.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \override TextScript #'font-family = #'typewriter
-    \override TextScript #'font-shape = #'upright
-    \override Script #'padding = #-0.1
-    a\ictus_"ictus" \break
-    a\circulus_"circulus" \break
-    a\semicirculus_"semicirculus" \break
-    a\accentus_"accentus" \break
-    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
-  }
-}
-@end lilypond
-
-@refbugs
-
-Certaines articulations sont verticalement trop proches de leurs têtes
-de note.
-
-Le trait d'un episem n'est bien souvent pas apparent et, lorsqu'il
-l'est, son extension à droite est trop longue.
-
-@node Custodes
-@subsection Custodes
-
-@cindex custos
-@cindex custodes
-@cindex guidon
-
-Un guidon --- @emph{custos}, pluriel @emph{custodes} en latin --- est un
-symbole qui apparaît à la fin d'une portée.  Il montre la hauteur de la
-ou des premières notes de la portée suivante, donnant une indication
-judicieuse à l'exécutant.
-
-Les guidons étaient couramment utilisés jusqu'au XVIIe siècle.  De nos
-jours, on les retrouve uniquement dans quelques formes particulières de
-notation telles que les éditions contemporaines de chant grégorien comme
-les @emph{editio vaticana}.  Différents glyphes existent selon le style
-de notation.
-
-L'impression de guidons s'obtient en affectant, dans un bloc
-@code{\layout}, le @internalsref{Custos_engraver} au contexte
-@code{Staff}, comme le montre l'exemple suivant.
-
-@example
-\layout @{
-  \context @{
-    \Staff
-    \consists Custos_engraver
-    Custos \override #'style = #'mensural
-  @}
-@}
-@end example
-
-Le résultat ressemblera à
-
-@lilypond[quote,ragged-right]
-\score {
-{
-  a'1
-  \override Staff.Custos #'style = #'mensural
-  \break
-  g'
-}
-\layout {
-  \context { \Staff \consists Custos_engraver }
-  }
-}
-@end lilypond
-
-Le glyphe du guidon est déterminé par la propriété @code{style}.  Les
-styles disponibles sont @code{vaticana}, @code{medicaea},
-@code{hufnagel} et @code{mensural}.  En voici un aperçu :
-
-@lilypond[quote,ragged-right,fragment]
-\new Lyrics \lyricmode {
-  \markup { \column {
-    \typewriter "vaticana"
-    \line { " " \musicglyph #"custodes.vaticana.u0" }
-  } }
-  \markup { \column {
-    \typewriter "medicaea"
-    \line { " " \musicglyph #"custodes.medicaea.u0" }
-  }}
-  \markup { \column {
-    \typewriter "hufnagel"
-    \line { " " \musicglyph #"custodes.hufnagel.u0" }
-  }}
-  \markup { \column {
-    \typewriter "mensural"
-    \line { " " \musicglyph #"custodes.mensural.u0" }
-  }}
-}
-@end lilypond
-
-@seealso
-
-Référence du programme : @internalsref{Custos}.
-
-Exemples : @lsr{ancient,custodes@/.ly}.
-
-
-@node Divisiones
-@subsection Divisiones
-
-@cindex divisio
-@cindex divisiones
-@cindex finalis
-
-Une division --- @emph{divisio}, pluriel @emph{divisiones} en latin ---
-est un symbole ajouté à la portée et utilisé en chant grégorien pour
-séparer les phrases ou parties.  @emph{Divisio minima}, @emph{divisio
-maior} et @emph{divisio maxima} peuvent respectivement s'interpréter
-comme une pauses courte, moyenne ou longue, à l'image des marques de
-respiration --- cf. @ref{Breath marks}.  Le signe @emph{finalis} n'est
-pas uniquement une marque de fin de chant ; il sert aussi à indiquer la
-fin de chaque partie dans une structure verset/répons.
-
-Les divisions sont disponibles après inclusion du fichier
-@file{gregorian@/-init@/.ly}.  Ce fichier définit les commandes
-@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima} et
-@code{\finalis}.  Certaines éditions utilisent @emph{virgula} ou
-@emph{caesura} en lieu et place de @emph{divisio minima} ; c'est
-pourquoi @file{gregorian@/-init@/.ly} définit aussi @code{\virgula} et
-@code{\caesura}.
-
-@lilypondfile[quote,ragged-right]{divisiones.ly}
-
-@refcommands
-
-@funindex \virgula
-@code{\virgula},
-@funindex \caesura
-@code{\caesura},
-@funindex \divisioMinima
-@code{\divisioMinima},
-@funindex \divisioMaior
-@code{\divisioMaior},
-@funindex \divisioMaxima
-@code{\divisioMaxima},
-@funindex \finalis
-@code{\finalis}.
-
-@seealso
-
-Dans ce manuel : @ref{Breath marks}.
-
-Référence du programme : @internalsref{BreathingSign}.
-
-Exemples : @lsr{expressive,breathing-sign.ly}.
-
-
-@node Ligatures
-@subsection Ligatures
-
-@cindex Ligatures
-
-@c TODO: Should double check if I recalled things correctly when I wrote
-@c down the following paragraph by heart.
-
-Une ligature est un symbole graphique qui représente un groupe d'au
-moins deux notes.  Les ligatures ont commencé à apparaître dans les
-manuscrits de chant grégorien, pour indiquer des suites ascendantes ou
-descendantes de notes.
-
-Les ligatures s'indiquent par une inclusion entre @code{\[} et 
-@code{\]}.  Certains styles de ligature peuvent demander un complément
-de syntaxe spécifique.  Par défaut, le graveur
-@internalsref{LigatureBracket} place un simple crochet au dessus de
-la ligature :
-
-@lilypond[quote,ragged-right,verbatim]
-\transpose c c' {
-  \[ g c a f d' \]
-  a g f
-  \[ e f a g \]
-}
-@end lilypond
-
-Selon le style de ligature désiré, il faut ajouter au contexte
-@internalsref{Voice} le graveur de ligature approprié, comme nous le
-verrons plus loin.  Seules sont disponibles les ligatures mensurales
-blanches, avec quelques limitations.
-
-
-@refbugs
-
-La gestion de l'espacement spécifique aux ligatures n'est à ce jour
-pas implémentée.  En conséquence, les ligatures sont trop espacées les
-unes des autres et les sauts de ligne mal ajustés. De plus, les
-paroles ne s'alignent pas de manière satisfaisante en présence de ligatures.
-
-Les altérations ne pouvant être imprimées à l'intérieur d'une
-ligature, il faut les rassembler et les imprimer juste avant.
-
-La syntaxe utilisée correspond à l'ancienne convention de préfixage
-@code{\[ expr. musicale\]}.  Pour des raisons d'uniformité, nous
-opterons probablement pour le style en suffixe (postfix)  @code{note\[
-... note\]}. 
-En attendant, vous pouvez inclure le fichier
-@file{gregorian@/-init@/.ly}, qui fournit une fonction Scheme 
-@example
-\ligature @var{expr. musicale}
-@end example
-qui produit le même résultat, et dont la pérennité est assurée.
-
-@menu
-* White mensural ligatures::    
-* Gregorian square neumes ligatures::  
-@end menu
-
-@node White mensural ligatures
-@subsubsection White mensural ligatures
-
-@cindex Ligatures mensurales
-@cindex Ligatures mensurales blanches
-
-Les ligatures mensurales blanches sont prises en charge, avec des
-limitations.
-
-La gravure des ligatures mensurales blanches s'obtient après avoir
-ajouté le @internalsref{Mensural_ligature_engraver} et enlevé le
-@internalsref{Ligature_bracket_engraver} dans le contexte
-@internalsref{Voice}, comme ici :
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \remove Ligature_bracket_engraver
-    \consists Mensural_ligature_engraver
-  @}
-@}
-@end example
-
-Lorsque le code ci-dessus est employé, l'aspect d'une ligature mensurale
-blanche est déterminé à partir des hauteurs et durées des notes qui la
-composent.  Bien que cela demande un temps d'adaptation au nouvel
-utilisateur, cette méthode offre l'avantage que toute l'information
-musicale incluse dans la ligature est connue en interne.  Ceci est non
-seulement important pour le rendu MIDI, mais aussi pour des questions de
-transcription automatisée d'une ligature.
-
-Par exemple,
-
-@example
-\set Score.timing = ##f
-\set Score.defaultBarType = "empty"
-\override NoteHead #'style = #'neomensural
-\override Staff.TimeSignature #'style = #'neomensural
-\clef "petrucci-g"
-\[ c'\maxima g \]
-\[ d\longa c\breve f e d \]
-\[ c'\maxima d'\longa \]
-\[ e'1 a g\breve \]
-@end example
-@lilypond[quote,ragged-right]
-\score {
-  \transpose c c' {
-    \set Score.timing = ##f
-    \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'neomensural
-    \override Staff.TimeSignature #'style = #'neomensural
-    \clef "petrucci-g"
-    \[ c'\maxima g \]
-    \[ d\longa c\breve f e d \]
-    \[ c'\maxima d'\longa \]
-    \[ e'1 a g\breve \]
-  }
-  \layout {
-    \context {
-      \Voice
-      \remove Ligature_bracket_engraver
-      \consists Mensural_ligature_engraver
-    }
-  }
-}
-@end lilypond
-
-Si on ne remplace pas le @internalsref{Ligature_bracket_engraver}
-par le @internalsref{Mensural_ligature_engraver}, on obtient
-
-@lilypond[quote,ragged-right]
-\transpose c c' {
-  \set Score.timing = ##f
-  \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'neomensural
-  \override Staff.TimeSignature #'style = #'neomensural
-  \clef "petrucci-g"
-  \[ c'\maxima g \]
-  \[ d\longa c\breve f e d \]
-  \[ c'\maxima d'\longa \]
-  \[ e'1 a g\breve \]
-}
-@end lilypond
-
-@refbugs
-
-L'espacement horizontal n'est pas des meilleurs.
-
-
-@node Gregorian square neumes ligatures
-@subsubsection Gregorian square neumes ligatures
-
-@cindex neumes carrés et ligatures
-@cindex grégorien, ligatures de neumes carrés
-
-Les neumes grégoriens conformément au style des Editio Vaticana sont
-pris en charge de façon assez limitée.  Les ligatures élémentaires sont
-déjà disponibles, mais beaucoup de règles typographiques ne sont pas
-encore implémentées, notamment l'espacement horizontal des enchaînements
-de ligatures, l'alignement des paroles ou une gestion convenable des
-altérations.
-
-Le tableau ci-dessous inventorie les différents neumes contenus dans
-le second tome de l'Antiphonale Romanum (@emph{Liber Hymnarius}) publié
-par l'abbaye de Solesmes en 1983.
-
-@multitable @columnfractions .4 .2 .2 .2
-
-@item
-@b{Neuma aut@*
-Neumarum Elementa}
-@tab
-@b{Figurae@*
-Rectae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Auctae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Deminutae}
-
-@c TODO: \layout block is identical in all of the below examples.
-@c Therefore, it should somehow be included rather than duplicated all
-@c the time. --jr
-
-@c why not make identifiers in ly/engraver-init.ly? --hwn
-
-@c Because it's just used to typeset plain notes without
-@c a staff for demonstration purposes rather than something
-@c special of Gregorian chant notation. --jr
-
-@item
-@code{1. Punctum}
-@tab
-@lilypond[staffsize=26,line-width=1.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum
-    \[ b \]
-    \noBreak s^\markup {"a"} \noBreak
-
-    % Punctum Inclinatum
-    \[ \inclinatum b \]
-    \noBreak s^\markup {"b"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Auctum Ascendens
-    \[ \auctum \ascendens b \]
-    \noBreak s^\markup {"c"} \noBreak
-
-    % Punctum Auctum Descendens
-    \[ \auctum \descendens b \]
-    \noBreak s^\markup {"d"} \noBreak
-
-    % Punctum Inclinatum Auctum
-    \[ \inclinatum \auctum b \]
-    \noBreak s^\markup {"e"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Inclinatum Parvum
-    \[ \inclinatum \deminutum b \]
-    \noBreak s^\markup {"f"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{2. Virga}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Virga
-    \[ \virga b \]
-    \noBreak s^\markup {"g"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{3. Apostropha vel Stropha}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha
-    \[ \stropha b \]
-    \noBreak s^\markup {"h"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha Aucta
-    \[ \stropha \auctum b \]
-    \noBreak s^\markup {"i"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{4. Oriscus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Oriscus
-    \[ \oriscus b \]
-    \noBreak s^\markup {"j"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{5. Clivis vel Flexa}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis vel Flexa
-    \[ b \flexa g \]
-    s^\markup {"k"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis Aucta Descendens
-    \[ b \flexa \auctum \descendens g \]
-    \noBreak s^\markup {"l"} \noBreak
-
-    % Clivis Aucta Ascendens
-    \[ b \flexa \auctum \ascendens g \]
-    \noBreak s^\markup {"m"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Cephalicus
-    \[ b \flexa \deminutum g \]
-    s^\markup {"n"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{6. Podatus vel Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Podatus vel Pes
-    \[ g \pes b \]
-    s^\markup {"o"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens
-    \[ g \pes \auctum \descendens b \]
-    \noBreak s^\markup {"p"} \noBreak
-
-    % Pes Auctus Ascendens
-    \[ g \pes \auctum \ascendens b \]
-    \noBreak s^\markup {"q"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Epiphonus
-    \[ g \pes \deminutum b \]
-    s^\markup {"r"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{7. Pes Quassus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus
-    \[ \oriscus g \pes \virga b \]
-    s^\markup {"s"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus Auctus Descendens
-    \[ \oriscus g \pes \auctum \descendens b \]
-    s^\markup {"t"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{8. Quilisma Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes
-    \[ \quilisma g \pes b \]
-    s^\markup {"u"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes Auctus Descendens
-    \[ \quilisma g \pes \auctum \descendens b \]
-    s^\markup {"v"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{9. Podatus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Initio Debilis
-    \[ \deminutum g \pes b \]
-    s^\markup {"w"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens Initio Debilis
-    \[ \deminutum g \pes \auctum \descendens b \]
-    s^\markup {"x"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{10. Torculus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus
-    \[ a \pes b \flexa g \]
-    s^\markup {"y"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens
-    \[ a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"z"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus
-    \[ a \pes b \flexa \deminutum g \]
-    s^\markup {"A"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{11. Torculus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Initio Debilis
-    \[ \deminutum a \pes b \flexa g \]
-    s^\markup {"B"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens Initio Debilis
-    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"C"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus Initio Debilis
-    \[ \deminutum a \pes b \flexa \deminutum g \]
-    s^\markup {"D"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{12. Porrectus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus
-    \[ a \flexa g \pes b \]
-    s^\markup {"E"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Auctus Descendens
-    \[ a \flexa g \pes \auctum \descendens b \]
-    s^\markup {"F"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Deminutus
-    \[ a \flexa g \pes \deminutum b \]
-    s^\markup {"G"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{13. Climacus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus
-    \[ \virga b \inclinatum a \inclinatum g \]
-    s^\markup {"H"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Auctus
-    \[ \virga b \inclinatum a \inclinatum \auctum g \]
-    s^\markup {"I"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Deminutus
-    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
-    s^\markup {"J"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{14. Scandicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus
-    \[ g \pes a \virga b \]
-    s^\markup {"K"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Auctus Descendens
-    \[ g \pes a \pes \auctum \descendens b \]
-    s^\markup {"L"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Deminutus
-    \[ g \pes a \pes \deminutum b \]
-    s^\markup {"M"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{15. Salicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus
-    \[ g \oriscus a \pes \virga b \]
-    s^\markup {"N"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus Auctus Descendens
-    \[ g \oriscus a \pes \auctum \descendens b \]
-    s^\markup {"O"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{16. Trigonus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Trigonus
-    \[ \stropha b \stropha b \stropha a \]
-    s^\markup {"P"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@tab
-
-@end multitable
-
-
-Contrairement à la majorité des autres systèmes de notation neumatique,
-la manière de saisir les neumes n'a rien à voir avec leur apparence
-typographique ; elle se concentre plutôt sur le sens musical.  Ainsi,
-@code{\[ a \pes b \flexa g \]} produit un @emph{torculus} constitué de
-trois @emph{punctums}, alors que @code{\[ a \flexa g \pes b \]} produit
-un @emph{porrectus} avec une flexe incurvée et un seul @emph{punctum}.
-Il n'existe pas de commande à proprement parler qui permette de
-spécifier la courbe d'une flexe ; c'est la source musicale qui va le
-déterminer.  Le fondement d'une telle approche réside dans la
-distinction que nous faisons entre les aspects musicaux de la source et
-le style de notation que nous voulons obtenir.  De ce fait, la même
-source pourra être utilisée pour imprimer dans un autre style de
-notation grégorienne.
-
-Le tableau suivant présente les fragments de code qui ont permis de
-générer les neumes ligaturés du tableau précédent.  Les lettres de la
-première colonne renvoient aux ligatures ci-dessus.  La seconde
-colonne énumère le nom des ligatures, et la troisième le code ayant
-permis de les générer, se basant ici sur sol, la, si.
-
-@multitable @columnfractions .02 .31 .67
-@item
-@b{#}
-@tab
-@b{Nom}
-@tab
-@b{Code source}
-
-@item
-a
-@tab
-Punctum
-@tab
-@code{\[ b \]}
-
-@item
-b
-@tab
-Punctum Inclinatum
-@tab
-@code{\[ \inclinatum b \]}
-
-@item
-c
-@tab
-Punctum Auctum@*
-Ascendens
-@tab
-@code{\[ \auctum \ascendens b \]}
-
-@item
-d
-@tab
-Punctum Auctum@*
-Descendens
-@tab
-@code{\[ \auctum \descendens b \]}
-
-@item
-e
-@tab
-Punctum Inclinatum@*
-Auctum
-@tab
-@code{\[ \inclinatum \auctum b \]}
-
-@item
-f
-@tab
-Punctum Inclinatum@*
-Parvum @tab
-@code{\[ \inclinatum \deminutum b \]}
-
-@item
-g
-@tab
-Virga
-@tab
-@code{\[ \virga b \]}
-
-@item
-h
-@tab
-Stropha
-@tab
-@code{\[ \stropha b \]}
-
-@item
-i
-@tab
-Stropha Aucta
-@tab
-@code{\[ \stropha \auctum b \]}
-
-@item
-j
-@tab
-Oriscus
-@tab
-@code{\[ \oriscus b \]}
-
-@item
-k
-@tab
-Clivis vel Flexa
-@tab
-@code{\[ b \flexa g \]}
-
-@item
-l
-@tab
-Clivis Aucta@*
-Descendens
-@tab
-@code{\[ b \flexa \auctum \descendens g \]}
-
-@item
-m
-@tab
-Clivis Aucta@*
-Ascendens
-@tab
-@code{\[ b \flexa \auctum \ascendens g \]}
-
-@item
-n
-@tab
-Cephalicus
-@tab
-@code{\[ b \flexa \deminutum g \]}
-
-@item
-o
-@tab
-Podatus vel Pes
-@tab
-@code{\[ g \pes b \]}
-
-@item
-p
-@tab
-Pes Auctus@*
-Descendens
-@tab
-@code{\[ g \pes \auctum \descendens b \]}
-
-@item
-q
-@tab
-Pes Auctus@*
-Ascendens
-@tab
-@code{\[ g \pes \auctum \ascendens b \]}
-
-@item
-r
-@tab
-Epiphonus
-@tab
-@code{\[ g \pes \deminutum b \]}
-
-@item
-s
-@tab
-Pes Quassus
-@tab
-@code{\[ \oriscus g \pes \virga b \]}
-
-@item
-t
-@tab
-Pes Quassus@*
-Auctus Descendens @tab
-@code{\[ \oriscus g \pes \auctum \descendens b \]}
-
-@item
-u
-@tab
-Quilisma Pes
-@tab
-@code{\[ \quilisma g \pes b \]}
-
-@item
-v
-@tab
-Quilisma Pes@*
-Auctus Descendens
-@tab
-@code{\[ \quilisma g \pes \auctum \descendens b \]}
-
-@item
-w
-@tab
-Pes Initio Debilis
-@tab
-@code{\[ \deminutum g \pes b \]}
-
-@item
-x
-@tab
-Pes Auctus Descendens@*
-Initio Debilis
-@tab
-@code{\[ \deminutum g \pes \auctum \descendens b \]}
-
-@item
-y
-@tab
-Torculus
-@tab
-@code{\[ a \pes b \flexa g \]}
-
-@item
-z
-@tab
-Torculus Auctus@*
-Descendens
-@tab
-@code{\[ a \pes b \flexa \auctum \descendens g \]}
-
-@item
-A
-@tab
-Torculus Deminutus
-@tab
-@code{\[ a \pes b \flexa \deminutum g \]}
-
-@item
-B
-@tab
-Torculus Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa g \]}
-
-@item
-C
-@tab
-Torculus Auctus@*
-Descendens Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
-
-@item
-D
-@tab
-Torculus Deminutus@*
-Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
-
-@item
-E
-@tab
-Porrectus
-@tab
-@code{\[ a \flexa g \pes b \]}
-
-@item
-F
-@tab
-Porrectus Auctus@*
-Descendens
-@tab
-@code{\[ a \flexa g \pes \auctum \descendens b \]}
-
-@item
-G
-@tab
-Porrectus Deminutus
-@tab
-@code{\[ a \flexa g \pes \deminutum b \]}
-
-@item
-H
-@tab
-Climacus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum g \]}
-
-@item
-I
-@tab
-Climacus Auctus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
-
-@item
-J
-@tab
-Climacus Deminutus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
-
-@item
-K
-@tab
-Scandicus
-@tab
-@code{\[ g \pes a \virga b \]}
-
-@item
-L
-@tab
-Scandicus Auctus@*
-Descendens
-@tab
-@code{\[ g \pes a \pes \auctum \descendens b \]}
-
-@item
-M
-@tab
-Scandicus Deminutus
-@tab
-@code{\[ g \pes a \pes \deminutum b \]}
-
-@item
-N
-@tab
-Salicus
-@tab
-@code{\[ g \oriscus a \pes \virga b \]}
-
-@item
-O
-@tab
-Salicus Auctus Descendens
-@tab
-@code{\[ g \oriscus a \pes \auctum \descendens b \]}
-
-@item
-P
-@tab
-Trigonus
-@tab
-@code{\[ \stropha b \stropha b \stropha a \]}
-@end multitable
-
-Les ligatures que nous venons de voir, bien que rudimentaires, donnent
-un aperçu des possibilités de former des ligatures grégoriennes.  En
-théorie, vous pouvez inclure entre les délimiteurs @code{\[} et
-@code{\]}, autant de sons que nécessaires à la ligature, ainsi que de
-préfixes tels que @code{\pes}, @code{\flexa}, @code{\virga},
-@code{\inclinatum}, @dots{} Bien sûr, les règles de construction
-présentées ci-dessus peuvent se combiner, ce qui permet la création
-d'une infinité de ligatures.
-
-Les points d'@emph{augmentum}, ou @emph{morae}, s'obtiennent avec la
-fonction @code{\augmentum}.  Notez que cette fonction @code{\augmentum}
-est implémentée en tant que fonction unaire plutôt que comme un préfixe
-de note.  Par conséquent, @code{\augmentum \virga c} ne donnera rien de
-particulier.  Il faut l'utiliser avec la syntaxe @code{\virga \augmentum
-c} ou @code{\augmentum @{\virga c@}}.  Par ailleurs, l'expression
-@code{\augmentum @{a g@}} constitue une forme abrégée de
-@code{\augmentum a \augmentum g}.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \[ \augmentum a \flexa \augmentum g \]
-    \augmentum g
-  }
-}
-@end lilypond
-
-@refcommands
-
-LilyPond dispose des préfixes suivants :
-
-@funindex \virga
-@code{\virga},
-@funindex \stropha
-@code{\stropha},
-@funindex \inclinatum
-@code{\inclinatum},
-@funindex \auctum
-@code{\auctum},
-@funindex \descendens
-@code{\descendens},
-@funindex \ascendens
-@code{\ascendens},
-@funindex \oriscus
-@code{\oriscus},
-@funindex \quilisma
-@code{\quilisma},
-@funindex \deminutum
-@code{\deminutum},
-@funindex \cavum
-@code{\cavum},
-@funindex \linea
-@code{\linea}.
-
-Les préfixes de note peuvent s'agglutiner, modulo quelques restrictions.
-Par exemple, on peut appliquer un @code{\descendens} ou un
-@code{\ascendens} à une note, mais pas les deux simultanément à une même
-note.
-
-@funindex \pes
-@funindex \flexa
-Deux notes adjacentes peuvent être reliées grâce aux commandes
-@code{\pes} ou @code{\flexa} pour marquer une ligne mélodique
-respectivement ascendante ou descendante.
-
-@funindex \augmentum
-Utilisez la fonction musicale unaire @code{\augmentum} pour ajouter
-des points d'augmentum.
-
-@refbugs
-
-Lorsqu'un @code{\augmentum} apparaît dans une ligature en fin de
-portée, son placement vertical peut être erroné.  Pour y remédier,
-ajoutez un silence invisible, @code{s8} par exemple, comme dernière note de
-cette portée.
-
-L'@code{\augmentum} devrait être implémenté en tant que préfixe plutôt
-qu'en tant que fonction unaire, afin qu'@code{\augmentum} puisse
-s'intégrer avec d'autres préfixes dans n'importe quel ordre.
-
-
-@node Gregorian Chant contexts
-@subsection Gregorian Chant contexts
-
-@cindex VaticanaVoiceContext
-@cindex VaticanaStaffContext
-
-Les contextes @code{VaticanaVoiceContext} et
-@code{VaticanaStaffContext} permettent de graver le chant grégorien
-dans le style des éditions vaticanes.  Ces contextes initialisent
-les propriétés de tous les autres contextes et objets graphiques à des
-valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
-lancer dans la saisie de votre chant, comme ci-dessous :
-
-@lilypond[quote,ragged-right,packed,verbatim]
-\include "gregorian-init.ly"
-\score {
-  <<
-    \new VaticanaVoice = "cantus" {
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \]
-      f \divisioMinima
-      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
-      c' \divisioMinima \break
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
-    }
-    \new Lyrics \lyricsto "cantus" {
-      San- ctus, San- ctus, San- ctus
-    }
-  >>
-}
-@end lilypond
-
-
-@node Mensural contexts
-@subsection Mensural contexts
-
-@cindex MensuralVoiceContext
-@cindex MensuralStaffContext
-
-Les contextes @code{MensuralVoiceContext} et
-@code{MensuralStaffContext} permettent de graver des chants
-dans le style mesuré.  Ces contextes initialisent
-les propriétés de tous les autres contextes et objets graphiques à des
-valeurs adéquates, de telle sorte que vous pouvez tout de suite vous
-lancer dans la saisie de votre chant comme ci-après :
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  <<
-    \new MensuralVoice = "discantus" \transpose c c' {
-      \override Score.BarNumber #'transparent = ##t {
-        c'1\melisma bes a g\melismaEnd
-        f\breve
-        \[ f1\melisma a c'\breve d'\melismaEnd \]
-        c'\longa
-        c'\breve\melisma a1 g1\melismaEnd
-        fis\longa^\signumcongruentiae
-      }
-    }
-    \new Lyrics \lyricsto "discantus" {
-      San -- ctus, San -- ctus, San -- ctus
-    }
-  >>
-}
-@end lilypond
-
-
-@node Musica ficta accidentals
-@subsection Musica ficta accidentals
-
-Dans la musique européenne antérieure au XVIIe siècle, les chanteurs
-étaient censés altérer les notes de leur propre initiative.  On appelait
-cela @emph{musica ficta}.  Dans les transcriptions modernes, on a
-l'habitude de placer ces altérations au-dessus de la note concernée.
-
-@cindex altérations, musica ficta
-@cindex musica ficta
-
-De telles altérations suggérées sont disponibles et peuvent être
-activées en assignant à la propriété @code{suggestAccidentals} la valeur
-vrai (@code{#t} pour @q{true}).
-
-@funindex suggestAccidentals
-
-@lilypond[verbatim,fragment,relative=1]
-fis gis
-\set suggestAccidentals = ##t
-ais bis
-@end lilypond
-
-@seealso
-
-Référence du programme : le graveur @internalsref{Accidental_engraver}
-et l'objet @internalsref{AccidentalSuggestion}.
-
-
-@node Figured bass
-@subsection Figured bass
-
-@cindex basse continue
-@cindex basse chiffrée
-
-@c TODO: musicological blurb about FB
-@c librement adapté de
-@c http://en.wikipedia.org/wiki/Basso_continuo#Basso_continuo
-Les parties de basse continue étaient très répandues dans la musique
-baroque et jusqu'à la fin du XVIIIe siècle.  Comme son nom
-l'indique, le @emph{continuo} constitue une partie à lui seul, qui
-se déroule tout au long de l'œuvre pour en donner la structure harmonique. 
-
-Les musiciens du @emph{continuo} jouent des claviers (clavecin,
-orgue) ou de tout autre instrument pouvant réaliser des accords.  Leur
-partie est constituée d'une portée de basse aux notes agrémentées de
-combinaisons de chiffres et signes indiquant le développement des
-accords à jouer, ainsi que leur éventuel renversement.  Cette notation
-était avant tout un guide, invitant le musicien à improviser de
-lui-même l'accompagnement.
-
-LilyPond gère la basse chiffrée. 
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-<<
-  \new Voice { \clef bass dis4 c d ais g fis}
-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
-  }
->>
-@end lilypond
-
-La gestion de la basse chiffrée se décompose en deux parties.  Dans un
-premier temps, le mode @code{\figuremode} permet de saisir les accords
-sous forme chiffrée.  Le contexte @internalsref{FiguredBass} s'occupera
-ensuite de gérer les objets @internalsref{BassFigure}.
-
-En mode de saisie, un chiffrage est délimité par @code{<} et
-@code{>}.  La  durée est indiquée après le @code{>} :
-
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { <4 6> }
-@end lilypond
-
-Les altérations s'obtiennent en ajoutant aux chiffres les caractères
-@code{-}, @code{!} ou @code{+}. Un signe plus s'obtient grâce à
-@code{\+}, et une quinte ou septième diminuée par @code{5/} ou
-@code{7/} respectivement.
-
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
-@end lilypond
-
-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
-markup commands}.
-
-@example
-<[4 6] 8 [_! 12] > <5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
-@end lilypond
-
-
-Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
-prolongation. 
-
-@lilypond[verbatim,relative=1]
-<<
-  \new Staff {
-    \clef bass
-    c4 c c
-  }
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
-  }
->>
-@end lilypond
-
-@noindent
-En pareil cas, la ligne de prolongation masquera toujours le chiffre
-qu'elle rappelle dans le chiffrage suivant.
-
-Le contexte @code{FiguredBass} ne tient aucun compte de la ligne de
-basse.  Par conséquent, il vous faudra peut être insérer des chiffrages
-supplémentaires pour imprimer les prolongations, ou utiliser des
-@code{\!} pour les éviter, comme dans l'exemple suivant :
-
-@lilypond[relative=1]
-<<
-  \new Voice
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
-  }
-  {
-    \clef bass
-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
-  }
->>
-@end lilypond
-
-Lorsque vous utilisez des lignes de prolongation, les chiffres communs
-seront verticalement alignés.  Pour l'éviter, insérez un silence avec
-@code{r} afin de réinitialiser l'alignement.  Par exemple, saisissez
-
-@example
-  <4 6>8 r8
-@end example
-
-@noindent
-au lieu de
-@example
-  <4 6>4
-@end example
-
-On peut choisir d'impriemr les altérations et signes plus aussi bien
-avant qu'après les chiffres, en réglant les propriétés
-@code{figuredBassAlterationDirection} et
-@code{figuredBassPlusDirection}.
-
-@lilypond
-  \figures {
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
-  }
-@end lilypond
-
-
-Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
-des accords, elle est beaucoup plus simpliste.  Le mode
-@code{\figuremode} ne fait que stocker des chiffres que le contexte
-@internalsref{FiguredBass} se chargera d'imprimer tels quels.  En
-aucune manière ils ne sont transformés en son, et ils ne sont pas
-rendus dans un fichier MIDI.
-
-En interne, ce code produit des étiquettes de texte que vous
-pouvez formater à votre convenance grâce aux propriétés des
-étiquettes.  Par exemple, l'espacement vertical des chiffrages est
-déterminé par la propriété @code{baseline-skip}.
-
-
-On peut également ajouter une basse chiffrée directement à un contexte
-@code{Staff}.  L'alignement vertical est alors automatiquement ajusté.
-
-@lilypond[ragged-right,fragment,quote]
-<<
-  \new Staff = someUniqueName
-  \relative c'' {
-    c4 c'8 r8 c,4 c'
-  }
-
-  %% send to existing Staff.
-  \context Staff = someUniqueName 
-  \figuremode {
-    <4>4 <6 10>8 s8
-    
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
-  }
->>
-@end lilypond
-
-
-@commonprop
-
-Par défaut, les chiffres sont imprimés au-dessus de la portée.  Pour les
-imprimer dessous, ajoutez
-
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
-
-
-@refbugs
-
-Si vous positionnez la basse chiffrée au dessus de la portée en ayant
-recours aux lignes d'extension et @code{implicitBassFigures}, les lignes
-peuvent se mélanger.  Préserver l'ordre des prolongateurs peut s'avérer
-impossible lorsque plusieurs chiffrages qui se chevauchent en possèdent.
-Ce problème peut être contourné en jouant sur l'empilement, avec la
-propriété @code{stacking-dir} de l'objet @code{BassFigureAlignment}.
-
-
-@seealso
-
-Référence du programme : les objets @internalsref{NewBassFigure},
-@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
-@internalsref{BassFigureBracket} et
-@internalsref{BassFigureContinuation}, ainsi que le contexte
-@internalsref{FiguredBass}.
-
-
-@node Other instrument specific notation
-@section Other instrument specific notation
-
-Cette section dispense des informations supplémentaires et utiles à
-l'écriture pour certains instruments.
-
-@menu
-* Artificial harmonics (strings)::  
-@end menu
-
-@node Artificial harmonics (strings)
-@subsection Artificial harmonics (strings)
-
-@cindex harmoniques
-
-La plupart des instruments à cordes peuvent produire des harmoniques
-artificiels, lorsque l'instrumentiste effleure simplement la corde pour
-une note donnée.  Le son émis sera un harmonique, que l'on peut indiquer
-par @code{\harmonic}.
-
-@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
-<c g'\harmonic>4
-@end lilypond
-
diff --git a/Documentation/fr/user/introduction.itely b/Documentation/fr/user/introduction.itely
index 1fe2135eec..6b2545a3ac 100644
--- a/Documentation/fr/user/introduction.itely
+++ b/Documentation/fr/user/introduction.itely
@@ -754,22 +754,22 @@ de manière linéaire.
 @ifhtml
 Le
 @end ifhtml
-@emph{@ref{Tutorial}}
+@emph{@ruser{Tutorial}}
 propose une introduction en douceur à la typographie musicale.
 Les utilisateurs débutants sont invités à commencer ici.
 
 @item
-@emph{@ref{Putting it all together}}
+@emph{@ruser{Putting it all together}}
 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{@ref{Working on LilyPond projects}}
+@emph{@ruser{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{@ref{Tweaking output}}
+@emph{@ruser{Tweaking output}}
 est une introduction aux retouches de gravure avec LilyPond.
 
 @end itemize
@@ -784,39 +784,39 @@ concepts exposés dans le manuel d'apprentissage.
 @itemize @bullet
 
 @item
-@emph{@ref{Basic notation}}
+@emph{@ruser{Basic 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{@ref{Instrument-specific notation}}
+@emph{@ruser{Instrument-specific 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{@ref{Advanced notation}}
+@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{@ref{Changing defaults}}
+@emph{@ruser{Changing defaults}}
 explique comment ajuster finement la mise en page.
 
 @item
-@emph{@ref{Non-musical notation}}
+@emph{@ruser{Non-musical notation}}
 traite de sorties non musicales comme les titres, les mouvements
 multiples, et la sélection des instruments MIDI.
 
 @item
-@emph{@ref{Spacing issues}}
+@emph{@ruser{Spacing issues}}
 traite de sujets affectant la sortie globale, comme sélectionner
 la taille de papier ou spécifier les sauts de page.
 
 @item
-@emph{@ref{Interfaces for programmers}}
+@emph{@ruser{Interfaces for programmers}}
 explique comment créer des fonctions de musique.
 
 @end itemize
@@ -826,19 +826,21 @@ explique comment créer des fonctions de musique.
 
 Ce livre contient des tables de référence pratiques.
 
+@c  Nous avons besoin d'ecrivez tous ca, aprez GDP est fini.  -gp
+@ignore 
 @itemize @bullet
 
 @item
 @ifhtml
 La
 @end ifhtml
-@emph{@ref{Literature list}}
+@emph{@ruser{Literature list}}
 contient un choix de livres de référence utiles pour ceux qui veulent
 en savoir plus sur la notation et la gravure.
 
 @item
 Le
-@emph{@ref{Scheme tutorial}}
+@emph{@ruser{Scheme tutorial}}
 propose une courte introduction à Scheme, le langage de programmation
 utilisé dans les fonctions de musique.
 
@@ -846,29 +848,29 @@ utilisé dans les fonctions de musique.
 @ifhtml
 Les
 @end ifhtml
-@emph{@ref{Notation manual tables}}
+@emph{@ruser{Notation manual tables}}
 sont un ensemble de tableaux montrant les noms d'accord, les
 instruments MIDI, les noms de couleur, et la police Feta.
 
 @item
 Les
-@emph{@ref{Templates}}
+@emph{@ruser{Templates}}
 de pièces LilyPond.  Copiez et collez un modèle
 dans un fichier, ajoutez les notes, et c'est prêt !
 
 @item
 L'
-@emph{@ref{Cheat sheet}}
+@emph{@ruser{Cheat sheet}}
 est une référence pratique des commandes LilyPond les plus courantes.
 
 @item
 L'
-@emph{@ref{LilyPond command index}}
+@emph{@ruser{LilyPond command index}}
 est un index de toutes les @code{\commandes} LilyPond.
 
 @item
 L'
-@emph{@ref{LilyPond index}}
+@emph{@ruser{LilyPond index}}
 est un index complet.
 
 @end itemize
@@ -903,7 +905,7 @@ livrés avec le paquetage LilyPond, et convertissent divers formats
 musicaux vers le format @code{.ly}.
 
 @end itemize
-
+@end ignore
 
 
 @subsubheading Autre documentation
@@ -922,7 +924,7 @@ leur traduction dans diverses langues.  C'est un document séparé,
 disponible aux formats HTML et PDF.
 @end iftex
 @ifnottex
-Le @ref{Top,glossaire musical,,music-glossary} explique les termes
+Le @ruser{Top,glossaire musical,,music-glossary} explique les termes
 musicaux et inclut les traductions dans diverses langues.  Il est
 également disponible au format PDF. 
 @end ifnottex
@@ -953,7 +955,7 @@ La
 référence du programme
 @end iftex
 @ifnottex
-@ref{Top,référence du programme,,lilypond-internals}.
+@ruser{Top,référence du programme,,lilypond-internals}.
 @end ifnottex
 est un ensemble de pages HTML étroitement liées entre elles, qui
 documente les moindres petits détails de chaque classe, objet et
diff --git a/Documentation/fr/user/lilypond-book.itely b/Documentation/fr/user/lilypond-book.itely
index 76b3e2565d..d4a58364c7 100644
--- a/Documentation/fr/user/lilypond-book.itely
+++ b/Documentation/fr/user/lilypond-book.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/lilypond-learning.tely b/Documentation/fr/user/lilypond-learning.tely
new file mode 100644
index 0000000000..c1740a2f5f
--- /dev/null
+++ b/Documentation/fr/user/lilypond-learning.tely
@@ -0,0 +1,199 @@
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: e9a620b6e7e1c0a1bf39b7063ff1744ad61efb08
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+@setfilename lilypond-learning.info
+@settitle GNU LilyPond -- manuel d'initiation
+@documentencoding UTF-8
+
+
+@iftex
+@afourpaper
+@c don't replace quotes with directed quotes
+@tex
+\gdef\SETtxicodequoteundirected{Foo}
+\gdef\SETtxicodequotebacktick{Bla}
+@end tex
+@end iftex
+
+
+@c don't remove this comment.
+@ignore
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
+@omfdescription User manual of the LilyPond music engraving system
+@omftype program usage
+@omfcategory Applications|Publishing
+@omflanguage French
+@end ignore
+
+
+@ifhtml
+Ce document est également disponible au format
+@uref{source/Documentation/user/lilypond-learning.fr.pdf,PDF}.
+@end ifhtml
+
+@c urg, makeinfo 4.9.91 French translation is funky
+@iftex
+@documentlanguage fr
+@frenchspacing on
+@end iftex
+
+@c  This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
+
+
+@finalout
+
+@titlepage
+@title LilyPond
+@subtitle Le système de gravure musicale
+@titlefont{Manuel d'initiation}
+@author L'équipe de développement de LilyPond
+
+
+Copyright @copyright{} 1999--2007 by the authors
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{La traduction de la notice de droits d'auteur ci-dessous vise à
+faciliter sa compréhension par le lecteur non anglophone, mais seule la
+notice en anglais a valeur légale.}
+
+@quotation
+Vous avez le droit de copier, distribuer et/ou modifier ce document
+selon les termes de la Licence GNU de documentation libre, version 1.1
+ou tout autre version ultérieure publiée par la Free Software
+Foundation, ``sans aucune section invariante''.
+Une copie de la licence est fournie à la section ``Licence GNU de documentation libre''.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+
+@vskip 20pt
+
+@lilypond[ragged-right]
+\score {
+  \context Lyrics {
+    \override Score.RehearsalMark #'self-alignment-X = #LEFT
+    \override Score.RehearsalMark #'font-size = #-2
+    \mark #(ly:export (string-append
+      "(For LilyPond version " (lilypond-version) ")"))
+    s2
+  }
+  \layout {
+    indent = 0.0\pt
+  }
+}
+@end lilypond
+
+@end titlepage
+
+@copying
+Copyright @copyright{} 1999--2007 by the authors
+
+@emph{The translation of the following copyright notice is provided
+for courtesy to non-English speakers, but only the notice in English
+legally counts.}
+
+@emph{La traduction de la notice de droits d'auteur ci-dessous vise à
+faciliter sa compréhension par le lecteur non anglophone, mais seule la
+notice en anglais a valeur légale.}
+
+@quotation
+Vous avez le droit de copier, distribuer et/ou modifier ce document
+selon les termes de la Licence GNU de documentation libre, version 1.1
+ou tout autre version ultérieure publiée par la Free Software
+Foundation, ``sans aucune section invariante''.
+Une copie de la licence est fournie à la section ``Licence GNU de documentation libre''.
+@end quotation
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end copying
+
+@ifnottex
+This file documents GNU LilyPond program usage.
+
+Copyright 1999--2007 by the authors
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end ifnottex
+
+@ifnottex
+@node Top
+@top GNU LilyPond --- manuel d'initiation
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
+
+Ce document est le manuel d'initiation pour GNU LilyPond 2.11.x.
+@ifhtml
+(Allez au bas de la page pour voir le numéro de version exact).
+@end ifhtml
+
+@cindex web site
+@cindex URL
+
+More information can be found at
+@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
+of this and other documentation.
+
+@menu
+* Preface::
+* Introduction::                   quoi, pourquoi comment.
+* Tutorial::                       un tutoriel d'introduction.
+* Putting it all together::        explication plus détaillée des concepts de LilyPond.
+* Working on LilyPond projects::   traite de l'utilisation quotidienne.
+* Tweaking output::                introduction aux retouches de mise en forme.
+
+Annexes
+
+* GNU Free Documentation License:: licence de ce document.
+* LilyPond index::
+@end menu
+@end ifnottex
+
+@contents
+
+
+@include macros.itexi
+
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include putting.itely
+@include working.itely
+@include tweaks.itely
+
+@include fdl.itexi
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
+
+@bye
diff --git a/Documentation/fr/user/lilypond.tely b/Documentation/fr/user/lilypond.tely
index af2babfc53..b47f0f694c 100644
--- a/Documentation/fr/user/lilypond.tely
+++ b/Documentation/fr/user/lilypond.tely
@@ -1,13 +1,13 @@
 \input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: a8a6ce84e2b7d1bdda6d3cad2f15e6c380edad11
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 @setfilename lilypond.info
-@settitle GNU LilyPond -- manuel de l'utilisateur
+@settitle GNU LilyPond -- manuel de référence
 @documentencoding UTF-8
 
 @iftex
@@ -52,7 +52,7 @@ Ce document est également disponible au format
 @titlepage
 @title GNU LilyPond
 @subtitle Le système de gravure musicale
-@titlefont{Manuel de l'utilisateur}
+@titlefont{Manuel de référence}
 @author L'équipe de développement de LilyPond
 
 
@@ -140,7 +140,7 @@ Free Documentation License''.
 @top GNU LilyPond --- le système de gravure musicale
 @c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
 
-Ce document est le manuel de l'utilisateur pour GNU LilyPond 2.11.x.
+Ce document est le manuel de référence de GNU LilyPond 2.11.x.
 @ifhtml
 (Allez au bas de la page pour voir le numéro de version exact).
 @end ifhtml
@@ -155,21 +155,9 @@ ligne de ce manuel, ainsi qu'une documentation supplémentaire.
 @include dedication.itely
 
 @menu
-Manuel d'apprentissage
-
-* Preface::
-* Introduction::                   quoi, pourquoi comment.
-* Tutorial::                       un tutoriel d'introduction.
-* Putting it all together::        explication plus détaillée des concepts de LilyPond.
-* Working on LilyPond projects::   traite de l'utilisation quotidienne.
-* Tweaking output::                introduction aux retouches de mise en forme.
-
-Manuel de référence
-
-* Basic notation::                 notation musicale standard.
-* Instrument-specific notation::   notation spécifique à des instruments.
-* Advanced notation::              notation plus rarement utilisée.
-* Changing defaults::              retoucher la mise en forme.
+* Musical notation::
+* Specialist notation::
+* Changing defaults::
 * Non-musical notation::           aspects autres que la notation musicale.
 * Spacing issues::                 mise en page de la musique sur le papier.
 * Interfaces for programmers::     utilisation avancée.
@@ -192,17 +180,10 @@ Annexes
 
 
 @include macros.itexi
-@include preface.itely
-@include introduction.itely
-@include tutorial.itely
-@include putting.itely
-@include working.itely
-@include tweaks.itely
 
+@include notation.itely
+@include specialist.itely
 
-@include basic-notation.itely
-@include instrument-notation.itely
-@include advanced-notation.itely
 @include changing-defaults.itely
 @include non-music.itely
 @include spacing.itely
diff --git a/Documentation/fr/user/literature.itely b/Documentation/fr/user/literature.itely
index bc7b0aad2b..14a8063076 100644
--- a/Documentation/fr/user/literature.itely
+++ b/Documentation/fr/user/literature.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 26d8e9ba8a35e1a632d5d0f036c72cd7e5df4ce2
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/macros.itexi b/Documentation/fr/user/macros.itexi
index 3ba23dd914..184955b3bb 100644
--- a/Documentation/fr/user/macros.itexi
+++ b/Documentation/fr/user/macros.itexi
@@ -1,134 +1,187 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @ignore
-    Translation of GIT committish: 6ffead15d2e3dffd294c8e030938facef896d861
+    Translation of GIT committish: d30aabb4adc9e13c7a5a99a22230e97a0f164255
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c **** all formats ****
 
-@macro refbugs
-@noindent
-@subsubheading Bugs
+@c   ***** Displaying text *****
+
+@c we need this since @q{\} doesn't work with makeinfo 4.8 --
+@c say @q{@value{backslash}} instead
+@set backslash \
+
+@c to get decent quotes in `foo' and ``foo''
+@c  these need to be split up so that "@qq{foo}." looks nice.  :(
+@iftex
+@macro q{TEXT}
+`\TEXT\'
+@end macro
 
+@macro qq{TEXT}
+@guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
 @end macro
+@end iftex
 
-@macro moreinfo
-@subheading More information
 
+@ifinfo
+@macro q{TEXT}
+`\TEXT\'
 @end macro
 
-@macro seealso
-@noindent
-@subsubheading See also
+@macro qq{TEXT}
+« \TEXT\ »
+@end macro
+@end ifinfo
 
+
+@ifhtml
+@macro q{TEXT}
+@html
+&lsquo;\TEXT\&rsquo;
+@end html
 @end macro
 
+@c FIXME: hack unbreakable thin spaces
+@macro qq{TEXT}
+@html
+&laquo;&nbsp;\TEXT\&nbsp;&raquo;
+@end html
+@end macro
+@end ifhtml
+
+
+@ifdocbook
+@macro q{TEXT}
+@xml
+&lsquo;\TEXT\&rsquo;
+@end xml
+@end macro
+
+@c FIXME: hack unbreakable thin spaces
+@macro qq{TEXT}
+@xml
+&laquo;&nbsp;\TEXT\&nbsp;&raquo;
+@end xml
+@end macro
+@end ifdocbook
+
+
+
+
+@c   **** Headings in a doc subsection ****
+
 @macro refcommands
 @noindent
 @subsubheading Predefined commands
 
 @end macro
 
-@macro context{NAME}
-@vindex \NAME\
-@code{\NAME\}@c should use internalsref
+@macro commonprop
+@noindent
+@subsubheading Commonly tweaked properties
+
 @end macro
 
-@macro refcommand{WHAT}
-@vindex \WHAT\
-@code{\WHAT\}
+@macro seealso
+@noindent
+@subsubheading See also
+
 @end macro
 
-@macro commonprop
+@macro refbugs
 @noindent
-@subsubheading Commonly tweaked properties
+@subsubheading Bugs
 
 @end macro
 
-@macro funindex {WORD}
-@findex \WORD\
-@kindex \WORD\
+
+@macro context{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}@c should use internalsref
 @end macro
 
+@macro refcommand{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
+@end macro
+
+@macro funindex {TEXT}
+@findex \TEXT\
+@kindex \TEXT\
+@end macro
 
 
-@c  *** Macros with variable output ***
+
+@c   **** Links and references ****
 
 @c usage: @lsr{ancient,custodes.ly}
-@macro lsr{DIR,NAME}
+@macro lsr{DIR,TEXT}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
+@uref{source/input/lsr/\DIR\/collated-files.html#\TEXT\,@file{\DIR\/\TEXT\}}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\/\NAME\}
+@file{\DIR\/\TEXT\}
 @end ifnothtml
 @end macro
 
 @macro lsrdir{DIR}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
+@uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\}
+@file{\DIR\}
 @end ifnothtml
 @end macro
 
 
 
 
-@macro arrow{}
-@iftex
-@tex $\\Rightarrow$ @end tex@c
-@end iftex
-@ifhtml
-@html
-&rarr;
-@end html
-@end ifhtml
-@ifinfo
--->
-@end ifinfo
-@end macro
-
-
-@c we need this since @q{\} doesn't work with makeinfo 4.8 --
-@c say @q{@value{backslash}} instead
-@set backslash \
-
+@c  Definitions for references:
+@c     @internalsref
+@c     @rglos
+@c     @rprogram
+@c     @ruser
+@c     @rlearning
 
 @ifhtml
 @c ***** HTML *****
 
 @c makeinfo-4.7 encodes html names, which means that nodes that
 @c contain nonalphanum characters will be broken links on the website.
-@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
+@c @uref{../lilypond-internals/\TEXT\.html,\TEXT\}@c
 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
 @c better than a broken link.
-@c @inforef{\NAME\,,lilypond-internals}@c
+@c @inforef{\TEXT\,,lilypond-internals}@c
 @c using @ref without punctuation is OK without for formats other than info
 
 @ifset bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals-big-page}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals-big-page}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary-big-page}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary-big-page}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program-big-page}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program-big-page}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-big-page}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-big-page}
+@end macro
+
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning-big-page}
 @end macro
 
 @end ifset
@@ -136,42 +189,32 @@
 
 @ifclear bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@end ifclear
-
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@html
-&lsquo;\TEXT\&rsquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
-@c to get decent French quotes in ``foo''
-@macro qq{TEXT}
-@html
-&laquo;&thinsp;\TEXT\&thinsp;&raquo;
-@end html
-@end macro
+@end ifclear
 
 @end ifhtml
 
@@ -179,38 +222,29 @@
 @ifdocbook
 @c ***** DOCBOOK-XML *****
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@html
-&lsquo;\TEXT\&rsquo;
-@end html
-@end macro
-
-@c to get decent French quotes in ``foo''
-@macro qq{TEXT}
-@html
-&laquo;&thinsp;\TEXT\&thinsp;&raquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifdocbook
@@ -226,31 +260,22 @@
 
 @macro rglos{NAME}
 @vindex \NAME\
-@inforef{\NAME\,,,music-glossary}
+@inforef{\NAME\,,music-glossary}
 @end macro
 
-@macro usermanref{NAME}
-@inforef{\NAME\}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
-@end macro
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
-@end macro
-
-@c to get decent French quotes in ``foo''
-@macro qq{TEXT}
-« \TEXT\ »
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifinfo
@@ -259,57 +284,29 @@
 @c **** TEX ****
 @iftex
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@code{\NAME\}
-@end macro
-
-@macro rglos {NAME}
-@vindex \NAME\
-@code{\NAME\}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro seeinternals{NAME}
-@emph{Référence du programme}, @internalsref{\NAME\}
+@macro rglos {TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro usermanref{NAME}
-@emph{Manuel de l'utilisateur, \NAME\}
+@macro rprogram{TEXT}
+@emph{Manuel d'utilisation du programme, \TEXT\}
 @end macro
 
-@macro rprogram{NAME}
-@emph{Manuel d'utilisation du programme, \NAME\}
+@macro ruser{TEXT}
+@emph{Manuel de l'utilisateur, \TEXT\}
 @end macro
 
-@alias ruser=usermanref
-
-@c to get decent French quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
-@end macro
-
-@c to get decent French quotes in ``foo''
-@macro qq{TEXT}
-@guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
+@macro rlearning{TEXT}
+@emph{Manuel d'apprentissage du programme, \TEXT\}
 @end macro
 
 @end iftex
 
 
-@ifnottex
-@c **** not TEX ****
-
-@macro seeinternals{NAME}
-@internalsref{\NAME\}
-@end macro
-
-@ifnotinfo
-@macro usermanref{NAME}
-@ref{\NAME\}
-@end macro
-@end ifnotinfo
-
-@end ifnottex
-
-
 @c EOF
diff --git a/Documentation/fr/user/non-music.itely b/Documentation/fr/user/non-music.itely
index 0c40352245..b97209ab28 100644
--- a/Documentation/fr/user/non-music.itely
+++ b/Documentation/fr/user/non-music.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
@@ -27,19 +27,14 @@ UNTRANSLATED NODE: IGNORE ME
 UNTRANSLATED NODE: IGNORE ME
 
 @menu 
-* File structure (introduction)::
 * File structure::
 * A single music expression::
 * Multiple scores in a book::
 * Extracting fragments of notation::
 * Including LilyPond files::
 * Text encoding::
+* Different editions from one source::
 @end menu 
-@node File structure (introduction)
-@subsection File structure (introduction)
-
-UNTRANSLATED NODE: IGNORE ME
-
 @node File structure
 @subsection File structure
 
@@ -70,6 +65,11 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
+@node Different editions from one source
+@subsection Different editions from one source
+
+UNTRANSLATED NODE: IGNORE ME
+
 @node Titles and headers
 @section Titles and headers
 
diff --git a/Documentation/fr/user/notation-appendices.itely b/Documentation/fr/user/notation-appendices.itely
index 63c94bdf53..c90df09a0a 100644
--- a/Documentation/fr/user/notation-appendices.itely
+++ b/Documentation/fr/user/notation-appendices.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
@@ -20,6 +20,8 @@ UNTRANSLATED NODE: IGNORE ME
 * List of colors::
 * The Feta font::
 * Note head styles::
+* Overview of text markup commands::
+* Overview of text markup list commands::
 @end menu 
 @node Chord name chart
 @appendixsec Chord name chart
@@ -51,6 +53,18 @@ UNTRANSLATED NODE: IGNORE ME
 
 UNTRANSLATED NODE: IGNORE ME
 
+@node Overview of text markup commands
+@appendixsec Overview of text markup commands
+
+UNTRANSLATED NODE: IGNORE ME
+
+@include markup-commands.tely
+@node Overview of text markup list commands
+@appendixsec Overview of text markup list commands
+
+UNTRANSLATED NODE: IGNORE ME
+
+@include markup-list-commands.tely
 
 -- SKELETON FILE --
 When you actually translate this file, please remove these lines as
diff --git a/Documentation/fr/user/notation.itely b/Documentation/fr/user/notation.itely
new file mode 100644
index 0000000000..93fddb97cc
--- /dev/null
+++ b/Documentation/fr/user/notation.itely
@@ -0,0 +1,33 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Musical notation
+@chapter Musical notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Pitches::            Writing and display the pitches of notes.
+* Rhythms::            Writing and displaying the durations of notes.
+* Expressive marks::   Adding expression to notes.
+* Repeats::            Repeat music.
+* Simultaneous notes:: More than one note at once.
+* Staff notation::     Displaying staves.
+* Educational use::    Special notation to increase legibility.
+* Text::               Adding text to scores.
+@end menu
+
+@include pitches.itely
+@include rhythms.itely
+@include expressive.itely
+@include repeats.itely
+@include simultaneous.itely
+@include staff.itely
+@include educational.itely
+@include text.itely
+
diff --git a/Documentation/fr/user/percussion.itely b/Documentation/fr/user/percussion.itely
new file mode 100644
index 0000000000..b5e989bd0e
--- /dev/null
+++ b/Documentation/fr/user/percussion.itely
@@ -0,0 +1,333 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Percussion
+@section Percussion
+
+@menu 
+* TODO percussion node fix::
+@end menu
+
+@node TODO percussion node fix
+@subsection TODO percussion node fix
+
+La notation rythmique sert avant tout aux parties de percussions ou de
+batterie, mais on peut aussi s'en servir à des fins pédagogiques, pour
+montrer le rythme d'une mélodie.
+
+@menu
+* Showing melody rhythms::      
+* Entering percussion::         
+* Percussion staves::           
+* Ghost notes::                 
+@end menu
+
+
+@node Showing melody rhythms
+@unnumberedsubsubsec Showing melody rhythms
+
+Au moyen d'une portée rythmique -- @q{rhythmic staff} en anglais -- on
+peut montrer seulement le rythme d'une mélodie : toutes les notes sont
+ramenées à la même hauteur, sur une portée d'une seule ligne.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new RhythmicStaff {
+  \time 4/4
+  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
+}
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{RhythmicStaff}.
+
+
+@node Entering percussion
+@unnumberedsubsubsec Entering percussion
+
+@cindex percussions
+@cindex batterie
+
+Les parties de percussions peuvent être saisies avec le mode @code{\drummode},
+qui est l'équivalent du mode standard utilisé pour les notes à hauteur
+déterminée.  Chaque instrument de percussion peut avoir, dans le
+fichier LilyPond, un nom complet et un nom raccourci.
+
+
+@lilypond[quote,ragged-right,verbatim]
+\drums {
+  hihat hh bassdrum bd
+}
+@end lilypond
+
+Ces noms sont inventoriés dans le fichier d'initialisation 
+@file{ly/@/drumpitch@/-init@/.ly}.
+@c TODO: properly document this.
+
+@seealso
+
+Référence du Programme : @internalsref{note-event}.
+
+@node Percussion staves
+@unnumberedsubsubsec Percussion staves
+@cindex percussions
+@cindex batterie
+
+Une partie de percussions utilisant plusieurs instruments requiert en
+général une portée de plusieurs lignes, où chaque hauteur sur la
+portée représente un instrument à percussion.
+
+Pour saisir cette musique, il faut que les notes soient situées dans
+des contextes @internalsref{DrumStaff} et @internalsref{DrumVoice}.
+
+@lilypond[quote,ragged-right,verbatim]
+up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
+down = \drummode { bassdrum4 snare8 bd r bd sn4 }
+  \new DrumStaff <<
+    \new DrumVoice { \voiceOne \up }
+    \new DrumVoice { \voiceTwo \down }
+  >>
+@end lilypond
+
+L'exemple ci-dessus montre une notation polyphonique détaillée.  La
+notation polyphonique abrégée peut être employée lorsque le contexte
+@internalsref{DrumVoice} est spécifié explicitement :
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new DrumStaff <<
+  \new DrumVoice = "1" { s1 *2 }
+  \new DrumVoice = "2" { s1 *2 }
+  \drummode {
+    bd4 sn4 bd4 sn4
+    <<
+      { \repeat unfold 16 hh16 }
+      \\
+      { bd4 sn4 bd4 sn4 }
+    >>
+  }
+>>
+@end lilypond
+
+On peut choisir d'autres mises en forme si l'on définit la propriété
+@code{drumStyleTable} dans le contexte @internalsref{DrumVoice}.  
+Quelques variables prédéfinies sont disponibles :
+
+@table @code
+@item drums-style
+La notation par défaut : une batterie standard, sur une portée de cinq lignes.
+
+
+@lilypond[quote,line-width=10.0\cm]
+nam = \lyricmode {
+  cymc cyms cymr hh hhc hho hhho hhp
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
+mus = \drummode {
+  cymc cyms cymr hh hhc hho hhho hhp \break
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
+\score {
+  << \new DrumStaff \with {
+       \remove Bar_engraver
+       \remove Time_signature_engraver
+       \override Stem #'transparent = ##t
+       \override Stem #'Y-extent-callback = ##f
+       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
+     } \mus
+     \new Lyrics \nam
+  >>
+  \layout {
+    \context {
+      \Score
+      \override LyricText #'font-family = #'typewriter
+      \override BarNumber #'transparent =##T
+    }
+  }
+}
+@end lilypond
+
+Le plan de la batterie peut inclure jusqu'à six toms différents.  Bien
+sûr, vous n'êtes pas obligé de tous les utiliser si la musique en
+prévoit moins ; par exemple, les trois toms des lignes du milieu sont
+@code{tommh}, @code{tomml}, et @code{tomfh}.
+
+@item timbales-style
+Ce style permet de saisir une partie de timbales, sur une portée à deux
+lignes.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { timh ssh timl ssl cb }
+mus = \drummode { timh ssh timl ssl cb s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+    \override StaffSymbol #'line-count = #2
+    \override StaffSymbol #'staff-space = #2
+    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
+    drumStyleTable = #timbales-style
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item congas-style
+Ce style produit une portée à deux lignes pour une partie de congas.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
+mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    drumStyleTable = #congas-style
+    \override StaffSymbol #'line-count = #2
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item bongos-style
+Ce style produit une portée à deux lignes pour une partie de bongos.
+
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
+mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override StaffSymbol #'line-count = #2
+    drumStyleTable = #bongos-style
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item percussion-style
+Ce style permet de saisir toute sorte de percussions sur des portées
+d'une ligne.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
+mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
+
+<<
+  \new DrumStaff \with{
+    \remove Bar_engraver
+    drumStyleTable = #percussion-style
+    \override StaffSymbol #'line-count = #1
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+@end table
+
+Cependant, si aucun des styles prédéfinis ne vous convient, il est aisé
+de définir le vôtre en début de fichier.
+
+@lilypond[quote,ragged-right,verbatim]
+#(define mydrums '(
+         (bassdrum     default   #f         -1)
+         (snare        default   #f         0)
+         (hihat        cross     #f         1)
+         (pedalhihat   xcircle   "stopped"  2)
+         (lowtom       diamond   #f         3)))
+up = \drummode { hh8 hh hh hh hhp4 hhp }
+down = \drummode { bd4 sn bd toml8 toml }
+
+\new DrumStaff <<
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+  \new DrumVoice { \voiceOne \up }
+  \new DrumVoice { \voiceTwo \down }
+>>
+@end lilypond
+
+
+@seealso
+
+Fichier d'initialisation : @file{ly/@/drumpitch@/-init@/.ly}.
+
+Référence du programme : @internalsref{DrumStaff}, @internalsref{DrumVoice}.
+
+@refbugs
+
+La bibliothèque MIDI générale ne contient pas les @emph{rimshots} --- coups
+sur le bord de la caisse claire --- donc ils sont remplacés par des
+@emph{sidesticks,} largement équivalents.
+
+
+
+@c FIXME: check name -gp
+@node Ghost notes
+@unnumberedsubsubsec Ghost notes
+
+Des notes fantômes peuvent être créées pour les parties de percussion,
+grâce à la commande @code{\parenthesize} décrite dans
+@ref{Parentheses}. Cependant, le mode @code{\drummode} n'inclut pas par
+défaut le graveur @code{Parenthesis_engraver} qui permet d'imprimer ces
+signes.  Il faut donc l'ajouter explicitement dans la définition du
+contexte, suivant la manœuvre indiquée dans @ref{Changing context
+properties on the fly}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\new DrumStaff \with {
+  \consists "Parenthesis_engraver"
+} <<
+  \context DrumVoice  = "1"  { s1 *2 }
+  \context DrumVoice  = "2" { s1 *2 }
+  \drummode {
+    <<
+      {
+        hh8[ hh] <hh sn> hh16
+        < \parenthesize sn > hh < \parenthesize
+        sn > hh8 <hh sn> hh
+      } \\ {
+        bd4 r4 bd8 bd r8 bd
+      }
+    >>
+  }
+>>
+@end lilypond
+
+@noindent
+Notez que les commandes @code{\parenthesize} obligent à ajouter des
+accords --- sous la forme @code{< >} --- autour de chaque élément.
+
diff --git a/Documentation/fr/user/piano.itely b/Documentation/fr/user/piano.itely
new file mode 100644
index 0000000000..962cb0631f
--- /dev/null
+++ b/Documentation/fr/user/piano.itely
@@ -0,0 +1,281 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Piano music
+@section Piano music
+
+@menu 
+* TODO piano node fix::
+@end menu
+
+@node TODO piano node fix
+@subsection TODO piano node fix
+
+Les systèmes de piano comprennent deux portées réunies par une accolade.
+Les portées sont largement autonomes, mais il arrive que des voix passent
+de l'une à l'autre.  Cette notation sert également à la harpe ou à d'autres
+instruments à clavier.  Le contexte @internalsref{PianoStaff} est précisément
+conçu pour gérer la notation spécifique au piano, notamment ces croisements.
+
+@menu
+* Automatic staff changes::     
+* Manual staff switches::       
+* Pedals::                      
+* Staff switch lines::          
+* Cross staff stems::           
+@end menu
+
+@refbugs
+
+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}.
+
+@cindex hampe, enjambement portées
+@cindex distance entre deux portées de piano
+
+
+@node Automatic staff changes
+@unnumberedsubsubsec Automatic staff changes
+@cindex Changements de portées automatiques
+
+Les voix peuvent passer automatiquement d'une portée à l'autre, au moyen
+de la syntaxe suivante :
+
+@quotation
+@example
+\autochange @dots{}@var{musique}@dots{}
+@end example
+@end quotation
+
+@noindent
+Deux portées seront alors créées au sein du contexte @code{PianoStaff},
+nommées respectivement @code{up} et @code{down}.  La portée du bas, par
+défaut, sera en clé de fa.
+
+Une section en mode @code{\relative} se situant en dehors de la commande
+@code{\autochange} n'aura pas d'effet sur les hauteurs de l'expression
+@var{musique} ; si on utilise @code{\relative}, il est donc préférable
+de mettre @code{\relative} @emph{après} @code{\autochange} et non avant :
+
+@quotation
+@example
+\autochange \relative @dots{} @dots{}
+@end example
+@end quotation
+
+La commande @code{\autochange} bascule les notes d'une portée à l'autre
+en fonction de leur hauteur (le do du milieu servant de charnière), et
+place les silences en fonction des notes qui les suivront. Ainsi :
+
+@lilypond[quote,verbatim,ragged-right]
+\new PianoStaff
+  \autochange \relative c'
+  {
+    g4 a b c d r4 a g
+  }
+@end lilypond
+
+
+@seealso
+
+Dans ce même manuel : @ref{Manual staff switches}.
+
+Référence du programme : @internalsref{AutoChangeMusic}.
+
+
+
+@refbugs
+
+Les changements de portée automatiques n'interviennent pas toujours à
+l'endroit le plus opportun.  Pour un résultat de meilleure qualité, il
+vaut mieux indiquer soi-même ces changements.
+
+
+@code{\autochange} ne peut intervenir à l'intérieur d'une commande
+@code{\times}.
+
+
+@node Manual staff switches
+@unnumberedsubsubsec Manual staff switches
+
+@cindex changements de portées manuels
+@cindex changement de portée, manuel
+
+Il est possible de passer d'une portée à l'autre de façon manuelle, au
+moyen de la commande
+
+@example
+\change Staff = @var{nomDeLaPortee} @var{musique}
+@end example
+
+@noindent
+La valeur @var{nomDeLaPortee} est le nom de la portée sur laquelle va se
+déplacer la voix courante.  Pour des raisons pratiques, on nomme la portée
+supérieure @code{"haut"} et la portée inférieure @code{"bas"}, donc
+@var{nomDeLaPortee} désigne habituellement @code{"haut"} ou
+@code{"bas"}.  Dans tous les cas, le contexte de portée ainsi utilisé
+doit exister au préalable.  C'est pourquoi il est d'usage de commencer
+par définir les portées
+
+@example
+<<
+  \new Staff = "haut" @{
+    \skip 1 * 10  % @emph{de façon à prolonger la portée}
+    @}
+  \new Staff = "bas" @{
+    \skip 1 * 10  % @emph{idem}
+    @}
+>>
+@end example
+
+
+avant d'insérer une mélodie au moyen d'un contexte @context{Voice} :
+
+@example
+\context Staff = bas
+  \new Voice @{ @dots{} \change Staff = haut @dots{} @}
+@end example
+
+
+@node Pedals
+@unnumberedsubsubsec Pedals
+@cindex Pédales
+
+Le piano possède deux pédales, parfois trois, permettant de modifier
+l'émission du son.  Il est possible d'indiquer précisément chacune
+d'entre elles, en ajoutant à une note ou un accord les commandes
+suivantes :
+@multitable {enfoncerr} {pédale de tenuee} {pédale una cordaa} {\sostenutoDownnnn}
+@item       @tab pédale de tenue @tab pédale @emph{una corda} @tab pédale tonale
+@item enfoncer @tab @code{\sustainDown} @tab @code{\unaCorda} @tab @code{\sostenutoDown}
+@item relâcher @tab @code{\sustainUp}   @tab @code{\treCorde} @tab @code{\sostenutoUp}
+@end multitable
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c'4\sustainDown c'4\sustainUp
+@end lilypond
+
+Les modalités d'impression de ces indications sont définies par la
+propriété @code{pedal@var{X}Strings}, @var{X} étant l'une des trois
+pédales @code{Sustain}, @code{Sostenuto} ou @code{UnaCorda}.  Voyez
+la référence du programme, section @internalsref{SustainPedal}, pour en
+savoir plus.
+
+La propriété @code{pedalSustainStyle} permet différentes notations de
+pédale, en utilisant des crochets
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'bracket
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+@noindent
+ou en mélangeant indications textuelles et crochets
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'mixed
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+@code{text} est le style de notation par défaut pour la pédale de
+tenue --- le traditionnel @q{*Ped.}.  La pédale tonale, en revanche,
+utilise @code{mixed} par défaut.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+Il est possible de d'affiner l'apparence d'un crochet de pédale, au
+moyen des propriétés @code{edge-width}, @code{edge-height}, et
+@code{shorten-pair}, appliquées aux objets @code{PianoPedalBracket} ---
+voir la référence du programme, section
+@internalsref{PianoPedalBracket}. Par exemple, on peut étirer le crochet
+jusqu'à l'extrémité droite de la dernière note :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+@seealso
+
+Dans ce manuel : @ref{Laissez vibrer ties}.
+
+@node Staff switch lines
+@unnumberedsubsubsec Staff switch lines
+
+
+@cindex voix entre deux portées
+@cindex changements de portée
+@cindex mélodie d'une portée à une autre
+
+@funindex followVoice
+
+Lorsqu'une voix change de portée, il est possible d'imprimer
+automatiquement une ligne reliant les notes, en attribuant à la variable
+@code{followVoice} la valeur @emph{vrai} :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \new Staff="one" {
+    \set followVoice = ##t
+    c1
+    \change Staff=two
+    b2 a
+  }
+  \new Staff="two" { \clef bass \skip 1*2 }
+>>
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{VoiceFollower}.
+
+@refcommands
+
+@funindex \showStaffSwitch
+@code{\showStaffSwitch},
+@funindex \hideStaffSwitch
+@code{\hideStaffSwitch}.
+
+
+@node Cross staff stems
+@unnumberedsubsubsec Cross staff stems
+
+Pour écrire des accords qui enjambent deux portées, on allonge la hampe
+de l'accord de l'une des deux portées de façon à ce qu'elle rejoigne celle de
+l'autre portée.
+
+@lilypond[ragged-right,verbatim,quote]
+stemExtend = {
+  \once \override Stem #'length = #10
+  \once \override Stem #'cross-staff = ##t
+}
+noFlag = \once \override Stem #'flag-style = #'no-flag
+\new PianoStaff <<
+  \new Staff {
+    \stemDown \stemExtend
+    f'4
+    \stemExtend \noFlag
+    f'8
+  }
+  \new Staff {
+    \clef bass
+    a4 a8
+  }
+>>
+@end lilypond
+
+
diff --git a/Documentation/fr/user/pitches.itely b/Documentation/fr/user/pitches.itely
new file mode 100644
index 0000000000..68c6bd0af1
--- /dev/null
+++ b/Documentation/fr/user/pitches.itely
@@ -0,0 +1,770 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Pitches
+@section Pitches
+
+This section discusses how to specify the pitch of notes.
+
+@menu
+* Writing pitches::             
+* Changing multiple pitches::   
+* Displaying pitches::          
+@end menu
+
+
+@node Writing pitches
+@subsection Writing pitches
+
+Into text.
+
+@menu
+* Normal pitches::              
+* Accidentals::                 
+* Cautionary accidentals::      
+* Micro tones::                 
+* Note names in other languages::  
+@end menu
+
+@node Normal pitches
+@unnumberedsubsubsec Normal pitches
+
+@cindex noms de note
+@cindex hauteurs
+
+La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
+notation anglaise, en utilisant les lettres @code{a} à @code{g}.
+Une gamme ascendante de do majeur s'écrit
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef bass
+c d e f g a b c'
+@end lilypond
+
+La note @code{c} est écrite une octave sous le do central.
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef treble
+c1
+\clef bass
+c1
+@end lilypond
+
+@funindex '
+@funindex ,
+
+L'octave peut être précisée sous forme d'une série d'apostrophes
+@samp{'} ou d'une série de virgules @samp{,}.  Chaque @samp{'} hausse la
+note d'une octave, chaque @samp{,} baisse la note d'une octave.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\clef treble
+c' c'' e' g d'' d' d c
+\clef bass
+c, c,, e, g d,, d, d c
+@end lilypond
+
+Il existe une autre méthode pour préciser à quelle octave se situe la
+note à graver ; cette méthode demande moins d'indications d'octave
+(@code{'} ou @code{,}) --- voir @ref{Relative octaves}.
+
+
+@node Accidentals
+@unnumberedsubsubsec Accidentals
+
+@cindex noms de note, hollandais
+@cindex noms de note, par défaut
+
+Dans la notation par défaut, un dièse est formé en ajoutant @code{-is}
+après le nom de note, un bémol en ajoutant @code{-es}.  Les
+double-dièses et double-bémols sont obtenus en ajoutant @code{-isis}
+ou @code{-eses} au nom de note.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a2 ais a aes
+a2 aisis a aeses
+@end lilypond
+
+@noindent
+Ce sont les noms de note hollandais.  En hollandais, on élide @code{aes}
+pour écrire @code{as}, mais les deux formes sont acceptées.  De manière
+similaire, on accepte aussi bien @code{es} que @code{ees}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a2 as e es
+@end lilypond
+
+Un bécarre annule l'effet d'une altération, qu'elle soit accidentelle
+ou à l'armure.  Cependant, dans la syntaxe des noms de note, les
+bécarres ne s'écrivent pas avec un suffixe ; un simple nom de note
+donnera une note bécarre.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a4 aes a2
+@end lilypond
+
+LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
+naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
+Pour plus d'information à propos de la distinction entre le contenu
+musical et sa représentation, voir @rlearning{Accidentals and key signatures}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+\key d \major
+d e f g
+d e fis g
+@end lilypond
+
+
+@commonprop
+
+En accord avec les règles standards de l'écriture musicale, on imprime
+un bécarre avant un dièse ou un bémol si on a besoin d'annuler une
+altération précédente.  Pour modifier ce comportement, spécifiez
+@code{\set Staff.extraNatural = ##f}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+ceses4 ces cis c
+\set Staff.extraNatural = ##f
+ceses4 ces cis c
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{LedgerLineSpanner},
+@internalsref{NoteHead}.
+
+
+@node Cautionary accidentals
+@unnumberedsubsubsec Cautionary accidentals
+
+@cindex altération, de précaution
+@cindex altération, entre parenthèses
+@cindex altération de précaution
+@funindex ?
+@cindex altération entre parenthèses
+@funindex !
+
+Normalement, les altérations sont imprimées automatiquement, mais il se
+peut que vous vouliez les imprimer manuellement.  On peut forcer
+l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
+point d'exclamation @samp{!} après la hauteur de note.  Une altération
+entre parenthèses peut être obtenue en ajoutant un point d'interrogation
+@samp{?} après la hauteur de note.  Ces signes peuvent aussi être
+utilisés pour imprimer des bécarres.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+cis cis cis! cis? c c? c! c
+@end lilypond
+
+
+@seealso
+
+L'impression automatique des altérations peut être affinée de plusieurs
+manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
+
+
+@node Micro tones
+@unnumberedsubsubsec Micro tones
+
+@cindex quarts de ton
+@cindex demi-bémols, demi-dièses
+
+Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
+@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
+croissantes :
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Les micro-intervalles sont aussi exportés dans le fichier MIDI.
+
+@refbugs
+
+Il n'y a pas de standard universellement accepté pour noter le bémol et
+demi (qui abaisse la hauteur trois quarts de ton), le symbole de
+LilyPond n'est donc conforme à aucun standard.
+
+
+@node Note names in other languages
+@unnumberedsubsubsec Note names in other languages
+
+Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
+langues.  Pour les utiliser, incluez le fichier d'initialisation
+spécifique à la langue voulue.  Par exemple, pour les langues romanes,
+ajoutez @code{\include "italiano.ly"} au début du fichier source.  Les
+fichiers de langues disponibles ainsi que les noms de notes utilisés
+sont les suivants :
+
+@cindex noms de note, autres langues
+@example
+                       Noms de note              dièse       bémol      double          double
+                                                                        dièse           bémol
+nederlands.ly  c   d   e   f   g   a   bes b   -is         -es          -isis           -eses
+english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat     -ss/-x/         -ff/
+                                                                        -sharpshsarp    -flatflat
+deutsch.ly     c   d   e   f   g   a   b   h   -is         -es          -isis           -eses
+norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es     -ississ/-isis   -essess/-eses
+svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess         -ississ         -essess
+italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b           -dd             -bb
+catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b           -dd/-ss         -bb
+espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b           -ss             -bb
+@end example
+
+@noindent
+Notez qu'en hollandais, en allemand, en norvégien et en suédois, un
+@samp{la} altéré de bemol se note @code{aes} et @code{aeses}.  Ces
+formes sont contractées en @code{as} et @code{ases} (ou plus communément
+@code{asas}).  Dans certains fichiers linguistiques, seules ces formes
+abrégées ont été définies ; ceci s'applique aussi aux suffixes pour les
+quarts de ton.
+
+@noindent
+Certaines musiques utilisent des microtonalités, pour lesquelles les
+altérations sont des fractions de dièse ou bémol @qq{normaux}.  Le
+tableau suivant répertorie les noms de note en quart de ton, tels que
+définis dans plusieurs fichiers linguistiques. Les préfixes @q{semi-} et
+@q{sesqui-} correspondent au @q{demi-} et @q{trois demis}.  À noter
+qu'aucune définition n'existe à ce jour pour le norvégien, le suédois,
+le catalan et l'espagnol.
+
+@c What about Turkish Maquam music and similar microtonal systems?
+@c
+@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
+@c is actually misleading since the alteration is in fact one and a half
+@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
+
+@example
+                        Noms de note           semi-   semi-  sesqui-  sesqui-
+                                               dièse   bémol  dièse    bémol
+
+nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
+english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
+deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
+norsk.ly       c   d   e   f   g   a   b   h   
+svenska.ly     c   d   e   f   g   a   b   h   
+italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
+catalan.ly     do  re  mi  fa  sol la  sib si  
+espanol.ly     do  re  mi  fa  sol la  sib si  
+@end example
+
+
+@node Changing multiple pitches
+@subsection Changing multiple pitches
+
+@menu
+* Relative octaves::            
+* Octave check::                
+* Transpose::                   
+@end menu
+
+@node Relative octaves
+@unnumberedsubsubsec Relative octaves
+
+@cindex relatif
+@cindex indication d'octave relative
+@funindex \relative
+
+On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
+hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
+à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
+Le mode d'écriture \relative prévient ces erreurs dans la mesure où
+elles deviennent beaucoup plus évidentes : une seule erreur décale le
+reste de la pièce à une mauvaise octave.
+
+
+@example
+\relative @var{startpitch} @var{musicexpr}
+@end example
+
+@noindent
+ou
+
+@example
+\relative @var{musicexpr}
+@end example
+
+@noindent
+@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
+définie.
+
+L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
+la manière suivante : si aucun signe de changement d'octave n'est
+utilisé, l'intervalle de base entre la note actuelle et la précédente
+sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
+tenir compte des altérations ; ainsi un @code{fisis} après un
+@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
+une quarte doublement augmentée demeure considérée comme un intervavlle
+plus petit qu'une quinte diminuée, bien que la quarte doublement
+augmentée soit de sept demi-tons et la quinte diminuée de seulement six
+demi-tons.
+
+Les signes de changement d'octave @code{'} et @code{,} peuvent être
+ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
+Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
+départ peut être spécifiée, et agira dès lors comme si elle précédait la
+première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
+spécifiée, le do central sert de point de départ.
+
+Voici le mode \relative en action.
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+On utilise les signes de changement d'octave pour les intervalles
+dépassant la quarte.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Si l'expression précédente est un accord, c'est la première note de
+l'accord qui détermine l'emplacement de la première note du prochain
+accord.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+La hauteur après @code{\relative} contient un nom de note.
+
+La conversion en mode \relative n'affectera pas les sections @code{\transpose},
+@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
+utiliser \relative dans de la musique transposée, un code
+@code{\relative} additionnel doit être placé dans @code{\transpose}.
+
+
+@node Octave check
+@unnumberedsubsubsec Octave check
+
+@cindex vérification d'octave
+
+Les tests d'octave rendent la correction d'erreurs d'octave plus facile
+dans le mode d'octave @code{relative} : une note peut être suivie de
+@code{=}@var{apostrophes/virgules} pour indiquer à quelle octave absolue
+elle devrait être.  Dans l'exemple suivant,
+
+@example
+\relative c'' @{ c='' b=' d,='' @}
+@end example
+
+@noindent
+le @code{d} générera un avertissement, puisqu'on attend un @code{d''}
+mais qu'on obtient un @code{d'} --- il n'y a qu'une tierce entre
+@code{b'} et @code{d''}.  Sur la partition, l'octave sera corrigée pour
+donner un @code{d''} et la prochaine note sera calculée en fonction de
+@code{d''} et non de @code{d'}.
+
+Il existe aussi une vérification d'octave qui ne produit pas de musique
+imprimée, ayant pour syntaxe
+
+@example
+\octave @var{hauteur}
+@end example
+
+Cette commande vérifie que la @var{hauteur} considérée sans apostrophe
+ni virgule et comme hauteur relative, est la même que la @var{hauteur}
+absolue considérée avec ses éventuelles apostrophes ou virgules.  Sinon,
+un avertissement est émis et l'octave est corrigée.  La @var{hauteur}
+n'est pas considérée comme une note, et donc n'est pas imprimée.
+
+Dans l'exemple ci-dessous, le premier test réussit, puisque le @code{e}
+--- dans le mode @code{relative} --- est au plus à une quarte de
+@code{a'}.  Cependant, le deuxième test produit un avertissement,
+puisque le @code{e} est à quinte de @code{b'}.  Le message
+d'avertissement est émis, et l'octave est corrigée afin que les notes
+suivantes soient à nouveau à la bonne octave.
+
+@example
+\relative c' @{
+  e
+  \octave a'
+  \octave b'
+@}
+@end example
+
+L'octave d'une note qui suit un test d'octave est déterminée selon la
+note précédente.  Dans l'exemple suivant, la dernière note est un
+@code{a'}, au-dessus du do central.  Cela veut dire que le test
+@code{\octave} réussit, et peut donc être enlevé sans changer le
+résultat sur la partition.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' {
+  e
+  \octave b
+  a
+}
+@end lilypond
+
+
+@node Transpose
+@unnumberedsubsubsec Transpose
+
+@cindex transposition
+@cindex transposition des hauteurs
+@funindex \transpose
+
+Une expression musicale peut être transposée avec @code{\transpose}.
+Voici la syntaxe :
+@example
+\transpose @var{note_de départ} @var{note_d_arrivée} @var{musicexpr}
+@end example
+
+Cela signifie que @var{musicexpr} est transposé d'un intervalle entre
+les notes @var{note_de_départ} et @var{note_d_arrivée} : toute note
+dont la hauteur était @code{note_de_départ}
+est changée en @code{note_d_arrivée}.
+
+Prenons comme exemple une pièce écrite en ré majeur.  Si cette pièce est
+un peu trop basse pour l'interprète, elle peut être transposée en mi
+majeur avec
+@example
+\transpose d e @dots{}
+@end example
+
+Regardons maintenant une partie écrite pour violon --- un instrument en
+ut).  Si cette partie doit être jouée par une clarinette en la (écrite à
+la tierce mineure supérieure, un do écrit donnant un la réel), la
+transposition suivante créera la partie appropriée.
+
+@example
+\transpose a c @dots{}
+@end example
+
+@code{\transpose} fait la distinction entre les notes enharmoniques :
+@code{\transpose c cis} et @code{\transpose c des} transposeront la
+pièce un demi-ton plus haut.  Mais la première version écrira des
+dièses et la deuxième des bémols.
+
+@lilypond[quote,ragged-right,verbatim]
+mus = { \key d \major cis d fis g }
+\new Staff {
+  \clef "F" \mus
+  \clef "G"
+  \transpose c g' \mus
+  \transpose c f' \mus
+}
+@end lilypond
+
+On peut aussi utiliser @code{\transpose} pour entrer des notes écrites
+pour un instrument transpositeur.  Normalement, les hauteurs dans
+LilyPond sont écrites en ut, i.e. en sons réels, mais elles peuvent être
+écrites dans un autre ton.  Quand, par exemple, on écrit pour une
+trompette en si bémol, commençant sur ré note réelle, on pourrait écrire
+@example
+\transpose c bes @{ e4 @dots{} @}
+@end example
+
+Pour imprimer cette musique en si bémol à nouveau --- et de ce fait
+produire une partie de trompette, au lieu d'un conducteur en notes
+réelles, on utilisera un deuxième @code{transpose}
+
+@example
+\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
+@end example
+
+
+@seealso
+
+Référence du programme : @internalsref{TransposedMusic}.
+
+Exemple : @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
+
+
+@refbugs
+
+Si vous voulez utiliser en même temps @code{\transpose} et
+@code{\relative}, vous devez mettre @code{\transpose} en dehors de
+@code{\relative}, puisque @code{\relative} n'aura aucun effet sur la
+musique apparaissant dans un @code{\transpose}.
+
+@node Displaying pitches
+@subsection Displaying pitches
+
+@menu
+* Clef::                        
+* Key signature::               
+* Ottava brackets::             
+* Instrument transpositions::   
+@end menu
+
+@node Clef
+@unnumberedsubsubsec Clef
+
+@funindex \clef
+
+La clé indique quelles lignes de la portée correspondent à telles
+hauteurs.  Elle est réglée par la commande @code{\clef}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+{ c''2 \clef alto g'2 }
+@end lilypond
+
+@cindex clé de sol
+@cindex clé de fa
+@cindex clé d'ut
+
+Les clés prises en charge sont
+
+@multitable @columnfractions .33 .66
+@headitem Clef @tab Position
+@item @code{treble}, violin, G, G2 @tab Clé de sol 2e ligne
+@item @code{alto, C} @tab Clé d'ut 3e ligne
+@item @code{tenor} @tab Clé d'ut 4e ligne
+@item @code{bass, F} @tab Clé de fa 4e ligne
+@item @code{french} @tab Clé de sol 1e ligne
+@item @code{soprano} @tab Clé d'ut 1e ligne
+@item @code{mezzosoprano} @tab Clé d'ut 2e ligne
+@item @code{baritone} @tab Clé d'ut 5e ligne
+@item @code{varbaritone} @tab Clé de fa 3e ligne
+@item @code{subbass} @tab Clé de fa 5e ligne
+@item @code{percussion} @tab Clé de percussion
+@item @code{tab} @tab Clé de tablature
+@end multitable
+
+En ajoutant @code{_8} ou @code{^8} au nom de la clé, celle-ci est
+transposée à l'octave respectivement inférieure ou supérieure, et
+@code{_15} ou @code{^15} la transpose de deux octaves.  L'argument
+@var{clefname} doit être mis entre guillemets lorsqu'il contient un
+caractère @qq{souligné} ou des chiffres.  Par exemple,
+
+
+@cindex choral tenor clef
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\clef "G_8" c4
+@end lilypond
+
+
+@commonprop
+
+La commande @code{\clef "treble_8"} équivaut à définir @code{clefGlyph},
+@code{clefPosition} --- qui contrôle la position verticale de la clé ---
+@code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
+lorsque l'une de ces propriétés est changée.  Les exemples suivant font
+apparaître des possibilités de réglage manuel de ces propriétés.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \set Staff.clefGlyph = #"clefs.F"
+  \set Staff.clefPosition = #2
+  c'4
+  \set Staff.clefGlyph = #"clefs.G"
+  c'4
+  \set Staff.clefGlyph = #"clefs.C"
+  c'4
+  \set Staff.clefOctavation = #7
+  c'4
+  \set Staff.clefOctavation = #0
+  \set Staff.clefPosition = #0
+  c'4
+  \clef "bass"
+  c'4
+  \set Staff.middleCPosition = #4
+  c'4
+}
+@end lilypond
+
+
+@seealso
+
+Dans ce manuel : @ref{Grace notes}.
+
+Référence du programme : @internalsref{Clef}.
+
+
+@node Key signature
+@unnumberedsubsubsec Key signature
+
+@cindex armure
+@funindex \key
+
+L'armure indique la tonalité dans laquelle la pièce doit être jouée.
+Elle comprend un ensemble d'altérations (dièses ou bémols) à la clé,
+c'est-à-dire au début de la portée.
+
+On définit ou modifie l'armure avec la commande @code{\key}
+
+@example
+@code{\key} @var{hauteur} @var{type}
+@end example
+
+@funindex \minor
+@funindex \major
+@funindex \minor
+@funindex \ionian
+@funindex \locrian
+@funindex \aeolian
+@funindex \mixolydian
+@funindex \lydian
+@funindex \phrygian
+@funindex \dorian
+@cindex modes anciens
+
+Ici, @var{type} doit être @code{\major} ou @code{\minor} afin d'avoir
+respectivement @var{hauteur}-major ou @var{hauteur}-minor.  Vous pouvez
+aussi avoir recours aux modes anciens que sont @code{\ionian},
+@code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
+@code{\phrygian}, et @code{\dorian}.
+
+Cette commande fixe la propriété de contexte @code{Staff.keySignature}.
+Des armures inhabituelles peuvent être spécifiées en modifiant
+directement cette propriété.
+
+Les nouveaux utilisateurs s'embrouillent souvent dans les altérations et
+les armures, car des notes naturelles prennent ou non un bécarre selon
+l'armure.  Pour plus d'informations, voir @ref{Accidentals} ou
+@rlearning{Accidentals and key signatures}.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\key g \major
+f1
+fis
+@end lilypond
+
+
+@commonprop
+
+Un bécarre est imprimé pour annuler toute altération précédente.  Ceci
+peut être supprimé en réglant la propriété
+@code{Staff.printKeyCancellation}.
+
+@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+\set Staff.printKeyCancellation = ##f
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{KeyCancellation},
+@internalsref{KeySignature}.
+
+
+@node Ottava brackets
+@unnumberedsubsubsec Ottava brackets
+
+Les marques d'octaviation, @emph{Ottava}, permettent d'introduire une
+transposition spécifique d'une octave pour la portée en cours.  C'est
+la fonction @code{set-octavation} qui s'en charge.
+
+@cindex ottava
+@cindex 15ma
+@cindex octaviation
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c''' {
+  a2 b
+  #(set-octavation 1)
+  a b
+  #(set-octavation 0)
+  a b
+}
+@end lilypond
+
+La fonction @code{set-octavation} peut aussi prendre en argument les
+valeurs -1@tie{}(pour 8va bassa), 2@tie{}(pour 15ma --- 2 octaves) ou
+-2@tie{}(pour 15ma bassa).   En interne, cette fonction détermine les
+propriétés @code{ottavation} (p.ex. en @code{"8va"} ou @code{"8vb"})
+et @code{centralCPosition}.  Vous pouvez modifier le texte d'une marque
+d'octaviation en définissant @code{ottavation} après avoir fait appel
+à @code{set-octavation} :
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  #(set-octavation 1)
+  \set Staff.ottavation = #"8"
+  c'''
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{OttavaBracket}.
+
+
+@refbugs
+
+@code{set-octavation} gère difficilement les changements de clé qui
+pourraient intervenir alors qu'elle est effective.
+
+
+@node Instrument transpositions
+@unnumberedsubsubsec Instrument transpositions
+
+@cindex transposition, MIDI
+@cindex transposition, instrument
+
+Vous pouvez spécifier la tonalité d'un instrument transpositeur, ce
+qui est le cas pour de nombreux instruments à vent comme la clarinette
+(si bémol, la ou mi bémol), le cor (fa), ou la trompette (si bémol,
+ut, ré ou mi bémol).
+
+Cette transposition s'indique après le mot-clé @code{\transposition}.
+
+@example
+\transposition bes   %% clarinette en si bémol
+@end example
+
+@noindent
+Cette commande détermine la propriété @code{instrumentTransposition},
+dont la valeur sera utilisée pour le fichier MIDI et en cas de
+citation.  Elle n'affecte en rien la manière dont les notes seront
+imprimées sur la portée.  Référez-vous à la section @ref{Transpose}
+pour obtenir un autre résultat.
+
+La hauteur donnée en argument à @code{\transposition} doit
+correspondre à la note entendue lorsqu'un @code{do} écrit sur la
+portée est joué par l'instrument transpositeur.  Par exemple, lorsque
+vous saisissez une partition en notes réelles, toutes les voix
+devraient être en ut ; pour les instruments transpositeurs, il faudra
+procéder de cette manière : 
+
+@example
+clarinet = @{
+  \transposition c'
+  ...
+@}
+saxophone = @{
+  \transposition c'
+  ...
+@}
+@end example
+
+Lorsque vous entrez de la musique à partir d'une partie transposée,
+utilisez la commande @code{\transposition}.  Si l'on prend l'exemple
+des parties de cor, leur tonalité change souvent au cours d'un morceau ;
+en recopiant cette partie, utilisez @code{\transposition} ainsi :
+
+@example
+\transposition d'
+c'4^"en ré"
+...
+\transposition g'
+c'4^"en sol"
+...
+@end example
+
diff --git a/Documentation/fr/user/programming-interface.itely b/Documentation/fr/user/programming-interface.itely
index bec9a0134e..84827e9363 100644
--- a/Documentation/fr/user/programming-interface.itely
+++ b/Documentation/fr/user/programming-interface.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/putting.itely b/Documentation/fr/user/putting.itely
index 524f540332..d2fb6dd8ff 100644
--- a/Documentation/fr/user/putting.itely
+++ b/Documentation/fr/user/putting.itely
@@ -225,7 +225,7 @@ ils l'entendent.  Cependant, les nouveaux utilisateurs peuvent parfois
 se perdre en raison de cette souplesse.  Cette section présente
 sommairement l'organisation du code LilyPond, en privilégiant
 la simplicité au détriment de certains détails.  Vous trouverez une
-description plus complète dans @ref{File structure}.
+description plus complète dans @ruser{File structure}.
 
 La plupart des exemples de ce manuel sont de courts fragments, par exemple
 
@@ -326,17 +326,17 @@ 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 @ref{Saving typing
+@code{laTeteAToto}.  Pour plus de détails, voir @ruser{Saving typing
 with identifiers and functions}.
 
 Pour une description complète du format des fichiers d'entrée, voir 
-@ref{File structure}.
+@ruser{File structure}.
 
 
 @node Score is a single musical expression
 @section Score is a single musical expression
 
-Dans la section précédente, @ref{How LilyPond files work}, nous
+Dans la section précédente, @ruser{How LilyPond files work}, nous
 avons vu l'organisation générale des fichiers d'entrée de LilyPond.
 Mais c'est comme si nous avions éludé la question essentielle : comment
 diable peut-on savoir quoi mettre après @code{\score} ?
@@ -352,7 +352,7 @@ expression musicale.}
 
 @noindent
 Peut-être serait-il judicieux de relire la section
-@ref{Music expressions explained}, dans laquelle vous avez
+@ruser{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,
@@ -461,7 +461,7 @@ mainGauche = @{ @}
 @noindent
 Souvenez-vous que vous pouvez donner aux variables le nom que vous
 voulez, à condition de respecter les caractères autorisés. Ces
-limitations sont décrites dans @ref{File structure}.
+limitations sont décrites dans @ruser{File structure}.
 
 Quand on écrit, ou que l'on lit, une section @code{\score}, mieux vaut
 y aller lentement et soigneusement. Commencez par le niveau le plus
@@ -594,7 +594,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
-@ref{Orchestral music}.
+@ruser{Orchestral music}.
 
 Les variables (@q{propriétés}) réglables sont abordées en détail dans
-@ref{Changing context properties on the fly}.
+@ruser{Changing context properties on the fly}.
diff --git a/Documentation/fr/user/repeats.itely b/Documentation/fr/user/repeats.itely
new file mode 100644
index 0000000000..4961e763c1
--- /dev/null
+++ b/Documentation/fr/user/repeats.itely
@@ -0,0 +1,437 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@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.
+
+@menu
+* Writing repeats::             
+* Other repeats::               
+@end menu
+
+@node Writing repeats
+@subsection Writing repeats
+
+@menu
+* Repeat types::                
+* Repeat syntax::               
+* Manual repeat commands::      
+* Repeats and MIDI::            
+@end menu
+
+
+@node Repeat types
+@unnumberedsubsubsec Repeat types
+
+@cindex reprises et répétitions
+
+On peut indiquer des répétitions des façons suivantes :
+
+@table @code
+@item unfold
+La musique qui doit être répétée sera entièrement imprimée (et jouée).
+Ceci est particulièrement utile dans de la musique répétitive.  Ce type
+de reprise est le seul pris en compte dans le rendu MIDI.
+
+@item volta
+Le passage répété ne sera pas écrit explicitement, mais il sera encadré
+sur la partition par des barres de reprises, et peut se terminer par
+plusieurs fins alternatives, imprimées de gauche à droite sous des
+crochets.  Il s'agit là de la notation courante des reprises avec des
+fins alternatives.  Ces dernières, par défaut, ne sont pas jouées dans
+le rendu MIDI.
+
+@item tremolo
+Pour réaliser des trémolos.  Ceux-ci, par défaut, ne sont pas joués dans
+le rendu MIDI.
+
+@item percent
+Pour répéter des temps ou des mesures, imprimés sous la forme de signes de
+pourcentage.  Ceux-ci, par défaut, ne sont pas joués dans le rendu MIDI.
+Les répétitions indiquées par ces symboles doivent être déclarées dans
+un contexte @code{Voice}.
+
+@end table
+
+
+@node Repeat syntax
+@unnumberedsubsubsec Repeat syntax
+
+@cindex volta
+@cindex première fois
+@cindex seconde fois
+@funindex \repeat
+
+Tous les différents types de reprise se spécifient dans
+LilyPond avec une même construction syntaxique, qui est :
+
+
+@example
+\repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{expression_à_répéter}
+@end example
+
+On peut ajouter, pour indiquer une fin alternative :
+@funindex \alternative
+@example
+\alternative @{
+ @var{alternative1}
+ @var{alternative2}
+ @var{alternative3}
+ @dots{}
+@}
+@end example
+
+@noindent
+chaque @var{alternative} étant une expression musicale.  Si l'on donne
+trop peu d'alternatives en regard du nombre de fois où le passage doit
+être rejoué, la première alternative sera jouée plusieurs fois.
+
+
+Les reprises courantes s'indiquent comme ceci :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 { c4 d e f }
+\repeat volta 2 { f e d c }
+@end lilypond
+
+Et avec des fins alternatives :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f}
+\alternative { {d2 d} {f f,} }
+@end lilypond
+
+Il est possible de créer des répétitions avec une levée.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 e |
+  \repeat volta 4 { c2 d2 | e2 f2 | }
+  \alternative { { g4 g g e } { a a a a | b2. } }
+}
+@end lilypond
+
+@noindent
+ou
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 
+  \repeat volta 4 { e | c2 d2 | e2 f2 | }
+  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+}
+@end lilypond
+
+
+
+@funindex \repeatTie
+Des liaisons de tenue peuvent être ajoutées à toute alternative :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f ~ }
+\alternative { {f2 d} {f\repeatTie f,} }
+@end lilypond
+
+
+On peut raccourcir les crochets indiquant les fins alternatives,
+en définissant la propriété @code{voltaSpannerDuration}.  Dans 
+l'exemple suivant, le crochet ne se prolonge que sur une mesure
+à 3/4.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c''{
+  \time 3/4
+  c c c
+  \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
+  \repeat volta 5 { d d d }
+  \alternative { { e e e f f f }
+  { g g g } }
+}
+@end lilypond
+
+Si l'on souhaite à la fois terminer une ligne par une double barre et
+débuter la ligne suivante avec une section reprise, on peut utiliser
+@example
+@dots{} \bar "||:" \break
+\repeat volta 2 @{ @dots{}
+@end example
+
+Consultez @ref{Bar lines} pour plus d'informations.
+
+@seealso
+
+Program reference: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic}, et
+@internalsref{UnfoldedRepeatedMusic}.
+
+
+Examples
+
+Les crochets précédant une reprise s'impriment d'ordinaire seulement
+au-dessus de la portée du haut.  On peut ajuster cela en déplaçant le
+graveur @code{Volta_engraver} vers les contextes de portée
+(@code{Staff}) qui doivent comporter ces crochets ;
+voir @ref{Modifying context plug-ins} et 
+@lsr{repeats,volta@/-multi@/-staff@/.ly}.
+
+
+@refbugs
+
+@cindex reprises ambigües
+
+Des reprises imbriquées telles que
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+présentent une ambiguïté, dans la mesure où l'on ne sait à quelle
+section @code{\repeat} attribuer la section @code{\alternative}.  Pour
+résoudre cette ambiguïté, il convient de toujours insérer la commande
+@code{\alternative} à l'intérieur de la section @code{\repeat}.  Il est
+préférable, dans une telle situation, d'utiliser des accolades pour plus
+de clarté.
+
+Lorsqu'une alternative commence, les informations de métrique sont
+perdues, il faut donc les rappeler après une reprise, par exemple
+en définissant @code{Score.measurePosition} ou en invoquant la commande
+@code{\partial}.  De même, aucune liaison (de tenue ou autre)
+n'est répétée.
+
+Les crochets qui indiquent les alternatives ne sont pas alignés 
+verticalement.
+
+
+@node Manual repeat commands
+@unnumberedsubsubsec Manual repeat commands
+
+@funindex repeatCommands
+
+La propriété @code{repeatCommands} sert à contrôler la mise en forme des
+reprises.  On la définit par une suite de commandes de reprise Scheme.
+
+@table @asis
+@item @code{start-repeat}
+Pour imprimer une barre de reprise @code{|:}
+
+@item @code{end-repeat}
+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}.
+Attention cependant à changer la police, car la police employée par
+défaut pour les chiffres ne contient aucun caractère alphabétique.
+
+@item @code{(volta #f)}
+Pour terminer un crochet indiquant une alternative.
+@end table
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c4
+  \set Score.repeatCommands = #'((volta "93") end-repeat)
+c4 c4
+  \set Score.repeatCommands = #'((volta #f))
+c4 c4
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic}, et
+@internalsref{UnfoldedRepeatedMusic}.
+
+
+@node Repeats and MIDI
+@unnumberedsubsubsec Repeats and MIDI
+
+@cindex reprises développées
+@funindex \unfoldRepeats
+
+Au prix de quelques réglages, les reprises de toutes sortes peuvent être
+rendues dans le fichier MIDI.  Il suffit pour cela de recourir à la
+fonction @code{\unfoldRepeats}, qui développe toutes les reprises.  En
+d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
+en reprises de type @code{unfold}.
+
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+  \repeat tremolo 8 {c'32 e' }
+  \repeat percent 2 { c''8 d'' }
+  \repeat volta 2 {c'4 d' e' f'}
+  \alternative {
+    { g' a' a' g' }
+    {f' e' d' c' }
+  }
+}
+\bar "|."
+@end lilypond
+
+
+Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
+MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI, avec
+des reprises explicites, et l'autre pour la partition, avec des reprises
+notées sous forme de barres de reprise, de trémolo ou de symboles de
+pourcentage.  Par exemple
+
+@example
+\score @{
+ @var{..musique..}
+ \layout @{ ..  @}
+@}
+\score @{
+ \unfoldRepeats @var{..musique..}
+ \midi @{ ..  @}
+@}
+@end example
+
+
+@node Other repeats
+@subsection Other repeats
+
+@menu
+* Tremolo repeats::             
+* Tremolo subdivisions::        
+* Measure repeats::             
+@end menu
+
+@node Tremolo repeats
+@unnumberedsubsubsec Tremolo repeats
+
+@cindex ligatures de trémolo
+@cindex trémolo, ligatures de
+
+On peut placer une notation de trémolo entre deux notes, avec la
+commande @code{\repeat} suivie du style trémolo :
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat tremolo 8 { c16 d16 }
+  \repeat tremolo 4 { c16 d16 }
+  \repeat tremolo 2 { c16 d16 }
+}
+@end lilypond
+
+
+On peut aussi indiquer un trémolo sur une seule note, qu'il faudra
+alors laisser sans accolades.
+
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
+@end lilypond
+
+
+La subdivision des trémolos aboutit à un résultat semblable : voir
+@ref{Tremolo subdivisions}.
+
+
+@seealso
+
+Dans ce manuel : @ref{Tremolo subdivisions}, @ref{Repeats}.
+
+Référence du programme : @internalsref{Beam}, @internalsref{StemTremolo}.
+
+
+@node Tremolo subdivisions
+@unnumberedsubsubsec Tremolo subdivisions
+
+@cindex trémolo, indication de
+@funindex tremoloFlags
+
+Un trémolo peut être indiqué sur une seule note, en la faisant suivre
+de deux points et d'un nombre :
+
+@code{note:}[@var{nombre}]. 
+
+Le nombre en question correspond à la valeur de la subdivision ;
+il doit être au moins de 8, auquel cas la hampe sera barrée par un 
+seul trait de ligature.  Si ce nombre est omis, la dernière valeur ---
+telle que mémorisée dans @code{tremoloFlags} --- sera utilisée.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+c'2:8 c':32 | c': c': |
+@end lilypond
+
+
+@refbugs
+
+Les trémolos entrés de cette manière ne sont pas rendus dans
+le fichier MIDI.
+
+
+@seealso
+
+Dans ce manuel : @ref{Tremolo repeats}.
+
+Référence du programme : @internalsref{StemTremolo}.
+
+
+@node Measure repeats
+@unnumberedsubsubsec Measure repeats
+
+@cindex percent repeats
+@cindex measure repeats
+
+Le style de @qq{reprise en pourcent} sert à répéter une séquence de
+notes.  Elle sera imprimée une fois, puis remplacée par un symbole
+spécial.  Les séquences d'une ou deux mesures sont remplacées par un
+symbole qui ressemble au symbole de pourcentage, tandis que les
+séquences inférieures à une mesure sont remplacées par une barre
+oblique.  Toutes ces répétitions doivent être déclarées dans un contexte
+@code{Voice}.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
+}
+@end lilypond
+
+Les répétitions de plus de 2 mesures sont surmontées d'un compteur,
+si l'on assigne @emph{vrai} (lettre @q{t}) à la propriété
+@code{countPercentRepeats}.
+
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+  \repeat percent 4 { c1 }
+}
+@end lilypond
+
+Des symboles de pourcentage isolés peuvent aussi être obtenus, au
+moyen d'un silence multi-mesures dont on modifie l'aspect :
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+  = #ly:multi-measure-rest::percent
+R1
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
+
diff --git a/Documentation/fr/user/rhythms.itely b/Documentation/fr/user/rhythms.itely
new file mode 100644
index 0000000000..1acb7ef84c
--- /dev/null
+++ b/Documentation/fr/user/rhythms.itely
@@ -0,0 +1,1758 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Rhythms
+@section Rhythms
+
+This section discusses rhythms, durations, and bars.
+
+@menu
+* Writing rhythms::             
+* Writing rests::               
+* Displaying rhythms::          
+* Beams::                       
+* Bars::                        
+* Special rhythmic concerns::   
+@end menu
+
+
+@node Writing rhythms
+@subsection Writing rhythms
+
+@menu
+* Durations::                   
+* Augmentation dots::           
+* Tuplets::                     
+* Scaling durations::           
+@end menu
+
+@node Durations
+@unnumberedsubsubsec Durations
+
+@cindex durées
+@funindex \longa
+@funindex \breve
+@funindex \maxima
+
+Dans les modes de notes, d'accords et de paroles, les durées sont
+écrites avec des chiffres et des points : les durées sont indiquées par
+leur valeur fractionnaire par rapport à la durée d'une ronde.  Une
+noire, par exemple, qui équivaut à un 1/4 de ronde --- @qq{quarter note}
+en anglais --- s'écrit @code{4}, alors qu'une blanche ---
+@qq{half-note}, 1/2 ronde --- s'écrit @code{2}.  Pour des notes plus
+longues qu'une ronde, vous devrez utiliser les commandes @code{\longa}
+pour une longue, et @code{\breve} pour une brève, aussi appelée carrée.
+
+@example
+c'\breve
+c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
+r\longa r\breve
+r1 r2 r4 r8 r16 r32 r64 r64
+@end example
+
+@lilypond[quote]
+\score {
+\relative c'' {
+    a\breve*1/2 \autoBeamOff
+    a1 a2 a4 a8 a16 a32 a64 a64
+   \bar "empty"
+   \break
+    r\longa*1/4 r\breve *1/2
+    r1 r2 r4 r8 r16 r32 r64 r64
+  }
+  \layout {
+    ragged-right = ##t
+    indent=0\mm
+    \context {
+      \Score
+        \remove "Bar_number_engraver"
+    }
+    \context {
+      \Staff
+        \remove "Clef_engraver"
+        \override StaffSymbol #'transparent = ##t
+        \override TimeSignature #'transparent = ##t
+        \override BarLine #'transparent = ##t
+        \consists "Pitch_squash_engraver"
+    }
+  }
+}
+@end lilypond
+
+Si la durée n'est pas précisée, elle est alors assimilée à la durée
+précédente.  La valeur par défaut pour la première note est une noire
+(4).
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+{ a a a2 a a4 a a1 a }
+@end lilypond
+
+
+@node Augmentation dots
+@unnumberedsubsubsec Augmentation dots
+
+@funindex .
+
+Pour obtenir des notes pointées, ajoutez simplement un point
+(@samp{.}) au chiffre.  Les notes doublement pointées sont créées de
+la même façon.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+a'4 b' c''4. b'8 a'4. b'4.. c''8.
+@end lilypond
+
+@refcommands
+
+Les points sont normalement haussés pour éviter les lignes de portées,
+sauf dans certaines polyphonies.  Les commandes suivantes peuvent être
+utilisées pour demander manuellement une orientation particulière des
+points.
+
+@funindex \dotsUp
+@code{\dotsUp},
+@funindex \dotsDown
+@code{\dotsDown},
+@funindex \dotsNeutral
+@code{\dotsNeutral}.
+
+@seealso
+
+Référence du programme : @internalsref{Dots}, @internalsref{DotColumn}.
+
+
+@node Tuplets
+@unnumberedsubsubsec Tuplets
+
+@cindex nolets
+@cindex triolets
+@funindex \times
+
+Les nolets --- triolets, quintolets, etc. --- sont obtenus en
+multipliant toutes les durées d'une expression musicale par une
+fraction.
+
+@example
+\times @var{fraction} @var{expr_musique}
+@end example
+
+@noindent
+La durée de @var{expr_musique} sera multipliée par la fraction.  Le
+dénominateur de la fraction sera imprimé au-dessus des notes, parfois
+avec un crochet.  Le nolet le plus courant est le triolet, dans lequel 3
+notes ont la durée de 2, et où les notes durent donc 2/3 de leur valeur
+écrite.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+g'4 \times 2/3 {c'4 c' c'} d'4 d'4
+@end lilypond
+
+Les nolets peuvent être imbriqués ; par exemple,
+
+@lilypond[fragment,ragged-right,verbatim,relative=2]
+\override TupletNumber #'text = #tuplet-number::calc-fraction-text
+\times 4/6 {
+  a4 a
+  \times 3/5 { a a a a a }
+}
+@end lilypond
+
+@refcommands
+
+@funindex \tupletUp
+@code{\tupletUp},
+@funindex \tupletDown
+@code{\tupletDown},
+@funindex \tupletNeutral
+@code{\tupletNeutral}.
+
+
+@commonprop
+
+@funindex tupletNumberFormatFunction
+@cindex nolets, formatage
+
+La propriété @code{tupletSpannerDuration} spécifie la longueur voulue de
+chaque crochet.  Avec elle, vous pouvez faire plusieurs nolets en ne
+tapant @code{\times} qu'une fois, ce qui évite une longue saisie.  Dans
+le prochain exemple, deux triolets sont imprimés avec une seule fonction
+@code{\times}.
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\set tupletSpannerDuration = #(ly:make-moment 1 4)
+\times 2/3 { c8 c c c c c }
+@end lilypond
+
+@noindent
+Pour plus d'information sur @code{make-moment}, voir
+@ref{Time administration}.
+
+L'apparence du chiffre est déterminée par la propriété @code{text} dans
+@code{TupletNumber}.  La valeur par défaut imprime seulement le
+dénominateur, mais si elle est définie par la fonction
+@code{tuplet-number::calc-fraction-text}, la fraction entière
+@var{num}:@var{den} sera imprimée à la place.
+
+Pour éviter d'imprimer les chiffres des nolets, utilisez
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+\override TupletNumber #'transparent = ##t
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+@end lilypond
+
+Utilisez la fonction @code{\tweak} pour définir une priorité dans le cas
+de nolets imbriqués débutant au même moment.  Dans cet exemple,
+@code{\tweak} spécifie un texte sous forme de fraction pour le
+@code{TupletNumber} externe et de dénominateur pour les trois triolets
+internes.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \times 4/3 {
+     \tweak #'text #tuplet-number::calc-denominator-text
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Ici, @code{\tweak} et @code{\override} agissent de concert pour
+spécifier le positionnement du @code{TupletBracket}.  Le premier
+@code{\tweak} positionne le @code{TupletBracket} du nolet externe au
+dessus de la portée. Le second @code{\tweak} positionne le
+@code{TupletBracket} du premier triolet interne au dessous de la
+portée.  Notez que cette paire de fonctions @code{\tweak} n'affecte
+que le triolet extérieur et le premier des trois triolets imbriqués
+parce qu'ils commencent au même instant musical.  Nous utilisons
+@code{\override} de manière tout à fait normale, pour forcer le
+positionnement du @code{TupletBracket} des deuxième et troisième
+triolets en dessous de la portée.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff {
+  \tweak #'text #tuplet-number::calc-fraction-text
+  \tweak #'direction #up
+  \times 4/3 {
+     \tweak #'direction #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \override TupletBracket #'direction = #down
+     \times 2/3 { c'8[ c'8 c'8] }
+     \times 2/3 { c'8[ c'8 c'8] }
+  }
+}
+@end lilypond
+
+Les crochets de nolets peuvent aller jusqu'aux prémisses de la mesure
+suivante, ou à la prochaine note.
+
+@lilypond[ragged-right]
+\new RhythmicStaff {
+  \set tupletFullLength = ##t
+  \time 4/4
+  \times 4/5 {
+    c4 c1
+  }
+  \set tupletFullLengthNote = ##t
+  \time 2/4
+  \times 2/3 {
+    c4 c c 
+  }
+  \time 3/4
+  c4 
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{TupletBracket},
+@internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
+
+
+
+@node Scaling durations
+@unnumberedsubsubsec Scaling durations
+
+Vous pouvez altérer la durée des notes en leur joignant une fraction
+@var{N/M}, donnant @q{@code{*}@var{N/M}} --- ou @q{@code{*}@var{N}} si
+@var{M=1}.  Ceci n'affectera pas l'apparence des notes ou silences
+produits.
+
+Dans l'exemple suivant, les trois premières notes prennent exactement
+deux temps, mais aucun triolet n'est imprimé.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\time 2/4
+a4*2/3 gis4*2/3 a4*2/3
+a4 a4 a4*2
+b16*4 c4
+@end lilypond
+
+
+@seealso
+
+Dans ce manuel : @ref{Tuplets}.
+
+
+@node Writing rests
+@subsection Writing rests
+
+@menu
+* Rests::                       
+* Skips::                       
+* Multi measure rests::         
+@end menu
+
+@node Rests
+@unnumberedsubsubsec Rests
+@cindex silences
+
+@funindex \rest
+@funindex r
+
+Les silences sont écrits comme des notes avec le nom de note @code{r}.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+r1 r2 r4 r8
+@end lilypond
+
+Les pauses d'une mesure complète, qui sont placées au centre de la
+mesure, doivent être entrées comme des mesures de silence.  Elles
+peuvent être utilisées pour une seule mesure comme pour plusieurs, et
+leur utilisation est expliquée dans la section
+@ref{Multi measure rests}.
+
+Pour spécifier explicitement la position verticale d'un silence, écrivez
+une note suivie de @code{\rest}.  Un silence sera placé à la position où
+serait imprimée la note.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+a'4\rest d'4\rest
+@end lilypond
+
+@noindent
+Cela rend plus facile la mise en place de la musique polyphonique,
+puisque le formateur automatique de collision des silences laissera ces
+silences tranquilles.
+
+@seealso
+
+Référence du programme : @internalsref{Rest}.
+
+
+@node Skips
+@unnumberedsubsubsec Skips
+
+@cindex sauts de durée
+@cindex silences invisibles
+@cindex silences d'espacement
+@funindex \skip
+@funindex s
+
+Un silence invisible --- que l'on pourrait appeler un @qq{saut} ---
+peut être entré comme une note avec le nom de note `@samp{s}' ou avec
+@code{\skip @var{durée}}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a4 a4 s4 a4 \skip 1 a4
+@end lilypond
+
+La syntaxe @code{s} est seulement disponible pour les modes d'entrée
+de notes et d'accords.  Dans d'autres situations, pour l'entrée de
+paroles par exemple, vous devrez utiliser la commande @code{\skip}.
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+  \relative { a'2 a2 }
+  \new Lyrics \lyricmode { \skip 2 bla2 }
+>>
+@end lilypond
+
+La commande de saut génère simplement une case musicale vide.  Elle ne
+produit rien sur la partition, pas même un symbole transparent.  Le code
+de saut @code{s} crée tout de même une @internalsref{Staff} et une
+@internalsref{Voice} lorsque nécessaire, tout comme les commandes de
+note et de silence.  Ainsi, le code suivant aboutit à une portée vide.
+
+@lilypond[quote,ragged-right,verbatim]
+{ s4 }
+@end lilypond
+
+Le fragment @code{@{ \skip 4 @} } produirait une page vide.
+
+@seealso
+
+Référence du programme : @internalsref{SkipMusic}.
+
+
+@node Multi measure rests
+@unnumberedsubsubsec Multi measure rests
+
+@cindex mesures à compter
+@cindex mesure entière de silence
+@cindex Silences, multi-mesures
+@cindex Silences, mesure entère
+@cindex une pause par mesure
+@funindex R
+
+Un silence valant une ou plusieurs mesures entières s'entre avec un
+@samp{R} majuscule.  Ceci ne peut être utile que pour une mesure complètement
+vide, et pour générer des parties séparées : ce silence sera alors
+répété sur autant de mesures que nécessaire, ou bien imprimé une seule
+fois.  La répétition est contrôlée par la propriété
+@code{Score.skipBars}.  Au cas où ce commutateur est défini comme
+vrai (lettre @code{##t} pour @q{true}), les mesures vides ne seront pas répétées, et le nombre exact de
+mesures sera ajouté.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
+\set Score.skipBars = ##t R1*17 R1*4
+@end lilypond
+
+Le @code{1} de @code{R1} est le même que celui utilisé pour la durée
+des notes.  Vous devrez donc, si le morceau n'est pas à 4/4, stipuler
+un autre durée, qui pourra contenir des points d'augmentation ou être
+libellé sous forme de fraction :
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+\time 3/4
+R2. | R2.*2
+\time 13/8
+R1*13/8
+R1*13/8*12 |
+\time 10/8 R4*5*4 |
+@end lilypond
+
+Un @code{R} qui s'étend sur une seule mesure s'imprime tantôt comme
+une pause, tantôt comme une brève, et sera centré sur la mesure
+quelle que soit la métrique.
+
+Dans le cas où ce silence ne dure que quelques mesures, LilyPond
+imprime sur la portée des @qq{ silences d'église }, simple suite de
+rectangles.  La propriété @code{MultiMeasureRest.expand-limit} permet
+d'obtenir un silence unique.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+R1*2 | R1*5 | R1*9
+\override MultiMeasureRest #'expand-limit = 1
+R1*2 | R1*5 | R1*9
+@end lilypond
+
+@cindex texte et silence multi-mesures
+@cindex script et silence multi-mesures
+@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
+variable @code{\fermataMarkup} permet d'ajouter un point d'orgue.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\set Score.skipBars = ##t
+\time 3/4
+R2.*10^\markup { \italic "ad lib." }
+R2.^\fermataMarkup
+@end lilypond
+
+Attention !  c'est @code{MultiMeasureRestText} qui créera le texte, et
+non @code{TextScript}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\override TextScript #'padding = #5
+R1^"low"
+\override MultiMeasureRestText #'padding = #5
+R1^"high"
+@end lilypond
+
+Pour aligner votre texte sur le début de la mesure, rattachez-le à un
+silence invisible de longueur zéro comme ceci :
+
+@example
+s1*0^"Allegro"
+R1*4
+@end example
+
+
+@seealso
+
+Référence du programme : @internalsref{MultiMeasureRestMusic},
+@internalsref{MultiMeasureRest}.
+
+L'objet de rendu @internalsref{MultiMeasureRestNumber} traite les
+nombres, et @internalsref{MultiMeasureRestText} le texte ajouté par
+l'utilisateur. 
+
+
+@refbugs
+
+Vous ne pouvez pas utiliser de doigtés (p.ex. @code{R1-4}) pour
+positionner des nombres au dessus d'un silence multi-mesures, ni
+modifier la hauteur.
+
+@cindex condenser les silences
+
+Condenser plusieurs silences en un unique silence multi-mesures ne peut 
+être automatisé.  Les silences multi-mesures peuvent générer des
+collisions avec d'autres silences.
+
+Pensez à indiquer explicitement la durée de la note qui suit un
+silence multi-mesures, car elle sera par défaut égale à la durée totale
+des mesures à compter. Ainsi, dans l'exemple ci-après, les deux do
+dièses vaudront chacun quatre mesures à 4/4.
+@example
+R1*4 cis cis
+@end example
+Lorsque @code{skipBars} est activé, le résultat semblera correct, mais
+la numérotation des mesures sera suspendue. 
+
+
+@node Displaying rhythms
+@subsection Displaying rhythms
+
+@menu
+* Time signature::              
+* Upbeats::                     
+* Unmetered music::             
+* Polymetric notation::         
+* Automatic note splitting::    
+@end menu
+
+@node Time signature
+@unnumberedsubsubsec Time signature
+
+@cindex chiffrage de mesure
+@cindex chiffre indicateur de mesure
+@cindex métrique
+@funindex \time
+
+Le chiffre de mesure indique le mètre d'une pièce : une alternance
+régulière de temps forts et de temps faibles.  Il est indiqué par une
+fraction au début de la portée.
+
+Le chiffre de mesure est réglé par la commande @code{\time}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 2/4 c'2 \time 3/4 c'2.
+@end lilypond
+
+@commonprop
+
+Le symbole imprimé peut être modifié avec la propriété @code{style}.
+En la réglant sur @code{#'()}, une fraction sera utilisée pour les
+chiffres de mesure 4/4 et 2/2.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+\time 4/4 c'1
+\time 2/2 c'1
+\override Staff.TimeSignature #'style = #'()
+\time 4/4 c'1
+\time 2/2 c'1
+@end lilypond
+
+Il y a bien d'autres options pour sa mise en place.  Voir @ref{Ancient time
+signatures} pour plus d'exemples.
+
+@code{\time} définit les propriétés @code{timeSignatureFraction},
+@code{beatLength} et @code{measureLength} dans le contexte
+@code{Timing}, qui en principe est assimilé à @internalsref{Score}.  La
+propriété @code{measureLength} détermine où des barres de mesure doivent
+être insérées, et comment les groupements de notes doivent être gérés.
+La modification de la valeur de @code{timeSignatureFraction} donne
+également lieu à l'impression d'un symbole.
+
+Plus d'options sont accessibles au moyen de la fonction Scheme
+@code{set-time-signature}.  De concert avec le
+@internalsref{Measure_grouping_engraver}, elle crée les signes de
+@internalsref{MeasureGrouping}, qui facilitent la lecture de musiques
+modernes, complexes rythmiquement.  Dans l'exemple suivant, les mesures
+à 9/8 sont subdivisées en @code{(2 2 2 3)}, ce qui est donné comme
+argument à la commande @code{set-time-signature}, en troisième position.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    #(set-time-signature 9 8 '(2 2 2 3))
+    g8[ g] d[ d] g[ g] a8[( bes g]) |
+    #(set-time-signature 5 8 '(3 2))
+    a4. g4
+  }
+  \layout {
+    \context {
+      \Staff
+      \consists "Measure_grouping_engraver"
+    }
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{TimeSignature} et
+@internalsref{Timing_translator}.
+
+Exemples : @lsr{contemporary,compound-time-signature.ly}.
+
+
+@refbugs
+
+Le groupement automatique des ligatures n'utilise pas les groupements
+spécifiés par @code{set-time-signature}.
+
+
+@node Upbeats
+@unnumberedsubsubsec Upbeats
+
+@cindex anacrouse
+@cindex levée
+@cindex mesure incomplète
+@funindex \partial
+
+
+Les mesures incomplètes, telles que les anacrouses ou levées, doivent
+être entrées avec la commande
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\partial 16*5 c16 cis d dis e | a2. c,4 | b2
+@end lilypond
+
+
+La syntaxe de cette commande est
+
+@example
+\partial @var{durée}
+@end example
+
+@code{durée} étant la valeur rythmique devant être ajoutée avant la
+mesure suivante.
+
+Le programme traduit cette commande en
+
+@example
+\set Timing.measurePosition = -@var{durée}
+@end example
+
+
+La propriété @code{measurePosition} contient un nombre rationnel qui
+indique, à ce point précis, où l'on en est de la mesure. Notez qu'il
+peut s'agir d'un nombre négatif ; @code{\partial 4} signifie, pour le
+programme : @qq{Dans cette mesure, il reste juste une noire}.
+
+
+@refbugs
+
+Cette commande ne prend pas en compte les notes d'ornement ou
+appoggiatures au début de la musique. Lorsqu'un morceau commence par une
+levée et avec des petites notes, la commande @code{\partial} devrait être
+placée après celles-ci.
+
+@lilypond[verbatim,quote,ragged-right,relative,fragment]
+\grace f16
+\partial 4
+g4
+a2 g2
+@end lilypond
+
+@code{\partial} n'est destiné à être utilisé qu'en début de pièce.
+Si on l'utilise ailleurs qu'au début, des messages d'erreurs peuvent
+s'afficher.
+
+
+@node Unmetered music
+@unnumberedsubsubsec Unmetered music
+
+@cindex cadence
+@funindex \cadenzaOn
+@funindex \cadenzaOff
+
+
+Les barres de mesure et les numéros de mesure sont calculés
+automatiquement, ce qui n'est pas souhaitable dans le cas d'une musique
+non mesurée --- les cadences, par exemple. Les commandes
+@code{\cadenzaOn} et @code{\cadenzaOff} permettent de désactiver et de
+rétablir la métrique automatique.
+
+@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
+c4 d e d
+\cadenzaOn
+c4 c d8 d d f4 g4.
+\cadenzaOff
+\bar "|"
+d4 e d c
+@end lilypond
+
+
+@refbugs
+
+LilyPond ne change de ligne ou de page qu'au niveau des barres de
+mesure.  Si votre musique non mesurée dure plus d'une ligne, il vous
+faudra insérer des barres de mesure invisibles, pour indiquer à quels
+endroit un saut de ligne peut intervenir.
+
+@example
+\bar ""
+@end example
+
+
+@node Polymetric notation
+@unnumberedsubsubsec Polymetric notation
+
+@cindex métrique composite
+@cindex composite, métrique
+@cindex métrique polymétrique
+@cindex polymétrie
+
+LilyPond ne gère pas les métriques composites de manière explicite,
+mais on peut contourner ce problème.  Dans l'exemple suivant,
+l'indicateur de métrique est obtenu grâce à une étiquette textuelle.
+Cette étiquette vient s'insérer dans l'objet graphique (@emph{grob})
+@internalsref{TimeSignature}.  Voir aussi
+@lsr{contemporary,compound-time-signature}. 
+
+
+@lilypond[verbatim,ragged-right]
+% create 2/4 + 5/8
+tsMarkup =\markup {
+  \override #'(baseline-skip . 2) \number {
+    \column { "2" "4" }
+    \vcenter "+"
+    \bracket \column { "5" "8" }
+  }
+}
+
+{
+  \override Staff.TimeSignature #'stencil = #ly:text-interface::print
+  \override Staff.TimeSignature #'text = #tsMarkup
+  \time 3/2
+  c'2 \bar ":" c'4 c'4.
+}
+@end lilypond
+
+Il arrive aussi que chaque portée ait sa propre métrique.  Vous y
+parviendrez en déplaçant le @internalsref{Timing_translator} dans le
+contexte @internalsref{Staff}.
+
+@example
+\layout @{
+  \context @{ \Score
+     \remove "Timing_translator"
+     \remove "Default_bar_line_engraver"
+  @}
+  \context @{
+    \Staff
+    \consists "Timing_translator"
+    \consists "Default_bar_line_engraver"
+  @}
+
+@}
+@end example
+
+
+Maintenant, chacune des portées dispose de sa propre métrique.
+@example
+<<
+  \new Staff @{
+    \time 3/4
+    c4 c c | c c c |
+  @}
+  \new Staff @{
+    \time 2/4
+    c4 c | c c | c c
+  @}
+  \new Staff @{
+    \time 3/8
+    c4. c8 c c c4. c8 c c
+  @}
+>>
+@end example
+
+@lilypond[quote,ragged-right]
+\layout{
+  \context{
+     \Score
+     \remove "Timing_translator"
+     \remove "Default_bar_line_engraver"
+    }
+  \context{ \Staff
+    \consists "Timing_translator"
+    \consists "Default_bar_line_engraver"
+  }
+}
+
+\relative c' <<
+  \new Staff {
+    \time 3/4
+    c4 c c | c c c |
+  }
+  \new Staff {
+    \time 2/4
+    c4 c | c c | c c
+  }
+  \new Staff {
+    \time 3/8
+    c4. c8 c c c4. c8 c c
+  }
+>>
+@end lilypond
+
+
+Une autre forme de notation polymétrique consiste dans le fait que des
+notes aient une durée relative différente selon la portée.  
+
+Vous pouvez créer une telle notation en définissant une métrique
+commune à toutes les portées,  que vous proratiserez manuellement
+selon le cas en utilisant @code{timeSignatureFraction} pour obtenir la
+division adéquate pour chaque portée.  Les durées, dans chacune des
+portées, seront alors échelonnées par rapport à la métrique commune.
+L'échelle de représentation se règle avec @code{\compressMusic} ---
+qui fonctionne comme @code{\times}, sans toutefois créer de crochet.
+La syntaxe appropriée est :
+@example
+\compressMusic #'(@var{numérateur} . @var{dénominateur}) @var{exprmusicale}
+@end example
+
+
+L'exemple suivant utilise parallèlement des mesures à 3/4, 9/8 et
+10/8.  Pour la deuxième portée, les durées sont multipliées par 2/3,
+de telle sorte que @w{2/3 * 9/8 = 3/4} ; pour la troisième, elles sont
+multipliées par 3/5, de telle sorte que @w{3/5 * 10/8 = 3/4}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' { <<
+  \new Staff {
+    \time 3/4
+    c4 c c | c c c |
+  }
+  \new Staff {
+    \time 3/4
+    \set Staff.timeSignatureFraction = #'(9 . 8)
+    \compressMusic #'(2 . 3)
+      \repeat unfold 6 { c8[ c c] }
+  }
+  \new Staff {
+    \time 3/4
+    \set Staff.timeSignatureFraction = #'(10 . 8)
+    \compressMusic #'(3 . 5) {
+      \repeat unfold 2 { c8[ c c] }
+      \repeat unfold 2 { c8[ c] }
+      | c4. c4. \times 2/3 { c8 c c } c4
+    }
+  }
+>> }
+@end lilypond
+
+
+
+
+@refbugs
+
+L'utilisation de métriques différentes en parallèle entraine un
+alignement vertical.  De ce fait, les barres de mesure ont tendance à
+fausser l'espacement régulier.
+
+
+@node Automatic note splitting
+@unnumberedsubsubsec Automatic note splitting
+
+On peut convertir automatiquement les notes longues en notes liées.  Il
+faut pour cela remplacer le graveur @internalsref{Note_heads_engraver}
+par le graveur @internalsref{Completion_heads_engraver}.  Dans les
+exemples suivants, les notes dépassant de la mesure sont divisées et
+liées.
+
+@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
+\new Voice \with {
+  \remove "Note_heads_engraver"
+  \consists "Completion_heads_engraver"
+} {
+  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
+}
+@end lilypond
+
+Ce graveur divise toutes les notes qui sortent de la mesure, et insère
+des liaisons de prolongation.  Une utilisation posible consiste à
+déboguer des partitions complexes : si les mesures ne sont pas
+entièrement remplies, alors les liaisons de prolongation montrent
+exactement la durée des décalages de mesure.
+
+Si vous voulez permettre un saut de ligne aux barres de mesure où
+@internalsref{Completion_heads_engraver} divise les notes, vous devez
+aussi enlever @internalsref{Forbid_line_break_engraver}.
+
+
+@refbugs
+
+Bien que toutes les durées --- particulièrement celles contenant des
+nolets --- ne puissent pas être représentées exactement avec des notes
+normales et des points, le graveur n'insèrera pas de nolets.
+
+@code{Completion_heads_engraver} affecte seulement les notes, il ne
+divise pas les silences.
+
+@seealso
+
+Référence du programme : @internalsref{Completion_heads_engraver}.
+
+
+@node Beams
+@subsection Beams
+
+@menu
+* Automatic beams::             
+* Manual beams::                
+* Feathered beams::             
+@end menu
+
+@node Automatic beams
+@unnumberedsubsubsec Automatic beams
+
+LilyPond décide automatiquement de la manière de grouper les notes et
+d'imprimer les ligatures.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
+@end lilypond
+
+Lorsque ce comportement automatisé n'est pas satisfaisant, on peut
+définir des groupements manuellement --- voir section suivante --- ou
+personnaliser les groupements automatiques --- voir @ref{Setting
+automatic beam behavior}.
+
+La commande @code{\noBeam} peut servir à empêcher des notes
+individuelles d'être rattachées aux autres.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c\noBeam c c
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{Beam}.
+
+
+@node Manual beams
+@unnumberedsubsubsec Manual beams
+
+@cindex groupements de note manuels
+@cindex ligatures manuelles
+@funindex ]
+@funindex [
+
+Dans certaines situations, il peut s'avérer nécessaire de
+supplanter l'algorithme de groupement automatique des notes, par
+exemple pour prolonger une ligature par-dessus un silence ou une barre
+de mesure.  Le début et la fin de la ligature sont alors indiqués par
+@code{[} et @code{]}.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+  r4 r8[ g' a r8] r8 g[ | a] r8
+}
+@end lilypond
+
+
+@commonprop
+
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
+
+LilyPond peut déterminer automatiquement les sous-groupes à
+l'intérieur d'un groupement de notes, bien que le résultat ne soit pas 
+toujours optimal.  Les propriétés @code{stemLeftBeamCount} et
+@code{stemRightBeamCount} permettent alors
+d'ajuster ce comportement.  Lorsque l'une ou l'autre de ces propriétés
+est définie, elle ne s'applique qu'une seule fois, après quoi sa
+définition est effacée.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+   f8[ r16
+      f g a]
+   f8[ r16
+   \set stemLeftBeamCount = #1
+      f g a]
+}
+@end lilypond
+
+La propriété @code{subdivideBeams} sert à grouper les double-croches
+ou les valeurs plus brèves pulsation par pulsation, la pulsation
+étant définie par la propriété @code{beatLength}.
+
+@lilypond[fragment,quote,relative=2,verbatim]
+c16[ c c c c c c c]
+\set subdivideBeams = ##t
+c16[ c c c c c c c]
+\set Score.beatLength = #(ly:make-moment 1 8)
+c16[ c c c c c c c]
+@end lilypond
+@funindex subdivideBeams
+
+@noindent
+Pour plus d'information sur @code{make-moment}, voir
+@ref{Time administration}.
+
+Lorsqu'une ligature franchit une barre de mesure, le saut
+de ligne est en principe interdit à cet endroit.  Ce comportement peut
+être outrepassé en définissant @code{breakable}.
+
+@funindex breakable
+
+@cindex ligatures et sauts de ligne
+@cindex ligatures coudées
+@cindex auto-knee-gap
+
+LilyPond insère automatiquement des ligatures coudées --- certaines
+notes vers le haut, d'autres vers le bas --- lorsqu'il détecte un espace
+important entre des têtes de notes. Ce comportement peut être changé par
+l'intermédiaire de l'objet @code{auto-knee-gap}
+
+
+@refbugs
+
+Les ligatures coudées à cheval sur deux portées ne peuvent être
+employées en même temps que des portées invisibles.  Voir
+@ref{Hiding staves}.
+
+@c Is this still true with skyline spacing stuff? -J.Mandereau
+Les ligatures peuvent entrer en collision avec des symboles entourant
+les notes, contrairement aux textes ou aux altérations.
+
+
+@node Feathered beams
+@unnumberedsubsubsec Feathered beams
+
+Les ligatures en soufflet s'obtiennent en définissant la propriété
+@code{grow-direction} d'une barre de ligature.  La fonction
+@code{\featherDurations} sert à ajuster la durée des notes.
+
+@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
+\override Beam #'grow-direction = #LEFT
+\featherDurations #(ly:make-moment 5 4) 
+{
+  c16[ c c c c c c]
+}
+@end lilypond
+
+@refbugs
+
+La commande @code{\featherDurations} ne permet de traiter que de très
+courts extraits.
+
+
+@node Bars
+@subsection Bars
+
+
+@menu
+* Bar check::                   
+* Bar lines::                   
+* Bar numbers::                 
+* Barnumber check::             
+* Rehearsal marks::             
+@end menu
+
+@node Bar check
+@unnumberedsubsubsec Bar check
+
+@cindex vérification des limites de mesure
+@cindex mesures, vérification des limites
+@funindex barCheckSynchronize
+@funindex |
+
+Les tests de limites de mesure (ou tests de mesure) aident à détecter
+les erreurs dans les durées.  Un test de mesure s'écrit avec une barre
+verticale, @samp{|}.  Lors du traitement, elle doit correspondre à une
+barre de mesure.  Sinon, un avertissement est émis.  Dans l'exemple
+suivant, le deuxième test de mesure signale une erreur.
+@example
+\time 3/4 c2 e4 | g2 |
+@end example
+
+Le test de mesure peut être aussi utilisé dans les paroles, par exemple :
+@example
+\lyricmode @{
+ \time 2/4
+ Twin -- kle | Twin -- kle
+@}
+@end example
+
+Des durées incorrectes font échouer les tests de mesure, et peuvent
+souvent mettre la partition sens dessus dessous, particulièrement s'il
+s'agit de musique polyphonique.  Vérifier les tests de mesure qui ont
+échoué et les durées incorrectes est un bon moyen de commencer à
+corriger sa partition.
+
+@funindex |
+@funindex pipeSymbol
+
+Il est aussi possible d'attribuer une autre valeur au symbole
+@code{|}, en assignant une expression musicale à @code{pipeSymbol},
+
+@lilypond[quote,ragged-right,verbatim]
+pipeSymbol = \bar "||"
+
+{ c'2 c' | c'2 c' }
+@end lilypond
+
+
+@node Bar lines
+@unnumberedsubsubsec Bar lines
+
+@cindex barres de mesure
+@funindex \bar
+@cindex barres de reprise
+
+
+Les barres de mesures délimitent les mesures, mais peuvent aussi
+indiquer une reprise. En principe, elles sont insérées automatiquement,
+et les sauts de ligne ne peuvent avoir lieu qu'au niveau de ces barres.
+
+Il est possible de forcer l'impression d'une barre de mesure spéciale,
+avec la commande @code{\bar} :
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+c4 \bar "|:" c4
+@end lilypond
+
+
+Les styles de barres de mesure disponibles sont
+
+@c @lilypondfile[ragged-right,quote]{bar-lines.ly}
+
+
+En plus de cela, on peut demander @code{"||:"}, qui équivaut à
+@code{"|:"}, mais qui donnera, en cas de saut de ligne, une double barre
+en fin de ligne, et une barre de reprise au début de la ligne suivante.
+
+Il est possible d'autoriser un saut de ligne même s'il n'y a pas
+de barre de mesure visible, en utilisant :
+
+@example
+\bar ""
+@end example
+
+@noindent
+
+
+Ceci insérera une barre de mesure invisible, et permettra de sauter de
+ligne à cet endroit, sans incrémenter le numéro de mesure.
+
+
+Dans une partition comprenant plusieurs portées, la commande @code{\bar}
+placée sur une portée s'applique automatiquement à toutes les
+portées. Les barres de mesure que l'on obtient alors sont d'un seul
+tenant sur les portées d'un @code{StaffGroup}, d'un @code{PianoStaff} ou
+d'un @code{GrandStaff}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+  \new StaffGroup <<
+    \new Staff {
+      e'4 d'
+      \bar "||"
+      f' e'
+    }
+    \new Staff { \clef bass c4 g e g }
+  >>
+  \new Staff { \clef bass c2 c2 }
+>>
+@end lilypond
+
+
+@commonprop
+
+@funindex whichBar
+@funindex repeatCommands
+@funindex defaultBarType
+
+
+La commande @code{\bar }@var{bartype} sert de raccourci pour @code{\set
+Timing.whichBar = }@var{bartype}.  Dès que l'on définit @code{whichBar},
+une barre de mesure est créée selon le style défini.
+
+
+Dès que la propriété @code{whichBar} est définie, une barre de mesure
+est créée.  À chaque début de mesure, elle prend la valeur de
+@code{Timing.defaultBarType}.  La valeur de @code{repeatCommands} sert à
+remplacer les barres de mesure par défaut.
+
+Nous vous invitons à utiliser @code{\repeat} pour indiquer les
+reprises. Voyez à ce sujet @ref{Repeats}.
+
+
+@seealso
+
+Dans ce manuel : @ref{Repeats}, @ref{System start delimiters}.
+
+Référence du programme : @internalsref{BarLine} (faisant partie du
+contexte @internalsref{Staff}), @internalsref{SpanBar} (sur plusieurs
+portées).
+
+
+@node Bar numbers
+@unnumberedsubsubsec Bar numbers
+
+@cindex Mesure, numéro de
+@cindex numéros de mesure
+@funindex currentBarNumber
+
+Les numéros de mesure sont imprimés par défaut à chaque début de
+ligne.  Ce nombre est stocké par la propriété @code{currentBarNumber}
+qui sera mis à jour à chaque mesure.
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\repeat unfold 4 {c4 c c c} \break
+\set Score.currentBarNumber = #50
+\repeat unfold 4 {c4 c c c}
+@end lilypond
+
+L'impression d'un numéro de mesure ne peut intervenir que s'il y a une
+barre.  Aussi, pour pouvoir le faire au début d'un morceau,
+devrez-vous ajouter une barre vide :
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\set Score.currentBarNumber = #50
+\bar ""
+\repeat unfold 4 {c4 c c c} \break
+\repeat unfold 4 {c4 c c c}
+@end lilypond
+
+Vous pouvez imprimer un numéro de mesure à intervalles réguliers plutôt
+qu'en tête de chaque ligne.  C'est ce qu'illustre l'exemple suivant,
+dont la source complète est 
+@lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
+
+@c @lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
+
+Désactiver le graveur concerné --- @code{Bar_number_engraver} ---
+donnera une partition sans numéros de mesure.
+
+@lilypond[verbatim,ragged-right,quote]
+\layout {
+  \context {
+    \Score
+    \remove "Bar_number_engraver"
+  }
+}
+\relative c''{
+c4 c c c \break
+c4 c c c
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{BarNumber}.
+
+Exemples : @lsrdir{staff}
+
+
+@refbugs
+
+Les numéros de mesure peuvent entrer en collision avec les crochets de
+@internalsref{StaffGroup}. La propriété @code{padding} --- décalage
+--- de l'objet @internalsref{BarNumber} permet alors d'ajuster leur
+positionnement. 
+
+
+@node Barnumber check
+@unnumberedsubsubsec Barnumber check
+
+Lorsque l'on recopie de longues pièces, il peut être utile de vérifier
+que les numéros de mesures de LilyPond correspondent à l'original que
+l'on recopie.  Cela se fait avec @code{\barNumberCheck}.  Par exemple,
+
+@verbatim
+\barNumberCheck #123
+@end verbatim
+
+@noindent
+affiche un avertissement lors du traitement si le numéro de mesure à ce
+point (variable @code{currentBarNumber}) n'est pas 123.
+
+
+@node Rehearsal marks
+@unnumberedsubsubsec Rehearsal marks
+
+@cindex Repères, indication de
+@funindex \mark
+
+Indiquer un repère s'obtient grâce à la commande @code{\mark}.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1 \mark \default
+c1 \mark \default
+c1 \mark #8
+c1 \mark \default
+c1 \mark \default
+@end lilypond
+
+@noindent
+La lettre@tie{}@q{I} n'est pas utilisée, conformément aux usages de la
+gravure.  Cependant, vous pourrez intégrer la lettre @q{I} en utilisant
+
+@example
+\set Score.markFormatter = #format-mark-alphabet
+@end example
+
+Lorsque vous utilisez @code{\mark \default}, le repère s'incrémente
+automatiquement ; toutefois donner un nombre en argument permet de
+spécifier manuellement le repère en question.  La valeur à utiliser
+est enregistrée dans la propriété @code{rehearsalMark}.
+
+Le style du repère est déterminé par la propriété
+@code{markFormatter}.  Il s'agit d'une fonction qui prend en arguments
+le repère en cours (un entier) ainsi que le contexte en cours, et
+retournera un objet de type étiquette.  Dans l'exemple qui suit,
+@code{markFormatter} est réglé pour une procédure type. Quelques
+mesure plus loin, son comportement est modifié pour imprimer un
+repère encadré.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\set Score.markFormatter = #format-mark-numbers
+c1 \mark \default
+c1 \mark \default
+\set Score.markFormatter = #format-mark-box-numbers
+c1 \mark \default
+c1 \mark \default
+c1
+@end lilypond
+
+Le fichier @file{scm/@/translation@/-functions@/.scm} comporte les
+définitions de @code{format-mark-numbers} (comportement par défaut), 
+@code{format-mark-box-numbers},
+@code{format-mark-letters} et @code{format-mark-box-letters}.  Vous
+pouvez vous en inspirer pour d'autres fonctions de formatage.
+
+@code{format-mark-barnumbers}, @code{format-mark-box-barnumbers} et 
+@code{format-mark-circle-barnumbers}  permettent d'imprimer le numéro
+de mesure au lieu des compteurs alphabétique ou numérique.
+
+On peut aussi spécifier manuellement une marque de repère :
+
+@example
+\mark "A1"
+@end example
+
+@noindent
+@code{Score.markFormatter} sera sans effet sur des repères ainsi
+définis.  Un @code{\markup} peut néanmoins s'utiliser en argument.
+
+@example
+\mark \markup@{ \box A1 @}
+@end example
+
+@cindex segno
+@cindex coda
+@cindex D.S al Fine
+
+Un @code{\mark} peut contenir un glype musical tel que le signe
+@emph{segno}.  
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+c1 \mark \markup { \musicglyph #"scripts.segno" }
+c1 \mark \markup { \musicglyph #"scripts.coda" }
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+Pour connaître les différents symboles accessibles par
+@code{\musicglyph}, consultez @ref{The Feta font}.
+
+Pour affiner le positionnement des repères, veuillez vous référer à
+@ref{Text marks}.
+
+@seealso
+
+Dans ce manuel : @ref{Text marks}.
+
+Référence du programme : @internalsref{RehearsalMark}.
+
+Fichiers d'initialisation : @file{scm/@/translation@/-functions@/.scm}
+contient les définitions de @code{format-mark-numbers} et
+@code{format-mark-letters}.  Elles seront source d'inspiration pour
+d'autres fonctions de formatage.
+
+Exemples : @lsr{parts,rehearsal-mark-numbers.ly}
+
+
+@node Special rhythmic concerns
+@subsection Special rhythmic concerns
+
+
+@menu
+* Grace notes::                 
+* Aligning to cadenzas::        
+* Time administration::         
+* Proportional notation (introduction)::  
+@end menu
+
+@node Grace notes
+@unnumberedsubsubsec Grace notes
+
+@funindex \grace
+@cindex ornements
+@cindex notes d'ornement
+@cindex appoggiature
+@cindex accacciature
+@cindex petite note
+
+
+Les petites notes sont des ornements entièrement écrits.  Les plus
+courantes sont les accacciatures, qui doivent se jouer très vite,
+et qui s'écrivent sous forme d'une petite note barrée (sur la hampe)
+et liée.  L'appoggiature est une petite note non barrée, qui vole
+une fraction à la durée de la note réelle qui la suit.
+
+Ces petites notes sont entrées avec les commandes @code{\acciaccatura}
+et @code{\appoggiatura}, comme le montre l'exemple suivant :
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+b4 \acciaccatura d8 c4 \appoggiatura e8 d4
+\acciaccatura { g16[ f] } e4
+@end lilypond
+
+
+Ce sont là deux formes spéciales de la commande @code{\grace}, qui prend
+en charge toutes les petites notes. Si on la fait suivre d'une
+expression musicale, un groupe de petites notes sera créé, sans impact
+sur la métrique.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+c4 \grace c16 c4
+\grace { c16[ d16] } c2 c4
+@end lilypond
+
+@noindent
+Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
+commande @code{\grace} ne provoque pas de liaison.
+
+La durée des petites notes est interprétée par le programme en fonction
+d'un deuxième compteur de temps, le chronomètre @code{grace}.  Chaque
+instant est défini par deux nombres rationnels : le premier compte les
+durées réelles, le second compte la durée des petites notes.  Reprenons
+l'exemple ci-dessus en y ajoutant ces couples de nombres :
+
+@lilypond[quote,ragged-right]
+<<
+  \relative c''{
+    c4 \grace c16 c4 \grace {
+    c16[ d16] } c2 c4
+  }
+  \new Lyrics \lyricmode {
+    \override LyricText #'font-family = #'typewriter
+
+    \markup { (0,0) } 4
+    \grace { \markup {
+      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
+    \markup { (\fraction 1 4 , 0 ) } 4
+    \grace {
+      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
+      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
+    }
+    \markup { ( \fraction 2 4 , 0 ) }
+  }
+>>
+@end lilypond
+
+Les petites notes se placent de façon synchrone entre les différentes
+portées.  Dans l'exemple suivant, il y a deux petites double-croches
+pour chaque petite croche.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \grace { c16[ d e f] } e4 }
+   \new Staff { c4 \grace { g8[ b] } c4 } >>
+@end lilypond
+
+@funindex \afterGrace
+
+La commande @code{\afterGrace} sert à placer une petite note après une
+note réelle --- et non @emph{avant} comme d'ordinaire.  Cette commande
+requiert deux arguments : la note réelle, et la ou les petites notes qui
+suivent.
+
+@lilypond[ragged-right, verbatim,relative=2,fragment]
+c1 \afterGrace d1 { c16[ d] } c4
+@end lilypond
+
+Les petites notes se placent alors aux 3/4 de la durée de la note
+réelle.  Cette fraction peut être changée en définissant
+@code{afterGraceFraction} ; ainsi,
+
+@example
+#(define afterGraceFraction (cons 7 8))
+@end example
+
+@noindent
+placera la petite note à 7/8 de la note réelle.
+
+On peut obtenir le même effet manuellement, de la façon suivante :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  << { d1^\trill_( }
+     { s2 \grace { c16[ d] } } >>
+  c4)
+}
+@end lilypond
+
+@noindent
+Le silence invisible peut être plus ou moins long --- ici c'est une
+demi-pause --- afin d'ajuster l'espace entre la note réelle et les
+petites notes.
+
+Les expressions @code{\grace} obéissent à des règles typographiques
+particulières, notamment pour régler l'orientation et la taille des
+objets.  De ce fait, toute subtilité de mise en forme devra être
+indiquée @emph{à l'intérieur} de l'expression introduite par
+@code{\grace} :
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  \acciaccatura {
+    \stemDown
+    f16->
+    \stemNeutral
+  }
+  g4
+}
+@end lilypond
+
+@noindent
+Tous les réglages ajoutés doivent également être désactivés dans cette
+même expression.
+
+Il est possible de changer globalement la mise en forme des petites
+notes dans un morceau, au moyen de la fonction
+@code{add-grace-property}.  Ici, par exemple, on ôte la définition de
+l'orientation des objets @code{Stem} pour toutes les petites notes, afin
+que les hampes ne soient pas toujours orientées vers le haut.
+
+@example
+\new Staff @{
+ #(add-grace-property 'Voice 'Stem 'direction '())
+ @dots{}
+@}
+@end example
+
+@noindent
+Il est par ailleurs possible de modifier les variables
+@code{startGraceMusic}, @code{stopGraceMusic},
+@code{startAcciaccaturaMusic}, @code{stopAcciaccaturaMusic},
+@code{startAppoggiaturaMusic}, et @code{stopAppoggiaturaMusic}.
+Pour plus de détails, voir le fichier @file{ly/@/grace@/-init@/.ly}.
+
+@noindent
+Le trait que l'on trouve sur les hampes des accacciatures peut
+être appliqué dans d'autres situations en définissant @*
+@code{\override Stem  #'stroke-style = #"grace"}.
+
+
+@commonprop
+
+Il est possible de forcer l'élasticité de l'espacement des notes d'agrément.
+
+@lilypond[relative=2,ragged-right]
+<<
+  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
+  \new Staff {
+     c'4
+     \afterGrace
+     c'4
+     { c'16[ c'8 c'16] }
+     c'4
+  }  
+  \new Staff {
+     c'16[ c'16 c'16 c'16]
+     c'16[ c'16 c'16 c'16]
+     c'4
+  }
+>>
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{GraceMusic}.
+
+
+@refbugs
+
+Une partition commençant par une expression @code{\grace} doit faire
+intervenir la commande @code{\new Voice}, sans quoi la note réelle et
+la petite note se retrouveront sur des portées différentes.
+
+La synchronisation des petites notes se fait de façon parfois
+surprenante, car les autres objets de la portée --- barres de mesure,
+armures, etc. --- sont eux aussi synchrones. Pensez-y lorsque vous
+mélez des portées comprenant des petites notes et d'autres sans :
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" d4 } >>
+@end lilypond
+
+@noindent
+Il est possible de remédier à cela en insérant sur les autres portées
+des silences invisibles dans une expression précédée de @code{\grace},
+correspondant à la durée des petites notes.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
+@end lilypond
+ 
+Seules des expressions musicales séquentielles peuvent être utilisées
+pour des petites notes ; il n'est pas possible d'imbriquer ni de
+juxtaposer des sections de petites notes, faute de quoi le traitement du
+code peut échouer ou produire des erreurs.
+
+
+@node Aligning to cadenzas
+@unnumberedsubsubsec Aligning to cadenzas
+
+Dans un contexte orchestral, une cadence constitue un problème
+spécifique.  Lors du montage d'une partition contenant une cadence,
+tous les autres instruments doivent sauter autant de notes que ce
+qu'en comporte la cadence, faute de quoi il démarreraient trop tôt ou
+trop tard. 
+
+Les fonctions @code{mmrest-of-length} ou @code{skip-of-length}
+permettent de résoudre ce problème.  Ces fonctions Scheme prennent en
+argument un fragment de musique, et génèrent un @code{\skip} ou un
+silence multi-mesures d'une durée correspondant à ce fragment.
+L'exemple qui suit illustre l'utilisation de @code{mmrest-of-length}. 
+
+@lilypond[verbatim,ragged-right,quote]
+cadenza = \relative c' {
+  c4 d8 << { e f g } \\ { d4. } >>
+  g4 f2 g4 g
+}
+
+\new GrandStaff <<
+  \new Staff { \cadenza c'4 }
+  \new Staff {
+    #(ly:export (mmrest-of-length cadenza))
+    c'4
+  }
+>>
+@end lilypond
+
+
+@node Time administration
+@unnumberedsubsubsec Time administration
+
+@cindex temps, gestion du
+
+Le temps est administré par le @internalsref{Time_signature_engraver},
+qui réside en principe dans le contexte @internalsref{Score}.  Sa
+gestion traite les variables suivantes :
+
+@table @code
+@item currentBarNumber
+Le numéro de mesure.
+
+@item measureLength
+La longueur de la mesure, dans la métrique en cours.  Pour une mesure
+à 4/4, elle est de@tie{}1, et de 3/4 pour une mesure à 6/8.
+
+@item measurePosition
+Le moment où l'on en est dans la mesure en cours.  Cette quantité est
+remise à@tie{}0 dès lors qu'on dépasse @code{measureLength} ; la variable
+@code{currentBarNumber} est alors incrémentée.  
+
+@item timing
+Lorsqu'on lui assigne la valeur @emph{vrai}, les valeurs ci-dessus
+mentionnées sont mises à jour à chaque pas.  Fixée à @emph{faux}, le
+graveur restera indéfiniment dans la mesure en cours.
+@end table
+
+Le calage peut être modifié en réglant explicitement l'une de ces
+variables.  Dans l'exemple qui suit, nous réglons la métrique à 4/4,
+tout en fixant @code{measureLength} à 5/4.  Un peu plus loin, nous
+raccourcissons la mesure de 1/8, en assignant 7/8 à
+@code{measurePosition}, alors que nous en sommes à 2/4 dans la
+mesure ; la barre de mesure tombera donc à @w{2/4 + 3/8}.  Les 3/8
+résultent du fait que 5/4 équivaut à 10/8, mais nous nous sommes recalés
+à 7/8 de la mesure ;  donc @w{10/8 @minus{} 7/8 = 3/8}.
+
+@lilypond[quote,ragged-right,verbatim,relative,fragment]
+\set Score.measureLength = #(ly:make-moment 5 4)
+c1 c4
+c1 c4
+c4 c4
+\set Score.measurePosition = #(ly:make-moment 7 8)
+b8 b b
+c4 c1
+@end lilypond
+
+@noindent
+Comme le montre cet exemple, @code{ly:make-moment n m} construit une
+durée de n/m fois une ronde.  
+Par conséquent, @code{ly:make-moment 1 8} correspond à une croche, et
+@code{ly:make-moment 7 16} à la durée de sept doubles croches.
+
+
+@node Proportional notation (introduction)
+@unnumberedsubsubsec Proportional notation (introduction)
+@cindex Notation proportionnelle
+
+Voir @ref{Proportional notation}.
+
+
+@c À faire : supprimer tout ça ?
+
+Les notes peuvent s'espacer proportionnellement en assignant une durée
+à @code{proportionalNotationDuration}
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+<<
+  \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
+  \new Staff { c8[ c c c c c]  c4 c2 r2 }
+  \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
+>>
+@end lilypond
+
+Manipuler cette propriété affectera l'espacement idéal uniquement pour
+des notes consécutives.  Pour obtenir une véritable notation
+proportionnelle, vous devrez tenir compte des réglages suivants :
+
+@itemize @bullet
+
+@item La véritable notation proportionnelle exige que des symboles
+puissent en écraser d'autres.  Pour y parvenir, il faut retirer le
+@internalsref{Separating_line_group_engraver} du contexte
+@internalsref{Staff}. 
+
+@item L'influence en matière d'espacement induite par le formatage
+(clés, barres de mesure, etc) s'annule en assignant
+@emph{vrai}@tie{}(#t) à la propriété @code{strict-note-spacing} de
+l'objet @internalsref{SpacingSpanner}.
+
+@item Les affinages optiques se règlent en assignant @emph{vrai} à la
+propriété @code{uniform-stretching} du @internalsref{SpacingSpanner}. 
+
+
+@end itemize
+
+@seealso
+
+Exemples : @lsr{spacing,proportional@/-spacing@/.ly}, 
+@lsr{spacing,proportional@/-strict@/-grace@/-notes@/.ly}, et
+@lsr{spacing,proportional@/-strict@/-notespacing@/.ly}
+
+Le fichier @file{input/proportional.ly} illustre la notation
+proportionnelle stricte.
+
+
diff --git a/Documentation/fr/user/running.itely b/Documentation/fr/user/running.itely
index cee74aed8d..f672beaf37 100644
--- a/Documentation/fr/user/running.itely
+++ b/Documentation/fr/user/running.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/scheme-tutorial.itely b/Documentation/fr/user/scheme-tutorial.itely
index 0758301567..34cf2a5b8e 100644
--- a/Documentation/fr/user/scheme-tutorial.itely
+++ b/Documentation/fr/user/scheme-tutorial.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/setup.itely b/Documentation/fr/user/setup.itely
index 615d6f5813..68ea6fc3c7 100644
--- a/Documentation/fr/user/setup.itely
+++ b/Documentation/fr/user/setup.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/simultaneous.itely b/Documentation/fr/user/simultaneous.itely
new file mode 100644
index 0000000000..22d5f5e3bf
--- /dev/null
+++ b/Documentation/fr/user/simultaneous.itely
@@ -0,0 +1,582 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Simultaneous notes
+@section Simultaneous notes
+
+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
+portée.
+
+@menu
+* Single voice::                
+* Multiple voices::             
+@end menu
+
+
+@node Single voice
+@subsection Single voice
+
+@menu
+* Chords::                      
+* Clusters::                    
+@end menu
+
+@node Chords
+@unnumberedsubsubsec Chords
+
+@cindex accords
+
+Un accord est formé en mettant une série de hauteurs entre @code{<}
+et @code{>}.  Un accord peut être suivi d'une durée et d'indications
+d'articulation, comme une simple note.
+
+@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
+<c e g>4 <c>8
+@end lilypond
+
+Pour plus d'information à propos des accords, voir @ref{Chord names}.
+
+
+@node Clusters
+@unnumberedsubsubsec Clusters
+
+@cindex cluster
+
+Un cluster indique un agrégat de sons.  On peut le représenter par une
+plage limitée par un ambitus (notes extrêmes).  On obtient une telle notation en
+appliquant la fonction @code{makeClusters} à une séquence d'accords,
+comme  
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+\makeClusters { <c e > <b f'> }
+@end lilypond
+
+Des notes ordinaires et des clusters peuvent cohabiter sur une même
+portée, y compris simultanément --- en pareil cas, rien ne sera fait
+pour tenter d'empécher les chevauchements entre notes et clusters.
+
+@seealso
+
+Référence du programme : @internalsref{ClusterSpanner},
+@internalsref{ClusterSpannerBeacon},
+@internalsref{Cluster_spanner_engraver}.
+
+Exemples : @lsr{contemporary,cluster@/.ly}.
+
+@refbugs
+
+Les expressions musicales du type @code{<< @{ g8 e8 @} a4 >>} ne
+seront pas imprimées de façon acceptable.  utilisez plutôt 
+@code{<g a>8 <e a>8} . 
+
+
+@node Multiple voices
+@subsection Multiple voices
+
+@menu
+* Basic polyphony::             
+* Explicitly instantiating voices::  
+* Collision Resolution::        
+* Automatic part combining::    
+* Writing music in parallel::   
+@end menu
+
+@node Basic polyphony
+@unnumberedsubsubsec Basic polyphony
+
+@cindex polyphonie
+
+La manière la plus facile d'entrer des fragments avec plus d'une voix
+sur une portée est d'entrer chaque voix comme une suite de notes
+--- entre accolades : @code{@{...@}} --- puis de les combiner simultanément,
+en séparant les voix avec @code{\\}
+
+@funindex \\
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  c16 d e f
+  <<
+    { g4 f e | d2 e2 } \\
+    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
+    { s2. | s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+Le séparateur permet aux contextes @internalsref{Voice}@footnote{Ces
+voix polyphoniques sont parfois appelées @qq{couches} ou @qq{calques} dans
+d'autres logiciels de notation.}
+@cindex couches
+@cindex calques
+d'être identifiés.  Les contextes de voix portent les noms @code{"1"},
+@code{"2"}, etc.  Dans chacun de ces contextes, la direction verticale
+des liaisons, hampes, etc. est réglée de manière appropriée.
+
+Ces voix sont toutes distinctes de la voix qui contient les notes en
+dehors de la construction @code{<< \\ >>}.  On doit le prendre en compte
+lorsqu'on fait des changements au niveau des voix.  Cela veut aussi dire
+que les liaisons de prolongation et d'articulation ne peuvent ni entrer
+ni sortir de la construction @code{<< \\ >>}.  À l'inverse, des voix
+parallèles venant de constructions @code{<< \\ >>} séparées sur la même
+portée sont dans les mêmes voix.  Voici le même exemple, avec des
+couleurs et têtes de note différentes pour chaque voix.  Notez que le
+changement de style de tête de note n'affecte pas l'intérieur des
+constructions @code{<< \\ >>}.  Aussi, le changement à la deuxième voix
+dans la première construction @code{<< \\ >>} l'affecte aussi dans la
+deuxième construction @code{<< \\ >>}, et la voix est liée entre les
+deux constructions.
+
+@cindex têtes de note, styles
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  <<
+    { g4 f e } \\
+    { \override NoteHead #'style = #'triangle
+      \override NoteHead #'color = #blue
+    r8 e4 d c8 ~ }
+  >> |
+  <<
+    { d2 e2 } \\
+    { c8 b16 a b8 g ~ g2 } \\
+    { \override NoteHead #'style = #'slash 
+      \override NoteHead #'color = #green
+      s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+La polyphonie ne change pas la relation des notes dans un bloc
+@code{\relative @{ @}}.  Chaque note est calculée en fonction de la note
+qui la précède immédiatement, sans tenir compte des différentes voix.
+
+@example
+\relative @{ noteA << noteB \\ noteC >> noteD @}
+@end example
+
+@code{noteC} est calculé relativement à @code{noteB}, non pas à
+@code{noteA} ; @code{noteD} est calculé relativement à @code{noteC}, non
+pas à @code{noteB} ou @code{noteA}.
+
+
+@node Explicitly instantiating voices
+@unnumberedsubsubsec Explicitly instantiating voices
+
+Les contextes @internalsref{Voice} peuvent être déclarés manuellement
+dans un bloc @code{<< >>} pour créer de la musique polyphonique, en
+utilisant @code{\voiceOne}, @dots{} jusqu'à @code{\voiceFour} pour
+assigner des directions de hampes et un déplacement horizontal pour
+chaque partie.
+
+En particulier,
+@example
+<< \upper \\ \lower >>
+@end example
+
+@noindent
+équivaut à
+
+@example
+<<
+ \new Voice = "1" @{ \voiceOne \upper @}
+ \new Voice = "2" @{ \voiceTwo \lower @}
+>>
+@end example
+
+Les commandes @code{\voiceXXX} fixent la direction des hampes, des
+liaisons de prolongations et de phrasé, des articulations, des
+annotations, des points d'augmentation des notes pointées et des
+doigtés.  @code{\voiceOne} et @code{\voiceThree} font pointer ces objets
+vers le haut, alors que @code{\voiceTwo} et @code{\voiceFour} les font
+pointer vers le bas.  La commande @code{\oneVoice} les ramène aux
+critères normaux.
+
+Une expression séquentielle qui apparaît en premier dans un @code{<< >>}
+appartient à la voix principale.  Ceci est utile lorsque des voix
+supplémentaires apparaissent pendant que la voix principale est jouée.
+Voici une meilleure réalisation de l'exemple de la section précédente.
+Les notes colorées et en croix mettent en évidence le fait que la mélodie principale
+est maintenant dans un seul contexte de voix.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2 }
+    \new Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. | s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+La définition correcte des voix permet à la mélodie d'être liée.
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Le fait d'éviter le séparateur @code{\\} permet aussi d'imbriquer des
+constructions polyphoniques, ce qui peut être une manière plus naturelle
+de saisir la musique.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ |
+      <<
+        {c8 b16 a b8 g ~ g2}
+        \new Voice { \voiceThree
+          s4 b4 c2
+          \oneVoice
+        }
+      >>
+    \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Dans certaines circonstances de polyphonie complexe, vous pourrez être
+amené à recourir à des voix supplémentaires afin d'éviter des collisions
+de notes.  Ces voix additionnelles s'ajoutent en définissant un
+identificateur, comme le montre l'exemple suivant :
+
+@lilypond[quote,verbatim,ragged-right,relative=2]
+voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
+
+\relative c''' <<
+  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
+  { \voiceThree  b4} \\
+  { \voiceFive d,} \\
+  { \voiceTwo g,}
+>>
+@end lilypond
+
+
+@node Collision Resolution
+@unnumberedsubsubsec Collision Resolution
+
+D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
+fusionnées, mais lorsque la propriété @code{merge-differently-dotted} de
+l'objet @internalsref{NoteCollision} est définie, elles se trouvent
+fusionnées :
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice << {
+  g8 g8
+  \override Staff.NoteCollision
+    #'merge-differently-dotted = ##t
+  g8 g8
+} \\ { g8.[ f16] g8.[ f16] } >>
+@end lilypond
+
+De même, vous pouvez fusionner une tête de blanche avec une tête de
+croche, en définissant @code{merge-differently-headed}
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\new Voice << {
+  c8 c4.
+  \override Staff.NoteCollision
+    #'merge-differently-headed = ##t
+c8 c4. } \\ { c2 c2 } >>
+@end lilypond
+
+LilyPond décale aussi verticalement les silences à l'opposé des hampes,
+par exemple
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new Voice << c''4 \\ r4 >>
+@end lilypond
+
+Lorsque trois notes ou plus s'agglutinent dans un même empilement,
+@code{merge-differently-headed} ne peut mener à bien la fusion des deux
+notes qui devraient l'être.  Pour obtenir une fusion optimale, appliquez
+un décalage (@code{\shift}) à la note qui ne devrait pas s'empiler.
+Dans la première mesure de l'exemple suivant,
+@code{merge-differently-headed} ne fonctionne pas --- la tête de la
+blanche est noire.  Dans la seconde mesure, @code{\shiftOn} s'applique
+pour sortir le sol (@code{g}) de l'alignement, et
+@code{merge-differently-headed} fonctionne correctement.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.NoteCollision #'merge-differently-headed = ##t
+<<
+  { d=''2 g2 } \\
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+<<
+  { d'=''2 \shiftOn g2 } \\ 
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+@end lilypond
+
+
+@refcommands
+
+@funindex \oneVoice
+@code{\oneVoice},
+@funindex \voiceOne
+@code{\voiceOne},
+@funindex \voiceTwo
+@code{\voiceTwo},
+@funindex \voiceThree
+@code{\voiceThree},
+@funindex \voiceFour
+@code{\voiceFour}.
+
+@funindex \shiftOn
+@code{\shiftOn},
+@funindex \shiftOnn
+@code{\shiftOnn},
+@funindex \shiftOnnn
+@code{\shiftOnnn},
+@funindex \shiftOff
+@code{\shiftOff} : toutes ces commandes précisent le degré de décalage
+des notes de la voix courante.  Les voix externes --- habituellement,
+les voix une et deux --- ont @code{\shiftOff}, alors que les voix
+internes --- trois et quatre --- ont @code{\shiftOn}.  @code{\shiftOnn}
+et @code{\shiftOnnn} sont des niveaux supplémentaires de décalage.
+
+Quand LilyPond est dépassé, la propriété @code{force-hshift} de l'objet
+@internalsref{NoteColumn}, et des silences à hauteur déterminée, peuvent
+s'avérer utiles pour dicter au programme les choix de placement.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative <<
+{
+  <d g>
+  <d g>
+} \\ {
+  <b f'>
+  \once \override NoteColumn #'force-hshift = #1.7
+  <b f'>
+} >>
+@end lilypond
+
+
+@seealso
+Référence du programme : les objets appropriés pour résoudre les
+collisions sont @internalsref{NoteCollision} et
+@internalsref{RestCollision}.
+
+
+@refbugs
+
+Quand @code{merge-differently-headed} est utilisé avec une croche ou
+une valeur plus courte à hampe vers le haut, et une blanche hampe vers
+le bas, la croche se retrouve à la mauvaise place.
+
+Il n'y a aucune prise en charge des agrégats dans lesquels une même note
+apparaît avec différentes altérations.  Il est conseillé d'avoir recours
+aux enharmoniques, ou d'utiliser la notation spécifique de cluster ---
+voir @ref{Clusters}.
+
+
+
+@node Automatic part combining
+@unnumberedsubsubsec Automatic part combining
+@cindex regroupement automatique de parties
+@cindex parties, combiner des
+
+Le regroupement automatique de parties vous permet de fusionner deux
+pupitres sur une seule portée, ceci dans le but de créer des
+partitions d'orchestre.  Lorsque les deux parties sont identiques sur
+une certaine durée, une seule s'affiche.  Lorsqu'elles diffèrent, 
+deux voix séparées apparaissent, avec des hampes dont la direction est
+gérée automatiquement.  Vous pouvez aussi identifier et faire
+ressortir les solos et parties @emph{a due}.
+
+Voici la syntaxe qui permet de combiner des parties :
+
+@example
+\partcombine @var{musicexpr1} @var{musicexpr2}
+@end example
+
+
+L'exemple suivant illustre les fonctionnalités élémentaires du
+combinateur de parties : positionner les parties sur une portée, gérer
+la direction des hampes et de la polyphonie.
+
+@lilypond[quote,verbatim,ragged-right,fragment]
+\new Staff \partcombine
+  \relative g' { g g a( b) c c r r }
+  \relative g' { g g r4 r e e g g }
+@end lilypond
+
+Le premier @code{sol} n'apparaît qu'une seule fois, alors qu'il a été
+spécifié deux fois (une fois dans chacune des parties).  La direction
+des hampes et des liaisons de tenue ou de phrasé est gérée
+automatiquement, selon qu'il s'agisse d'un solo ou d'un unisson.  La
+première partie, dont le contexte s'appellera @code{one}, aura toujours
+ses hampes dirigées vers le haut et sera notée @q{Solo}, alors que la
+deuxième, appelée @code{two}, aura des hampes vers le bas et sera
+notée @q{Solo@tie{}II}.
+
+Si votre intention n'est que de fusionner les parties, sans ajouter de
+texte, assignez faux à la propriété @code{printPartCombineTexts}.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Staff.printPartCombineTexts = ##f
+  \partcombine
+    \relative g' { g a( b) r }
+    \relative g' { g r4 r f }
+>>
+@end lilypond
+
+Le texte imprimé pour les sections solo ou à l'unisson se règle par
+les propriétés @code{soloText}, @code{soloIIText}, et @code{aDueText}. 
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Score.soloText = #"ichi"
+  \set Score.soloIIText = #"ni"
+  \set Score.aDueText = #"tachi"
+  \partcombine
+    \relative g' { g4 g a( b) r }
+    \relative g' { g4 g r r f }
+>>
+@end lilypond
+
+LilyPond interprète dans un contexte @internalsref{Voice} les
+arguments fournis à @code{\partcombine}.  Si vous travaillez avec des
+octaves relatives, spécifiez @code{\relative} dans chacune des
+expressions musicales, comme ceci :
+
+@example
+\partcombine
+  \relative @dots{} @var{musicexpr1}
+  \relative @dots{} @var{musicexpr2}
+@end example
+
+@noindent
+Une section @code{\relative} en dehors de @code{\partcombine} sera
+sans effet sur les hauteurs de @var{musicexpr1} et @var{musicexpr2}.
+
+@seealso
+
+Référence du programme : @internalsref{PartCombineMusic}.
+
+@refbugs
+
+Lorsque @code{printPartCombineTexts} est actif et que les deux voix
+jouent souvent les mêmes notes, le combinateur peut afficher @code{a2}
+plus d'une fois par mesure.
+
+@code{\partcombine} ne peut s'inscrire dans un bloc @code{\times}.
+
+@code{\partcombine} ne peut s'inscrire dans un bloc @code{\relative}.
+
+En interne, @code{\partcombine} interprète les deux arguments en tant
+que @code{Voice}s, dénommées @code{one} et @code{two}, puis décide de
+quand les parties seront fusionnées.  Par conséquent, si les arguments
+changent pour d'autres noms de contexte @internalsref{Voice}, les
+événements qu'ils contiendraient seront ignorés. 
+
+
+@node Writing music in parallel
+@unnumberedsubsubsec Writing music in parallel
+
+@cindex écrire la musique en parallèle
+@cindex musique en parallèle
+@cindex musique entremêlée
+
+On peut écrire plusieurs voix de façon entremêlée :
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
+  c'2                                c'2                                |
+  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
+  c'2                                c'2                                |
+}
+\new StaffGroup <<
+  \new Staff \new Voice \voiceA
+  \new Staff \new Voice \voiceB
+>>
+@end lilypond
+
+Ceci fonctionne bien avec la musique pour piano :
+
+@lilypond[quote,verbatim]
+music = {
+  \key c \major
+  \time 4/4
+  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
+    % Bar 1
+    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
+e''] |
+    c'2                                 c'2 |
+    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
+    c2                                  c2 |
+
+    % Bar 2
+    a'8 b'      c'' d''    e'' f''    g'' a'' |
+    d'4         d'         d'         d' |
+    c16 d e f   d e f g    e f g a    f g a b |
+    a,4         a,4        a,4        a,4 |
+
+    % Bar 3 ...
+  }
+}
+
+\score {
+  \new PianoStaff <<
+    \music
+    \new Staff <<
+      \voiceA \\
+      \voiceB
+    >>
+    \new Staff {
+      \clef bass
+      <<
+        \voiceC \\
+        \voiceD
+      >>
+    }
+  >>
+}
+@end lilypond
+
+
diff --git a/Documentation/fr/user/spacing.itely b/Documentation/fr/user/spacing.itely
index 38a4ad5b05..b23adcbea0 100644
--- a/Documentation/fr/user/spacing.itely
+++ b/Documentation/fr/user/spacing.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/specialist.itely b/Documentation/fr/user/specialist.itely
new file mode 100644
index 0000000000..66edc579f2
--- /dev/null
+++ b/Documentation/fr/user/specialist.itely
@@ -0,0 +1,34 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Specialist notation
+@chapter Specialist notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Vocal music:: a
+* Chords Blah:: b
+* Piano music:: c
+* Percussion:: d
+* Guitar:: e
+* Orchestral strings::
+* Bagpipes::
+* Ancient notation:: g
+@end menu
+
+@include vocal.itely
+@include chords.itely
+@include piano.itely
+@include percussion.itely
+@include guitar.itely
+@include strings.itely
+@include bagpipes.itely
+@include ancient.itely
+
+
diff --git a/Documentation/fr/user/staff.itely b/Documentation/fr/user/staff.itely
new file mode 100644
index 0000000000..cbc72dc99e
--- /dev/null
+++ b/Documentation/fr/user/staff.itely
@@ -0,0 +1,616 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Staff notation
+@section Staff notation
+
+staff = singular, staves = plural
+
+@menu
+* Displaying staves::           
+* Writing parts::               
+@end menu
+
+
+@node Displaying staves
+@subsection Displaying staves
+
+@menu
+* System start delimiters::     
+* Staff symbol::                
+* Hiding staves::               
+@end menu
+
+@node System start delimiters
+@unnumberedsubsubsec System start delimiters
+
+@cindex système, début de
+@cindex crochet vertical
+@cindex accolade verticale
+@cindex portée multiple
+@cindex portées, groupe de
+
+De nombreuses partitions sont écrites sur plusieurs portées.  Ces
+portées peuvent être regroupées de quatre manières différentes.
+
+@itemize @bullet
+@item Le groupe de portées est attaché par une accolade sur la gauche,
+et les barres de mesure sont d'un seul tenant. Il s'agit du contexte
+@internalsref{GrandStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new GrandStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item Le groupe de portées est attaché par un crochet, et les barres
+de mesure sont d'un seul tenant. Il s'agit du contexte
+@internalsref{StaffGroup}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new StaffGroup
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+
+
+@item Le groupe de portées est attaché par un crochet, mais les barres
+de mesure sont séparées d'une portée à l'autre. Il s'agit du contexte
+@internalsref{ChoirStaff}.
+
+@lilypond[verbatim,ragged-right,quote]
+\new ChoirStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item Les portées du groupe ne sont pas attachées (hormis par une
+simple ligne verticale). Les barres de mesure sont détachées. Il
+s'agit de l'assemblage par défaut.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+@end itemize
+
+
+@seealso
+
+Les barres de mesure au début de chaque système prennent l'un des styles
+@internalsref{SystemStartBar}, @internalsref{SystemStartBrace},
+@internalsref{SystemStartBracket}.  Dans chaque contexte, seul l'un de
+ces styles est utilisé, et c'est la propriété
+@code{systemStartDelimiter} qui détermine lequel.
+
+@commonprop
+
+Les accolades et crochets délimitant les systèmes peuvent être imbriqués
+en profondeur,
+
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup
+\relative <<
+  \set StaffGroup.systemStartDelimiterHierarchy
+    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+>>
+@end lilypond
+
+
+@node Staff symbol
+@unnumberedsubsubsec Staff symbol
+
+@cindex symbole de portée
+@cindex portée, lignes de
+
+Les notes, nuances, etc. sont regroupés dans un assemblage de lignes
+horizontales, que l'on nomme la portée (en anglais @qq{staff}, et
+@qq{staves} au pluriel).  Dans LilyPond, ces lignes sont dessinées au
+moyen d'un objet de mise en forme à part entière, nommé @code{staff
+symbol} --- symbole de portée.
+
+
+L'aspect du symbole de portée peut être modifié selon différentes
+propriétés, telles que le nombre de lignes, leur épaisseur, ou leur
+éloignement. Vous en trouverez des exemples dans
+@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} et
+@lsr{staff,changing-the-staff-size.ly}.
+
+
+De plus, la portée peut commencer et s'arrêter où l'on veut, grâce aux
+commandes @code{\startStaff} et @code{\stopStaff}.
+
+@lilypond[verbatim,relative=2,fragment]
+b4 b
+\override Staff.StaffSymbol #'line-count = 2
+\stopStaff \startStaff
+b b
+\revert Staff.StaffSymbol #'line-count
+\stopStaff \startStaff
+b b
+@end lilypond
+
+Cette manière de procéder peut être utilisée pour introduire des
+@qq{ossias}, ou dans des partitions à nombre de portées variable,
+comme sur l'exemple suivant :
+
+@cindex ossia
+
+@c @lilypondfile{ossia.ly}
+
+@cindex lignes de portée, nombre de
+@cindex lignes de portée, épaisseur des
+@cindex épaisseur des lignes de portées
+@cindex nombre de lignes de portée
+
+@seealso
+
+Référence du programme : @internalsref{StaffSymbol}.
+
+D'autres exemples : @lsrdir{staff}.
+
+
+@node Hiding staves
+@unnumberedsubsubsec Hiding staves
+
+@cindex Frenched scores
+@cindex Masquer des portées
+
+Dans les partitions d'orchestre, les portées qui n'ont que des
+silences sont habituellement masquées afin de gagner de la place.  Ce
+style d'édition s'appelle en anglais @qq{French Score}.
+Cette fonctionnalité est activée par défaut dans les contextes 
+@internalsref{Lyrics}, @internalsref{ChordNames} et
+@internalsref{FiguredBass}.  Lorsque des lignes appartenant à ces
+contextes se retrouvent vides après placement des sauts de ligne,
+elles sont effacées.
+
+En ce qui concerne les portées normales, il existe un contexte
+@internalsref{Staff} spécifique qui permet d'arriver à ce résultat :
+les portées ne contenant rien ou uniquement des silences multi-mesures
+seront retirées.  La définition de ce contexte est enregistrée dans la
+variable @code{\RemoveEmptyStaffContext}.  Voyez comment la deuxième
+portée disparaît du deuxième système :
+
+@lilypond[quote,ragged-right,verbatim]
+\layout {
+  \context { \RemoveEmptyStaffContext }
+}
+
+{
+  \relative c' <<
+    \new Staff { e4 f g a \break c1 }
+    \new Staff { c4 d e f \break R1 }
+  >>
+}
+@end lilypond
+
+Le premier système comportera absolument toutes les portées.  Si vous
+voulez masquer les portées vides y compris pour le premier système,
+vous devrez assigner vrai à la propriété @code{remove-first} dans
+@internalsref{VerticalAxisGroup}. 
+
+@example
+\override Score.VerticalAxisGroup #'remove-first = ##t
+@end example
+
+Pour masquer d'autres types de contextes, vous pouvez utiliser 
+@code{\AncientRemoveEmptyStaffContext} ou
+@code{\RemoveEmptyRhythmicStaffContext}. 
+
+Une application particulière de cette fonctionnalité est la création
+d'une @emph{ossia} --- variante d'une partie de la mélodie --- affichée à
+l'aide d'une portée supplémentaire.
+
+
+@node Writing parts
+@subsection Writing parts
+
+@menu
+* Metronome marks::             
+* Instrument names::            
+* Quoting other voices::        
+* Formatting cue notes::        
+@end menu
+
+@node Metronome marks
+@unnumberedsubsubsec Metronome marks
+
+@cindex Tempo
+@cindex battements par minute
+@cindex indication métronomique
+
+Le métronome se règle de la manière suivante,
+@example
+\tempo @var{durée} = @var{par minute}
+@end example
+
+Les indications métronomiques seront interprétées, dans le fichier
+MIDI, comme des changements de tempo.  Ils seront imprimés sur la
+partition comme ici :
+@funindex \tempo
+@lilypond[quote,ragged-right,verbatim,fragment]
+\tempo 8.=120 c''1
+@end lilypond
+
+
+@commonprop
+
+Vous pouvez indiquer un changement de tempo pour le fichier MIDI sans
+pour autant l'imprimer.  Il suffit alors de le rendre invisible pour
+l'impression :
+@example
+\once \override Score.MetronomeMark #'transparent = ##t
+@end example
+
+Vous pouvez imprimer d'autres indications métronomiques, telles que
+des équivalences, en utilisant ce type d'étiquette textuelle :
+@lilypond[quote,ragged-right,verbatim,relative,fragment]
+c4^\markup {
+  (
+  \smaller \general-align #Y #DOWN \note #"16." #1
+  =
+  \smaller \general-align #Y #DOWN \note #"8" #1
+  ) }
+@end lilypond
+
+@noindent
+Pour plus de détails, voir @ref{Text markup}.
+
+
+@seealso
+
+Référence du programme : @internalsref{MetronomeMark}.
+
+
+@refbugs
+
+Les risques de collision ne sont pas vérifiés.  Dans le cas où il y
+aurait des notes au dessus de la portée ou d'autres objets
+(articulations, liaisons, texte, etc), l'indication métronomique peut
+venir en surimpression.  Augmentez alors le décalage de cette
+indication par rapport à la portée :
+
+@example
+\override Score.MetronomeMark #'padding = #2.5
+@end example
+
+
+@node Instrument names
+@unnumberedsubsubsec Instrument names
+
+Dans un conducteur, les noms d'instrument sont portés en regard de
+chacune des portées.
+
+Ce résultat s'obtient en spécifiant
+@internalsref{Staff}.@code{instrumentName} et
+@internalsref{Staff}.@code{shortInstrumentName}, ou
+@internalsref{PianoStaff}.@code{instrumentName} et 
+@internalsref{PianoStaff}.@code{shortInstrumentName}.  L'argument
+textuel apparaîtra avant le début de la portée.  La première ligne
+affichera @code{instrumentName}, et les suivantes
+@code{shortInstrumentName}. 
+
+@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
+\set Staff.instrumentName = "Ploink "
+\set Staff.shortInstrumentName = "Plk "
+c1
+\break
+c''
+@end lilypond
+
+Le recours à la commande @code{\markup} permet de construire des noms
+d'instruments particuliers, tels que
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\set Staff.instrumentName = \markup {
+  \column { "Clarinetti"
+            \line { "in B" \smaller \flat } } }
+c''1
+@end lilypond
+
+Si vous centrez le nom d'un instrument, il faudra le faire pour tous
+
+@lilypond[quote,verbatim,ragged-right]
+{ <<
+\new Staff {
+  \set Staff.instrumentName = \markup {
+    \center-align { "Clarinetti"
+      \line { "in B" \smaller \flat } } }
+  c''1
+}
+\new Staff {
+  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
+  c''1
+}
+>>
+}
+@end lilypond
+
+Losque le nom d'un instrument est relativement long, il est judicieux
+d'augmenter le retrait --- @code{indent} --- au sein du bloc
+@code{\layout}. 
+
+Procédez comme suit pour centrer des noms d'instruments tout en
+préservant un décalage par rapport à la portée :
+
+@lilypond[quote,verbatim,ragged-right]
+\new StaffGroup \relative
+<<
+  \new Staff {
+    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
+    c1 c1
+  }
+  \new Staff {
+    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
+    c1 c1
+  }
+>>
+@end lilypond
+
+Des noms d'instruments peuvent s'utiliser dans d'autres contextes, tels
+que @code{GrandStaff}, @code{ChoirStaff}, ou @code{StaffGroup}, à
+condition de leur affecter le graveur approprié :
+
+@example
+\layout@{
+  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
+@}
+@end example
+
+@noindent
+Pour de plus amples informations sur la manière d'activer ou
+désactiver un graveur, voir @ref{Modifying context plug-ins}.
+
+Vous pouvez changer d'instrument en cours de morceau :
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\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
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{InstrumentName}.
+
+
+@node Quoting other voices
+@unnumberedsubsubsec Quoting other voices
+
+@cindex cues
+@cindex citation
+
+Grâce aux citations de répliques, vous pouvez insérer directement dans une partie
+des fragments d'une autre partie.  Avant qu'une partie ne puisse être
+mentionnée ailleurs, elle doit être considérée comme reproductible.
+C'est le but de la commande @code{\addQuote}.
+
+@example
+\addQuote @var{nom} @var{musique}
+@end example
+
+
+@noindent
+Ici, @var{nom} représente une chaîne d'identification, et
+@var{musique} n'importe quelle musique.  Voici un exemple de
+@code{\addQuote} :
+
+@example
+\addQuote clarinet \relative c' @{
+  f4 fis g gis
+@}
+@end example
+
+Vous devez placer cette commande au niveau le plus haut, c'est à dire
+en dehors de tout bloc de musique.
+
+Après avoir fait appel à @code{\addquote}, la citation interviendra
+en utilisant @code{\quoteDuring} ou @code{\cueDuring} :
+
+@example
+\quoteDuring #@var{nom} @var{musique}
+@end example
+
+Au cours d'une partie, des extraits de répliques peuvent être cités en
+utilisant la commande @code{\quoteDuring}.
+
+@example
+\quoteDuring #"clarinet" @{ s2. @}
+@end example
+
+Cela citera trois noires (la durée de @code{s2.}) appartenant à la
+voix @code{clarinette} précédemment générée.
+
+Plus précisément, on s'arrête à cet instant de la partie en cours
+d'impression, et l'on extrait les notes à ce même instant dans la voix
+citée --- celle qui contient @code{\addQuote}.  C'est la raison pour
+laquelle l'argument de @code{\addQuote} doit englober toute la voix en
+question, y compris les éventuels silences à son début.
+
+Les citations tiennent compte des transpositions, aussi bien celle de
+l'instrument d'origine que celle de la partie où elle intervient, dans
+la mesure où elles sont spécifiées par la commande @code{\transposition}.
+
+@lilypond[quote,ragged-right,verbatim]
+\addQuote clarinet \relative c' {
+  \transposition bes
+  f4 fis g gis
+}
+
+{
+  e'8 f'8 \quoteDuring #"clarinet" { s2 }
+}
+@end lilypond
+
+Le type d'événements pris en charge pour la citation peut se régler
+avec la propriété @code{quotedEventTypes}.  Par défaut, sa valeur est
+fixée à @code{(note-event rest-event)}, ce qui signifie que seuls les
+notes et silences seront mentionnés par @code{\quoteDuring}.
+Définir
+
+@example
+\set Staff.quotedEventTypes =
+       #'(note-event articulation-event dynamic-event)
+@end example
+
+@noindent
+reproduira les notes (mais pas les silences), ainsi que les scripts
+et nuances.
+
+@refbugs
+
+Seul le contenu de la première @internalsref{Voice} rencontrée dans la
+partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
+voie de conséquence, @code{music} ne saurait comprendre de @code{\new}
+ou une instance @code{context Voice} qui la ferait passer à une autre voix.
+
+Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
+un blocage de LilyPond.
+
+Citer des triolets imbriqués peut entraîner un résultat de médiocre qualité.
+
+
+@seealso
+
+Dans ce manuel : @ref{Instrument transpositions}.
+
+Exemples : @lsr{parts,quote.ly}, @lsr{parts,quote-transportation.ly}
+
+Référence du programme : @internalsref{QuoteMusic}.
+
+
+@node Formatting cue notes
+@unnumberedsubsubsec Formatting cue notes
+
+@cindex petites notes, formater des
+
+La section précédente indiquait comment insérer des notes d'une autre
+voix.  Nous allons maintenant voir une fonction musicale avancée,
+@code{\cueDuring}, qui facilite le formatage des petites notes.
+
+Sa syntaxe est :
+
+@example
+  \cueDuring #@var{nom} #@var{updown} @var{musique}
+@end example
+
+Des notes issues de la partie @var{nom} s'insèreront dans une
+@internalsref{Voice} nommée @code{cue}, simultanément avec
+@var{musique} --- habituellement un silence.  L'apparition des petites
+notes initialise une polyphonie temporaire pour la portée concernée.  
+L'argument @var{updown} détermine si ces petites notes seront
+attachées à la première ou à la seconde voix.
+
+
+@lilypond[verbatim,ragged-right]
+smaller = {
+  \set fontSize = #-2
+  \override Stem #'length-fraction = #0.8
+  \override Beam #'thickness = #0.384
+  \override Beam #'length-fraction = #0.8
+}
+
+\addQuote clarinet \relative {
+  R1*20
+  r2 r8 c' f f
+}
+
+\new Staff \relative  <<
+
+  % setup a context for cue notes.
+  \new Voice = "cue" { \smaller \skip 1*21 }
+
+  \set Score.skipBars = ##t
+
+  \new Voice {
+    R1*20
+    \cueDuring #"clarinet" #UP {
+      R1
+    }
+    g4 g2.
+  }
+>>
+@end lilypond
+
+
+Quelques indications pour une citation efficace :
+
+@itemize @bullet
+@item
+ Les notes de la citation sont dans une police plus petite.
+@item
+ La citation comporte une étiquette indiquant l'instrument qui joue.
+@item
+ Lorsque la partie originale reprend sa place, rappeler l'instrument.
+
+@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
+
+@c Yes, this is good practice.  Otherwise, the start of the original
+@c part can only be seen from the font size.  This is not good enough
+@c for sight-reading.  It is possilbe to use other
+@c markers (e.g. a big close-bracket over the staff) to indicate the cue
+@c   notes are
+@c finished.
+@c -hwn
+
+
+Tout autre modification introduite par la citation devrait être
+annulée.  Par exemple, si l'instrument cité utilise une autre clé, il
+faudra revenir à la clé habituelle.
+
+@end itemize
+
+La macro @code{\transposedCueDuring} est particulièrement adaptée pour
+des instrument ayant une tessiture éloignée, comme dans le cas d'un
+piccolo cité dans une partie de contrebasson.
+
+@lilypond[verbatim,ragged-right,quote]
+picc = \relative c''' {
+  \clef "treble^8"
+  R1 |
+  c8 c c e g2 |
+  a4 g g2 |
+}
+\addQuote "picc" { \picc }
+
+cbsn = \relative c, {
+  \clef "bass_8"
+  c4 r g r
+  \transposedCueDuring #"picc" #UP c,, { R1 } |
+  c4 r g r |
+}
+
+<<
+  \context Staff = "picc" \picc
+  \context Staff = "cbsn" \cbsn
+>>
+@end lilypond
+
+
diff --git a/Documentation/fr/user/strings.itely b/Documentation/fr/user/strings.itely
new file mode 100644
index 0000000000..39c150c271
--- /dev/null
+++ b/Documentation/fr/user/strings.itely
@@ -0,0 +1,46 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Orchestral strings
+@section Orchestral strings
+
+Cette section dispense des informations supplémentaires et utiles à
+l'écriture pour les cordes frottées.
+
+@menu 
+* Orchestral strings TODO::
+@end menu
+
+
+@node Orchestral strings TODO
+@subsection Orchestral strings TODO
+
+@menu 
+* Artificial harmonics (strings)::
+@end menu
+
+@node Artificial harmonics (strings)
+@unnumberedsubsubsec Artificial harmonics (strings)
+
+@node Artificial harmonics (strings)
+@unnumberedsubsubsec Artificial harmonics (strings)
+
+@cindex harmoniques
+
+La plupart des instruments à cordes peuvent produire des harmoniques
+artificiels, lorsque l'instrumentiste effleure simplement la corde pour
+une note donnée.  Le son émis sera un harmonique, que l'on peut indiquer
+par @code{\harmonic}.
+
+@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
+<c g'\harmonic>4
+@end lilypond
+
+
diff --git a/Documentation/fr/user/templates.itely b/Documentation/fr/user/templates.itely
index 1a97a3e9e0..7bc3f46e5a 100644
--- a/Documentation/fr/user/templates.itely
+++ b/Documentation/fr/user/templates.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
-    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
 
 
     When revising a translation, copy the HEAD committish of the
diff --git a/Documentation/fr/user/text.itely b/Documentation/fr/user/text.itely
new file mode 100644
index 0000000000..10ead3bb20
--- /dev/null
+++ b/Documentation/fr/user/text.itely
@@ -0,0 +1,848 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Text
+@section Text
+
+Nous allons voir ici comment insérer du texte, selon différents
+formatages, dans vos partitions.
+
+@cindex Texte, autres langues
+Pour écrire des accents et autres caractères spéciaux, il suffit de
+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::                 
+@end menu
+
+
+@node Writing text
+@subsection Writing text
+
+@menu
+* Text scripts::                
+* Text and line spanners::      
+* Text spanners::               
+* Text marks::                  
+* New dynamic marks::           
+@end menu
+
+@node Text scripts
+@unnumberedsubsubsec Text scripts
+
+@c I'm not fond of this "étiquette" wording of yours Jean-Charles;
+@c j'utiliserais simplement l'expression "bloc \markup" afin
+@c d'éviter toute confusion avec les \tags (qui méritent davantage
+@c le titre d'étiquette, stricto sensu) -vv
+
+@cindex Étiquette de texte
+@cindex blocs de texte
+@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
+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{\fatText}.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+c4^"longtext" \fatText c4_"longlongtext" c4
+@end lilypond
+
+@noindent
+Pour revenir à l'espacement par défaut, utilisez @code{\emptyText}.
+
+Des constructions plus élaborées d'étiquette peuvent être obtenues en
+ayant recours à la commande @emph{markup} :
+
+@lilypond[fragment,ragged-right,verbatim,quote]
+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}.
+
+
+@refcommands
+
+@funindex \fatText
+@code{\fatText},
+@funindex \emptyText
+@code{\emptyText}.
+
+
+@commonprop
+
+S'assurer que tous les éléments textuels et les paroles respectent
+les marges du document requiert des calculs relativement lourds ; c'est
+la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
+Vous pouvez cependant l'y forcer en définissant
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+
+@seealso
+
+Dans ce manuel : @ref{Text markup}.
+
+Référence du programme : @internalsref{TextScript}.
+
+
+@node Text and line spanners
+@unnumberedsubsubsec Text and line spanners
+
+Certaines indications d'interprétation comme @i{rallentando}, 
+@i{accelerando} ou @i{trilles}, s'incrivent textuellement et se
+prolongent sur plusieurs mesures à l'aide d'une ligne pleine, pointillée
+ou ondulée.
+
+Les routines chargées de matérialiser un @emph{glissando} sont tout à
+fait adaptées à une gestion précise, à la fois du placement du texte, et
+du calcul de l'envergure de sa ligne d'extension.  La routine
+@code{ly:line-interface::print} est plus particulièrement en charge de
+déterminer les points d'ancrage de la ligne et de la dessiner selon le
+style requis.
+  
+Voici un exemple qui illustre les différents styles de ligne
+disponibles, ainsi que la manière de les personnaliser.
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+d2 \glissando d'2
+\once \override Glissando #'dash-fraction = #0.5
+d,2 \glissando d'2
+\override Glissando #'style = #'dotted-line
+d,2 \glissando d'2
+\override Glissando #'style = #'zigzag
+d,2 \glissando d'2
+\override Glissando #'style = #'trill
+d,2 \glissando d'2
+@end lilypond
+
+L'information qui va déterminer les extrémités est calculée à la
+volée pour chaque objet graphique.  Il est tout à fait possible de les
+régler vous-même :
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+e2 \glissando f
+\once \override Glissando #'bound-details #'right #'Y = #-2
+e2 \glissando f
+@end lilypond
+
+L'objet @code{Glissando}, comme tous ceux qui utilisent la routine
+@code{ly:line-interface::print}, comporte une liste 
+d'associations.  Dans le code ci-dessus, la valeur de @code{Y} est
+fixée, dans la liste d'associations, à @code{-2} pour l'ancrage à
+droite.  Vous pouvez naturellement ajuster l'extrémité gauche en
+remplaçant @code{right} (pour @code{droite}) par @code{left}.
+
+Si @code{Y} n'est pas fixé, sa valeur sera calculée en fonction de la
+hauteur du point de référence droite de la ligne.
+
+Lorsque survient un saut de ligne, la liste des ancrages est
+augmentée d'une liste complémentaire contenant @code{left-broken}
+(brisure à gauche) et @code{right-broken} (brisure à droite), comme
+dans l'exemple suivant :
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+\override Glissando #'breakable = ##T 
+\override Glissando #'bound-details #'right-broken #'Y = #-3
+c1 \glissando \break
+f1
+@end lilypond
+
+Vous disposez des propriétés suivantes :
+
+@table @code
+@item Y
+Fixe l'ordonnée (coordonnée-Y) de l'extrémité, mesurée en taille de
+portée.  Il s'agit par défaut du centre de l'objet de rattachement ;
+pour un glissando, ce sera le milieu de la tête de note.
+
+Pour des marques horizontales, telles du texte ou le trait d'un
+trille, cette valeur est figée à 0.
+
+@item attach-dir
+Détermine l'endroit où la ligne commence et finit, relativement à
+l'objet de rattachement. Autrement dit, une valeur de @code{-1} (ou
+@code{LEFT} pour gauche) fera commencer ou finir la ligne du côté
+gauche de la tête de note de référence.
+
+@item X
+Coordonnée absolue du point final. Dans la mesure où elle est calculée
+à la volée, il n'y a pas vraiment de raison de l'outrepasser.
+
+@item stencil
+Sous-propriété contenant les éventuels symboles présents avant ou
+après la ligne. Destinée à un usage interne, nous vous recommendons
+d'utiliser plutôt @code{text}.
+
+@item text
+Marqueur qui sera analysé pour alimenter @code{stencil}.  On y trouve
+habituellement les @i{cresc.} ou @i{tr} des extenseurs horizontaux.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override TextSpanner #'bound-details #'left #'text
+   = \markup { \small \bold Slower }
+c2\startTextSpan b c a\stopTextSpan
+@end lilypond
+
+@item stencil-align-dir-y
+@item stencil-offset
+Lorsqu'ils ne sont pas définis, le tracé est tout simplement
+positionné conformément aux sous-propriétés @code{X} et @code{Y}.  En
+fixant soit @code{stencil-align-dir-y}, soit @code{stencil-offset},
+vous pouvez décaler le coin du marqueur par rapport à l'extrémité de
+la ligne.
+
+@lilypond[relative=1,fragment,verbatim]
+\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
+\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
+
+\override TextSpanner #'bound-details #'left #'text = #"gggg"
+\override TextSpanner #'bound-details #'right #'text = #"hhhh"
+c4^\startTextSpan c c c \stopTextSpan
+@end lilypond
+
+@item arrow
+Assigner à cette sous-propriété la valeur @code{vrai} (@code{#t})
+produira une terminaison en pointe de flèche.
+
+@item padding
+Cette sous-propriété contrôle l'espace entre les extrémités de la
+ligne, telles que définies, et la réalité.  Sans ce léger décalage, le
+début et la fin d'un glissando seraient en plein milieu des têtes de note.
+
+@end table
+
+@seealso
+
+Référence du programme : @internalsref{TextSpanner},
+@internalsref{Glissando}, @internalsref{VoiceFollower},
+@internalsref{TrillSpanner}, @internalsref{line-spanner-interface}.
+
+Exemples : @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
+
+
+@node Text spanners
+@unnumberedsubsubsec Text spanners
+
+@cindex Prolongateurs de texte
+
+Certaines indications d'interprétation comme @i{rallentando} ou 
+@i{accelerando} s'incrivent en toutes lettres et se prolongent sur
+plusieurs mesures grâce à une ligne pointillée.  Les commandes
+@code{\startTextSpan} et @code{\stopTextSpan}, respectivement
+attachées à la première et à la dernière note qu'elles concernent,
+déterminent l'envergure de ces prolongateurs, ou extenseurs.
+
+La chaîne à imprimer, ainsi que son style, sont définis par des
+propriétés, comme ici :
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c1
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \upright "rall" } 
+c2\startTextSpan b c\stopTextSpan a
+\break
+\textSpannerUp
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \italic "rit" } 
+c2\startTextSpan b c\stopTextSpan a
+@end lilypond
+
+@refcommands
+
+@funindex textSpannerUp
+@code{\textSpannerUp},
+@funindex textSpannerDown
+@code{\textSpannerDown},
+@funindex textSpannerNeutral
+@code{\textSpannerNeutral}.
+
+
+@commonprop
+
+Pour obtenir une ligne pleine, utilisez
+
+@example
+\override TextSpanner #'dash-fraction = #'()
+@end example
+
+
+@seealso
+
+Référence du programme : @internalsref{TextSpanner}.
+
+
+@node Text marks
+@unnumberedsubsubsec Text marks
+
+@cindex coda sur une barre de mesure
+@cindex segno sur une barre de mesure
+@cindex point d'orgue sur une barre de mesure
+@cindex barres de mesure, symboles au dessus de
+@funindex \mark
+
+La commande @code{\mark} est tout d'abord conçue pour les
+@ref{Rehearsal marks}.  Elle peut néanmoins servir à insérer des
+signes de coda ou de segno, ou bien un point d'orgue, au dessus d'une
+barre de mesure.  Couplez-la alors à la commande @code{\markup} pour
+avoir accès au symbole approprié (ils sont répertoriés dans 
+@ref{The Feta font}).
+
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+Le résultat de @code{\mark} n'apparaîtra que sur la portée supérieure
+d'un système.  Si vous introduisez la commande @code{\mark} au moment
+d'une barre de mesure, la marque se placera au dessus de la barre.  Si
+vous y faites appel au milieu d'une mesure, cette marque sera
+positionnée entre les notes.  Si elle intervient en début de ligne,
+elle sera placée juste avant la première note de cette portée.  Enfin,
+une marque qui tomberait sur un saut de ligne sera imprimée au début
+de la ligne suivante.
+@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
+@c  delete this sentence.   -gp
+Au cas où il n'y aurait pas de ligne à suivre, la marque ne sera pas imprimée.
+
+
+@commonprop
+
+Pour imprimer une marque à la fin de la portée en cours, procédez
+ainsi :
+
+@example
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+@end example
+
+@code{\mark} est souvent bien utile pour porter une indication à la
+fin d'une mesure.  Pensez alors à modifier la propriété
+@code{#'self-alignment}.  
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+c1 c c c4 c c c
+\once \override Score.RehearsalMark #'self-alignment-X = #right
+\mark "D.S. al Fine "
+@end lilypond
+
+Les indications textuelles peuvent s'aligner par rapport à d'autres
+objets que des barres de mesure, tels que l'armure, la clé ou le chiffre de
+mesure : 
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\relative {
+  c1
+  \key cis \major
+  \clef alto
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  \mark "on key"
+  cis
+  \key ces \major
+  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
+  \clef treble
+  \mark "on clef"
+  ces
+  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
+  \key d \minor
+  \clef tenor
+  \time 3/4
+  \mark "on time"
+  c
+}
+@end lilypond
+
+Les symboles pris en charge par @code{break-align-symbols} sont :
+@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
+@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
+@code{key-signature}, et @code{time-signature}.
+
+Par défaut, les indications textuelles sont alignées avec le milieu
+des objets de notation. Bien entendu, vous pouvez modifier les
+propriétés @code{break-align-anchor-alignment} ou
+@code{break-align-anchor} des objets en question pour obtenir un autre
+résultat.
+
+@c KEEP LY
+@lilypond[fragment,quote,ragged-right,verbatim]
+{
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  c1
+  \key cis \major
+
+  % La marque sera alignée sur le côté gauche de l'armure
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
+  \mark \default
+  cis1
+  \key ces \major
+
+  % La marque sera alignée sur le côté droit de l'armure
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
+  \mark \default
+  ces1
+  \key cis \major
+
+  %  La marque sera alignée sur le côté gauche de l'armure,
+  % puis décalée vers la droite de 2 unités.
+  \once \override Staff.KeySignature #'break-align-anchor = #2
+  \mark \default
+  ces1
+}
+@end lilypond
+
+Bien que ces indications textuelles ne soient habituellement imprimées
+qu'au niveau de la portée supérieure, vous pouvez forcer leur
+affectation à chacune des portées :
+
+@lilypond[quote,ragged-right,verbatim,relative=2]
+{
+  \new Score \with {
+    \remove "Mark_engraver"
+  }
+  <<
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c''1 \mark "foo" c'' }
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c'1 \mark "foo" c' }
+  >>
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{RehearsalMark}.
+
+
+@node New dynamic marks
+@unnumberedsubsubsec New dynamic marks
+
+Grâce à la commande @code{make-dynamic-script}, vous pouvez créer de
+nouvelles marques textuelles de nuances que vous combinerez
+éventuellement avec les signes de nuances.
+Notez bien que la police des nuances en contient que les caractères
+@code{f,m,p,r,s} and @code{z}. 
+
+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.
+
+@cindex make-dynamic-script
+
+@lilypond[quote,verbatim,ragged-right]
+sfzp = #(make-dynamic-script "sfzp")
+\relative c' {
+  c4 c c\sfzp c
+}
+@end lilypond
+
+@cindex Nuances éditoriales
+@cindex Nuances, entre parenthèses
+
+Vous pouvez aussi encadrer les nuances entre parenthèses ou entre
+crochets.  Ceci est souvent utilisé pour ajouter des nuances propres à
+une édition donnée.
+
+@lilypond[quote,verbatim,ragged-right]
+rndf = \markup{ \center-align {\line { \bold{\italic (}
+  \dynamic f \bold{\italic )} }} }
+boxf = \markup{ \bracket { \dynamic f } }
+{ c'1_\rndf c'1_\boxf }
+@end lilypond
+
+
+
+@node Text markup
+@subsection Text markup
+
+@menu
+* Text markup introduction::    
+* Nested scores::               
+* Page wrapping text::          
+* Font selection::              
+@end menu
+
+@node Text markup introduction
+@unnumberedsubsubsec Text markup introduction
+
+@cindex étiquette
+@cindex commentaire textuel
+@cindex étiquette textuelle
+@cindex texte ajouté
+
+La commande @code{\markup} permet d'ajouter du texte.  Vous pouvez y
+inclure des commandes, précédées d'un antislash @code{\} ; les
+caractères @code{\} et @code{#} doivent être encadrés de guillemets
+informatiques @code{"}.
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { hello }
+c1_\markup { hi there }
+c1^\markup { hi \bold there, is \italic {anyone home?} }
+c1_\markup { "\special {weird} #characters" }
+@end lilypond
+
+@noindent
+Pour une liste des différentes commandes disponibles, consultez
+@ref{Overview of text markup commands}. 
+
+
+@code{\markup} est avant tout conçu pour gérer les
+@internalsref{TextScript}s, mais rien ne s'oppose à son utilisation
+pour traiter du texte avec LilyPond.
+
+@lilypond[quote,verbatim]
+\header{ title = \markup{ \bold { foo \italic { bar! } } } }
+\score{
+  \relative c'' {
+    \override Score.RehearsalMark
+      #'break-visibility = #begin-of-line-invisible
+    \override Score.RehearsalMark #'self-alignment-X = #right
+
+    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
+    c2^\markup{ don't be \flat }
+    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
+    b2\startTextSpan
+    a2\mark \markup{ \large \bold Fine }
+    r2\stopTextSpan
+    \bar "||"
+  }
+  \addlyrics { bar, foo \markup{ \italic bar! } }
+}
+@end lilypond
+
+La commande @code{\markup} peut intervenir à tout moment, y compris en
+dehors d'un bloc @code{\score}. Voir à ce sujet 
+@ref{Multiple scores in a book}. 
+
+@lilypond[quote,ragged-right,verbatim]
+\markup{ Here is some text. }
+@end lilypond
+
+@cindex changer de police
+
+Le @emph{markup} de l'exemple précédent montre comment utiliser les
+commandes de changement de police. Les commandes @code{\bold} et
+@code{\italic} n'affectent que le premier mot qui les suit ; encadrez
+les par des accolades si vous désirez que ces commandent s'appliquent
+à plusieurs mots.
+
+@example
+\markup @{ \bold @{ c'est moi @} @}
+@end example
+
+@noindent
+Une bonne habitude à prendre consiste à utiliser des accolades même
+pour un seul mot, comme ici :
+@example
+\markup @{ qui \italic @{ est @} là ? @}
+@end example
+
+En mode @emph{markup}, vous pouvez composer des expressions comme
+en mathématiques, des documents XML ou bien les expressions musicales.
+Vous pouvez empiler ces expressions grâce à la commande
+@code{\column}, ou les centrer par rapport à leur milieu avec
+@code{\center-align}. 
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { \column { a bbbb \line { c d } } }
+c1^\markup { \center-align { a bbbb c } }
+c1^\markup { \line { a b c } }
+@end lilypond
+
+Des listes non précédées de commande ne sont pas isolées. Ainsi, 
+@example
+\center-align @{ @{ a b @} @{ c d @} @}
+@end example
+
+@noindent
+
+est la même expression que
+
+@example
+\center-align @{ a b c d @}
+@end example
+
+@noindent
+
+L'utilisation des @code{"} ou de la commande @code{\line} permet de
+différencier les listes de mots.
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c4^\markup{ \center-align { on three lines } }
+c4^\markup{ \center-align { "all one line" } }
+c4^\markup{ \center-align { { on three lines } } }
+c4^\markup{ \center-align { \line { on one line } } }
+@end lilypond
+
+Vous pouvez stocker les étiquettes textuelles en tant que variables,
+et attacher ces identificateurs à des notes, comme
+@example
+allegro = \markup @{ \bold \large @{ Allegro @} @}
+ @{ a^\allegro b c d @}
+@end example
+
+Certains objets possèdent leurs propres procédures d'alignement, qui
+annuleront toute spécification d'alignement que vous pourriez affecter
+à un argument de type @emph{markup} que vous leur auriez fourni.  Par
+exemple, les @internalsref{RehearsalMark} sont centrées
+horizontalement ; de fait, utiliser 
+@code{\mark \markup @{ \left-align .. @}} sera sans effet.
+
+Par ailleurs, le placement vertical n'est effectué qu'après la
+création de l'objet @emph{étiquette textuelle}. Si donc vous souhaitez
+déplacer une étiquette, il vous faudra utiliser la propriété
+@code{#'padding} ou créer un @qq{point d'ancrage} à l'intérieur même
+de l'étiquette (généralement avec @code{\hspace #0}).
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c'4^\markup{ \raise #5 "not raised" }
+\once \override TextScript #'padding = #3
+c'4^\markup{ raised }
+c'4^\markup{ \hspace #0 \raise #1.5 raised }
+@end lilypond
+
+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}. 
+
+
+@seealso
+
+Dans ce manuel : @ref{Overview of text markup commands}.
+
+Référence du programme : @internalsref{TextScript}.
+
+Fichiers d'initialisation : @file{scm/@/new@/-markup@/.scm}.
+
+
+@refbugs
+
+Le crénage ou la génération de ligatures ne sont accessibles que lors
+d'un retraitement par @TeX{}.  Dans ce cas, LilyPond n'en tient pas
+compte, et l'espacement de tels textes sera trop large.
+
+Les erreurs de syntaxe sont peu loquaces.
+
+
+@node Nested scores
+@unnumberedsubsubsec Nested scores
+
+Rien ne s'oppose à ce qu'une étiquette ne comporte de la musique.  Il
+suffit que l'expression en question contienne un bloc @code{\score} et
+un bloc @code{\layout}.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  c4 d^\markup {
+    \score {
+      \relative { c4 d e f }
+      \layout { }
+    }
+  }
+  e f
+}
+@end lilypond
+
+@node Page wrapping text
+@unnumberedsubsubsec Page wrapping text
+Alors que @code{\markup} s'utilise pour traiter un bloc de texte
+insécable, @code{\markuplines} permet, employé en tête de partition,
+d'obtenir un bloc de lignes réparties différemment et au cas où sur
+plusieurs pages.
+
+@verbatim
+\markuplines {
+  \justified-lines {
+    Un long texte constitué de lignes justifiées.
+    ...
+  }
+  \justified-lines {
+    Un autre grand paragraphe justifié.
+    ...
+  }
+  ...
+}
+@end verbatim
+
+@code{\markuplines} prend en argument une liste de lignes de texte,
+qui peut elle-même consister en une suite de commandes générant à leur
+tour des lignes de texte, comme ici :
+
+@verbatim
+\markuplines {
+  \line { ... }    % une ligne alignée à gauche
+  \fill-line { \line { ... } } % une ligne centrée
+  \wordwrap-lines { ... } % une liste de lignes alignées à gauche
+  \justified-lines { ... } % une liste de lignes justifiées
+}
+@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}.
+
+@seealso
+
+Dans ce manuel : @ref{Overview of text markup list commands}, 
+@ref{New markup list command definition}.
+
+@refcommands
+
+@funindex \markuplines
+@code{\markuplines}
+
+
+@node Font selection
+@unnumberedsubsubsec Font selection
+
+@cindex sélection de polices
+@cindex grossissement des polices
+@funindex font-interface
+
+C'est en jouant sur les propriétés des objets décrites ci-après que
+vous pourrez sélectionner une police parmi les familles de fontes
+préconfigurées.  LilyPond utilise par défaut la police musicale feta.
+Pour le texte, les polices sont sélectionnées par Pango/Fontconfig.
+C'est New Century Schoolbook qui sert de police sérif par défaut, et
+celles définies lors de l'installation de Pango pour ce qui est du
+sans-serif et du @q{typewriter}.
+
+
+@itemize @bullet
+@item @code{font-encoding}
+symbolise le tracé des glyphes. N'utilisez cette propriété que pour
+traiter des éléments non textuels, comme :
+
+
+@code{fetaBraces} pour les accolades de partition pianistique,
+@code{fetaMusic} pour de la musique (y compris musique ancienne),
+@code{fetaDynamic} pour les nuances et @code{fetaNumber} pour les
+chiffres. 
+
+@item @code{font-family}
+symbolise les différentes familles de police : @code{roman} (Computer
+Modern), @code{sans}-serif et @code{typewriter} (espacement fixe).
+
+@item @code{font-shape}
+symbolise le style des caractères. En pratique, chaque famille de
+police dispose de @code{italic}, @code{caps} (petites capitales) ou
+@code{upright} (droit).
+
+@item @code{font-series}
+symbolise le niveau de gras des caractères. Chaque style dispose, pour
+chaque famille, de @code{medium} et @code{bold} (gras).
+
+@end itemize
+
+Les variantes ci-dessus mentionnées font référence à une feuille de
+style prédéfinie.  Vous pouvez cependant faire appel à une autre
+police, en utilisant la propriété @code{font-name} :
+
+@lilypond[fragment,verbatim]
+{
+  \override Staff.TimeSignature #'font-name = #"Charter"
+  \override Staff.TimeSignature #'font-size = #2
+  \time 3/4
+  c'1_\markup {
+    \override #'(font-name . "Vera Bold")
+      { This text is in Vera Bold }
+  }
+}
+@end lilypond
+
+@noindent
+Vous pouvez utiliser n'importe quelle police, du moment qu'elle est
+accessible par Pango/Fontconfig.  Pour obtenir la liste de toutes
+les polices disponibles sur votre machine, lancez
+@example
+lilypond -dshow-available-fonts blabla
+@end example
+(quel qu'il soit, le dernier argument est obligatoire).
+
+
+La propriété @code{font-size} permet de régler la taille de la police.
+La taille effective que vous obtiendrez dépend de
+@code{text-font-size} tel que défini dans le bloc @code{\paper}.
+
+@cindex taille de police
+@cindex police, augmenter la taille
+
+
+Vous pouvez aussi changer la police par défaut au niveau du document.
+Il suffit alors de faire appel à @code{make-pango-font-tree} au sein
+du bloc @code{paper}.  Vous définirez alors la police à utiliser pour
+du texte respectivement en roman, sans serif et monospace, comme ici : 
+
+@cindex polices, définir 
+@cindex Pango
+
+
+@lilypond[verbatim]
+\paper  {
+  myStaffSize = #20
+
+  #(define fonts
+    (make-pango-font-tree "Times New Roman"
+                          "Nimbus Sans"
+                          "Luxi Mono"
+                           (/ myStaffSize 20)))
+}
+
+{
+  c'^\markup { roman: foo \sans bla \typewriter bar }
+}
+@end lilypond
+
+@c we don't do Helvetica / Courier, since GS incorrectly loads
+@c Apple TTF fonts
+
+
+
+@seealso
+
+Exemples : @lsr{text,font@/-family@/-override.ly}.
+
+
diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely
index 1748a44b78..a10ba2edc3 100644
--- a/Documentation/fr/user/tutorial.itely
+++ b/Documentation/fr/user/tutorial.itely
@@ -60,7 +60,7 @@ Essayez sur cette image :
 En copiant et en collant tout le code de l'extrait ly dans un fichier
 test, vous aurez un modèle de base pour faire vos expériences.  Si vous
 apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
-garder un lien vers l'@ref{Cheat sheet}, tableau qui répertorie les
+garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
 commandes usuelles pour une consultation rapide.
 @end ifhtml
 
@@ -396,17 +396,17 @@ Voici un bref exemple qui montre tous ces éléments ensemble :
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Entrer des hauteurs et des durées
-voir @ref{Pitches} and @ref{Durations}.
+voir @ruser{Pitches} and @ruser{Durations}.
 @item Les silences
-voir @ref{Rests}.
+voir @ruser{Rests}.
 @item Les chiffres de mesure et autres commandes de métrique
-voir @ref{Time signature}.
+voir @ruser{Time signature}.
 @item Les clés
-voir @ref{Clef}.
+voir @ruser{Clef}.
 @end table
 @end quotation
 
@@ -497,13 +497,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
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
 
 
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-Comme nous l'avons vu dans @ref{Working on text files}, un code
+Comme nous l'avons vu dans @ruser{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.
@@ -548,9 +548,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 @ref{Simple notation}, LilyPond calcule la
+Comme nous l'avons vu dans @ruser{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 @ref{Absolute note
+un autre mode de saisie des hauteurs, le mode @ruser{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
@@ -567,13 +567,13 @@ c2 fis
 c2 ges
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Les hauteurs de note relatives
-voir @ref{Relative octaves}.
+voir @ruser{Relative octaves}.
 @item Les vérifications d'octaves
-voir @ref{Octave check}.
+voir @ruser{Octave check}.
 @end table
 @end quotation
 
@@ -600,7 +600,7 @@ bémol.  Le double dièse et le double bémol s'obtiennent en ajoutant
 respectivement @samp{dd} et @samp{bb}
 @c END DIV
 
-Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
 names in other languages}.
 
 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
@@ -672,17 +672,17 @@ d'effort dans la phase de saisie, mais la transposition en sera
 grandement facilitée.
 De plus les altérations accidentelles
 peuvent être imprimées suivant plusieurs conventions.  Regardez
-@ref{Automatic accidentals} pour connaître les différentes manières dont les
+@ruser{Automatic accidentals} pour connaître les différentes manières dont les
 altérations accidentelles peuvent être imprimées, suivant les règles
 que vous choisirez.
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Les altérations
-voir @ref{Accidentals} and @ref{Automatic accidentals}.
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
 @item Les armures
-voir @ref{Key signature}.
+voir @ruser{Key signature}.
 @end table
 @end quotation
 
@@ -741,12 +741,12 @@ liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé.
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
-@item @ref{Ties},
-@item @ref{Slurs},
-@item @ref{Phrasing slurs}.
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
 @end table
 @end quotation
 
@@ -809,12 +809,12 @@ Crescendos et decrescendos débutent avec les commandes @code{\<} et
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
-@item @ref{Articulations}.
-@item @ref{Fingering instructions}.
-@item @ref{Dynamics}.
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
 @end table
 @end quotation
 
@@ -838,13 +838,13 @@ première note à attacher d'un @samp{[} et la dernière d'un @samp{]}.
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Groupements de notes et ligatures automatiques
-voir @ref{Automatic beams}.
+voir @ruser{Automatic beams}.
 @item Groupements et ligatures manuels
-voir @ref{Manual beams}.
+voir @ruser{Manual beams}.
 @end table
 @end quotation
 
@@ -897,15 +897,15 @@ c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Notes d'ornement
-voir @ref{Grace notes},
+voir @ruser{Grace notes},
 @item nolets
-voir @ref{Tuplets},
+voir @ruser{Tuplets},
 @item levées
-voir @ref{Partial measures}.
+voir @ruser{Partial measures}.
 @end table
 @end quotation
 
@@ -1037,7 +1037,7 @@ polyphoniques.
 @node Multiple staves
 @subsection Multiple staves
 
-Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier
+Comme nous l'avons vu dans @ruser{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
@@ -1079,7 +1079,7 @@ grosse expression.
 
 Les chiffres de métrique indiqués sur une portée affectent toutes les
 autres portées@footnote{Ce comportement peut être modifié si nécessaire,
-voir @ref{Polymetric notation}.}.  En revanche l'armure d'une portée
+voir @ruser{Polymetric notation}.}.  En revanche l'armure d'une portée
 n'affecte @emph{pas} les autres portées.
 
 @lilypond[quote,ragged-right,verbatim]
@@ -1101,7 +1101,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 @ref{Multiple staves}, mais maintenant cette expression
+polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
 entière doit être interprétée dans un contexte @code{PianoStaff} :
 
 @example
@@ -1122,9 +1122,9 @@ Voici un bref exemple :
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Voir @ref{Piano music}.
+Voir @ruser{Piano music}.
 @end quotation
 
 
@@ -1205,9 +1205,9 @@ Là encore, ces expressions peuvent s'imbriquer arbitrairement :
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-Voir @ref{Basic polyphony}.
+Voir @ruser{Basic polyphony}.
 @end quotation
 
 
@@ -1282,10 +1282,10 @@ entre les deux syllabes :
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
-en dessous d'une même mélodie sont exposées dans @ref{Vocal music}.
+en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
 @end quotation
 
 
@@ -1341,10 +1341,10 @@ partition de chanson :
 @end lilypond
 
 
-@moreinfo
+@seealso
 @quotation
 Une liste complète de modificateurs et d'autres options de mise en forme
-se trouve à la section @ref{Chords}.
+se trouve à la section @ruser{Chords}.
 @end quotation
 
 
@@ -1408,7 +1408,7 @@ bloc @code{\header} est habituellement placé en début de fichier.
 @end example
 Quand le fichier est traité, le titre et le compositeur sont imprimés en
 haut de la partition.  Vous trouverez plus d'informations sur les titres
-à @ref{Creating titles}.
+à @ruser{Creating titles}.
 
 @node Absolute note names
 @subsection Absolute note names
@@ -1554,12 +1554,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 @ref{Templates} types et
+morceau ou deux.  Commencez par copier l'un des @ruser{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 @ref{Basic notation}.  Si vous désirez écrire pour
-un ensemble instrumental non couvert par les @ref{Templates}, lisez la
-section @ref{Extending the templates}.
+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}.
 
 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 à
@@ -1571,7 +1571,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 @ref{How to read the tutorial}, de
+Comme nous l'avons déjà vu dans @ruser{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é.
 
@@ -1591,4 +1591,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 à @ruser{About this manual}.
diff --git a/Documentation/fr/user/tweaks.itely b/Documentation/fr/user/tweaks.itely
index fb9361152b..38c9f4d527 100644
--- a/Documentation/fr/user/tweaks.itely
+++ b/Documentation/fr/user/tweaks.itely
@@ -146,7 +146,7 @@ et n'attendra @strong{pas} le prochain texte.  Pour que ce comportement
 persiste après la commande, ne mettez pas @code{\once}.  Votre réglage
 s'appliquera alors partout, jusqu'à ce que vous l'annuliez au moyen de
 la commande @code{\revert}.  Ceci est expliqué en détail dans 
-@ref{The \override command}.
+@ruser{The \override command}.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
@@ -168,20 +168,20 @@ c4^"piu mosso" d e f
 
 @seealso
 
-Dans ce même manuel : @ref{The \override command}, @ref{Common tweaks}.
+Dans ce même manuel : @ruser{The \override command}, @ruser{Common tweaks}.
 
 
 @node Fixing overlapping notation
 @section Fixing overlapping notation
 
-Dans la section @ref{Moving objects}, nous avons vu comment
+Dans la section @ruser{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.
 
 Pour trouver cette dénomination, regardez les liens @q{@strong{Voir aussi}}
 en bas des pages de la documentation.  Par exemple, en bas de la page
-@ref{Dynamics}, nous trouvons 
+@ruser{Dynamics}, nous trouvons 
 
 @quotation
 @seealso
@@ -260,7 +260,7 @@ Notez, dans le second exemple, l'importance de savoir à quel contexte
 correspond l'objet.  Dans la mesure où l'objet @code{MetronomeMark}
 appartient au contexte @code{Score}, ses modifications affectées au
 contexte @code{Voice} ne l'affecteront pas.  Pour plus de détails, voir 
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
 
 @cindex extra-offset
 
@@ -399,7 +399,7 @@ Si vous vous intéressez aux problèmes de mise en page,
 @code{annotate-spacing} peut alors être un outil d'une valeur
 inestimable.  Cette commande imprime les valeurs 
 de nombreuses commandes d'espacement concernant la mise en page.  
-Consultez @ref{Displaying spacing} pour de plus amples informations.  À l'aide 
+Consultez @ruser{Displaying spacing} pour de plus amples informations.  À l'aide 
 des informations données par @code{annotate-spacing}, on peut 
 voir quelles marges il est souhaitable de modifier afin de résoudre le
 problème.
@@ -455,7 +455,7 @@ Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
 
 @item
 Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
-@ref{Changing horizontal spacing} pour plus de détails.
+@ruser{Changing horizontal spacing} pour plus de détails.
 
 @lilypond[verbatim,quote]
 \score {
@@ -486,7 +486,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 
-@ref{Scheme tutorial}  et les @ref{Interfaces for programmers}.
+@ruser{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
new file mode 100644
index 0000000000..37041fd0e3
--- /dev/null
+++ b/Documentation/fr/user/vocal.itely
@@ -0,0 +1,1082 @@
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+@c This file is part of lilypond.tely
+@ignore
+    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Vocal music
+@section Vocal music
+
+Dans la mesure où les fichiers LilyPond sont constitués de texte,
+traiter de la musique vocale demande de prendre en compte deux spécificités :
+
+@itemize @bullet
+@item
+Les paroles sont saisies comme étant du texte, non des notes.
+Ainsi, le code@tie{}@code{d} sera interprété comme une syllabe, et non
+comme la note@tie{}ré (D pour les non latinistes).
+
+@item
+Les paroles doivent s'aligner avec les notes de la mélodie correspondante.
+@end itemize
+
+Plusieurs solutions existent pour ajouter des paroles ; nous les
+examinerons par degré croissant de complexité.
+
+@menu 
+* TODO subsection vocal music::
+@end menu
+
+@commonprop
+
+S'assurer que tous les éléments textuels et les paroles respectent
+les marges du document requiert des calculs relativement lourds ; c'est
+la raison pour laquelle LilyPond, par défaut, ne s'en préoccupe pas.
+Vous pouvez cependant l'y forcer en ajoutant le code
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+Pour que les paroles évitent également les barres de mesure, ajoutez
+@example
+\layout @{
+  \context @{
+    \Lyrics
+      \consists "Bar_engraver"
+      \consists "Separating_line_group_engraver"
+      \override BarLine #'transparent = ##t
+  @}
+@}
+@end example
+
+
+@node TODO subsection vocal music
+@subsection TODO subsection vocal music
+
+@menu 
+* Setting simple songs::
+* Entering lyrics::
+* Aligning lyrics to a melody::
+* Automatic syllable durations::
+* Another way of entering lyrics::
+* Assigning more than one syllable to a single note::
+* More than one note on a single syllable::
+* Extenders and hyphens::
+* Working with lyrics and identifiers::
+* Flexibility in placement::
+* Lyrics to multiple notes of a melisma::
+* Divisi lyrics::
+* Switching the melody associated with a lyrics line::
+* Lyrics independent of notes::
+* Spacing lyrics::
+* More about stanzas::
+* Other vocal issues::
+@end menu
+
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+Le plus simple pour ajouter des paroles à une mélodie est d'adjoindre 
+
+@example
+\addlyrics @{ @var{les paroles} @}
+@end example
+
+@noindent
+à la mélodie.  En voici un exemple :
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+On peut ajouter davantage de couplets en multipliant le nombre de
+sections @code{\addlyrics}.
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+Cependant, la commande @code{\addlyrics} ne peut gérer les
+constructions polyphoniques.  Dans ce cas, mieux vaut employer
+@code{\lyricsto} et @code{\lyricmode}, comme nous le verrons dans
+@ref{Entering lyrics}. 
+
+
+
+@node Entering lyrics
+@unnumberedsubsubsec Entering lyrics
+
+@cindex paroles
+@funindex \lyricmode
+@cindex ponctuation
+@cindex espaces, dans les paroles
+@cindex guillemets, dans les paroles
+
+Il existe un mode de saisie spécialement adapté aux paroles.  On
+l'introduit avec le mot-clé @code{\lyricmode}, ou en utilisant 
+@code{\addlyrics} ou @code{\lyricsto}.  Ce mode vous permet de saisir
+des paroles, ainsi que leur ponctuation, et le caractère @code{d} ne
+sera plus interprété comme une note, mais comme une syllabe.  Les
+syllabes sont saisies comme des notes, mais les hauteurs sont alors
+remplacées par du texte.  Exemple avec une comptine anglaise :
+
+@example
+\lyricmode @{ Twin-4 kle4 twin- kle litt- le star2 @}
+@end example
+
+Ici on a choisi de saisir explicitement la durée de chaque syllabe. Cependant,
+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}.
+
+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
+chiffre).  Toute syllabe doit donc être séparée d'une autre par un
+espace, tout autre caractère étant considéré comme partie intégrante
+de cette même syllabe.  L'exemple suivant comporte une faute de frappe
+évidente :
+
+@example
+\lyricmode @{ lah- lah@}
+@end example
+
+la dernière syllabe contient une @code{@}}, il y a de fait un défaut de
+parité avec l'accolade ouvrante, et la compilation échouera fort
+probablement. 
+
+
+@funindex \property dans \lyricmode
+
+@noindent
+De la même manière, un point concluant une suite de lettres sera
+partie intégrante de la chaîne résultante. Par conséquent, il est
+impératif d'insérer des espaces lorsque vous modifiez les propriétés
+d'une commande.  En d'autres termes, ne saisissez pas
+
+@example
+\override Score.LyricText #'font-shape = #'italic
+@end example
+
+@noindent
+mais plutôt
+
+@example
+\override Score . LyricText #'font-shape = #'italic
+@end example
+
+@funindex _
+@cindex espaces, dans les paroles
+@cindex guillemets, dans les paroles
+@cindex liaisons, dans les paroles
+
+Pour attribuer plus d'une syllabe à une même note, vous pouvez mettre
+ces syllabes entre guillemets, ou bien remplacer l'espace par un
+caractère souligné (@code{_}), ou encore utiliser un tilde (@code{~})
+pour obtenir une liaison entre les syllabes.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+Cette liaison adaptée aux paroles correspond au caractère Unicode
+U+203F, et n'apparaîtra dans la partition que s'il existe une police
+incluant ce symbole (par exemple DejaVuLGC) installée sur le système.
+
+
+Pour utiliser des lettres accentuées ou des caractères spéciaux 
+--- cœurs ou guillemets inversés par exemple --- il suffit de les insérer
+dans le fichier et de veiller à sauvegarder ce dernier avec le codage
+utf-8.  Voir à ce sujet @ref{Text encoding} pour plus de détails.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative { e4 f e d e f e2 }
+\addlyrics { He said: “Let my peo ple go”. }
+@end lilypond
+
+Pour utiliser des guillemets informatiques standard, faites-les
+précéder d'une barre oblique inverse :
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
+\addlyrics { "\"I" am so lone- "ly\"" said she }
+@end lilypond
+
+Expliquer exactement comment LilyPond repère le début d'un mot en mode
+paroles (Lyrics) est quelque peu compliqué.
+
+En mode Lyrics, un mot peut commencer par : tout caractère alphabétique,
+@code{_}, @code{?}, @code{!}, @code{:}, @code{'}, un des codes de
+contrôle @code{^A} à @code{^F} et @code{^Q} à @code{^W}, @code{^Y},
+@code{^^}, tout caractère ASCII de code strictement supérieur à 127, ou
+enfin un des symboles @code{`}, @code{'}, @code{"}, ou @code{^}, s'il
+est précédé d'une barre oblique inverse.
+
+Pour définir un identificateur contenant des paroles, il faut utiliser
+la fonction @code{lyricmode}.
+
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+  <<
+    \new Voice = "one" \relative c'' @{
+      \autoBeamOff
+      \time 2/4
+      c4 b8. a16 g4. f8 e4 d c2
+    @}
+    \addlyrics @{ \verseOne @}
+  >>
+@}
+@end example
+
+
+@seealso
+
+Référence du programme : @internalsref{LyricText}, @internalsref{LyricSpace}.
+
+
+
+@node Aligning lyrics to a melody
+@unnumberedsubsubsec Aligning lyrics to a melody
+
+@funindex \lyricmode
+@funindex \addlyrics
+@funindex \lyricsto
+
+
+Avant d'être imprimées, les paroles sont interprétées par le programme
+dans le contexte @internalsref{Lyrics}.
+
+@example
+\new Lyrics \lyricmode @dots{}
+@end example
+
+Il y a deux grandes méthodes pour gérer le placement horizontal des
+syllabes :
+
+@itemize @bullet
+@item
+en alignant automatiquement les paroles sur une mélodie ou une autre
+voix, en ayant recours à @code{\addlyrics} ou @code{\lyricsto} ;
+
+@item
+en affectant explicitement à chaque syllabe une durée, au sein du
+contexte @code{\lyricmode}
+@end itemize
+
+@menu
+* Automatic syllable durations::  
+* Another way of entering lyrics::  
+* Assigning more than one syllable to a single note::  
+* More than one note on a single syllable::  
+* Extenders and hyphens::       
+@end menu
+
+@node Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
+
+@cindex durée automatique des syllabes
+@cindex paroles et mélodies
+
+Les paroles peuvent être automatiquement alignées sous
+une mélodie.  Il suffit pour cela de combiner la mélodie et les
+paroles avec la commande @code{\lyricsto}.
+
+@example
+\new Lyrics \lyricsto @var{nom} @dots{}
+@end example
+
+Cette commande adapte les paroles aux notes de la voix (contexte
+@internalsref{Voice} dans le jargon LilyPond) @var{nom}.  Ce contexte
+@code{Voice} doit exister avant l'indication des paroles avec
+@code{\lyricsto}.  La commande @code{\lyricsto} introduit
+automatiquement le mode @code{\lyricmode}, donc dans ce cas vous n'avez
+pas à ajouter vous-même @code{\lyricmode}.
+
+L'exemple suivant récapitule les différentes manières de saisir des paroles.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+<<
+  \new Voice = "one" \relative c'' {
+    \autoBeamOff
+    \time 2/4
+    c4 b8. a16 g4. f8 e4 d c2
+  }
+  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
+  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
+  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
+>>
+@end lilypond
+
+Le deuxième couplet n'est pas correctement disposé, aucune durée
+n'ayant été spécifiée. Dans un tel cas, il aurait mieux valu utiliser
+@code{\lyricsto}, comme dans le troisième couplet.
+
+La commande @code{\addlyrics} n'est en fait qu'une simplification de
+la structure employée par LilyPond pour définir les paroles.
+
+@example
+@{ MUSIQUE @}
+\addlyrics @{ PAROLES @}
+@end example
+
+@noindent
+est exactement la même chose que
+
+@example
+\new Voice = "blah" @{ musique @}
+\new Lyrics \lyricsto "blah" @{ PAROLES @}
+@end example
+
+@node Another way of entering lyrics
+@unnumberedsubsubsec Another way of entering lyrics
+
+On peut aussi se passer de @code{\addlyrics} et de @code{\lyricsto} pour
+saisir des paroles.  Dans ce cas, les syllabes sont entrées comme des
+notes --- du texte remplaçant les hauteurs --- ce qui veut dire que vous
+devez définir leur durée explicitement :
+ 
+@example
+play2 the4 game2.
+sink2 or4 swim2.
+@end example
+ 
+La mélodie associée à ces paroles peut être spécifiée par la propriété
+@code{associatedVoice} :
+ 
+@example
+\set associatedVoice = #"lala"
+@end example
+ 
+@noindent
+La valeur que vous attribuez à cette propriété (ici @code{"lala"})
+doit désigner un contexte @internalsref{Voice}, sans quoi les mélismes
+ne seront pas imprimés correctement.
+ 
+Voici un exemple de cette manière de procéder :
+ 
+@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
+<< \new Voice = "melody" {
+    \time 3/4
+    c2 e4 g2.
+ }
+ \new Lyrics \lyricmode {
+   \set associatedVoice = #"melody"
+   play2 the4 game2.
+ } >>
+@end lilypond
+
+@seealso
+ 
+Référence du programme : @internalsref{Lyrics}.
+
+
+@node Assigning more than one syllable to a single note
+@unnumberedsubsubsec Assigning more than one syllable to a single note
+
+
+@funindex _
+@cindex liaisons, dans les paroles
+
+Pour attribuer plus d'une syllabe à une même note, vous pouvez les
+mettre entre guillemets, remplacer une espace par un caractère souligné
+(@code{_}) pour obtenir une espace, ou bien encore utiliser un tilde
+(@code{~}) pour obtenir une liaison entre les syllabes@footnote{Une
+liaison adaptée aux paroles correspond au caractère Unicode U+203F, et
+n'apparaîtra dans la partition que si le système dispose d'une police
+installée qui contient ce symbole(par exemple DejaVuLGC).}.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+@seealso
+
+Référence du programme : @internalsref{LyricCombineMusic}.
+
+@c Here come the section which used to be "Melismata"
+@c the new title might be more self-explanatory
+
+
+@node More than one note on a single syllable
+@unnumberedsubsubsec More than one note on a single syllable
+
+@cindex mélisme
+@cindex vocalise
+@c better here
+@cindex phrasé, pour des paroles
+
+
+Parfois, tout particulièrement dans la musique médiévale, plusieurs
+notes correspondent à une même syllabe. Ces vocalises sont appelées mélismes.
+
+@c this method seems to be the simplest; therefore
+@c it might be better to present it first - vv
+
+Il est possible d'indiquer tous les mélismes lors de la saisie des
+paroles. Il suffit pour cela d'utiliser le caractère @code{_} pour
+chaque note du mélisme.
+
+@lilypond[relative=1,verbatim,fragment,quote]
+{ \set melismaBusyProperties = #'()
+ c d( e) f f( e) e e  }
+\addlyrics
+ { Ky -- _ _ ri __ _ _ _  e }
+@end lilypond
+
+En définissant, comme dans l'exemple ci-dessus, la propriété
+@code{melismaBusyProperties}, vous obtiendrez automatiquement toutes
+les liaisons de tenue et de phrasé requises.
+
+D'autre part, la commande @code{\lyricsto} arrive aussi à détecter
+automatiquement les mélismes : une seule syllabe sera placée sous un
+groupe de notes comprenant des liaisons de tenue ou de phrasé.  Au cas
+où un mélisme doit s'appliquer à des notes non liées, il suffit
+d'adjoindre @code{\melisma} à la première note du groupe, et 
+@code{\melismaEnd} à la dernière :
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+<<
+  \new Voice = "lala" {
+    \time 3/4
+    f4 g8
+    \melisma
+    f e f
+    \melismaEnd
+    e2
+  }
+  \new Lyrics \lyricsto "lala" {
+    la di __ daah
+  }
+>>
+@end lilypond
+
+Enfin, lorsque la fonction de ligature automatique (cf.
+@ref{Setting automatic beam behavior}) est désactivée, le fait de les
+connecter manuellement créera un mélisme.
+
+@c TODO: there might be some more relevant place for 
+@c the following link (?)
+
+@cindex SATB
+@cindex choral score
+
+Vous trouverez un exemple complet de partition pour chœur dans la
+section @ref{Vocal ensembles}.
+
+
+@refcommands
+
+@code{\melisma}, @code{\melismaEnd}
+@funindex \melismaEnd
+@funindex \melisma
+
+@seealso
+
+Référence du programme : @internalsref{Melisma_translator}.
+
+@lsr{vocal,lyric@/-combine.ly}.
+
+@refbugs
+
+Certains mélismes ne sont pas détectés automatiquement ; vous devrez
+alors prolonger vous-même les syllabes concernées.
+
+@node Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens
+
+@cindex mélisme
+@cindex extenseur
+@cindex prolongateur
+
+Un mélisme est indiqué par une ligne horizontale basse centrée
+entre une syllabe et la suivante.  Une telle ligne, que nous
+appellerons prolongateur ou extenseur, s'obtient en saisissant 
+@samp{ __ } (notez les espaces entourant le souligné double).
+
+@cindex trait d'union
+
+Un trait d'union séparant deux syllabes d'un même mot s'obtient en
+saisissant @samp{ -- } (notez les espaces entourant le tiret double).
+Ce trait d'union sera centré entre les deux syllabes et sa longueur
+sera proportionnelle à l'espace les séparant.
+
+Dans les partitions très serrées, les traits d'union peuvent ne pas être
+imprimés.  Cet inconvénient peut être contrôlé par
+@code{minimum-distance} pour gérer l'espace minimum entre deux syllabes,
+et @code{minimum-length}, seuil en deçà duquel il n'y a pas de trait
+d'union.
+
+@seealso
+
+Référence du programme : @internalsref{LyricExtender},
+@internalsref{LyricHyphen}
+
+
+@node Working with lyrics and identifiers
+@unnumberedsubsubsec Working with lyrics and identifiers
+@cindex paroles, identificateurs
+
+La fonction @code{\lyricmode} permet de définir un identificateur pour
+les paroles.  Point n'est besoin de spécifier les durées si vous
+utilisez @code{\addlyrics} ou @code{\lyricsto} lorsque vous y faites référence.
+ 
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+ <<
+   \new Voice = "one" \relative c'' @{
+     \autoBeamOff
+     \time 2/4
+     c4 b8. a16 g4. f8 e4 d c2
+   @}
+   \addlyrics @{ \verseOne @}
+ >>
+@}
+@end example
+ 
+Pour une organisation différente ou plus complexe, mieux vaut
+commencer par définir la hiérarchie des portées et des paroles,
+@example
+\new ChoirStaff <<
+  \new Voice = "soprano" @{ @emph{musique} @}
+  \new Lyrics = "sopranoParoles" @{ s1 @}
+  \new Lyrics = "tenorParoles" @{ s1 @}
+  \new Voice = "tenor" @{ @emph{musique} @}
+>>
+@end example
+ 
+puis combiner correctement les mélodies et les paroles :
+ 
+@example
+\context Lyrics = sopranoParoles \lyricsto "soprano"
+@emph{les paroles}
+@end example
+ 
+@noindent
+
+Le résultat donnera ainsi quelque chose comme
+ 
+@example
+<<\new ChoirStaff << @emph{définition de la musique} >>
+ \lyricsto "soprano" @emph{etc}
+ \lyricsto "alto" @emph{etc}
+@emph{etc}
+>>
+@end example
+ 
+@seealso
+ 
+@c TODO: document \new Staff << Voice \lyricsto >> bug
+
+Référence du programme : @internalsref{LyricCombineMusic},
+@internalsref{Lyrics}.  
+
+
+@node Flexibility in placement
+@unnumberedsubsubsec Flexibility in placement
+
+Une même mélodie peut se voir traitée différemment suivant les couplets.
+La commande @code{\lyricsto} permet de prendre en compte ces variantes.
+
+@menu
+* Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Lyrics independent of notes::  
+@end menu
+
+
+@node Lyrics to multiple notes of a melisma
+@unnumberedsubsubsec Lyrics to multiple notes of a melisma
+
+Il peut survenir que les paroles comportent un mélisme pour l'un des
+couplets, mais plusieurs syllabes pour d'autres. Une solution consiste à
+temporairement ignorer les mélismes dans le couplet ayant plus de
+syllabes.  Il suffit pour cela de définir la propriété
+@code{ignoreMelismata} à l'intérieur du contexte Lyrics.
+
+Petit détail qui a son importance : la définition de
+@code{ignoreMelismata} doit intervenir une syllabe @emph{avant} les
+syllabes auxquelles elle s'appliquera :
+
+@c  FIXME: breaks compile
+@lilypond[verbatim,ragged-right,quote]
+%{
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    \slurDotted
+    f8.[( g16])
+    a4
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    more slow -- ly
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    \set ignoreMelismata = ##t % applies to "fas"
+    go fas -- ter
+    \unset ignoreMelismata
+    still
+  }
+>>
+%}
+@end lilypond
+
+
+Ici la fonction @code{ignoreMelismata} concerne la syllabe @q{fas},
+bien qu'elle ait été définie avant la syllabe @q{go}.
+
+L'inverse est aussi possible : prendre une mélodie syllabique pour en
+faire un mélisme.  Il faudra alors insérer des sauts invisibles
+@code{\skip} dans vos paroles. Chaque @code{\skip} décale le texte
+suivant d'une note :
+
+@lilypond[verbatim,ragged-right,quote]
+\relative { c c g' }
+\addlyrics {
+  twin -- \skip 4
+  kle
+}
+@end lilypond
+
+
+@node Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
+
+En donnant un nom à chaque voix et en leur attribuant spécifiquement
+des paroles, on peut créer des paroles alternatives --- également
+qualifiées de @q{divisi}.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" {
+    \relative c' {
+      c4
+      <<
+        { \voiceOne c8 e }
+        \new Voice = "splitpart" { \voiceTwo c4 }
+      >>
+      \oneVoice c4 c | c
+    }
+  }
+  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
+  \new Lyrics \lyricsto "splitpart" { will }
+>> }
+@end lilypond
+
+
+Cette astuce permet de faire varier les paroles lorsqu'une section est reprise.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" \relative c' {
+    c2 e | g e | c1 |
+    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
+    a2 b | c1}
+  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
+    do mi sol mi do
+    la si do }
+  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
+   do re mi fa sol }
+  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
+   dodo rere mimi fafa solsol }
+>>
+}
+@end lilypond
+
+
+
+@node Switching the melody associated with a lyrics line
+@unnumberedsubsubsec Switching the melody associated with a lyrics line
+
+On peut créer des variations plus complexes à partir d'une mélodie à
+plusieurs voix.  Les paroles peuvent suivre l'une ou l'autre des
+lignes mélodiques, et même basculer de l'une à l'autre si l'on
+modifie la propriété @code{associatedVoice}.  Dans cet exemple,
+
+@lilypond[ragged-right,quote]
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    <<
+      \new Voice = "alternative" {
+        \voiceOne
+        \times 2/3 {
+          % show associations clearly.
+          \override NoteColumn #'force-hshift = #-3
+          f8 f g
+        }
+      }
+      {
+        \voiceTwo
+        f8.[ g16]
+        \oneVoice
+      } >>
+    a8( b) c
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    Ju -- ras -- sic Park
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    % Tricky: need to set associatedVoice
+    % one syllable too soon!
+    \set associatedVoice = alternative % applies to "ran"
+    Ty --
+    ran --
+    no --
+    \set associatedVoice = lahlah % applies to "rus"
+    sau -- rus Rex
+  } >>
+@end lilypond
+
+@noindent
+le texte du premier couplet s'aligne sur la mélodie nommée
+@q{lahlah},
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  Ju -- ras -- sic Park
+@}
+@end example
+
+
+Le second couplet est tout d'abord rattaché au contexte @code{lahlah},
+mais bascule sur une autre mélodie sur la syllabe @q{ran}.  Pour cela,
+nous utilisons
+@example
+\set associatedVoice = alternative
+@end example
+
+@noindent
+où @code{alternative} désigne le nom du contexte @code{Voice} qui contient
+le triolet.
+
+Encore une fois, cette commande doit être spécifiée une syllabe en
+avance, c'est-à-dire ici avant la syllabe @q{Ty}.
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  \set associatedVoice = alternative % applies to "ran"
+  Ty --
+  ran --
+  no --
+  \set associatedVoice = lahlah % applies to "rus"
+  sau -- rus Rex
+@}
+@end example
+
+@noindent
+Comme vous pouvez le voir, nous revenons ensuite à l'alignement sur la
+mélodie d'origine, en assignant à la propriété @code{associatedVoice}
+la valeur @code{lahlah}.
+
+
+@node Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
+
+Dans certaines musiques vocales assez complexes, on peut avoir intérêt à
+imprimer les paroles indépendamment des notes.  La mélodie sur laquelle
+s'aligne les paroles --- marquée par le tag @code{lyricrhythm} dans
+l'exemple suivant --- peut être insérée dans un contexte @code{Devnull},
+ce qui indique à LilyPond de na pas imprimer cette mélodie dans la
+partition.  Seules subsistent alors de cette mélodie les valeurs
+rythmiques, sur lesquelles s'alignent les paroles.
+
+@lilypond[quote,verbatim,ragged-right]
+voice = {
+  c''2
+  \tag #'music { c''2 }
+  \tag #'lyricrhythm { c''4. c''8 }
+  d''1
+}
+
+lyr = \lyricmode { I like my cat! }
+
+<<
+  \new Staff \keepWithTag #'music \voice
+  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
+  \new Lyrics \lyricsto "nowhere" \lyr
+  \new Staff { c'8 c' c' c' c' c' c' c'
+  c' c' c' c' c' c' c' c' }
+>>
+@end lilypond
+
+
+@node Spacing lyrics
+@unnumberedsubsubsec Spacing lyrics
+
+@cindex espacer des paroles
+@cindex paroles, accroître l'espacement
+
+La propriété @code{#'minimum-distance} de l'objet LyricSpace permet
+d'accroître l'espacement des paroles.
+
+@lilypond[relative,verbatim,fragment,quote,ragged-right]
+{
+  c c c c
+  \override Lyrics.LyricSpace #'minimum-distance = #1.0
+  c c c c
+}
+\addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+}
+@end lilypond
+
+Pour que ce réglage s'applique à toute la partition, définissez-le
+dans le bloc @code{\layout}.
+
+@lilypond[relative,verbatim,quote,ragged-right]
+\score {
+  \relative c' {
+  c c c c
+  c c c c
+  }
+  \addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+  }
+  \layout {
+    \context {
+      \Lyrics
+      \override LyricSpace #'minimum-distance = #1.0
+    }
+  }
+}
+@end lilypond
+
+
+@node More about stanzas
+@unnumberedsubsubsec More about stanzas
+
+@cindex numéro de couplet
+@unnumberedsubsubsec Adding stanza numbers 
+
+On peut ajouter un numéro aux couplets en définissant la variable
+@code{stanza} :
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set stanza = "1. "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set stanza = "2. "
+  Oh, ché -- ri, je t'aime
+}
+@end lilypond
+
+@noindent
+Ces numéros se placeront juste avant le début de la première syllabe.
+
+@unnumberedsubsubsec Adding dynamics marks
+
+Lorsque des couplets ont des nuances différentes, vous pouvez ajouter
+une nuance devant chaque numéro.  L'objet @code{StanzaNumber} contient
+tout ce qui se place au début du couplet.  Pour des raisons techniques,
+vous devrez définir la variable @code{stanza} en dehors du mode
+@code{\lyricmode}.
+
+@lilypond[quote,ragged-right,verbatim]
+text = {
+  \set stanza = \markup { \dynamic "ff" "1. " }
+  \lyricmode {
+    Big bang
+  }
+}
+
+<<
+  \new Voice = "tune" {
+    \time 3/4
+    g'4 c'2
+  }
+\new Lyrics \lyricsto "tune" \text
+>>
+@end lilypond
+
+@cindex nom de personnage
+@cindex nom du chanteur
+@unnumberedsubsubsec Adding singer names
+
+On peut également ajouter le nom de chaque rôle ; ils s'imprimeront au
+début de chaque ligne comme les noms d'instruments.  Il faut pour cela
+définir @code{vocalName}, et @code{shortVocalName} pour une version
+abrégée.
+
+@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set vocalName = "Bert "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set vocalName = "Ernie "
+  Oh, che -- ri, je t'aime
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end 
+
+Il peut parfois s'avérer opportun d'aligner un seul couplet sur la
+mélodie, et de présenter tous les autres en bloc à la fin du morceau.
+Ces couplets additionnels peuvent être inclus dans une section
+@code{\markup} en dehors du bloc @code{\score} principal.
+Vous en trouverez un exemple ci-dessous ; notez également les deux
+méthodes différentes employées pour indiquer les sauts de ligne,
+entre les couplets (@q{verses} en anglais) 2 et 3.
+
+@c keeply?
+@lilypond[ragged-right,verbatim,quote]
+melody = \relative c' {
+e d c d | e e e e |
+d d e d | c1 |
+}
+
+text = \lyricmode {
+\set stanza = "1." Ma- ry had a lit- tle lamb,
+its fleece was white as snow.
+}
+
+\score{ <<
+  \new Voice = "one" { \melody }
+  \new Lyrics \lyricsto "one" \text
+>>
+  \layout { }
+}
+\markup { \column{
+  \line{ Verse 2. }
+  \line{ All the children laughed and played }
+  \line{ To see a lamb at school. }
+  }
+}
+\markup{
+  \wordwrap-string #"
+  Verse 3.
+
+  Mary took it home again,
+
+  It was against the rule."
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns 
+
+Si les couplets sont vraiment nombreux, il est possible de les imprimer
+sur plusieurs colonnes.  De plus, l'exemple suivant vous montrera
+comment faire en sorte que le numéro du couplet soit en retrait à
+gauche, comme c'est traditionnellement le cas.
+
+@c keeply?
+@lilypond[ragged-right,quote,verbatim]
+melody = \relative c' {
+  c c c c | d d d d
+}
+ 
+text = \lyricmode {
+  \set stanza = "1." This is verse one.
+  It has two lines.
+}
+
+\score{ <<
+    \new Voice = "one" { \melody }
+    \new Lyrics \lyricsto "one" \text
+   >>
+  \layout { }
+}
+
+\markup {
+  \fill-line {
+    \hspace #0.1 % moves the column off the left margin; can be removed if
+        % space on the page is tight
+     \column {
+      \line { \bold "2."
+        \column {
+          "This is verse two."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "3."
+        \column {
+          "This is verse three."
+          "It has two lines."
+        }
+      }
+    }
+    \hspace #0.1  % adds horizontal spacing between columns; if they are
+        % still too close, add more " " pairs until the result 
+        % looks good
+     \column {
+      \line { \bold "4."
+        \column {
+          "This is verse four."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "5."
+        \column {
+          "This is verse five."
+          "It has two lines."
+        }
+      }
+    }
+  \hspace #0.1 % gives some extra space on the right margin; can
+      % be removed if page space is tight
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Référence du programme : @internalsref{LyricText},
+@internalsref{StanzaNumber}, @internalsref{VocalName}.
+
+
+
+@node Other vocal issues
+@unnumberedsubsubsec Other vocal issues
+
+@ignore
+yeah, I'm giving up somewhat by stuffing a bunch of things in
+here.  But at least they're in the manual now; it's easier to
+move them around in the manual once they're already here.
+
+Besides, if users complain about everything stuffed in here, I
+can ask them for specific instructions about where to move these
+examples, and that might get them more involved in the docs.  -gp
+@end ignore
+
+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}.
+
diff --git a/Documentation/fr/user/working.itely b/Documentation/fr/user/working.itely
index dfc0f09f48..615bc3d63e 100644
--- a/Documentation/fr/user/working.itely
+++ b/Documentation/fr/user/working.itely
@@ -76,8 +76,8 @@ de se rappeler quelle version de LilyPond on utilisait quelques
 années auparavant.  L'utilitaire @code{convert-ly} demande que vous
 spécifiiez la version de LilyPond vous utilisiez alors.
 
-@item @strong{Ajoutez des contrôles}: @ref{Bar check}, @ref{Octave
-check} et @ref{Barnumber check}.  Si vous avez ajouté des contrôles de
+@item @strong{Ajoutez des contrôles}: @ruser{Bar check}, @ruser{Octave
+check} et @ruser{Barnumber check}.  Si vous avez ajouté des contrôles de
 loin en loin, et que vous faites une erreur, vous pourrez la retrouver
 plus rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?  Cela
 dépend de la complexité de la musique.  Pour de la musique très
@@ -104,8 +104,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 @ref{Saving typing with identifiers and functions} et
-@ref{Style sheets}.
+elle-même. Voyez @ruser{Saving typing with identifiers and functions} et
+@ruser{Style sheets}.
 
 @end itemize
 
@@ -122,7 +122,7 @@ c'est-à-dire de la musique déjà écrite,
 à la fois --- mais toujours une seule mesure par ligne de texte ---,
 et vérifiez chaque système lorsqu'il est terminé.  Vous pouvez
 utiliser la commande @code{showLastLength} pour accélérer la
-compilation --- voir @ref{Skipping corrected music} ;
+compilation --- voir @ruser{Skipping corrected music} ;
 
 @item définissez @code{mBreak = @{\break @}} et insérez
 @code{\mBreak} dans le fichier d'entrée pour obtenir des sauts de
@@ -164,7 +164,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Séparez les retouches} des définitions de
-musique.  Ce conseil a été vu dans @ref{General suggestions},
+musique.  Ce conseil a été vu dans @ruser{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
@@ -281,8 +281,8 @@ padText =
 
 Utiliser les identificateurs est aussi un bon moyen pour vous épargner
 du travail si la syntaxe de LilyPond change un jour --- voir
-@ref{Updating old files}.  Si vous avez une seule définition, par
-exemple @code{\dolce}, pour tous vos fichiers (voir @ref{Style
+@ruser{Updating old files}.  Si vous avez une seule définition, par
+exemple @code{\dolce}, pour tous vos fichiers (voir @ruser{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}.
@@ -292,14 +292,14 @@ chaque fichier @code{.ly}.
 @section Style sheets
 
 La sortie que produit LilyPond peut être largement modifiée --- voir
-@ref{Tweaking output} pour plus de détails.  Mais que faire si vous
+@ruser{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
-@ref{Advanced tweaks with Scheme}.
+@ruser{Advanced tweaks with Scheme}.
 
 @lilypond[quote,verbatim,ragged-right]
 mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@@ -320,7 +320,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 @ref{Moving objects}.  On peut
+cela en utilisant les techniques de @ruser{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.
@@ -632,10 +632,10 @@ problème.
 
 Une autre technique de déboguage très utile est la construction
 @iftex
-de @ref{Minimal examples}.
+de @ruser{Minimal examples}.
 @end iftex
 @ifnottex
-d'@ref{Minimal examples}.
+d'@ruser{Minimal examples}.
 @end ifnottex
 
 
diff --git a/Documentation/index.html.in b/Documentation/index.html.in
index 696c6a6590..315b676d46 100644
--- a/Documentation/index.html.in
+++ b/Documentation/index.html.in
@@ -48,10 +48,11 @@
           <td class="left-column">
 	  <ul>
 	    <li>
-	    <a class="title" href="user/lilypond/Tutorial.html">Tutorial</a>
+	    <a class="title"
+href="user/lilypond-learning/index.html">Learning manual</a>
 	      <br>(start here)
 
-	   <li><a class="title" href="user/music-glossary/index.html">Glossary</a>
+	   <li><a class="title" href="user/music-glossary/index.html">Music glossary</a>
 (in <a class="title" href="user/music-glossary-big-page.html">one big page</a> ~ 1 Mb,
 in <a class="title" href="user/music-glossary.pdf">PDF</a>)
 
@@ -75,7 +76,7 @@ in <a class="title" href="user/music-glossary.pdf">PDF</a>)
           &nbsp;
 	  <ul>
 	    <li>
-<a class="title" href="user/lilypond/index.html">User manual</a>
+<a class="title" href="user/lilypond/index.html">Notation reference</a>
 (in <a class="title" href="user/lilypond-big-page.html">one big page</a> ~ 4 Mb,
 in <a class="title" href="user/lilypond.pdf">PDF</a>)
      <br>(writing music in LilyPond)
diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 781197c124..fbf099e94e 100644
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -116,7 +116,6 @@ their end points.  This includes glissando, voice followers, text
 crescendos and other text spanners.  The old syntax for setting
 text on line spanners is no longer valid.
 
-
 @c  with ragged-right we can't see the gliss.
 @lilypond[]
 \relative c'' {
diff --git a/Documentation/user/GNUmakefile b/Documentation/user/GNUmakefile
index 77c2f3b410..1ba38e5e97 100644
--- a/Documentation/user/GNUmakefile
+++ b/Documentation/user/GNUmakefile
@@ -21,7 +21,7 @@ HTML_FILES = $(TELY_FILES:%.tely=$(outdir)/%-big-page.html)\
 # todo: add latex.
 PDF_FILES = $(TELY_FILES:%.tely=$(outdir)/%.pdf)
 
-INFO_DOCS = lilypond lilypond-internals music-glossary lilypond-program
+INFO_DOCS = lilypond lilypond-internals music-glossary lilypond-program lilypond-learning
 INFO_FILES = $(INFO_DOCS:%=$(outdir)/%.info)
 
 STEPMAKE_TEMPLATES=tex texinfo omf documentation
@@ -38,8 +38,6 @@ include $(depth)/make/stepmake.make
 
 info: $(INFO_FILES)
 
-pathsettings:
-	@echo export PATH=$(PATH)
 	@echo export LILYPOND_DATADIR=$(LILYPOND_DATADIR)
 	@echo export PYTHONPATH=$(PYTHONPATH)
 
@@ -75,6 +73,7 @@ else
 	-$(INSTALL) -d $(DESTDIR)$(package_infodir)
 	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond.info
 	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond-program.info
+	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond-learning.info
 	install-info --info-dir=$(infodir) $(outdir)/lilypond.info
 	(cd $(package_infodir) && ln -sf $(webdir)/Documentation/user/*png .)
 endif
@@ -109,6 +108,7 @@ else
 	-$(INSTALL) -d $(DESTDIR)$(package_infodir)
 	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond.info
 	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond-program.info
+	-install-info --remove --info-dir=$(infodir) $(outdir)/lilypond-learning.info
 	install-info --info-dir=$(infodir) $(outdir)/lilypond.info
 	@echo
 	@echo "***************************************************************"
@@ -150,6 +150,11 @@ $(outdir)/lilypond.nexi: $(outdir)/lilypond-internals.texi
 $(outdir)/lilypond/index.html: $(outdir)/lilypond.texi $(OUT_PNG_IMAGES) $(OUT_EPS_IMAGES)
 	mkdir -p $(dir $@)
 	$(MAKEINFO) -I$(outdir) --output=$(outdir)/lilypond --css-include=$(top-src-dir)/Documentation/texinfo.css --html $<
+# we /might/ switch to texi2html if it can be fixed:
+#	echo "*************************************"
+#	echo $<
+#	cd $(outdir)
+#	texi2html --output=$(outdir)/lilypond --css-include=$(top-src-dir)/Documentation/texinfo.css $<
 	find $(outdir)/lilypond/ -name '*'.png -o -name '*'.ly | xargs rm -f
 # symbolic links to save space
 	(cd $(outdir)/lilypond/ ; ln -sf ../*.png ../*.ly . )
@@ -170,12 +175,31 @@ $(outdir)/lilypond-program/index.html: $(outdir)/lilypond-program.texi $(OUT_PNG
 # symbolic links to save space
 	(cd $(outdir)/lilypond-program/ ; ln -sf ../*.png ../*.ly . )
 
+#
+# The Learning Manual
+#
+$(outdir)/lilypond-learning/index.html: $(outdir)/lilypond-learning.texi $(OUT_PNG_IMAGES) $(OUT_EPS_IMAGES)
+	mkdir -p $(dir $@)
+	$(MAKEINFO) -I$(outdir) --output=$(outdir)/lilypond-learning --css-include=$(top-src-dir)/Documentation/texinfo.css --html $<
+	find $(outdir)/lilypond-learning/ -name '*'.png -o -name '*'.ly | xargs rm -f
+# symbolic links to save space
+	(cd $(outdir)/lilypond-learning/ ; ln -sf ../*.png ../*.ly . )
+
+
 #
 # One big page program usage
 #
 $(outdir)/lilypond-program-big-page.html: $(outdir)/lilypond-program.texi $(OUT_PNG_IMAGES)
 	$(MAKEINFO) -I$(outdir) --output=$@ --css-include=$(top-src-dir)/Documentation/texinfo.css --html --no-split -D bigpage --no-headers $<
 
+#
+# One big page learning manual
+#
+$(outdir)/lilypond-learning-big-page.html: $(outdir)/lilypond-learning.texi $(OUT_PNG_IMAGES)
+	$(MAKEINFO) -I$(outdir) --output=$@ --css-include=$(top-src-dir)/Documentation/texinfo.css --html --no-split -D bigpage --no-headers $<
+
+
+
 
 #
 # The split internals reference
@@ -212,6 +236,8 @@ $(outdir)/lilypond.pdf: $(OUT_PDF_IMAGES) $(OUT_PNG_IMAGES)
 
 $(outdir)/lilypond-program.pdf: $(OUT_PDF_IMAGES) $(OUT_PNG_IMAGES)
 
+$(outdir)/lilypond-learning.pdf: $(OUT_PDF_IMAGES) $(OUT_PNG_IMAGES)
+
 $(outdir)/%.png: %.png
 	convert -depth 8 -geometry 50x50% $< $@
 
@@ -229,10 +255,11 @@ DEEP_HTML_FILES =\
  $(outdir)/lilypond/index.html\
  $(outdir)/lilypond-internals/index.html\
  $(outdir)/music-glossary/index.html\
- $(outdir)/lilypond-program/index.html
+ $(outdir)/lilypond-program/index.html\
+ $(outdir)/lilypond-learning/index.html
 
 # Symlinks to refer to external source documents from split and non-split HTML
-source-links = $(outdir)/source $(outdir)/lilypond/source $(outdir)/music-glossary/source $(outdir)/lilypond-program/source
+source-links = $(outdir)/source $(outdir)/lilypond/source $(outdir)/music-glossary/source $(outdir)/lilypond-program/source $(outdir)/lilypond-learning/source
 
 $(outdir)/source:
 	@rm -f $(@)
@@ -253,12 +280,16 @@ $(outdir)/lilypond-program/source:
 	mkdir -p $(outdir)/lilypond-program
 	ln -sf ../../../ $(@)
 
+$(outdir)/lilypond-learning/source:
+	@rm -f $(@)
+	mkdir -p $(outdir)/lilypond-learning
+	ln -sf ../../../ $(@)
 
 local-WWW: $(HTML_FILES) $(DEEP_HTML_FILES)\
  $(datafiles) $(PDF_FILES) $(source-links) info info-dir
 
 info-dir:
-	$(SHELL) $(buildscript-dir)/install-info-html.sh --dir=$(outdir) lilypond lilypond-internals music-glossary lilypond-program
+	$(SHELL) $(buildscript-dir)/install-info-html.sh --dir=$(outdir) lilypond lilypond-internals music-glossary lilypond-program lilypond-learning
 
 
 $(outdir)/%.bib: %.bib
diff --git a/Documentation/user/README.txt b/Documentation/user/README.txt
index 7c28e2bc7e..80c9f92c16 100644
--- a/Documentation/user/README.txt
+++ b/Documentation/user/README.txt
@@ -1,161 +1,18 @@
 Info for Documentation
 ----------------------
 
-Current version of the manual: 2.11.28
-*** Please update this whenever you run convert-ly on the docs.
+%%%%% GENERAL POLICY
 
-convert-ly -e --from=... --to=... --no-version *.itely
- 
-%%%%%
-DOC ORGANIZATION
-
-There are three parts to the documentation: the Learning Manual,
-the Notation Reference, and the Technical Details.
-
-* Long, wordy, chatty explanations go in the Learning Manual.
-This is aimed at users learning something for the first
-time -- not necessarily just learning lilypond notation, but
-also things like learning how to deal with projects, tweaking,
-preparing parts for orchestras, etc.  Less formal language
-may be used here.
-
-* Notation Reference is a (hopefully complete) description of
-LilyPond input notation.  Some material from here may be
-duplicated in the Learning Manual (for teaching).  The
-material is presented in an approximate order of increasing
-difficulty, but the goal is _not_ to provide a step-by-step
-learning environment.  For example, all material under
-"Notes" should remain in that section, even though microtonal
-accidentals may seem more advanced than info about clefs or
-time signatures -- "Notes" should be a one-stop reference
-about, well, notes.  This section is written in formal
-technical writing style.
-
-* Technical Details contains information about using
-the program lilypond with other programs (lilypond-book,
-operating systems, GUIs, convert-ly, etc).  This section
-is written in formal technical writing style.
-
-
-%%%%%
-GENERAL GUIDELINES
-
-* Use two spaces for indentation in lilypond examples.
-
-* Do not forget to create @cindex entries for new sections of text.
-  Enter commands with @funindex, i.e.
-  @funindex \relative
-  do not bother with the @code{} (they are added automatically).  These
-  items are added to both the command index and the unified index.
-
-* The use of the word `illegal' is inappropriate in most cases.  Say
-  `invalid' instead.
-
-* Avoid long stretches of input code.  Noone is going to read them in
-  print.  Instead refer to an example input file (with @lsr{}); these
-  are clickable in HTML.
-
-* Abbrevs in caps, e.g., HTML, DVI, MIDI, etc.
-
-* Colon usage
-
-  0. Do not use a colon to introduce examples, sentences just continue
-
-      in the display material.
-
-  1. To introduce lists
-  2. When beginning a quote: "So, he said,..."
-     This usage is rarer.  Americans often just use a comma.
-  3. When adding a defining example at the end of a sentence.
-
-* To produce good looking texinfo output (for both TTY and DVI) some
-  additional formatting rules should be followed.
-
-  . Do not use tabs.  They expand to nothing in DVI output.
-
-  . Do not use spaces at the beginning of a line (except in @example
-    or @verbatim environments), and do not use more than a single space
-    between words.  `makeinfo' copies the input lines verbatim without
-    removing those spaces.
-
-  . Use two spaces after a period.
-
-  . Variables or numbers which consist of a single character (probably
-    followed by a punctuation mark) should be tied properly, either to
-    the previous or the next word.  Example:
+See policy.txt
 
-      The variable@tie{}@var{a} ...
 
-  . To get consistent indentation in the DVI output it is better to avoid
-    the @verbatim environment.  Use the @example environment instead if
-    possible, but without extraneous indentation.  For example, this
-
-      @example
-        foo {
-          bar
-        }
-      @end example
-
-    should be replaced with
-
-      @example
-      foo {
-        bar
-      }
-      @end example
-
-    where `@example' starts the line (without leading spaces).
-
-  . Use the `quote' option in @lilypond commands if possible.
-
-  . Do not compress the input vertically; this is, do not use
-
-      Beginning of logical unit
-      @example
-      ...
-      @end example
-      continuation of logical unit
-
-    but
-
-      Beginning of logical unit
-
-      @example
-      ...
-      @end example
-
-      @noindent
-      continuation of logical unit
-
-    This makes it easier to not forget `@noindent'.
-
-  . Non-ASCII characters which are in utf-8 should be directly used;
-    this is, don't say `Ba@ss{}tuba' but `Baßtuba'.  This ensures that
-    all such characters appear in all output formats.
-
-* Lines should be less than 80 characters long.
-
-* Use @q instead of `...' and @qq instead of ``...''.  The latter macro
-  should be used with care since we use `...' as the default quoting
-  throughout the manual, except for things related to direct speech.
-
-
-%%%%%
-HINTS FOR TECHNICAL WRITING STYLE
-
-* Do not refer to LilyPond in the text.  The reader knows what the
-  manual is about.  If you do, capitalization is LilyPond.
-
-* If you explicitly refer to `lilypond', the program (or any other
-  command to be executed), say `@command{lilypond}'.
-
-* Do not explicitly refer to the reader/user.  There is no one else
-  besides the reader and the writer.
+%%%%% UPDATING DOCS
+convert-ly -e --from=... --to=... --no-version *.itely
 
-* Do not use abbreviations (don't, won't, etc.).  If you do, use a
-  comma after it:
+% to find the current version number,
+grep "version \"" tutorial.itely
 
-    blabla blabla, i.e., blabla blabla
+%  (nobody ever remembers to update this file, so I've stopped
+%  trying to record it here)
 
-* Avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'').
 
diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely
deleted file mode 100644
index 61729918cb..0000000000
--- a/Documentation/user/advanced-notation.itely
+++ /dev/null
@@ -1,2683 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-
-@node Advanced notation
-@chapter Advanced notation
-
-This chapter deals with rarely-used and advanced notation.
-
-@menu
-* Text::                        
-* Preparing parts::             
-* Orchestral music::            
-* Contemporary notation::       
-* Educational use::             
-@end menu
-
-
-
-@node Text
-@section Text
-
-This section explains how to include text (with various formatting) in
-your scores.
-
-@cindex Text, other languages
-To write accented and special text (such as characters from other languages),
-simply
-insert the characters directly into the lilypond file.  The file must be
-saved as UTF-8.  For more information, see @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
-* Text scripts::                
-* Text and line spanners::      
-* Text spanners::               
-* Text marks::                  
-* Text markup::                 
-* Nested scores::               
-* Page wrapping text::          
-* Overview of text markup commands::  
-* Overview of text markup list commands::  
-* Font selection::              
-* New dynamic marks::           
-@end menu
-
-
-@node Text scripts
-@subsection Text scripts
-
-@cindex Text scripts
-@cindex text items, non-empty
-@cindex non-empty texts
-
-It is possible to place arbitrary strings of text or @ref{Text markup},
-above or below notes by using a string @code{c^"text"}.  By default,
-these indications do not influence the note spacing, but by using the
-command @code{\fatText}, the widths will be taken into account
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
-c4^"longtext" \fatText c4_"longlongtext" c4
-@end lilypond
-
-@noindent
-To prevent text from influencing spacing, use @code{\emptyText}.
-
-More complex formatting may also be added to a note by using the
-markup command,
-
-@lilypond[fragment,ragged-right,verbatim,quote]
-c'4^\markup { bla \bold bla }
-@end lilypond
-
-The @code{\markup} is described in more detail in
-@ref{Text markup}.
-
-
-@refcommands
-
-@funindex \fatText
-@code{\fatText},
-@funindex \emptyText
-@code{\emptyText}.
-
-
-@commonprop
-
-Checking to make sure that text scripts and lyrics are within the margins is
-a relatively large computational task.  To speed up processing, lilypond does
-not perform such calculations by default; to enable it, use
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-
-@seealso
-
-In this manual: @ref{Text markup}.
-
-Program reference: @internalsref{TextScript}.
-
-
-@node Text and line spanners
-@subsection Text and line spanners
-
-Some performance indications, e.g., @i{rallentando} and
-@i{accelerando} and @i{trills} are written as text and are extended
-over many measures with lines, sometimes dotted or wavy.
-
-These all use the same routines as the glissando for drawing the texts
-and the lines, and tuning their behavior is therefore also done in the
-same way. It is done with a spanner, and the routine responsible for
-drawing the spanners is @code{ly:line-interface::print}. This
-routine determines the exact location of the two @i{span
-points} and draws a line in between, in the style requested.
-
-Here is an example of the different line styles available, and how to
-tune them.
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-d2 \glissando d'2
-\once \override Glissando #'dash-fraction = #0.5
-d,2 \glissando d'2
-\override Glissando #'style = #'dotted-line
-d,2 \glissando d'2
-\override Glissando #'style = #'zigzag
-d,2 \glissando d'2
-\override Glissando #'style = #'trill
-d,2 \glissando d'2
-@end lilypond
-
-The information that determines the end-points is computed on-the-fly
-for every graphic object, but it is possible to override these. 
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-e2 \glissando f
-\once \override Glissando #'bound-details #'right #'Y = #-2
-e2 \glissando f
-@end lilypond
-
-The @code{Glissando} object, like any other using the
-@code{ly:line-interface::print} routine, carries a nested
-association list. In the above statement, the value for @code{Y}
-is set to @code{-2} for the association list corresponding to the right
-end point. Of course, it is also possible to adjust the left side with
-@code{left} instead of @code{right}.
-
-If @code{Y} is not set, the value is computed from the vertical
-position of right attachment point of the spanner. 
-
-In case of a line break, the values for the span-points are extended
-with contents of the @code{left-broken} and @code{right-broken}
-sublists, for example
-
-@lilypond[relative=2,ragged-right,verbatim,fragment]
-\override Glissando #'breakable = ##T 
-\override Glissando #'bound-details #'right-broken #'Y = #-3
-c1 \glissando \break
-f1
-@end lilypond
-
-The following properties can be used for the
-
-@table @code
-@item Y
-This sets the Y-coordinate of the end point, in staff space.  By
-default, it is the center of the bound object, so for a glissando it
-points to the vertical center of the note head.
-
-For horizontal spanners, such as text spanner and trill spanners, it
-is hardcoded to 0.
-
-@item attach-dir
-This determines where the line starts and ends in X-direction,
-relative to the bound object.  So, a value of @code{-1} (or
-@code{LEFT}) makes the line start/end at the left side of the note
-head it is attached to.
-
-@item X
-This is the absolute coordinate of the end point. It is usually
-computed on the fly, and there is little use in overriding it. 
-
-@item stencil
-Line spanners may have symbols at the beginning or end, which is
-contained in this sub-property.  This is for internal use, it is
-recommended to use @code{text}.
-
-@item text
-This is a markup that is evaluated to yield stencil. It is
-used to put @i{cresc.} and @i{tr} on horizontal spanners.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override TextSpanner #'bound-details #'left #'text
-   = \markup { \small \bold Slower }
-c2\startTextSpan b c a\stopTextSpan
-@end lilypond
-
-@item stencil-align-dir-y
-@item stencil-offset
-Without setting this, the stencil is simply put there at the
-end-point, as defined by the @code{X} and @code{Y} sub properties.
-Setting either @code{stencil-align-dir-y} or @code{stencil-offset}
-will move the symbol at the edge relative to the end point of the line
-
-@lilypond[relative=1,fragment,verbatim]
-\override TextSpanner #'bound-details #'left #'stencil-align-dir-y = #DOWN
-\override TextSpanner #'bound-details #'right #'stencil-align-dir-y = #UP
-
-\override TextSpanner #'bound-details #'left #'text = #"gggg"
-\override TextSpanner #'bound-details #'right #'text = #"hhhh"
-c4^\startTextSpan c c c \stopTextSpan
-@end lilypond
-
-@item arrow
-Setting this sub property to @code{#t} produce an arrowhead at the end
-of the line.
-
-@item padding
-This sub property controls the space between the specified end-point
-of the line and the actual end.  Without padding, a glissando would
-start and end in the center of each note head.
-
-@end table
-
-@seealso
-
-Program reference: @internalsref{TextSpanner},
-@internalsref{Glissando}, @internalsref{VoiceFollower},
-@internalsref{TrillSpanner}, @internalsref{line-spanner-interface}.
-
-Examples: @lsr{expressive,line-styles.ly}, @lsr{expressive,line-arrows.ly}
-
-
-@node Text spanners
-@subsection Text spanners
-
-@cindex Text spanners
-
-Some performance indications, e.g., @i{rallentando} or @i{accelerando},
-are written as text and are extended over many measures with dotted
-lines.  Such texts are created using text spanners; attach
-@code{\startTextSpan} and @code{\stopTextSpan} to the first and last
-notes of the spanner.
-
-The string to be printed, as well as the style, is set through object
-properties
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c1
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \upright "rall" } 
-c2\startTextSpan b c\stopTextSpan a
-\break
-\textSpannerUp
-\override TextSpanner #'bound-details #'left #'text =
-  \markup { \italic "rit" } 
-c2\startTextSpan b c\stopTextSpan a
-@end lilypond
-
-@refcommands
-
-@funindex textSpannerUp
-@code{\textSpannerUp},
-@funindex textSpannerDown
-@code{\textSpannerDown},
-@funindex textSpannerNeutral
-@code{\textSpannerNeutral}.
-
-
-@commonprop
-
-To print a solid line, use
-
-@example
-\override TextSpanner #'dash-fraction = #'()
-@end example
-
-
-@seealso
-
-Program reference: @internalsref{TextSpanner}.
-
-
-@node Text marks
-@subsection Text marks
-
-@cindex coda on bar line
-@cindex segno on bar line
-@cindex fermata on bar line
-@cindex bar lines, symbols on
-@funindex \mark
-
-The @code{\mark} command is primarily used for
-@ref{Rehearsal marks},
-but it can also be used to put signs like coda,
-segno, and fermata on a bar line.  Use @code{\markup} to
-access the appropriate symbol (symbols are listed in
-@ref{The Feta font}).
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
-c1
-@end lilypond
-
-@noindent
-@code{\mark} is only typeset above the top stave of the score.  If
-you specify the @code{\mark} command at a bar line, the resulting
-mark is placed above the bar line.  If you specify it in the middle
-of a bar, the resulting mark is positioned between notes.  If it is
-specified before the beginning of a score line, it is placed
-before the first note of the line.  Finally, if the mark occurs at
-a line break, the mark will be printed at the
-beginning of the next line.
-@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
-@c  delete this sentence.   -gp
-If there is no next line, then the mark will not be printed at all.
-
-
-@commonprop
-
-To print the mark at the end of the current line, use
-
-@example
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-@end example
-
-@code{\mark} is often useful for adding text to the end of bar.  In
-such cases, changing the @code{#'self-alignment} is very useful
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\override Score.RehearsalMark
-  #'break-visibility = #begin-of-line-invisible
-c1 c c c4 c c c
-\once \override Score.RehearsalMark #'self-alignment-X = #right
-\mark "D.S. al Fine "
-@end lilypond
-
-Text marks may be aligned with notation objects other than
-bar lines,
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\relative {
-  c1
-  \key cis \major
-  \clef alto
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  \mark "on key"
-  cis
-  \key ces \major
-  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
-  \clef treble
-  \mark "on clef"
-  ces
-  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
-  \key d \minor
-  \clef tenor
-  \time 3/4
-  \mark "on time"
-  c
-}
-@end lilypond
-
-Possible symbols for the @code{break-align-symbols} list are
-@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
-@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
-@code{key-signature}, and @code{time-signature}.
-
-The text marks will, by default, be aligned with the middle of the notation
-object, but this can be changed by overriding the
-@code{break-align-anchor-alignment} and
-@code{break-align-anchor} properties for the appropriate grob.
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-{
-  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
-  c1
-  \key cis \major
-
-  % the RehearsalMark will be aligned with the left edge of the KeySignature
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
-  \mark \default
-  cis1
-  \key ces \major
-
-  % the RehearsalMark will be aligned with the right edge of the KeySignature
-  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
-  \mark \default
-  ces1
-  \key cis \major
-
-  % the RehearsalMark will be aligned with the left edge of the KeySignature
-  % and then shifted right by 2 units.
-  \once \override Staff.KeySignature #'break-align-anchor = #2
-  \mark \default
-  ces1
-}
-@end lilypond
-
-Although text marks are normally only printed above the topmost
-staff, you may alter this to print them on every staff,
-
-@lilypond[quote,ragged-right,verbatim,relative=2]
-{
-  \new Score \with {
-    \remove "Mark_engraver"
-  }
-  <<
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c''1 \mark "foo" c'' }
-    \new Staff \with {
-      \consists "Mark_engraver"
-    }
-    { c'1 \mark "foo" c' }
-  >>
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{RehearsalMark}.
-
-
-@node Text markup
-@subsection Text markup
-
-@cindex markup
-@cindex text markup
-@cindex markup text
-@cindex typeset text
-
-Use @code{\markup} to typeset text.  Commands are entered with the
-backslash @code{\}.  To enter @code{\} and @code{#}, use double
-quotation marks.
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { hello }
-c1_\markup { hi there }
-c1^\markup { hi \bold there, is \italic {anyone home?} }
-c1_\markup { "\special {weird} #characters" }
-@end lilypond
-
-@noindent
-See @ref{Overview of text markup commands}, for a list of all
-commands.
-
-@code{\markup} is primarily used for @internalsref{TextScript}s,
-but it can also be used anywhere text is called in lilypond
-
-@lilypond[quote,verbatim]
-\header{ title = \markup{ \bold { foo \italic { bar! } } } }
-\score{
-  \relative c'' {
-    \override Score.RehearsalMark
-      #'break-visibility = #begin-of-line-invisible
-    \override Score.RehearsalMark #'self-alignment-X = #right
-
-    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
-    c2^\markup{ don't be \flat }
-    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
-    b2\startTextSpan
-    a2\mark \markup{ \large \bold Fine }
-    r2\stopTextSpan
-    \bar "||"
-  }
-  \addlyrics { bar, foo \markup{ \italic bar! } }
-}
-@end lilypond
-
-A @code{\markup} command can also be placed on its own, away from any
-@code{\score} block, see @ref{Multiple scores in a book}.
-
-@lilypond[quote,ragged-right,verbatim]
-\markup{ Here is some text. }
-@end lilypond
-
-@cindex font switching
-
-The markup in the example demonstrates font switching commands.  The
-command @code{\bold} and @code{\italic} apply to the first following
-word only; to apply a command to more than one word, enclose the
-words with braces,
-
-@example
-\markup @{ \bold @{ hi there @} @}
-@end example
-
-@noindent
-For clarity, you can also do this for single arguments, e.g.,
-
-@example
-\markup @{ is \italic @{ anyone @} home @}
-@end example
-
-In markup mode you can compose expressions, similar to mathematical
-expressions, XML documents, and music expressions.  You can stack
-expressions grouped vertically with the command @code{\column}.
-Similarly, @code{\center-align} aligns texts by their center lines:
-
-@lilypond[quote,verbatim,fragment,relative=1]
-c1^\markup { \column { a bbbb \line { c d } } }
-c1^\markup { \center-align { a bbbb c } }
-c1^\markup { \line { a b c } }
-@end lilypond
-
-Lists with no previous command are not kept distinct.  The expression
-
-@example
-\center-align @{ @{ a b @} @{ c d @} @}
-@end example
-
-@noindent
-
-is equivalent to
-
-@example
-\center-align @{ a b c d @}
-@end example
-
-@noindent
-
-To keep lists of words distinct, please use quotes @code{"} or
-the @code{\line} command
-
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c4^\markup{ \center-align { on three lines } }
-c4^\markup{ \center-align { "all one line" } }
-c4^\markup{ \center-align { { on three lines } } }
-c4^\markup{ \center-align { \line { on one line } } }
-@end lilypond
-
-Markups can be stored in variables and these variables
-may be attached to notes, like
-@example
-allegro = \markup @{ \bold \large @{ Allegro @} @}
- @{ a^\allegro b c d @}
-@end example
-
-Some objects have alignment procedures of their own, which cancel out
-any effects of alignments applied to their markup arguments as a
-whole.  For example, the @internalsref{RehearsalMark} is horizontally
-centered, so using @code{\mark \markup @{ \left-align .. @}} has no
-effect.
-
-In addition, vertical placement is performed after creating the
-text markup object.  If you wish to move an entire piece of markup,
-you need to use the #'padding property or create an @q{anchor} point
-inside the markup (generally with @code{\hspace #0}).
-
-@lilypond[quote,verbatim,fragment,relative=1]
-\fatText
-c'4^\markup{ \raise #5 "not raised" }
-\once \override TextScript #'padding = #3
-c'4^\markup{ raised }
-c'4^\markup{ \hspace #0 \raise #1.5 raised }
-@end lilypond
-
-Some situations (such as dynamic marks) have preset font-related
-properties.  If you are creating text in such situations, it
-is advisable to cancel those properties with
-@code{normal-text}.  See @ref{Overview of text markup commands},
-for more details.
-
-
-@seealso
-
-This manual: @ref{Overview of text markup commands}.
-
-Program reference: @internalsref{TextScript}.
-
-Init files: @file{scm/@/new@/-markup@/.scm}.
-
-
-@refbugs
-
-Kerning or generation of ligatures is only done when the @TeX{}
-backend is used.  In this case, LilyPond does not account for them so
-texts will be spaced slightly too wide.
-
-Syntax errors for markup mode are confusing.
-
-
-@node Nested scores
-@subsection Nested scores
-
-It is possible to nest music inside markups, by adding a @code{\score}
-block to a markup expression.  Such a score must contain a @code{\layout}
-block.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative {
-  c4 d^\markup {
-    \score {
-      \relative { c4 d e f }
-      \layout { }
-    }
-  }
-  e f
-}
-@end lilypond
-
-@node Page wrapping text
-@subsection Page wrapping text
-Whereas @code{\markup} is used to enter a non-breakable block of text,
-@code{\markuplines} can be used at top-level to enter lines of text that
-can spread over multiple pages:
-
-@verbatim
-\markuplines {
-  \justified-lines {
-    A very long text of justified lines.
-    ...
-  }
-  \justified-lines {
-    An other very long paragraph.
-    ...
-  }
-  ...
-}
-@end verbatim
-
-@code{\markuplines} accepts a list of markup, that is either the result
-of a markup list command, or a list of markups or of markup lists. The
-built-in markup list commands are described in
-@ref{Overview of text markup list commands}.
-
-@seealso
-
-This manual: @ref{Overview of text markup list commands}, 
-@ref{New markup list command definition}.
-
-@refcommands
-
-@funindex \markuplines
-@code{\markuplines}
-
-@node Overview of text markup commands
-@subsection Overview of text markup commands
-
-The following commands can all be used inside @code{\markup @{ @}}.
-
-@include markup-commands.tely
-
-@node Overview of text markup list commands
-@subsection Overview of text markup list commands
-
-The following commands can all be used with @code{\markuplines}.
-
-@include markup-list-commands.tely
-
-@node Font selection
-@subsection Font selection
-
-@cindex font selection
-@cindex font magnification
-@funindex font-interface
-
-By setting the object properties described below, you can select a
-font from the preconfigured font families.  LilyPond has default
-support for the feta music fonts. Text fonts are selected through
-Pango/FontConfig. The serif font defaults to New Century Schoolbook,
-the sans and typewriter to whatever the Pango installation defaults
-to.
-
-
-@itemize @bullet
-@item @code{font-encoding}
-is a symbol that sets layout of the glyphs.  This should only be set to
-select different types of non-text fonts, e.g.
-
-@code{fetaBraces} for piano staff braces, @code{fetaMusic} the
-standard music font, including ancient glyphs, @code{fetaDynamic} for
-dynamic signs and @code{fetaNumber} for the number font.
-
-@item @code{font-family}
-is a symbol indicating the general class of the typeface.  Supported are
-@code{roman} (Computer Modern), @code{sans}, and @code{typewriter}.
-
-@item @code{font-shape}
-is a symbol indicating the shape of the font.  There are typically
-several font shapes available for each font family.  Choices are
-@code{italic}, @code{caps}, and @code{upright}.
-
-@item @code{font-series}
-is a symbol indicating the series of the font.  There are typically
-several font series for each font family and shape.  Choices are
-@code{medium} and @code{bold}.
-
-@end itemize
-
-Fonts selected in the way sketched above come from a predefined style
-sheet. If you want to use a font from outside the style sheet,
-then set the
-@code{font-name} property,
-
-@lilypond[fragment,verbatim]
-{
-  \override Staff.TimeSignature #'font-name = #"Charter"
-  \override Staff.TimeSignature #'font-size = #2
-  \time 3/4
-  c'1_\markup {
-    \override #'(font-name . "Vera Bold")
-      { This text is in Vera Bold }
-  }
-}
-@end lilypond
-
-@noindent
-Any font can be used, as long as it is available to Pango/FontConfig.
-To get a full list of all available fonts, run the command
-@example
-lilypond -dshow-available-fonts blabla
-@end example
-(the last argument of the command can be anything, but has to be present).
-
-
-The size of the font may be set with the @code{font-size}
-property. The resulting size is taken relative to the
-@code{text-font-size} as defined in the @code{\paper} block.
-
-@cindex font size
-@cindex font magnification
-
-
-It is also possible to change the default font family for the entire
-document. This is done by calling the @code{make-pango-font-tree} from
-within the @code{\paper} block. The function takes names for the font
-families to use for roman, sans serif and monospaced text. For
-example,
-
-@cindex font families, setting
-@cindex Pango
-
-
-@lilypond[verbatim]
-\paper  {
-  myStaffSize = #20
-
-  #(define fonts
-    (make-pango-font-tree "Times New Roman"
-                          "Nimbus Sans"
-                          "Luxi Mono"
-                           (/ myStaffSize 20)))
-}
-
-{
-  c'^\markup { roman: foo \sans bla \typewriter bar }
-}
-@end lilypond
-
-@c we don't do Helvetica / Courier, since GS incorrectly loads
-@c Apple TTF fonts
-
-
-
-@seealso
-
-Examples: @lsr{text,font@/-family@/-override.ly}.
-
-
-@node New dynamic marks
-@subsection New dynamic marks
-
-It is possible to print new dynamic marks or text that should be aligned
-with dynamics.  Use @code{make-dynamic-script} to create these
-marks.  Note that the dynamic font only contains the characters
-@code{f,m,p,r,s} and @code{z}.
-
-Some situations (such as dynamic marks) have preset font-related
-properties.  If you are creating text in such situations, it
-is advisable to cancel those properties with
-@code{normal-text}.  See @ref{Overview of text markup commands},
-for more details.
-
-@cindex make-dynamic-script
-
-@lilypond[quote,verbatim,ragged-right]
-sfzp = #(make-dynamic-script "sfzp")
-\relative c' {
-  c4 c c\sfzp c
-}
-@end lilypond
-
-@cindex Dynamics, editorial
-@cindex Dynamics, parenthesis
-
-It is also possible to print dynamics in round parenthesis or square
-brackets.  These are often used for adding editorial dynamics.
-
-@lilypond[quote,verbatim,ragged-right]
-rndf = \markup{ \center-align {\line { \bold{\italic (}
-  \dynamic f \bold{\italic )} }} }
-boxf = \markup{ \bracket { \dynamic f } }
-{ c'1_\rndf c'1_\boxf }
-@end lilypond
-
-
-
-@node Preparing parts
-@section Preparing parts
-
-This section describes various notation that are useful for preparing
-individual parts.
-
-@menu
-* Multi measure rests::         
-* Metronome marks::             
-* Rehearsal marks::             
-* Bar numbers::                 
-* Instrument names::            
-* Instrument transpositions::   
-* Ottava brackets::             
-* Different editions from one source::  
-@end menu
-
-
-@node Multi measure rests
-@subsection Multi measure rests
-
-@cindex multi measure rests
-@cindex full measure rests
-@cindex Rests, multi measure
-@cindex Rests, full measure
-@cindex whole rests for a full measure
-@funindex R
-
-Rests for one full measure (or many bars) are entered using @samp{R}.  It
-is specifically meant for full bar rests and for entering parts: the rest
-can expand to fill a score with rests, or it can be printed as a single
-multi-measure rest.  This expansion is controlled by the property
-@code{Score.skipBars}.  If this is set to true, empty measures will not
-be expanded, and the appropriate number is added automatically
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 4/4 r1 | R1 | R1*2 \time 3/4 R2. \time 2/4 R2 \time 4/4
-\set Score.skipBars = ##t R1*17 R1*4
-@end lilypond
-
-The @code{1} in @code{R1} is similar to the duration notation used for
-notes.  Hence, for time signatures other than 4/4, you must enter other
-durations.  This can be done with augmentation dots or fractions
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-\time 3/4
-R2. | R2.*2
-\time 13/8
-R1*13/8
-R1*13/8*12 |
-\time 10/8 R4*5*4 |
-@end lilypond
-
-An @code{R} spanning a single measure is printed as either a whole rest
-or a breve, centered in the measure regardless of the time signature.
-
-If there are only a few measures of rest, LilyPond prints @q{church rests}
-(a series of rectangles) in the staff.  To replace that with a simple
-rest, use @code{MultiMeasureRest.expand-limit}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\set Score.skipBars = ##t
-R1*2 | R1*5 | R1*9
-\override MultiMeasureRest #'expand-limit = 1
-R1*2 | R1*5 | R1*9
-@end lilypond
-
-@cindex text on multi-measure rest
-@cindex script on multi-measure rest
-@cindex fermata on multi-measure rest
-
-Texts can be added to multi-measure rests by using the
-@var{note}-@code{markup} syntax @ref{Text markup}.
-A variable (@code{\fermataMarkup}) is provided for
-adding fermatas
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\set Score.skipBars = ##t
-\time 3/4
-R2.*10^\markup { \italic "ad lib." }
-R2.^\fermataMarkup
-@end lilypond
-
-Warning!  This text is created by @code{MultiMeasureRestText}, not
-@code{TextScript}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\override TextScript #'padding = #5
-R1^"low"
-\override MultiMeasureRestText #'padding = #5
-R1^"high"
-@end lilypond
-
-If you want to have text on the left end of a multi-measure rest,
-attach the text to a zero-length skip note, i.e.,
-
-@example
-s1*0^"Allegro"
-R1*4
-@end example
-
-
-@seealso
-
-Program reference: @internalsref{MultiMeasureRestMusicGroup},
-@internalsref{MultiMeasureRest}.
-
-The layout object @internalsref{MultiMeasureRestNumber} is for the
-default number, and @internalsref{MultiMeasureRestText} for user
-specified texts.
-
-
-@refbugs
-
-It is not possible to use fingerings (e.g., @code{R1-4}) to put numbers
-over multi-measure rests.  And the pitch of multi-measure rests (or
-staff-centered rests) can not be influenced.
-
-@cindex condensing rests
-
-There is no way to automatically condense multiple rests into a single
-multi-measure rest.  Multi-measure rests do not take part in rest
-collisions.
-
-Be careful when entering multi-measure rests followed by whole
-notes.  The following will enter two notes lasting four measures each
-@example
-R1*4 cis cis
-@end example
-When @code{skipBars} is set, the result will look OK, but the bar
-numbering will be off.
-
-
-@node Metronome marks
-@subsection Metronome marks
-
-@cindex Tempo
-@cindex beats per minute
-@cindex metronome marking
-
-Metronome settings can be entered as follows
-@example
-\tempo @var{duration} = @var{per-minute}
-@end example
-
-In the MIDI output, they are interpreted as a tempo change.  In the
-layout output, a metronome marking is printed
-@funindex \tempo
-@lilypond[quote,ragged-right,verbatim,fragment]
-\tempo 8.=120 c''1
-@end lilypond
-
-
-@commonprop
-
-To change the tempo in the MIDI output without printing anything, make
-the metronome marking invisible
-@example
-\once \override Score.MetronomeMark #'transparent = ##t
-@end example
-
-To print other metronome markings, use these markup commands
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-c4^\markup {
-  (
-  \smaller \general-align #Y #DOWN \note #"16." #1
-  =
-  \smaller \general-align #Y #DOWN \note #"8" #1
-  ) }
-@end lilypond
-
-@noindent
-See @ref{Text markup}, for more details.
-
-
-@seealso
-
-Program reference: @internalsref{MetronomeMark}.
-
-
-@refbugs
-
-Collisions are not checked.  If you have notes above the top line of
-the staff (or notes with articulations, slurs, text, etc), then the
-metronome marking may be printed on top of musical symbols.  If this
-occurs, increase the padding of the metronome mark to place it
-further away from the staff.
-
-@example
-\override Score.MetronomeMark #'padding = #2.5
-@end example
-
-
-@node Rehearsal marks
-@subsection Rehearsal marks
-
-@cindex Rehearsal marks
-@funindex \mark
-
-To print a rehearsal mark, use the @code{\mark} command
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1 \mark \default
-c1 \mark \default
-c1 \mark #8
-c1 \mark \default
-c1 \mark \default
-@end lilypond
-
-@noindent
-The letter@tie{}@q{I} is skipped in accordance with engraving traditions.
-If you wish to include the letter @q{I}, then use
-
-@example
-\set Score.markFormatter = #format-mark-alphabet
-@end example
-
-The mark is incremented automatically if you use @code{\mark
-\default}, but you can also use an integer argument to set the mark
-manually.  The value to use is stored in the property
-@code{rehearsalMark}.
-
-The style is defined by the property @code{markFormatter}.  It is a
-function taking the current mark (an integer) and the current context
-as argument.  It should return a markup object.  In the following
-example, @code{markFormatter} is set to a canned procedure.  After a
-few measures, it is set to function that produces a boxed number.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-\set Score.markFormatter = #format-mark-numbers
-c1 \mark \default
-c1 \mark \default
-\set Score.markFormatter = #format-mark-box-numbers
-c1 \mark \default
-c1 \mark \default
-c1
-@end lilypond
-
-The file @file{scm/@/translation@/-functions@/.scm} contains the definitions
-of @code{format-mark-numbers} (the default format),
-@code{format-mark-box-numbers},
-@code{format-mark-letters} and @code{format-mark-box-letters}.
-These can be used as inspiration for other formatting functions.
-
-You may use @code{format-mark-barnumbers}, @code{format-mark-box-barnumbers},
-and @code{format-mark-circle-barnumbers} to get bar numbers instead of
-incremented numbers or letters.
-
-Other styles of rehearsal mark can be specified manually
-
-@example
-\mark "A1"
-@end example
-
-@noindent
-@code{Score.markFormatter} does not affect marks specified in this manner.
-However, it is possible to apply a @code{\markup} to the string.
-
-@example
-\mark \markup@{ \box A1 @}
-@end example
-
-@cindex segno
-@cindex coda
-@cindex D.S al Fine
-
-Music glyphs (such as the segno sign) may be printed inside
-a @code{\mark}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-c1 \mark \markup { \musicglyph #"scripts.segno" }
-c1 \mark \markup { \musicglyph #"scripts.coda" }
-c1 \mark \markup { \musicglyph #"scripts.ufermata" }
-c1
-@end lilypond
-
-@noindent
-See @ref{The Feta font}, for a list of symbols which may be
-printed with @code{\musicglyph}.
-
-For common tweaks to the positioning of rehearsal marks, see @ref{Text marks}.
-
-@seealso
-
-This manual: @ref{Text marks}.
-
-Program reference: @internalsref{RehearsalMark}.
-
-Init files: @file{scm/@/translation@/-functions@/.scm} contains the
-definition of @code{format-mark-numbers} and
-@code{format-mark-letters}.  They can be used as inspiration for other
-formatting functions.
-
-Examples: @lsr{parts,rehearsal-mark-numbers.ly}
-
-
-@node Bar numbers
-@subsection Bar numbers
-
-@cindex Bar numbers
-@cindex measure numbers
-@funindex currentBarNumber
-
-Bar numbers are printed by default at the start of the line.  The
-number itself is stored in the @code{currentBarNumber} property, which
-is normally updated automatically for every measure.
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\repeat unfold 4 {c4 c c c} \break
-\set Score.currentBarNumber = #50
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-Bar numbers may only be printed at bar lines; to print a bar
-number at the beginning of a piece, an empty bar line must
-be added
-
-@lilypond[verbatim,ragged-right,quote,fragment,relative]
-\set Score.currentBarNumber = #50
-\bar ""
-\repeat unfold 4 {c4 c c c} \break
-\repeat unfold 4 {c4 c c c}
-@end lilypond
-
-Bar numbers can be typeset at regular intervals instead of at the
-beginning of each line.  This is illustrated in the following example,
-whose source is available as
-@lsr{staff,making-bar-numbers-appear-at-regular-intervals.ly}.
-
-@lilypondfile[ragged-right,quote]{bar-number-regular-interval.ly}
-
-Bar numbers can be removed entirely by removing the Bar number
-engraver from the score.
-
-@lilypond[verbatim,ragged-right,quote]
-\layout {
-  \context {
-    \Score
-    \remove "Bar_number_engraver"
-  }
-}
-\relative c''{
-c4 c c c \break
-c4 c c c
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{BarNumber}.
-
-Examples: @lsrdir{staff}
-
-
-@refbugs
-
-Bar numbers can collide with the @internalsref{StaffGroup} bracket, if
-there is one at the top.  To solve this, the
-@code{padding} property of @internalsref{BarNumber} can be
-used to position the number correctly.
-
-
-@node Instrument names
-@subsection Instrument names
-
-In an orchestral score, instrument names are printed at the left side
-of the staves.
-
-This can be achieved by setting @internalsref{Staff}.@code{instrumentName}
-and @internalsref{Staff}.@code{shortInstrumentName}, or
-@internalsref{PianoStaff}.@code{instrumentName} and
-@internalsref{PianoStaff}.@code{shortInstrumentName}.  This will
-print text before
-the start of the staff.  For the first staff, @code{instrumentName} is
-used, for the following ones, @code{shortInstrumentName} is used.
-
-@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-\set Staff.instrumentName = "Ploink "
-\set Staff.shortInstrumentName = "Plk "
-c1
-\break
-c''
-@end lilypond
-
-You can also use markup texts to construct more complicated instrument
-names, for example
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\set Staff.instrumentName = \markup {
-  \column { "Clarinetti"
-            \line { "in B" \smaller \flat } } }
-c''1
-@end lilypond
-
-If you wish to center the instrument names, you must center all of them
-
-@lilypond[quote,verbatim,ragged-right]
-{ <<
-\new Staff {
-  \set Staff.instrumentName = \markup {
-    \center-align { "Clarinetti"
-      \line { "in B" \smaller \flat } } }
-  c''1
-}
-\new Staff {
-  \set Staff.instrumentName = \markup{ \center-align { Vibraphone }}
-  c''1
-}
->>
-}
-@end lilypond
-
-For longer instrument names, it may be useful to increase the
-@code{indent} setting in the @code{\layout} block.
-
-To center instrument names while leaving extra space to the right,
-
-@lilypond[quote,verbatim,ragged-right]
-\new StaffGroup \relative
-<<
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blabla" }
-    c1 c1
-  }
-  \new Staff {
-    \set Staff.instrumentName = \markup { \hcenter-in #10 "blo" }
-    c1 c1
-  }
->>
-@end lilypond
-
-To add instrument names to other contexts (such as @code{GrandStaff},
-@code{ChoirStaff}, or @code{StaffGroup}), the engraver must
-be added to that context.
-
-@example
-\layout@{
-  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
-@}
-@end example
-
-@noindent
-More information about adding and removing engravers can
-be found in @ref{Modifying context plug-ins}.
-
-Instrument names may be changed in the middle of a piece,
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\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
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{InstrumentName}.
-
-
-
-@node Instrument transpositions
-@subsection Instrument transpositions
-
-@cindex transposition, MIDI
-@cindex transposition, instrument
-
-The key of a transposing instrument can also be specified.  This
-applies to many wind instruments, for example, clarinets (B-flat, A, and
-E-flat), horn (F) and trumpet (B-flat, C, D, and E-flat).
-
-The transposition is entered after the keyword @code{\transposition}
-
-@example
-\transposition bes   %% B-flat clarinet
-@end example
-
-@noindent
-This command sets the property @code{instrumentTransposition}.  The value of
-this property is used for MIDI output and quotations.  It does not
-affect how notes are printed in the current staff.  To change the printed
-output, see @ref{Transpose}.
-
-The pitch to use for @code{\transposition} should correspond to the
-real sound heard when a @code{c'} written on the staff is played by the
-transposing instrument.  For example, when entering a score in
-concert pitch, typically all voices are entered in C, so
-they should be entered as
-
-@example
-clarinet = @{
-  \transposition c'
-  ...
-@}
-saxophone = @{
-  \transposition c'
-  ...
-@}
-@end example
-
-The command @code{\transposition} should be used when the music is
-entered from a (transposed) orchestral part.  For example, in
-classical horn parts, the tuning of the instrument is often changed
-during a piece.  When copying the notes from the part, use
-@code{\transposition}, e.g.,
-
-@example
-\transposition d'
-c'4^"in D"
-...
-\transposition g'
-c'4^"in G"
-...
-@end example
-
-
-@node Ottava brackets
-@subsection Ottava brackets
-
-@q{Ottava} brackets introduce an extra transposition of an octave for
-the staff.  They are created by invoking the function
-@code{set-octavation}
-
-@cindex ottava
-@cindex 15ma
-@cindex octavation
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c''' {
-  a2 b
-  #(set-octavation 1)
-  a b
-  #(set-octavation 0)
-  a b
-}
-@end lilypond
-
-The @code{set-octavation} function also takes -1 (for 8va bassa), 2@tie{}(for 15ma),
-and -2 (for 15ma bassa) as arguments.  Internally the function sets the properties
-@code{ottavation} (e.g., to @code{"8va"} or @code{"8vb"}) and
-@code{centralCPosition}.  For overriding the text of the bracket, set
-@code{ottavation} after invoking @code{set-octavation}, i.e.,
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  #(set-octavation 1)
-  \set Staff.ottavation = #"8"
-  c'''
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{OttavaBracket}.
-
-
-@refbugs
-
-@code{set-octavation} will get confused when clef changes happen
-during an octavation bracket.
-
-
-@node Different editions from one source
-@subsection Different editions from one source
-
-@funindex \tag
-@cindex tag
-
-The @code{\tag} command marks music expressions with a name.  These
-tagged expressions can be filtered out later.  With this mechanism it
-is possible to make different versions of the same music source.
-
-In the following example, we see two versions of a piece of music, one
-for the full score, and one with cue notes for the instrumental part
-
-@example
-c1
-<<
-  \tag #'part <<
-    R1 \\
-    @{
-      \set fontSize = #-1
-      c4_"cue" f2 g4 @}
-  >>
-  \tag #'score R1
->>
-c1
-@end example
-
-The same can be applied to articulations, texts, etc.: they are
-made by prepending
-@example
--\tag #@var{your-tag}
-@end example
-to an articulation, for example,
-@example
-c1-\tag #'part ^4
-@end example
-
-This defines a note with a conditional fingering indication.
-
-@cindex keepWithTag
-@cindex removeWithTag
-By applying the @code{\keepWithTag} and @code{\removeWithTag}
-commands, tagged expressions can be filtered.  For example,
-@example
-<<
-  @var{the music}
-  \keepWithTag #'score @var{the music}
-  \keepWithTag #'part @var{the music}
->>
-@end example
-would yield
-
-@lilypondfile[ragged-right,quote]{tag-filter.ly}
-
-The arguments of the @code{\tag} command should be a symbol
-(such as @code{#'score} or @code{#'part}), followed by a
-music expression.  It is possible to put multiple tags on
-a piece of music with multiple @code{\tag} entries,
-
-@example
-  \tag #'original-part \tag #'transposed-part @dots{}
-@end example
-
-
-@seealso
-
-Examples: @lsr{parts,tag@/-filter@/.ly}
-
-
-@refbugs
-
-Multiple rests are not merged if you create the score with both tagged
-sections.
-
-
-
-@node Orchestral music
-@section Orchestral music
-
-Orchestral music involves some special notation, both in the full
-score and the individual parts.  This section explains how to tackle
-some common problems in orchestral music.
-
-@menu
-* Automatic part combining::    
-* Hiding staves::               
-* Quoting other voices::        
-* Formatting cue notes::        
-* Aligning to cadenzas::        
-@end menu
-
-
-@node Automatic part combining
-@subsection Automatic part combining
-@cindex automatic part combining
-@cindex part combiner
-
-Automatic part combining is used to merge two parts of music onto a
-staff.  It is aimed at typesetting orchestral scores.  When the two
-parts are identical for a period of time, only one is shown.  In
-places where the two parts differ, they are typeset as separate
-voices, and stem directions are set automatically.  Also, solo and
-@emph{a due} parts are identified and can be marked.
-
-The syntax for part combining is
-
-@example
-\partcombine @var{musicexpr1} @var{musicexpr2}
-@end example
-
-
-The following example demonstrates the basic functionality of the part
-combiner: putting parts on one staff, and setting stem directions and
-polyphony
-
-@lilypond[quote,verbatim,ragged-right,fragment]
-\new Staff \partcombine
-  \relative g' { g g a( b) c c r r }
-  \relative g' { g g r4 r e e g g }
-@end lilypond
-
-The first @code{g} appears only once, although it was
-specified twice (once in each part).  Stem, slur, and tie directions are
-set automatically, depending whether there is a solo or unisono.  The
-first part (with context called @code{one}) always gets up stems, and
-@q{Solo}, while the second (called @code{two}) always gets down stems and
-@q{Solo II}.
-
-If you just want the merging parts, and not the textual markings, you
-may set the property @code{printPartCombineTexts} to false
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Staff.printPartCombineTexts = ##f
-  \partcombine
-    \relative g' { g a( b) r }
-    \relative g' { g r4 r f }
->>
-@end lilypond
-
-To change the text that is printed for solos or merging, you may
-set the @code{soloText}, @code{soloIIText}, and @code{aDueText}
-properties.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Score.soloText = #"ichi"
-  \set Score.soloIIText = #"ni"
-  \set Score.aDueText = #"tachi"
-  \partcombine
-    \relative g' { g4 g a( b) r }
-    \relative g' { g4 g r r f }
->>
-@end lilypond
-
-Both arguments to @code{\partcombine} will be interpreted as
-@internalsref{Voice} contexts.  If using relative octaves,
-@code{\relative} should be specified for both music expressions, i.e.,
-
-@example
-\partcombine
-  \relative @dots{} @var{musicexpr1}
-  \relative @dots{} @var{musicexpr2}
-@end example
-
-@noindent
-A @code{\relative} section that is outside of @code{\partcombine} has
-no effect on the pitches of @var{musicexpr1} and @var{musicexpr2}.
-
-@seealso
-
-Program reference: @internalsref{PartCombineMusic}.
-
-@refbugs
-
-When @code{printPartCombineTexts} is set, when the two voices play the
-same notes on and off, the part combiner may typeset @code{a2} more
-than once in a measure.
-
-@code{\partcombine} cannot be inside @code{\times}.
-
-@code{\partcombine} cannot be inside @code{\relative}.
-
-Internally, the @code{\partcombine} interprets both arguments as
-@code{Voice}s named @code{one} and @code{two}, and then decides when
-the parts can be combined.  Consequently, if the arguments switch to
-differently named @internalsref{Voice} contexts, the events in those
-will be ignored.
-
-
-@node Hiding staves
-@subsection Hiding staves
-
-@cindex Frenched scores
-@cindex Hiding staves
-
-In orchestral scores, staff lines that only have rests are usually
-removed; this saves some space.  This style is called @q{French Score}.
-For @internalsref{Lyrics},
-@internalsref{ChordNames} and @internalsref{FiguredBass}, this is
-switched on by default.  When the lines of these contexts turn out
-empty after the line-breaking process, they are removed.
-
-For normal staves, a specialized @internalsref{Staff} context is
-available, which does the same: staves containing nothing (or only
-multi-measure rests) are removed.  The context definition is stored in
-@code{\RemoveEmptyStaffContext} variable.  Observe how the second staff
-in this example disappears in the second line
-
-@lilypond[quote,ragged-right,verbatim]
-\layout {
-  \context { \RemoveEmptyStaffContext }
-}
-
-{
-  \relative c' <<
-    \new Staff { e4 f g a \break c1 }
-    \new Staff { c4 d e f \break R1 }
-  >>
-}
-@end lilypond
-
-The first system shows all staves in full.  If empty staves should be
-removed from the first system too, set @code{remove-first} to true in
-@internalsref{VerticalAxisGroup}.
-
-@example
-\override Score.VerticalAxisGroup #'remove-first = ##t
-@end example
-
-To remove other types of contexts, use @code{\AncientRemoveEmptyStaffContext}
-or @code{\RemoveEmptyRhythmicStaffContext}.
-
-Another application is making ossia sections, i.e., alternative
-melodies on a separate piece of staff, with help of a Frenched
-staff.  
-
-
-@node Quoting other voices
-@subsection Quoting other voices
-
-@cindex cues
-
-With quotations, fragments of other parts can be inserted into a part
-directly.  Before a part can be quoted, it must be marked especially as
-quotable.  This is done with the @code{\addQuote} command.
-
-@example
-\addQuote @var{name} @var{music}
-@end example
-
-
-@noindent
-Here, @var{name} is an identifying string.  The @var{music} is any kind
-of music.  Here is an example of @code{\addQuote}
-
-@example
-\addQuote clarinet \relative c' @{
-  f4 fis g gis
-@}
-@end example
-
-This command must be entered at toplevel, i.e., outside any music
-blocks.
-
-After calling @code{\addQuote}, the quotation may then be done with
-@code{\quoteDuring} or @code{\cueDuring},
-
-@example
-\quoteDuring #@var{name} @var{music}
-@end example
-
-During a part, a piece of music can be quoted with the @code{\quoteDuring}
-command.
-
-@example
-\quoteDuring #"clarinet" @{ s2. @}
-@end example
-
-This would cite three quarter notes (the duration of @code{s2.})  of
-the previously added @code{clarinet} voice.
-
-
-More precisely, it takes the current time-step of the part being
-printed, and extracts the notes at the corresponding point of the
-@code{\addQuote}d voice.  Therefore, the argument to @code{\addQuote}
-should be the entire part of the voice to be quoted, including any
-rests at the beginning.
-
-Quotations take into account the transposition of both source and target
-instruments, if they are specified using the @code{\transposition} command.
-
-@lilypond[quote,ragged-right,verbatim]
-\addQuote clarinet \relative c' {
-  \transposition bes
-  f4 fis g gis
-}
-
-{
-  e'8 f'8 \quoteDuring #"clarinet" { s2 }
-}
-@end lilypond
-
-The type of events that are present in cue notes can be trimmed with
-the @code{quotedEventTypes} property.  The default value is
-@code{(note-event rest-event)}, which means that only notes and
-rests of the cued voice end up in the @code{\quoteDuring}.
-Setting
-
-@example
-\set Staff.quotedEventTypes =
-       #'(note-event articulation-event dynamic-event)
-@end example
-
-@noindent
-will quote notes (but no rests), together with scripts and dynamics.
-
-@refbugs
-
-Only the contents of the first @internalsref{Voice} occurring in an
-@code{\addQuote} command will be considered for quotation, so
-@var{music} can not contain @code{\new} and @code{\context Voice}
-statements that would switch to a different Voice.
-
-Quoting grace notes is broken and can even cause LilyPond to crash.
-
-Quoting nested triplets may result in poor notation.
-
-
-@seealso
-
-In this manual: @ref{Instrument transpositions}.
-
-Examples: @lsr{parts,quote.ly}, @lsr{parts,quote-transportation.ly}
-
-Program reference: @internalsref{QuoteMusic}.
-
-
-@node Formatting cue notes
-@subsection Formatting cue notes
-
-@cindex cues, formatting
-
-The previous section deals with inserting notes from another voice.
-There is a more advanced music function called @code{\cueDuring},
-which makes formatting cue notes easier.
-
-The syntax is
-
-@example
-  \cueDuring #@var{name} #@var{updown} @var{music}
-@end example
-
-This will insert notes from the part @var{name} into a
-@internalsref{Voice} called @code{cue}.  This happens simultaneously
-with @var{music}, which usually is a rest.  When the cue notes start,
-the staff in effect becomes polyphonic for a moment.  The argument
-@var{updown} determines whether the cue notes should be notated as a
-first or second voice.
-
-
-@lilypond[verbatim,ragged-right]
-smaller = {
-  \set fontSize = #-2
-  \override Stem #'length-fraction = #0.8
-  \override Beam #'thickness = #0.384
-  \override Beam #'length-fraction = #0.8
-}
-
-\addQuote clarinet \relative {
-  R1*20
-  r2 r8 c' f f
-}
-
-\new Staff \relative  <<
-
-  % setup a context for cue notes.
-  \new Voice = "cue" { \smaller \skip 1*21 }
-
-  \set Score.skipBars = ##t
-
-  \new Voice {
-    R1*20
-    \cueDuring #"clarinet" #UP {
-      R1
-    }
-    g4 g2.
-  }
->>
-@end lilypond
-
-
-Here are a couple of hints for successful cue notes
-
-@itemize @bullet
-@item
-Cue notes have smaller font sizes.
-@item
- the cued part is marked with the instrument playing the cue.
-@item
- when the original part takes over again, this should be marked with
- the name of the original instrument.
-
-@c really?  Are you sure about that last point?  I'll check after 3.0 -gp
-
-@c Yes, this is good practice.  Otherwise, the start of the original
-@c part can only be seen from the font size.  This is not good enough
-@c for sight-reading.  It is possilbe to use other
-@c markers (e.g. a big close-bracket over the staff) to indicate the cue
-@c   notes are
-@c finished.
-@c -hwn
-
-
-Any other changes introduced by the cued part should also be
-undone.  For example, if the cued instrument plays in a different clef,
-the original clef should be stated once again.
-
-@end itemize
-
-The macro @code{\transposedCueDuring} is
-useful to add cues to instruments which use a completely different
-octave range (for example, having a cue of a piccolo flute within
-a contra bassoon part).
-
-@lilypond[verbatim,ragged-right,quote]
-picc = \relative c''' {
-  \clef "treble^8"
-  R1 |
-  c8 c c e g2 |
-  a4 g g2 |
-}
-\addQuote "picc" { \picc }
-
-cbsn = \relative c, {
-  \clef "bass_8"
-  c4 r g r
-  \transposedCueDuring #"picc" #UP c,, { R1 } |
-  c4 r g r |
-}
-
-<<
-  \context Staff = "picc" \picc
-  \context Staff = "cbsn" \cbsn
->>
-@end lilypond
-
-
-
-@node Aligning to cadenzas
-@subsection Aligning to cadenzas
-
-In an orchestral context, cadenzas present a special problem:
-when constructing a score that includes a cadenza, all other
-instruments should skip just as many notes as the length of the
-cadenza, otherwise they will start too soon or too late.
-
-A solution to this problem are the functions @code{mmrest-of-length}
-and @code{skip-of-length}.  These Scheme functions take a piece of music
-as argument, and generate a @code{\skip} or multi-rest, exactly as
-long as the piece.  The use of @code{mmrest-of-length} is demonstrated
-in the following example.
-
-@lilypond[verbatim,ragged-right,quote]
-cadenza = \relative c' {
-  c4 d8 << { e f g } \\ { d4. } >>
-  g4 f2 g4 g
-}
-
-\new GrandStaff <<
-  \new Staff { \cadenza c'4 }
-  \new Staff {
-    #(ly:export (mmrest-of-length cadenza))
-    c'4
-  }
->>
-@end lilypond
-
-
-
-
-@node Contemporary notation
-@section Contemporary notation
-
-In the 20th century, composers have greatly expanded the musical
-vocabulary.  With this expansion, many innovations in musical notation
-have been tried.  The book @q{Music Notation in the 20th century} by
-Kurt Stone gives a comprehensive overview (see @ref{Literature
-list}).
-
-This section describes notation that does
-not fit into traditional notation categories, such as pitches,
-tuplet beams, and articulation.  For contemporary notation
-that fits into traditional notation categories, such as
-microtones, nested tuplet beams, and unusual fermatas, please
-see those sections of the documentation.
-
-@menu
-* Polymetric notation::         
-* Time administration::         
-* Proportional notation (introduction)::  
-* Clusters::                    
-* Special noteheads::           
-* Feathered beams::             
-* Improvisation::               
-* Selecting notation font size::  
-@end menu
-
-
-@node Polymetric notation
-@subsection Polymetric notation
-
-@cindex double time signatures
-@cindex signatures, polymetric
-@cindex polymetric signatures
-@cindex meter, polymetric
-
-Double time signatures are not supported explicitly, but they can be
-faked.  In the next example, the markup for the time signature is
-created with a markup text.  This markup text is inserted in the
-@internalsref{TimeSignature} grob. See also
-@lsr{contemporary,compound-time-signature}.
-
-@lilypond[verbatim,ragged-right]
-% create 2/4 + 5/8
-tsMarkup =\markup {
-  \override #'(baseline-skip . 2) \number {
-    \column { "2" "4" }
-    \vcenter "+"
-    \bracket \column { "5" "8" }
-  }
-}
-
-{
-  \override Staff.TimeSignature #'stencil = #ly:text-interface::print
-  \override Staff.TimeSignature #'text = #tsMarkup
-  \time 3/2
-  c'2 \bar ":" c'4 c'4.
-}
-@end lilypond
-
-Each staff can also have its own time signature.  This is done by
-moving the @internalsref{Timing_translator} to the @internalsref{Staff}
-context.
-
-@example
-\layout @{
-  \context @{ \Score
-     \remove "Timing_translator"
-     \remove "Default_bar_line_engraver"
-  @}
-  \context @{
-    \Staff
-    \consists "Timing_translator"
-    \consists "Default_bar_line_engraver"
-  @}
-
-@}
-@end example
-
-
-Now, each staff has its own time signature.
-@example
-<<
-  \new Staff @{
-    \time 3/4
-    c4 c c | c c c |
-  @}
-  \new Staff @{
-    \time 2/4
-    c4 c | c c | c c
-  @}
-  \new Staff @{
-    \time 3/8
-    c4. c8 c c c4. c8 c c
-  @}
->>
-@end example
-
-@lilypond[quote,ragged-right]
-\layout{
-  \context{
-     \Score
-     \remove "Timing_translator"
-     \remove "Default_bar_line_engraver"
-    }
-  \context{ \Staff
-    \consists "Timing_translator"
-    \consists "Default_bar_line_engraver"
-  }
-}
-
-\relative c' <<
-  \new Staff {
-    \time 3/4
-    c4 c c | c c c |
-  }
-  \new Staff {
-    \time 2/4
-    c4 c | c c | c c
-  }
-  \new Staff {
-    \time 3/8
-    c4. c8 c c c4. c8 c c
-  }
->>
-@end lilypond
-
-
-A different form of polymetric notation is where note lengths have
-different values across staves.
-
-This notation can be created by setting a common time signature for
-each staff but replacing it manually using
-@code{timeSignatureFraction} to the desired fraction.  Then the printed
-durations in each staff are scaled to the common time signature.
-The latter is done with @code{\compressMusic}, which is used similar
-to @code{\times}, but does not create a tuplet bracket. The syntax is
-@example
-\compressMusic #'(@var{numerator} . @var{denominator}) @var{musicexpr}
-@end example
-
-
-
-In this example, music with the time signatures of 3/4, 9/8, and 10/8 are
-used in parallel.  In the second staff, shown durations are multiplied by
-2/3, so that 2/3 * 9/8 = 3/4, and in the third staff, shown durations are
-multiplied by 3/5, so that 3/5 * 10/8 = 3/4.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' { <<
-  \new Staff {
-    \time 3/4
-    c4 c c | c c c |
-  }
-  \new Staff {
-    \time 3/4
-    \set Staff.timeSignatureFraction = #'(9 . 8)
-    \compressMusic #'(2 . 3)
-      \repeat unfold 6 { c8[ c c] }
-  }
-  \new Staff {
-    \time 3/4
-    \set Staff.timeSignatureFraction = #'(10 . 8)
-    \compressMusic #'(3 . 5) {
-      \repeat unfold 2 { c8[ c c] }
-      \repeat unfold 2 { c8[ c] }
-      | c4. c4. \times 2/3 { c8 c c } c4
-    }
-  }
->> }
-@end lilypond
-
-
-
-
-@refbugs
-
-When using different time signatures in parallel, the spacing is
-aligned vertically, but bar lines distort the regular spacing.
-
-
-@node Time administration
-@subsection Time administration
-
-@cindex Time administration
-
-Time is administered by the @internalsref{Time_signature_engraver},
-which usually lives in the @internalsref{Score} context.  The
-bookkeeping deals with the following variables
-
-@table @code
-@item currentBarNumber
-The measure number.
-
-@item measureLength
-The length of the measures in the current time signature.  For a 4/4
-time this is@tie{}1, and for 6/8 it is 3/4.
-
-@item measurePosition
-The point within the measure where we currently are.  This quantity
-is reset to@tie{}0 whenever it exceeds @code{measureLength}.  When that
-happens, @code{currentBarNumber} is incremented.
-
-@item timing
-If set to true, the above variables are updated for every time
-step.  When set to false, the engraver stays in the current measure
-indefinitely.
-@end table
-
-Timing can be changed by setting any of these variables explicitly.
-In the next example, the 4/4 time signature is printed, but
-@code{measureLength} is set to 5/4.  After a while, the measure is
-shortened by 1/8, by setting @code{measurePosition} to 7/8 at 2/4
-in the measure, so the next bar line will fall at 2/4 + 3/8.  The
-3/8 arises because 5/4 normally has 10/8, but we have manually
-set the measure position to be 7/8 and 10/8 - 7/8 = 3/8.
-
-@lilypond[quote,ragged-right,verbatim,relative,fragment]
-\set Score.measureLength = #(ly:make-moment 5 4)
-c1 c4
-c1 c4
-c4 c4
-\set Score.measurePosition = #(ly:make-moment 7 8)
-b8 b b
-c4 c1
-@end lilypond
-
-@noindent
-As the example illustrates, @code{ly:make-moment n m} constructs a
-duration of n/m of a whole note.  For example, @code{ly:make-moment 1 8} is
-an eighth
-note duration and @code{ly:make-moment 7 16} is the duration of
-seven sixteenths notes.
-
-
-@node Proportional notation (introduction)
-@subsection Proportional notation (introduction)
-@cindex Proportional notation
-
-See @ref{Proportional notation}.
-
-
-TODO: remove all this stuff?
-
-Notes can be spaced proportionally to their time-difference by
-assigning a duration to @code{proportionalNotationDuration}
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-<<
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 16)
-  \new Staff { c8[ c c c c c]  c4 c2 r2 }
-  \new Staff { c2  \times 2/3 { c8 c c } c4 c1 }
->>
-@end lilypond
-
-Setting this property only affects the ideal spacing between
-consecutive notes.  For true proportional notation, the following
-settings are also required.
-
-@itemize @bullet
-
-@item True proportional notation requires that symbols are allowed to
-overstrike each other.  That is achieved by removing the
-@internalsref{Separating_line_group_engraver} from
-@internalsref{Staff} context.
-
-@item Spacing influence of  prefatory matter (clefs, bar lines, etc.)
-is removed by setting the @code{strict-note-spacing} property to
-@code{#t} in @internalsref{SpacingSpanner} grob.
-
-@item Optical spacing tweaks are switched by setting 
-@code{uniform-stretching} in @internalsref{SpacingSpanner} to true.
-
-
-@end itemize
-
-@seealso
-
-Examples: @lsr{spacing,proportional@/-spacing@/.ly}, 
-@lsr{spacing,proportional@/-strict@/-grace@/-notes@/.ly}, and
-@lsr{spacing,proportional@/-strict@/-notespacing@/.ly}
-
-An example of strict proportional notation is in the
-example file @file{input/proportional.ly}.
-
-
-@node Clusters
-@subsection Clusters
-
-@cindex cluster
-
-A cluster indicates a continuous range of pitches to be played.  They
-can be denoted as the envelope of a set of notes.  They are entered by
-applying the function @code{makeClusters} to a sequence of
-chords, e.g.,
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-\makeClusters { <c e > <b f'> }
-@end lilypond
-
-Ordinary notes and clusters can be put together in the same staff,
-even simultaneously.  In such a case no attempt is made to
-automatically avoid collisions between ordinary notes and clusters.
-
-@seealso
-
-Program reference: @internalsref{ClusterSpanner},
-@internalsref{ClusterSpannerBeacon},
-@internalsref{Cluster_spanner_engraver}.
-
-Examples: @lsr{contemporary,cluster@/.ly}.
-
-@refbugs
-
-Music expressions like @code{<< @{ g8 e8 @} a4 >>} are not printed
-accurately.  Use @code{<g a>8 <e a>8} instead.
-
-
-@node Special noteheads
-@subsection Special noteheads
-
-@cindex note heads, special
-
-Different noteheads are used by various instruments for various
-meanings -- crosses are used for @q{parlato} with vocalists, stopped
-notes on guitar; diamonds are used for harmonics on string instruments,
-etc.  There is a shorthand (@code{\harmonic}) for diamond shapes; the
-other notehead styles are produced by tweaking the property
-
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-c4 d
-\override NoteHead #'style = #'cross
-e f
-\revert NoteHead #'style
-e d <c f\harmonic> <d a'\harmonic>
-@end lilypond
-
-@noindent
-To see all notehead styles, please see
-@ref{Note head styles}.
-
-
-@seealso
-
-Program reference: @internalsref{NoteHead}.
-
-
-@node Feathered beams
-@subsection Feathered beams
-
-Feathered beams are printed by setting the @code{grow-direction}
-property of a @code{Beam}.  The @code{\featherDurations} function
-can be used to adjust note durations.
-
-@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
-\override Beam #'grow-direction = #LEFT
-\featherDurations #(ly:make-moment 5 4) 
-{
-  c16[ c c c c c c]
-}
-@end lilypond
-
-@refbugs
-
-The @code{\featherDurations} command only works with very short
-music snippets.
-
-@node Improvisation
-@subsection Improvisation
-
-Improvisation is sometimes denoted with slashed note heads.  Such note
-heads can be created by adding a @internalsref{Pitch_squash_engraver}
-to the @internalsref{Voice} context.  Then, the
-following command
-
-@example
-\set squashedPosition = #0
-\override NoteHead #'style = #'slash
-@end example
-
-@noindent
-switches on the slashes.
-
-There are shortcuts @code{\improvisationOn} (and an accompanying
-@code{\improvisationOff}) for this command sequence.  They are used in
-the following example
-
-@lilypond[verbatim,ragged-right,quote]
-\new Voice \with {
-  \consists Pitch_squash_engraver
-} \transpose c c' {
-  e8 e g a a16(bes)(a8) g \improvisationOn
-  e8
-  ~e2~e8 f4 fis8
-  ~fis2 \improvisationOff a16(bes) a8 g e
-}
-@end lilypond
-
-
-@node Selecting notation font size
-@subsection Selecting notation font size
-
-The easiest method of setting the font size of any context is by
-setting the @code{fontSize} property.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g
-@end lilypond
-
-@noindent
-It does not change the size of variable symbols, such as beams or
-slurs.
-
-Internally, the @code{fontSize} context property will cause the
-@code{font-size} property to be set in all layout objects.  The value
-of @code{font-size} is a number indicating the size relative to the
-standard size for the current staff height.  Each step up is an
-increase of approximately 12% of the font size.  Six steps is exactly a
-factor two.  The Scheme function @code{magstep} converts a
-@code{font-size} number to a scaling factor.  The @code{font-size}
-property can also be set directly, so that only certain layout objects are
-affected.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g
-@end lilypond
-
-Font size changes are achieved by scaling the design size that is
-closest to the desired size.  The standard font size (for
-@code{font-size} equals 0), depends on the standard staff height.  For
-a 20pt staff, a 10pt font is selected.
-
-The @code{font-size} property can only be set on layout objects that
-use fonts. These are the ones supporting the
-@internalsref{font-interface} layout interface.
-
-@refcommands
-
-The following commands set @code{fontSize} for the current voice:
-
-@funindex \tiny
-@code{\tiny},
-@funindex \small
-@code{\small},
-@funindex \normalsize
-@code{\normalsize}.
-
-
-
-@node Educational use
-@section Educational use
-
-With the amount of control that LilyPond offers, one can make great
-teaching tools in addition to great musical scores.
-
-@menu
-* Balloon help::                
-* Blank music sheet::           
-* Hidden notes::                
-* Shape note heads::            
-* Easy Notation note heads::    
-* Analysis brackets::           
-* Coloring objects::            
-* Parentheses::                 
-* Grid lines::                  
-@end menu
-
-@node Balloon help
-@subsection Balloon help
-
-Elements of notation can be marked and named with the help of a square
-balloon.  The primary purpose of this feature is to explain notation.
-
-The following example demonstrates its use.
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice \with { \consists "Balloon_engraver" }
-{
-  \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
-  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
-}
-@end lilypond
-
-@noindent
-There are two music functions, @code{balloonText} and
-@code{balloonGrobText}. The latter takes the name of the grob to
-adorn, while the former may be used as an articulation on a note. 
-The other arguments  are the offset and the text of the label.
-
-@cindex balloon
-@cindex notation, explaining
-
-@seealso
-
-Program reference: @internalsref{text-balloon-interface}.
-
-
-
-
-@node Blank music sheet
-@subsection Blank music sheet
-
-@cindex Sheet music, empty
-@cindex Staves, blank sheet
-
-A blank music sheet can be produced also by using invisible notes, and
-removing @code{Bar_number_engraver}.
-
-
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
-  \repeat unfold 2 % Change this for more lines.
-  { s1\break }
-  \bar "|."
-}
-\new Score \with {
-  \override TimeSignature #'transparent = ##t
-% un-comment this line if desired
-%  \override Clef #'transparent = ##t
-  defaultBarType = #""
-  \remove Bar_number_engraver
-} <<
-
-% modify these to get the staves you want
-  \new Staff \emptymusic
-  \new TabStaff \emptymusic
->>
-@end lilypond
-
-
-@node Hidden notes
-@subsection Hidden notes
-
-@cindex Hidden notes
-@cindex Invisible notes
-@cindex Transparent notes
-
-@funindex \hideNotes
-@funindex \unHideNotes
-Hidden (or invisible or transparent) notes can be useful in preparing theory
-or composition exercises.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-c4 d4
-\hideNotes
-e4 f4
-\unHideNotes
-g4 a
-@end lilypond
-
-
-@node Shape note heads
-@subsection Shape note heads
-
-@cindex note heads, shape
-
-In shape note head notation, the shape of the note head corresponds
-to the harmonic function of a note in the scale.  This notation was
-popular in the 19th century American song books.
-
-Shape note heads can be produced by setting @code{\aikenHeads} or
-@code{\sacredHarpHeads}, depending on the style desired.
-
-@lilypond[verbatim,relative=1,fragment]
-  \aikenHeads
-  c8 d4 e8 a2 g1
-  \sacredHarpHeads
-  c8 d4. e8 a2 g1
-@end lilypond
-
-Shapes are determined on the step in the scale, where the base of the
-scale is determined by  the @code{\key} command
-
-@funindex \key
-@funindex shapeNoteStyles
-@funindex \aikenHeads
-@funindex \sacredHarpHeads
-
-Shape note heads are implemented through the @code{shapeNoteStyles}
-property.  Its value is a vector of symbols.  The k-th element indicates
-the style to use for the k-th step of the scale.  Arbitrary
-combinations are possible, e.g.
-
-@lilypond[verbatim,relative=1,fragment]
-  \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
-  c8 d4. e8 a2 g1
-@end lilypond
-
-
-@node Easy Notation note heads
-@subsection Easy Notation note heads
-
-@cindex note heads, practice
-@cindex note heads, easy notation
-@cindex easy notation
-@cindex Hal Leonard
-
-The @q{easy play} note head includes a note name inside the head.  It is
-used in music for beginners
-
-@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
-  \setEasyHeads
-  c'2 e'4 f' | g'1
-@end lilypond
-
-The command @code{\setEasyHeads} overrides settings for the
-@internalsref{NoteHead} object.  To make the letters readable, it has
-to be printed in a large font size.  To print with a larger font, see
-@ref{Setting the staff size}.
-
-@refcommands
-
-@funindex \setEasyHeads
-@code{\setEasyHeads}
-
-
-@node Analysis brackets
-@subsection Analysis brackets
-@cindex brackets
-@cindex phrasing brackets
-@cindex musicological analysis
-@cindex note grouping bracket
-
-Brackets are used in musical analysis to indicate structure in musical
-pieces.  LilyPond supports a simple form of nested horizontal
-brackets.  To use this, add the @internalsref{Horizontal_bracket_engraver}
-to @internalsref{Staff} context.  A bracket is started with
-@code{\startGroup} and closed with @code{\stopGroup}
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    c4\startGroup\startGroup
-    c4\stopGroup
-    c4\startGroup
-    c4\stopGroup\stopGroup
-  }
-  \layout {
-    \context {
-      \Staff \consists "Horizontal_bracket_engraver"
-}}}
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{HorizontalBracket}.
-
-
-@node Coloring objects
-@subsection Coloring objects
-
-Individual objects may be assigned colors.  You may use the
-color names listed in the @ref{List of colors}.
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\override NoteHead #'color = #red
-c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
-d
-\override Stem #'color = #blue
-e
-@end lilypond
-
-The full range of colors defined for X11 can be accessed by using the
-Scheme function x11-color.  The function takes one argument that can be a
-symbol
-
-@example
-\override Beam #'color = #(x11-color 'MediumTurquoise)
-@end example
-
-or a string
-
-@example
-\override Beam #'color = #(x11-color "MediumTurquoise")
-@end example
-
-The first form is quicker to write and is more efficient.  However, using
-the second form it is possible to access X11 colors by the multi-word
-form of its name
-
-@example
-\override Beam #'color = #(x11-color "medium turquoise")
-@end example
-
-If x11-color cannot make sense of the parameter then the color returned
-defaults to black.  It should be obvious from the final score that
-something is wrong.
-
-This example illustrates the use of x11-color.  Notice that the stem
-color remains black after being set to (x11-color 'Boggle), which is
-deliberate nonsense.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
-  \set Staff.instrumentName = \markup {
-    \with-color #(x11-color 'navy) "Clarinet"
-  }
-  \time 2/4
-  gis''8 a''
-  \override Beam #'color = #(x11-color "medium turquoise")
-  gis'' a''
-  \override NoteHead #'color = #(x11-color "LimeGreen")
-  gis'' a''
-  \override Stem #'color = #(x11-color 'Boggle)
-  gis'' a''
-}
-@end lilypond
-
-
-@seealso
-
-Appendix: @ref{List of colors}.
-
-
-@refbugs
-Not all x11 colors are distinguishable in a web browser.  For web use
-normal colors are recommended.
-
-An x11 color is not necessarily exactly the same shade as a similarly
-named normal color.
-
-Notes in a chord cannot be colored with @code{\override}; use
-@code{\tweak} instead.  See @ref{Objects connected to the input},
-for details.
-
-
-@node Parentheses
-@subsection Parentheses
-
-@cindex ghost notes
-@cindex notes, ghost
-@cindex notes, parenthesized
-
-Objects may be parenthesized by prefixing @code{\parenthesize} to the music
-event,
-
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
-  c
-  \parenthesize d
-  g
->4-\parenthesize -.
-@end lilypond
-
-This only functions inside chords, even for single notes
-
-@example
-< \parenthesize NOTE>
-@end example
-
-
-@node Grid lines
-@subsection Grid lines
-
-Vertical lines can be drawn between staves synchronized with
-the notes.
-
-@lilypond[ragged-right,quote,verbatim]
-\layout {
-  \context {
-    \Staff
-    \consists "Grid_point_engraver" %% sets of grid
-    gridInterval = #(ly:make-moment 1 4)
-  }
-}
-
-\new Score \with {
-  \consists "Grid_line_span_engraver"
-  %% centers grid lines  horizontally below noteheads
-  \override NoteColumn #'X-offset = #-0.5
-}
-
-\new ChoirStaff <<
-  \new Staff {
-    \stemUp
-    \relative {
-      c'4. d8 e8 f g4
-    }
-  }
-  \new Staff {
-    %% centers grid lines  vertically
-    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
-    \stemDown
-    \clef bass
-    \relative c {
-      c4  g'  f  e
-    }
-  }
->>
-@end lilypond
-
-Examples: @lsrdir{education}
-
-
diff --git a/Documentation/user/ancient.itely b/Documentation/user/ancient.itely
new file mode 100644
index 0000000000..35eaeb3ce1
--- /dev/null
+++ b/Documentation/user/ancient.itely
@@ -0,0 +1,2214 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Ancient notation
+@section Ancient notation
+
+@cindex Vaticana, Editio
+@cindex Medicaea, Editio
+@cindex hufnagel
+@cindex Petrucci
+@cindex mensural
+
+Support for ancient notation includes features for mensural notation
+and Gregorian Chant notation.  There is also limited support for
+figured bass notation.
+
+Many graphical objects provide a @code{style} property, see
+@itemize
+@item
+@ref{Ancient note heads},
+@item
+@ref{Ancient accidentals},
+@item
+@ref{Ancient rests},
+@item
+@ref{Ancient clefs},
+@item
+@ref{Ancient flags},
+@item
+@ref{Ancient time signatures}.
+@end itemize
+
+By manipulating such a grob property, the typographical appearance of
+the affected graphical objects can be accommodated for a specific
+notation flavor without the need for introducing any new notational
+concept.
+
+In addition to the standard articulation signs described in
+section @ref{Articulations and ornamentations}, specific
+articulation signs for ancient notation are provided.
+
+@itemize
+@item
+@ref{Ancient articulations}
+@end itemize
+
+Other aspects of ancient notation can not that easily be expressed
+in terms of just changing a style property of a graphical object or
+adding articulation signs.  Some notational concepts are introduced
+specifically for ancient notation,
+
+@itemize
+@item
+@ref{Custodes},
+@item
+@ref{Divisiones},
+@item
+@ref{Ligatures}.
+@end itemize
+
+If this all is too much of documentation for you, and you just want to
+dive into typesetting without worrying too much about the details on
+how to customize a context, you may have a look at the predefined
+contexts.  Use them to set up predefined style-specific voice and
+staff contexts, and directly go ahead with the note entry,
+
+@itemize
+@item
+@ref{Gregorian Chant contexts},
+@item
+@ref{Mensural contexts}.
+@end itemize
+
+There is limited support for figured bass notation which came
+up during the baroque period.
+
+@itemize
+@item
+@ref{Figured bass}
+@end itemize
+
+Here are all subtopics at a glance:
+
+@menu
+* Ancient TODO::                
+@end menu
+
+@node Ancient TODO
+@subsection Ancient TODO
+
+
+
+@menu
+* Ancient note heads::          
+* Ancient accidentals::         
+* Ancient rests::               
+* Ancient clefs::               
+* Ancient flags::               
+* Ancient time signatures::     
+* Ancient articulations::       
+* Custodes::                    
+* Divisiones::                  
+* Ligatures::                   
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+* Gregorian Chant contexts::    
+* Mensural contexts::           
+* Musica ficta accidentals::    
+* Figured bass::                
+@end menu
+
+@node Ancient note heads
+@unnumberedsubsubsec Ancient note heads
+
+@cindex note heads, ancient
+
+For ancient notation, a note head style other than the @code{default}
+style may be chosen.  This is accomplished by setting the @code{style}
+property of the @internalsref{NoteHead} object to @code{baroque},
+@code{neomensural}, @code{mensural} or @code{petrucci}.  The
+@code{baroque} style differs from the @code{default} style only in
+using a square shape for @code{\breve} note heads.  The
+@code{neomensural} style differs from the @code{baroque} style in that
+it uses rhomboidal heads for whole notes and all smaller durations.
+Stems are centered on the note heads.  This style is particularly
+useful when transcribing mensural music, e.g., for the incipit.  The
+@code{mensural} style produces note heads that mimic the look of note
+heads in historic printings of the 16th century.  Finally, the
+@code{petrucci} style also mimicks historic printings, but uses bigger
+note heads.
+
+The following example demonstrates the @code{neomensural} style
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override NoteHead #'style = #'neomensural
+a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
+@end lilypond
+
+When typesetting a piece in Gregorian Chant notation, the
+@internalsref{Gregorian_ligature_engraver} will automatically select
+the proper note heads, so there is no need to explicitly set the
+note head style.  Still, the note head style can be set, e.g., to
+@code{vaticana_punctum} to produce punctum neumes.  Similarly, a
+@internalsref{Mensural_ligature_engraver} is used to automatically
+assemble mensural ligatures.  See @ref{Ligatures}, for how ligature
+engravers work.
+
+@seealso
+
+@ref{Note head styles}, gives an overview over all available note head styles.
+
+
+@node Ancient accidentals
+@unnumberedsubsubsec Ancient accidentals
+
+@cindex accidentals
+
+
+Use the @code{glyph-name-alist} property of grob
+@internalsref{Accidental} and @internalsref{KeySignature} to select
+ancient accidentals. 
+
+@lilypond[quote,ragged-right,staffsize=26]
+\score {
+{
+  \fatText
+  s^\markup {
+    \column {
+      "vaticana"
+      \line { " " \musicglyph #"accidentals.vaticana-1"
+        " " \musicglyph #"accidentals.vaticana0" }
+    }
+    \column {
+      "medicaea"
+      \line { " " \musicglyph #"accidentals.medicaea-1" }
+    }
+    \column {
+      "hufnagel"
+      \line { " " \musicglyph #"accidentals.hufnagel-1" }
+    }
+    \column {
+      "mensural"
+      \line { " " \musicglyph #"accidentals.mensural-1"
+        " " \musicglyph #"accidentals.mensural1" }
+    }
+  }
+}
+\layout {
+  interscoreline = 1
+  \context { \Score \remove "Bar_number_engraver" }
+  \context { \Staff
+      \remove "Clef_engraver"
+      \remove "Key_engraver"
+      \remove "Time_signature_engraver"
+      \remove "Staff_symbol_engraver"
+      \override VerticalAxisGroup #'minimum-Y-extent = ##f
+    }
+  }
+}
+@end lilypond
+
+As shown, not all accidentals are supported by each style.  When
+trying to access an unsupported accidental, LilyPond will switch to a
+different style, as demonstrated in
+@lsr{ancient,ancient-accidentals.ly}.
+
+Similarly to local accidentals, the style of the key signature can be
+controlled by the @code{glyph-name-alist} property of the
+@internalsref{KeySignature} grob.
+
+@seealso
+
+In this manual: @ref{Pitches}, @ref{Accidentals}, and
+@ref{Automatic accidentals}, give a general introduction of the use of
+accidentals.  @ref{Key signature}, gives a general introduction of
+the use of key signatures.
+
+Program reference: @internalsref{KeySignature}.
+
+Examples: @lsrdir{ancient}
+
+@node Ancient rests
+@unnumberedsubsubsec Ancient rests
+
+@cindex rests, ancient
+
+
+Use the @code{style} property of grob @internalsref{Rest} to select
+ancient rests.   Supported styles are @code{classical},
+@code{neomensural}, and @code{mensural}.  @code{classical} differs
+from the @code{default} style only in that the quarter rest looks like
+a horizontally mirrored 8th rest.  The @code{neomensural} style suits
+well for, e.g., the incipit of a transcribed mensural piece of music.
+The @code{mensural} style finally mimics the appearance of rests as
+in historic prints of the 16th century.
+
+The following example demonstrates the @code{neomensural} style
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\set Score.skipBars = ##t
+\override Rest #'style = #'neomensural
+r\longa r\breve r1 r2 r4 r8 r16
+@end lilypond
+
+There are no 32th and 64th rests specifically for the mensural or
+neo-mensural style.  Instead, the rests from the default style will be
+taken.  See @lsr{pitches,rests} for a chart of all rests.
+
+There are no rests in Gregorian Chant notation; instead, it uses
+@ref{Divisiones}.
+
+@seealso
+
+In this manual: @ref{Rests}, gives a general introduction into the use of
+rests.
+
+
+@node Ancient clefs
+@unnumberedsubsubsec Ancient clefs
+
+@cindex clefs
+
+
+LilyPond supports a variety of clefs, many of them ancient.
+
+The following table shows all ancient clefs that are supported via the
+@code{\clef} command.  Some of the clefs use the same glyph, but
+differ only with respect to the line they are printed on.  In such
+cases, a trailing number in the name is used to enumerate these clefs.
+Still, you can manually force a clef glyph to be typeset on an
+arbitrary line, as described in @ref{Clef}.  The note printed to the
+right side of each clef in the example column denotes the @code{c'}
+with respect to that clef.
+
+@multitable @columnfractions .4 .4 .2
+@item
+@b{Description}
+@tab
+@b{Supported Clefs}
+@tab
+@b{Example}
+
+@item
+modern style mensural C clef
+@tab
+@code{neomensural-c1}, @code{neomensural-c2},@*
+@code{neomensural-c3}, @code{neomensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "neomensural-c2" c
+@end lilypond
+
+@item
+petrucci style mensural C clefs, for use on different staff lines
+(the examples show the 2nd staff line C clef)
+@tab
+@code{petrucci-c1}, @code{petrucci-c2},@*
+@code{petrucci-c3}, @code{petrucci-c4},@*
+@code{petrucci-c5}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+petrucci style mensural F clef
+@tab
+@code{petrucci-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+petrucci style mensural G clef
+@tab
+@code{petrucci-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "petrucci-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+historic style mensural C clef
+@tab
+@code{mensural-c1}, @code{mensural-c2},@*
+@code{mensural-c3}, @code{mensural-c4}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-c2"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+historic style mensural F clef
+@tab
+@code{mensural-f}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-f"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+historic style mensural G clef
+@tab
+@code{mensural-g}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \clef "mensural-g"
+  \override NoteHead #'style = #'mensural
+  c
+@end lilypond
+
+@item
+Editio Vaticana style do clef
+@tab
+@code{vaticana-do1}, @code{vaticana-do2},@*
+@code{vaticana-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-do2"
+  c
+@end lilypond
+
+@item
+Editio Vaticana style fa clef
+@tab
+@code{vaticana-fa1}, @code{vaticana-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-fa2"
+  c
+@end lilypond
+
+@item
+Editio Medicaea style do clef
+@tab
+@code{medicaea-do1}, @code{medicaea-do2},@*
+@code{medicaea-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-do2"
+  c
+@end lilypond
+
+@item
+Editio Medicaea style fa clef
+@tab
+@code{medicaea-fa1}, @code{medicaea-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-fa2"
+  c
+@end lilypond
+
+@item
+historic style hufnagel do clef
+@tab
+@code{hufnagel-do1}, @code{hufnagel-do2},@*
+@code{hufnagel-do3}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do2"
+  c
+@end lilypond
+
+@item
+historic style hufnagel fa clef
+@tab
+@code{hufnagel-fa1}, @code{hufnagel-fa2}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'line-count = #4
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-fa2"
+  c
+@end lilypond
+
+@item
+historic style hufnagel combined do/fa clef
+@tab
+@code{hufnagel-do-fa}
+@tab
+@lilypond[fragment,relative=1,notime]
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do-fa"
+  c
+@end lilypond
+@end multitable
+
+
+
+@emph{Modern style} means @qq{as is typeset in contemporary editions of
+transcribed mensural music.}
+
+@emph{Petrucci style} means @qq{inspired by printings published by the
+famous engraver Petrucci (1466-1539).}
+
+@emph{Historic style} means @qq{as was typeset or written in historic
+editions (other than those of Petrucci).}
+
+@emph{Editio XXX style} means @qq{as is/was printed in Editio XXX.}
+
+Petrucci used C clefs with differently balanced left-side vertical
+beams, depending on which staff line it is printed.
+
+@seealso
+
+In this manual: see @ref{Clef}.
+
+@refbugs
+
+The mensural g clef is mapped to the Petrucci g clef.
+
+
+
+@node Ancient flags
+@unnumberedsubsubsec Ancient flags
+
+@cindex flags
+
+
+Use the @code{flag-style} property of grob @internalsref{Stem} to
+select ancient flags.  Besides the @code{default} flag style,
+only the @code{mensural} style is supported
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\override Stem #'flag-style = #'mensural
+\override Stem #'thickness = #1.0
+\override NoteHead #'style = #'mensural
+\autoBeamOff
+c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
+c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
+@end lilypond
+
+Note that the innermost flare of each mensural flag always is
+vertically aligned with a staff line.
+
+There is no particular flag style for neo-mensural notation.  Hence,
+when typesetting the incipit of a transcribed piece of mensural
+music, the default flag style should be used.  There are no flags in
+Gregorian Chant notation.
+
+@refbugs
+
+The attachment of ancient flags to stems is slightly off due to a
+change in early 2.3.x.
+
+Vertically aligning each flag with a staff line assumes that stems
+always end either exactly on or exactly in the middle between two
+staff lines.  This may not always be true when using advanced layout
+features of classical notation (which however are typically out of
+scope for mensural notation).
+
+@node Ancient time signatures
+@unnumberedsubsubsec Ancient time signatures
+
+@cindex time signatures
+
+
+There is limited support for mensural time signatures.   The
+glyphs are hard-wired to particular time fractions.  In other words,
+to get a particular mensural signature glyph with the @code{\time n/m}
+command, @code{n} and @code{m} have to be chosen according to the
+following table
+
+@lilypond[quote,ragged-right]
+\layout {
+  indent = 0.0
+  \context {
+    \Staff
+    \remove Staff_symbol_engraver
+    \remove Clef_engraver
+    \remove Time_signature_engraver
+  }
+}
+{
+  \set Score.timing = ##f
+  \set Score.barAlways = ##t
+  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural44" }
+  s
+  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural22" }
+  s
+  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural64" }
+  s
+  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural68" }
+  \break
+  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural32" }
+  s
+  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural34" }
+  s
+  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural94" }
+  s
+  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural98" }
+  \break
+  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural48" }
+  s
+  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural24" }
+}
+@end lilypond
+
+Use the @code{style} property of grob @internalsref{TimeSignature} to
+select ancient time signatures.  Supported styles are
+@code{neomensural} and @code{mensural}.  The above table uses the
+@code{neomensural} style.  This style is appropriate for the
+incipit of transcriptions of mensural pieces.  The @code{mensural}
+style mimics the look of historical printings of the 16th century.
+
+The following examples show the differences in style,
+
+@lilypond[ragged-right,fragment,relative=1,quote]
+{
+  \fatText
+
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter default }
+
+  \override Staff.TimeSignature #'style = #'numbered
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter numbered }
+
+  \override Staff.TimeSignature #'style = #'mensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter mensural }
+
+  \override Staff.TimeSignature #'style = #'neomensural
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter neomensural }
+  \override Staff.TimeSignature #'style = #'single-digit
+  \time 2/2
+  c1^\markup { \hspace #-2.0 \typewriter single-digit }
+}
+@end lilypond
+
+@seealso
+
+This manual: @ref{Time signature}, gives a general introduction to
+the use of time signatures.
+
+@refbugs
+
+Ratios of note durations do not change with the time signature.  For
+example, the ratio of 1 brevis = 3 semibrevis (tempus perfectum) must
+be made by hand, by setting
+
+@example
+breveTP = #(ly:make-duration -1 0 3 2)
+@dots{}
+@{ c\breveTP f1 @}
+@end example
+
+@noindent
+This sets @code{breveTP} to 3/2 times 2 = 3 times a whole note.
+
+The @code{old6/8alt} symbol (an alternate symbol for 6/8) is not
+addressable with @code{\time}.  Use a @code{\markup} instead
+
+@node Ancient articulations
+@unnumberedsubsubsec Ancient articulations
+
+@cindex articulations
+
+In addition to the standard articulation signs described in
+section @ref{Articulations and ornamentations}, articulation signs
+for ancient notation are provided.  These are specifically
+designed for use with notation in Editio Vaticana style.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \override TextScript #'font-family = #'typewriter
+    \override TextScript #'font-shape = #'upright
+    \override Script #'padding = #-0.1
+    a\ictus_"ictus" \break
+    a\circulus_"circulus" \break
+    a\semicirculus_"semicirculus" \break
+    a\accentus_"accentus" \break
+    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
+  }
+}
+@end lilypond
+
+@refbugs
+
+Some articulations are vertically placed too closely to the
+corresponding note heads.
+
+The episem line is not displayed in many cases.  If it is displayed,
+the right end of the episem line is often too far to the right.
+
+@node Custodes
+@unnumberedsubsubsec Custodes
+
+@cindex custos
+@cindex custodes
+
+A @emph{custos} (plural: @emph{custodes}; Latin word for @q{guard}) is a
+symbol that appears at the end of a staff.  It anticipates the pitch
+of the first note(s) of the following line thus helping the performer
+to manage line breaks during performance.
+
+Custodes were frequently used in music notation until the 17th
+century.  Nowadays, they have survived only in a few particular forms
+of musical notation such as contemporary editions of Gregorian chant
+like the @emph{editio vaticana}.  There are different custos glyphs
+used in different flavors of notational style.
+
+For typesetting custodes, just put a @internalsref{Custos_engraver} into the
+@internalsref{Staff} context when declaring the @code{\layout} block,
+as shown in the following example
+
+@example
+\layout @{
+  \context @{
+    \Staff
+    \consists Custos_engraver
+    Custos \override #'style = #'mensural
+  @}
+@}
+@end example
+
+The result looks like this
+
+@lilypond[quote,ragged-right]
+\score {
+{
+  a'1
+  \override Staff.Custos #'style = #'mensural
+  \break
+  g'
+}
+\layout {
+  \context { \Staff \consists Custos_engraver }
+  }
+}
+@end lilypond
+
+The custos glyph is selected by the @code{style} property.  The styles
+supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
+@code{mensural}.  They are demonstrated in the following fragment
+
+@lilypond[quote,ragged-right,fragment]
+\new Lyrics \lyricmode {
+  \markup { \column {
+    \typewriter "vaticana"
+    \line { " " \musicglyph #"custodes.vaticana.u0" }
+  } }
+  \markup { \column {
+    \typewriter "medicaea"
+    \line { " " \musicglyph #"custodes.medicaea.u0" }
+  }}
+  \markup { \column {
+    \typewriter "hufnagel"
+    \line { " " \musicglyph #"custodes.hufnagel.u0" }
+  }}
+  \markup { \column {
+    \typewriter "mensural"
+    \line { " " \musicglyph #"custodes.mensural.u0" }
+  }}
+}
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{Custos}.
+
+Examples:
+@lsr{ancient,custodes@/.ly}.
+
+
+@node Divisiones
+@unnumberedsubsubsec Divisiones
+
+@cindex divisio
+@cindex divisiones
+@cindex finalis
+
+A @emph{divisio} (plural: @emph{divisiones}; Latin word for
+@q{division}) is a staff context symbol that is used to structure
+Gregorian music into phrases and sections.  The musical meaning of
+@emph{divisio minima}, @emph{divisio maior}, and @emph{divisio maxima}
+can be characterized as short, medium, and long pause, somewhat like
+the breathmarks from @ref{Breath marks}.  The @emph{finalis} sign not
+only marks the end of a chant, but is also frequently used within a
+single antiphonal/responsorial chant to mark the end of each section.
+
+
+To use divisiones, include the file @file{gregorian@/-init@/.ly}.  It
+contains definitions that you can apply by just inserting
+@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima},
+and @code{\finalis} at proper places in the input.  Some editions use
+@emph{virgula} or @emph{caesura} instead of divisio minima.
+Therefore, @file{gregorian@/-init@/.ly} also defines @code{\virgula} and
+@code{\caesura}
+
+@lilypondfile[quote,ragged-right]{divisiones.ly}
+
+@refcommands
+
+@funindex \virgula
+@code{\virgula},
+@funindex \caesura
+@code{\caesura},
+@funindex \divisioMinima
+@code{\divisioMinima},
+@funindex \divisioMaior
+@code{\divisioMaior},
+@funindex \divisioMaxima
+@code{\divisioMaxima},
+@funindex \finalis
+@code{\finalis}.
+
+@seealso
+
+In this manual: @ref{Breath marks}.
+
+Program reference: @internalsref{BreathingSign}.
+
+Examples: @lsr{expressive,breathing-sign.ly}.
+
+
+@node Ligatures
+@unnumberedsubsubsec Ligatures
+
+@cindex Ligatures
+
+@c TODO: Should double check if I recalled things correctly when I wrote
+@c down the following paragraph by heart.
+
+A ligature is a graphical symbol that represents at least two distinct
+notes.  Ligatures originally appeared in the manuscripts of Gregorian
+chant notation to denote ascending or descending sequences of notes.
+
+Ligatures are entered by enclosing them in @code{\[} and @code{\]}.
+Some ligature styles may need additional input syntax specific for
+this particular type of ligature.  By default, the
+@internalsref{LigatureBracket} engraver just puts a square bracket
+above the ligature
+
+@lilypond[quote,ragged-right,verbatim]
+\transpose c c' {
+  \[ g c a f d' \]
+  a g f
+  \[ e f a g \]
+}
+@end lilypond
+
+To select a specific style of ligatures, a proper ligature engraver
+has to be added to the @internalsref{Voice} context, as explained in
+the following subsections.   Only white mensural ligatures
+are supported with certain limitations.
+
+
+
+@refbugs
+
+Ligatures need special spacing that has not yet been implemented.  As
+a result, there is too much space between ligatures most of the time,
+and line breaking often is unsatisfactory.  Also, lyrics do not
+correctly align with ligatures.
+
+Accidentals must not be printed within a ligature, but instead need to
+be collected and printed in front of it.
+
+The syntax still uses the deprecated infix style @code{\[ music expr
+\]}.  For consistency reasons, it will eventually be changed to
+postfix style @code{note\[ ... note\]}.  Alternatively, the file
+@file{gregorian@/-init@/.ly} can be included; it provides a scheme
+function
+@example
+\ligature @var{music expr}
+@end example
+with the same effect and is believed to be stable.
+
+@menu
+* White mensural ligatures::    
+* Gregorian square neumes ligatures::  
+@end menu
+
+@node White mensural ligatures
+@unnumberedsubsubsec White mensural ligatures
+
+@cindex Mensural ligatures
+@cindex White mensural ligatures
+
+There is limited support for white mensural ligatures.
+
+To engrave white mensural ligatures, in the layout block put the
+@internalsref{Mensural_ligature_engraver} into the
+@internalsref{Voice} context, and remove the
+@internalsref{Ligature_bracket_engraver}, like this
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \remove Ligature_bracket_engraver
+    \consists Mensural_ligature_engraver
+  @}
+@}
+@end example
+
+There is no additional input language to describe the shape of a
+white mensural ligature.  The shape is rather determined solely from
+the pitch and duration of the enclosed notes.  While this approach may
+take a new user a while to get accustomed to, it has the great advantage
+that the full musical information of the ligature is known internally.
+This is not only required for correct MIDI output, but also allows for
+automatic transcription of the ligatures.
+
+For example,
+
+@example
+\set Score.timing = ##f
+\set Score.defaultBarType = "empty"
+\override NoteHead #'style = #'neomensural
+\override Staff.TimeSignature #'style = #'neomensural
+\clef "petrucci-g"
+\[ c'\maxima g \]
+\[ d\longa c\breve f e d \]
+\[ c'\maxima d'\longa \]
+\[ e'1 a g\breve \]
+@end example
+@lilypond[quote,ragged-right]
+\score {
+  \transpose c c' {
+    \set Score.timing = ##f
+    \set Score.defaultBarType = "empty"
+    \override NoteHead #'style = #'neomensural
+    \override Staff.TimeSignature #'style = #'neomensural
+    \clef "petrucci-g"
+    \[ c'\maxima g \]
+    \[ d\longa c\breve f e d \]
+    \[ c'\maxima d'\longa \]
+    \[ e'1 a g\breve \]
+  }
+  \layout {
+    \context {
+      \Voice
+      \remove Ligature_bracket_engraver
+      \consists Mensural_ligature_engraver
+    }
+  }
+}
+@end lilypond
+
+Without replacing @internalsref{Ligature_bracket_engraver} with
+@internalsref{Mensural_ligature_engraver}, the same music transcribes
+to the following
+
+@lilypond[quote,ragged-right]
+\transpose c c' {
+  \set Score.timing = ##f
+  \set Score.defaultBarType = "empty"
+  \override NoteHead #'style = #'neomensural
+  \override Staff.TimeSignature #'style = #'neomensural
+  \clef "petrucci-g"
+  \[ c'\maxima g \]
+  \[ d\longa c\breve f e d \]
+  \[ c'\maxima d'\longa \]
+  \[ e'1 a g\breve \]
+}
+@end lilypond
+
+@refbugs
+
+Horizontal spacing is poor.
+
+@node Gregorian square neumes ligatures
+@unnumberedsubsubsec Gregorian square neumes ligatures
+
+@cindex Square neumes ligatures
+@cindex Gregorian square neumes ligatures
+
+There is limited support for Gregorian square neumes notation
+(following the style of the Editio Vaticana).  Core ligatures can
+already be typeset, but essential issues for serious typesetting are
+still lacking, such as (among others) horizontal alignment of multiple
+ligatures, lyrics alignment and proper handling of accidentals.
+
+
+The following table contains the extended neumes table of the 2nd
+volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
+1983 by the monks of Solesmes.
+
+@multitable @columnfractions .4 .2 .2 .2
+
+@item
+@b{Neuma aut@*
+Neumarum Elementa}
+@tab
+@b{Figurae@*
+Rectae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Auctae}
+@tab
+@b{Figurae@*
+Liquescentes@*
+Deminutae}
+
+@c TODO: \layout block is identical in all of the below examples.
+@c Therefore, it should somehow be included rather than duplicated all
+@c the time. --jr
+
+@c why not make variables in ly/engraver-init.ly? --hwn
+
+@c Because it's just used to typeset plain notes without
+@c a staff for demonstration purposes rather than something
+@c special of Gregorian chant notation. --jr
+
+@item
+@code{1. Punctum}
+@tab
+@lilypond[staffsize=26,line-width=1.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum
+    \[ b \]
+    \noBreak s^\markup {"a"} \noBreak
+
+    % Punctum Inclinatum
+    \[ \inclinatum b \]
+    \noBreak s^\markup {"b"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.5\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Auctum Ascendens
+    \[ \auctum \ascendens b \]
+    \noBreak s^\markup {"c"} \noBreak
+
+    % Punctum Auctum Descendens
+    \[ \auctum \descendens b \]
+    \noBreak s^\markup {"d"} \noBreak
+
+    % Punctum Inclinatum Auctum
+    \[ \inclinatum \auctum b \]
+    \noBreak s^\markup {"e"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Punctum Inclinatum Parvum
+    \[ \inclinatum \deminutum b \]
+    \noBreak s^\markup {"f"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{2. Virga}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Virga
+    \[ \virga b \]
+    \noBreak s^\markup {"g"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{3. Apostropha vel Stropha}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha
+    \[ \stropha b \]
+    \noBreak s^\markup {"h"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Stropha Aucta
+    \[ \stropha \auctum b \]
+    \noBreak s^\markup {"i"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{4. Oriscus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Oriscus
+    \[ \oriscus b \]
+    \noBreak s^\markup {"j"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@tab
+
+@item
+@code{5. Clivis vel Flexa}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis vel Flexa
+    \[ b \flexa g \]
+    s^\markup {"k"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Clivis Aucta Descendens
+    \[ b \flexa \auctum \descendens g \]
+    \noBreak s^\markup {"l"} \noBreak
+
+    % Clivis Aucta Ascendens
+    \[ b \flexa \auctum \ascendens g \]
+    \noBreak s^\markup {"m"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Cephalicus
+    \[ b \flexa \deminutum g \]
+    s^\markup {"n"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{6. Podatus vel Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Podatus vel Pes
+    \[ g \pes b \]
+    s^\markup {"o"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=2.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens
+    \[ g \pes \auctum \descendens b \]
+    \noBreak s^\markup {"p"} \noBreak
+
+    % Pes Auctus Ascendens
+    \[ g \pes \auctum \ascendens b \]
+    \noBreak s^\markup {"q"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Epiphonus
+    \[ g \pes \deminutum b \]
+    s^\markup {"r"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{7. Pes Quassus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus
+    \[ \oriscus g \pes \virga b \]
+    s^\markup {"s"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Quassus Auctus Descendens
+    \[ \oriscus g \pes \auctum \descendens b \]
+    s^\markup {"t"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{8. Quilisma Pes}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes
+    \[ \quilisma g \pes b \]
+    s^\markup {"u"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Quilisma Pes Auctus Descendens
+    \[ \quilisma g \pes \auctum \descendens b \]
+    s^\markup {"v"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{9. Podatus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Initio Debilis
+    \[ \deminutum g \pes b \]
+    s^\markup {"w"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Pes Auctus Descendens Initio Debilis
+    \[ \deminutum g \pes \auctum \descendens b \]
+    s^\markup {"x"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{10. Torculus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus
+    \[ a \pes b \flexa g \]
+    s^\markup {"y"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens
+    \[ a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"z"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus
+    \[ a \pes b \flexa \deminutum g \]
+    s^\markup {"A"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{11. Torculus Initio Debilis}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Initio Debilis
+    \[ \deminutum a \pes b \flexa g \]
+    s^\markup {"B"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Auctus Descendens Initio Debilis
+    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
+    s^\markup {"C"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Torculus Deminutus Initio Debilis
+    \[ \deminutum a \pes b \flexa \deminutum g \]
+    s^\markup {"D"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{12. Porrectus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus
+    \[ a \flexa g \pes b \]
+    s^\markup {"E"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Auctus Descendens
+    \[ a \flexa g \pes \auctum \descendens b \]
+    s^\markup {"F"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Porrectus Deminutus
+    \[ a \flexa g \pes \deminutum b \]
+    s^\markup {"G"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{13. Climacus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus
+    \[ \virga b \inclinatum a \inclinatum g \]
+    s^\markup {"H"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Auctus
+    \[ \virga b \inclinatum a \inclinatum \auctum g \]
+    s^\markup {"I"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Climacus Deminutus
+    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
+    s^\markup {"J"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{14. Scandicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus
+    \[ g \pes a \virga b \]
+    s^\markup {"K"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Auctus Descendens
+    \[ g \pes a \pes \auctum \descendens b \]
+    s^\markup {"L"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Scandicus Deminutus
+    \[ g \pes a \pes \deminutum b \]
+    s^\markup {"M"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+
+@item
+@code{15. Salicus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus
+    \[ g \oriscus a \pes \virga b \]
+    s^\markup {"N"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Salicus Auctus Descendens
+    \[ g \oriscus a \pes \auctum \descendens b \]
+    s^\markup {"O"}
+  }
+\layout { \neumeDemoLayout }}
+@end lilypond
+@tab
+
+@item
+@code{16. Trigonus}
+@tab
+@lilypond[staffsize=26,line-width=1.0\cm]
+\include "gregorian-init.ly"
+\score {
+  \transpose c c' {
+    % Trigonus
+    \[ \stropha b \stropha b \stropha a \]
+    s^\markup {"P"}
+  }
+  \layout { \neumeDemoLayout }
+}
+@end lilypond
+@tab
+@tab
+
+@end multitable
+
+
+Unlike most other neumes notation systems, the input language for
+neumes does not reflect the typographical appearance, but is designed
+to focus on musical meaning.  For example, @code{\[ a \pes b
+\flexa g \]} produces a Torculus consisting of three Punctum heads,
+while @code{\[ a \flexa g \pes b \]} produces a Porrectus with a
+curved flexa shape and only a single Punctum head.  There is no
+command to explicitly typeset the curved flexa shape; the decision of
+when to typeset a curved flexa shape is based on the musical
+input.  The idea of this approach is to separate the musical aspects
+of the input from the notation style of the output.  This way, the
+same input can be reused to typeset the same music in a different
+style of Gregorian chant notation.
+
+The following table shows the code fragments that produce the
+ligatures in the above neumes table.  The letter in the first column
+in each line of the below table indicates to which ligature in the
+above table it refers.  The second column gives the name of the
+ligature.  The third column shows the code fragment that produces this
+ligature, using @code{g}, @code{a}, and @code{b} as example pitches.
+
+@multitable @columnfractions .02 .31 .67
+@item
+@b{#}
+@tab
+@b{Name}
+@tab
+@b{Input Language}
+
+@item
+a
+@tab
+Punctum
+@tab
+@code{\[ b \]}
+
+@item
+b
+@tab
+Punctum Inclinatum
+@tab
+@code{\[ \inclinatum b \]}
+
+@item
+c
+@tab
+Punctum Auctum@*
+Ascendens
+@tab
+@code{\[ \auctum \ascendens b \]}
+
+@item
+d
+@tab
+Punctum Auctum@*
+Descendens
+@tab
+@code{\[ \auctum \descendens b \]}
+
+@item
+e
+@tab
+Punctum Inclinatum@*
+Auctum
+@tab
+@code{\[ \inclinatum \auctum b \]}
+
+@item
+f
+@tab
+Punctum Inclinatum@*
+Parvum @tab
+@code{\[ \inclinatum \deminutum b \]}
+
+@item
+g
+@tab
+Virga
+@tab
+@code{\[ \virga b \]}
+
+@item
+h
+@tab
+Stropha
+@tab
+@code{\[ \stropha b \]}
+
+@item
+i
+@tab
+Stropha Aucta
+@tab
+@code{\[ \stropha \auctum b \]}
+
+@item
+j
+@tab
+Oriscus
+@tab
+@code{\[ \oriscus b \]}
+
+@item
+k
+@tab
+Clivis vel Flexa
+@tab
+@code{\[ b \flexa g \]}
+
+@item
+l
+@tab
+Clivis Aucta@*
+Descendens
+@tab
+@code{\[ b \flexa \auctum \descendens g \]}
+
+@item
+m
+@tab
+Clivis Aucta@*
+Ascendens
+@tab
+@code{\[ b \flexa \auctum \ascendens g \]}
+
+@item
+n
+@tab
+Cephalicus
+@tab
+@code{\[ b \flexa \deminutum g \]}
+
+@item
+o
+@tab
+Podatus vel Pes
+@tab
+@code{\[ g \pes b \]}
+
+@item
+p
+@tab
+Pes Auctus@*
+Descendens
+@tab
+@code{\[ g \pes \auctum \descendens b \]}
+
+@item
+q
+@tab
+Pes Auctus@*
+Ascendens
+@tab
+@code{\[ g \pes \auctum \ascendens b \]}
+
+@item
+r
+@tab
+Epiphonus
+@tab
+@code{\[ g \pes \deminutum b \]}
+
+@item
+s
+@tab
+Pes Quassus
+@tab
+@code{\[ \oriscus g \pes \virga b \]}
+
+@item
+t
+@tab
+Pes Quassus@*
+Auctus Descendens @tab
+@code{\[ \oriscus g \pes \auctum \descendens b \]}
+
+@item
+u
+@tab
+Quilisma Pes
+@tab
+@code{\[ \quilisma g \pes b \]}
+
+@item
+v
+@tab
+Quilisma Pes@*
+Auctus Descendens
+@tab
+@code{\[ \quilisma g \pes \auctum \descendens b \]}
+
+@item
+w
+@tab
+Pes Initio Debilis
+@tab
+@code{\[ \deminutum g \pes b \]}
+
+@item
+x
+@tab
+Pes Auctus Descendens@*
+Initio Debilis
+@tab
+@code{\[ \deminutum g \pes \auctum \descendens b \]}
+
+@item
+y
+@tab
+Torculus
+@tab
+@code{\[ a \pes b \flexa g \]}
+
+@item
+z
+@tab
+Torculus Auctus@*
+Descendens
+@tab
+@code{\[ a \pes b \flexa \auctum \descendens g \]}
+
+@item
+A
+@tab
+Torculus Deminutus
+@tab
+@code{\[ a \pes b \flexa \deminutum g \]}
+
+@item
+B
+@tab
+Torculus Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa g \]}
+
+@item
+C
+@tab
+Torculus Auctus@*
+Descendens Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
+
+@item
+D
+@tab
+Torculus Deminutus@*
+Initio Debilis
+@tab
+@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
+
+@item
+E
+@tab
+Porrectus
+@tab
+@code{\[ a \flexa g \pes b \]}
+
+@item
+F
+@tab
+Porrectus Auctus@*
+Descendens
+@tab
+@code{\[ a \flexa g \pes \auctum \descendens b \]}
+
+@item
+G
+@tab
+Porrectus Deminutus
+@tab
+@code{\[ a \flexa g \pes \deminutum b \]}
+
+@item
+H
+@tab
+Climacus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum g \]}
+
+@item
+I
+@tab
+Climacus Auctus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
+
+@item
+J
+@tab
+Climacus Deminutus
+@tab
+@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
+
+@item
+K
+@tab
+Scandicus
+@tab
+@code{\[ g \pes a \virga b \]}
+
+@item
+L
+@tab
+Scandicus Auctus@*
+Descendens
+@tab
+@code{\[ g \pes a \pes \auctum \descendens b \]}
+
+@item
+M
+@tab
+Scandicus Deminutus
+@tab
+@code{\[ g \pes a \pes \deminutum b \]}
+
+@item
+N
+@tab
+Salicus
+@tab
+@code{\[ g \oriscus a \pes \virga b \]}
+
+@item
+O
+@tab
+Salicus Auctus Descendens
+@tab
+@code{\[ g \oriscus a \pes \auctum \descendens b \]}
+
+@item
+P
+@tab
+Trigonus
+@tab
+@code{\[ \stropha b \stropha b \stropha a \]}
+@end multitable
+
+The ligatures listed above mainly serve as a limited, but still
+representative pool of Gregorian ligature examples.  Virtually, within
+the ligature delimiters @code{\[} and @code{\]}, any number of heads
+may be accumulated to form a single ligature, and head prefixes like
+@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
+etc. may be mixed in as desired.  The use of the set of rules that
+underlies the construction of the ligatures in the above table is
+accordingly extrapolated.  This way, infinitely many different
+ligatures can be created.
+
+Augmentum dots, also called @emph{morae}, are added with the music
+function @code{\augmentum}.  Note that @code{\augmentum} is
+implemented as a unary music function rather than as head prefix.  It
+applies to the immediately following music expression only.  That is,
+@code{\augmentum \virga c} will have no visible effect.  Instead, say
+@code{\virga \augmentum c} or @code{\augmentum @{\virga c@}}.  Also
+note that you can say @code{\augmentum @{a g@}} as a shortcut for
+@code{\augmentum a \augmentum g}.
+
+@lilypond[quote,ragged-right,verbatim]
+\include "gregorian-init.ly"
+\score {
+  \new VaticanaVoice {
+    \[ \augmentum a \flexa \augmentum g \]
+    \augmentum g
+  }
+}
+@end lilypond
+
+@refcommands
+
+The following head prefixes are supported
+
+@funindex \virga
+@code{\virga},
+@funindex \stropha
+@code{\stropha},
+@funindex \inclinatum
+@code{\inclinatum},
+@funindex \auctum
+@code{\auctum},
+@funindex \descendens
+@code{\descendens},
+@funindex \ascendens
+@code{\ascendens},
+@funindex \oriscus
+@code{\oriscus},
+@funindex \quilisma
+@code{\quilisma},
+@funindex \deminutum
+@code{\deminutum},
+@funindex \cavum
+@code{\cavum},
+@funindex \linea
+@code{\linea}.
+
+Head prefixes can be accumulated, though restrictions apply.  For
+example, either @code{\descendens} or @code{\ascendens} can be applied
+to a head, but not both to the same head.
+
+@funindex \pes
+@funindex \flexa
+Two adjacent heads can be tied together with the @code{\pes} and
+@code{\flexa} infix commands for a rising and falling line of melody,
+respectively.
+
+@funindex \augmentum
+Use the unary music function @code{\augmentum} to add augmentum dots.
+
+@refbugs
+
+When an @code{\augmentum} dot appears at the end of the last staff
+within a ligature, it is sometimes vertically placed wrong.  As a
+workaround, add an additional skip note (e.g. @code{s8}) as last note
+of the staff.
+
+@code{\augmentum} should be implemented as a head prefix rather than a
+unary music function, such that @code{\augmentum} can be intermixed
+with head prefixes in arbitrary order.
+
+@node Gregorian Chant contexts
+@unnumberedsubsubsec Gregorian Chant contexts
+
+@cindex VaticanaVoiceContext
+@cindex VaticanaStaffContext
+
+The predefined @code{VaticanaVoiceContext} and
+@code{VaticanaStaffContext} can be used to engrave a piece of
+Gregorian Chant in the style of the Editio Vaticana.  These contexts
+initialize all relevant context properties and grob properties to
+proper values, so you can immediately go ahead entering the chant, as
+the following excerpt demonstrates
+
+@lilypond[quote,ragged-right,packed,verbatim]
+\include "gregorian-init.ly"
+\score {
+  <<
+    \new VaticanaVoice = "cantus" {
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \]
+      f \divisioMinima
+      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
+      c' \divisioMinima \break
+      \[ c'\melisma c' \flexa a \]
+      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
+    }
+    \new Lyrics \lyricsto "cantus" {
+      San- ctus, San- ctus, San- ctus
+    }
+  >>
+}
+@end lilypond
+
+
+@node Mensural contexts
+@unnumberedsubsubsec Mensural contexts
+
+@cindex MensuralVoiceContext
+@cindex MensuralStaffContext
+
+The predefined @code{MensuralVoiceContext} and
+@code{MensuralStaffContext} can be used to engrave a piece in
+mensural style.  These contexts initialize all relevant context
+properties and grob properties to proper values, so you can
+immediately go ahead entering the chant, as the following excerpt
+demonstrates
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  <<
+    \new MensuralVoice = "discantus" \transpose c c' {
+      \override Score.BarNumber #'transparent = ##t {
+        c'1\melisma bes a g\melismaEnd
+        f\breve
+        \[ f1\melisma a c'\breve d'\melismaEnd \]
+        c'\longa
+        c'\breve\melisma a1 g1\melismaEnd
+        fis\longa^\signumcongruentiae
+      }
+    }
+    \new Lyrics \lyricsto "discantus" {
+      San -- ctus, San -- ctus, San -- ctus
+    }
+  >>
+}
+@end lilypond
+
+@node Musica ficta accidentals
+@unnumberedsubsubsec Musica ficta accidentals
+
+In European music from before about 1600, singers were often
+expected to chromatically alter notes at their own initiative.
+This is called @q{Musica Ficta}.  In modern transcriptions, these
+accidentals are usually printed over the note.
+
+@cindex Accidental, musica ficta
+@cindex Musica ficta
+
+Support for such suggested accidentals is included, and can be
+switched on by setting @code{suggestAccidentals} to true.
+
+@funindex suggestAccidentals
+
+@lilypond[verbatim,fragment,relative=1]
+fis gis
+\set suggestAccidentals = ##t
+ais bis
+@end lilypond
+
+This will treat @emph{every} subsequent accidentals as
+@emph{musica ficta} until it is unset with @code{\set
+suggestAccidentals = ##f}.  A more convenient way is to use
+@code{\once}:
+
+@lilypond[verbatim,fragment,relative=1]
+fis gis
+\once \set suggestAccidentals = ##t
+ais ais bis
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{Accidental_engraver} engraver and
+the @internalsref{AccidentalSuggestion} object.
+
+@node Figured bass
+@unnumberedsubsubsec Figured bass
+
+@cindex Basso continuo
+
+@c TODO: musicological blurb about FB
+
+
+LilyPond has support for figured bass
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+<<
+  \new Voice { \clef bass dis4 c d ais g fis}
+  \new FiguredBass \figuremode {
+    < 6 >4 < 7\+ >8 < 6+ [_!] >
+    < 6 >4 <6 5 [3+] >
+    < _ >4 < 6 5/>4
+  }
+>>
+@end lilypond
+
+The support for figured bass consists of two parts: there is an input
+mode, introduced by @code{\figuremode}, where you can enter bass figures
+as numbers, and there is a context called @internalsref{FiguredBass} that
+takes care of making @internalsref{BassFigure} objects.
+
+In figures input mode, a group of bass figures is delimited by
+@code{<} and @code{>}.  The duration is entered after the @code{>}
+@example
+<4 6>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { <4 6> }
+@end lilypond
+
+Accidentals are added when you append @code{-}, @code{!}, and @code{+}
+to the numbers.  A plus sign is added when you append @code{\+}, and
+diminished fifths and sevenths can be obtained with @code{5/} and @code{7/}.
+
+@example
+<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
+@end example
+@lilypond[quote,ragged-right,fragment]
+\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@end lilypond
+
+Spaces may be inserted by using @code{_}.  Brackets are
+introduced with @code{[} and @code{]}.  You can also include text
+strings and text markups, see @ref{Overview of text markup commands}.
+
+@example
+< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
+@end example
+@lilypond[quote,ragged-right,fragment]
+\new FiguredBass
+\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@end lilypond
+
+
+It is also possible to use continuation lines for repeated figures,
+
+@lilypond[verbatim,relative=1]
+<<
+  \new Staff {
+    \clef bass
+    c4 c c
+  }
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <4 6> <3 6> <3 7>
+  }
+>>
+@end lilypond
+
+@noindent
+In this case, the extender lines always replace existing figures.
+
+The @code{FiguredBass} context doesn't pay attention to the actual
+bass line.  As a consequence, you may have to insert extra figures to
+get extender lines below all notes, and you may have to add @code{\!}
+to avoid getting an extender line, e.g.
+
+@lilypond[relative=1]
+<<
+  \new Voice
+  \figures {
+    \set useBassFigureExtenders = ##t
+    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+  }
+  {
+    \clef bass
+    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+  }
+>>
+@end lilypond
+
+When using continuation lines, common figures are always put in the
+same vertical position.  When this is unwanted, you can insert a rest
+with @code{r}.  The rest will clear any previous alignment.  For
+example, you can write
+
+@example
+  <4 6>8 r8
+@end example
+
+@noindent
+instead of
+@example
+  <4 6>4
+@end example
+
+Accidentals and plus signs can appear before or after the numbers,
+depending on the @code{figuredBassAlterationDirection} and
+@code{figuredBassPlusDirection}
+properties
+
+@lilypond
+  \figures {
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassPlusDirection = #1
+    <6\+> <5+> <6 4-> r
+    \set figuredBassAlterationDirection = #-1
+    <6\+> <5+> <6 4-> r
+  }
+@end lilypond
+
+
+Although the support for figured bass may superficially resemble chord
+support, it is much simpler.  The @code{\figuremode} mode simply
+stores the numbers and @internalsref{FiguredBass} context prints them
+as entered.  There is no conversion to pitches and no realizations of
+the bass are played in the MIDI file.
+
+Internally, the code produces markup texts.  You can use any of the
+markup text properties to override formatting.  For example, the
+vertical spacing of the figures may be set with @code{baseline-skip}.
+
+
+Figured bass can also be added to @code{Staff} contexts
+directly.  In this case, their vertical position is adjusted
+automatically.
+
+@lilypond[ragged-right,fragment,quote]
+<<
+  \new Staff = someUniqueName
+  \relative c'' {
+    c4 c'8 r8 c,4 c'
+  }
+
+  %% send to existing Staff.
+  \context Staff = someUniqueName 
+  \figuremode {
+    <4>4 <6 10>8 s8
+    
+    \set Staff.useBassFigureExtenders = ##t
+    <4 6>4 <4 6>
+  }
+>>
+@end lilypond
+
+
+@commonprop
+
+By default, this method produces figures above the notes.  To get
+figures below the notes, use
+
+@example
+\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
+@end example
+
+
+@refbugs
+
+When using figured bass above the staff with extender lines and
+@code{implicitBassFigures} the lines may become swapped around.
+Maintaining order consistently will be impossible when multiple figures
+have overlapping extender lines.  To avoid this problem, please
+use @code{stacking-dir} on @code{BassFigureAlignment}.
+
+
+@seealso
+
+Program reference: @internalsref{NewBassFigure},
+@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
+@internalsref{BassFigureBracket}, and
+@internalsref{BassFigureContinuation} objects and
+@internalsref{FiguredBass} context.
+
+
diff --git a/Documentation/user/bagpipes.itely b/Documentation/user/bagpipes.itely
new file mode 100644
index 0000000000..7a65454201
--- /dev/null
+++ b/Documentation/user/bagpipes.itely
@@ -0,0 +1,114 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Bagpipes
+@section Bagpipes
+
+This section includes extra information for writing for bagpipes.
+
+@menu
+* Bagpipe sections::            
+@end menu
+
+
+@node Bagpipe sections
+@subsection Bagpipe sections
+
+@menu
+* Bagpipe definitions::         
+* Bagpipe example::             
+@end menu
+
+@node Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+LilyPond contains special definitions for music for the Scottish
+highland bagpipe; to use them, add
+
+@example
+\include "bagpipe.ly"
+@end example
+
+@noindent
+at the top of your input file.  This lets you add the special gracenotes
+common to bagpipe music with short commands.  For example, you could
+write @code{\taor} instead of
+
+@example
+\grace @{ \small G32[ d G e] @}
+@end example
+
+@code{bagpipe.ly} also contains pitch definitions for the bagpipe
+notes in the appropriate octaves, so you do not need to worry about
+@code{\relative} or @code{\transpose}.
+
+@lilypond[ragged-right,verbatim,quote,notime]
+\include "bagpipe.ly"
+{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
+@end lilypond
+
+Bagpipe music nominally uses the key of D Major (even though that
+isn't really true).  However, since that is the only key that can be used,
+the key signature is normally not written out.  To set this up correctly,
+always start your music with @code{\hideKeySignature}.  If you for some
+reason want to show the key signature, you can use @code{\showKeySignature}
+instead.
+
+Some modern music use cross fingering on c and f to flatten those notes.
+This can be indicated by @code{cflat} or @code{fflat}.  Similarly, the
+piobaireachd high g can be written @code{gflat} when it occurs in light
+music.
+
+
+@node Bagpipe example
+@unnumberedsubsubsec Bagpipe example
+
+This is what the well known tune Amazing Grace looks like in bagpipe
+notation.
+
+@lilypond[verbatim,quote]
+\include "bagpipe.ly"
+\layout {
+  indent = 0.0\cm
+  \context { \Score \remove "Bar_number_engraver" }
+}
+
+\header {
+  title = "Amazing Grace"
+  meter = "Hymn"
+  arranger = "Trad. arr."
+}
+
+{
+  \hideKeySignature
+  \time 3/4
+  \grg \partial 4 a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 \grg e8. f16
+  \dblA A2 \grg A4
+  \grg A2 f8. A16
+  \grg A2 \hdblf f8[ e32 d16.]
+  \grg f2 \grg f8 e
+  \thrwd d2 \grg b4
+  \grG a2 \grg a8. d16
+  \slurd d2 \grg f8[ e32 d16.]
+  \grg f2 e4
+  \thrwd d2.
+  \slurd d2
+  \bar "|."
+}
+@end lilypond
+
+
+
+
+
diff --git a/Documentation/user/basic-notation.itely b/Documentation/user/basic-notation.itely
deleted file mode 100644
index 47ca1e4368..0000000000
--- a/Documentation/user/basic-notation.itely
+++ /dev/null
@@ -1,3524 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Basic notation
-@chapter Basic notation
-
-This chapter explains how to use basic notation features.
-
-@menu
-* Pitches::                     
-* Rhythms::                     
-* Polyphony::                   
-* Staff notation::              
-* Connecting notes::            
-* Expressive marks::            
-* Repeats::                     
-@end menu
-
-
-
-@node Pitches
-@section Pitches
-
-This section discusses how to specify the pitch of notes.
-
-@menu
-* Normal pitches::              
-* Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
-* Note names in other languages::  
-* Relative octaves::            
-* Octave check::                
-* Transpose::                   
-* Rests::                       
-* Skips::                       
-@end menu
-
-
-@node Normal pitches
-@subsection Normal pitches
-
-@cindex Pitch names
-@cindex pitches
-
-A pitch name is specified using lowercase letters @code{a} through @code{g}.
-An ascending C-major scale is engraved with
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef bass
-c d e f g a b c'
-@end lilypond
-
-The note name @code{c} is engraved one octave below middle C.
-
-@lilypond[quote,fragment,verbatim,ragged-right]
-\clef treble
-c1
-\clef bass
-c1
-@end lilypond
-
-@funindex '
-@funindex ,
-
-The optional octave specification takes the form of a series of
-single quote (@samp{'}) characters or a series of comma
-(@samp{,}) characters.  Each @samp{'} raises the pitch by one
-octave; each @samp{,} lowers the pitch by an octave.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\clef treble
-c' c'' e' g d'' d' d c
-\clef bass
-c, c,, e, g d,, d, d c
-@end lilypond
-
-An alternate method may be used to declare which octave to
-engrave a pitch; this method does not require as many
-octave specifications (@code{'} and @code{,}).  See
-@ref{Relative octaves}.
-
-
-@node Accidentals
-@subsection Accidentals
-
-@cindex note names, Dutch
-@cindex note names, default
-
-A sharp is formed by adding @code{-is} to the end of a pitch name and
-a flat is formed by adding @code{-es}.  Double sharps and double flats
-are obtained by adding @code{-isis} or @code{-eses} to a note name.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a2 ais a aes
-a2 aisis a aeses
-@end lilypond
-
-@noindent
-These are the Dutch note names.  In Dutch, @code{aes} is contracted to
-@code{as}, but both forms are accepted.  Similarly, both
-@code{es} and @code{ees} are accepted
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a2 as e es
-@end lilypond
-
-A natural will cancel the effect of an accidental or key signature.
-However, naturals are not encoded into the note name syntax with a
-suffix; a natural pitch is shown as a simple note name
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-a4 aes a2
-@end lilypond
-
-The input @code{d e f} is interpreted as @q{print a D-natural,
-E-natural, and an F-natural,} regardless of the key
-signature.  For more information about the distinction between
-musical content and the presentation of that content, see
-@ref{Accidentals and key signatures}.
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative]
-\key d \major
-d e f g
-d e fis g
-@end lilypond
-
-
-@commonprop
-
-In accordance with standard typesetting rules, a natural sign is printed
-before a sharp or flat if a previous accidental needs to be
-cancelled.  To change this behavior, use
-@code{\set Staff.extraNatural = ##f}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-ceses4 ces cis c
-\set Staff.extraNatural = ##f
-ceses4 ces cis c
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{LedgerLineSpanner},
-@internalsref{NoteHead}.
-
-
-@node Cautionary accidentals
-@subsection Cautionary accidentals
-
-@cindex accidental, reminder
-@cindex accidental, cautionary
-@cindex accidental, parenthesized
-@cindex reminder accidental
-@funindex ?
-@cindex cautionary accidental
-@cindex parenthesized accidental
-@funindex !
-
-Normally accidentals are printed automatically, but you may also
-print them manually.  A reminder accidental
-can be forced by adding an exclamation mark @code{!}
-after the pitch.  A cautionary accidental
-(i.e., an accidental within parentheses) can be obtained by adding the
-question mark @samp{?} after the pitch.  These extra accidentals
-can be used to produce natural signs, too.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-cis cis cis! cis? c c? c! c
-@end lilypond
-
-
-@seealso
-
-The automatic production of accidentals can be tuned in many
-ways.  For more information, see @ref{Automatic accidentals}.
-
-
-@node Micro tones
-@subsection Micro tones
-
-@cindex quarter tones
-@cindex semi-flats, semi-sharps
-
-Half-flats and half-sharps are formed by adding @code{-eh} and
-@code{-ih}; the following is a series of Cs with increasing pitches
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Micro tones are also exported to the MIDI file.
-
-
-@refbugs
-
-There are no generally accepted standards for denoting
-three-quarter flats, so LilyPond's symbol does not conform to any
-standard.
-
-
-@node Note names in other languages
-@subsection Note names in other languages
-
-There are predefined sets of note names for various other languages.
-To use them, include the language specific init file.  For
-example, add @code{\include "english.ly"} to the top of the input
-file.  The available language files
-and the note names they define are
-
-@c  Should this be made into a multitable?
-@cindex note names, other languages
-@example
-                        Note Names               sharp       flat     double        double
-                                                                       sharp        flat
-
-nederlands.ly  c   d   e   f   g   a   bes b   -is         -es       -isis         -eses
-english.ly     c   d   e   f   g   a   bf  b   -s/-sharp   -f/-flat  -ss/-x/       -ff/
-                                                                     -sharpsharp   -flatflat
-deutsch.ly     c   d   e   f   g   a   b   h   -is         -es       -isis         -eses
-norsk.ly       c   d   e   f   g   a   b   h   -iss/-is    -ess/-es  -ississ/-isis -essess/-eses
-svenska.ly     c   d   e   f   g   a   b   h   -iss        -ess      -ississ       -essess
-italiano.ly    do  re  mi  fa  sol la  sib si  -d          -b        -dd           -bb
-catalan.ly     do  re  mi  fa  sol la  sib si  -d/-s       -b        -dd/-ss       -bb
-espanol.ly     do  re  mi  fa  sol la  sib si  -s          -b        -ss           -bb
-@end example
-
-@noindent
-Note that in Dutch, German, Norwegian, and Swedish, the flat
-alterations of @samp{a} like for example @code{aes} and @code{aeses}
-are usually contracted to @code{as} and @code{ases} (or more commonly
-@code{asas}). Sometimes only these contracted names are defined in the
-corresponding language files (this also applies to the suffixes for
-quartertones below).
-
-@noindent
-Some music uses microtones whose alterations are fractions of a
-@q{regular} sharp or flat. The note names for quartertones defined in
-the various language files are listed in the following table. Here the
-prefixes @q{semi-} and @q{sesqui-} mean @q{half} and @q{one and a
-half}, respectively. For Norwegian, Swedish, Catalan and Spanish no
-special names have been defined yet.
-@c What about Turkish Maquam music and similar microtonal systems?
-@c
-@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
-@c is actually misleading since the alteration is in fact one and a half
-@c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
-
-@example
-                        Note Names             semi-   semi-  sesqui-  sesqui-
-                                               sharp   flat    sharp    flat
-
-nederlands.ly  c   d   e   f   g   a   bes b   -ih     -eh    -isih    -eseh
-english.ly     c   d   e   f   g   a   bf  b   -qs     -qf    -tqs     -tqf
-deutsch.ly     c   d   e   f   g   a   b   h   -ih     -eh    -isih    -eseh
-norsk.ly       c   d   e   f   g   a   b   h   
-svenska.ly     c   d   e   f   g   a   b   h   
-italiano.ly    do  re  mi  fa  sol la  sib si  -sd     -sb    -dsd     -bsb
-catalan.ly     do  re  mi  fa  sol la  sib si  
-espanol.ly     do  re  mi  fa  sol la  sib si  
-@end example
-
-
-
-@node Relative octaves
-@subsection Relative octaves
-
-@cindex Relative
-@cindex Relative octave specification
-@funindex \relative
-
-Octaves are specified by adding @code{'} and @code{,} to pitch names.
-When you copy existing music, it is easy to accidentally put a pitch
-in the wrong octave and hard to find such an error.  The relative
-octave mode prevents these errors by making the mistakes much
-larger: a single error puts the rest of the piece off by one octave
-
-@example
-\relative @var{startpitch} @var{musicexpr}
-@end example
-
-@noindent
-or
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} is used as the default if no starting pitch is defined.
-
-The octave of notes that appear in @var{musicexpr} are calculated as
-follows: if no octave changing marks are used, the basic interval
-between this and the last note is always taken to be a fourth or
-less.  This distance is determined without regarding alterations; a
-@code{fisis} following a @code{ceses} will be put above the
-@code{ceses}.  In other words, a doubly-augmented fourth is considered
-a smaller interval than a diminished fifth, even though the
-doubly-augmented fourth spans seven semitones while the diminished
-fifth only spans six semitones.
-
-The octave changing marks @code{'} and @code{,} can be added to raise
-or lower the pitch by an extra octave.  Upon entering relative mode,
-an absolute starting pitch can be specified that will act as the
-predecessor of the first note of @var{musicexpr}.  If no starting pitch
-is specified, then middle C is used as a start.
-
-Here is the relative mode shown in action
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-Octave changing marks are used for intervals greater than a fourth
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-If the preceding item is a chord, the first note of the chord is used
-to determine the first note of the next chord
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-The pitch after @code{\relative} contains a note name.
-
-The relative conversion will not affect @code{\transpose},
-@code{\chordmode} or @code{\relative} sections in its argument.  To use
-relative within transposed music, an additional @code{\relative} must
-be placed inside @code{\transpose}.
-
-
-@node Octave check
-@subsection Octave check
-
-@cindex Octave check
-
-Octave checks make octave errors easier to correct: a note may be
-followed by @code{=}@var{quotes} which indicates what its absolute
-octave should be.  In the following example,
-
-@example
-\relative c'' @{ c='' b=' d,='' @}
-@end example
-
-@noindent
-the @code{d} will generate a warning, because a @code{d''} is expected
-(because @code{b'} to @code{d''} is only a third), but a @code{d'} is
-found.  In the output, the octave is corrected to be a @code{d''} and
-the next note is calculated relative to @code{d''} instead of @code{d'}.
-
-There is also an octave check that produces no visible output.  The syntax
-
-@example
-\octave @var{pitch}
-@end example
-
-This checks that @var{pitch} (without quotes) yields @var{pitch} (with
-quotes) in @code{\relative} mode compared to the note given in the
-@code{\relative} command.  If not, a warning is printed, and the
-octave is corrected.  The @var{pitch} is not printed as a note.
-
-In the example below, the first check passes without incident, since
-the @code{e} (in @code{relative} mode) is within a fifth of
-@code{a'}.  However,
-the second check produces a warning, since the @code{e} is not within
-a fifth of @code{b'}.  The warning message is printed, and the octave
-is adjusted so that the following notes are in the correct octave
-once again.
-
-@example
-\relative c' @{
-  e
-  \octave a'
-  \octave b'
-@}
-@end example
-
-
-The octave of a note following an octave check is determined with
-respect to the note preceding it.  In the next fragment, the last note
-is an @code{a'}, above middle C.  That means that the @code{\octave}
-check passes successfully, so the check could be deleted without changing
-the output of the piece.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\relative c' {
-  e
-  \octave b
-  a
-}
-@end lilypond
-
-
-@node Transpose
-@subsection Transpose
-
-@cindex Transpose
-@cindex Transposition of pitches
-@funindex \transpose
-
-A music expression can be transposed with @code{\transpose}.  The
-syntax is
-@example
-\transpose @var{from} @var{to} @var{musicexpr}
-@end example
-
-This means that @var{musicexpr} is transposed by the interval between
-the pitches @var{from} and @var{to}: any note with pitch @code{from}
-is changed to @code{to}.
-
-For example, consider a piece written in the key of D-major.  If
-this piece is a little too low for its performer, it can be
-transposed up to E-major with
-@example
-\transpose d e @dots{}
-@end example
-
-Consider a part written for violin (a C instrument).  If
-this part is to be played on the A clarinet (for which an
-A is notated as a C, and which sounds a minor third lower
-than notated), the following
-transposition will produce the appropriate part
-
-@example
-\transpose a c @dots{}
-@end example
-
-@code{\transpose} distinguishes between enharmonic pitches: both
-@code{\transpose c cis} or @code{\transpose c des} will transpose up
-half a tone.  The first version will print sharps and the second
-version will print flats
-
-@lilypond[quote,ragged-right,verbatim]
-mus = { \key d \major cis d fis g }
-\new Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
-}
-@end lilypond
-
-@code{\transpose} may also be used to input written notes for a
-transposing instrument.  Pitches are normally entered into LilyPond
-in C (or @q{concert pitch}), but they may be entered in another
-key.  For example, when entering music for a B-flat trumpet which
-begins on concert D, one would write
-
-@example
-\transpose c bes @{ e4 @dots{} @}
-@end example
-
-To print this music in B-flat again (i.e., producing a trumpet part,
-instead of a concert pitch conductor's score) you would wrap the
-existing music with another @code{transpose}
-
-@example
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
-@end example
-
-
-@seealso
-
-Program reference: @internalsref{TransposedMusic}.
-
-Example: @lsr{scheme,transpose-pitches-with-minimum-accidentals.ly}.
-
-
-@refbugs
-
-If you want to use both @code{\transpose} and @code{\relative},
-you must put @code{\transpose} outside of @code{\relative}, since
-@code{\relative} will have no effect on music that appears inside a
-@code{\transpose}.
-
-
-@node Rests
-@subsection Rests
-@cindex Rests
-
-@funindex \rest
-@funindex r
-
-Rests are entered like notes with the note name @code{r}
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-r1 r2 r4 r8
-@end lilypond
-
-Whole bar rests, centered in middle of the bar,
-must be done with multi-measure rests.  They can be used for a
-single bar as well as many bars, and are discussed in
-@ref{Multi measure rests}.
-
-To explicitly specify a rest's vertical position, write a note
-followed by @code{\rest}.  A rest will be placed in the position
-where the note would appear,
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-a'4\rest d'4\rest
-@end lilypond
-
-@noindent
-This makes manual formatting of
-polyphonic music much easier, since the automatic rest collision
-formatter will leave these rests alone.
-
-@seealso
-
-Program reference: @internalsref{Rest}.
-
-
-@node Skips
-@subsection Skips
-
-@cindex Skip
-@cindex Invisible rest
-@cindex Space note
-@funindex \skip
-@funindex s
-
-An invisible rest (also called a @q{skip}) can be entered like a note
-with note name @samp{s} or with @code{\skip @var{duration}}
-
-@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
-a4 a4 s4 a4 \skip 1 a4
-@end lilypond
-
-The @code{s} syntax is only available in note mode and chord mode.  In
-other situations, for example, when entering lyrics, you should use
-the @code{\skip} command
-
-@lilypond[quote,ragged-right,verbatim]
-<<
-  \relative { a'2 a2 }
-  \new Lyrics \lyricmode { \skip 2 bla2 }
->>
-@end lilypond
-
-The skip command is merely an empty musical placeholder.  It does not
-produce any output, not even transparent output.
-
-The @code{s} skip command does create @internalsref{Staff} and
-@internalsref{Voice} when necessary, similar to note and rest
-commands.  For example, the following results in an empty staff.
-
-@lilypond[quote,ragged-right,verbatim]
-{ s4 }
-@end lilypond
-
-The fragment @code{@{ \skip 4 @} } would produce an empty page.
-
-@seealso
-
-Program reference: @internalsref{SkipMusic}.
-
-
-
-@node Rhythms
-@section Rhythms
-
-This section discusses rhythms, durations, and bars.
-
-@menu
-* Durations::                   
-* Augmentation dots::           
-* Tuplets::                     
-* Scaling durations::           
-* Bar check::                   
-* Barnumber check::             
-* Automatic note splitting::    
-@end menu
-
-
-@node Durations
-@subsection Durations
-
-@cindex duration
-@funindex \longa
-@funindex \breve
-@funindex \maxima
-
-In Note, Chord, and Lyrics mode, durations are designated by numbers and
-dots: durations are entered as their reciprocal values.  For example, a
-quarter note is entered using a @code{4} (since it is a 1/4 note), while
-a half note is entered using a @code{2} (since it is a 1/2 note).  For
-notes longer than a whole you must use the @code{\longa} and
-@code{\breve} commands
-
-@example
-c'\breve
-c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
-r\longa r\breve
-r1 r2 r4 r8 r16 r32 r64 r64
-@end example
-
-@lilypond[quote]
-\score {
-\relative c'' {
-    a\breve*1/2 \autoBeamOff
-    a1 a2 a4 a8 a16 a32 a64 a64
-   \bar "empty"
-   \break
-    r\longa*1/4 r\breve *1/2
-    r1 r2 r4 r8 r16 r32 r64 r64
-  }
-  \layout {
-    ragged-right = ##t
-    indent=0\mm
-    \context {
-      \Score
-        \remove "Bar_number_engraver"
-    }
-    \context {
-      \Staff
-        \remove "Clef_engraver"
-        \override StaffSymbol #'transparent = ##t
-        \override TimeSignature #'transparent = ##t
-        \override BarLine #'transparent = ##t
-        \consists "Pitch_squash_engraver"
-    }
-  }
-}
-@end lilypond
-
-If the duration is omitted then it is set to the previously entered
-duration.  The default for the first note is a quarter note.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-{ a a a2 a a4 a a1 a }
-@end lilypond
-
-
-@node Augmentation dots
-@subsection Augmentation dots
-
-@funindex .
-
-To obtain dotted note lengths, simply add a dot (@samp{.}) to
-the number.  Double-dotted notes are produced in a similar way.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-a'4 b' c''4. b'8 a'4. b'4.. c''8.
-@end lilypond
-
-@refcommands
-
-Dots are normally moved up to avoid staff lines, except in polyphonic
-situations.  The following commands may be used to force a particular
-direction manually
-
-@funindex \dotsUp
-@code{\dotsUp},
-@funindex \dotsDown
-@code{\dotsDown},
-@funindex \dotsNeutral
-@code{\dotsNeutral}.
-
-@seealso
-
-Program reference: @internalsref{Dots}, and @internalsref{DotColumn}.
-
-
-@node Tuplets
-@subsection Tuplets
-
-@cindex tuplets
-@cindex triplets
-@funindex \times
-
-Tuplets are made out of a music expression by multiplying all durations
-with a fraction
-
-@example
-\times @var{fraction} @var{musicexpr}
-@end example
-
-@noindent
-The duration of @var{musicexpr} will be multiplied by the fraction.
-The fraction's denominator will be printed over the notes, optionally
-with a bracket.  The most common tuplet is the triplet in which 3
-notes have the length of 2, so the notes are 2/3 of their written
-length
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-g'4 \times 2/3 {c'4 c' c'} d'4 d'4
-@end lilypond
-
-Tuplets may be nested, for example,
-
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\override TupletNumber #'text = #tuplet-number::calc-fraction-text
-\times 4/6 {
-  a4 a
-  \times 3/5 { a a a a a }
-}
-@end lilypond
-
-@refcommands
-
-@funindex \tupletUp
-@code{\tupletUp},
-@funindex \tupletDown
-@code{\tupletDown},
-@funindex \tupletNeutral
-@code{\tupletNeutral}.
-
-
-@commonprop
-
-@funindex tupletNumberFormatFunction
-@cindex tuplet formatting
-
-The property @code{tupletSpannerDuration} specifies how long each
-bracket should last.  With this, you can make lots of tuplets while
-typing @code{\times} only once, thus saving lots of typing.  In the next
-example, there are two triplets shown, while @code{\times} was only
-used once
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
-
-@noindent
-For more information about @code{make-moment}, see
-@ref{Time administration}.
-
-The format of the number is determined by the property @code{text} in
-@code{TupletNumber}.  The default prints only the denominator, but if
-it is set to the function @code{tuplet-number::calc-fraction-text},
-@var{num}:@var{den} will be printed instead.
-
-To avoid printing tuplet numbers, use
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-\override TupletNumber #'transparent = ##t
-\times 2/3 { c8 c c } \times 2/3 { c8 c c }
-@end lilypond
-
-Use the @code{\tweak} function to override nested tuplets beginning at the
-same music moment.  In this example, @code{\tweak} specifies fraction
-text for the
-outer @code{TupletNumber} and denominator text for the @code{TupletNumber}
-of the first of the three inner tuplets.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \times 4/3 {
-     \tweak #'text #tuplet-number::calc-denominator-text
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Here @code{\tweak} and @code{\override} work together to specify
-@code{TupletBracket} direction.  The first @code{\tweak} positions
-the @code{TupletBracket} of the outer
-tuplet above the staff.  The second @code{\tweak} positions the
-@code{TupletBracket} of the first of the three inner tuplets below the
-staff.  Note that this pair of @code{\tweak} functions affects only
-the outer tuplet and the first of the three inner tuplets because only
-those two tuplets begin at the same music moment.  We use @code{\override}
-in the usual way to position the @code{TupletBrackets} of
-the second and third of the inner tuplets below the staff.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff {
-  \tweak #'text #tuplet-number::calc-fraction-text
-  \tweak #'direction #up
-  \times 4/3 {
-     \tweak #'direction #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \override TupletBracket #'direction = #down
-     \times 2/3 { c'8[ c'8 c'8] }
-     \times 2/3 { c'8[ c'8 c'8] }
-  }
-}
-@end lilypond
-
-Tuplet brackets can be made to run to prefatory matter or
-the next note
-
-@lilypond[ragged-right]
-\new RhythmicStaff {
-  \set tupletFullLength = ##t
-  \time 4/4
-  \times 4/5 {
-    c4 c1
-  }
-  \set tupletFullLengthNote = ##t
-  \time 2/4
-  \times 2/3 {
-    c4 c c 
-  }
-  \time 3/4
-  c4 
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{TupletBracket},
-@internalsref{TupletNumber}, and @internalsref{TimeScaledMusic}.
-
-
-
-@node Scaling durations
-@subsection Scaling durations
-
-You can alter the length of duration by a fraction @var{N/M}
-appending @samp{*@var{N/M}} (or @samp{*@var{N}} if @var{M=1}).  This
-will not affect the appearance of the notes or rests produced.  These
-may be combined such as @samp{*M*N}.
-
-In the following example, the first three notes take up exactly two
-beats, but no triplet bracket is printed.
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\time 2/4
-a4*2/3 gis4*2/3 a4*2/3
-a4 a4 a4*2
-b16*4 c4
-@end lilypond
-
-
-@seealso
-
-This manual: @ref{Tuplets}.
-
-
-@node Bar check
-@subsection Bar check
-
-@cindex Bar check
-@funindex barCheckSynchronize
-@funindex |
-
-Bar checks help detect errors in the durations.  A bar check is
-entered using the bar symbol, @samp{|}.  Whenever it is encountered
-during interpretation, it should fall on a measure boundary.  If it
-does not, a warning is printed.  In the next example, the second bar
-check will signal an error
-@example
-\time 3/4 c2 e4 | g2 |
-@end example
-
-Bar checks can also be used in lyrics, for example
-
-@example
-\lyricmode @{
-  \time 2/4
-  Twin -- kle | Twin -- kle
-@}
-@end example
-
-Failed bar checks are caused by entering incorrect
-durations.  Incorrect durations often completely garble up the score,
-especially if the score is polyphonic, so a good place to start correcting
-input is by scanning for failed bar checks and incorrect durations.
-
-@funindex |
-@funindex pipeSymbol
-
-It is also possible to redefine the meaning of @code{|}.  This is done
-by assigning a music expression to @code{pipeSymbol},
-
-@lilypond[quote,ragged-right,verbatim]
-pipeSymbol = \bar "||"
-
-{ c'2 c' | c'2 c' }
-@end lilypond
-
-
-@node Barnumber check
-@subsection Barnumber check
-
-When copying large pieces of music, it can be helpful to check that
-the LilyPond bar number corresponds to the original that you are
-entering from.  This can be checked with @code{\barNumberCheck}, for
-example,
-
-@verbatim
-\barNumberCheck #123
-@end verbatim
-
-@noindent
-will print a warning if the @code{currentBarNumber} is not 123 when it
-is processed.
-
-
-@node Automatic note splitting
-@subsection Automatic note splitting
-
-Long notes can be converted automatically to tied notes.  This is done
-by replacing the @internalsref{Note_heads_engraver} by the
-@internalsref{Completion_heads_engraver}.
-In the following examples, notes crossing the bar line are split and tied.
-
-@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
-\new Voice \with {
-  \remove "Note_heads_engraver"
-  \consists "Completion_heads_engraver"
-} {
-  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
-}
-@end lilypond
-
-This engraver splits all running notes at the bar line, and inserts
-ties.  One of its uses is to debug complex scores: if the measures are
-not entirely filled, then the ties exactly show how much each measure
-is off.
-
-If you want to allow line breaking on the bar lines where
-@internalsref{Completion_heads_engraver} splits notes, you must
-also remove @internalsref{Forbid_line_break_engraver}.
-
-
-@refbugs
-
-Not all durations (especially those containing tuplets) can be
-represented exactly with normal notes and dots, but the engraver will
-not insert tuplets.
-
-@code{Completion_heads_engraver} only affects notes; it does not split
-rests.
-
-
-@seealso
-
-Program reference: @internalsref{Completion_heads_engraver}.
-
-
-@node Polyphony
-@section Polyphony
-
-Polyphony in music refers to having more than one voice occurring in
-a piece of music.  Polyphony in LilyPond refers to having more than
-one voice on the same staff.
-
-@menu
-* Chords::                      
-* Stems::                       
-* Basic polyphony::             
-* Explicitly instantiating voices::  
-* Collision Resolution::        
-@end menu
-
-
-@node Chords
-@subsection Chords
-
-@cindex Chords
-
-A chord is formed by a enclosing a set of pitches between @code{<}
-and @code{>}.  A chord may be followed by a duration, and a set of
-articulations, just like simple notes
-
-@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
-@end lilypond
-
-For more information about chords, see @ref{Chord names}.
-
-
-@c  I don't like having this here, but I can't think of
-@c  anywhere else to put it.  :(   -gp
-@node Stems
-@subsection Stems
-
-Whenever a note is found, a @internalsref{Stem} object is created
-automatically.  For whole notes and rests, they are also created but
-made invisible.
-
-@refcommands
-
-@funindex \stemUp
-@code{\stemUp},
-@funindex \stemDown
-@code{\stemDown},
-@funindex \stemNeutral
-@code{\stemNeutral}.
-
-
-@commonprop
-
-To change the direction of stems in the middle of the staff, use
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
-
-
-@node Basic polyphony
-@subsection Basic polyphony
-
-@cindex polyphony
-
-The easiest way to enter fragments with more than one voice on a staff
-is to enter each voice as a sequence (with @code{@{...@}}), and combine
-them simultaneously, separating the voices with @code{\\}
-
-@funindex \\
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  c16 d e f
-  <<
-    { g4 f e | d2 e2 } \\
-    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
-    { s2. | s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-The separator causes @internalsref{Voice} contexts@footnote{Polyphonic
-voices are sometimes called @q{layers} in other notation packages}
-@cindex layers
-to be instantiated.  They bear the names @code{"1"}, @code{"2"}, etc.  In
-each of these contexts, vertical direction of slurs, stems, etc., is set
-appropriately.
-
-These voices are all separate from the voice that contains the notes just
-outside the @code{<< \\ >>} construct.  This should be noted when making
-changes at the voice level.  This also means that slurs and ties cannot go
-into or out of a @code{<< \\ >>} construct.  Conversely, parallel voices
-from separate @code{<< \\ >>} constructs on the same staff are the
-same voice.  Here is the same example, with different noteheads and
-colors for each
-voice.  Note that the change to the note-head style in the main voice does
-not affect
-the inside of the @code{<< \\ >>} constructs.  Also, the change to the
-second
-voice in the first @code{<< \\ >>} construct is effective in the second
-@code{<< \\ >>}, and the voice is tied across the two constructs.
-
-@cindex note heads, styles
-
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  <<
-    { g4 f e } \\
-    { \override NoteHead #'style = #'triangle
-      \override NoteHead #'color = #blue
-    r8 e4 d c8 ~ }
-  >> |
-  <<
-    { d2 e2 } \\
-    { c8 b16 a b8 g ~ g2 } \\
-    { \override NoteHead #'style = #'slash 
-      \override NoteHead #'color = #green
-      s4 b4 c2 }
-  >>
-}
-@end lilypond
-
-Polyphony does not change the relationship of notes within a
-@code{\relative @{ @}} block.  Each note is calculated relative
-to the note immediately preceding it.
-
-@example
-\relative @{ noteA << noteB \\ noteC >> noteD @}
-@end example
-
-@code{noteC} is relative to @code{noteB}, not @code{noteA};
-@code{noteD} is relative to @code{noteC}, not @code{noteB} or
-@code{noteA}.
-
-
-@node Explicitly instantiating voices
-@subsection Explicitly instantiating voices
-
-@internalsref{Voice} contexts can also be instantiated manually
-inside a @code{<< >>} block to create polyphonic music, using
-@code{\voiceOne}, up to @code{\voiceFour} to assign stem directions
-and a horizontal shift for each part.
-
-Specifically,
-@example
-<< \upper \\ \lower >>
-@end example
-
-@noindent
-is equivalent to
-
-@example
-<<
-  \new Voice = "1" @{ \voiceOne \upper @}
-  \new Voice = "2" @{ \voiceTwo \lower @}
->>
-@end example
-
-The @code{\voiceXXX} commands set the direction of stems, slurs, ties,
-articulations, text annotations, augmentation dots of dotted
-notes, and fingerings.  @code{\voiceOne} and @code{\voiceThree} make
-these objects point upwards, while @code{\voiceTwo} and @code{\voiceFour}
-make them point downwards.
-The command @code{\oneVoice} will revert back to the normal setting.
-
-An expression that appears directly inside a @code{<< >>} belongs to
-the main voice.  This is useful when extra voices appear while the main
-voice is playing.  Here is a more correct rendition of the example from
-the previous section.  The crossed colored noteheads demonstrate that the main
-melody is now in a single voice context.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2 }
-    \new Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. | s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-The correct definition of the voices allows the melody to be slurred.
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
-      \oneVoice
-    }
-    \new Voice { \voiceThree
-      s2. s4 b4 c2
-      \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-Avoiding the @code{\\} separator also allows nesting polyphony
-constructs, which in some case might be a more natural way to typeset
-the music.
-
-@lilypond[quote,ragged-right,verbatim]
-\new Staff \relative c' {
-  c16^( d e f
-  \voiceOne
-  <<
-    { g4 f e | d2 e2) }
-    \context Voice="1" { \voiceTwo
-      r8 e4 d c8 ~ |
-      <<
-        {c8 b16 a b8 g ~ g2}
-        \new Voice { \voiceThree
-          s4 b4 c2
-          \oneVoice
-        }
-      >>
-    \oneVoice
-    }
-  >>
-  \oneVoice
-}
-@end lilypond
-
-In some instances of complex polyphonic music, you may need additional
-voices to avoid collisions between notes.  Additional voices are added
-by defining an identifier, as shown below:
-
-@lilypond[quote,verbatim,ragged-right,relative=2]
-voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
-
-\relative c''' <<
-  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
-  { \voiceThree  b4} \\
-  { \voiceFive d,} \\
-  { \voiceTwo g,}
->>
-@end lilypond
-
-
-@node Collision Resolution
-@subsection Collision Resolution
-
-Normally, note heads with a different number of dots are not merged, but
-when the object property @code{merge-differently-dotted} is set in
-the @internalsref{NoteCollision} object, they are merged:
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice << {
-  g8 g8
-  \override Staff.NoteCollision
-    #'merge-differently-dotted = ##t
-  g8 g8
-} \\ { g8.[ f16] g8.[ f16] } >>
-@end lilypond
-
-Similarly, you can merge half note heads with eighth notes, by setting
-@code{merge-differently-headed}:
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\new Voice << {
-  c8 c4.
-  \override Staff.NoteCollision
-    #'merge-differently-headed = ##t
-c8 c4. } \\ { c2 c2 } >>
-@end lilypond
-
-@noindent
-@code{merge-differently-headed} and @code{merge-differently-dotted}
-only apply to opposing stem directions (ie. Voice 1 & 2).
-
-LilyPond also vertically shifts rests that are opposite of a stem,
-for example
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new Voice << c''4 \\ r4 >>
-@end lilypond
-
-If three or more notes line up in the same column,
-@code{merge-differently-headed} cannot
-successfully complete the merge of the two notes that should be merged.
-To allow the merge to work properly, apply a @code{\shift} to the note that
-should not be merged.  In the first measure of following example,
-@code{merge-differently-headed} does not work (the half-note head is
-solid).  In the second measure, @code{\shiftOn} is applied to move the
-top @code{g} out of the column, and @code{merge-differently-headed}
-works properly.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-<<
-  { d=''2 g2 } \\
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-<<
-  { d'=''2 \shiftOn g2 } \\ 
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
-@end lilypond
-
-
-@refcommands
-
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
-
-@funindex \shiftOn
-@code{\shiftOn},
-@funindex \shiftOnn
-@code{\shiftOnn},
-@funindex \shiftOnnn
-@code{\shiftOnnn},
-@funindex \shiftOff
-@code{\shiftOff}: these commands specify the
-degree to which chords of the current voice should be shifted.
-The outer voices (normally: voice one and
-two) have @code{\shiftOff}, while the inner voices (three and four)
-have @code{\shiftOn}.  @code{\shiftOnn} and @code{\shiftOnnn} define
-further shift levels.
-
-When LilyPond cannot cope, the @code{force-hshift}
-property of the @internalsref{NoteColumn} object and pitched rests can
-be used to override typesetting decisions.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative <<
-{
-  <d g>
-  <d g>
-} \\ {
-  <b f'>
-  \once \override NoteColumn #'force-hshift = #1.7
-  <b f'>
-} >>
-@end lilypond
-
-
-@seealso
-
-Program reference: the objects responsible for resolving collisions are
-@internalsref{NoteCollision} and @internalsref{RestCollision}.
-
-
-@refbugs
-
-When using @code{merge-differently-headed} with an upstem eighth or a
-shorter note, and a downstem half note, the eighth note gets the wrong
-offset.
-
-There is no support for clusters where the same note occurs with
-different accidentals in the same chord.  In this case, it is
-recommended to use enharmonic transcription, or to use special cluster
-notation (see @ref{Clusters}).
-
-
-
-@node Staff notation
-@section Staff notation
-
-@cindex Staff notation
-
-This section describes music notation that occurs on staff level,
-such as key signatures, clefs and time signatures.
-
-@menu
-* Clef::                        
-* Key signature::               
-* Time signature::              
-* Partial measures::            
-* Bar lines::                   
-* Unmetered music::             
-* System start delimiters::     
-* Staff symbol::                
-* Writing music in parallel::   
-@end menu
-
-
-@node Clef
-@subsection Clef
-
-@funindex \clef
-
-The clef indicates which lines of the staff correspond to which
-pitches.  The clef is set with the @code{\clef} command
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-{ c''2 \clef alto g'2 }
-@end lilypond
-
-@cindex treble clef
-@cindex violin clef
-@cindex alto clef
-@cindex tenor clef
-@cindex bass clef
-@cindex french clef
-@cindex soprano clef
-@cindex mezzosoprano clef
-@cindex baritone clef
-@cindex varbaritone clef
-@cindex subbass clef
-
-Supported clefs include
-
-@multitable @columnfractions .33 .66
-@headitem Clef @tab Position
-@item @code{treble}, violin, G, G2 @tab
-G clef on 2nd line
-@item @code{alto, C} @tab
-C clef on 3rd line
-@item @code{tenor} @tab
-C clef on 4th line.
-@item @code{bass, F} @tab
-F clef on 4th line
-@item @code{french} @tab
-G clef on 1st line, so-called French violin clef
-@item @code{soprano} @tab
-C clef on 1st line
-@item @code{mezzosoprano} @tab
-C clef on 2nd line
-@item @code{baritone} @tab
-C clef on 5th line
-@item @code{varbaritone} @tab
-F clef on 3rd line
-@item @code{subbass} @tab
-F clef on 5th line
-@item @code{percussion} @tab
-percussion clef
-@item @code{tab} @tab
-tablature clef
-@end multitable
-
-By adding @code{_8} or @code{^8} to the clef name, the clef is
-transposed one octave down or up, respectively, and @code{_15} and
-@code{^15} transposes by two octaves.  The argument @var{clefname}
-must be enclosed in quotes when it contains underscores or digits.  For
-example,
-
-@cindex choral tenor clef
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\clef "G_8" c4
-@end lilypond
-
-
-@commonprop
-
-The command @code{\clef "treble_8"} is equivalent to setting
-@code{clefGlyph},
-@code{clefPosition} (which controls the Y position of the clef),
-@code{middleCPosition} and @code{clefOctavation}.  A clef is printed
-when any of these properties are changed.  The following example shows
-possibilities when setting properties manually.
-
-@lilypond[quote,ragged-right,verbatim]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
-@end lilypond
-
-
-@seealso
-
-Manual: @ref{Grace notes}.
-
-Program reference: @internalsref{Clef}.
-
-
-@node Key signature
-@subsection Key signature
-
-@cindex Key signature
-@funindex \key
-
-The key signature indicates the tonality in which a piece is played.  It
-is denoted by a set of alterations (flats or sharps) at the start of the
-staff.
-
-Setting or changing the key signature is done with the @code{\key}
-command
-
-@example
-@code{\key} @var{pitch} @var{type}
-@end example
-
-@funindex \minor
-@funindex \major
-@funindex \minor
-@funindex \ionian
-@funindex \locrian
-@funindex \aeolian
-@funindex \mixolydian
-@funindex \lydian
-@funindex \phrygian
-@funindex \dorian
-@cindex church modes
-
-Here, @var{type} should be @code{\major} or @code{\minor} to get
-@var{pitch}-major or @var{pitch}-minor, respectively.  You may also
-use the standard mode names (also called @q{church modes}): @code{\ionian},
-@code{\locrian}, @code{\aeolian}, @code{\mixolydian}, @code{\lydian},
-@code{\phrygian}, and @code{\dorian}.
-
-This command sets the context property
-@code{Staff.keySignature}.  Non-standard key signatures
-can be specified by setting this property directly.
-
-Accidentals and key signatures often confuse new users, because
-unaltered notes get natural signs depending on the key signature.  For
-more information, see @ref{Accidentals}, or @ref{Accidentals and key signatures}.
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\key g \major
-f1
-fis
-@end lilypond
-
-
-@commonprop
-
-A natural sign is printed to cancel any previous accidentals.  This
-can be suppressed by setting the @code{Staff.printKeyCancellation}
-property.
-
-@lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-\set Staff.printKeyCancellation = ##f
-\key d \major
-a b cis d
-\key g \minor
-a bes c d
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{KeyCancellation},
-@internalsref{KeySignature}.
-
-
-@node Time signature
-@subsection Time signature
-
-@cindex Time signature
-@cindex meter
-@funindex \time
-
-Time signature indicates the metrum of a piece: a regular pattern of
-strong and weak beats.  It is denoted by a fraction at the start of the
-staff.
-
-The time signature is set with the @code{\time} command
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 2/4 c'2 \time 3/4 c'2.
-@end lilypond
-
-@commonprop
-
-The symbol that is printed can be customized with the @code{style}
-property.  Setting it to @code{#'()} uses fraction style for 4/4 and
-2/2 time,
-
-@lilypond[fragment,quote,ragged-right,verbatim]
-\time 4/4 c'1
-\time 2/2 c'1
-\override Staff.TimeSignature #'style = #'()
-\time 4/4 c'1
-\time 2/2 c'1
-@end lilypond
-
-There are many more options for its layout.  See @ref{Ancient time
-signatures}, for more examples.
-
-@code{\time} sets the property @code{timeSignatureFraction},
-@code{beatLength} and @code{measureLength} in the @code{Timing}
-context, which is normally aliased to @internalsref{Score}.  The
-property @code{measureLength} determines where bar lines should be
-inserted, and how automatic beams should be generated.  Changing the
-value of @code{timeSignatureFraction} also causes the symbol to be
-printed.
-
-More options are available through the Scheme function
-@code{set-time-signature}.  In combination with the
-@internalsref{Measure_grouping_engraver}, it will create
-@internalsref{MeasureGrouping} signs.  Such signs ease reading
-rhythmically complex modern music.  In the following example, the 9/8
-measure is subdivided in 2, 2, 2 and 3.  This is passed to
-@code{set-time-signature} as the third argument @code{(2 2 2 3)}
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  \relative c'' {
-    #(set-time-signature 9 8 '(2 2 2 3))
-    g8[ g] d[ d] g[ g] a8[( bes g]) |
-    #(set-time-signature 5 8 '(3 2))
-    a4. g4
-  }
-  \layout {
-    \context {
-      \Staff
-      \consists "Measure_grouping_engraver"
-    }
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{TimeSignature}, and
-@internalsref{Timing_translator}.
-
-Examples: @lsr{contemporary,compound-time-signature.ly}.
-
-
-@refbugs
-
-Automatic beaming does not use the measure grouping specified with
-@code{set-time-signature}.
-
-
-@node Partial measures
-@subsection Partial measures
-
-@cindex anacrusis
-@cindex upbeat
-@cindex partial measure
-@cindex measure, partial
-@cindex shorten measures
-@funindex \partial
-
-Partial measures, such as an anacrusis or upbeat, are entered using the
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\partial 16*5 c16 cis d dis e | a2. c,4 | b2
-@end lilypond
-
-The syntax for this command is
-
-@example
-\partial @var{duration}
-@end example
-
-where @code{duration} is the rhythmic length to be added before
-the next bar.
-
-This is internally translated into
-
-@example
-\set Timing.measurePosition = -@var{length of duration}
-@end example
-
-The property @code{measurePosition} contains a rational number
-indicating how much of the measure has passed at this point.  Note
-that this is a negative number; @code{\partial 4} is internally
-translated to mean @qq{there is a quarter note left in the bar.}
-
-
-@refbugs
-
-This command does not take into account grace notes at the start of
-the music.  When a piece starts with graces notes in the pickup, then
-the @code{\partial} should follow the grace notes
-
-@lilypond[verbatim,quote,ragged-right,relative,fragment]
-\grace f16
-\partial 4
-g4
-a2 g2
-@end lilypond
-
-@code{\partial} is only intended to be used at the beginning of a
-piece.  If you use it after the beginning, some odd warnings may
-occur.
-
-
-@node Bar lines
-@subsection Bar lines
-
-@cindex Bar lines
-@funindex \bar
-@cindex measure lines
-@cindex repeat bars
-
-Bar lines delimit measures, but are also used to indicate
-repeats.  Normally they are inserted automatically.  Line
-breaks may only happen on bar lines.
-
-Special types of bar lines can be forced with the @code{\bar} command
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-c4 \bar "|:" c4
-@end lilypond
-
-The following bar types are available
-
-@lilypondfile[ragged-right,quote]{bar-lines.ly}
-
-In addition, you can specify @code{"||:"}, which is equivalent to 
-@code{"|:"} except at line breaks, where it gives a double bar line at
-the end of the line and a start repeat at the beginning of the next
-line. 
-
-To allow a line break where there is no visible bar line, use
-
-@example
-\bar ""
-@end example
-
-@noindent
-This will insert an invisible bar line and allow line breaks at this
-point (without increasing the bar number counter).
-
-In scores with many staves, a @code{\bar} command in one staff is
-automatically applied to all staves.  The resulting bar lines are
-connected between different staves of a @code{StaffGroup},
-@code{PianoStaff}, or @code{GrandStaff}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-<<
-  \new StaffGroup <<
-    \new Staff {
-      e'4 d'
-      \bar "||"
-      f' e'
-    }
-    \new Staff { \clef bass c4 g e g }
-  >>
-  \new Staff { \clef bass c2 c2 }
->>
-@end lilypond
-
-
-@commonprop
-
-@funindex whichBar
-@funindex repeatCommands
-@funindex defaultBarType
-
-The command @code{\bar }@var{bartype} is a short cut for doing
-@code{\set Timing.whichBar = }@var{bartype}.  Whenever @code{whichBar}
-is set to a string, a bar line of that type is created.
-
-A bar line is created whenever the @code{whichBar} property is set.
-At the start of a measure it is set to the contents of
-@code{Timing.defaultBarType}.  The contents of @code{repeatCommands} are
-used
-to override default measure bars.
-
-You are encouraged to use @code{\repeat} for repetitions.  See
-@ref{Repeats}.
-
-
-@seealso
-
-In this manual: @ref{Repeats}, @ref{System start delimiters}.
-
-Program reference: @internalsref{BarLine} (created at
-@internalsref{Staff} level), @internalsref{SpanBar} (across staves).
-
-
-@node Unmetered music
-@subsection Unmetered music
-
-@cindex cadenza
-@funindex \cadenzaOn
-@funindex \cadenzaOff
-
-Bar lines and bar numbers are calculated automatically.  For unmetered
-music (cadenzas, for example), this is not desirable.  To turn off
-automatic bar lines and bar numbers, use the commands @code{\cadenzaOn}
-and @code{\cadenzaOff}.
-
-@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
-c4 d e d
-\cadenzaOn
-c4 c d8 d d f4 g4.
-\cadenzaOff
-\bar "|"
-d4 e d c
-@end lilypond
-
-
-@refbugs
-
-LilyPond will only insert line breaks and page breaks at a
-barline.  Unless the unmetered music ends before the end of
-the staff line, you will need to insert
-invisible bar lines
-
-@example
-\bar ""
-@end example
-
-@noindent
-to indicate where breaks can occur.
-
-
-@node System start delimiters
-@subsection System start delimiters
-
-@cindex start of system
-@cindex Staff, multiple
-@cindex bracket, vertical
-@cindex brace, vertical
-@cindex grand staff
-@cindex staff group
-@cindex staff, choir
-
-Many scores consist of more than one staff.  These staves can be
-joined in four different ways
-
-@itemize @bullet
-@item The group is started with a brace at the left, and bar lines are
-connected.  This is done with the @internalsref{GrandStaff} context.
-
-@lilypond[verbatim,ragged-right,quote]
-\new GrandStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item The group is started with a bracket, and bar lines are connected.
-This is done with the
-@internalsref{StaffGroup} context
-
-@lilypond[verbatim,ragged-right,quote]
-\new StaffGroup
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item The group is started with a bracket, but bar lines are not
-connected.  This is done with the @internalsref{ChoirStaff} context.
-
-@lilypond[verbatim,ragged-right,quote]
-\new ChoirStaff
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-
-@item The group is started with a vertical line.  Bar lines are not
-connected.  This is the default for the score.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative <<
-  \new Staff { c1 c }
-  \new Staff { c c }
->>
-@end lilypond
-@end itemize
-
-
-@seealso
-
-The bar lines at the start of each system are
-@internalsref{SystemStartBar}, @internalsref{SystemStartBrace}, and
-@internalsref{SystemStartBracket}.  Only one of these types is created
-in every context, and that type is determined by the property
-@code{systemStartDelimiter}.
-
-
-@commonprop
-
-System start delimiters may be deeply nested,
-
-@lilypond[quote,ragged-right,verbatim]
-\new StaffGroup
-\relative <<
-  \set StaffGroup.systemStartDelimiterHierarchy
-    = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
-  \new Staff { c1 }
->>
-@end lilypond
-
-
-@node Staff symbol
-@subsection Staff symbol
-
-@cindex adjusting staff symbol
-
-Notes, dynamic signs, etc., are grouped
-with a set of horizontal lines, called a staff (plural @q{staves}).  In
-LilyPond, these lines are drawn using a separate layout object called
-@code{staff symbol}.
-
-The staff symbol may be tuned in the number, thickness and distance
-of lines, using properties.  This is demonstrated in the example files
-@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} and
-@lsr{staff,changing-the-staff-size.ly}.
-
-In addition, staves may be started and stopped at will. This is done
-with @code{\startStaff} and @code{\stopStaff}.
-
-@lilypond[verbatim,relative=2,fragment]
-b4 b
-\override Staff.StaffSymbol #'line-count = 2
-\stopStaff \startStaff
-b b
-\revert Staff.StaffSymbol #'line-count
-\stopStaff \startStaff
-b b
-@end lilypond
-
-In combination with Frenched staves, this may be used to typeset ossia
-sections. An example is shown here
-
-@cindex ossia
-
-@lilypondfile{ossia.ly}
-
-@cindex staff lines, setting number of
-@cindex staff lines, setting thickness of
-@cindex thickness of staff lines, setting
-@cindex number of staff lines, setting
-
-@seealso
-
-Program reference: @internalsref{StaffSymbol}.
-
-Examples: @lsrdir{staff}
-
-
-@node Writing music in parallel
-@subsection Writing music in parallel
-
-@cindex Writing music in parallel
-@cindex Interleaved music
-
-Music for multiple parts can be interleaved
-
-@lilypond[quote,fragment,verbatim]
-\parallelMusic #'(voiceA voiceB) {
-  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
-  c'2                                c'2                                |
-  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
-  c'2                                c'2                                |
-}
-\new StaffGroup <<
-  \new Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
->>
-@end lilypond
-
-This works quite well for piano music
-
-@lilypond[quote,verbatim]
-music = {
-  \key c \major
-  \time 4/4
-  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
-    % Bar 1
-    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
-e''] |
-    c'2                                 c'2 |
-    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
-    c2                                  c2 |
-
-    % Bar 2
-    a'8 b'      c'' d''    e'' f''    g'' a'' |
-    d'4         d'         d'         d' |
-    c16 d e f   d e f g    e f g a    f g a b |
-    a,4         a,4        a,4        a,4 |
-
-    % Bar 3 ...
-  }
-}
-
-\score {
-  \new PianoStaff <<
-    \music
-    \new Staff <<
-      \voiceA \\
-      \voiceB
-    >>
-    \new Staff {
-      \clef bass
-      <<
-        \voiceC \\
-        \voiceD
-      >>
-    }
-  >>
-}
-@end lilypond
-
-
-@node Connecting notes
-@section Connecting notes
-
-This section deals with notation that affects groups of notes.
-
-@menu
-* Ties::                        
-* Slurs::                       
-* Phrasing slurs::              
-* Laissez vibrer ties::         
-* Automatic beams::             
-* Manual beams::                
-* Grace notes::                 
-@end menu
-
-
-@node Ties
-@subsection Ties
-
-@cindex tie
-@funindex ~
-
-A tie connects two adjacent note heads of the same pitch.  The tie in
-effect extends the length of a note.  Ties should not be confused with
-slurs, which indicate articulation, or phrasing slurs, which indicate
-musical phrasing.  A tie is entered using the tilde symbol @samp{~}
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-e' ~ e' <c' e' g'> ~ <c' e' g'>
-@end lilypond
-
-When a tie is applied to a chord, all note heads whose pitches match
-are connected.  When no note heads match, no ties will be created.  Chords
-may be partially tied by placing the tie inside the chord,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-<c~ e g~ b> <c e g b>
-@end lilypond
-
-A tie is just a way of extending a note duration, similar to the
-augmentation dot.  The following example shows two ways of notating
-exactly the same concept
-
-@lilypond[quote,fragment,ragged-right]
-\time 3/4 c'2. c'2 ~ c'4
-@end lilypond
-
-@noindent
-Ties are used either when the note crosses a bar line, or when dots
-cannot be used to denote the rhythm.  When using ties, larger note
-values should be aligned to subdivisions of the measure, such as
-
-@lilypond[fragment,quote,ragged-right]
-\relative {
-  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
-}
-@end lilypond
-
-If you need to tie a lot of notes over bars, it may be easier to use
-automatic note splitting (see @ref{Automatic note splitting}).  This
-mechanism automatically splits long notes, and ties them across bar
-lines.
-
-@funindex \repeatTie
-
-When a second alternative of a repeat starts with a tied note, you
-have to repeat the tie. This can be achieved with @code{\repeatTie},
-
-@lilypond[fragment,quote,ragged-right,relative=2]
-r <c e g>\repeatTie
-@end lilypond
-
-@cindex repeating ties
-@cindex volta brackets and ties
-
-@commonprop
-
-Ties are sometimes used to write out arpeggios.  In this case, two tied
-notes need not be consecutive.  This can be achieved by setting the
-@code{tieWaitForNote} property to true. The same feature is also useful,
-for example, to tie a tremolo to a chord. For example,
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-\set tieWaitForNote = ##t
-\grace { c16[~ e~ g]~ } <c, e g>2
-\repeat tremolo 8 { c32~ c'~ } <c c,>1
-e8~ c~ a~ f~ <e' c a f>2
-@end lilypond
-
-Ties may be engraved manually by changing the @code{tie-configuration}
-property.  The first number indicates the distance from the center
-of the staff in staff-spaces, and the second number indicates the
-direction (1=up, -1=down).
-
-@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
-<c e g>2~ <c e g> |
-\override TieColumn #'tie-configuration =
-  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
-<c e g>~ <c e g> |
-@end lilypond
-
-
-@refcommands
-
-
-@funindex \tieUp
-@code{\tieUp},
-@funindex \tieDown
-@code{\tieDown},
-@funindex \tieNeutral
-@code{\tieNeutral},
-@funindex \tieDotted
-@code{\tieDotted},
-@funindex \tieDashed
-@code{\tieDashed},
-@funindex \tieSolid
-@code{\tieSolid}.
-
-
-@seealso
-
-In this manual: @ref{Automatic note splitting}.
-
-Program reference: @internalsref{Tie}.
-
-
-@refbugs
-
-Switching staves when a tie is active will not produce a slanted tie.
-
-Changing clefs or octavations during a tie is not really
-well-defined.  In these cases, a slur may be preferable.
-
-
-@node Slurs
-@subsection Slurs
-
-@cindex Slurs
-
-A slur indicates that notes are to be played bound or
-@emph{legato}.  They are entered using parentheses
-
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-f( g a) a8 b( a4 g2 f4)
-<c e>2( <b d>2)
-@end lilypond
-
-The direction of a slur can be specified with
-@code{\slur@emph{DIR}}, where @code{@emph{DIR}} is
-either @code{Up}, @code{Down}, or @code{Neutral} (automatically
-selected).
-
-However, there is a convenient shorthand for forcing slur
-directions.  By adding @code{_} or @code{^} before the opening
-parentheses, the direction is also set.  For example,
-
-@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
-c4_( c) c^( c)
-@end lilypond
-
-Only one slur can be printed at once.  If you need to print a long
-slur over a few small slurs, please see @ref{Phrasing slurs}.
-
-
-@commonprop
-
-Some composers write two slurs when they want legato chords.  This can
-be achieved in LilyPond by setting @code{doubleSlurs},
-
-@lilypond[verbatim,ragged-right,relative,fragment,quote]
-\set doubleSlurs = ##t
-<c e>4 ( <d f> <c e> <d f> )
-@end lilypond
-
-
-@refcommands
-
-@funindex \slurUp
-@code{\slurUp},
-@funindex \slurDown
-@code{\slurDown},
-@funindex \slurNeutral
-@code{\slurNeutral},
-@funindex \slurDashed
-@code{\slurDashed},
-@funindex \slurDotted
-@code{\slurDotted},
-@funindex \slurSolid
-@code{\slurSolid}.
-
-@seealso
-
-Program reference: @seeinternals{Slur}.
-
-
-@node Phrasing slurs
-@subsection Phrasing slurs
-
-@cindex phrasing slurs
-@cindex phrasing marks
-
-A phrasing slur (or phrasing mark) connects notes and is used to
-indicate a musical sentence.  It is written using @code{\(} and @code{\)}
-respectively
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-\time 6/4 c'\( d( e) f( e) d\)
-@end lilypond
-
-Typographically, the phrasing slur behaves almost exactly like a
-normal slur.  However, they are treated as different objects.  A
-@code{\slurUp} will have no effect on a phrasing slur; instead, use
-@code{\phrasingSlurUp}, @code{\phrasingSlurDown}, and
-@code{\phrasingSlurNeutral}.
-
-You cannot have simultaneous phrasing slurs.
-
-
-@refcommands
-
-@funindex \phrasingSlurUp
-@code{\phrasingSlurUp},
-@funindex \phrasingSlurDown
-@code{\phrasingSlurDown},
-@funindex \phrasingSlurNeutral
-@code{\phrasingSlurNeutral}.
-
-
-@seealso
-
-Program reference: @internalsref{PhrasingSlur}.
-
-
-@node Laissez vibrer ties
-@subsection Laissez vibrer ties
-@cindex Laissez vibrer
-@cindex Ties, laissez vibrer
-
-L.v. ties (laissez vibrer) indicate that notes must not be damped at the
-end. It is used in notation for piano, harp and other string and
-percussion instruments. They can be entered using @code{\laissezVibrer},
-
-@lilypond[fragment,ragged-right,verbatim,relative=1]
-<c f g>\laissezVibrer
-@end lilypond
-
-@seealso
-
-Program reference:
-@internalsref{LaissezVibrerTie}
-@internalsref{LaissezVibrerTieColumn}
-
-Example files:
-@lsr{connecting,laissez-vibrer-ties.ly}
-
-
-@node Automatic beams
-@subsection Automatic beams
-
-LilyPond inserts beams automatically
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
-@end lilypond
-
-When these automatic decisions are not good enough, beaming can be
-entered explicitly.  It is also possible to define beaming patterns
-that differ from the defaults.  See @ref{Setting automatic beam behavior},
-for details.
-
-Individual notes may be marked with @code{\noBeam} to prevent them
-from being beamed
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\time 2/4 c8 c\noBeam c c
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{Beam}.
-
-
-@node Manual beams
-@subsection Manual beams
-
-@cindex beams, manual
-@funindex ]
-@funindex [
-
-In some cases it may be necessary to override the automatic beaming
-algorithm.  For example, the autobeamer will not put beams over rests
-or bar lines.  Such beams are specified manually by marking the begin
-and end point with @code{[} and @code{]}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-  r4 r8[ g' a r8] r8 g[ | a] r8
-}
-@end lilypond
-
-
-@commonprop
-
-@funindex stemLeftBeamCount
-@funindex stemRightBeamCount
-
-
-LilyPond can automatically determine beaming patterns within a beam,
-but this automatic behavior can sometimes produce odd results;
-therefore the @code{stemLeftBeamCount} and @code{stemRightBeamCount} properties can
-be used to override the defaults.  If
-either property is set, its value will be used only once, and then it
-is erased.
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-{
-   f8[ r16
-      f g a]
-   f8[ r16
-   \set stemLeftBeamCount = #1
-      f g a]
-}
-@end lilypond
-
-The property @code{subdivideBeams} can be set in order to subdivide
-all 16th or shorter beams at beat positions, as defined by the
-@code{beatLength} property.
-
-@lilypond[fragment,quote,relative=2,verbatim]
-c16[ c c c c c c c]
-\set subdivideBeams = ##t
-c16[ c c c c c c c]
-\set Score.beatLength = #(ly:make-moment 1 8)
-c16[ c c c c c c c]
-@end lilypond
-@funindex subdivideBeams
-
-@noindent
-For more information about @code{make-moment}, see
-@ref{Time administration}.
-
-Line breaks are normally forbidden when beams cross bar lines.  This
-behavior can be changed by setting @code{breakable}.
-
-@funindex breakable
-
-@cindex beams and line breaks
-@cindex beams, kneed
-@cindex kneed beams
-@cindex auto-knee-gap
-
-Kneed beams are inserted automatically when a large gap is detected
-between the note heads.  This behavior can be tuned through the
-@code{auto-knee-gap} object.
-
-
-@refbugs
-
-Automatically kneed cross-staff beams cannot be used together with
-hidden staves.  See @ref{Hiding staves}.
-
-@c Is this still true with skyline spacing stuff? -J.Mandereau
-Beams do not avoid collisions with symbols around the notes, such as
-texts and accidentals.
-
-
-@node Grace notes
-@subsection Grace notes
-
-@funindex \grace
-@cindex ornaments
-@cindex grace notes
-@cindex appoggiatura
-@cindex acciaccatura
-
-Grace notes are ornaments that are written out.  The most common ones
-are acciaccatura, which should be played as very short.  It is denoted
-by a slurred small note with a slashed stem.  The appoggiatura is a
-grace note that takes a fixed fraction of the main note, and is
-denoted as a slurred note in small print without a slash.  They
-are entered with the commands @code{\acciaccatura} and
-@code{\appoggiatura}, as demonstrated in the following example
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-b4 \acciaccatura d8 c4 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
-@end lilypond
-
-Both are special forms of the @code{\grace} command.  By prefixing this
-keyword to a music expression, a new one is formed, which will be
-printed in a smaller font and takes up no logical time in a measure.
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2 c4
-@end lilypond
-
-@noindent
-Unlike @code{\acciaccatura} and @code{\appoggiatura}, the
-@code{\grace} command does not start a slur.
-
-@cindex timing, internal
-
-Internally, timing for grace notes is done using a second, @q{grace}
-timing.  Every point in time consists of two rational numbers: one
-denotes the logical time, one denotes the grace timing.  The above
-example is shown here with timing tuples
-
-@lilypond[quote,ragged-right]
-<<
-  \relative c''{
-    c4 \grace c16 c4 \grace {
-    c16[ d16] } c2 c4
-  }
-  \new Lyrics \lyricmode {
-    \override LyricText #'font-family = #'typewriter
-
-    \markup { (0,0) } 4
-    \grace { \markup {
-      ( \fraction 1 4 , \fraction -1 16 ) } 16 }
-    \markup { (\fraction 1 4 , 0 ) } 4
-    \grace {
-      \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
-      \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
-    }
-    \markup { ( \fraction 2 4 , 0 ) }
-  }
->>
-@end lilypond
-
-The placement of grace notes is synchronized between different staves.
-In the following example, there are two sixteenth grace notes for
-every eighth grace note
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \grace { c16[ d e f] } e4 }
-   \new Staff { c4 \grace { g8[ b] } c4 } >>
-@end lilypond
-
-@funindex \afterGrace
-
-If you want to end a note with a grace, use the @code{\afterGrace}
-command.  It takes two arguments: the main note, and the grace notes
-following the main note.
-
-@lilypond[ragged-right, verbatim,relative=2,fragment]
-c1 \afterGrace d1 { c16[ d] } c4
-@end lilypond
-
-This will put the grace notes after a @q{space} lasting 3/4 of the
-length of the main note.  The fraction 3/4 can be changed by setting
-@code{afterGraceFraction}, ie.
-
-@example
-#(define afterGraceFraction (cons 7 8))
-@end example
-
-@noindent
-will put the grace note at 7/8 of the main note.
-
-The same effect can be achieved manually by doing
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  << { d1^\trill_( }
-     { s2 \grace { c16[ d] } } >>
-  c4)
-}
-@end lilypond
-
-@noindent
-By adjusting the duration of the skip note (here it is a half-note),
-the space between the main-note and the grace is adjusted.
-
-A @code{\grace} music expression will introduce special typesetting settings,
-for example, to produce smaller type, and set directions.  Hence, when
-introducing layout tweaks, they should be inside the grace expression,
-for example,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Voice {
-  \acciaccatura {
-    \stemDown
-    f16->
-    \stemNeutral
-  }
-  g4
-}
-@end lilypond
-
-@noindent
-The overrides should also be reverted inside the grace expression.
-
-The layout of grace expressions can be changed throughout the music
-using the function @code{add-grace-property}.  The following example
-undefines the @code{Stem} direction for this grace, so that stems do not
-always point up.
-
-@example
-\new Staff @{
-  #(add-grace-property 'Voice 'Stem 'direction '())
-  @dots{}
-@}
-@end example
-
-@noindent
-Another option is to change the variables @code{startGraceMusic},
-@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
-@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic},
-@code{stopAppoggiaturaMusic}.  More information is in the file
-@file{ly/@/grace@/-init@/.ly}.
-
-@noindent
-The slash through the stem in acciaccaturas can be obtained
-in other situations by @code{\override Stem  #'stroke-style = #"grace"}.
-
-
-@commonprop
-
-Grace notes may be forced to use floating spacing,
-
-@lilypond[relative=2,ragged-right]
-<<
-  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
-  \new Staff {
-     c'4
-     \afterGrace
-     c'4
-     { c'16[ c'8 c'16] }
-     c'4
-  }  
-  \new Staff {
-     c'16[ c'16 c'16 c'16]
-     c'16[ c'16 c'16 c'16]
-     c'4
-  }
->>
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{GraceMusic}.
-
-
-@refbugs
-
-A score that starts with a @code{\grace} expression needs an explicit
-@code{\new Voice} declaration, otherwise the main note and the grace
-note end up on different staves.
-
-Grace note synchronization can also lead to surprises.  Staff notation,
-such as key signatures, bar lines, etc., are also synchronized.  Take
-care when you mix staves with grace notes and staves without, for example,
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" d4 } >>
-@end lilypond
-
-@noindent
-This can be remedied by inserting grace skips of the corresponding
-durations in the other staves. For the above example
-
-@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
-<< \new Staff { e4 \bar "|:" \grace c16 d4 }
-   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
-@end lilypond
-
-Grace sections should only be used within sequential music
-expressions.  Nesting or juxtaposing grace sections is not supported,
-and might produce crashes or other errors.
-
-
-
-@node Expressive marks
-@section Expressive marks
-
-Expressive marks help musicians to bring more to the music than simple
-notes and rhythms.
-
-@menu
-* Articulations::               
-* Fingering instructions::      
-* Dynamics::                    
-* Breath marks::                
-* Trills::                      
-* Glissando::                   
-* Arpeggio::                    
-* Falls and doits::             
-@end menu
-
-
-@node Articulations
-@subsection Articulations
-
-@cindex Articulations
-@cindex scripts
-@cindex ornaments
-
-A variety of symbols can appear above and below notes to indicate
-different characteristics of the performance.  They are added to a note
-by adding a dash and the character signifying the
-articulation.  They are demonstrated here
-
-@lilypondfile[quote,ragged-right]{script-abbreviations.ly}
-
-The meanings of these shorthands can be changed.  See
-@file{ly/@/script@/-init@/.ly} for examples.
-
-The script is automatically placed, but the direction can be forced as
-well.  Like other pieces of LilyPond code, @code{_} will place them
-below the staff, and @code{^} will place them above.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c''4^^ c''4_^
-@end lilypond
-
-Other symbols can be added using the syntax
-@var{note}@code{\}@var{name}.  Again, they
-can be forced up or down using @code{^} and @code{_},
-e.g.,
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c\fermata c^\fermata c_\fermata
-@end lilypond
-
-@cindex accent
-@cindex marcato
-@cindex staccatissimo
-@cindex espressivo
-@cindex fermata
-@cindex stopped
-@cindex staccato
-@cindex portato
-@cindex tenuto
-@cindex upbow
-@cindex downbow
-@cindex foot marks
-@cindex organ pedal marks
-@cindex turn
-@cindex open
-@cindex stopped
-@cindex flageolet
-@cindex reverseturn
-@cindex trill
-@cindex prall
-@cindex mordent
-@cindex prallprall
-@cindex prallmordent
-@cindex prall, up
-@cindex prall, down
-@cindex thumb marking
-@cindex segno
-@cindex coda
-@cindex varcoda
-
-Here is a chart showing all scripts available,
-
-@lilypondfile[ragged-right,quote]{script-chart.ly}
-
-
-@commonprop
-
-The vertical ordering of scripts is controlled with the
-@code{script-priority} property.  The lower this number, the closer it
-will be put to the note.  In this example, the
-@internalsref{TextScript} (the sharp symbol) first has the lowest
-priority, so it is put lowest in the first example.  In the second, the
-prall trill (the @internalsref{Script}) has the lowest, so it is on the
-inside.  When two objects have the same priority, the order in which
-they are entered decides which one comes first.
-
-@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
-\once \override TextScript #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-
-\once \override Script #'script-priority = #-100
-a4^\prall^\markup { \sharp }
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{Script}.
-
-
-@refbugs
-
-These signs appear in the printed output but have no effect on the
-MIDI rendering of the music.
-
-
-@node Fingering instructions
-@subsection Fingering instructions
-
-@cindex fingering
-@cindex finger change
-
-Fingering instructions can be entered using
-@example
-@var{note}-@var{digit}
-@end example
-For finger changes, use markup texts
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
-@end lilypond
-
-You can use the thumb-script to indicate that a note should be
-played with the thumb (e.g., in cello music)
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
-@end lilypond
-
-Fingerings for chords can also be added to individual notes
-of the chord by adding them after the pitches
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
-@end lilypond
-
-
-@commonprop
-
-You may exercise greater control over fingering chords by
-setting @code{fingeringOrientations}
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-Using this feature, it is also possible to put fingering instructions
-very close to note heads in monophonic music,
-
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{Fingering}.
-
-Examples: @lsr{expressive,fingering-chords.ly}
-
-
-@node Dynamics
-@subsection Dynamics
-
-@cindex Dynamics
-@funindex \pppp
-@funindex \ppp
-@funindex \pp
-@funindex \p
-@funindex \mp
-@funindex \mf
-@funindex \f
-@funindex \ff
-@funindex \fff
-@funindex \ffff
-@funindex \fp
-@funindex \sf
-@funindex \sff
-@funindex \sp
-@funindex \spp
-@funindex \sfz
-@funindex \rfz
-
-Absolute dynamic marks are specified using a command after a note
-@code{c4\ff}.  The available dynamic marks are @code{\ppppp},
-@code{\pppp}, @code{\ppp},
-@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
-@code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
-@code{\sp}, @code{\spp}, @code{\sfz}, and @code{\rfz}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
-c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
-@end lilypond
-
-@funindex \<
-@funindex \>
-@funindex \!
-
-A crescendo mark is started with @code{\<} and terminated with
-@code{\!} or an absolute dynamic.  A decrescendo is started with
-@code{\>} and is also terminated with @code{\!} or an absolute
-dynamic.  @code{\cr} and @code{\decr} may be used instead of
-@code{\<} and @code{\>}.  Because these marks are bound to notes, you must
-use spacer notes if multiple marks are needed during one note
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\< c\! d\> e\!
-<< f1 { s4 s4\< s4\! \> s4\! } >>
-@end lilypond
-
-@noindent
-A hairpin normally starts at the left edge of the beginning note
-and ends on the right edge of the ending note.  If the ending
-note falls on the downbeat, the hairpin ends on the immediately
-preceding barline. This may be modified by setting the
-@code{hairpinToBarline} property,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set hairpinToBarline = ##f
-c4\< c2. c4\!
-@end lilypond
-
-In some situations the @code{\espressivo} articulation mark may
-be suitable to indicate a crescendo and decrescendo on the one note,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c2 b4 a g1\espressivo
-@end lilypond
-
-This may give rise to very short hairpins.  Use @code{minimum-length}
-in @internalsref{Voice}.@internalsref{Hairpin} to lengthen them, for
-example
-
-@example
-\override Voice.Hairpin #'minimum-length = #5
-@end example
-
-@cindex al niente
-@cindex niente, al
-
-Hairpins may be printed with a circled tip (al niente notation) by
-setting the @code{circled-tip} property,
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\override Hairpin #'circled-tip = ##t
-c2\< c\!
-c4\> c\< c2\!
-@end lilypond
-
-
-@cindex crescendo
-@cindex decrescendo
-@cindex diminuendo
-
-You can also use text saying @emph{cresc.} instead of hairpins
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\setTextCresc
-c\< d e f\!
-\setHairpinCresc
-e\> d c b\!
-\setTextDecresc
-c\> d e f\!
-\setTextDim
-e\> d c b\!
-@end lilypond
-
-You can also supply your own texts
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\set crescendoText = \markup { \italic "cresc. poco" }
-\set crescendoSpanner = #'dashed-line
-a'2\< a a a\!\mf
-@end lilypond
-
-To create new dynamic marks or text that should be aligned
-with dynamics, see @ref{New dynamic marks}.
-
-Vertical positioning of dynamics is handled by
-@internalsref{DynamicLineSpanner}.
-
-
-@commonprop
-
-Dynamics that occur at, begin on, or end on, the same note
-will be vertically aligned.  If you want to ensure that dynamics
-are aligned when they do not occur on the same note, you can
-increase the @code{staff-padding} property.
-
-@example
-\override DynamicLineSpanner #'staff-padding = #4
-@end example
-
-You may also use this property if the dynamics are colliding
-with other notation.
-
-Crescendi and decrescendi that end on the first note of a
-new line are not printed.  To change this behavior, use
-
-@example
-\override Score.Hairpin #'after-line-breaking = ##t
-@end example
-
-Text style dynamic changes (such as @emph{cresc.} and @emph{dim.})
-are printed with a
-dashed line showing their extent.  To surpress printing this line, use
-
-@example
-\override DynamicTextSpanner #'dash-period = #-1.0
-@end example
-
-
-@refcommands
-
-@funindex \dynamicUp
-@code{\dynamicUp},
-@funindex \dynamicDown
-@code{\dynamicDown},
-@funindex \dynamicNeutral
-@code{\dynamicNeutral}.
-
-
-@seealso
-
-Program reference: @internalsref{DynamicText}, @internalsref{Hairpin}.
-Vertical positioning of these symbols is handled by
-@internalsref{DynamicLineSpanner}.
-
-
-@node Breath marks
-@subsection Breath marks
-
-Breath marks are entered using @code{\breathe}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-c'4 \breathe d4
-@end lilypond
-
-
-@commonprop
-
-The glyph of the breath mark can be tuned by overriding the
-@code{text} property of the @code{BreathingSign} layout object with
-any markup text.  For example,
-@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
-c'4
-\override BreathingSign #'text
-  = #(make-musicglyph-markup "scripts.rvarcomma")
-\breathe
-d4
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{BreathingSign}.
-
-Examples: @lsr{expressive,breathing-sign.ly}
-
-
-@node Trills
-@subsection Trills
-
-Short trills are printed like normal articulation; see @ref{Articulations}.
-
-Long running trills are made with @code{\startTrillSpan} and
-@code{\stopTrillSpan},
-
-@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
-\new Voice {
-  << { c1 \startTrillSpan }
-     { s2. \grace { d16[\stopTrillSpan e] } } >>
-  c4 }
-@end lilypond
-
-@cindex Pitched trills
-
-Trills that should be executed on an explicitly specified pitch can be
-typeset with the command @code{pitchedTrill},
-
-@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
-\pitchedTrill c4\startTrillSpan fis
-f\stopTrillSpan
-@end lilypond
-
-@noindent
-The first argument is the main note.  The pitch of the second
-is printed as a stemless note head in parentheses.
-
-
-@refcommands
-
-@code{\startTrillSpan},
-@funindex \startTrillSpan
-@code{\stopTrillSpan}.
-@funindex \stopTrillSpan
-
-
-@seealso
-
-Program reference: @internalsref{TrillSpanner}.
-
-
-@node Glissando
-@subsection Glissando
-
-@cindex Glissando
-@funindex \glissando
-
-A glissando is a smooth change in pitch.  It is denoted by a line or a
-wavy line between two notes.  It is requested by attaching
-@code{\glissando} to a note
-
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-c2\glissando c'
-\override Glissando #'style = #'zigzag
-c2\glissando c,
-@end lilypond
-
-
-@commonprop
-
-@lilypond[quote,ragged-right,verbatim]
-I = \once \override NoteColumn #'ignore-collision = ##t
-
-\relative <<
-  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
-  { \oneVoice \I c2 \glissando \I d, }
->>
-@end lilypond
-
-
-
-@seealso
-
-Program reference: @internalsref{Glissando}.
-
-Example files:
-@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
-
-
-@refbugs
-
-Printing text over the line (such as @emph{gliss.}) is not supported.
-
-
-@node Arpeggio
-@subsection Arpeggio
-
-@cindex Arpeggio
-@cindex broken chord
-@funindex \arpeggio
-
-You can specify an arpeggio sign (also known as broken chord) on a
-chord by attaching an @code{\arpeggio} to a chord
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-<c e g c>\arpeggio
-@end lilypond
-
-A square bracket on the left indicates that the player should not
-arpeggiate the chord
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\arpeggioBracket
-<c' e g c>\arpeggio
-@end lilypond
-
-The direction of the arpeggio is sometimes denoted by adding an
-arrowhead to the wiggly line
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new Voice {
-  \arpeggioUp
-  <c e g c>\arpeggio
-  \arpeggioDown
-  <c e g c>\arpeggio
-}
-@end lilypond
-
-
-@commonprop
-
-When an arpeggio crosses staves, you may attach an arpeggio to the chords
-in both staves and set
-@internalsref{PianoStaff}.@code{connectArpeggios}
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \set PianoStaff.connectArpeggios = ##t
-  \new Staff { <c' e g c>\arpeggio }
-  \new Staff { \clef bass <c,, e g>\arpeggio }
->>
-@end lilypond
-
-@c TODO: cross-voice arpeggio example?
-@c such an example is already in LSR -J.Mandereau
-
-@refcommands
-
-@code{\arpeggio},
-@funindex \arpeggioUp
-@code{\arpeggioUp},
-@funindex \arpeggioDown
-@code{\arpeggioDown},
-@funindex \arpeggioNeutral
-@code{\arpeggioNeutral},
-@funindex \arpeggioBracket
-@code{\arpeggioBracket}.
-
-
-@seealso
-
-Notation manual: @ref{Ties}, for writing out arpeggios.
-
-Program reference: @internalsref{Arpeggio}.
-
-
-@refbugs
-
-It is not possible to mix connected arpeggios and unconnected
-arpeggios in one @internalsref{PianoStaff} at the same point in time.
-
-
-@node Falls and doits
-@subsection Falls and doits
-
-Falls and doits can be added to notes using the @code{\bendAfter}
-command,
-
-@lilypond[fragment,ragged-right,relative=2]
-\override Score.SpacingSpanner #'shortest-duration-space = #3.0
-c4-\bendAfter #+5
-c4-\bendAfter #-3
-@end lilypond
-
-
-@node Repeats
-@section Repeats
-
-Repetition is a central concept in music, and multiple notations exist
-for repetitions.
-
-@menu
-* Repeat types::                
-* Repeat syntax::               
-* Repeats and MIDI::            
-* Manual repeat commands::      
-* Tremolo repeats::             
-* Tremolo subdivisions::        
-* Measure repeats::             
-@end menu
-
-
-@node Repeat types
-@subsection Repeat types
-
-@cindex repeats
-
-The following types of repetition are supported
-
-@table @code
-@item unfold
-Repeated music is fully written (played) out.  This is useful when
-entering repetitious music.  This is the only kind of repeat that
-is included in MIDI output.
-
-@item volta
-Repeats are not written out, but alternative endings (volte) are
-printed, left to right with brackets.  This is the standard notation
-for repeats with alternatives.  These are not played in MIDI output by
-default.
-
-
-@item tremolo
-Make tremolo beams.  These are not played in MIDI output by default.
-
-@item percent
-Make beat or measure repeats.  These look like percent signs.  These
-are not played in MIDI output by default.  Percent repeats must be
-declared within a @code{Voice} context.
-
-@end table
-
-
-@node Repeat syntax
-@subsection Repeat syntax
-
-@cindex volta
-@cindex prima volta
-@cindex seconda volta
-@funindex \repeat
-
-LilyPond has one syntactic construct for specifying different types of
-repeats.  The syntax is
-
-@example
-\repeat @var{variant} @var{repeatcount} @var{repeatbody}
-@end example
-
-If you have alternative endings, you may add
-@funindex \alternative
-@example
-\alternative @{
-  @var{alternative1}
-  @var{alternative2}
-  @var{alternative3}
-  @dots{}
-@}
-@end example
-
-@noindent
-where each @var{alternative} is a music expression.  If you do not
-give enough alternatives for all of the repeats, the first alternative
-is assumed to be played more than once.
-
-Standard repeats are used like this
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 { c4 d e f }
-\repeat volta 2 { f e d c }
-@end lilypond
-
-With alternative endings
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f}
-\alternative { {d2 d} {f f,} }
-@end lilypond
-
-Repeats with upbeats may be created.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 e |
-  \repeat volta 4 { c2 d2 | e2 f2 | }
-  \alternative { { g4 g g e } { a a a a | b2. } }
-}
-@end lilypond
-
-@noindent
-or
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\new Staff {
-  \partial 4 
-  \repeat volta 4 { e | c2 d2 | e2 f2 | }
-  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
-}
-@end lilypond
-
-
-
-@funindex \repeatTie
-
-Ties may be added to a second ending,
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c1
-\repeat volta 2 {c4 d e f ~ }
-\alternative { {f2 d} {f\repeatTie f,} }
-@end lilypond
-
-It is possible to shorten volta brackets
-by setting @code{voltaSpannerDuration}.  In the next example, the
-bracket only lasts one measure, which is a duration of 3/4.
-
-@lilypond[verbatim,ragged-right,quote]
-\relative c''{
-  \time 3/4
-  c c c
-  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
-  \repeat volta 5 { d d d }
-  \alternative { { e e e f f f }
-  { g g g } }
-}
-@end lilypond
-
-If you want to start a repeat at the beginning of a line and have a
-double bar at the end of the previous line, use
-@example
-@dots{} \bar "||:" \break 
-\repeat volta 2 @{ @dots{} 
-@end example
-see @ref{Bar lines} for more information.
-
-@seealso
-
-Program reference: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic}, and
-@internalsref{UnfoldedRepeatedMusic}.
-
-Examples:
-
-Brackets for the repeat are normally only printed over the topmost
-staff.  This can be adjusted by moving @code{Volta_engraver} to the
-Staff context where you want the brackets to appear;
-see @ref{Modifying context plug-ins} and
-
-@lsr{repeats,volta@/-multi@/-staff@/.ly}.
-
-
-@refbugs
-
-@cindex repeat, ambiguous
-
-A nested repeat like
-
-@example
-\repeat @dots{}
-\repeat @dots{}
-\alternative
-@end example
-
-@noindent
-is ambiguous, since it is is not clear to which @code{\repeat} the
-@code{\alternative} belongs.  This ambiguity is resolved by always
-having the @code{\alternative} belong to the inner @code{\repeat}.
-For clarity, it is advisable to use braces in such situations.
-
-Timing information is not remembered at the start of an alternative,
-so after a repeat timing information must be reset by hand; for
-example, by setting @code{Score.measurePosition} or entering
-@code{\partial}.  Similarly, slurs or ties are also not repeated.
-
-
-@node Repeats and MIDI
-@subsection Repeats and MIDI
-
-@cindex expanding repeats
-@funindex \unfoldRepeats
-
-With a little bit of tweaking, all types of repeats can be present
-in the MIDI output.  This is achieved by applying the
-@code{\unfoldRepeats} music function.  This function changes all
-repeats to unfold repeats.
-
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
-  \repeat tremolo 8 {c'32 e' }
-  \repeat percent 2 { c''8 d'' }
-  \repeat volta 2 {c'4 d' e' f'}
-  \alternative {
-    { g' a' a' g' }
-    {f' e' d' c' }
-  }
-}
-\bar "|."
-@end lilypond
-
-When creating a score file using @code{\unfoldRepeats} for MIDI,
-it is necessary to make two @code{\score} blocks: one for MIDI (with
-unfolded repeats) and one for notation (with volta, tremolo, and
-percent repeats).  For example,
-
-@example
-\score @{
-  @var{..music..}
-  \layout @{ .. @}
-@}
-\score @{
-  \unfoldRepeats @var{..music..}
-  \midi @{ .. @}
-@}
-@end example
-
-
-@node Manual repeat commands
-@subsection Manual repeat commands
-
-@funindex repeatCommands
-
-The property @code{repeatCommands} can be used to control the layout of
-repeats.  Its value is a Scheme list of repeat commands.
-
-@table @asis
-@item @code{start-repeat}
-Print a @code{|:} bar line.
-
-@item @code{end-repeat}
-Print a @code{:|} bar line.
-
-@item @code{(volta @var{text})}
-Print a volta bracket saying @var{text}: The text can be specified as
-a text string or as a markup text, see @ref{Text markup}.  Do not
-forget to change the font, as the default number font does not contain
-alphabetic characters;
-
-@item @code{(volta #f)}
-Stop a running volta bracket.
-@end table
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c4
-  \set Score.repeatCommands = #'((volta "93") end-repeat)
-c4 c4
-  \set Score.repeatCommands = #'((volta #f))
-c4 c4
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{VoltaBracket},
-@internalsref{RepeatedMusic},
-@internalsref{VoltaRepeatedMusic}, and
-@internalsref{UnfoldedRepeatedMusic}.
-
-
-@node Tremolo repeats
-@subsection Tremolo repeats
-
-@cindex tremolo beams
-
-To place tremolo marks between notes, use @code{\repeat} with tremolo
-style
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat tremolo 8 { c16 d16 }
-  \repeat tremolo 4 { c16 d16 }
-  \repeat tremolo 2 { c16 d16 }
-}
-@end lilypond
-
-Tremolo marks can also be put on a single note.  In this case, the
-note should not be surrounded by braces.
-@lilypond[quote,verbatim,ragged-right]
-\repeat tremolo 4 c'16
-@end lilypond
-
-Similar output is obtained using the tremolo subdivision, described in
-@ref{Tremolo subdivisions}.
-
-
-@seealso
-
-In this manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
-
-Program reference: @internalsref{Beam}, @internalsref{StemTremolo}.
-
-
-@node Tremolo subdivisions
-@subsection Tremolo subdivisions
-
-@cindex tremolo marks
-@funindex tremoloFlags
-
-Tremolo marks can be printed on a single note by adding
-@q{@code{:}[@var{number}]} after the note.  The number indicates the
-duration of the subdivision, and it must be at least 8.  A
-@var{length} value of 8 gives one line across the note stem.  If the
-length is omitted, the last value (stored in @code{tremoloFlags}) is
-used
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-c'2:8 c':32 | c': c': |
-@end lilypond
-
-
-@refbugs
-
-Tremolos entered in this way do not carry over into the MIDI output.
-
-
-@seealso
-
-In this manual: @ref{Tremolo repeats}.
-
-Elsewhere: @internalsref{StemTremolo}.
-
-
-@node Measure repeats
-@subsection Measure repeats
-
-@cindex percent repeats
-@cindex measure repeats
-
-In the @code{percent} style, a note pattern can be repeated.  It is
-printed once, and then the pattern is replaced with a special sign.
-Patterns of one and two measures are replaced by percent-like signs,
-patterns that divide the measure length are replaced by slashes.
-Percent repeats must be declared within a @code{Voice} context.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
-  \repeat percent 4 { c4 }
-  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Measure repeats of more than 2 measures get a counter, if you switch
-on the @code{countPercentRepeats} property,
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
-  \repeat percent 4 { c1 }
-}
-@end lilypond
-
-
-
-Isolated percents can also be printed. This is done by putting a
-multi-measure rest with a different print function,
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
-  = #ly:multi-measure-rest::percent
-R1
-@end lilypond
-
-
-
-
-@seealso
-
-Program reference: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
-
-
-
diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index 17a782b8fb..92959d8667 100644
--- a/Documentation/user/changing-defaults.itely
+++ b/Documentation/user/changing-defaults.itely
@@ -39,7 +39,7 @@ but is also included with the LilyPond documentation package.
 
 There are four areas where the default settings may be changed:
 
-@itemize @bullet
+@itemize
 @item
 Automatic notation: changing the automatic creation of notation
 elements.  For example, changing the beaming rules.
@@ -63,584 +63,16 @@ Internally, LilyPond uses Scheme (a LISP dialect) to provide
 infrastructure.  Overriding layout decisions in effect accesses the
 program internals, which requires Scheme input.  Scheme elements are
 introduced in a @code{.ly} file with the hash mark
-@code{#}.@footnote{@ref{Scheme tutorial}, contains a short tutorial
+@code{#}.@footnote{@rlearning{Scheme tutorial}, contains a short tutorial
 on entering numbers, lists, strings, and symbols in Scheme.}
 
 
 @menu
-* Automatic notation::          
 * Interpretation contexts::     
 * The \override command::       
 @end menu
 
 
-@node Automatic notation
-@section Automatic notation
-
-This section describes how to change the way that accidentals and
-beams are automatically displayed.
-
-@menu
-* Automatic accidentals::       
-* Setting automatic beam behavior::  
-@end menu
-
-@node Automatic accidentals
-@subsection Automatic accidentals
-@cindex Automatic accidentals
-
-Common rules for typesetting accidentals have been placed in a
-function.  This function is called as follows
-
-@funindex set-accidental-style
-@example
-#(set-accidental-style 'STYLE)
-@end example
-
-@c TODO: check the context stuff below
-@c -does it *really* work?
-@c -the default contexts as specified in
-@c  scm/music-function.scm seem to be different -vv
-
-Optionally, the function can take two arguments: the name of the
-accidental style, and an optional argument that denotes the context that
-should be changed:
-
-@example
-#(set-accidental-style 'STYLE #('CONTEXT#))
-@end example
-
-If no context name is supplied, @code{Staff} is the default,
-but you may wish to apply the accidental style to a single @code{Voice}
-instead.
-
-The following accidental styles are supported:
-
-@table @code
-@item default
-This is the default typesetting behavior.  It corresponds
-to 18th century common practice: Accidentals are
-remembered to the end of the measure in which they occur and
-only on their own octave.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       %#(set-accidental-style 'default) 
-       \musicA }
-       \context Staff = "down"{
-	       %#(set-accidental-style 'default)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
-}
-@end lilypond
-
-@item voice
-The normal behavior is to remember the accidentals on
-Staff-level.  This variable, however, typesets accidentals
-individually for each voice.  Apart from that, the rule is similar to
-@code{default}.
-
-@example
- \new Staff <<
-        #(set-accidental-style 'voice)
-	@{ @dots{} @}
-	>>
-@end example
-
-As a result, accidentals from one voice do not get canceled in other
-voices, which is often an unwanted result: in the following example, it
-is hard to determine whether the second @samp{a} should be played
-natural or sharp.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'voice) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
-}
-@end lilypond
-
-The @code{voice} option should be used if the voices
-are to be read solely by individual musicians.  If the staff is to be
-used by one musician (e.g., a conductor) then
-@code{modern} or @code{modern-cautionary}
-should be used instead.
-
-@item modern
-@funindex modern style accidentals
-This rule corresponds to the common practice in the 20th century.  This rule
-prints the same accidentals as @code{default}, but temporary
-accidentals also are canceled in other octaves.  Furthermore,
-in the same octave, they also get canceled in the following
-measure: in the following example, notice the two natural signs which appear
-in the second bar of the upper staff.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'modern) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'modern)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
-}
-@end lilypond
-
-@item @code{modern-cautionary}
-@funindex modern-cautionary
-This rule is similar to @code{modern}, but the @q{extra} accidentals
-(the ones not typeset by @code{default}) are typeset as cautionary
-accidentals.  They are printed in reduced size or (by default)
-with parentheses -- this can be set by definig the @code{cautionary-style}
-property of the @internalsref{AccidentalSuggestion} object.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'modern-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'modern-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
-}
-@end lilypond
-
-@funindex modern-voice
-@item modern-voice
-This rule is used for multivoice accidentals to be read both by musicians
-playing one voice and musicians playing all voices.  Accidentals are
-typeset for each voice, but they @emph{are} canceled across voices in
-the same @internalsref{Staff}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'modern-voice) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'modern-voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
-}
-@end lilypond
-
-@funindex modern-voice-cautionary
-@item modern-voice-cautionary
-This rule is the same as @code{modern-voice}, but with the extra
-accidentals (the ones not typeset by @code{voice}) typeset
-as cautionaries.  Even though all accidentals typeset by
-@code{default} @emph{are} typeset by this variable,
-some of them are typeset as cautionaries.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'modern-voice-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'modern-voice-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
-}
-@end lilypond
-
-@item piano
-@funindex piano accidentals
-This accidental style takes place in a GrandStaff context. However, you have to 
-explicitly set it for @emph{each} individual Staff of the GrandStaff:
-
-@example
-\new GrandStaff @{ <<
-  \new Staff = "up" @{ <<
-    #(set-accidental-style 'piano)
-    @{ @dots{} @}
-  >> @}
-  \new Staff = "down"@{ <<
-    #(set-accidental-style 'piano)
-  @{ @dots{} @}
-  >> @}
->> @}
-@end example
-
-This rule reflects 20th century practice for piano notation.  Its behavior is very
-similar to @code{modern} style, but here accidentals also get canceled
-across the staves in the same @internalsref{GrandStaff} or
-@internalsref{PianoStaff}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'piano) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'piano)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
-}
-@end lilypond
-
-@item piano-cautionary
-@funindex #(set-accidental-style 'piano-cautionary)
-Same as @code{#(set-accidental-style 'piano)} but with the extra
-accidentals typeset as cautionaries.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'piano-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'piano-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
-}
-@end lilypond
-
-@item no-reset
-@funindex no-reset accidental style
-This is the same as @code{default} but with accidentals lasting
-@q{forever} and not only until the next measure:
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'no-reset) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'no-reset)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
-}
-@end lilypond
-
-@item forget
-This is sort of the opposite of @code{no-reset}: Accidentals
-are not remembered at all -- and hence all accidentals are
-typeset relative to the key signature, regardless of what was
-before in the music
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-	\change Staff = up cis' \change Staff = down <fis, a>  
-	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-	<f a d>2 |  } }}
-
-\score { 
-	\new PianoStaff {
-       << \context Staff = "up" {
-	       #(set-accidental-style 'forget) 
-       \musicA }
-       \context Staff = "down"{
-	       #(set-accidental-style 'forget)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
-}
-@end lilypond
-@end table
-
-
-@seealso
-
-Program reference: @internalsref{Accidental_engraver},
-@internalsref{Accidental}, @internalsref{AccidentalSuggestion} and @internalsref{AccidentalPlacement}.
-
-
-@refbugs
-
-Simultaneous notes are considered to be entered in sequential
-mode.  This means that in a chord the accidentals are typeset as if the
-notes in the chord happen one at a time, in the order in which
-they appear in the input file.  This is a problem when accidentals
-in a chord depend on each other,
-which does not happen for the default accidental style.  The problem
-can be solved by manually inserting @code{!} and @code{?} for the
-problematic notes.
-
-
-@node Setting automatic beam behavior
-@subsection Setting automatic beam behavior
-
-@funindex autoBeamSettings
-@funindex (end * * * *)
-@funindex (begin * * * *)
-@cindex automatic beams, tuning
-@cindex tuning automatic beaming
-
-@c [TODO: use \applyContext]
-
-In normal time signatures, automatic beams can start on any note but can
-only end in a few positions within the measure: beams can end on a beat,
-or at durations specified by the properties in
-@code{autoBeamSettings}.  The properties in @code{autoBeamSettings}
-consist of a list of rules for where beams can begin and end.  The
-default @code{autoBeamSettings} rules are defined in
-@file{scm/@/auto@/-beam@/.scm}.
-
-In order to add a rule to the list, use
-@example
-#(override-auto-beam-setting '(be p q n m) a b [context])
-@end example
-
-@itemize @bullet
-
-@item @code{be} is either "begin" or "end".
-
-@item @code{p/q} is the duration of the note for which you want
-to add a rule.  A beam is considered to have the duration of its
-shortest note.  Set @code{p} and @code{q} to @code{'*'} to
-have this apply to any beam.
-
-@item @code{n/m} is the time signature to which
-this rule should apply.  Set @code{n} and @code{m} to @code{'*'}
-to have this apply in any time signature.
-
-@item @code{a/b} is the position in the bar at which the beam should
-begin/end.
-
-@item @code{context} is optional, and it specifies the context at which
-the change should be made.  The default is @code{'Voice}.
-@code{#(score-override-auto-beam-setting '(A B C D) E F)} is equivalent to
-@code{#(override-auto-beam-setting '(A B C D) E F 'Score)}.
-
-@end itemize
-
-For example, if automatic beams should always end on the first quarter
-note, use
-
-@example
-#(override-auto-beam-setting '(end * * * *) 1 4)
-@end example
-
-You can force the beam settings to only take effect on beams whose shortest
-note is a certain duration
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\time 2/4
-#(override-auto-beam-setting '(end 1 16 * *) 1 16)
-a16 a a a a a a a |
-a32 a a a a16 a a a a a |
-#(override-auto-beam-setting '(end 1 32 * *) 1 16)
-a32 a a a a16 a a a a a |
-@end lilypond
-
-You can force the beam settings to only take effect in certain time
-signatures
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\time 5/8
-#(override-auto-beam-setting '(end * * 5 8) 2 8)
-c8 c d d d
-\time 4/4
-e8 e f f e e d d
-\time 5/8
-c8 c d d d
-@end lilypond
-
-You can also remove a previously set beam-ending rule by using
-
-@example
-#(revert-auto-beam-setting '(be p q n m) a b [context])
-@end example
-
-@noindent
-be, p, q, n, m, a, b and context are the same as above.  Note that the
-default rules are specified in @file{scm/@/auto@/-beam@/.scm},
-so you can revert rules that you did not explicitly create.
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\time 4/4
-a16 a a a a a a a a a a a a a a a
-#(revert-auto-beam-setting '(end 1 16 4 4) 1 4)
-a16 a a a a a a a a a a a a a a a
-@end lilypond
-
-The rule in a revert-auto-beam-setting statement must exactly match the
-original rule.  That is, no wildcard expansion is taken into account.
-
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
-\time 1/4
-#(override-auto-beam-setting '(end 1 16 1 4) 1 8)
-a16 a a a
-#(revert-auto-beam-setting '(end 1 16 * *) 1 8) % this won't revert it!
-a a a a
-#(revert-auto-beam-setting '(end 1 16 1 4) 1 8) % this will
-a a a a
-@end lilypond
-
-
-
-@c TODO:  old material -- not covered by above stuff, I think.
-If automatic beams should end on every quarter in 5/4 time, specify
-all endings
-@example
-#(override-auto-beam-setting '(end * * * *) 1 4 'Staff)
-#(override-auto-beam-setting '(end * * * *) 1 2 'Staff)
-#(override-auto-beam-setting '(end * * * *) 3 4 'Staff)
-#(override-auto-beam-setting '(end * * * *) 5 4 'Staff)
-@dots{}
-@end example
-
-The same syntax can be used to specify beam starting points.  In this
-example, automatic beams can only end on a dotted quarter note
-@example
-#(override-auto-beam-setting '(end * * * *) 3 8)
-#(override-auto-beam-setting '(end * * * *) 1 2)
-#(override-auto-beam-setting '(end * * * *) 7 8)
-@end example
-In 4/4 time signature, this means that automatic beams could end only on
-3/8 and on the fourth beat of the measure (after 3/4, that is 2 times
-3/8, has passed within the measure).
-
-If any unexpected beam behaviour occurs, check the default automatic beam
-settings in @file{scm/@/auto@/-beam@/.scm}
-for possible interference, because the beam
-endings defined there will still apply on top of your own overrides. Any
-unwanted endings in the default vales must be reverted for your time
-signature(s).
-
-For example, to typeset @code{(3 4 3 2)}-beam endings in 12/8, begin
-with
-
-@example
-%%% revert default values in scm/auto-beam.scm regarding 12/8 time
-#(revert-auto-beam-setting '(end * * 12 8) 3 8)
-#(revert-auto-beam-setting '(end * * 12 8) 3 4)
-#(revert-auto-beam-setting '(end * * 12 8) 9 8)
-
-%%% your new values
-#(override-auto-beam-setting '(end 1 8 12 8) 3 8)
-#(override-auto-beam-setting '(end 1 8 12 8) 7 8)
-#(override-auto-beam-setting '(end 1 8 12 8) 10 8)
-@end example
-
-@cindex automatic beam generation
-@cindex autobeam
-@funindex autoBeaming
-@cindex lyrics
-
-If beams are used to indicate melismata in songs, then automatic
-beaming should be switched off with @code{\autoBeamOff}.
-
-
-@refcommands
-
-@funindex \autoBeamOff
-@code{\autoBeamOff},
-@funindex \autoBeamOn
-@code{\autoBeamOn}.
-
-@commonprop
-
-Beaming patterns may be altered with the @code{beatGrouping} property,
-
-@lilypond[quote,verbatim,relative=2,fragment,ragged-right]
-\time 5/16
-\set beatGrouping = #'(2 3)
-c8[^"(2+3)" c16 c8]
-\set beatGrouping = #'(3 2)
-c8[^"(3+2)" c16 c8]
-@end lilypond
-
-
-@refbugs
-
-If a score ends while an automatic beam has not been ended and is
-still accepting notes, this last beam will not be typeset at all.  The
-same holds polyphonic voices, entered with @code{<< @dots{} \\ @dots{}
->>}.  If a polyphonic voice ends while an automatic beam is still
-accepting notes, it is not typeset.
-
-
 @node Interpretation contexts
 @section Interpretation contexts
 
@@ -716,7 +148,7 @@ reference, see
 @internalsref{Contexts}.
 @end ifhtml
 @ifnothtml
-Translation @arrow{} Context.
+Translation @expansion{} Context.
 @end ifnothtml
 
 @c [TODO: describe propagation]
@@ -729,7 +161,7 @@ For scores with only one voice and one staff, contexts are
 created automatically.  For more complex scores, it is necessary to
 create them by hand.  There are three commands that do this.
 
-@itemize @bullet
+@itemize
 
 @item
 The easiest command is @code{\new}, and it also the quickest to type.
@@ -981,7 +413,7 @@ program reference, see
 @internalsref{Tunable context properties}.
 @end ifhtml
 @ifnothtml
-Translation @arrow{} Tunable context properties.
+Translation @expansion{} Tunable context properties.
 @end ifnothtml
 
 
@@ -1000,14 +432,14 @@ For a full a description of each plug-in, see
 @internalsref{Engravers}.
 @end ifhtml
 @ifnothtml
-Program reference @arrow Translation @arrow{} Engravers.
+Program reference @expansion{} Translation @expansion{} Engravers.
 @end ifnothtml
 Every context described in
 @ifhtml
 @internalsref{Contexts}
 @end ifhtml
 @ifnothtml
-Program reference @arrow Translation @arrow{} Context.
+Program reference @expansion{} Translation @expansion{} Context.
 @end ifnothtml
 lists the engravers used for that context.
 
@@ -1054,7 +486,7 @@ In the second staff there are no time signature or clef symbols.  This
 is a rather crude method of making objects disappear since it will affect
 the entire staff.  This method also influences the spacing, which may or
 may not be desirable.  A more
-sophisticated method of blanking objects is shown in @ref{Common tweaks}.
+sophisticated method of blanking objects is shown in @rlearning{Common tweaks}.
 
 The next example shows a practical application.  Bar lines and time
 signatures are normally synchronized across the score.  This is done
@@ -1438,7 +870,7 @@ Then the output at the start of this subsection can be entered as
 @subsection Aligning contexts
 
 New contexts may be aligned above or below exisiting contexts.  This
-could be useful in setting up a vocal staff (@ref{Vocal ensembles}) and
+could be useful in setting up a vocal staff (@rlearning{Vocal ensembles}) and
 in ossia,
 
 @cindex ossia
@@ -1464,8 +896,8 @@ ossia = { f4 f f f }
 
 The VerticalAlignment and VerticalAxisGroup grobs work together.
 VerticalAxisGroup groups together different grobs like Staff, Lyrics,
-etc. VerticalAlignment then vertically aligns the different grobs
-grouped together by VerticalAxisGroup. There is usually only one
+etc.  VerticalAlignment then vertically aligns the different grobs
+grouped together by VerticalAxisGroup.  There is usually only one
 VerticalAlignment per score but every Staff, Lyrics, etc. has its own
 VerticalAxisGroup. 
 
@@ -1621,7 +1053,7 @@ Fingering objects are created by: @internalsref{Fingering_engraver} and
 By following related links inside the program reference, we can follow the
 flow of information within the program:
 
-@itemize @bullet
+@itemize
 
 @item @internalsref{Fingering}:
 @internalsref{Fingering} objects are created by:
@@ -1685,7 +1117,7 @@ Each layout object may have several functions as a notational or
 typographical element.  For example, the Fingering object
 has the following aspects
 
-@itemize @bullet
+@itemize
 @item
 Its size is independent of the horizontal spacing, unlike slurs or beams.
 
@@ -1726,7 +1158,7 @@ can be modified.
 
 We have been talking of @emph{the} @code{Fingering} object, but actually it
 does not amount to much.  The initialization file (see
-@ref{Default files})
+@rlearning{Default files})
 @file{scm/@/define@/-grobs@/.scm} shows the soul of the @q{object},
 
 @example
@@ -1848,7 +1280,7 @@ applied.
 This technique only works for objects that are directly connected to
 an @internalsref{Event} from the input, for example
 
-@itemize @bullet
+@itemize
 @item note heads, caused by chord-pitch (i.e., notes inside a chord)
 @item articulation signs, caused by articulation instructions
 @end itemize
@@ -1933,7 +1365,7 @@ change value over time while interpreting a piece of music;
 this.  Context properties are modified with @code{\set}.
 
 There is a special type of context property: the element
-description. These properties are named in @code{StudlyCaps}
+description.  These properties are named in @code{StudlyCaps}
 (starting with capital letters).  They contain the
 @q{default settings} for said graphical object as an
 association list.  See @file{scm/@/define@/-grobs@/.scm}
@@ -1972,7 +1404,7 @@ property (modified with @code{\set}) was created.
 
 There are a few classes of difficult adjustments.
 
-@itemize @bullet
+@itemize
 
 
 @item
@@ -1995,7 +1427,7 @@ objects have been split over different systems.
 In the following example, we define a procedure
 @code{my-callback}.  This procedure
 
-@itemize @bullet
+@itemize
 @item
 determines if we have been split across line breaks
 @item
diff --git a/Documentation/user/chords.itely b/Documentation/user/chords.itely
new file mode 100644
index 0000000000..4a868c0942
--- /dev/null
+++ b/Documentation/user/chords.itely
@@ -0,0 +1,444 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Chords
+@section Chords
+
+Intro text.
+
+@menu
+* Chords sections::             
+@end menu
+
+
+@node Chords sections
+@subsection Chords sections
+
+@menu
+* A lead sheet::                
+* Introducing chord names::     
+* Chords mode::                 
+* Printing chord names::        
+@end menu
+
+@c really awkward; I just shoved this in here from the tutorial.
+@node A lead sheet
+@unnumberedsubsubsec A lead sheet
+
+@cindex Lead sheets
+@cindex chords
+@cindex chord names
+
+In popular music it is common to denote accompaniment with chord
+names.  Such chords can be entered like notes,
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2 f4. g8 }
+@end lilypond
+
+Now each pitch is read as the root of a chord instead of a note.
+This mode is switched on with @code{\chordmode}.  Other chords can
+be created by adding modifiers after a colon.  The following
+example shows a few common modifiers:
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
+@end lilypond
+
+For lead sheets, chords are not printed on staves, but as names on
+a line for themselves.  This is achieved by using @code{\chords}
+instead of @code{\chordmode}.  This uses the same syntax as
+@code{\chordmode}, but renders the notes in a @code{ChordNames}
+context, with the following result:
+
+@lilypond[verbatim,quote,ragged-right]
+\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
+@end lilypond
+
+@cindex lead sheet
+When put together, chord names, lyrics and a melody form a lead
+sheet,
+
+@lilypond[verbatim,quote,ragged-right]
+<<
+  \chords { c2 g:sus4 f e }
+  \relative c'' {
+    a4 e c8 e r4
+    b2 c4( d)
+  }
+  \addlyrics { One day this shall be free __ }
+>>
+@end lilypond
+
+
+@seealso
+@quotation
+A complete list of modifiers and other options for layout can be
+found in @ruser{Chords}.
+@end quotation
+
+
+@node Introducing chord names
+@unnumberedsubsubsec Introducing chord names
+@cindex chord names
+
+LilyPond has support for printing chord names.  Chords may be entered
+in musical chord notation, i.e., @code{< .. >}, but they can also be
+entered by name.  Internally, the chords are represented as a set of
+pitches, so they can be transposed
+
+
+@lilypond[quote,ragged-right,verbatim,ragged-right]
+twoWays = \transpose c c' {
+  \chordmode {
+    c1 f:sus4 bes/f
+  }
+  <c e g>
+  <f bes c'>
+  <f bes d'>
+}
+
+<< \new ChordNames \twoWays
+   \new Voice \twoWays >>
+@end lilypond
+
+This example also shows that the chord printing routines do not try to
+be intelligent.  The last chord (@code{f bes d}) is not interpreted as
+an inversion.
+
+Note that the duration of chords must be specified outside the
+@code{<>}.
+
+@example
+<c e g>2
+@end example
+
+
+@node Chords mode
+@unnumberedsubsubsec Chords mode
+@cindex Chords mode
+
+In chord mode sets of pitches (chords) are entered with normal note
+names.  A chord is entered by the root, which is entered like a
+normal pitch
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { es4. d8 c2 }
+@end lilypond
+
+@noindent
+The mode is introduced by the keyword @code{\chordmode}.
+
+@cindex chord entry
+@cindex chord mode
+
+Other chords may be entered by suffixing a colon and introducing a
+modifier (which may include a number if desired)
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { e1:m e1:7 e1:m7 }
+@end lilypond
+
+The first number following the root is taken to be the @q{type} of the
+chord, thirds are added to the root until it reaches the specified
+number.  The exception is @code{c:13}, for which the 11 is omitted.
+
+@lilypond[quote,fragment,verbatim]
+\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@end lilypond
+
+@cindex root of chord
+@cindex additions, in chords
+@cindex removals, in chords
+
+More complex chords may also be constructed adding separate steps
+to a chord.  Additions are added after the number following
+the colon and are separated by dots
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+@end lilypond
+
+Chord steps can be altered by suffixing a @code{-} or @code{+} sign
+to the number
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+@end lilypond
+
+Removals are specified similarly and are introduced by a caret.  They
+must come after the additions
+
+@lilypond[quote,verbatim,fragment]
+\chordmode { c^3 c:7^5 c:9^3.5 }
+@end lilypond
+
+Modifiers can be used to change pitches.  The following modifiers are
+supported
+
+@table @code
+@item m
+The minor chord.  This modifier lowers the 3rd and (if present) the 7th step.
+
+@item dim
+The diminished chord.  This modifier lowers the 3rd, 5th and (if present)
+the 7th step.
+
+@item aug
+The augmented chord.  This modifier raises the 5th step.
+
+@item maj
+The major 7th chord.  This modifier raises the 7th step if present.
+
+@item sus
+The suspended 4th or 2nd.  This modifier removes the 3rd
+step.  Append either @code{2} or @code{4} to add the 2nd or 4th step to
+the chord.
+@end table
+
+Modifiers can be mixed with additions
+@lilypond[quote,verbatim,fragment]
+  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+@end lilypond
+
+@cindex modifiers, in chords.
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex sus
+@funindex m
+
+Since an unaltered 11 does not sound good when combined with an
+unaltered 13, the 11 is removed in this case (unless it is added
+explicitly)
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c:13 c:13.11 c:m13 }
+@end lilypond
+
+@funindex /
+
+An inversion (putting one pitch of the chord on the bottom), as well
+as bass notes, can be specified by appending
+@code{/}@var{pitch} to the chord
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/g c/f }
+@end lilypond
+@funindex /+
+
+A bass note can be added instead of transposed out of the chord,
+by using @code{/+}@var{pitch}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\chordmode { c1 c/+g c/+f }
+@end lilypond
+
+Chords is a mode similar to @code{\lyricmode}, etc.  Most
+of the commands continue to work, for example, @code{r} and
+@code{\skip} can be used to insert rests and spaces, and property
+commands may be used to change various settings.
+
+
+
+@refbugs
+
+Each step can only be present in a chord once.  The following
+simply produces the augmented chord, since @code{5+} is interpreted
+last
+@cindex clusters
+@lilypond[quote,ragged-right,verbatim,fragment]
+\chordmode { c:5.5-.5+ }
+@end lilypond
+
+
+@node Printing chord names
+@unnumberedsubsubsec Printing chord names
+
+@cindex printing chord names
+@cindex chord names
+@cindex chords
+
+For displaying printed chord names, use the @internalsref{ChordNames} context.
+The chords may be entered either using the notation
+described above, or directly using @code{<} and @code{>}
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = {
+  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+}
+<<
+  \new ChordNames \harmonies
+  \new Staff \harmonies
+>>
+@end lilypond
+
+You can make the chord changes stand out by setting
+@internalsref{ChordNames}.@code{chordChanges} to true.  This will only
+display chord names when there is a change in the chords scheme and at
+the start of a new line
+
+@lilypond[quote,verbatim,ragged-right]
+harmonies = \chordmode {
+  c1:m c:m \break c:m c:m d
+}
+<<
+  \new ChordNames {
+    \set chordChanges = ##t
+    \harmonies }
+  \new Staff \transpose c c' \harmonies
+>>
+@end lilypond
+
+The previous examples all show chords over a staff.  This is not
+necessary.  Chords may also be printed separately.  It may be necessary
+to add @internalsref{Volta_engraver} and @internalsref{Bar_engraver}
+for showing repeats.
+
+@lilypond[ragged-right,verbatim]
+\new ChordNames \with {
+  \override BarLine #'bar-size = #4
+  \consists Bar_engraver
+  \consists "Volta_engraver"
+}
+\chordmode { \repeat volta 2 {
+  f1:maj7 f:7 bes:7
+  c:maj7
+} \alternative {
+  es e
+}
+}
+@end lilypond
+
+
+The default chord name layout is a system for Jazz music, proposed by
+Klaus Ignatzek (see @ref{Literature list}).  It can be tuned through the
+following properties
+
+@table @code
+@funindex chordNameExceptions
+@item chordNameExceptions
+This is a list that contains the chords that have special formatting.
+
+The exceptions list should be encoded as
+@example
+@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
+@end example
+
+To get this information into @code{chordNameExceptions} takes a little
+manoeuvring.  The following code transforms @code{chExceptionMusic}
+(which is a sequential music) into a list of exceptions.
+@example
+(sequential-music-to-chord-exceptions chExceptionMusic #t)
+@end example
+Then,
+@example
+(append
+ (sequential-music-to-chord-exceptions chExceptionMusic #t)
+ ignatzekExceptions)
+@end example
+adds the new exceptions to the default ones, which are defined in
+@file{ly/@/chord@/-modifier@/-init@/.ly}.
+
+For an example of tuning this property, see also
+@lsr{chords,chord@/-name@/-exceptions@/.ly}
+@cindex exceptions, chord names.
+
+
+@funindex majorSevenSymbol
+@item majorSevenSymbol
+This property contains the markup object used for the 7th step, when
+it is major.  Predefined options are @code{whiteTriangleMarkup} and
+@code{blackTriangleMarkup}.  See
+@lsr{chords,chord@/-name@/-major7@/.ly} for an example.
+
+@funindex chordNameSeparator
+@item chordNameSeparator
+Different parts of a chord name are normally separated by a
+slash.  By setting @code{chordNameSeparator}, you can specify other
+separators, e.g.,
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new ChordNames \chordmode {
+  c:7sus4
+  \set chordNameSeparator
+    = \markup { \typewriter "|" }
+  c:7sus4
+}
+@end lilypond
+
+@funindex chordRootNamer
+@item chordRootNamer
+The root of a chord is usually printed as a letter with an optional
+alteration.  The transformation from pitch to letter is done by this
+function.  Special note names (for example, the German @q{H} for a
+B-chord) can be produced by storing a new function in this property.
+
+@funindex chordNoteNamer
+@item chordNoteNamer
+The default is to print single pitch, e.g., the bass note, using the
+@code{chordRootNamer}.  The @code{chordNoteNamer} property can be set
+to a specialized function to change this behavior.  For example, the
+base can be printed in lower case.
+
+@funindex chordPrefixSpacer
+@item chordPrefixSpacer
+The @q{m} for minor chords is usually printed right after the root of
+the chord.  By setting @code{chordPrefixSpacer}, you can fix a spacer
+between the root and @q{m}.  The spacer is not used when the root
+is altered.
+
+@end table
+
+The predefined variables @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} and @code{\frenchChords}
+set these variables.  The effect is
+demonstrated here,
+
+@lilypondfile[ragged-right]{chord-names-languages.ly}
+
+There are also two other chord name schemes implemented: an alternate
+Jazz chord notation, and a systematic scheme called Banter chords.  The
+alternate Jazz notation is also shown on the chart in @ref{Chord name
+chart}.  Turning on these styles is demonstrated in
+@lsr{chords,chord-names-jazz.ly}.
+
+@cindex Banter
+@cindex jazz chords
+@cindex chords, jazz
+
+
+@refcommands
+
+@funindex \germanChords
+@code{\germanChords},
+@funindex \semiGermanChords
+@code{\semiGermanChords}.
+@funindex \italianChords
+@code{\italianChords}.
+@funindex \frenchChords
+@code{\frenchChords}.
+
+
+
+
+@seealso
+
+Examples:
+@lsrdir{chords}
+
+Init files: @file{scm/@/chords@/-ignatzek@/.scm}, and
+@file{scm/@/chord@/-entry@/.scm}.
+
+
+@refbugs
+
+Chord names are determined solely from the list of pitches.  Chord
+inversions are not identified, and neither are added bass notes.  This
+may result in strange chord names when chords are entered with the
+@code{< .. >} syntax.
+
+
diff --git a/Documentation/user/converters.itely b/Documentation/user/converters.itely
index 8b39478200..f843f2e978 100644
--- a/Documentation/user/converters.itely
+++ b/Documentation/user/converters.itely
@@ -258,7 +258,7 @@ there are some external tools that also generate LilyPond files.
 
 These tools include
 
-@itemize @bullet
+@itemize
 @item
 @uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, a graphical score editor.
 @item
diff --git a/Documentation/user/educational.itely b/Documentation/user/educational.itely
new file mode 100644
index 0000000000..4f4e7a6be1
--- /dev/null
+++ b/Documentation/user/educational.itely
@@ -0,0 +1,669 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Educational use
+@section Educational use
+
+@menu
+* Note heads::                  
+* Inside the staff::            
+* Outside the staff::           
+@end menu
+
+
+@node Note heads
+@subsection Note heads
+
+@menu
+* Easy notation note heads::    
+* Shape note heads::            
+* Improvisation::               
+* Special noteheads::           
+@end menu
+
+@node Easy notation note heads
+@unnumberedsubsubsec Easy notation note heads
+
+@cindex note heads, practice
+@cindex note heads, easy notation
+@cindex easy notation
+@cindex Hal Leonard
+
+The @q{easy play} note head includes a note name inside the head.
+It is used in music for beginners
+
+@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
+  \setEasyHeads
+  c'2 e'4 f' | g'1
+@end lilypond
+
+The command @code{\setEasyHeads} overrides settings for the
+@internalsref{NoteHead} object.  To make the letters readable, it
+has to be printed in a large font size.  To print with a larger
+font, see @ref{Setting the staff size}.
+
+@refcommands
+
+@funindex \setEasyHeads
+@code{\setEasyHeads}
+
+
+@node Shape note heads
+@unnumberedsubsubsec Shape note heads
+
+@cindex note heads, shape
+
+In shape note head notation, the shape of the note head
+corresponds to the harmonic function of a note in the scale.  This
+notation was popular in the 19th century American song books.
+
+Shape note heads can be produced by setting @code{\aikenHeads} or
+@code{\sacredHarpHeads}, depending on the style desired.
+
+@lilypond[verbatim,relative=1,fragment]
+  \aikenHeads
+  c8 d4 e8 a2 g1
+  \sacredHarpHeads
+  c8 d4. e8 a2 g1
+@end lilypond
+
+Shapes are determined on the step in the scale, where the base of
+the scale is determined by  the @code{\key} command
+
+@funindex \key
+@funindex shapeNoteStyles
+@funindex \aikenHeads
+@funindex \sacredHarpHeads
+
+Shape note heads are implemented through the
+@code{shapeNoteStyles} property.  Its value is a vector of
+symbols.  The k-th element indicates the style to use for the k-th
+step of the scale.  Arbitrary combinations are possible, e.g.
+
+@lilypond[verbatim,relative=1,fragment]
+\set shapeNoteStyles =
+  ##(cross triangle fa #f mensural xcircle diamond)
+c8 d4. e8 a2 g1
+@end lilypond
+
+
+@node Improvisation
+@unnumberedsubsubsec Improvisation
+
+Improvisation is sometimes denoted with slashed note heads.  Such
+note heads can be created by adding a
+@internalsref{Pitch_squash_engraver} to the @internalsref{Voice}
+context.  Then, the following command
+
+@example
+\set squashedPosition = #0
+\override NoteHead #'style = #'slash
+@end example
+
+@noindent
+switches on the slashes.
+
+There are shortcuts @code{\improvisationOn} (and an accompanying
+@code{\improvisationOff}) for this command sequence.  They are
+used in the following example
+
+@lilypond[verbatim,ragged-right,quote]
+\new Voice \with {
+  \consists Pitch_squash_engraver
+} \transpose c c' {
+  e8 e g a a16(bes)(a8) g \improvisationOn
+  e8
+  ~e2~e8 f4 fis8
+  ~fis2 \improvisationOff a16(bes) a8 g e
+}
+@end lilypond
+
+
+@node Special noteheads
+@unnumberedsubsubsec Special noteheads
+
+@cindex note heads, special
+
+Different noteheads are used by various instruments for various
+meanings -- crosses are used for @q{parlato} with vocalists,
+stopped notes on guitar; diamonds are used for harmonics on string
+instruments, etc.  There is a shorthand (@code{\harmonic}) for
+diamond shapes; the other notehead styles are produced by tweaking
+the property
+
+@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
+c4 d
+\override NoteHead #'style = #'cross
+e f
+\revert NoteHead #'style
+e d <c f\harmonic> <d a'\harmonic>
+@end lilypond
+
+@noindent
+To see all notehead styles, please see @ref{Note head styles}.
+
+
+@seealso
+
+Program reference: @internalsref{NoteHead}.
+
+
+
+@node Inside the staff
+@subsection Inside the staff
+
+
+@menu
+* Selecting notation font size::  
+* Fingering instructions::      
+* Hidden notes::                
+* Coloring objects::            
+* Parentheses::                 
+* Ambitus::                     
+* Stems::                       
+@end menu
+
+@node Selecting notation font size
+@unnumberedsubsubsec Selecting notation font size
+
+The easiest method of setting the font size of any context is by
+setting the @code{fontSize} property.
+
+@lilypond[quote,fragment,relative=1,verbatim]
+c8
+\set fontSize = #-4
+c f
+\set fontSize = #3
+g
+@end lilypond
+
+@noindent
+It does not change the size of variable symbols, such as beams or
+slurs.
+
+Internally, the @code{fontSize} context property will cause the
+@code{font-size} property to be set in all layout objects.  The
+value of @code{font-size} is a number indicating the size relative
+to the standard size for the current staff height.  Each step up
+is an increase of approximately 12% of the font size.  Six steps
+is exactly a factor two.  The Scheme function @code{magstep}
+converts a @code{font-size} number to a scaling factor.  The
+@code{font-size} property can also be set directly, so that only
+certain layout objects are affected.
+
+@lilypond[quote,fragment,relative=1,verbatim]
+c8
+\override NoteHead #'font-size = #-4
+c f
+\override NoteHead #'font-size = #3
+g
+@end lilypond
+
+Font size changes are achieved by scaling the design size that is
+closest to the desired size.  The standard font size (for
+@code{font-size} equals 0), depends on the standard staff height.
+For a 20pt staff, a 10pt font is selected.
+
+The @code{font-size} property can only be set on layout objects
+that use fonts.  These are the ones supporting the
+@internalsref{font-interface} layout interface.
+
+@refcommands
+
+The following commands set @code{fontSize} for the current voice:
+
+@funindex \tiny
+@code{\tiny},
+@funindex \small
+@code{\small},
+@funindex \normalsize
+@code{\normalsize}.
+
+
+@node Fingering instructions
+@unnumberedsubsubsec Fingering instructions
+
+@cindex fingering
+@cindex finger change
+
+Fingering instructions can be entered using
+
+@example
+@var{note}-@var{digit}
+@end example
+
+For finger changes, use markup texts
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+c4-1 c-2 c-3 c-4
+c^\markup { \finger "2 - 3" }
+@end lilypond
+
+You can use the thumb-script to indicate that a note should be
+played with the thumb (e.g., in cello music)
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+<a_\thumb a'-3>8 <b_\thumb b'-3>
+@end lilypond
+
+Fingerings for chords can also be added to individual notes of the
+chord by adding them after the pitches
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+< c-1 e-2 g-3 b-5 >4
+@end lilypond
+
+
+@commonprop
+
+You may exercise greater control over fingering chords by setting
+@code{fingeringOrientations}
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+\set fingeringOrientations = #'(left down)
+<c-1 es-2 g-4 bes-5 > 4
+\set fingeringOrientations = #'(up right down)
+<c-1 es-2 g-4 bes-5 > 4
+@end lilypond
+
+Using this feature, it is also possible to put fingering
+instructions very close to note heads in monophonic music,
+
+@lilypond[verbatim,ragged-right,quote,fragment]
+\set fingeringOrientations = #'(right)
+<es'-2>4
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{Fingering}.
+
+Examples: @lsr{expressive,fingering-chords.ly}
+
+
+
+@node Hidden notes
+@unnumberedsubsubsec Hidden notes
+
+@cindex Hidden notes
+@cindex Invisible notes
+@cindex Transparent notes
+
+@funindex \hideNotes
+@funindex \unHideNotes
+
+Hidden (or invisible or transparent) notes can be useful in
+preparing theory or composition exercises.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+c4 d4
+\hideNotes
+e4 f4
+\unHideNotes
+g4 a
+@end lilypond
+
+
+@node Coloring objects
+@unnumberedsubsubsec Coloring objects
+
+Individual objects may be assigned colors.  You may use the color
+names listed in the @ref{List of colors}.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\override NoteHead #'color = #red
+c4 c
+\override NoteHead #'color = #(x11-color 'LimeGreen)
+d
+\override Stem #'color = #blue
+e
+@end lilypond
+
+The full range of colors defined for X11 can be accessed by using
+the Scheme function x11-color.  The function takes one argument
+that can be a symbol
+
+@example
+\override Beam #'color = #(x11-color 'MediumTurquoise)
+@end example
+
+or a string
+
+@example
+\override Beam #'color = #(x11-color "MediumTurquoise")
+@end example
+
+The first form is quicker to write and is more efficient.
+However, using the second form it is possible to access X11 colors
+by the multi-word form of its name
+
+@example
+\override Beam #'color = #(x11-color "medium turquoise")
+@end example
+
+If x11-color cannot make sense of the parameter then the color
+returned defaults to black.  It should be obvious from the final
+score that something is wrong.
+
+This example illustrates the use of x11-color.  Notice that the
+stem color remains black after being set to (x11-color 'Boggle),
+which is deliberate nonsense.
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
+  \set Staff.instrumentName = \markup {
+    \with-color #(x11-color 'navy) "Clarinet"
+  }
+  \time 2/4
+  gis''8 a''
+  \override Beam #'color = #(x11-color "medium turquoise")
+  gis'' a''
+  \override NoteHead #'color = #(x11-color "LimeGreen")
+  gis'' a''
+  \override Stem #'color = #(x11-color 'Boggle)
+  gis'' a''
+}
+@end lilypond
+
+
+TODO
+you can get exact RGB colors by specifying
+
+% black
+\override Stem #'color = #(rgb-color 0 0 0)
+% white
+\override Stem #'color = #(rgb-color 1 1 1)
+% dark blue
+\override Stem #'color = #(rgb-color 0 0 0.5) 
+
+
+@seealso
+
+Appendix: @ref{List of colors}.
+
+
+@refbugs
+Not all x11 colors are distinguishable in a web browser.  For web
+use normal colors are recommended.
+
+An x11 color is not necessarily exactly the same shade as a
+similarly named normal color.
+
+Notes in a chord cannot be colored with @code{\override}; use
+@code{\tweak} instead.  See @ref{Objects connected to the input},
+for details.
+
+
+@node Parentheses
+@unnumberedsubsubsec Parentheses
+
+@cindex ghost notes
+@cindex notes, ghost
+@cindex notes, parenthesized
+
+Objects may be parenthesized by prefixing @code{\parenthesize} to
+the music event,
+
+@lilypond[relative=2,fragment,verbatim,ragged-right]
+<
+  c
+  \parenthesize d
+  g
+>4-\parenthesize -.
+@end lilypond
+
+This only functions inside chords, even for single notes
+
+@example
+< \parenthesize NOTE>
+@end example
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+The term @emph{ambitus} denotes a range of pitches for a given
+voice in a part of music.  It may also denote the pitch range that
+a musical instrument is capable of playing.  Ambits are printed on
+vocal parts, so performers can easily determine it meets their
+capabilities.
+
+Ambits are denoted at the beginning of a piece near the initial
+clef.  The range is graphically specified by two note heads that
+represent the minimum and maximum pitch.  To print such ambits,
+add the @internalsref{Ambitus_engraver} to the
+@internalsref{Voice} context, for example,
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+This results in the following output
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \consists Ambitus_engraver
+  }
+}
+
+\relative \new Staff {
+  as'' c e2 cis,2
+}
+@end lilypond
+
+If you have multiple voices in a single staff and you want a
+single ambitus per staff rather than per each voice, add the
+@internalsref{Ambitus_engraver} to the @internalsref{Staff}
+context rather than to the @internalsref{Voice} context.  Here is
+an example,
+
+@lilypond[verbatim,ragged-right,quote]
+\new Staff \with {
+  \consists "Ambitus_engraver"
+}
+<<
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c'' {
+    \override Ambitus #'X-offset = #-1.0
+    \voiceOne
+    c4 a d e f2
+  }
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c' {
+    \voiceTwo
+    es4 f g as b2
+  }
+>>
+@end lilypond
+
+@noindent
+This example uses one advanced feature,
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@noindent
+This code moves the ambitus to the left.  The same effect could
+have been achieved with @code{extra-offset}, but then the
+formatting system would not reserve space for the moved object.
+
+@seealso
+
+Program reference: @internalsref{Ambitus},
+@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
+@internalsref{AmbitusAccidental}.
+
+Examples:
+@lsr{vocal,ambitus@/.ly}.
+
+@refbugs
+
+There is no collision handling in the case of multiple per-voice
+ambitus.
+
+
+@node Stems
+@unnumberedsubsubsec Stems
+
+Whenever a note is found, a @internalsref{Stem} object is created
+automatically.  For whole notes and rests, they are also created
+but made invisible.
+
+@refcommands
+
+@funindex \stemUp
+@code{\stemUp},
+@funindex \stemDown
+@code{\stemDown},
+@funindex \stemNeutral
+@code{\stemNeutral}.
+
+
+@commonprop
+
+To change the direction of stems in the middle of the staff, use
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+a4 b c b
+\override Stem #'neutral-direction = #up
+a4 b c b
+\override Stem #'neutral-direction = #down
+a4 b c b
+@end lilypond
+
+
+@node Outside the staff
+@subsection Outside the staff
+
+
+@menu
+* Balloon help::                
+* Grid lines::                  
+* Blank music sheet::           
+@end menu
+
+@node Balloon help
+@unnumberedsubsubsec Balloon help
+
+Elements of notation can be marked and named with the help of a
+square balloon.  The primary purpose of this feature is to explain
+notation.
+
+The following example demonstrates its use.
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+  \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
+  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
+}
+@end lilypond
+
+@noindent
+There are two music functions, @code{balloonText} and
+@code{balloonGrobText}.  The latter takes the name of the grob to
+adorn, while the former may be used as an articulation on a note.
+The other arguments  are the offset and the text of the label.
+
+@cindex balloon
+@cindex notation, explaining
+
+@seealso
+
+Program reference: @internalsref{text-balloon-interface}.
+
+
+@node Grid lines
+@unnumberedsubsubsec Grid lines
+
+Vertical lines can be drawn between staves synchronized with the
+notes.
+
+@lilypond[ragged-right,quote,verbatim]
+\layout {
+  \context {
+    \Staff
+    \consists "Grid_point_engraver" %% sets of grid
+    gridInterval = #(ly:make-moment 1 4)
+  }
+}
+
+\new Score \with {
+  \consists "Grid_line_span_engraver"
+  %% centers grid lines  horizontally below noteheads
+  \override NoteColumn #'X-offset = #-0.5
+}
+
+\new ChoirStaff <<
+  \new Staff {
+    \stemUp
+    \relative {
+      c'4. d8 e8 f g4
+    }
+  }
+  \new Staff {
+    %% centers grid lines  vertically
+    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
+    \stemDown
+    \clef bass
+    \relative c {
+      c4  g'  f  e
+    }
+  }
+>>
+@end lilypond
+
+Examples: @lsrdir{education}
+
+
+@node Blank music sheet
+@unnumberedsubsubsec Blank music sheet
+
+@cindex Sheet music, empty
+@cindex Staves, blank sheet
+
+A blank music sheet can be produced also by using invisible notes,
+and removing @code{Bar_number_engraver}.
+
+
+@lilypond[quote,verbatim]
+\layout{ indent = #0 }
+emptymusic = {
+  \repeat unfold 2 % Change this for more lines.
+  { s1\break }
+  \bar "|."
+}
+\new Score \with {
+  \override TimeSignature #'transparent = ##t
+% un-comment this line if desired
+%  \override Clef #'transparent = ##t
+  defaultBarType = #""
+  \remove Bar_number_engraver
+} <<
+
+% modify these to get the staves you want
+  \new Staff \emptymusic
+  \new TabStaff \emptymusic
+>>
+@end lilypond
+
+
+
diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely
new file mode 100644
index 0000000000..43598a2175
--- /dev/null
+++ b/Documentation/user/expressive.itely
@@ -0,0 +1,944 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Expressive marks
+@section Expressive marks
+
+@menu
+* Attached to notes::           
+* Curves::                      
+* Lines::                       
+@end menu
+
+
+@node Attached to notes
+@subsection Attached to notes
+
+
+@menu
+* Articulations and ornamentations::  
+* Dynamics::                    
+@end menu
+
+@node Articulations and ornamentations
+@unnumberedsubsubsec Articulations and ornamentations
+
+@cindex Articulations
+@cindex scripts
+@cindex ornaments
+
+A variety of symbols can appear above and below notes to indicate
+different characteristics of the performance.  All these symbols
+can be attached to a note using the syntax @var{note}@code{\}@var{name}. 
+
+The possible values for @var{name} are listed in @ref{List of
+articulations}.
+
+Some of these articulations have shorthands for easier entry.  They
+are used by adding a dash and the character signifying
+the articulation to the note name.  The available shorthands and
+their output are:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override TextScript  #'font-family = #'typewriter
+\override TextScript  #'font-shape = #'upright
+c''4-._"c-."   
+c''4--_"c--"   
+c''4-+_"c-+"   
+c''4-|_"c-|"   
+c''4->_"c->"   
+c''4-^_"c-^"   
+c''4-__"c-_"         
+@end lilypond
+
+The marks are automatically placed, but the direction can be
+forced as well.  Like other pieces of LilyPond code, @code{_} will
+place them below the staff, and @code{^} will place them above.
+This applies both to the shorthands and the fully named
+articulations.  For the shorthands, the dash itself should be
+omitted; the shorthand signs replace it:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c''4^^ c''4_^
+c\fermata c^\fermata c_\fermata
+@end lilypond
+
+
+@cindex accent
+@cindex marcato
+@cindex staccatissimo
+@cindex espressivo
+@cindex fermata
+@cindex stopped
+@cindex staccato
+@cindex portato
+@cindex tenuto
+@cindex upbow
+@cindex downbow
+@cindex foot marks
+@cindex organ pedal marks
+@cindex turn
+@cindex open
+@cindex stopped
+@cindex flageolet
+@cindex reverseturn
+@cindex trill
+@cindex prall
+@cindex mordent
+@cindex prallprall
+@cindex prallmordent
+@cindex prall, up
+@cindex prall, down
+@cindex thumb marking
+@cindex segno
+@cindex coda
+@cindex varcoda
+
+
+@commonprop
+
+The meanings of the shorthands can be changed.  They are defined
+in @file{ly/@/script@/-init@/.ly}, where the variables  
+@code{DashDot}, @code{DashDash}, @code{DashPlus}, @code{DashBar},
+@code{DashLarger}, @code{DashHat}, and @code{DashUnderscore}
+are associated with the default articulation marks.  If you want,
+e.g., @code{-+} to produce a trill instead of a "+", you can
+redefine the variable in your document:
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' { c-+ }       
+dashPlus = "trill"
+\relative c'' { c-+ }       
+@end lilypond
+
+The vertical ordering of scripts is controlled with the
+@code{script-priority} property.  The lower this number, the
+closer it will be put to the note.  In this example, the
+@internalsref{TextScript} (the sharp symbol) first has the lowest
+priority, so it is put lowest in the first example.  In the
+second, the prall trill (the @internalsref{Script}) has the
+lowest, so it is on the inside.  When two objects have the same
+priority, the order in which they are entered decides which one
+comes first.
+
+
+@commonprop
+
+The meanings of the shorthands can be changed.  They are defined
+in @file{ly/@/script@/-init@/.ly}, where the variables  
+@code{DashDot}, @code{DashDash}, @code{DashPlus}, @code{DashBar},
+@code{DashLarger}, @code{DashHat}, and @code{DashUnderscore}
+are associated with the default articulation marks.  If you want,
+e.g., @code{-+} to produce a trill instead of a "+", you can
+redefine the variable in your document:
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c'' { c-+ }       
+dashPlus = "trill"
+\relative c'' { c-+ }       
+@end lilypond
+
+The vertical ordering of scripts is controlled with the
+@code{script-priority} property.  The lower this number, the
+closer it will be put to the note.  In this example, the
+@internalsref{TextScript} (the sharp symbol) first has the lowest
+priority, so it is put lowest in the first example.  In the
+second, the prall trill (the @internalsref{Script}) has the
+lowest, so it is on the inside.  When two objects have the same
+priority, the order in which they are entered decides which one
+comes first.
+
+@lilypond[verbatim,relative=3,ragged-right,fragment,quote]
+\once \override TextScript #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+
+\once \override Script #'script-priority = #-100
+a4^\prall^\markup { \sharp }
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{Script}.
+
+
+@refbugs
+
+These signs appear in the printed output but have no effect on the
+MIDI rendering of the music.
+
+
+@node Dynamics
+@unnumberedsubsubsec Dynamics
+
+@cindex Dynamics
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
+
+Absolute dynamic marks are specified using a command after a note
+@code{c4\ff}.  The available dynamic marks are @code{\ppppp},
+@code{\pppp}, @code{\ppp}, @code{\pp}, @code{\p}, @code{\mp},
+@code{\mf}, @code{\f}, @code{\ff}, @code{\fff}, @code{\ffff},
+@code{\fp}, @code{\sf}, @code{\sff}, @code{\sp}, @code{\spp},
+@code{\sfz}, and @code{\rfz}.  The dynamic marks can be placed
+above or below the staff with @code{_} and @code{^}, just like
+articulation marks. 
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+c2\ppp c\mp 
+c\rfz c^\mf
+c_\spp c_\staccato^\ff
+@end lilypond
+
+@funindex \<
+@funindex \>
+@funindex \!
+
+A crescendo mark is started with @code{\<} and terminated with
+@code{\!} or an absolute dynamic.  A decrescendo is started with
+@code{\>} and is also terminated with @code{\!} or an absolute
+dynamic.  @code{\cr} and @code{\decr} may be used instead of
+@code{\<} and @code{\>}.  They can be engraved either using a
+graphical sign (a @q{hairpin}), or with textual signs.
+
+Because these marks are bound to notes, you must use spacer notes
+if multiple marks are needed during one note.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\< c\! d\> e\!
+<< f1 { s4 s4\< s4\! \> s4\! } >>
+@end lilypond
+
+This may give rise to very short hairpins.  Use
+@code{minimum-length} in
+@internalsref{Voice}.@internalsref{Hairpin} to lengthen them, for
+example:
+
+@example
+\override Voice.Hairpin #'minimum-length = #5
+@end example
+
+@noindent
+A hairpin normally starts at the left edge of the beginning note
+and ends on the right edge of the ending note.  If the ending note
+falls on the downbeat, the hairpin ends on the immediately
+preceding barline.  This may be modified by setting the
+@code{hairpinToBarline} property,
+@cindex Hairpin
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+e4\< e2. e1\!
+\set hairpinToBarline = ##f
+e4\< e2. e1\!
+@end lilypond
+
+@cindex espressivo, articulation
+In some situations the @code{\espressivo} articulation mark may be
+suitable to indicate a crescendo and decrescendo on the one note:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c2 b4 a g1\espressivo
+@end lilypond
+
+@cindex al niente
+@cindex niente, al
+
+Hairpins may be printed with a circled tip (al niente notation) by
+setting the @code{circled-tip} property:
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override Hairpin #'circled-tip = ##t
+c2\< c\!
+c4\> c\< c2\!
+@end lilypond
+
+
+@cindex crescendo
+@cindex decrescendo
+@cindex diminuendo
+
+You can use text saying @emph{cresc.}, @emph{decr.}, or
+@emph{dim.} instead of hairpins with the commands \setTextCresc,
+\setTextDim, and \setTextDecresc.  The corresponding
+\setHairpinCresc, \setHairpinDim, and \setHairpinDecresc will
+revert to hairpins again: 
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\setTextCresc
+c\< d e f\!
+\setHairpinCresc
+e\> d c b\!
+\setTextDecresc
+c\> d e f\!
+\setTextDim
+e\> d c b\!
+@end lilypond
+
+You can also supply your own texts and change the style of the
+spanner line with the properties @code{\crescendoText},
+@code{\crescendoSpanner}, @code{\decrescendoText}, and
+@code{\decrescendoSpanner}. Available values for the spanner
+properties are @code{hairpin}, @code{line}, @code{dashed-line},
+and @code{dotted-line}. If unset, a hairpin crescendo is used:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\set crescendoText = \markup { \italic "cresc. poco" }
+\set crescendoSpanner = #'dotted-line
+a'2\< a a a a a a a\!\mf
+@end lilypond
+
+
+To create new dynamic marks or text that should be aligned with
+dynamics, see @ref{New dynamic marks}.
+
+Vertical positioning of dynamics is handled by
+@internalsref{DynamicLineSpanner}.
+
+
+@commonprop
+
+Dynamics that occur at, begin on, or end on the same note will be
+vertically aligned.  If you want to ensure that dynamics are
+aligned when they do not occur on the same note, you can increase
+the @code{staff-padding} property.
+
+@example
+\override DynamicLineSpanner #'staff-padding = #4
+@end example
+
+You may also use this property if the dynamics are colliding with
+other notation.
+
+Crescendi and decrescendi that cross a line break will be
+continued on the second line.  If they end on the first note of a
+new line, nothing will be printed on that line.  To change this
+behavior, use
+
+@example
+\override Score.Hairpin #'after-line-breaking = ##t
+@end example
+
+Text style dynamic changes (such as @emph{cresc.} and @emph{dim.})
+are printed with a dashed line showing their extent.  To surpress
+printing this line, use
+
+@example
+\override DynamicTextSpanner #'dash-period = #-1.0
+@end example
+
+
+@refcommands
+
+@funindex \dynamicUp
+@code{\dynamicUp},
+@funindex \dynamicDown
+@code{\dynamicDown},
+@funindex \dynamicNeutral
+@code{\dynamicNeutral}.
+
+
+@seealso
+
+Program reference: @internalsref{DynamicText},
+@internalsref{Hairpin}.  Vertical positioning of these symbols is
+handled by @internalsref{DynamicLineSpanner}.
+Glossary: @rglos{Hairpin}, @rglos{crescendo}, @rglos{decrescendo}
+
+
+@node Curves
+@subsection Curves
+
+@menu
+* Ties::                        
+* Slurs::                       
+* Phrasing slurs::              
+* Breath marks::                
+* Falls and doits::             
+@end menu
+
+@node Ties
+@unnumberedsubsubsec Ties
+
+@cindex tie
+@funindex ~
+
+A tie connects two adjacent note heads of the same pitch.  The tie
+in effect extends the length of a note. 
+
+@warning{Ties should not be confused with @emph{slurs}, which
+indicate articulation, or @emph{phrasing slurs}, which indicate
+musical phrasing. A tie is just a way of extending a note
+duration, similar to the augmentation dot.}
+
+A tie is entered using the tilde symbol @code{~}
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+e' ~ e'
+@end lilypond
+
+
+@noindent
+Ties are used either when the note crosses a bar line, or when
+dots cannot be used to denote the rhythm.  Ties should also be
+used when note values cross larger subdivisions of the measure:
+
+@lilypond[fragment,quote,ragged-right]
+\relative {
+  r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
+}
+@end lilypond
+
+If you need to tie a lot of notes over bars, it may be easier to
+use automatic note splitting (see @ref{Automatic note splitting}).
+This mechanism automatically splits long notes, and ties them
+across bar lines.
+
+@funindex \repeatTie
+@cindex repeating ties
+@cindex volta brackets and ties
+
+When a tie is applied to a chord, all note heads whose pitches
+match are connected.  When no note heads match, no ties will be
+created.  Chords may be partially tied by placing the tie inside
+the chord.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+ <c e g> ~ <c e g>
+<c~ e g~ b> <c e g b>
+@end lilypond
+
+When a second alternative of a repeat starts with a tied note, you
+have to repeat the tie.  This can be achieved with
+@code{\repeatTie},
+
+@lilypond[fragment,quote,ragged-right,relative=2]
+\repeat volta 2 { c g <c e>2 ~ }
+\alternative {{ <c e>2. r4 } {<c e>2\repeatTie d4 c }} 
+@end lilypond
+
+@cindex Laissez vibrer
+@cindex Ties, laissez vibrer
+
+@notation{L.v.} ties (@notation{laissez vibrer}) indicate that
+notes must not be damped at the end.  It is used in notation for
+piano, harp and other string and percussion instruments.  They can
+be entered using @code{\laissezVibrer}:
+
+@lilypond[fragment,ragged-right,verbatim,relative=1]
+<c f g>\laissezVibrer
+@end lilypond
+
+The direction of a tie can be specified with @code{\tieUp} or
+@code{\tieDown} (see example below).  @code{\tieNeutral} reverts
+to the default behaviour again.
+
+However, as with other music elements of this kind, there is a
+convenient shorthand for forcing tie directions.  By adding
+@code{_} or @code{^} before the tilde, the direction is also set:
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_~ c c^~ c)
+@end lilypond
+
+
+@seealso
+
+Program reference:
+@internalsref{LaissezVibrerTie}
+@internalsref{LaissezVibrerTieColumn}
+
+Example files:
+@lsr{connecting,laissez-vibrer-ties.ly}
+
+
+@commonprop
+
+Ties are sometimes used to write out arpeggios.  In this case, two
+tied notes need not be consecutive.  This can be achieved by
+setting the @code{tieWaitForNote} property to true.  The same
+feature is also useful, for example, to tie a tremolo to a chord,
+but in principle, it can also be used for ordinary, consecutive
+notes:
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+\set tieWaitForNote = ##t
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat tremolo 8 { c32~ c'~ } <c c,>1
+e8~ c~ a~ f~ <e' c a f>2
+\tieUp c8~ a \tieDown \tieDotted g~ c g2
+@end lilypond
+
+Ties may be engraved manually by changing the
+@code{tie-configuration} property.  The first number indicates the
+distance from the center of the staff in staff-spaces, and the
+second number indicates the direction (1=up, -1=down).
+
+@lilypond[fragment,verbatim,relative=1,ragged-right,quote]
+<c e g>2~ <c e g> |
+\override TieColumn #'tie-configuration =
+  #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
+<c e g>~ <c e g> |
+@end lilypond
+
+
+@refcommands
+
+
+@funindex \tieUp
+@code{\tieUp},
+@funindex \tieDown
+@code{\tieDown},
+@funindex \tieNeutral
+@code{\tieNeutral},
+@funindex \tieDotted
+@code{\tieDotted},
+@funindex \tieDashed
+@code{\tieDashed},
+@funindex \tieSolid
+@code{\tieSolid}.
+
+
+@seealso
+
+In this manual: @ref{Automatic note splitting}.
+
+Program reference: @internalsref{Tie}.
+
+
+@refbugs
+
+Switching staves when a tie is active will not produce a slanted
+tie.
+
+Changing clefs or octavations during a tie is not really
+well-defined.  In these cases, a slur may be preferable.
+
+
+@node Slurs
+@unnumberedsubsubsec Slurs
+
+@cindex Slurs
+
+A slur indicates that notes are to be played bound or
+@emph{legato}.  They are entered using parentheses:
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+f( g a) a8 b( a4 g2 f4)
+<c e>2( <b d>2)
+@end lilypond
+
+Just as with ties, the direction of a slur can be specified with
+@code{\slur@emph{DIR}}, where @code{@emph{DIR}} is either
+@code{Up}, @code{Down}, or @code{Neutral} (automatically
+selected).  The shorthands are also available: by adding
+@code{_} or @code{^} before the opening parentheses, the direction
+is also set.  
+
+@lilypond[relative=2,ragged-right,quote,verbatim,fragment]
+c4_( c) c^( c)
+@end lilypond
+
+Only one slur can be printed at once.  If you need to print a long
+slur over a few small slurs, please see @ref{Phrasing slurs}.
+
+
+@commonprop
+
+Some composers write two slurs when they want legato chords.  This
+can be achieved in LilyPond by setting @code{doubleSlurs},
+
+@lilypond[verbatim,ragged-right,relative,fragment,quote]
+\set doubleSlurs = ##t
+<c e>4 ( <d f> <c e> <d f> )
+@end lilypond
+
+
+@refcommands
+
+@funindex \slurUp
+@code{\slurUp},
+@funindex \slurDown
+@code{\slurDown},
+@funindex \slurNeutral
+@code{\slurNeutral},
+@funindex \slurDashed
+@code{\slurDashed},
+@funindex \slurDotted
+@code{\slurDotted},
+@funindex \slurSolid
+@code{\slurSolid}.
+
+@seealso
+
+Program reference: @internalsref{Slur}.
+
+
+@node Phrasing slurs
+@unnumberedsubsubsec Phrasing slurs
+
+@cindex phrasing slurs
+@cindex phrasing marks
+
+A phrasing slur (or phrasing mark) connects notes and is used to
+indicate a musical sentence.  It is written using @code{\(} and
+@code{\)} respectively:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+\time 6/4 c'\( d( e) f( e) d\)
+@end lilypond
+
+Typographically, the phrasing slur behaves almost exactly like a
+normal slur.  However, they are treated as different objects.  A
+@code{\slurUp} will have no effect on a phrasing slur; instead,
+use @code{\phrasingSlurUp}, @code{\phrasingSlurDown}, and
+@code{\phrasingSlurNeutral}, or use the shorthands @code{_} and
+@code{^}.
+
+You cannot have simultaneous phrasing slurs.
+
+
+@refcommands
+
+@funindex \phrasingSlurUp
+@code{\phrasingSlurUp},
+@funindex \phrasingSlurDown
+@code{\phrasingSlurDown},
+@funindex \phrasingSlurNeutral
+@code{\phrasingSlurNeutral}.
+
+
+@seealso
+
+Program reference: @internalsref{PhrasingSlur}.
+
+
+@node Breath marks
+@unnumberedsubsubsec Breath marks
+
+Breath marks are entered using @code{\breathe}
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c'4 \breathe d4
+@end lilypond
+
+
+@commonprop
+
+The glyph of the breath mark can be tuned by overriding the
+@code{text} property of the @code{BreathingSign} layout object
+with any markup text.  For example,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+c'4
+\override BreathingSign #'text
+  = #(make-musicglyph-markup "scripts.rvarcomma")
+\breathe
+d4
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{BreathingSign}.
+
+Examples: @lsr{expressive,breathing-sign.ly}
+
+
+@node Falls and doits
+@unnumberedsubsubsec Falls and doits
+
+Falls and doits can be added to notes using the @code{\bendAfter}
+command,
+
+@lilypond[fragment,ragged-right,relative=2]
+\override Score.SpacingSpanner #'shortest-duration-space = #3.0
+c4-\bendAfter #+5
+c4-\bendAfter #-3
+@end lilypond
+
+@node Lines
+@subsection Lines
+
+@menu
+* Glissando::                   
+* Arpeggio::                    
+* Trills::                      
+* Analysis brackets::           
+@end menu
+
+@node Glissando
+@unnumberedsubsubsec Glissando
+
+@cindex Glissando
+@funindex \glissando
+
+A glissando is a smooth change in pitch.  It is denoted by a line
+or a wavy line between two notes.  It is requested by attaching
+@code{\glissando} to a note
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+c2\glissando c'
+\override Glissando #'style = #'zigzag
+c2\glissando c,
+@end lilypond
+
+@commonprop
+
+
+@lilypond[quote,ragged-right,verbatim]
+I = \once \override NoteColumn #'ignore-collision = ##t
+
+\relative <<
+  { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
+  { \oneVoice \I c2 \glissando \I d, }
+>>
+@end lilypond
+
+
+
+@seealso
+
+Program reference: @internalsref{Glissando}.
+
+Glossary: @rglos{falls}, @rglos{doits}
+Example files:
+@lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
+
+
+@refbugs
+
+Printing text over the line (such as @emph{gliss.}) is not
+supported.
+
+
+@node Arpeggio
+@unnumberedsubsubsec Arpeggio
+
+@cindex Arpeggio
+@cindex broken chord
+@funindex \arpeggio
+
+You can specify an arpeggio sign (also known as broken chord) on a
+chord by attaching an @code{\arpeggio} to the chord:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+<c e g c>\arpeggio
+@end lilypond
+
+A square bracket on the left is used to indicate that the chord should
+@emph{not} be arpeggiated:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\arpeggioBracket
+<c' e g c>\arpeggio
+@end lilypond
+
+The direction of the arpeggio can be denoted by adding an
+arrowhead to the wiggly line. This is done with the commands
+@code{arpeggioUp} and @code{arpeggioDown}. @code{arpeggioNeutral}
+reverts to the arrow-less version:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new Voice {
+  \arpeggioUp
+  <c e g c>\arpeggio
+  \arpeggioDown
+  <c e g c>\arpeggio
+  \arpeggioNeutral
+  <c e g c>\arpeggio
+}
+@end lilypond
+
+
+@commonprop
+
+In a @code{PianoStaff}, it is possible to let an arpeggio cross
+between the staves by setting the property
+@internalsref{PianoStaff}.@code{connectArpeggios}. 
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \set PianoStaff.connectArpeggios = ##t
+  \new Staff { <c' e g c>\arpeggio }
+  \new Staff { \clef bass <c,, e g>\arpeggio }
+>>
+@end lilypond
+
+The same can be accomplished in contexts other than
+@code{PianoStaff} if the @code{Span_arpeggio_engraver} is included
+in the Score context.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \new StaffGroup {
+    \set Score.connectArpeggios = ##t
+    <<
+      \new Voice \relative c' {
+        <e g>4\arpeggio
+      }
+      \new Voice  \relative c {
+        \clef bass
+        <c e>4\arpeggio
+      }
+    >>
+  }
+  \layout {
+    \context {
+      \Score 
+      \consists "Span_arpeggio_engraver"
+    } 
+  }
+}
+@end lilypond
+
+Similarly,  an arpeggio can be drawn across notes in
+different voices on the same staff if the Span_arpeggio_engraver
+is moved to the Staff context:
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff
+\with {
+  \consists "Span_arpeggio_engraver"
+} \relative c' {
+  \set Staff.connectArpeggios = ##t
+    <<
+    {<e' g>4\arpeggio <d f> <d f>2 }
+  \\
+  {<d, f>2\arpeggio  <g b>2  }
+  >>
+}
+@end lilypond
+
+
+
+@refcommands
+
+@code{\arpeggio},
+@funindex \arpeggioUp
+@code{\arpeggioUp},
+@funindex \arpeggioDown
+@code{\arpeggioDown},
+@funindex \arpeggioNeutral
+@code{\arpeggioNeutral},
+@funindex \arpeggioBracket
+@code{\arpeggioBracket}.
+
+
+@seealso
+
+Notation manual: @ref{Ties}, for writing out arpeggios.
+
+Program reference: @internalsref{Arpeggio}.
+
+
+@refbugs
+
+It is not possible to mix connected arpeggios and unconnected
+arpeggios in one @internalsref{PianoStaff} at the same point in
+time.
+
+
+@node Trills
+@unnumberedsubsubsec Trills
+
+Short trills are printed with @code{\trill} like normal
+articulation; see @ref{Articulations and ornamentations}.
+
+Long running trills are made with @code{\startTrillSpan} and
+@code{\stopTrillSpan}. In the following example, it is shown in
+the common combination with grace notes.  If a more precise
+control of the placement of the grace notes is needed, see
+@ref{Grace notes}.
+
+@lilypond[verbatim,ragged-right,relative=2,quote,fragment]
+\relative c''
+{c1 \afterGrace 
+d1\startTrillSpan { c16[\stopTrillSpan d] }
+c4 }
+@end lilypond
+
+@cindex Pitched trills
+
+Trills that should be executed on an explicitly specified pitch
+can be typeset with the command @code{pitchedTrill}, and the
+syntax @code{\pitchedTrill} @var{mainnote}@code{\startTrillSpan}
+@var{trillnote} @var{endnote} @code{\stopTrillSpan}.
+
+@lilypond[ragged-right,verbatim,fragment,relative=1,quote]
+\pitchedTrill e2 \startTrillSpan fis
+d\stopTrillSpan
+@end lilypond
+
+
+@noindent
+The first argument is the main note.  The pitch of the second is
+printed as a stemless note head in parentheses.
+
+
+@refcommands
+
+@code{\startTrillSpan},
+@funindex \startTrillSpan
+@code{\stopTrillSpan}.
+@funindex \stopTrillSpan
+
+
+@seealso
+
+Program reference: @internalsref{TrillSpanner}.
+
+
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
+
+@cindex brackets
+@cindex phrasing brackets
+@cindex musicological analysis
+@cindex note grouping bracket
+
+Brackets are used in musical analysis to indicate structure in
+musical pieces.  LilyPond supports a simple form of nested
+horizontal brackets.  To use this, add the
+@internalsref{Horizontal_bracket_engraver} to the
+@internalsref{Staff} context.  A bracket is started with
+@code{\startGroup} and closed with @code{\stopGroup}.
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    c4\startGroup\startGroup
+    c4\stopGroup
+    c4\startGroup
+    c4\stopGroup\stopGroup
+  }
+  \layout {
+    \context {
+      \Staff \consists "Horizontal_bracket_engraver"
+}}}
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{HorizontalBracket}.
+
+
+
diff --git a/Documentation/user/fundamental.itely b/Documentation/user/fundamental.itely
new file mode 100644
index 0000000000..4e8dafa4f7
--- /dev/null
+++ b/Documentation/user/fundamental.itely
@@ -0,0 +1,897 @@
+
+@c -*- coding: utf-8; mode: texinfo; -*-
+@c This file is part of lilypond-learning.tely
+
+@node Fundamental concepts
+@chapter Fundamental concepts
+
+@menu
+* How LilyPond files work::     
+* Voices contain music::        
+* TODO new sec fundamental::    
+* Extending the templates::     
+* Scores and parts::            
+@end menu
+
+
+@node How LilyPond files work
+@section How LilyPond files work
+
+The LilyPond input format is quite free-form, giving experienced
+users a lot of flexibility to structure their files however they
+wish.  However, this flexibility can make things confusing for new
+users.  This section will explain some of this structure, but may
+gloss over some details in favor of simplicity.  For a complete
+description of the input format, see @ruser{File structure}.
+
+@menu
+* Introduction to the LilyPond file structure::  
+* Score is a (single) compound musical expression::  
+@end menu
+
+@node Introduction to the LilyPond file structure
+@subsection Introduction to the LilyPond file structure
+
+A basic example of a lilypond input file is
+
+@example
+\version "2.11.23"
+\score @{
+  @var{...compound music expression...}  % all the music goes here!
+  \header @{ @}
+  \layout @{ @}
+  \midi @{ @}
+@}
+@end example
+
+@noindent
+There are many variations of this basic pattern, but this
+example serves as a useful starting place.
+
+At this point, you may be confused, since you have never seen a
+@code{\score@{@}} before.  This is because LilyPond automatically
+adds the extra commands when you give it simple input.  LilyPond
+treats input like this:
+
+@example
+\relative c'' @{
+  c4 a d c
+@}
+@end example
+
+@noindent
+as shorthand for this:
+
+@example
+\score @{
+  \relative c'' @{
+    c4 a b c
+  @}
+  \layout @{ @}
+@}
+@end example
+
+In other words, if the input contains a single music expression,
+LilyPond will interpret the file as though the music expression
+was wrapped up inside a @code{\score@{@}}.
+
+@smallspace
+
+A @code{\score} must begin with a compound music expression.
+Remember that a music expression could be anything from a single
+note to a huge
+
+@example
+@{
+  \new GrandStaff <<
+    @var{...insert the whole score of a Wagner opera in here...}
+  >>
+@}
+@end example
+
+@noindent
+Since everything is inside @code{@{ ... @}}, it counts
+as one music expression.
+
+As we saw previously, the @code{\score} can contain other things,
+such as
+
+@example
+\score @{
+  @{ c'4 a b c' @}
+  \header @{ @}
+  \layout @{ @}
+  \midi @{ @}
+@}
+@end example
+
+@noindent
+Some people put some of those commands outside the @code{\score}
+block -- for example, @code{\header} is often placed above the
+@code{\score}.  That's just another shorthand that LilyPond
+accepts.
+
+@smallspace
+
+@cindex variables
+
+Another great shorthand is the ability to define variables.  All
+the templates use this
+
+@example
+melody = \relative c' @{
+  c4 a b c
+@}
+
+\score @{
+  @{ \melody @}
+@}
+@end example
+
+When LilyPond looks at this file, it takes the value of
+@code{melody} (everything after the equals sign) and inserts it
+whenever it sees @code{\melody}.  There's nothing special about
+the names -- it could be @code{melody}, @code{global},
+@code{pianorighthand}, or @code{foofoobarbaz}.  You can use
+whatever variable names you want.  For more details, see
+@ruser{Saving typing with variables and functions}.
+
+
+@seealso
+
+For a complete definition of the input format, see @ruser{File
+structure}.
+
+
+@node Score is a (single) compound musical expression
+@subsection Score is a (single) compound musical expression
+
+@cindex Compound music expression
+@cindex Music expression, compound
+
+We saw the general organization of LilyPond input files in the
+previous section, @ref{How LilyPond files work}.  But we seemed to
+skip over the most important part: how do we figure out what to
+write after @code{\score}?
+
+We didn't skip over it at all.  The big mystery is simply that
+there @emph{is} no mystery.  This line explains it all:
+
+@quotation
+@emph{A @code{\score} must begin with a compound music expression.}
+@end quotation
+
+@noindent
+You may find it useful to review @ruser{Music expressions
+explained}.  In that section, we saw how to build big music
+expressions from small pieces -- we started from notes, then
+chords, etc.  Now we're going to start from a big music expression
+and work our way down.
+
+@example
+\score @{
+  @{ % this brace begins the overall compound music expression
+    \new GrandStaff <<
+      @var{...insert the whole score of a Wagner opera in here...}
+    >>
+  @} % this brace ends the overall compound music expression
+  \layout @{ @}
+@}
+@end example
+
+A whole Wagner opera would easily double the length of this
+manual, so let's just add a singer and piano.  We don't need a
+@code{GrandStaff} for this ensemble, so we shall remove it.  We
+@emph{do} need a singer and a piano, though.
+
+@example
+\score @{
+  @{
+    <<
+      \new Staff = "singer" <<
+      >>
+      \new PianoStaff = piano <<
+      >>
+    >>
+  @}
+  \layout @{ @}
+@}
+@end example
+
+Remember that we use @code{<<} and @code{>>} to show simultaneous
+music.  And we definitely want to show the vocal part and piano
+part at the same time, not one after the other!
+
+@example
+\score @{
+  @{
+    <<
+      \new Staff = "singer" <<
+        \new Voice = "vocal" @{ @}
+      >>
+      \new Lyrics \lyricsto vocal \new Lyrics @{ @}
+      \new PianoStaff = "piano" <<
+        \new Staff = "upper" @{ @}
+        \new Staff = "lower" @{ @}
+      >>
+    >>
+  @}
+  \layout @{ @}
+@}
+@end example
+
+Now we have a lot more details.  We have the singer's staff: it
+contains a @code{Voice} (in LilyPond, this term refers to a set of
+notes, not necessarily vocal notes -- for example, a violin
+generally plays one voice) and some lyrics.  We also have a piano
+staff: it contains an upper staff (right hand) and a lower staff
+(left hand).
+
+At this stage, we could start filling in notes.  Inside the curly
+braces next to @code{\new Voice = vocal}, we could start writing
+
+@example
+\relative c'' @{
+  a4 b c d
+@}
+@end example
+
+But if we did that, the @code{\score} section would get pretty
+long, and it would be harder to understand what was happening.  So
+let's use variables instead.
+
+@example
+melody = @{ @}
+text = @{ @}
+upper = @{ @}
+lower = @{ @}
+\score @{
+  @{
+    <<
+      \new Staff = "singer" <<
+        \new Voice = "vocal" @{ \melody @}
+      >>
+      \new Lyrics \lyricsto vocal \new Lyrics @{ \text @}
+      \new PianoStaff = "piano" <<
+        \new Staff = "upper" @{ \upper @}
+        \new Staff = "lower" @{ \lower @}
+      >>
+    >>
+  @}
+  \layout @{ @}
+@}
+@end example
+
+@noindent
+Remember that you can use almost any name you like.  The
+limitations on variable names are detailed in @ruser{File
+structure}.
+
+When writing (or reading) a @code{\score} section, just take it
+slowly and carefully.  Start with the outer layer, then work on
+each smaller layer.  It also really helps to be strict with
+indentation -- make sure that each item on the same layer starts
+on the same horizontal position in your text editor.
+
+
+@node Voices contain music
+@section Voices contain music
+
+TODO: something cheesy and vaguely witty about voices being the
+fundamental thing that includes music in lilypond.
+
+@menu
+* I'm seeing Voices::           
+* Explicitly instantiating voices::  
+* Voices and vocals::           
+@end menu
+
+@c too cheesy?  I'm not certain.  -gp
+@node I'm seeing Voices
+@subsection I'm seeing Voices
+
+@cindex polyphony
+
+TODO: add intro about voices vs. layers vs. whatever.
+
+TODO: sex this up with colors and stuff.  -gp 
+
+TODO: actually, a general rewrite is needed.  -gp
+
+
+The easiest way to enter fragments with more than one voice on a
+staff is to enter each voice as a sequence (with @code{@{...@}}),
+and combine them simultaneously, separating the voices with
+@code{\\}
+
+@funindex \\
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  c16 d e f
+  <<
+    { g4 f e | d2 e2 } \\
+    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
+    { s2. | s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+@cindex layers
+
+The separator causes @internalsref{Voice}
+contexts@footnote{Polyphonic voices are sometimes
+called @q{layers} in other notation packages} to be instantiated.
+They bear the names @code{"1"}, @code{"2"}, etc.  In each of these
+contexts, vertical direction of slurs, stems, etc., is set
+appropriately.
+
+These voices are all separate from the voice that contains the
+notes just outside the @code{<< \\ >>} construct.  This should be
+noted when making changes at the voice level.  This also means
+that slurs and ties cannot go into or out of a @code{<< \\ >>}
+construct.  Conversely, parallel voices from separate @code{<< \\
+>>} constructs on the same staff are the same voice.  Here is the
+same example, with different noteheads and colors for each voice.
+Note that the change to the note-head style in the main voice does
+not affect the inside of the @code{<< \\ >>} constructs.  Also,
+the change to the second voice in the first @code{<< \\ >>}
+construct is effective in the second @code{<< \\ >>}, and the
+voice is tied across the two constructs.
+
+@cindex note heads, styles
+
+@lilypond[quote,verbatim,fragment]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  <<
+    { g4 f e } \\
+    { \override NoteHead #'style = #'triangle
+      \override NoteHead #'color = #blue
+    r8 e4 d c8 ~ }
+  >> |
+  <<
+    { d2 e2 } \\
+    { c8 b16 a b8 g ~ g2 } \\
+    { \override NoteHead #'style = #'slash 
+      \override NoteHead #'color = #green
+      s4 b4 c2 }
+  >>
+}
+@end lilypond
+
+Polyphony does not change the relationship of notes within a
+@code{\relative @{ @}} block.  Each note is calculated relative to
+the note immediately preceding it.
+
+@example
+\relative @{ noteA << noteB \\ noteC >> noteD @}
+@end example
+
+@code{noteC} is relative to @code{noteB}, not @code{noteA};
+@code{noteD} is relative to @code{noteC}, not @code{noteB} or
+@code{noteA}.
+
+
+@node Explicitly instantiating voices
+@subsection Explicitly instantiating voices
+
+TODO: more colors and stuff.
+
+@internalsref{Voice} contexts can also be instantiated manually
+inside a @code{<< >>} block to create polyphonic music, using
+@code{\voiceOne}, up to @code{\voiceFour} to assign stem
+directions and a horizontal shift for each part.
+
+Specifically,
+@example
+<< \upper \\ \lower >>
+@end example
+
+@noindent
+is equivalent to
+
+@example
+<<
+  \new Voice = "1" @{ \voiceOne \upper @}
+  \new Voice = "2" @{ \voiceTwo \lower @}
+>>
+@end example
+
+The @code{\voiceXXX} commands set the direction of stems, slurs,
+ties, articulations, text annotations, augmentation dots of dotted
+notes, and fingerings.  @code{\voiceOne} and @code{\voiceThree}
+make these objects point upwards, while @code{\voiceTwo} and
+@code{\voiceFour} make them point downwards.  The command
+@code{\oneVoice} will revert back to the normal setting.
+
+An expression that appears directly inside a @code{<< >>} belongs
+to the main voice.  This is useful when extra voices appear while
+the main voice is playing.  Here is a more correct rendition of
+the example from the previous section.  The crossed colored
+noteheads demonstrate that the main melody is now in a single
+voice context.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  \override NoteHead #'style = #'cross
+  \override NoteHead #'color = #red
+  c16 d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2 }
+    \new Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. | s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+The correct definition of the voices allows the melody to be
+slurred.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
+      \oneVoice
+    }
+    \new Voice { \voiceThree
+      s2. s4 b4 c2
+      \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+Avoiding the @code{\\} separator also allows nesting polyphony
+constructs, which in some case might be a more natural way to
+typeset the music.
+
+@lilypond[quote,ragged-right,verbatim]
+\new Staff \relative c' {
+  c16^( d e f
+  \voiceOne
+  <<
+    { g4 f e | d2 e2) }
+    \context Voice="1" { \voiceTwo
+      r8 e4 d c8 ~ |
+      <<
+        {c8 b16 a b8 g ~ g2}
+        \new Voice { \voiceThree
+          s4 b4 c2
+          \oneVoice
+        }
+      >>
+    \oneVoice
+    }
+  >>
+  \oneVoice
+}
+@end lilypond
+
+
+@node Voices and vocals
+@subsection Voices and vocals
+
+Vocal music presents a special difficulty: we need to combine two
+expressions -- notes and lyrics.
+
+You have already seen the @code{\lyricsAdd@{@}} command, which
+handles simple cases for you.  However, @code{\lyricsAdd@{@}} is
+very limited.  For most music, you must explicitly link the lyrics
+to the notes with @code{\lyricsTo@{@}}
+
+@lilypond[quote,verbatim,fragment]
+<<
+  \new Voice = "one" \relative c'' {
+    \autoBeamOff
+    \time 2/4
+    c4 b8. a16 g4. f8 e4 d c2
+  }
+  \new Lyrics \lyricsto "one" {
+    No more let sins and sor -- rows grow.
+  }
+>>
+@end lilypond
+
+TODO: get some vocal person to write more.
+
+
+@node TODO new sec fundamental
+@section TODO new sec fundamental
+
+blh blah
+
+
+@menu
+* On the un-nestedness of brackets and ties::  
+* Up and down::                 
+* Distances and measurements::  
+@end menu
+
+@c my name start sucking the more docs I write. -gp
+@node On the un-nestedness of brackets and ties
+@subsection On the un-nestedness of brackets and ties
+
+Different kinds of brackets and ties may be mixed freely,
+
+TODO: improve this example
+
+@lilypond[quote,verbatim,fragment,ragged-right]
+{
+  r16[ g16 \times 2/3 {r16 e'8] }
+  g16( a \times 2/3 {b d e') }
+  g8[( a \times 2/3 {b d') e'~]}
+  \times 4/5 {e'32\( a b d' e'} a'4.\)
+}
+@end lilypond
+
+TODO... add more info?  Fluff up the first sentence?
+
+
+@node Up and down
+@subsection Up and down
+
+TODO: everything
+
+By default, lilypnod does a pretty jazz'n job of picking
+directions.  But in some cases, it may be desirable to force a
+direction.
+
+@verbatim
+-
+^ _
+@end verbatim
+
+
+@node Distances and measurements
+@subsection Distances and measurements
+
+DISCUSS
+
+TODO: staff spaces, #UP #DOWN #LEFT #RIGHT.  Maybe move into tweaks?
+
+
+
+@node Extending the templates
+@section Extending the templates
+
+You've read the tutorial, you know how to write music.  But how can you
+get the staves that you want?  The templates are ok, but what if you
+want something that isn't covered?
+
+@menu
+* Soprano and cello::           
+* TODO another example of extending templates::  
+@end menu
+
+@node Soprano and cello
+@unnumberedsubsec Soprano and cello
+
+Start off with the template that seems closest to what you want to end
+up with.  Let's say that you want to write something for soprano and
+cello.  In this case, we would start with @q{Notes and lyrics} (for the
+soprano part).
+
+@example
+\version "2.11.23"
+melody = \relative c' @{
+  \clef treble
+  \key c \major
+  \time 4/4
+
+  a4 b c d
+@}
+
+text = \lyricmode @{
+  Aaa Bee Cee Dee
+@}
+
+\score@{
+  <<
+    \new Voice = "one" @{
+      \autoBeamOff
+      \melody
+    @}
+    \new Lyrics \lyricsto "one" \text
+  >>
+  \layout @{ @}
+  \midi @{ @}
+@}
+@end example
+
+Now we want to add a cello part.  Let's look at the @q{Notes only} example:
+
+@example
+\version "2.11.23"
+melody = \relative c' @{
+  \clef treble
+  \key c \major
+  \time 4/4
+
+  a4 b c d
+@}
+
+\score @{
+\new Staff \melody
+\layout @{ @}
+\midi @{ @}
+@}
+@end example
+
+We don't need two @code{\version} commands.  We'll need the @code{melody}
+section.  We don't want two @code{\score} sections -- if we had two
+@code{\score}s, we'd get the two parts separately.  We want them together,
+as a duet.  Within the @code{\score} section, we don't need two
+@code{\layout} or @code{\midi}.
+
+If we simply cut and paste the @code{melody} section, we would end up with
+two @code{melody} sections.  So let's rename them.  We'll call the section
+for the soprano @code{sopranoMusic} and the section for the cello
+@code{celloMusic}.  While we're doing this, let's rename @code{text}
+to be @code{sopranoLyrics}.  Remember to rename both instances of all
+these names -- both the initial definition (the
+@code{melody = relative c' @{ } part) and the name's use (in the
+@code{\score} section).
+
+While we're doing this, let's change the cello part's staff -- celli
+normally use bass clef.  We'll also give the cello some different
+notes.
+
+@example
+\version "2.11.23"
+sopranoMusic = \relative c' @{
+  \clef treble
+  \key c \major
+  \time 4/4
+
+  a4 b c d
+@}
+
+sopranoLyrics = \lyricmode @{
+  Aaa Bee Cee Dee
+@}
+
+celloMusic = \relative c @{
+  \clef bass
+  \key c \major
+  \time 4/4
+
+  d4 g fis8 e d4
+@}
+
+\score@{
+  <<
+    \new Voice = "one" @{
+      \autoBeamOff
+      \sopranoMusic
+    @}
+    \new Lyrics \lyricsto "one" \sopranoLyrics
+  >>
+  \layout @{ @}
+  \midi @{ @}
+@}
+@end example
+
+This is looking promising, but the cello part won't appear in the
+score -- we haven't used it in the @code{\score} section.  If we
+want the cello part to appear under the soprano part, we need to add
+
+@example
+\new Staff \celloMusic
+@end example
+
+@noindent
+underneath the soprano stuff.  We also need to add @code{<<} and
+@code{>>} around the music -- that tells LilyPond that there's
+more than one thing (in this case, @code{Staff}) happening at once.  The
+@code{\score} looks like this now
+
+@example
+\score@{
+  <<
+    <<
+      \new Voice = "one" @{
+        \autoBeamOff
+        \sopranoMusic
+      @}
+      \new Lyrics \lyricsto "one" \sopranoLyrics
+    >>
+    \new Staff \celloMusic
+  >>
+  \layout @{ @}
+  \midi @{ @}
+@}
+@end example
+
+@noindent
+This looks a bit messy; the indentation is messed up now.  That is
+easily fixed.  Here's the complete soprano and cello template.
+
+@lilypond[quote,verbatim,ragged-right]
+\version "2.11.23"
+sopranoMusic = \relative c' {
+  \clef treble
+  \key c \major
+  \time 4/4
+
+  a4 b c d
+}
+
+sopranoLyrics = \lyricmode {
+  Aaa Bee Cee Dee
+}
+
+celloMusic = \relative c {
+  \clef bass
+  \key c \major
+  \time 4/4
+
+  d4 g fis8 e d4
+}
+
+\score{
+  <<
+    <<
+      \new Voice = "one" {
+        \autoBeamOff
+        \sopranoMusic
+      }
+      \new Lyrics \lyricsto "one" \sopranoLyrics
+    >>
+    \new Staff \celloMusic
+  >>
+  \layout { }
+  \midi { }
+}
+@end lilypond
+
+
+@node TODO another example of extending templates
+@unnumberedsubsec TODO another example of extending templates
+
+TODO: somebody else fill this in.  You guys like vocal stuff,
+right?  Get to it.  :)  -gp
+
+
+
+@node Scores and parts
+@section Scores and parts
+
+TODO: this is really old stuff from the really old tutorial.
+Rewrite, fix, etc.  -gp
+
+In orchestral music, all notes are printed twice.  Once in a part for
+the musicians, and once in a full score for the conductor.  Variables can
+be used to avoid double work.  The music is entered once, and stored in
+a variable.  The contents of that variable is then used to generate
+both the part and the full score.
+
+It is convenient to define the notes in a special file.  For example,
+suppose that the file @file{horn-music.ly} contains the following part
+of a horn/@/bassoon duo
+
+@example
+hornNotes = \relative c @{
+  \time 2/4
+  r4 f8 a cis4 f e d
+@}
+@end example
+
+@noindent
+Then, an individual part is made by putting the following in a file
+
+@example
+\include "horn-music.ly"
+\header @{
+  instrument = "Horn in F"
+@}
+
+@{
+ \transpose f c' \hornNotes
+@}
+@end example
+
+The line
+
+@example
+\include "horn-music.ly"
+@end example
+
+@noindent
+substitutes the contents of @file{horn-music.ly} at this position in
+the file, so @code{hornNotes} is defined afterwards.  The command
+@code{\transpose f@tie{}c'} indicates that the argument, being
+@code{\hornNotes}, should be transposed by a fifth upwards.  Sounding
+@samp{f} is denoted by notated @code{c'}, which corresponds with the
+tuning of a normal French Horn in@tie{}F.  The transposition can be seen
+in the following output
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+  \time 2/4
+  r4 f8 a cis4 f e d
+}
+@end lilypond
+
+In ensemble pieces, one of the voices often does not play for many
+measures.  This is denoted by a special rest, the multi-measure
+rest.  It is entered with a capital @samp{R} followed by a duration
+(@code{1}@tie{}for a whole note, @code{2}@tie{}for a half note,
+etc.).  By multiplying the
+duration, longer rests can be constructed.  For example, this rest
+takes 3@tie{}measures in 2/4 time
+
+@example
+R2*3
+@end example
+
+When printing the part, multi-rests
+must be condensed.  This is done by setting a run-time variable
+
+@example
+\set Score.skipBars = ##t
+@end example
+
+@noindent
+This command sets the property @code{skipBars} in the
+@code{Score} context to true (@code{##t}).  Prepending the rest and
+this option to the music above, leads to the following result
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+  \time 2/4
+  \set Score.skipBars = ##t
+  R2*3
+  r4 f8 a cis4 f e d
+}
+@end lilypond
+
+
+The score is made by combining all of the music together.  Assuming
+that the other voice is in @code{bassoonNotes} in the file
+@file{bassoon-music.ly}, a score is made with
+
+@example
+\include "bassoon-music.ly"
+\include "horn-music.ly"
+
+<<
+  \new Staff \hornNotes
+  \new Staff \bassoonNotes
+>>
+@end example
+
+@noindent
+leading to
+
+@lilypond[quote,ragged-right]
+\relative c <<
+  \new Staff {
+    \time 2/4 R2*3
+    r4 f8 a cis4 f e d
+  }
+  \new Staff {
+    \clef bass
+    r4 d,8 f | gis4 c | b bes |
+    a8 e f4 | g d | gis f
+  }
+>>
+@end lilypond
+
+
+
diff --git a/Documentation/user/guitar.itely b/Documentation/user/guitar.itely
new file mode 100644
index 0000000000..34ad9983ef
--- /dev/null
+++ b/Documentation/user/guitar.itely
@@ -0,0 +1,355 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Guitar
+@section Guitar
+
+@cindex tablature
+@cindex guitar tablature
+
+@menu
+* Guitar sections::             
+@end menu
+
+@node Guitar sections
+@subsection Guitar sections
+
+@menu
+* String number indications::   
+* Tablatures basic::            
+* Non-guitar tablatures::       
+* Banjo tablatures::            
+* Fret diagrams::               
+* Right hand fingerings::       
+* Other guitar issues::         
+@end menu
+
+@node String number indications
+@unnumberedsubsubsec String number indications
+
+@cindex String numbers
+
+String numbers can be added to chords, by indicating the string number
+with @code{\}@var{number},
+
+@lilypond[relative,relative=1,ragged-right,fragment]
+<c\1 e\2 g\3>
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.
+
+
+@node Tablatures basic
+@unnumberedsubsubsec Tablatures basic
+@cindex Tablatures basic
+
+Tablature notation is used for notating music for plucked string
+instruments.  Pitches are not denoted with note heads, but by
+numbers indicating on which string and fret a note must be played.  LilyPond
+offers limited support for tablature.
+
+The string number associated to a note is given as a backslash
+followed by a number, e.g., @code{c4\3} for a C quarter on the third
+string.  By default, string 1 is the highest one, and the tuning
+defaults to the standard guitar tuning (with 6 strings).  The notes
+are printed as tablature, by using @internalsref{TabStaff} and
+@internalsref{TabVoice} contexts
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff {
+  a,4\5 c'\2 a\3 e'\1
+  e\4 c'\2 a\3 e'\1
+}
+@end lilypond
+
+@funindex minimumFret
+@cindex fret
+
+When no string is specified, the first string that does not give a
+fret number less than @code{minimumFret} is selected.  The default
+value for @code{minimumFret} is 0
+
+
+@example
+e16 fis gis a b4
+\set TabStaff.minimumFret = #8
+e16 fis gis a b4
+@end example
+@lilypond[quote,ragged-right]
+frag = {
+  \key e \major
+  e16 fis gis a b4
+  \set TabStaff.minimumFret = #8
+  e16 fis gis a b4
+}
+  \new StaffGroup <<
+    \new Staff { \clef "G_8" \frag }
+    \new TabStaff { \frag }
+  >>
+@end lilypond
+
+
+@commonprop
+
+To print tablatures with stems down and horizontal beams,
+initialize the @code{TabStaff} with this code:
+
+@example
+\stemDown
+\override Beam #'damping = #100000
+@end example
+
+@seealso
+
+Program reference: @internalsref{TabStaff}, @internalsref{TabVoice}.
+
+@refbugs
+
+Chords are not handled in a special way, and hence the automatic
+string selector may easily select the same string to two notes in a
+chord.
+
+In order to handle @code{\partcombine}, a @code{TabStaff} must use
+specially-created voices:
+
+@lilypond[quote,ragged-right,verbatim]
+melodia = \partcombine { e4 g g g }{ e4 e e e }
+<<
+  \new TabStaff <<
+    \new TabVoice = "one" s1
+    \new TabVoice = "two" s1
+    \new TabVoice = "shared" s1
+    \new TabVoice = "solo" s1
+    { \melodia }
+  >>
+>>
+@end lilypond
+
+
+@node Non-guitar tablatures
+@unnumberedsubsubsec Non-guitar tablatures
+@cindex Non-guitar tablatures
+
+You can change the tuning of the strings.  A string tuning is given as
+a Scheme list with one integer number for each string, the number
+being the pitch (measured in semitones relative to middle C) of an
+open string.  The numbers specified for @code{stringTunings} are the
+numbers of semitones to subtract or add, starting the specified pitch
+by default middle C, in string order.  LilyPond automatically calculates
+the number of strings by looking at @code{stringTunings}.
+
+In the next example,
+@code{stringTunings} is set for the pitches e, a, d, and g
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
+  {
+    a,4 c' a e' e c' a e'
+  }
+>>
+@end lilypond
+
+LilyPond comes with predefined string tunings for banjo, mandolin, guitar
+and bass guitar.
+
+@example
+\set TabStaff.stringTunings = #bass-tuning
+@end example
+
+The default string tuning is @code{guitar-tuning} (the standard EADGBE
+tuning).
+Some other predefined tunings are @code{guitar-open-g-tuning},
+@code{mandolin-tuning} and @code{banjo-open-g-tuning}.
+
+@seealso
+
+The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
+tunings.
+Program reference: @internalsref{Tab_note_heads_engraver}.
+
+@refbugs
+
+No guitar special effects have been implemented.
+
+
+
+@node Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
+@cindex Banjo tablatures
+
+LilyPond has basic support for five stringed banjo.  When making tablatures
+for five stringed banjo, use the banjo tablature format function to get
+correct
+fret numbers for the fifth string:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new TabStaff <<
+  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
+  \set TabStaff.stringTunings = #banjo-open-g-tuning
+  {
+    \stemDown
+    g8 d' g'\5 a b g e d' |
+    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
+    g4
+  }
+>>
+@end lilypond
+
+A number of common tunings for banjo are predefined in LilyPond:
+@code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
+@code{banjo-open-d-tuning} (aDF#AD) and @code{banjo-open-dm-tuning}
+(aDFAD).
+
+These tunings may be converted to four string banjo tunings using the
+@code{four-string-banjo} function:
+
+@example
+\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
+@end example
+
+@seealso
+
+The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
+
+
+@node Fret diagrams
+@unnumberedsubsubsec Fret diagrams
+@cindex fret diagrams
+@cindex chord diagrams
+
+Fret diagrams can be added to music as a markup to the desired note.  The
+markup contains information about the desired fret diagram, as shown in the
+following example
+
+@lilypond[verbatim, ragged-right, quote]
+\new Voice {
+  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  d' d' d'
+  fis'^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  fis' fis' fis'
+  c'^\markup \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+  c' c' c'
+}
+@end lilypond
+
+
+There are three different fret-diagram markup interfaces: standard, terse,
+and verbose.  The three interfaces produce equivalent markups, but have
+varying amounts of information in the markup string.  Details about the
+markup interfaces are found at @ref{Overview of text markup commands}.
+
+You can set a number of graphical properties according to your preference.
+Details about the property interface to fret diagrams are found at
+@internalsref{fret-diagram-interface}.
+
+
+@seealso
+
+Examples: @lsrdir{guitar}
+
+
+@node Right hand fingerings
+@unnumberedsubsubsec Right hand fingerings
+
+Right hand fingerings in chords can be entered using
+@code{@var{note}-\rightHandFinger @var{finger}}
+
+@lilypond[verbatim,fragment,relative=2]
+  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
+@end lilypond
+
+for brevity, you can abbreviate @code{\rightHandFinger} to something
+short, for example @code{RH},
+
+@example
+#(define RH rightHandFinger)
+@end example
+
+@cindex fingerings, right hand, for guitar 
+@cindex right hand fingerings for guitar
+ 
+@commonprop
+
+You may exercise greater control over right handing fingerings by
+setting @code{strokeFingerOrientations},
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(up down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+  \set strokeFingerOrientations = #'(up right down)
+  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
+}
+@end lilypond
+
+The letters used for the fingerings are contained in the property
+@code{digit-names}, but they can also be set individually by supplying
+@code{\rightHandFinger} with a string argument, as in the following example
+
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
+#(define RH rightHandFinger)
+{
+  \set strokeFingerOrientations = #'(right)
+  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
+  <c-\RH #5 >4
+  <c-\RH "@">4  
+}
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{StrokeFinger}
+
+
+
+@node Other guitar issues
+@unnumberedsubsubsec Other guitar issues
+
+This example demonstrates how to include guitar position and
+barring indications.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
+\clef "G_8"
+b16 d16 g16 b16 e16
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text = #"XII "
+  g16\startTextSpan
+  b16 e16 g16 e16 b16 g16\stopTextSpan
+e16 b16 g16 d16
+@end lilypond
+
+
+Stopped (X) note heads are used in guitar music to signal a place where the
+guitarist must play a certain note or chord, with its fingers just
+touching the strings instead of fully pressing them.  This gives the sound a
+percussive noise-like sound that still maintains part of the original
+pitch.  It is notated with cross noteheads; this is
+demonstrated in @ref{Special noteheads}.
+
+
+
diff --git a/Documentation/user/install.itely b/Documentation/user/install.itely
index b6f509b7e9..cc0ca9764b 100644
--- a/Documentation/user/install.itely
+++ b/Documentation/user/install.itely
@@ -83,7 +83,7 @@ mingw       - Windows x86
 
 Download source
 
-@itemize @bullet
+@itemize
 @item tarballs from
 @uref{http://lilypond.org/download/} by HTTP.
 @item tarballs from
@@ -120,7 +120,7 @@ FOO-devel, libFOO-dev or FOO-dev package too.
 
 @item @uref{http://fontforge.sf.net/,FontForge} 20060125 or newer.
 
-@item New Century Schoolbook fonts, as PFB files. These are shipped with
+@item New Century Schoolbook fonts, as PFB files.  These are shipped with
 X11 and Ghostscript, and are named @file{c059033l.pfb}
 @file{c059036l.pfb}, @file{c059013l.pfb} and @file{c059016l.pfb}
 
@@ -159,7 +159,7 @@ header files and libraries.
 
 Running LilyPond requires proper installation of the following software
 
-@itemize @bullet
+@itemize
 
 @item @uref{http://www.freetype.org/,Freetype} (version 2.1.10 or newer).
 @item @uref{http://www.freetype.org/,FontConfig} (version 2.2).
@@ -190,7 +190,7 @@ make web
 
 Building the website requires some additional tools and packages
 
-@itemize @bullet
+@itemize
 @item The @uref{http://netpbm.sourceforge.net/,netpbm utilities}
 @item ImageMagick
 @item International fonts (see input/regression/utf-8.ly for hints
@@ -279,6 +279,39 @@ unstable Lily will fail to build the docs.
 You may build the manual ( Documentation/user/ ) without building all
 the input/* stuff.
 
+@refbugs
+
+You may also need to create a script for @command{pngtopnm} and
+@code{pnmtopng}.  On Linux, I use this:
+
+@verbatim
+export LD_LIBRARY_PATH=/usr/lib
+exec /usr/bin/pngtopnm "$@"
+@end verbatim
+
+On OSX, I use this:
+
+@verbatim
+export DYLD_LIBRARY_PATH=/sw/lib
+exec /sw/bin/pngtopnm "$@" 
+@end verbatim
+
+In order to force make to build a complete manual (this does not
+rebuild all examples, only things which are changed), I recommend
+writing a script like this:
+
+@verbatim
+### run from Documentation/user/
+#  possibly required on OSX and/or old texinfo
+# ulimit -n 4096
+if [ -e out-www/lilypond.texi ]; then rm out-www/lilypond.* ; fi;
+if [ -e out-www/lilypond-program.texi ]; then rm
+out-www/lilypond-program.* ; fi;
+if [ -e out-www/lilypond-learning.texi ]; then rm
+out-www/lilypond-learning.* ; fi;
+nice make LILYPOND_EXTERNAL_BINARY=~/usr/bin/lilypond web
+@end verbatim
+
 
 @node Testing LilyPond
 @subsection Testing LilyPond
@@ -288,8 +321,8 @@ the input/* stuff.
 @end html
 
 LilyPond comes with an extensive suite that exercises the entire
-program. This suite can be used to automatically check the impact of a
-change. This is done as follows
+program.  This suite can be used to automatically check the impact of a
+change.  This is done as follows
 
 @example
 make test-baseline
@@ -337,7 +370,7 @@ Bugs that are not fault of LilyPond are documented here.
 @unnumberedsubsubsec Bison 1.875
 
 There is a bug in bison-1.875: compilation fails with "parse error
-before `goto'" in line 4922 due to a bug in bison. To fix, please
+before `goto'" in line 4922 due to a bug in bison.  To fix, please
 recompile bison 1.875 with the following fix
 
 @example
diff --git a/Documentation/user/instrument-notation.itely b/Documentation/user/instrument-notation.itely
deleted file mode 100644
index cd8f1e473a..0000000000
--- a/Documentation/user/instrument-notation.itely
+++ /dev/null
@@ -1,4757 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-
-@c A menu is needed before every deeper *section nesting of @node's; run
-@c     M-x texinfo-all-menus-update
-@c to automatically fill in these menus before saving changes
-
-@node Instrument-specific notation
-@chapter Instrument-specific notation
-
-This chapter explains how to use notation for specific instruments.
-
-@menu
-* Piano music::                 
-* Chord names::                 
-* Vocal music::                 
-* Rhythmic music::              
-* Guitar::                      
-* Bagpipe::                     
-* Ancient notation::            
-* Other instrument specific notation::  
-@end menu
-
-
-
-@node Piano music
-@section Piano music
-
-Piano staves are two normal staves coupled with a brace.  The staves
-are largely independent, but sometimes voices can cross between the
-two staves.  The same notation is also used for harps and other key
-instruments.  The @internalsref{PianoStaff} is especially built to
-handle this cross-staffing behavior.  In this section we discuss the
-@internalsref{PianoStaff} and some other pianistic peculiarities.
-
-@menu
-* Automatic staff changes::     
-* Manual staff switches::       
-* Pedals::                      
-* Staff switch lines::          
-* Cross staff stems::           
-@end menu
-
-@refbugs
-
-Dynamics are not centered, but workarounds do exist.  See the
-@q{piano centered dynamics} template in @ref{Piano templates}.
-
-@cindex cross staff stem
-@cindex stem, cross staff
-@cindex distance between staves in piano music
-
-
-@node Automatic staff changes
-@subsection Automatic staff changes
-@cindex Automatic staff changes
-
-Voices can be made to switch automatically between the top and the bottom
-staff.  The syntax for this is
-
-@quotation
-@example
-\autochange @dots{}@var{music}@dots{}
-@end example
-@end quotation
-
-@noindent
-This will create two staves inside the current PianoStaff, called
-@code{up} and @code{down}.  The lower staff will be in bass clef by
-default.
-
-A @code{\relative} section that is outside of @code{\autochange} has
-no effect on the pitches of @var{music}, so, if necessary, put
-@code{\relative} inside @code{\autochange} like
-
-@quotation
-@example
-\autochange \relative @dots{} @dots{}
-@end example
-@end quotation
-
-
-The autochanger switches on basis of the pitch (middle C is the turning
-point), and it looks ahead skipping over rests to switch in
-advance.  Here is a practical example
-
-@lilypond[quote,verbatim,ragged-right]
-\new PianoStaff
-  \autochange \relative c'
-  {
-    g4 a b c d r4 a g
-  }
-@end lilypond
-
-
-@seealso
-
-In this manual: @ref{Manual staff switches}.
-
-Program reference: @internalsref{AutoChangeMusic}.
-
-
-
-@refbugs
-
-The staff switches may not end up in optimal places.  For high
-quality output, staff switches should be specified manually.
-
-
-@code{\autochange} cannot be inside @code{\times}.
-
-
-@node Manual staff switches
-@subsection Manual staff switches
-
-@cindex manual staff switches
-@cindex staff switch, manual
-
-Voices can be switched between staves manually, using the command
-@example
-\change Staff = @var{staffname} @var{music}
-@end example
-
-@noindent
-The string @var{staffname} is the name of the staff.  It switches the
-current voice from its current staff to the Staff called
-@var{staffname}.  Typically @var{staffname} is @code{"up"} or
-@code{"down"}.  The @context{Staff} referred to must already exist, so
-usually the setup for a score will start with a setup of the staves,
-
-@example
-<<
-  \new Staff = "up" @{
-    \skip 1 * 10  % @emph{keep staff alive}
-    @}
-  \new Staff = "down" @{
-    \skip 1 * 10  % @emph{idem}
-    @}
->>
-@end example
-
-
-and the @context{Voice} is inserted afterwards
-
-@example
-\context Staff = down
-  \new Voice @{ @dots{} \change Staff = up @dots{} @}
-@end example
-
-
-@node Pedals
-@subsection Pedals
-@cindex Pedals
-
-Pianos have pedals that alter the way sound is produced.  Generally, a
-piano has three pedals, sustain, una corda, and sostenuto.
-
-
-Piano pedal instruction can be expressed by attaching
-@code{\sustainDown}, @code{\sustainUp}, @code{\unaCorda},
-@code{\treCorde}, @code{\sostenutoDown} and @code{\sostenutoUp} to a
-note or chord
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c'4\sustainDown c'4\sustainUp
-@end lilypond
-
-What is printed can be modified by setting @code{pedal@var{X}Strings},
-where @var{X} is one of the pedal types: @code{Sustain},
-@code{Sostenuto} or @code{UnaCorda}.  Refer to
-@internalsref{SustainPedal} in the program reference for more
-information.
-
-Pedals can also be indicated by a sequence of brackets, by setting the
-@code{pedalSustainStyle} property to bracket objects
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'bracket
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-A third style of pedal notation is a mixture of text and brackets,
-obtained by setting the @code{pedalSustainStyle} property to
-@code{mixed}
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'mixed
-c\sustainDown d e
-b\sustainUp\sustainDown
-b g \sustainUp a \sustainDown \bar "|."
-@end lilypond
-
-The default @q{*Ped.} style for sustain and damper pedals corresponds to
-style @code{#'text}.  The sostenuto pedal uses @code{mixed} style by
-default.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-For fine-tuning the appearance of a pedal bracket, the properties
-@code{edge-width}, @code{edge-height}, and @code{shorten-pair} of
-@code{PianoPedalBracket} objects (see
-@internalsref{PianoPedalBracket} in the Program reference) can be
-modified.  For example, the bracket may be extended to the right edge
-of the note head
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
-c\sostenutoDown d e c, f g a\sostenutoUp
-@end lilypond
-
-@seealso
-
-In this manual: @ref{Laissez vibrer ties}.
-
-@node Staff switch lines
-@subsection Staff switch lines
-
-
-@cindex follow voice
-@cindex staff switching
-@cindex cross staff
-
-@funindex followVoice
-
-Whenever a voice switches to another staff, a line connecting the notes
-can be printed automatically.  This is switched on by setting
-@code{followVoice} to true
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new PianoStaff <<
-  \new Staff="one" {
-    \set followVoice = ##t
-    c1
-    \change Staff=two
-    b2 a
-  }
-  \new Staff="two" { \clef bass \skip 1*2 }
->>
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{VoiceFollower}.
-
-@refcommands
-
-@funindex \showStaffSwitch
-@code{\showStaffSwitch},
-@funindex \hideStaffSwitch
-@code{\hideStaffSwitch}.
-
-
-@node Cross staff stems
-@subsection Cross staff stems
-
-Chords that cross staves may be produced by increasing the length
-of the stem in the lower staff, so it reaches the stem in the upper
-staff, or vice versa.
-
-@lilypond[ragged-right,verbatim,quote]
-stemExtend = {
-  \once \override Stem #'length = #10
-  \once \override Stem #'cross-staff = ##t
-}
-noFlag = \once \override Stem #'flag-style = #'no-flag
-\new PianoStaff <<
-  \new Staff {
-    \stemDown \stemExtend
-    f'4
-    \stemExtend \noFlag
-    f'8
-  }
-  \new Staff {
-    \clef bass
-    a4 a8
-  }
->>
-@end lilypond
-
-
-
-@node Chord names
-@section Chord names
-
-@menu
-* Introducing chord names::     
-* Chords mode::                 
-* Printing chord names::        
-@end menu
-
-
-@c  awkward name; awkward section name.
-@c  still, the Basic "chords" seems like a good name...  :(
-@node Introducing chord names
-@subsection Introducing chord names
-@cindex chord names
-
-LilyPond has support for printing chord names.  Chords may be entered
-in musical chord notation, i.e., @code{< .. >}, but they can also be
-entered by name.  Internally, the chords are represented as a set of
-pitches, so they can be transposed
-
-
-@lilypond[quote,ragged-right,verbatim,ragged-right]
-twoWays = \transpose c c' {
-  \chordmode {
-    c1 f:sus4 bes/f
-  }
-  <c e g>
-  <f bes c'>
-  <f bes d'>
-}
-
-<< \new ChordNames \twoWays
-   \new Voice \twoWays >>
-@end lilypond
-
-This example also shows that the chord printing routines do not try to
-be intelligent.  The last chord (@code{f bes d}) is not interpreted as
-an inversion.
-
-Note that the duration of chords must be specified outside the
-@code{<>}.
-
-@example
-<c e g>2
-@end example
-
-
-@node Chords mode
-@subsection Chords mode
-@cindex Chords mode
-
-In chord mode sets of pitches (chords) are entered with normal note
-names.  A chord is entered by the root, which is entered like a
-normal pitch
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { es4. d8 c2 }
-@end lilypond
-
-@noindent
-The mode is introduced by the keyword @code{\chordmode}.
-
-@cindex chord entry
-@cindex chord mode
-
-Other chords may be entered by suffixing a colon and introducing a
-modifier (which may include a number if desired)
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
-@end lilypond
-
-The first number following the root is taken to be the @q{type} of the
-chord, thirds are added to the root until it reaches the specified
-number.  The exception is @code{c:13}, for which the 11 is omitted.
-
-@lilypond[quote,fragment,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
-@end lilypond
-
-@cindex root of chord
-@cindex additions, in chords
-@cindex removals, in chords
-
-More complex chords may also be constructed adding separate steps
-to a chord.  Additions are added after the number following
-the colon and are separated by dots
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
-@end lilypond
-
-Chord steps can be altered by suffixing a @code{-} or @code{+} sign
-to the number
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
-@end lilypond
-
-Removals are specified similarly and are introduced by a caret.  They
-must come after the additions
-
-@lilypond[quote,verbatim,fragment]
-\chordmode { c^3 c:7^5 c:9^3.5 }
-@end lilypond
-
-Modifiers can be used to change pitches.  The following modifiers are
-supported
-
-@table @code
-@item m
-The minor chord.  This modifier lowers the 3rd and (if present) the 7th step.
-
-@item dim
-The diminished chord.  This modifier lowers the 3rd, 5th and (if present)
-the 7th step.
-
-@item aug
-The augmented chord.  This modifier raises the 5th step.
-
-@item maj
-The major 7th chord.  This modifier raises the 7th step if present.
-
-@item sus
-The suspended 4th or 2nd.  This modifier removes the 3rd
-step.  Append either @code{2} or @code{4} to add the 2nd or 4th step to
-the chord.
-@end table
-
-Modifiers can be mixed with additions
-@lilypond[quote,verbatim,fragment]
-  \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
-@end lilypond
-
-@cindex modifiers, in chords.
-@funindex aug
-@funindex dim
-@funindex maj
-@funindex sus
-@funindex m
-
-Since an unaltered 11 does not sound good when combined with an
-unaltered 13, the 11 is removed in this case (unless it is added
-explicitly)
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
-@end lilypond
-
-@funindex /
-
-An inversion (putting one pitch of the chord on the bottom), as well
-as bass notes, can be specified by appending
-@code{/}@var{pitch} to the chord
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/g c/f }
-@end lilypond
-@funindex /+
-
-A bass note can be added instead of transposed out of the chord,
-by using @code{/+}@var{pitch}.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\chordmode { c1 c/+g c/+f }
-@end lilypond
-
-Chords is a mode similar to @code{\lyricmode}, etc.  Most
-of the commands continue to work, for example, @code{r} and
-@code{\skip} can be used to insert rests and spaces, and property
-commands may be used to change various settings.
-
-
-
-@refbugs
-
-Each step can only be present in a chord once.  The following
-simply produces the augmented chord, since @code{5+} is interpreted
-last
-@cindex clusters
-@lilypond[quote,ragged-right,verbatim,fragment]
-\chordmode { c:5.5-.5+ }
-@end lilypond
-
-
-@node Printing chord names
-@subsection Printing chord names
-
-@cindex printing chord names
-@cindex chord names
-@cindex chords
-
-For displaying printed chord names, use the @internalsref{ChordNames} context.
-The chords may be entered either using the notation
-described above, or directly using @code{<} and @code{>}
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
-  \chordmode {a1 b c} <d' f' a'> <e' g' b'>
-}
-<<
-  \new ChordNames \harmonies
-  \new Staff \harmonies
->>
-@end lilypond
-
-You can make the chord changes stand out by setting
-@internalsref{ChordNames}.@code{chordChanges} to true.  This will only
-display chord names when there is a change in the chords scheme and at
-the start of a new line
-
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
-  c1:m c:m \break c:m c:m d
-}
-<<
-  \new ChordNames {
-    \set chordChanges = ##t
-    \harmonies }
-  \new Staff \transpose c c' \harmonies
->>
-@end lilypond
-
-The previous examples all show chords over a staff.  This is not
-necessary.  Chords may also be printed separately.  It may be necessary
-to add @internalsref{Volta_engraver} and @internalsref{Bar_engraver}
-for showing repeats.
-
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
-  \override BarLine #'bar-size = #4
-  \consists Bar_engraver
-  \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
-  f1:maj7 f:7 bes:7
-  c:maj7
-} \alternative {
-  es e
-}
-}
-@end lilypond
-
-
-The default chord name layout is a system for Jazz music, proposed by
-Klaus Ignatzek (see @ref{Literature list}).  It can be tuned through the
-following properties
-
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-This is a list that contains the chords that have special formatting.
-
-The exceptions list should be encoded as
-@example
-@{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-
-To get this information into @code{chordNameExceptions} takes a little
-manoeuvring.  The following code transforms @code{chExceptionMusic}
-(which is a sequential music) into a list of exceptions.
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Then,
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
-adds the new exceptions to the default ones, which are defined in
-@file{ly/@/chord@/-modifier@/-init@/.ly}.
-
-For an example of tuning this property, see also
-@lsr{chords,chord@/-name@/-exceptions@/.ly}
-@cindex exceptions, chord names.
-
-
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-This property contains the markup object used for the 7th step, when
-it is major.  Predefined options are @code{whiteTriangleMarkup} and
-@code{blackTriangleMarkup}.  See
-@lsr{chords,chord@/-name@/-major7@/.ly} for an example.
-
-@funindex chordNameSeparator
-@item chordNameSeparator
-Different parts of a chord name are normally separated by a
-slash.  By setting @code{chordNameSeparator}, you can specify other
-separators, e.g.,
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new ChordNames \chordmode {
-  c:7sus4
-  \set chordNameSeparator
-    = \markup { \typewriter "|" }
-  c:7sus4
-}
-@end lilypond
-
-@funindex chordRootNamer
-@item chordRootNamer
-The root of a chord is usually printed as a letter with an optional
-alteration.  The transformation from pitch to letter is done by this
-function.  Special note names (for example, the German @q{H} for a
-B-chord) can be produced by storing a new function in this property.
-
-@funindex chordNoteNamer
-@item chordNoteNamer
-The default is to print single pitch, e.g., the bass note, using the
-@code{chordRootNamer}.  The @code{chordNoteNamer} property can be set
-to a specialized function to change this behavior.  For example, the
-base can be printed in lower case.
-
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-The @q{m} for minor chords is usually printed right after the root of
-the chord. By setting @code{chordPrefixSpacer}, you can fix a spacer
-between the root and @q{m}. The spacer is not used when the root
-is altered.
-
-@end table
-
-The predefined variables @code{\germanChords},
-@code{\semiGermanChords}, @code{\italianChords} and @code{\frenchChords}
-set these variables.  The effect is
-demonstrated here,
-
-@lilypondfile[ragged-right]{chord-names-languages.ly}
-
-There are also two other chord name schemes implemented: an alternate
-Jazz chord notation, and a systematic scheme called Banter chords.  The
-alternate Jazz notation is also shown on the chart in @ref{Chord name
-chart}.  Turning on these styles is demonstrated in
-@lsr{chords,chord-names-jazz.ly}.
-
-@cindex Banter
-@cindex jazz chords
-@cindex chords, jazz
-
-
-@refcommands
-
-@funindex \germanChords
-@code{\germanChords},
-@funindex \semiGermanChords
-@code{\semiGermanChords}.
-@funindex \italianChords
-@code{\italianChords}.
-@funindex \frenchChords
-@code{\frenchChords}.
-
-
-
-
-@seealso
-
-Examples:
-@lsrdir{chords}
-
-Init files: @file{scm/@/chords@/-ignatzek@/.scm}, and
-@file{scm/@/chord@/-entry@/.scm}.
-
-
-@refbugs
-
-Chord names are determined solely from the list of pitches.  Chord
-inversions are not identified, and neither are added bass notes.  This
-may result in strange chord names when chords are entered with the
-@code{< .. >} syntax.
-
-
-
-@node Vocal music
-@section Vocal music
-
-Since LilyPond input files are text, there are two issues to
-consider when working with vocal music:
-
-@itemize @bullet
-@item
-Song texts must be entered as text, not notes.  For example, the
-input@tie{}@code{d} should be interpreted as a one letter syllable, not the
-note@tie{}D.
-
-@item
-Song texts must be aligned with the notes of their melody.
-@end itemize
-
-There are a few different ways to define lyrics; we shall begin
-by examining the simplest method, and gradually increase complexity.
-
-@menu
-* Setting simple songs::        
-* Entering lyrics::             
-* Aligning lyrics to a melody::  
-* Working with lyrics and identifiers::  
-* Flexibility in placement::    
-* Spacing lyrics::              
-* More about stanzas::          
-* Ambitus::                     
-* Other vocal issues::          
-@end menu
-
-
-@commonprop
-
-Checking to make sure that text scripts and lyrics are within the margins is
-a relatively large computational task.  To speed up processing, lilypond does
-not perform such calculations by default; to enable it, use
-
-@example
-\override Score.PaperColumn #'keep-inside-line = ##t
-@end example
-
-To make lyrics avoid barlines as well, use
-@example
-\layout @{
-  \context @{
-    \Lyrics
-      \consists "Bar_engraver"
-      \consists "Separating_line_group_engraver"
-      \override BarLine #'transparent = ##t
-  @}
-@}
-@end example
-
-
-@node Setting simple songs
-@subsection Setting simple songs
-
-@cindex \addlyrics
-
-The easiest way to add lyrics to a melody is to append
-
-@example
-\addlyrics @{ @var{the lyrics} @}
-@end example
-
-@noindent
-to a melody.  Here is an example,
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-@end lilypond
-
-More stanzas can be added by adding more
-@code{\addlyrics} sections
-
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
-@end lilypond
-
-The command @code{\addlyrics} cannot handle polyphony settings.  For these
-cases you should use @code{\lyricsto} and @code{\lyricmode}, as will be
-introduced in @ref{Entering lyrics}.
-
-
-
-@node Entering lyrics
-@subsection Entering lyrics
-
-@cindex lyrics
-@funindex \lyricmode
-@cindex punctuation
-@cindex spaces, in lyrics
-@cindex quotes, in lyrics
-
-Lyrics are entered in a special input mode, which can be introduced
-by the keyword @code{\lyricmode}, or by using @code{\addlyrics} or
-@code{\lyricsto}.  In this mode you can enter lyrics,
-with punctuation and accents, and the input @code{d} is not parsed as
-a pitch, but rather as a one letter syllable.  Syllables are entered
-like notes, but with pitches replaced by text.  For example,
-
-@example
-\lyricmode @{ Twin-4 kle4 twin- kle litt- le star2 @}
-@end example
-
-There are two main methods to specify the horizontal placement
-of the syllables, either by specifying the duration of each syllable
-explicitly, like in the example above, or by automatically aligning
-the lyrics to a melody or other voice of music, using @code{\addlyrics}
-or @code{\lyricsto}.
-@c  TODO: broken
-@c For more details see @ref{The Lyrics context}.
-
-A word or syllable of lyrics begins with an alphabetic character, and ends
-with
-any space or digit.  The following characters can be any character
-that is not a digit or white space.
-
-Any character that is not a digit or white space will be regarded as
-part of the syllable; one important consequence of this is that a word
-can end with @code{@}}, which often leads to the following mistake:
-
-@example
-\lyricmode @{ lah- lah@}
-@end example
-
-In this example, the @code{@}} is included in the final syllable, so the
-opening brace is not balanced and the input file will probably not
-compile.
-
-
-@funindex \property in \lyricmode
-
-@noindent
-Similarly, a period which follows an alphabetic sequence is included in
-the resulting string.  As a consequence, spaces must be inserted around
-property commands: do @emph{not} write
-
-@example
-\override Score.LyricText #'font-shape = #'italic
-@end example
-
-@noindent
-but instead use
-
-@example
-\override Score . LyricText #'font-shape = #'italic
-@end example
-
-@funindex _
-@cindex spaces, in lyrics
-@cindex quotes, in lyrics
-@cindex ties, in lyrics
-
-In order to assign more than one syllable to a single note, you can
-surround them with quotes or use a @code{_} character, to get spaces
-between syllables, or use tilde  symbol (@code{~}) to get a lyric tie.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-The lyric tie is implemented with the Unicode character U+203F, so be
-sure to have a font (Like DejaVuLGC) installed that includes this
-glyph.
-
-
-To enter lyrics with characters from non-English languages, or with
-accented and special characters (such as the heart symbol or slanted quotes),
-simply insert the characters directly into the input file and save
-it with utf-8 encoding.  See @ref{Text encoding}, for more info.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative { e4 f e d e f e2 }
-\addlyrics { He said: “Let my peo ple go”. }
-@end lilypond
-
-To use normal quotes in lyrics, add a backslash before the
-quotes.  For example,
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
-\addlyrics { "\"I" am so lone- "ly\"" said she }
-@end lilypond
-
-The full definition of a word start in Lyrics mode is somewhat more
-complex.
-
-A word in Lyrics mode begins with: an alphabetic character, @code{_},
-@code{?}, @code{!}, @code{:}, @code{'}, the control characters @code{^A}
-through @code{^F}, @code{^Q} through @code{^W}, @code{^Y}, @code{^^},
-any 8-bit character with ASCII code over 127, or a two-character
-combination of a backslash followed by one of @code{`}, @code{'},
-@code{"}, or @code{^}.
-
-To define identifiers containing lyrics, the function @code{lyricmode}
-must be used.
-
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
-  <<
-    \new Voice = "one" \relative c'' @{
-      \autoBeamOff
-      \time 2/4
-      c4 b8. a16 g4. f8 e4 d c2
-    @}
-    \addlyrics @{ \verseOne @}
-  >>
-@}
-@end example
-
-
-@seealso
-
-Program reference: @internalsref{LyricText}, @internalsref{LyricSpace}.
-
-
-
-@node Aligning lyrics to a melody
-@subsection Aligning lyrics to a melody
-
-@funindex \lyricmode
-@funindex \addlyrics
-@funindex \lyricsto
-
-
-Lyrics are printed by interpreting them in the context called
-@internalsref{Lyrics}.
-
-@example
-\new Lyrics \lyricmode @dots{}
-@end example
-
-There are two main methods to specify the horizontal placement
-of the syllables:
-
-@itemize @bullet
-@item
-by automatically aligning
-the lyrics to a melody or other voice of music, using @code{\addlyrics}
-or @code{\lyricsto}.
-
-@item
-or by specifying the duration of each syllable
-explicitly, using @code{\lyricmode}
-@end itemize
-
-@menu
-* Automatic syllable durations::  
-* Another way of entering lyrics::  
-* Assigning more than one syllable to a single note::  
-* More than one note on a single syllable::  
-* Extenders and hyphens::       
-@end menu
-
-@node Automatic syllable durations
-@subsubsection Automatic syllable durations
-
-@cindex automatic syllable durations
-@cindex lyrics and melodies
-
-The lyrics can be aligned under a given melody
-automatically.  This is achieved by combining the
-melody and the lyrics with the @code{\lyricsto} expression
-
-@example
-\new Lyrics \lyricsto @var{name} @dots{}
-@end example
-
-This aligns the lyrics to the
-notes of the @internalsref{Voice} context called @var{name}, which must
-already exist.  Therefore normally the @code{Voice} is specified first, and
-then the lyrics are specified with @code{\lyricsto}.  The command
-@code{\lyricsto} switches to @code{\lyricmode} mode automatically, so the
-@code{\lyricmode} keyword may be omitted.
-
-The following example uses different commands for entering lyrics.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-<<
-  \new Voice = "one" \relative c'' {
-    \autoBeamOff
-    \time 2/4
-    c4 b8. a16 g4. f8 e4 d c2
-  }
-  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
-  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
-  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
->>
-@end lilypond
-
-The second stanza is not properly aligned because the durations
-were not specified.  A solution for that would be to use @code{\lyricsto}.
-
-The @code{\addlyrics} command is actually just a convenient way
-to write a more complicated LilyPond structure that sets up the
-lyrics.
-
-@example
-@{ MUSIC @}
-\addlyrics @{ LYRICS @}
-@end example
-
-@noindent
-is the same as
-
-@example
-\new Voice = "blah" @{ music @}
-\new Lyrics \lyricsto "blah" @{ LYRICS @}
-@end example
-
-@node Another way of entering lyrics
-@subsubsection Another way of entering lyrics
-
-Lyrics can also be entered without @code{\addlyrics} or
-@code{\lyricsto}.  In this case,
-syllables are entered like notes -- but with pitches replaced by text -- and the
-duration of each syllable must be entered explicitly. For example:
- 
-@example
-play2 the4 game2.
-sink2 or4 swim2.
-@end example
- 
-The alignment to a melody can be specified with the
-@code{associatedVoice} property,
- 
-@example
-\set associatedVoice = #"lala"
-@end example
- 
-@noindent
-The value of the property (here: @code{"lala"}) should be the name of
-a @internalsref{Voice} context.  Without this setting, extender lines
-will not be formatted properly.
- 
-Here is an example demonstrating manual lyric durations,
- 
-@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
-<< \new Voice = "melody" {
-    \time 3/4
-    c2 e4 g2.
- }
- \new Lyrics \lyricmode {
-   \set associatedVoice = #"melody"
-   play2 the4 game2.
- } >>
-@end lilypond
-
-@seealso
- 
-Program reference: @internalsref{Lyrics}.
-
-
-@node Assigning more than one syllable to a single note
-@subsubsection Assigning more than one syllable to a single note
-
-
-@funindex _
-@cindex ties, in lyrics
-
-In order to assign more than one syllable to a single note, you can
-surround them with quotes or use a @code{_} character, to get spaces
-between syllables, or use tilde  symbol (@code{~}) to get a lyric
-tie@footnote{The lyric ties is implemented with the Unicode character
-U+203F, so be
-sure to have a font (Like DejaVuLGC) installed that includes this
-glyph.}.
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-\time 3/4
-\relative { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{LyricCombineMusic}.
-
-@c Here come the section which used to be "Melismata"
-@c the new title might be more self-explanatory
-
-
-@node More than one note on a single syllable
-@subsubsection More than one note on a single syllable
-
-@cindex melisma
-@cindex melismata
-@cindex phrasing, in lyrics
-
-Sometimes, particularly in Medieval music, several notes are to be sung on one
-single syllable; such vocalises are called melismas, or melismata.
-
-@c this method seems to be the simplest; therefore
-@c it might be better to present it first - vv
-
-You can define melismata entirely in the lyrics, by entering @code{_}
-for every note
-that is part of the melisma.
-
-@lilypond[relative=1,verbatim,fragment,quote]
-{ \set melismaBusyProperties = #'()
- c d( e) f f( e) e e  }
-\addlyrics
- { Ky -- _ _ ri __ _ _ _  e }
-@end lilypond
-
-In this case, you can also have ties and slurs in the melody if you
-set @code{melismaBusyProperties}, as is done in the example above.
-
-However, the @code{\lyricsto} command can also
-detect melismata automatically: it only puts one
-syllable under a tied or slurred group of notes.  If you want to force
-an unslurred group of notes to be a melisma, insert @code{\melisma}
-after the first note of the group, and @code{\melismaEnd} after the
-last one, e.g.,
-
-@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
-<<
-  \new Voice = "lala" {
-    \time 3/4
-    f4 g8
-    \melisma
-    f e f
-    \melismaEnd
-    e2
-  }
-  \new Lyrics \lyricsto "lala" {
-    la di __ daah
-  }
->>
-@end lilypond
-
-In addition, notes are considered a melisma if they are manually
-beamed, and automatic beaming (see @ref{Setting automatic beam
-behavior}) is switched off.
-
-@c TODO: there might be some more relevant place for 
-@c the following link (?)
-
-@cindex SATB
-@cindex choral score
-
-A complete example of a SATB score setup is in section
-@ref{Vocal ensembles}.
-
-
-@refcommands
-
-@code{\melisma}, @code{\melismaEnd}
-@funindex \melismaEnd
-@funindex \melisma
-
-@seealso
-
-Program reference: @internalsref{Melisma_translator}.
-
-@lsr{vocal,lyric@/-combine.ly}.
-
-@refbugs
-
-Melismata are not detected automatically, and extender lines must be
-inserted by hand.
-
-@node Extenders and hyphens
-@subsubsection Extenders and hyphens
-
-@cindex melisma
-@cindex extender
-
-Melismata are indicated with a horizontal line centered between a syllable
-and the next one.  Such a line is called an extender line, and it is entered
-as @samp{ __ } (note the spaces before and after the two underscore
-characters).
-
-@cindex hyphens
-
-Centered hyphens are entered as @samp{ -- } between syllables of a same word
-(note the spaces before and after the two hyphen characters).  The hyphen
-will be centered between the syllables, and its length will be adjusted
-depending on the space between the syllables.
-
-In tighly engraved music, hyphens can be removed.  Whether this
-happens can be controlled with the @code{minimum-distance} (minimum
-distance between two syllables) and the @code{minimum-length}
-(threshold below which hyphens are removed).
-
-@seealso
-
-Program reference: @internalsref{LyricExtender},
-@internalsref{LyricHyphen}
-
-
-@node Working with lyrics and identifiers
-@subsection Working with lyrics and identifiers
-@cindex lyrics, identifiers
-
-To define identifiers containing lyrics, the function @code{\lyricmode}
-must be used. You do not have to enter durations though, if you add
-@code{\addlyrics} or @code{\lyricsto}
-when invoking your identifier.
- 
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
- <<
-   \new Voice = "one" \relative c'' @{
-     \autoBeamOff
-     \time 2/4
-     c4 b8. a16 g4. f8 e4 d c2
-   @}
-   \addlyrics @{ \verseOne @}
- >>
-@}
-@end example
- 
-For different or more complex orderings, the best way is to setup the
-hierarchy of staves and lyrics first, e.g.,
-@example
-\new ChoirStaff <<
-  \new Voice = "soprano" @{ @emph{music} @}
-  \new Lyrics = "sopranoLyrics" @{ s1 @}
-  \new Lyrics = "tenorLyrics" @{ s1 @}
-  \new Voice = "tenor" @{ @emph{music} @}
->>
-@end example
- 
-and then combine the appropriate melodies and lyric lines
- 
-@example
-\context Lyrics = sopranoLyrics \lyricsto "soprano"
-@emph{the lyrics}
-@end example
- 
-@noindent
-
-The final input would resemble
- 
-@example
-<<\new ChoirStaff << @emph{setup the music} >>
- \lyricsto "soprano" @emph{etc}
- \lyricsto "alto" @emph{etc}
-@emph{etc}
->>
-@end example
- 
-@seealso
- 
-@c TODO: document \new Staff << Voice \lyricsto >> bug
-Program reference: @internalsref{LyricCombineMusic},
-@internalsref{Lyrics}.  
-
-
-@node Flexibility in placement
-@subsection Flexibility in placement
-
-Often, different stanzas of one song are put to one melody in slightly
-differing ways.  Such variations can still be captured with
-@code{\lyricsto}.
-
-@menu
-* Lyrics to multiple notes of a melisma::  
-* Divisi lyrics::               
-* Switching the melody associated with a lyrics line::  
-* Lyrics independent of notes::  
-@end menu
-
-
-@node Lyrics to multiple notes of a melisma
-@subsubsection Lyrics to multiple notes of a melisma
-
-One possibility is that the text has a melisma in one stanza, but
-multiple syllables in another one.  One solution is to make the faster
-voice ignore the melisma.  This is done by setting
-@code{ignoreMelismata} in the Lyrics context.
-
-There is one tricky aspect: the setting for @code{ignoreMelismata}
-must be set one syllable @emph{before} the non-melismatic syllable
-in the text, as shown here,
-
-@c  FIXME: breaks compile
-@lilypond[verbatim,ragged-right,quote]
-%{
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    \slurDotted
-    f8.[( g16])
-    a4
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    more slow -- ly
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    \set ignoreMelismata = ##t % applies to "fas"
-    go fas -- ter
-    \unset ignoreMelismata
-    still
-  }
->>
-%}
-@end lilypond
-
-
-The @code{ignoreMelismata} applies to the syllable @q{fas}, so it
-should be entered before @q{go}.
-
-The reverse is also possible: making a lyric line slower than the
-standard.  This can be achieved by insert @code{\skip}s into the
-lyrics.  For every @code{\skip}, the text will be delayed another note.
-For example,
-
-@lilypond[verbatim,ragged-right,quote]
-\relative { c c g' }
-\addlyrics {
-  twin -- \skip 4
-  kle
-}
-@end lilypond
-
-
-@node Divisi lyrics
-@subsubsection Divisi lyrics
-
-You can display alternate (or divisi) lyrics by naming voice
-contexts and attaching lyrics to those specific contexts.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" {
-    \relative c' {
-      c4
-      <<
-        { \voiceOne c8 e }
-        \new Voice = "splitpart" { \voiceTwo c4 }
-      >>
-      \oneVoice c4 c | c
-    }
-  }
-  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
-  \new Lyrics \lyricsto "splitpart" { will }
->> }
-@end lilypond
-
-
-You can use this trick to display different lyrics for a repeated
-section.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" \relative c' {
-    c2 e | g e | c1 |
-    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
-    a2 b | c1}
-  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
-    do mi sol mi do
-    la si do }
-  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
-   do re mi fa sol }
-  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
-   dodo rere mimi fafa solsol }
->>
-}
-@end lilypond
-
-
-
-@node Switching the melody associated with a lyrics line
-@subsubsection Switching the melody associated with a lyrics line
-
-More complex variations in text underlay are possible.  It is possible
-to switch the melody for a line of lyrics during the text.  This is
-done by setting the @code{associatedVoice} property.  In the example
-
-@lilypond[ragged-right,quote]
-<<
-  \relative \new Voice = "lahlah" {
-    \set Staff.autoBeaming = ##f
-    c4
-    <<
-      \new Voice = "alternative" {
-        \voiceOne
-        \times 2/3 {
-          % show associations clearly.
-          \override NoteColumn #'force-hshift = #-3
-          f8 f g
-        }
-      }
-      {
-        \voiceTwo
-        f8.[ g16]
-        \oneVoice
-      } >>
-    a8( b) c
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    Ju -- ras -- sic Park
-  }
-  \new Lyrics \lyricsto "lahlah" {
-    % Tricky: need to set associatedVoice
-    % one syllable too soon!
-    \set associatedVoice = alternative % applies to "ran"
-    Ty --
-    ran --
-    no --
-    \set associatedVoice = lahlah % applies to "rus"
-    sau -- rus Rex
-  } >>
-@end lilypond
-
-@noindent
-the text for the first stanza is set to a melody called @q{lahlah},
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  Ju -- ras -- sic Park
-@}
-@end example
-
-
-The second stanza initially is set to the @code{lahlah} context, but
-for the syllable @q{ran}, it switches to a different melody.
-This is achieved with
-@example
-\set associatedVoice = alternative
-@end example
-
-@noindent
-Here, @code{alternative} is the name of the @code{Voice} context
-containing the triplet.
-
-Again, the command must be one syllable too early, before @q{Ty} in
-this case.
-
-@example
-\new Lyrics \lyricsto "lahlah" @{
-  \set associatedVoice = alternative % applies to "ran"
-  Ty --
-  ran --
-  no --
-  \set associatedVoice = lahlah % applies to "rus"
-  sau -- rus Rex
-@}
-@end example
-
-@noindent
-The underlay is switched back to the starting situation by assigning
-@code{lahlah} to @code{associatedVoice}.
-
-
-@node Lyrics independent of notes
-@subsubsection Lyrics independent of notes
-
-In some complex vocal music, it may be desirable to place
-lyrics completely independently of notes.  Music defined
-inside @code{lyricrhythm} disappears into the
-@code{Devnull} context, but the rhythms can still be used
-to place the lyrics.
-
-@lilypond[quote,verbatim,ragged-right]
-voice = {
-  c''2
-  \tag #'music { c''2 }
-  \tag #'lyricrhythm { c''4. c''8 }
-  d''1
-}
-
-lyr = \lyricmode { I like my cat! }
-
-<<
-  \new Staff \keepWithTag #'music \voice
-  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
-  \new Lyrics \lyricsto "nowhere" \lyr
-  \new Staff { c'8 c' c' c' c' c' c' c'
-  c' c' c' c' c' c' c' c' }
->>
-@end lilypond
-
-
-@node Spacing lyrics
-@subsection Spacing lyrics
-
-@cindex Spacing lyrics
-@cindex Lyrics, increasing space between
-
-To increase the spacing between lyrics, set the minimum-distance property of
-LyricSpace.
-
-@lilypond[relative,verbatim,fragment,quote,ragged-right]
-{
-  c c c c
-  \override Lyrics.LyricSpace #'minimum-distance = #1.0
-  c c c c
-}
-\addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-}
-@end lilypond
-
-To make this change for all lyrics in the score, set the property in the
-layout.
-
-@lilypond[relative,verbatim,quote,ragged-right]
-\score {
-  \relative c' {
-  c c c c
-  c c c c
-  }
-  \addlyrics {
-  longtext longtext longtext longtext
-  longtext longtext longtext longtext
-  }
-  \layout {
-    \context {
-      \Lyrics
-      \override LyricSpace #'minimum-distance = #1.0
-    }
-  }
-}
-@end lilypond
-
-
-@node More about stanzas
-@subsection More about stanzas
-
-@cindex stanza number
-@subsubsection Adding stanza numbers 
-
-Stanza numbers can be added by setting @code{stanza}, e.g.,
-
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set stanza = "1. "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set stanza = "2. "
-  Oh, ché -- ri, je t'aime
-}
-@end lilypond
-
-@noindent
-These numbers are put just before the start of the first syllable.
-
-
-@subsubsection Adding dynamics marks
-
-Stanzas differing in loudness may be indicated by putting a
-dynamics mark before each stanza.  In Lilypond, everthing coming in
-front of a stanza goes into the @code{StanzaNumber} object; dynamics marks
-are no different.  For technical reasons, you have to set the stanza
-outside @code{\lyricmode}:
-
-@lilypond[quote,ragged-right,verbatim]
-text = {
-  \set stanza = \markup { \dynamic "ff" "1. " }
-  \lyricmode {
-    Big bang
-  }
-}
-
-<<
-  \new Voice = "tune" {
-    \time 3/4
-    g'4 c'2
-  }
-\new Lyrics \lyricsto "tune" \text
->>
-@end lilypond
-
-@cindex singer name
-@cindex name of singer
-@subsubsection Adding singer names
-
-Names of singers can also be added.  They are printed at the start of
-the line, just like instrument names.  They are created by setting
-@code{vocalName}.  A short version may be entered as @code{shortVocalName}.
-
-@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
-\new Voice {
-  \time 3/4 g2 e4 a2 f4 g2.
-} \addlyrics {
-  \set vocalName = "Bert "
-  Hi, my name is Bert.
-} \addlyrics {
-  \set vocalName = "Ernie "
-  Oh, che -- ri, je t'aime
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end 
-
-Sometimes it is appropriate to have one stanza set
-to the music, and the rest added in verse form at
-the end of the piece.  This can be accomplished by adding
-the extra verses into a @code{\markup} section outside
-of the main score block.  Notice that there are two
-different ways to force linebreaks when using
-@code{\markup}.
-
-@lilypond[ragged-right,verbatim,quote]
-melody = \relative c' {
-e d c d | e e e e |
-d d e d | c1 |
-}
-
-text = \lyricmode {
-\set stanza = "1." Ma- ry had a lit- tle lamb,
-its fleece was white as snow.
-}
-
-\score{ <<
-  \new Voice = "one" { \melody }
-  \new Lyrics \lyricsto "one" \text
->>
-  \layout { }
-}
-\markup { \column{
-  \line{ Verse 2. }
-  \line{ All the children laughed and played }
-  \line{ To see a lamb at school. }
-  }
-}
-\markup{
-  \wordwrap-string #"
-  Verse 3.
-
-  Mary took it home again,
-
-  It was against the rule."
-}
-@end lilypond
-
-
-@subsubsection Printing stanzas at the end in multiple columns 
-
-When a piece of music has many verses, they are often printed in
-multiple columns across the page. An outdented verse number often
-introduces each verse. The following example shows how to produce such
-output in Lilypond.
-
-@lilypond[ragged-right,quote,verbatim]
-melody = \relative c' {
-  c c c c | d d d d
-}
- 
-text = \lyricmode {
-  \set stanza = "1." This is verse one.
-  It has two lines.
-}
-
-\score{ <<
-    \new Voice = "one" { \melody }
-    \new Lyrics \lyricsto "one" \text
-   >>
-  \layout { }
-}
-
-\markup {
-  \fill-line {
-    \hspace #0.1 % moves the column off the left margin; can be removed if
-        % space on the page is tight
-     \column {
-      \line { \bold "2."
-        \column {
-          "This is verse two."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "3."
-        \column {
-          "This is verse three."
-          "It has two lines."
-        }
-      }
-    }
-    \hspace #0.1  % adds horizontal spacing between columns; if they are
-        % still too close, add more " " pairs until the result 
-        % looks good
-     \column {
-      \line { \bold "4."
-        \column {
-          "This is verse four."
-          "It has two lines."
-        }
-      }
-      \hspace #0.1 % adds vertical spacing between verses
-      \line { \bold "5."
-        \column {
-          "This is verse five."
-          "It has two lines."
-        }
-      }
-    }
-  \hspace #0.1 % gives some extra space on the right margin; can
-      % be removed if page space is tight
-  }
-}
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
-@internalsref{VocalName}.
-
-
-
-@node Ambitus
-@subsection Ambitus
-@cindex ambitus
-
-The term @emph{ambitus} denotes a range of pitches for a given voice
-in a part of music.  It may also denote the pitch range that a musical
-instrument is capable of playing.  Ambits are printed on vocal parts,
-so performers can easily determine it meets their capabilities.
-
-Ambits are denoted at the beginning of a piece near the initial clef.
-The range is graphically specified by two note heads that represent the
-minimum and maximum pitch.  To print such ambits, add the
-@internalsref{Ambitus_engraver} to the @internalsref{Voice} context,
-for example,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-This results in the following output
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-If you have multiple voices in a single staff and you want a single
-ambitus per staff rather than per each voice, add the
-@internalsref{Ambitus_engraver} to the @internalsref{Staff} context
-rather than to the @internalsref{Voice} context.  Here is an example,
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-This example uses one advanced feature,
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-This code moves the ambitus to the left.  The same effect could have
-been achieved with @code{extra-offset}, but then the formatting system
-would not reserve space for the moved object.
-
-@seealso
-
-Program reference: @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Examples:
-@lsr{vocal,ambitus@/.ly}.
-
-@refbugs
-
-There is no collision handling in the case of multiple per-voice
-ambitus.
-
-
-@node Other vocal issues
-@subsection Other vocal issues
-
-@ignore
-yeah, I'm giving up somewhat by stuffing a bunch of things in
-here.  But at least they're in the manual now; it's easier to
-move them around in the manual once they're already here.
-
-Besides, if users complain about everything stuffed in here, I
-can ask them for specific instructions about where to move these
-examples, and that might get them more involved in the docs.  -gp
-@end ignore
-
-@q{Parlato} is spoken without pitch but still with rhythm; it is
-notated by cross noteheads.  This is demonstrated in
-@ref{Special noteheads}.
-
-
-
-
-
-@node Rhythmic music
-@section Rhythmic music
-
-Rhythmic music is primarily used for percussion and drum notation, but it can
-also be used to show the rhythms of melodies.
-
-@menu
-* Showing melody rhythms::      
-* Entering percussion::         
-* Percussion staves::           
-* Ghost notes::                 
-@end menu
-
-
-@node Showing melody rhythms
-@subsection Showing melody rhythms
-
-Sometimes you might want to show only the rhythm of a melody.  This
-can be done with the rhythmic staff.  All pitches of notes on such a
-staff are squashed, and the staff itself has a single line
-
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
-\new RhythmicStaff {
-  \time 4/4
-  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
-}
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{RhythmicStaff}.
-
-
-@node Entering percussion
-@subsection Entering percussion
-
-@cindex percussion
-@cindex drums
-
-
-Percussion notes may be entered in @code{\drummode} mode, which is
-similar to the standard mode for entering notes.  Each piece of
-percussion has a full name and an abbreviated name, and both can be used
-in input files
-
-@lilypond[quote,ragged-right,verbatim]
-\drums {
-  hihat hh bassdrum bd
-}
-@end lilypond
-
-The complete list of drum names is in the init file
-@file{ly/@/drumpitch@/-init@/.ly}.
-@c TODO: properly document this.
-
-@seealso
-
-Program reference: @internalsref{note-event}.
-
-@node Percussion staves
-@subsection Percussion staves
-@cindex percussion
-@cindex drums
-
-A percussion part for more than one instrument typically uses a
-multiline staff where each position in the staff refers to one piece
-of percussion.
-
-
-To typeset the music, the notes must be interpreted in a
-@internalsref{DrumStaff} and @internalsref{DrumVoice} contexts
-
-@lilypond[quote,ragged-right,verbatim]
-up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
-down = \drummode { bassdrum4 snare8 bd r bd sn4 }
-  \new DrumStaff <<
-    \new DrumVoice { \voiceOne \up }
-    \new DrumVoice { \voiceTwo \down }
-  >>
-@end lilypond
-
-The above example shows verbose polyphonic notation.  The short
-polyphonic notation, described in @ref{Basic polyphony}, can also be used if
-the @internalsref{DrumVoice}s are instantiated by hand first.  For example,
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new DrumStaff <<
-  \new DrumVoice = "1" { s1 *2 }
-  \new DrumVoice = "2" { s1 *2 }
-  \drummode {
-    bd4 sn4 bd4 sn4
-    <<
-      { \repeat unfold 16 hh16 }
-      \\
-      { bd4 sn4 bd4 sn4 }
-    >>
-  }
->>
-@end lilypond
-
-
-There are also other layout possibilities.  To use these, set the
-property @code{drumStyleTable} in context @internalsref{DrumVoice}.
-The following variables have been predefined
-
-@table @code
-@item drums-style
-This is the default.  It typesets a typical drum kit on a five-line staff
-
-@lilypond[quote,line-width=10.0\cm]
-nam = \lyricmode {
-  cymc cyms cymr hh hhc hho hhho hhp
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
-mus = \drummode {
-  cymc cyms cymr hh hhc hho hhho hhp \break
-  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
-\score {
-  << \new DrumStaff \with {
-       \remove Bar_engraver
-       \remove Time_signature_engraver
-       \override Stem #'transparent = ##t
-       \override Stem #'Y-extent-callback = ##f
-       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
-     } \mus
-     \new Lyrics \nam
-  >>
-  \layout {
-    \context {
-      \Score
-      \override LyricText #'font-family = #'typewriter
-      \override BarNumber #'transparent =##T
-    }
-  }
-}
-@end lilypond
-
-The drum scheme supports six different toms.  When there are fewer toms,
-simply select the toms that produce the desired result, i.e., to get toms
-on the three middle lines you use @code{tommh}, @code{tomml}, and
-@code{tomfh}.
-
-@item timbales-style
-This typesets timbales on a two line staff
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { timh ssh timl ssl cb }
-mus = \drummode { timh ssh timl ssl cb s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-    \override StaffSymbol #'line-count = #2
-    \override StaffSymbol #'staff-space = #2
-    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
-    drumStyleTable = #timbales-style
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item congas-style
-This typesets congas on a two line staff
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
-mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    drumStyleTable = #congas-style
-    \override StaffSymbol #'line-count = #2
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item bongos-style
-This typesets bongos on a two line staff
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
-mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
-
-<<
-  \new DrumStaff \with {
-    \remove Bar_engraver
-    \remove Time_signature_engraver
-    \override StaffSymbol #'line-count = #2
-    drumStyleTable = #bongos-style
-
-    %% this sucks; it will lengthen stems.
-    \override StaffSymbol #'staff-space = #2
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-
-@item percussion-style
-To typeset all kinds of simple percussion on one line staves.
-
-@lilypond[quote,ragged-right]
-nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
-mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
-
-<<
-  \new DrumStaff \with{
-    \remove Bar_engraver
-    drumStyleTable = #percussion-style
-    \override StaffSymbol #'line-count = #1
-    \remove Time_signature_engraver
-    \override Stem #'transparent = ##t
-    \override Stem #'Y-extent-callback = ##f
-  } \mus
-  \new Lyrics {
-    \override LyricText #'font-family = #'typewriter
-    \nam
-  }
->>
-@end lilypond
-@end table
-
-If you do not like any of the predefined lists you can define your own
-list at the top of your file
-
-@lilypond[quote,ragged-right,verbatim]
-#(define mydrums '(
-         (bassdrum     default   #f         -1)
-         (snare        default   #f         0)
-         (hihat        cross     #f         1)
-         (pedalhihat   xcircle   "stopped"  2)
-         (lowtom       diamond   #f         3)))
-up = \drummode { hh8 hh hh hh hhp4 hhp }
-down = \drummode { bd4 sn bd toml8 toml }
-
-\new DrumStaff <<
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
-  \new DrumVoice { \voiceOne \up }
-  \new DrumVoice { \voiceTwo \down }
->>
-@end lilypond
-
-
-@seealso
-
-Init files: @file{ly/@/drumpitch@/-init@/.ly}.
-
-Program reference: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
-
-@refbugs
-
-Because general MIDI does not contain rim shots, the sidestick is used
-for this purpose instead.
-
-
-@c FIXME: check name -gp
-@node Ghost notes
-@subsection Ghost notes
-
-Ghost notes for drums and percussion may be created using the
-@code{\parenthesize} command detailed in @ref{Parentheses}.  However,
-the default @code{\drummode} does
-not include the @code{Parenthesis_engraver} plugin which allows
-this.  You
-must add the plugin explicitly in the context definition as
-detailed in @ref{Changing context properties on the fly}.
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-\new DrumStaff \with {
-  \consists "Parenthesis_engraver"
-} <<
-  \context DrumVoice  = "1"  { s1 *2 }
-  \context DrumVoice  = "2" { s1 *2 }
-  \drummode {
-    <<
-      {
-        hh8[ hh] <hh sn> hh16
-        < \parenthesize sn > hh < \parenthesize
-        sn > hh8 <hh sn> hh
-      } \\ {
-        bd4 r4 bd8 bd r8 bd
-      }
-    >>
-  }
->>
-@end lilypond
-
-@noindent
-Also note that you must add chords (@code{< >} brackets)
-around each @code{\parenthesize} statement.
-
-
-@node Guitar
-@section Guitar
-
-@cindex tablature
-@cindex guitar tablature
-
-@menu
-* String number indications::   
-* Tablatures basic::            
-* Non-guitar tablatures::       
-* Banjo tablatures::            
-* Fret diagrams::               
-* Right hand fingerings::       
-* Other guitar issues::         
-@end menu
-
-@node String number indications
-@subsection String number indications
-
-@cindex String numbers
-
-String numbers can be added to chords, by indicating the string number
-with @code{\}@var{number},
-
-@lilypond[relative,relative=1,ragged-right,fragment]
-<c\1 e\2 g\3>
-@end lilypond
-
-
-@seealso
-
-Program reference: @internalsref{StringNumber},
-@lsr{guitar/,string-number.ly}.
-
-
-@node Tablatures basic
-@subsection Tablatures basic
-@cindex Tablatures basic
-
-Tablature notation is used for notating music for plucked string
-instruments.  Pitches are not denoted with note heads, but by
-numbers indicating on which string and fret a note must be played.  LilyPond
-offers limited support for tablature.
-
-The string number associated to a note is given as a backslash
-followed by a number, e.g., @code{c4\3} for a C quarter on the third
-string.  By default, string 1 is the highest one, and the tuning
-defaults to the standard guitar tuning (with 6 strings).  The notes
-are printed as tablature, by using @internalsref{TabStaff} and
-@internalsref{TabVoice} contexts
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  a,4\5 c'\2 a\3 e'\1
-  e\4 c'\2 a\3 e'\1
-}
-@end lilypond
-
-@funindex minimumFret
-@cindex fret
-
-When no string is specified, the first string that does not give a
-fret number less than @code{minimumFret} is selected.  The default
-value for @code{minimumFret} is 0
-
-
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
-  \key e \major
-  e16 fis gis a b4
-  \set TabStaff.minimumFret = #8
-  e16 fis gis a b4
-}
-  \new StaffGroup <<
-    \new Staff { \clef "G_8" \frag }
-    \new TabStaff { \frag }
-  >>
-@end lilypond
-
-
-@commonprop
-
-To print tablatures with stems down and horizontal beams,
-initialize the @code{TabStaff} with this code:
-
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
-
-@seealso
-
-Program reference: @internalsref{TabStaff}, @internalsref{TabVoice}.
-
-@refbugs
-
-Chords are not handled in a special way, and hence the automatic
-string selector may easily select the same string to two notes in a
-chord.
-
-In order to handle @code{\partcombine}, a @code{TabStaff} must use
-specially-created voices:
-
-@lilypond[quote,ragged-right,verbatim]
-melodia = \partcombine { e4 g g g }{ e4 e e e }
-<<
-  \new TabStaff <<
-    \new TabVoice = "one" s1
-    \new TabVoice = "two" s1
-    \new TabVoice = "shared" s1
-    \new TabVoice = "solo" s1
-    { \melodia }
-  >>
->>
-@end lilypond
-
-
-@node Non-guitar tablatures
-@subsection Non-guitar tablatures
-@cindex Non-guitar tablatures
-
-You can change the tuning of the strings.  A string tuning is given as
-a Scheme list with one integer number for each string, the number
-being the pitch (measured in semitones relative to middle C) of an
-open string.  The numbers specified for @code{stringTunings} are the
-numbers of semitones to subtract or add, starting the specified pitch
-by default middle C, in string order.  LilyPond automatically calculates
-the number of strings by looking at @code{stringTunings}.
-
-In the next example,
-@code{stringTunings} is set for the pitches e, a, d, and g
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
->>
-@end lilypond
-
-LilyPond comes with predefined string tunings for banjo, mandolin, guitar
-and bass guitar.
-
-@example
-\set TabStaff.stringTunings = #bass-tuning
-@end example
-
-The default string tuning is @code{guitar-tuning} (the standard EADGBE
-tuning).
-Some other predefined tunings are @code{guitar-open-g-tuning},
-@code{mandolin-tuning} and @code{banjo-open-g-tuning}.
-
-@seealso
-
-The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
-tunings.
-Program reference: @internalsref{Tab_note_heads_engraver}.
-
-@refbugs
-
-No guitar special effects have been implemented.
-
-
-
-@node Banjo tablatures
-@subsection Banjo tablatures
-@cindex Banjo tablatures
-
-LilyPond has basic support for five stringed banjo.  When making tablatures
-for five stringed banjo, use the banjo tablature format function to get
-correct
-fret numbers for the fifth string:
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
-  \set TabStaff.stringTunings = #banjo-open-g-tuning
-  {
-    \stemDown
-    g8 d' g'\5 a b g e d' |
-    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
-    g4
-  }
->>
-@end lilypond
-
-A number of common tunings for banjo are predefined in LilyPond:
-@code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
-@code{banjo-open-d-tuning} (aDF#AD) and @code{banjo-open-dm-tuning}
-(aDFAD).
-
-These tunings may be converted to four string banjo tunings using the
-@code{four-string-banjo} function:
-
-@example
-\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
-@end example
-
-@seealso
-
-The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
-
-
-@node Fret diagrams
-@subsection Fret diagrams
-@cindex fret diagrams
-@cindex chord diagrams
-
-Fret diagrams can be added to music as a markup to the desired note.  The
-markup contains information about the desired fret diagram, as shown in the
-following example
-
-@lilypond[verbatim, ragged-right, quote]
-\new Voice {
-  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
-  d' d' d'
-  fis'^\markup \override #'(size . 0.75) {
-    \override #'(finger-code . below-string) {
-      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
-                               (place-fret 5 4 3) (place-fret 4 4 4)
-                               (place-fret 3 3 2) (place-fret 2 2 1)
-                               (place-fret 1 2 1))
-    }
-  }
-  fis' fis' fis'
-  c'^\markup \override #'(dot-radius . 0.35) {
-    \override #'(finger-code . in-dot) {
-      \override #'(dot-color . white) {
-        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
-      }
-    }
-  }
-  c' c' c'
-}
-@end lilypond
-
-
-There are three different fret-diagram markup interfaces: standard, terse,
-and verbose.  The three interfaces produce equivalent markups, but have
-varying amounts of information in the markup string.  Details about the
-markup interfaces are found at @ref{Overview of text markup commands}.
-
-You can set a number of graphical properties according to your preference.
-Details about the property interface to fret diagrams are found at
-@internalsref{fret-diagram-interface}.
-
-
-@seealso
-
-Examples: @lsrdir{guitar}
-
-
-@node Right hand fingerings
-@subsection Right hand fingerings
-
-Right hand fingerings in chords can be entered using
-@code{@var{note}-\rightHandFinger @var{finger}}
-
-@lilypond[verbatim,fragment,relative=2]
-  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
-@end lilypond
-
-for brevity, you can abbreviate @code{\rightHandFinger} to something
-short, for example @code{RH},
-
-@example
-#(define RH rightHandFinger)
-@end example
-
-@cindex fingerings, right hand, for guitar 
-@cindex right hand fingerings for guitar
- 
-@commonprop
-
-You may exercise greater control over right handing fingerings by
-setting @code{strokeFingerOrientations},
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(up down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-  \set strokeFingerOrientations = #'(up right down)
-  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
-}
-@end lilypond
-
-The letters used for the fingerings are contained in the property
-@code{digit-names}, but they can also be set individually by supplying
-@code{\rightHandFinger} with a string argument, as in the following example
-
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-#(define RH rightHandFinger)
-{
-  \set strokeFingerOrientations = #'(right)
-  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
-  <c-\RH #5 >4
-  <c-\RH "@">4  
-}
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{StrokeFinger}
-
-
-
-@node Other guitar issues
-@subsection Other guitar issues
-
-This example demonstrates how to include guitar position and
-barring indications.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
-\clef "G_8"
-b16 d16 g16 b16 e16
-\textSpannerDown
-\override TextSpanner #'bound-details #'left #'text = #"XII "
-  g16\startTextSpan
-  b16 e16 g16 e16 b16 g16\stopTextSpan
-e16 b16 g16 d16
-@end lilypond
-
-
-Stopped (X) note heads are used in guitar music to signal a place where the
-guitarist must play a certain note or chord, with its fingers just
-touching the strings instead of fully pressing them.  This gives the sound a
-percussive noise-like sound that still maintains part of the original
-pitch.  It is notated with cross noteheads; this is
-demonstrated in @ref{Special noteheads}.
-
-
-@node Bagpipe
-@section Bagpipe
-
-@cindex Bagpipe
-
-@menu
-* Bagpipe definitions::         
-* Bagpipe example::             
-@end menu
-
-
-@node Bagpipe definitions
-@subsection Bagpipe definitions
-
-LilyPond contains special definitions for music for the Scottish
-highland bagpipe; to use them, add
-
-@example
-\include "bagpipe.ly"
-@end example
-
-@noindent
-at the top of your input file.  This lets you add the special gracenotes
-common to bagpipe music with short commands.  For example, you could
-write @code{\taor} instead of
-
-@example
-\grace @{ \small G32[ d G e] @}
-@end example
-
-@code{bagpipe.ly} also contains pitch definitions for the bagpipe
-notes in the appropriate octaves, so you do not need to worry about
-@code{\relative} or @code{\transpose}.
-
-@lilypond[ragged-right,verbatim,quote,notime]
-\include "bagpipe.ly"
-{ \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
-@end lilypond
-
-Bagpipe music nominally uses the key of D Major (even though that
-isn't really true). However, since that is the only key that can be used,
-the key signature is normally not written out. To set this up correctly,
-always start your music with @code{\hideKeySignature}. If you for some
-reason want to show the key signature, you can use @code{\showKeySignature}
-instead.
-
-Some modern music use cross fingering on c and f to flatten those notes.
-This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
-piobaireachd high g can be written @code{gflat} when it occurs in light
-music.
-
-
-@node Bagpipe example
-@subsection Bagpipe example
-
-This is what the well known tune Amazing Grace looks like in bagpipe
-notation.
-
-@lilypond[verbatim,quote]
-\include "bagpipe.ly"
-\layout {
-  indent = 0.0\cm
-  \context { \Score \remove "Bar_number_engraver" }
-}
-
-\header {
-  title = "Amazing Grace"
-  meter = "Hymn"
-  arranger = "Trad. arr."
-}
-
-{
-  \hideKeySignature
-  \time 3/4
-  \grg \partial 4 a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 \grg e8. f16
-  \dblA A2 \grg A4
-  \grg A2 f8. A16
-  \grg A2 \hdblf f8[ e32 d16.]
-  \grg f2 \grg f8 e
-  \thrwd d2 \grg b4
-  \grG a2 \grg a8. d16
-  \slurd d2 \grg f8[ e32 d16.]
-  \grg f2 e4
-  \thrwd d2.
-  \slurd d2
-  \bar "|."
-}
-@end lilypond
-
-
-@node Ancient notation
-@section Ancient notation
-
-@cindex Vaticana, Editio
-@cindex Medicaea, Editio
-@cindex hufnagel
-@cindex Petrucci
-@cindex mensural
-
-Support for ancient notation includes features for mensural notation
-and Gregorian Chant notation.  There is also limited support for
-figured bass notation.
-
-Many graphical objects provide a @code{style} property, see
-@itemize @bullet
-@item
-@ref{Ancient note heads},
-@item
-@ref{Ancient accidentals},
-@item
-@ref{Ancient rests},
-@item
-@ref{Ancient clefs},
-@item
-@ref{Ancient flags},
-@item
-@ref{Ancient time signatures}.
-@end itemize
-
-By manipulating such a grob property, the typographical appearance of
-the affected graphical objects can be accommodated for a specific
-notation flavor without the need for introducing any new notational
-concept.
-
-In addition to the standard articulation signs described in section
-@ref{Articulations}, specific articulation signs for ancient notation
-are provided.
-
-@itemize @bullet
-@item
-@ref{Ancient articulations}
-@end itemize
-
-Other aspects of ancient notation can not that easily be expressed
-in terms of just changing a style property of a graphical object or
-adding articulation signs.  Some notational concepts are introduced
-specifically for ancient notation,
-
-@itemize @bullet
-@item
-@ref{Custodes},
-@item
-@ref{Divisiones},
-@item
-@ref{Ligatures}.
-@end itemize
-
-If this all is too much of documentation for you, and you just want to
-dive into typesetting without worrying too much about the details on
-how to customize a context, you may have a look at the predefined
-contexts.  Use them to set up predefined style-specific voice and
-staff contexts, and directly go ahead with the note entry,
-
-@itemize @bullet
-@item
-@ref{Gregorian Chant contexts},
-@item
-@ref{Mensural contexts}.
-@end itemize
-
-There is limited support for figured bass notation which came
-up during the baroque period.
-
-@itemize @bullet
-@item
-@ref{Figured bass}
-@end itemize
-
-Here are all subtopics at a glance:
-
-@menu
-* Ancient note heads::          
-* Ancient accidentals::         
-* Ancient rests::               
-* Ancient clefs::               
-* Ancient flags::               
-* Ancient time signatures::     
-* Ancient articulations::       
-* Custodes::                    
-* Divisiones::                  
-* Ligatures::                   
-* Gregorian Chant contexts::    
-* Mensural contexts::           
-* Musica ficta accidentals::    
-* Figured bass::                
-@end menu
-
-
-
-@node Ancient note heads
-@subsection Ancient note heads
-
-@cindex note heads, ancient
-
-For ancient notation, a note head style other than the @code{default}
-style may be chosen.  This is accomplished by setting the @code{style}
-property of the @internalsref{NoteHead} object to @code{baroque},
-@code{neomensural}, @code{mensural} or @code{petrucci}.  The
-@code{baroque} style differs from the @code{default} style only in
-using a square shape for @code{\breve} note heads.  The
-@code{neomensural} style differs from the @code{baroque} style in that
-it uses rhomboidal heads for whole notes and all smaller durations.
-Stems are centered on the note heads.  This style is particularly
-useful when transcribing mensural music, e.g., for the incipit.  The
-@code{mensural} style produces note heads that mimic the look of note
-heads in historic printings of the 16th century.  Finally, the
-@code{petrucci} style also mimicks historic printings, but uses bigger
-note heads.
-
-The following example demonstrates the @code{neomensural} style
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override NoteHead #'style = #'neomensural
-a'\longa a'\breve a'1 a'2 a'4 a'8 a'16
-@end lilypond
-
-When typesetting a piece in Gregorian Chant notation, the
-@internalsref{Gregorian_ligature_engraver} will automatically select
-the proper note heads, so there is no need to explicitly set the
-note head style.  Still, the note head style can be set, e.g., to
-@code{vaticana_punctum} to produce punctum neumes.  Similarly, a
-@internalsref{Mensural_ligature_engraver} is used to automatically
-assemble mensural ligatures.  See @ref{Ligatures}, for how ligature
-engravers work.
-
-@seealso
-
-@ref{Note head styles}, gives an overview over all available note head styles.
-
-
-@node Ancient accidentals
-@subsection Ancient accidentals
-
-@cindex accidentals
-
-
-Use the @code{glyph-name-alist} property of grob
-@internalsref{Accidental} and @internalsref{KeySignature} to select
-ancient accidentals. 
-
-@lilypond[quote,ragged-right,staffsize=26]
-\score {
-{
-  \fatText
-  s^\markup {
-    \column {
-      "vaticana"
-      \line { " " \musicglyph #"accidentals.vaticana-1"
-        " " \musicglyph #"accidentals.vaticana0" }
-    }
-    \column {
-      "medicaea"
-      \line { " " \musicglyph #"accidentals.medicaea-1" }
-    }
-    \column {
-      "hufnagel"
-      \line { " " \musicglyph #"accidentals.hufnagel-1" }
-    }
-    \column {
-      "mensural"
-      \line { " " \musicglyph #"accidentals.mensural-1"
-        " " \musicglyph #"accidentals.mensural1" }
-    }
-  }
-}
-\layout {
-  interscoreline = 1
-  \context { \Score \remove "Bar_number_engraver" }
-  \context { \Staff
-      \remove "Clef_engraver"
-      \remove "Key_engraver"
-      \remove "Time_signature_engraver"
-      \remove "Staff_symbol_engraver"
-      \override VerticalAxisGroup #'minimum-Y-extent = ##f
-    }
-  }
-}
-@end lilypond
-
-As shown, not all accidentals are supported by each style.  When
-trying to access an unsupported accidental, LilyPond will switch to a
-different style, as demonstrated in
-@lsr{ancient,ancient-accidentals.ly}.
-
-Similarly to local accidentals, the style of the key signature can be
-controlled by the @code{glyph-name-alist} property of the
-@internalsref{KeySignature} grob.
-
-@seealso
-
-In this manual: @ref{Pitches}, @ref{Cautionary accidentals}, and
-@ref{Automatic accidentals}, give a general introduction of the use of
-accidentals.  @ref{Key signature}, gives a general introduction of
-the use of key signatures.
-
-Program reference: @internalsref{KeySignature}.
-
-Examples: @lsrdir{ancient}
-
-@node Ancient rests
-@subsection Ancient rests
-
-@cindex rests, ancient
-
-
-Use the @code{style} property of grob @internalsref{Rest} to select
-ancient rests.   Supported styles are @code{classical},
-@code{neomensural}, and @code{mensural}.  @code{classical} differs
-from the @code{default} style only in that the quarter rest looks like
-a horizontally mirrored 8th rest.  The @code{neomensural} style suits
-well for, e.g., the incipit of a transcribed mensural piece of music.
-The @code{mensural} style finally mimics the appearance of rests as
-in historic prints of the 16th century.
-
-The following example demonstrates the @code{neomensural} style
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\set Score.skipBars = ##t
-\override Rest #'style = #'neomensural
-r\longa r\breve r1 r2 r4 r8 r16
-@end lilypond
-
-There are no 32th and 64th rests specifically for the mensural or
-neo-mensural style.  Instead, the rests from the default style will be
-taken.  See @lsr{pitches,rests} for a chart of all rests.
-
-There are no rests in Gregorian Chant notation; instead, it uses
-@ref{Divisiones}.
-
-@seealso
-
-In this manual: @ref{Rests}, gives a general introduction into the use of
-rests.
-
-
-@node Ancient clefs
-@subsection Ancient clefs
-
-@cindex clefs
-
-
-LilyPond supports a variety of clefs, many of them ancient.
-
-The following table shows all ancient clefs that are supported via the
-@code{\clef} command.  Some of the clefs use the same glyph, but
-differ only with respect to the line they are printed on.  In such
-cases, a trailing number in the name is used to enumerate these clefs.
-Still, you can manually force a clef glyph to be typeset on an
-arbitrary line, as described in @ref{Clef}.  The note printed to the
-right side of each clef in the example column denotes the @code{c'}
-with respect to that clef.
-
-@multitable @columnfractions .4 .4 .2
-@item
-@b{Description}
-@tab
-@b{Supported Clefs}
-@tab
-@b{Example}
-
-@item
-modern style mensural C clef
-@tab
-@code{neomensural-c1}, @code{neomensural-c2},@*
-@code{neomensural-c3}, @code{neomensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "neomensural-c2" c
-@end lilypond
-
-@item
-petrucci style mensural C clefs, for use on different staff lines
-(the examples show the 2nd staff line C clef)
-@tab
-@code{petrucci-c1}, @code{petrucci-c2},@*
-@code{petrucci-c3}, @code{petrucci-c4},@*
-@code{petrucci-c5}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-petrucci style mensural F clef
-@tab
-@code{petrucci-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-petrucci style mensural G clef
-@tab
-@code{petrucci-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "petrucci-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-historic style mensural C clef
-@tab
-@code{mensural-c1}, @code{mensural-c2},@*
-@code{mensural-c3}, @code{mensural-c4}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-c2"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-historic style mensural F clef
-@tab
-@code{mensural-f}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-f"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-historic style mensural G clef
-@tab
-@code{mensural-g}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \clef "mensural-g"
-  \override NoteHead #'style = #'mensural
-  c
-@end lilypond
-
-@item
-Editio Vaticana style do clef
-@tab
-@code{vaticana-do1}, @code{vaticana-do2},@*
-@code{vaticana-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-do2"
-  c
-@end lilypond
-
-@item
-Editio Vaticana style fa clef
-@tab
-@code{vaticana-fa1}, @code{vaticana-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'vaticana.punctum
-  \clef "vaticana-fa2"
-  c
-@end lilypond
-
-@item
-Editio Medicaea style do clef
-@tab
-@code{medicaea-do1}, @code{medicaea-do2},@*
-@code{medicaea-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-do2"
-  c
-@end lilypond
-
-@item
-Editio Medicaea style fa clef
-@tab
-@code{medicaea-fa1}, @code{medicaea-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'medicaea.punctum
-  \clef "medicaea-fa2"
-  c
-@end lilypond
-
-@item
-historic style hufnagel do clef
-@tab
-@code{hufnagel-do1}, @code{hufnagel-do2},@*
-@code{hufnagel-do3}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do2"
-  c
-@end lilypond
-
-@item
-historic style hufnagel fa clef
-@tab
-@code{hufnagel-fa1}, @code{hufnagel-fa2}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'line-count = #4
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-fa2"
-  c
-@end lilypond
-
-@item
-historic style hufnagel combined do/fa clef
-@tab
-@code{hufnagel-do-fa}
-@tab
-@lilypond[fragment,relative=1,notime]
-  \override Staff.StaffSymbol #'color = #red
-  \override Staff.LedgerLineSpanner #'color = #red
-  \override Voice.Stem #'transparent = ##t
-  \override NoteHead #'style = #'hufnagel.punctum
-  \clef "hufnagel-do-fa"
-  c
-@end lilypond
-@end multitable
-
-
-
-@emph{Modern style} means @qq{as is typeset in contemporary editions of
-transcribed mensural music.}
-
-@emph{Petrucci style} means @qq{inspired by printings published by the
-famous engraver Petrucci (1466-1539).}
-
-@emph{Historic style} means @qq{as was typeset or written in historic
-editions (other than those of Petrucci).}
-
-@emph{Editio XXX style} means @qq{as is/was printed in Editio XXX.}
-
-Petrucci used C clefs with differently balanced left-side vertical
-beams, depending on which staff line it is printed.
-
-@seealso
-
-In this manual: see @ref{Clef}.
-
-@refbugs
-
-The mensural g clef is mapped to the Petrucci g clef.
-
-
-
-@node Ancient flags
-@subsection Ancient flags
-
-@cindex flags
-
-
-Use the @code{flag-style} property of grob @internalsref{Stem} to
-select ancient flags.  Besides the @code{default} flag style,
-only the @code{mensural} style is supported
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\override Stem #'flag-style = #'mensural
-\override Stem #'thickness = #1.0
-\override NoteHead #'style = #'mensural
-\autoBeamOff
-c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
-c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
-@end lilypond
-
-Note that the innermost flare of each mensural flag always is
-vertically aligned with a staff line.
-
-There is no particular flag style for neo-mensural notation.  Hence,
-when typesetting the incipit of a transcribed piece of mensural
-music, the default flag style should be used.  There are no flags in
-Gregorian Chant notation.
-
-@refbugs
-
-The attachment of ancient flags to stems is slightly off due to a
-change in early 2.3.x.
-
-Vertically aligning each flag with a staff line assumes that stems
-always end either exactly on or exactly in the middle between two
-staff lines.  This may not always be true when using advanced layout
-features of classical notation (which however are typically out of
-scope for mensural notation).
-
-@node Ancient time signatures
-@subsection Ancient time signatures
-
-@cindex time signatures
-
-
-There is limited support for mensural time signatures.   The
-glyphs are hard-wired to particular time fractions.  In other words,
-to get a particular mensural signature glyph with the @code{\time n/m}
-command, @code{n} and @code{m} have to be chosen according to the
-following table
-
-@lilypond[quote,ragged-right]
-\layout {
-  indent = 0.0
-  \context {
-    \Staff
-    \remove Staff_symbol_engraver
-    \remove Clef_engraver
-    \remove Time_signature_engraver
-  }
-}
-{
-  \set Score.timing = ##f
-  \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural44" }
-  s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural22" }
-  s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural64" }
-  s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural68" }
-  \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
-#"timesig.neomensural32" }
-  s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural34" }
-  s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural94" }
-  s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural98" }
-  \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
-#"timesig.neomensural48" }
-  s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
-#"timesig.neomensural24" }
-}
-@end lilypond
-
-Use the @code{style} property of grob @internalsref{TimeSignature} to
-select ancient time signatures.  Supported styles are
-@code{neomensural} and @code{mensural}.  The above table uses the
-@code{neomensural} style.  This style is appropriate for the
-incipit of transcriptions of mensural pieces.  The @code{mensural}
-style mimics the look of historical printings of the 16th century.
-
-The following examples show the differences in style,
-
-@lilypond[ragged-right,fragment,relative=1,quote]
-{
-  \fatText
-
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter default }
-
-  \override Staff.TimeSignature #'style = #'numbered
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter numbered }
-
-  \override Staff.TimeSignature #'style = #'mensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter mensural }
-
-  \override Staff.TimeSignature #'style = #'neomensural
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter neomensural }
-  \override Staff.TimeSignature #'style = #'single-digit
-  \time 2/2
-  c1^\markup { \hspace #-2.0 \typewriter single-digit }
-}
-@end lilypond
-
-@seealso
-
-This manual: @ref{Time signature}, gives a general introduction to
-the use of time signatures.
-
-@refbugs
-
-Ratios of note durations do not change with the time signature.  For
-example, the ratio of 1 brevis = 3 semibrevis (tempus perfectum) must
-be made by hand, by setting
-
-@example
-breveTP = #(ly:make-duration -1 0 3 2)
-@dots{}
-@{ c\breveTP f1 @}
-@end example
-
-@noindent
-This sets @code{breveTP} to 3/2 times 2 = 3 times a whole note.
-
-The @code{old6/8alt} symbol (an alternate symbol for 6/8) is not
-addressable with @code{\time}.  Use a @code{\markup} instead
-
-@node Ancient articulations
-@subsection Ancient articulations
-
-@cindex articulations
-
-In addition to the standard articulation signs described in section
-@ref{Articulations}, articulation signs for ancient notation are
-provided.  These are specifically designed for use with notation in
-Editio Vaticana style.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \override TextScript #'font-family = #'typewriter
-    \override TextScript #'font-shape = #'upright
-    \override Script #'padding = #-0.1
-    a\ictus_"ictus" \break
-    a\circulus_"circulus" \break
-    a\semicirculus_"semicirculus" \break
-    a\accentus_"accentus" \break
-    \[ a_"episem" \episemInitium \pes b \flexa a b \episemFinis \flexa a \]
-  }
-}
-@end lilypond
-
-@refbugs
-
-Some articulations are vertically placed too closely to the
-corresponding note heads.
-
-The episem line is not displayed in many cases.  If it is displayed,
-the right end of the episem line is often too far to the right.
-
-@node Custodes
-@subsection Custodes
-
-@cindex custos
-@cindex custodes
-
-A @emph{custos} (plural: @emph{custodes}; Latin word for @q{guard}) is a
-symbol that appears at the end of a staff.  It anticipates the pitch
-of the first note(s) of the following line thus helping the performer
-to manage line breaks during performance.
-
-Custodes were frequently used in music notation until the 17th
-century.  Nowadays, they have survived only in a few particular forms
-of musical notation such as contemporary editions of Gregorian chant
-like the @emph{editio vaticana}.  There are different custos glyphs
-used in different flavors of notational style.
-
-For typesetting custodes, just put a @internalsref{Custos_engraver} into the
-@internalsref{Staff} context when declaring the @code{\layout} block,
-as shown in the following example
-
-@example
-\layout @{
-  \context @{
-    \Staff
-    \consists Custos_engraver
-    Custos \override #'style = #'mensural
-  @}
-@}
-@end example
-
-The result looks like this
-
-@lilypond[quote,ragged-right]
-\score {
-{
-  a'1
-  \override Staff.Custos #'style = #'mensural
-  \break
-  g'
-}
-\layout {
-  \context { \Staff \consists Custos_engraver }
-  }
-}
-@end lilypond
-
-The custos glyph is selected by the @code{style} property.  The styles
-supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
-@code{mensural}.  They are demonstrated in the following fragment
-
-@lilypond[quote,ragged-right,fragment]
-\new Lyrics \lyricmode {
-  \markup { \column {
-    \typewriter "vaticana"
-    \line { " " \musicglyph #"custodes.vaticana.u0" }
-  } }
-  \markup { \column {
-    \typewriter "medicaea"
-    \line { " " \musicglyph #"custodes.medicaea.u0" }
-  }}
-  \markup { \column {
-    \typewriter "hufnagel"
-    \line { " " \musicglyph #"custodes.hufnagel.u0" }
-  }}
-  \markup { \column {
-    \typewriter "mensural"
-    \line { " " \musicglyph #"custodes.mensural.u0" }
-  }}
-}
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{Custos}.
-
-Examples:
-@lsr{ancient,custodes@/.ly}.
-
-
-@node Divisiones
-@subsection Divisiones
-
-@cindex divisio
-@cindex divisiones
-@cindex finalis
-
-A @emph{divisio} (plural: @emph{divisiones}; Latin word for
-@q{division}) is a staff context symbol that is used to structure
-Gregorian music into phrases and sections.  The musical meaning of
-@emph{divisio minima}, @emph{divisio maior}, and @emph{divisio maxima}
-can be characterized as short, medium, and long pause, somewhat like
-the breathmarks from @ref{Breath marks}.  The @emph{finalis} sign not
-only marks the end of a chant, but is also frequently used within a
-single antiphonal/responsorial chant to mark the end of each section.
-
-
-To use divisiones, include the file @file{gregorian@/-init@/.ly}.  It
-contains definitions that you can apply by just inserting
-@code{\divisioMinima}, @code{\divisioMaior}, @code{\divisioMaxima},
-and @code{\finalis} at proper places in the input.  Some editions use
-@emph{virgula} or @emph{caesura} instead of divisio minima.
-Therefore, @file{gregorian@/-init@/.ly} also defines @code{\virgula} and
-@code{\caesura}
-
-@lilypondfile[quote,ragged-right]{divisiones.ly}
-
-@refcommands
-
-@funindex \virgula
-@code{\virgula},
-@funindex \caesura
-@code{\caesura},
-@funindex \divisioMinima
-@code{\divisioMinima},
-@funindex \divisioMaior
-@code{\divisioMaior},
-@funindex \divisioMaxima
-@code{\divisioMaxima},
-@funindex \finalis
-@code{\finalis}.
-
-@seealso
-
-In this manual: @ref{Breath marks}.
-
-Program reference: @internalsref{BreathingSign}.
-
-Examples: @lsr{expressive,breathing-sign.ly}.
-
-
-@node Ligatures
-@subsection Ligatures
-
-@cindex Ligatures
-
-@c TODO: Should double check if I recalled things correctly when I wrote
-@c down the following paragraph by heart.
-
-A ligature is a graphical symbol that represents at least two distinct
-notes.  Ligatures originally appeared in the manuscripts of Gregorian
-chant notation to denote ascending or descending sequences of notes.
-
-Ligatures are entered by enclosing them in @code{\[} and @code{\]}.
-Some ligature styles may need additional input syntax specific for
-this particular type of ligature.  By default, the
-@internalsref{LigatureBracket} engraver just puts a square bracket
-above the ligature
-
-@lilypond[quote,ragged-right,verbatim]
-\transpose c c' {
-  \[ g c a f d' \]
-  a g f
-  \[ e f a g \]
-}
-@end lilypond
-
-To select a specific style of ligatures, a proper ligature engraver
-has to be added to the @internalsref{Voice} context, as explained in
-the following subsections.   Only white mensural ligatures
-are supported with certain limitations.
-
-
-
-@refbugs
-
-Ligatures need special spacing that has not yet been implemented.  As
-a result, there is too much space between ligatures most of the time,
-and line breaking often is unsatisfactory.  Also, lyrics do not
-correctly align with ligatures.
-
-Accidentals must not be printed within a ligature, but instead need to
-be collected and printed in front of it.
-
-The syntax still uses the deprecated infix style @code{\[ music expr
-\]}.  For consistency reasons, it will eventually be changed to
-postfix style @code{note\[ ... note\]}.  Alternatively, the file
-@file{gregorian@/-init@/.ly} can be included; it provides a scheme
-function
-@example
-\ligature @var{music expr}
-@end example
-with the same effect and is believed to be stable.
-
-@menu
-* White mensural ligatures::    
-* Gregorian square neumes ligatures::  
-@end menu
-
-@node White mensural ligatures
-@subsubsection White mensural ligatures
-
-@cindex Mensural ligatures
-@cindex White mensural ligatures
-
-There is limited support for white mensural ligatures.
-
-To engrave white mensural ligatures, in the layout block put the
-@internalsref{Mensural_ligature_engraver} into the
-@internalsref{Voice} context, and remove the
-@internalsref{Ligature_bracket_engraver}, like this
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \remove Ligature_bracket_engraver
-    \consists Mensural_ligature_engraver
-  @}
-@}
-@end example
-
-There is no additional input language to describe the shape of a
-white mensural ligature.  The shape is rather determined solely from
-the pitch and duration of the enclosed notes.  While this approach may
-take a new user a while to get accustomed to, it has the great advantage
-that the full musical information of the ligature is known internally.
-This is not only required for correct MIDI output, but also allows for
-automatic transcription of the ligatures.
-
-For example,
-
-@example
-\set Score.timing = ##f
-\set Score.defaultBarType = "empty"
-\override NoteHead #'style = #'neomensural
-\override Staff.TimeSignature #'style = #'neomensural
-\clef "petrucci-g"
-\[ c'\maxima g \]
-\[ d\longa c\breve f e d \]
-\[ c'\maxima d'\longa \]
-\[ e'1 a g\breve \]
-@end example
-@lilypond[quote,ragged-right]
-\score {
-  \transpose c c' {
-    \set Score.timing = ##f
-    \set Score.defaultBarType = "empty"
-    \override NoteHead #'style = #'neomensural
-    \override Staff.TimeSignature #'style = #'neomensural
-    \clef "petrucci-g"
-    \[ c'\maxima g \]
-    \[ d\longa c\breve f e d \]
-    \[ c'\maxima d'\longa \]
-    \[ e'1 a g\breve \]
-  }
-  \layout {
-    \context {
-      \Voice
-      \remove Ligature_bracket_engraver
-      \consists Mensural_ligature_engraver
-    }
-  }
-}
-@end lilypond
-
-Without replacing @internalsref{Ligature_bracket_engraver} with
-@internalsref{Mensural_ligature_engraver}, the same music transcribes
-to the following
-
-@lilypond[quote,ragged-right]
-\transpose c c' {
-  \set Score.timing = ##f
-  \set Score.defaultBarType = "empty"
-  \override NoteHead #'style = #'neomensural
-  \override Staff.TimeSignature #'style = #'neomensural
-  \clef "petrucci-g"
-  \[ c'\maxima g \]
-  \[ d\longa c\breve f e d \]
-  \[ c'\maxima d'\longa \]
-  \[ e'1 a g\breve \]
-}
-@end lilypond
-
-@refbugs
-
-Horizontal spacing is poor.
-
-@node Gregorian square neumes ligatures
-@subsubsection Gregorian square neumes ligatures
-
-@cindex Square neumes ligatures
-@cindex Gregorian square neumes ligatures
-
-There is limited support for Gregorian square neumes notation
-(following the style of the Editio Vaticana).  Core ligatures can
-already be typeset, but essential issues for serious typesetting are
-still lacking, such as (among others) horizontal alignment of multiple
-ligatures, lyrics alignment and proper handling of accidentals.
-
-
-The following table contains the extended neumes table of the 2nd
-volume of the Antiphonale Romanum (@emph{Liber Hymnarius}), published
-1983 by the monks of Solesmes.
-
-@multitable @columnfractions .4 .2 .2 .2
-
-@item
-@b{Neuma aut@*
-Neumarum Elementa}
-@tab
-@b{Figurae@*
-Rectae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Auctae}
-@tab
-@b{Figurae@*
-Liquescentes@*
-Deminutae}
-
-@c TODO: \layout block is identical in all of the below examples.
-@c Therefore, it should somehow be included rather than duplicated all
-@c the time. --jr
-
-@c why not make identifiers in ly/engraver-init.ly? --hwn
-
-@c Because it's just used to typeset plain notes without
-@c a staff for demonstration purposes rather than something
-@c special of Gregorian chant notation. --jr
-
-@item
-@code{1. Punctum}
-@tab
-@lilypond[staffsize=26,line-width=1.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum
-    \[ b \]
-    \noBreak s^\markup {"a"} \noBreak
-
-    % Punctum Inclinatum
-    \[ \inclinatum b \]
-    \noBreak s^\markup {"b"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.5\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Auctum Ascendens
-    \[ \auctum \ascendens b \]
-    \noBreak s^\markup {"c"} \noBreak
-
-    % Punctum Auctum Descendens
-    \[ \auctum \descendens b \]
-    \noBreak s^\markup {"d"} \noBreak
-
-    % Punctum Inclinatum Auctum
-    \[ \inclinatum \auctum b \]
-    \noBreak s^\markup {"e"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Punctum Inclinatum Parvum
-    \[ \inclinatum \deminutum b \]
-    \noBreak s^\markup {"f"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{2. Virga}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Virga
-    \[ \virga b \]
-    \noBreak s^\markup {"g"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{3. Apostropha vel Stropha}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha
-    \[ \stropha b \]
-    \noBreak s^\markup {"h"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Stropha Aucta
-    \[ \stropha \auctum b \]
-    \noBreak s^\markup {"i"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{4. Oriscus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Oriscus
-    \[ \oriscus b \]
-    \noBreak s^\markup {"j"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@tab
-
-@item
-@code{5. Clivis vel Flexa}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis vel Flexa
-    \[ b \flexa g \]
-    s^\markup {"k"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Clivis Aucta Descendens
-    \[ b \flexa \auctum \descendens g \]
-    \noBreak s^\markup {"l"} \noBreak
-
-    % Clivis Aucta Ascendens
-    \[ b \flexa \auctum \ascendens g \]
-    \noBreak s^\markup {"m"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Cephalicus
-    \[ b \flexa \deminutum g \]
-    s^\markup {"n"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{6. Podatus vel Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Podatus vel Pes
-    \[ g \pes b \]
-    s^\markup {"o"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=2.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens
-    \[ g \pes \auctum \descendens b \]
-    \noBreak s^\markup {"p"} \noBreak
-
-    % Pes Auctus Ascendens
-    \[ g \pes \auctum \ascendens b \]
-    \noBreak s^\markup {"q"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Epiphonus
-    \[ g \pes \deminutum b \]
-    s^\markup {"r"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{7. Pes Quassus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus
-    \[ \oriscus g \pes \virga b \]
-    s^\markup {"s"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Quassus Auctus Descendens
-    \[ \oriscus g \pes \auctum \descendens b \]
-    s^\markup {"t"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{8. Quilisma Pes}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes
-    \[ \quilisma g \pes b \]
-    s^\markup {"u"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Quilisma Pes Auctus Descendens
-    \[ \quilisma g \pes \auctum \descendens b \]
-    s^\markup {"v"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{9. Podatus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Initio Debilis
-    \[ \deminutum g \pes b \]
-    s^\markup {"w"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Pes Auctus Descendens Initio Debilis
-    \[ \deminutum g \pes \auctum \descendens b \]
-    s^\markup {"x"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{10. Torculus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus
-    \[ a \pes b \flexa g \]
-    s^\markup {"y"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens
-    \[ a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"z"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus
-    \[ a \pes b \flexa \deminutum g \]
-    s^\markup {"A"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{11. Torculus Initio Debilis}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Initio Debilis
-    \[ \deminutum a \pes b \flexa g \]
-    s^\markup {"B"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Auctus Descendens Initio Debilis
-    \[ \deminutum a \pes b \flexa \auctum \descendens g \]
-    s^\markup {"C"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Torculus Deminutus Initio Debilis
-    \[ \deminutum a \pes b \flexa \deminutum g \]
-    s^\markup {"D"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{12. Porrectus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus
-    \[ a \flexa g \pes b \]
-    s^\markup {"E"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Auctus Descendens
-    \[ a \flexa g \pes \auctum \descendens b \]
-    s^\markup {"F"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Porrectus Deminutus
-    \[ a \flexa g \pes \deminutum b \]
-    s^\markup {"G"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{13. Climacus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus
-    \[ \virga b \inclinatum a \inclinatum g \]
-    s^\markup {"H"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Auctus
-    \[ \virga b \inclinatum a \inclinatum \auctum g \]
-    s^\markup {"I"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Climacus Deminutus
-    \[ \virga b \inclinatum a \inclinatum \deminutum g \]
-    s^\markup {"J"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{14. Scandicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus
-    \[ g \pes a \virga b \]
-    s^\markup {"K"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Auctus Descendens
-    \[ g \pes a \pes \auctum \descendens b \]
-    s^\markup {"L"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Scandicus Deminutus
-    \[ g \pes a \pes \deminutum b \]
-    s^\markup {"M"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-
-@item
-@code{15. Salicus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus
-    \[ g \oriscus a \pes \virga b \]
-    s^\markup {"N"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Salicus Auctus Descendens
-    \[ g \oriscus a \pes \auctum \descendens b \]
-    s^\markup {"O"}
-  }
-\layout { \neumeDemoLayout }}
-@end lilypond
-@tab
-
-@item
-@code{16. Trigonus}
-@tab
-@lilypond[staffsize=26,line-width=1.0\cm]
-\include "gregorian-init.ly"
-\score {
-  \transpose c c' {
-    % Trigonus
-    \[ \stropha b \stropha b \stropha a \]
-    s^\markup {"P"}
-  }
-  \layout { \neumeDemoLayout }
-}
-@end lilypond
-@tab
-@tab
-
-@end multitable
-
-
-Unlike most other neumes notation systems, the input language for
-neumes does not reflect the typographical appearance, but is designed
-to focus on musical meaning.  For example, @code{\[ a \pes b
-\flexa g \]} produces a Torculus consisting of three Punctum heads,
-while @code{\[ a \flexa g \pes b \]} produces a Porrectus with a
-curved flexa shape and only a single Punctum head.  There is no
-command to explicitly typeset the curved flexa shape; the decision of
-when to typeset a curved flexa shape is based on the musical
-input.  The idea of this approach is to separate the musical aspects
-of the input from the notation style of the output.  This way, the
-same input can be reused to typeset the same music in a different
-style of Gregorian chant notation.
-
-The following table shows the code fragments that produce the
-ligatures in the above neumes table.  The letter in the first column
-in each line of the below table indicates to which ligature in the
-above table it refers.  The second column gives the name of the
-ligature.  The third column shows the code fragment that produces this
-ligature, using @code{g}, @code{a}, and @code{b} as example pitches.
-
-@multitable @columnfractions .02 .31 .67
-@item
-@b{#}
-@tab
-@b{Name}
-@tab
-@b{Input Language}
-
-@item
-a
-@tab
-Punctum
-@tab
-@code{\[ b \]}
-
-@item
-b
-@tab
-Punctum Inclinatum
-@tab
-@code{\[ \inclinatum b \]}
-
-@item
-c
-@tab
-Punctum Auctum@*
-Ascendens
-@tab
-@code{\[ \auctum \ascendens b \]}
-
-@item
-d
-@tab
-Punctum Auctum@*
-Descendens
-@tab
-@code{\[ \auctum \descendens b \]}
-
-@item
-e
-@tab
-Punctum Inclinatum@*
-Auctum
-@tab
-@code{\[ \inclinatum \auctum b \]}
-
-@item
-f
-@tab
-Punctum Inclinatum@*
-Parvum @tab
-@code{\[ \inclinatum \deminutum b \]}
-
-@item
-g
-@tab
-Virga
-@tab
-@code{\[ \virga b \]}
-
-@item
-h
-@tab
-Stropha
-@tab
-@code{\[ \stropha b \]}
-
-@item
-i
-@tab
-Stropha Aucta
-@tab
-@code{\[ \stropha \auctum b \]}
-
-@item
-j
-@tab
-Oriscus
-@tab
-@code{\[ \oriscus b \]}
-
-@item
-k
-@tab
-Clivis vel Flexa
-@tab
-@code{\[ b \flexa g \]}
-
-@item
-l
-@tab
-Clivis Aucta@*
-Descendens
-@tab
-@code{\[ b \flexa \auctum \descendens g \]}
-
-@item
-m
-@tab
-Clivis Aucta@*
-Ascendens
-@tab
-@code{\[ b \flexa \auctum \ascendens g \]}
-
-@item
-n
-@tab
-Cephalicus
-@tab
-@code{\[ b \flexa \deminutum g \]}
-
-@item
-o
-@tab
-Podatus vel Pes
-@tab
-@code{\[ g \pes b \]}
-
-@item
-p
-@tab
-Pes Auctus@*
-Descendens
-@tab
-@code{\[ g \pes \auctum \descendens b \]}
-
-@item
-q
-@tab
-Pes Auctus@*
-Ascendens
-@tab
-@code{\[ g \pes \auctum \ascendens b \]}
-
-@item
-r
-@tab
-Epiphonus
-@tab
-@code{\[ g \pes \deminutum b \]}
-
-@item
-s
-@tab
-Pes Quassus
-@tab
-@code{\[ \oriscus g \pes \virga b \]}
-
-@item
-t
-@tab
-Pes Quassus@*
-Auctus Descendens @tab
-@code{\[ \oriscus g \pes \auctum \descendens b \]}
-
-@item
-u
-@tab
-Quilisma Pes
-@tab
-@code{\[ \quilisma g \pes b \]}
-
-@item
-v
-@tab
-Quilisma Pes@*
-Auctus Descendens
-@tab
-@code{\[ \quilisma g \pes \auctum \descendens b \]}
-
-@item
-w
-@tab
-Pes Initio Debilis
-@tab
-@code{\[ \deminutum g \pes b \]}
-
-@item
-x
-@tab
-Pes Auctus Descendens@*
-Initio Debilis
-@tab
-@code{\[ \deminutum g \pes \auctum \descendens b \]}
-
-@item
-y
-@tab
-Torculus
-@tab
-@code{\[ a \pes b \flexa g \]}
-
-@item
-z
-@tab
-Torculus Auctus@*
-Descendens
-@tab
-@code{\[ a \pes b \flexa \auctum \descendens g \]}
-
-@item
-A
-@tab
-Torculus Deminutus
-@tab
-@code{\[ a \pes b \flexa \deminutum g \]}
-
-@item
-B
-@tab
-Torculus Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa g \]}
-
-@item
-C
-@tab
-Torculus Auctus@*
-Descendens Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \auctum \descendens g \]}
-
-@item
-D
-@tab
-Torculus Deminutus@*
-Initio Debilis
-@tab
-@code{\[ \deminutum a \pes b \flexa \deminutum g \]}
-
-@item
-E
-@tab
-Porrectus
-@tab
-@code{\[ a \flexa g \pes b \]}
-
-@item
-F
-@tab
-Porrectus Auctus@*
-Descendens
-@tab
-@code{\[ a \flexa g \pes \auctum \descendens b \]}
-
-@item
-G
-@tab
-Porrectus Deminutus
-@tab
-@code{\[ a \flexa g \pes \deminutum b \]}
-
-@item
-H
-@tab
-Climacus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum g \]}
-
-@item
-I
-@tab
-Climacus Auctus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \auctum g \]}
-
-@item
-J
-@tab
-Climacus Deminutus
-@tab
-@code{\[ \virga b \inclinatum a \inclinatum \deminutum g \]}
-
-@item
-K
-@tab
-Scandicus
-@tab
-@code{\[ g \pes a \virga b \]}
-
-@item
-L
-@tab
-Scandicus Auctus@*
-Descendens
-@tab
-@code{\[ g \pes a \pes \auctum \descendens b \]}
-
-@item
-M
-@tab
-Scandicus Deminutus
-@tab
-@code{\[ g \pes a \pes \deminutum b \]}
-
-@item
-N
-@tab
-Salicus
-@tab
-@code{\[ g \oriscus a \pes \virga b \]}
-
-@item
-O
-@tab
-Salicus Auctus Descendens
-@tab
-@code{\[ g \oriscus a \pes \auctum \descendens b \]}
-
-@item
-P
-@tab
-Trigonus
-@tab
-@code{\[ \stropha b \stropha b \stropha a \]}
-@end multitable
-
-The ligatures listed above mainly serve as a limited, but still
-representative pool of Gregorian ligature examples.  Virtually, within
-the ligature delimiters @code{\[} and @code{\]}, any number of heads
-may be accumulated to form a single ligature, and head prefixes like
-@code{\pes}, @code{\flexa}, @code{\virga}, @code{\inclinatum},
-etc. may be mixed in as desired.  The use of the set of rules that
-underlies the construction of the ligatures in the above table is
-accordingly extrapolated.  This way, infinitely many different
-ligatures can be created.
-
-Augmentum dots, also called @emph{morae}, are added with the music
-function @code{\augmentum}.  Note that @code{\augmentum} is
-implemented as a unary music function rather than as head prefix.  It
-applies to the immediately following music expression only.  That is,
-@code{\augmentum \virga c} will have no visible effect.  Instead, say
-@code{\virga \augmentum c} or @code{\augmentum @{\virga c@}}.  Also
-note that you can say @code{\augmentum @{a g@}} as a shortcut for
-@code{\augmentum a \augmentum g}.
-
-@lilypond[quote,ragged-right,verbatim]
-\include "gregorian-init.ly"
-\score {
-  \new VaticanaVoice {
-    \[ \augmentum a \flexa \augmentum g \]
-    \augmentum g
-  }
-}
-@end lilypond
-
-@refcommands
-
-The following head prefixes are supported
-
-@funindex \virga
-@code{\virga},
-@funindex \stropha
-@code{\stropha},
-@funindex \inclinatum
-@code{\inclinatum},
-@funindex \auctum
-@code{\auctum},
-@funindex \descendens
-@code{\descendens},
-@funindex \ascendens
-@code{\ascendens},
-@funindex \oriscus
-@code{\oriscus},
-@funindex \quilisma
-@code{\quilisma},
-@funindex \deminutum
-@code{\deminutum},
-@funindex \cavum
-@code{\cavum},
-@funindex \linea
-@code{\linea}.
-
-Head prefixes can be accumulated, though restrictions apply.  For
-example, either @code{\descendens} or @code{\ascendens} can be applied
-to a head, but not both to the same head.
-
-@funindex \pes
-@funindex \flexa
-Two adjacent heads can be tied together with the @code{\pes} and
-@code{\flexa} infix commands for a rising and falling line of melody,
-respectively.
-
-@funindex \augmentum
-Use the unary music function @code{\augmentum} to add augmentum dots.
-
-@refbugs
-
-When an @code{\augmentum} dot appears at the end of the last staff
-within a ligature, it is sometimes vertically placed wrong.  As a
-workaround, add an additional skip note (e.g. @code{s8}) as last note
-of the staff.
-
-@code{\augmentum} should be implemented as a head prefix rather than a
-unary music function, such that @code{\augmentum} can be intermixed
-with head prefixes in arbitrary order.
-
-@node Gregorian Chant contexts
-@subsection Gregorian Chant contexts
-
-@cindex VaticanaVoiceContext
-@cindex VaticanaStaffContext
-
-The predefined @code{VaticanaVoiceContext} and
-@code{VaticanaStaffContext} can be used to engrave a piece of
-Gregorian Chant in the style of the Editio Vaticana.  These contexts
-initialize all relevant context properties and grob properties to
-proper values, so you can immediately go ahead entering the chant, as
-the following excerpt demonstrates
-
-@lilypond[quote,ragged-right,packed,verbatim]
-\include "gregorian-init.ly"
-\score {
-  <<
-    \new VaticanaVoice = "cantus" {
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \]
-      f \divisioMinima
-      \[ f\melisma \pes a c' c' \pes d'\melismaEnd \]
-      c' \divisioMinima \break
-      \[ c'\melisma c' \flexa a \]
-      \[ a \flexa \deminutum g\melismaEnd \] f \divisioMinima
-    }
-    \new Lyrics \lyricsto "cantus" {
-      San- ctus, San- ctus, San- ctus
-    }
-  >>
-}
-@end lilypond
-
-
-@node Mensural contexts
-@subsection Mensural contexts
-
-@cindex MensuralVoiceContext
-@cindex MensuralStaffContext
-
-The predefined @code{MensuralVoiceContext} and
-@code{MensuralStaffContext} can be used to engrave a piece in mensural
-style.  These contexts initialize all relevant context properties and
-grob properties to proper values, so you can immediately go ahead
-entering the chant, as the following excerpt demonstrates
-
-@lilypond[quote,ragged-right,verbatim]
-\score {
-  <<
-    \new MensuralVoice = "discantus" \transpose c c' {
-      \override Score.BarNumber #'transparent = ##t {
-        c'1\melisma bes a g\melismaEnd
-        f\breve
-        \[ f1\melisma a c'\breve d'\melismaEnd \]
-        c'\longa
-        c'\breve\melisma a1 g1\melismaEnd
-        fis\longa^\signumcongruentiae
-      }
-    }
-    \new Lyrics \lyricsto "discantus" {
-      San -- ctus, San -- ctus, San -- ctus
-    }
-  >>
-}
-@end lilypond
-
-@node Musica ficta accidentals
-@subsection Musica ficta accidentals
-
-In European music from before about 1600, singers were often expected
-to chromatically alter notes at their own initiative. This is called
-@q{Musica Ficta}. In modern transcriptions, these accidentals are
-usually printed over the note.
-
-@cindex Accidental, musica ficta
-@cindex Musica ficta
-
-Support for such suggested accidentals is included, and can be
-switched on by setting @code{suggestAccidentals} to true.
-
-@funindex suggestAccidentals
-
-@lilypond[verbatim,fragment,relative=1]
-fis gis
-\set suggestAccidentals = ##t
-ais bis
-@end lilypond
-
-@seealso
-
-Program reference: @internalsref{Accidental_engraver} engraver and the
-@internalsref{AccidentalSuggestion} object.
-
-@node Figured bass
-@subsection Figured bass
-
-@cindex Basso continuo
-
-@c TODO: musicological blurb about FB
-
-
-LilyPond has support for figured bass
-
-@lilypond[quote,ragged-right,verbatim,fragment]
-<<
-  \new Voice { \clef bass dis4 c d ais g fis}
-  \new FiguredBass \figuremode {
-    < 6 >4 < 7\+ >8 < 6+ [_!] >
-    < 6 >4 <6 5 [3+] >
-    < _ >4 < 6 5/>4
-  }
->>
-@end lilypond
-
-The support for figured bass consists of two parts: there is an input
-mode, introduced by @code{\figuremode}, where you can enter bass figures
-as numbers, and there is a context called @internalsref{FiguredBass} that
-takes care of making @internalsref{BassFigure} objects.
-
-In figures input mode, a group of bass figures is delimited by
-@code{<} and @code{>}.  The duration is entered after the @code{>}
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { <4 6> }
-@end lilypond
-
-Accidentals are added when you append @code{-}, @code{!}, and @code{+}
-to the numbers.  A plus sign is added when you append @code{\+}, and
-diminished fifths and sevenths can be obtained with @code{5/} and @code{7/}.
-
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right,fragment]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
-@end lilypond
-
-Spaces may be inserted by using @code{_}.  Brackets are
-introduced with @code{[} and @code{]}. You can also include text
-strings and text markups, see @ref{Overview of text markup commands}.
-
-@example
-< [4 6] 8 [_! 12] > < 5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right,fragment]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
-@end lilypond
-
-
-It is also possible to use continuation lines for repeated figures,
-
-@lilypond[verbatim,relative=1]
-<<
-  \new Staff {
-    \clef bass
-    c4 c c
-  }
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <4 6> <3 6> <3 7>
-  }
->>
-@end lilypond
-
-@noindent
-In this case, the extender lines always replace existing figures.
-
-The @code{FiguredBass} context doesn't pay attention to the actual
-bass line. As a consequence, you may have to insert extra figures to
-get extender lines below all notes, and you may have to add @code{\!}
-to avoid getting an extender line, e.g.
-
-@lilypond[relative=1]
-<<
-  \new Voice
-  \figures {
-    \set useBassFigureExtenders = ##t
-    <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
-  }
-  {
-    \clef bass
-    f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
-  }
->>
-@end lilypond
-
-When using continuation lines, common figures are always put in the
-same vertical position. When this is unwanted, you can insert a rest
-with @code{r}. The rest will clear any previous alignment.  For
-example, you can write
-
-@example
-  <4 6>8 r8
-@end example
-
-@noindent
-instead of
-@example
-  <4 6>4
-@end example
-
-Accidentals and plus signs can appear before or after the numbers,
-depending on the @code{figuredBassAlterationDirection} and
-@code{figuredBassPlusDirection}
-properties
-
-@lilypond
-  \figures {
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassPlusDirection = #1
-    <6\+> <5+> <6 4-> r
-    \set figuredBassAlterationDirection = #-1
-    <6\+> <5+> <6 4-> r
-  }
-@end lilypond
-
-
-Although the support for figured bass may superficially resemble chord
-support, it is much simpler.  The @code{\figuremode} mode simply
-stores the numbers and @internalsref{FiguredBass} context prints them
-as entered.  There is no conversion to pitches and no realizations of
-the bass are played in the MIDI file.
-
-Internally, the code produces markup texts.  You can use any of the
-markup text properties to override formatting.  For example, the
-vertical spacing of the figures may be set with @code{baseline-skip}.
-
-
-Figured bass can also be added to @code{Staff} contexts
-directly.  In this case, their vertical position is adjusted
-automatically.
-
-@lilypond[ragged-right,fragment,quote]
-<<
-  \new Staff = someUniqueName
-  \relative c'' {
-    c4 c'8 r8 c,4 c'
-  }
-
-  %% send to existing Staff.
-  \context Staff = someUniqueName 
-  \figuremode {
-    <4>4 <6 10>8 s8
-    
-    \set Staff.useBassFigureExtenders = ##t
-    <4 6>4 <4 6>
-  }
->>
-@end lilypond
-
-
-@commonprop
-
-By default, this method produces figures above the notes.  To get
-figures below the notes, use
-
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
-
-
-@refbugs
-
-When using figured bass above the staff with extender lines and
-@code{implicitBassFigures} the lines may become swapped around.
-Maintaining order consistently will be impossible when multiple figures
-have overlapping extender lines.  To avoid this problem, please
-use @code{stacking-dir} on @code{BassFigureAlignment}.
-
-
-@seealso
-
-Program reference: @internalsref{NewBassFigure},
-@internalsref{BassFigureAlignment}, @internalsref{BassFigureLine},
-@internalsref{BassFigureBracket}, and
-@internalsref{BassFigureContinuation} objects and
-@internalsref{FiguredBass} context.
-
-
-
-@node Other instrument specific notation
-@section Other instrument specific notation
-
-This section includes extra information for writing for instruments.
-
-@menu
-* Artificial harmonics (strings)::  
-@end menu
-
-@node Artificial harmonics (strings)
-@subsection Artificial harmonics (strings)
-
-@cindex artificial harmonics
-
-Artificial harmonics are notated with a different notehead style.  They
-are entered by marking the harmonic pitch with @code{\harmonic}.
-
-@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
-<c g'\harmonic>4
-@end lilypond
-
diff --git a/Documentation/user/introduction.itely b/Documentation/user/introduction.itely
index 6ace6ebf90..71fe0f3b01 100644
--- a/Documentation/user/introduction.itely
+++ b/Documentation/user/introduction.itely
@@ -1,5 +1,5 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
@@ -243,7 +243,7 @@ programming language; the program's functionality was set in stone by
 the developers.  That proved to be unsatisfactory for a number of
 reasons:
 
-@itemize @bullet
+@itemize
 @item When LilyPond makes mistakes,
 users need to override formatting decisions.  Therefore, the user must
 have access to the formatting engine.  Hence, rules and settings cannot
@@ -690,21 +690,20 @@ to mix music and text in documents.
 @node About this manual
 @section About this manual
 
-There are two manuals about LilyPond: the @emph{user manual} (this
-document), and @emph{program usage}.
+FIXME: needs almost-complete rewrite.  -gp
 
+There are four manuals about LilyPond: the @emph{Learning Manual},
+the @emph{Notation Reference}, the @emph{Program Usage}, and the
+@emph{Program Reference}.
 
-@subheading User manual
 
-The manual is divided into three books.
-
-@subsubheading Learning manual
+@subheading Learning Manual (LM)
 
 This book explains how to begin learning LilyPond, as well as explaining
 some key concepts in easy terms.  It is recommended to read these
 chapters in a linear fashion.
 
-@itemize @bullet
+@itemize
 
 @item
 @ifhtml
@@ -715,7 +714,7 @@ gives a gentle introduction to typesetting music.  First time
 users should start here.
 
 @item
-@emph{@ref{Putting it all together}},
+@emph{@ref{Fundamental concepts}},
 explains some general concepts about the lilypond file format.  If
 you are not certain where to place a command, read this chapter!
 
@@ -732,47 +731,51 @@ produces.
 @end itemize
 
 
-@subsubheading Notation reference
+@subheading Notation Reference (NR)
 
 This book explains all the LilyPond commands which produce notation.  It
 assumes that readers are familiar with the concepts in the Learning
 manual.
 
-@itemize @bullet
+All of this needs to be rewritten after GDP, anyway.
+
+@ignore
+
+@itemize
 
 @item
-@emph{@ref{Basic notation}},
+@emph{@r ef{Basic notation}},
 discusses topics grouped by notation construct.  This section gives
 details about basic notation that will be useful in almost any
 notation project.
 
 @item
-@emph{@ref{Instrument-specific notation}},
+@emph{@r ef{Instrument-specific notation}},
 discusses topics grouped by notation construct.  This section gives
 details about special notation that will only be useful for particular
 instrument (or vocal) groups.
 
 @item
-@emph{@ref{Advanced notation}},
+@emph{@r ef{Advanced notation}},
 discusses topics grouped by notation construct.  This section gives
 details about complicated or unusual notation.
 
 @item
-@emph{@ref{Changing defaults}},
+@emph{@r ef{Changing defaults}},
 explains how to fine tune layout.
 
 @item
-@emph{@ref{Non-musical notation}},
+@emph{@r ef{Non-musical notation}},
 discusses non-musical output such as titles, multiple movements,
 and how to select which MIDI instruments to use.
 
 @item
-@emph{@ref{Spacing issues}},
+@emph{@r ef{Spacing issues}},
 discusses issues which affect the global output, such as selecting
 paper size or specifying page breaks.
 
 @item
-@emph{@ref{Interfaces for programmers}},
+@emph{@r ef{Interfaces for programmers}},
 explains how to create music functions.
 
 @end itemize
@@ -782,55 +785,56 @@ explains how to create music functions.
 
 This book contains useful reference charts.
 
-@itemize @bullet
+@itemize
 @item
 @ifhtml
 The
 @end ifhtml
-@emph{@ref{Literature list}},
+@emph{@r ef{Literature list}},
 contains a set of useful reference books for those who wish to know
 more on notation and engraving.
 
 @item
 The
-@emph{@ref{Scheme tutorial}},
+@emph{@r ef{Scheme tutorial}},
 presents a short introduction to Scheme, the programming
 language that music functions use.
 
 @item
-@emph{@ref{Notation manual tables}},
+@emph{@r ef{Notation manual tables}},
 are a set of tables showing the chord names, MIDI instruments,
 a list of color names, and the Feta font.
 
 @item
-@emph{@ref{Templates}},
+@emph{@r ef{Templates}},
 of LilyPond pieces.  Just cut and paste a
 template into a file, add notes, and you're done!
 
 @item
 The
-@emph{@ref{Cheat sheet}},
+@emph{@r ef{Cheat sheet}},
 is a handy reference of the most common LilyPond commands.
 
 @item
 The
-@emph{@ref{LilyPond command index}},
+@emph{@r ef{LilyPond command index}},
 is an index of all LilyPond @code{\commands}.
 
 @item
 The
-@emph{@ref{LilyPond index}},
+@emph{@r ef{LilyPond index}},
 is a complete index.
 
 @end itemize
 
+@end ignore
 
 @subheading Program usage
 
 This book explains how to execute the program and how to integrate
 LilyPond notation with other programs.
 
-@itemize @bullet
+@itemize
 
 @item
 @emph{@rprogram{Install}},
@@ -866,7 +870,7 @@ formats to the @code{.ly} format.
 
 There are a number of other places which may be very valuable.
 
-@itemize @bullet
+@itemize
 @cindex idiom
 @cindex jargon
 @cindex terminology
diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely
index 9234ab531d..08f50350cd 100644
--- a/Documentation/user/lilypond-book.itely
+++ b/Documentation/user/lilypond-book.itely
@@ -314,7 +314,7 @@ command line:
 
 @noindent
 where the @var{file}@command{psfonts} file is obtained from
-@command{lilypond-book}, @xref{Invoking lilypond-book}, for details. PDF
+@command{lilypond-book}, @xref{Invoking lilypond-book}, for details.  PDF
 can then be produced with a PostScript to PDF translator like
 @code{ps2pdf} (which is part of GhostScript).  Running @command{dvips}
 will produce some warnings about fonts; these are harmless and may
@@ -503,13 +503,13 @@ based on the standard DocBook elements.
 
 For inserting all type of snippets we use the @code{mediaobject} and @code{inlinemediaobject} element, so our snippets can be
 formatted inline or not inline.
-The snippet formatting options are always provided in the @code{role} property of the innermost element (see in next sections). Tags are
+The snippet formatting options are always provided in the @code{role} property of the innermost element (see in next sections).  Tags are
 chosen to allow DocBook editors format the content gracefully.
 The DocBook files to be processed with @command{lilypond-book} should have the extension @file{.lyxml}.
 
 @subheading Including a LilyPond file
 
-This is the most simple case. We must use the @file{.ly} extension for the included file, and insert it as a standard @code{imageobject},
+This is the most simple case.  We must use the @file{.ly} extension for the included file, and insert it as a standard @code{imageobject},
 with the following structure:
 
 @example
@@ -695,7 +695,7 @@ a link.
 
 @item fontload
 This option includes fonts in all of the generated EPS-files for this
-snippet. This should be used if the snippet uses any font that LaTeX
+snippet.  This should be used if the snippet uses any font that LaTeX
 cannot find on its own.
 
 @end table
@@ -800,7 +800,7 @@ music stick out of the right margin.
 
 The width of a tightly clipped systems can vary, due to notation
 elements that stick into the left margin, such as bar numbers and
-instrument names. This option will shorten each line and move each 
+instrument names.  This option will shorten each line and move each 
 line to the right by the same amount.
 
 
diff --git a/Documentation/user/lilypond-learning.tely b/Documentation/user/lilypond-learning.tely
new file mode 100644
index 0000000000..c1e811970a
--- /dev/null
+++ b/Documentation/user/lilypond-learning.tely
@@ -0,0 +1,168 @@
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+@setfilename lilypond-learning.info
+@settitle GNU LilyPond Learning Manual
+@documentencoding UTF-8
+@documentlanguage en
+
+@iftex
+@afourpaper
+@c don't replace quotes with directed quotes
+@tex
+\gdef\SETtxicodequoteundirected{Foo}
+\gdef\SETtxicodequotebacktick{Bla}
+@end tex
+@end iftex
+
+
+@c don't remove this comment.
+@ignore
+@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival
+@omfdescription User manual of the LilyPond music engraving system
+@omftype program usage
+@omfcategory Applications|Publishing
+@omflanguage English
+@end ignore
+
+
+@ifhtml
+This document is also available as a
+@uref{source/Documentation/user/lilypond-learning.pdf,PDF} and as
+@uref{source/Documentation/user/lilypond-learning-big-page.html,one big page}.
+@end ifhtml
+
+
+@c  This produces the unified index
+@syncodeindex fn cp
+@syncodeindex vr cp
+
+
+@finalout
+
+@titlepage
+@title LilyPond
+@subtitle The music typesetter
+@titlefont{Learning Manual}
+@author The LilyPond development team
+
+
+Copyright @copyright{} 1999--2007 by the authors
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+
+@vskip 20pt
+
+@lilypond[ragged-right]
+\score {
+  \context Lyrics {
+    \override Score.RehearsalMark #'self-alignment-X = #LEFT
+    \override Score.RehearsalMark #'font-size = #-2
+    \mark #(ly:export (string-append
+      "(For LilyPond version " (lilypond-version) ")"))
+    s2
+  }
+  \layout {
+    indent = 0.0\pt
+  }
+}
+@end lilypond
+
+@end titlepage
+
+@copying
+Copyright @copyright{} 1999--2007 by the authors
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end copying
+
+@ifnottex
+This file documents GNU LilyPond for beginners.
+
+Copyright 1999--2007 by the authors
+
+@quotation
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1
+or any later version published by the Free Software Foundation;
+with no Invariant Sections.
+A copy of the license is included in the section entitled ``GNU
+Free Documentation License''.
+@end quotation
+@end ifnottex
+
+@ifnottex
+@node Top
+@top GNU LilyPond --- learning manual
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
+
+This is the learning manual for GNU LilyPond 2.11.x series.
+@ifhtml
+(See the bottom of this page for the exact version number).
+@end ifhtml
+
+@cindex web site
+@cindex URL
+
+More information can be found at
+@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
+of this and other documentation.
+
+@menu
+* Preface::                        Preface.
+* Introduction::                   What, Why, How.
+* Tutorial::                       A tutorial introduction.
+* Fundamental concepts::           Basic concepts required for reading
+the rest of this manual.
+* Tweaking output::                Introduction to modifying output.
+* Working on LilyPond projects::   Discusses real-life usage.
+
+Appendices
+
+* Templates::                      Ready-made templates.
+* Scheme tutorial::                Programming inside LilyPond.
+* GNU Free Documentation License:: License of this document.
+* LilyPond index::
+@end menu
+@end ifnottex
+
+@contents
+
+
+@include macros.itexi
+
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include fundamental.itely
+@include tweaks.itely
+@include working.itely
+
+@include templates.itely
+@include scheme-tutorial.itely
+@include fdl.itexi
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
+
+@bye
diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely
index c5a85cdcfc..5388681825 100644
--- a/Documentation/user/lilypond.tely
+++ b/Documentation/user/lilypond.tely
@@ -158,20 +158,9 @@ of this and other documentation.
 @include dedication.itely
 
 @menu
-Learning Manual
-
-* Preface::                        Preface.
-* Introduction::                   What, Why, How.
-* Tutorial::                       A tutorial introduction.
-* Putting it all together::        More explanation about LilyPond concepts.
-* Working on LilyPond projects::   Discusses real-life usage.
-* Tweaking output::                Introduction to modifying output.
-
-Notation Reference
-
-* Basic notation::                 Standard musical notation.
-* Instrument-specific notation::   Specialized notation.
-* Advanced notation::              Less frequently used notation.
+* Musical notation::               Musical notation.
+* Specialist notation::            Notation which is only used for
+    specific purposes.
 * Changing defaults::              Tuning output.
 * Non-musical notation::           Output that is not musical notation.
 * Spacing issues::                 Display of output on paper.
@@ -180,9 +169,7 @@ Notation Reference
 Appendices
 
 * Literature list::                Reference works about music notation.
-* Scheme tutorial::                Programming inside LilyPond.
 * Notation manual tables::         Tables and charts.
-* Templates::                      Ready-made templates.
 * Cheat sheet::                    Summary of LilyPond syntax.
 * GNU Free Documentation License:: License of this document.
 * LilyPond command index::
@@ -194,16 +181,10 @@ Appendices
 
 
 @include macros.itexi
-@include preface.itely
-@include introduction.itely
-@include tutorial.itely
-@include putting.itely
-@include working.itely
-@include tweaks.itely
-
-@include basic-notation.itely
-@include instrument-notation.itely
-@include advanced-notation.itely
+
+@include notation.itely
+@include specialist.itely
+
 @include changing-defaults.itely
 @include non-music.itely
 @include spacing.itely
@@ -211,9 +192,7 @@ Appendices
 
 
 @include literature.itely
-@include scheme-tutorial.itely
 @include notation-appendices.itely
-@include templates.itely
 @include cheatsheet.itely
 @include fdl.itexi
 
diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi
index 1c96e06771..334cf17612 100644
--- a/Documentation/user/macros.itexi
+++ b/Documentation/user/macros.itexi
@@ -6,129 +6,148 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c **** all formats ****
+@c   ***** Displaying text *****
 
-@macro refbugs
-@noindent
-@subsubheading Bugs
+@c we need this since @q{\} doesn't work with makeinfo 4.8 --
+@c say @q{@value{backslash}} instead
+@set backslash \
 
+@c to get decent quotes in `foo' and ``foo''
+@macro q{TEXT}
+@quoteleft{}\TEXT\@quoteright{}
 @end macro
 
-@macro moreinfo
-@subheading More information
+@macro qq{TEXT}
+@quotedblleft{}\TEXT\@quotedblright{}
+@end macro
 
+@macro warning{TEXT}
+@quotation
+@quotation
+@cartouche
+@b{Note:} \TEXT\
+@end cartouche
+@end quotation
+@end quotation
 @end macro
 
-@macro seealso
-@noindent
-@subsubheading See also
+@c TODO: define different output for info
+@macro notation{TEXT}
+@var{\TEXT\}
+@end macro
+
+
+
+@c   **** Headings in a doc subsection ****
 
+@c not really a heading, but...
+@macro smallspace
+@sp 1
 @end macro
 
+@c obsolete; being removed.
 @macro refcommands
 @noindent
 @subsubheading Predefined commands
 
 @end macro
 
-@macro context{NAME}
-@vindex \NAME\
-@code{\NAME\}@c should use internalsref
+@macro commonprop
+@noindent
+@subsubheading Commonly tweaked properties
+
 @end macro
 
-@macro refcommand{WHAT}
-@vindex \WHAT\
-@code{\WHAT\}
+@macro seealso
+@noindent
+@subsubheading See also
+
 @end macro
 
-@macro commonprop
+@macro refbugs
 @noindent
-@subsubheading Commonly tweaked properties
+@subsubheading Known issues and warnings
 
 @end macro
 
-@macro funindex {WORD}
-@findex \WORD\
-@kindex \WORD\
+
+@macro context{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}@c should use internalsref
 @end macro
 
+@macro funindex {TEXT}
+@findex \TEXT\
+@kindex \TEXT\
+@end macro
 
 
-@c  *** Macros with variable output ***
+
+@c   **** Links and references ****
 
 @c usage: @lsr{ancient,custodes.ly}
-@macro lsr{DIR,NAME}
+@macro lsr{DIR,TEXT}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
+@uref{source/input/lsr/\DIR\/collated-files.html#\TEXT\,@file{\DIR\/\TEXT\}}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\/\NAME\}
+@file{\DIR\/\TEXT\}
 @end ifnothtml
 @end macro
 
 @macro lsrdir{DIR}
 @ifhtml
-  @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
+@uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
 @end ifhtml
 @ifnothtml
-  @file{\DIR\}
+@file{\DIR\}
 @end ifnothtml
 @end macro
 
 
-
-
-@macro arrow{}
-@iftex
-@tex $\\Rightarrow$ @end tex@c
-@end iftex
-@ifhtml
-@html
-&rarr;
-@end html
-@end ifhtml
-@ifinfo
--->
-@end ifinfo
-@end macro
-
-
-@c we need this since @q{\} doesn't work with makeinfo 4.8 --
-@c say @q{@value{backslash}} instead
-@set backslash \
-
+@c  Definitions for references:
+@c     @internalsref
+@c     @rglos
+@c     @rprogram
+@c     @ruser
+@c     @rlearning
 
 @ifhtml
 @c ***** HTML *****
 
 @c makeinfo-4.7 encodes html names, which means that nodes that
 @c contain nonalphanum characters will be broken links on the website.
-@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
+@c @uref{../lilypond-internals/\TEXT\.html,\TEXT\}@c
 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
 @c better than a broken link.
-@c @inforef{\NAME\,,lilypond-internals}@c
+@c @inforef{\TEXT\,,lilypond-internals}@c
 @c using @ref without punctuation is OK without for formats other than info
 
 @ifset bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals-big-page}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals-big-page}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary-big-page}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary-big-page}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program-big-page}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program-big-page}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-big-page}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-big-page}
+@end macro
+
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning-big-page}
 @end macro
 
 @end ifset
@@ -136,42 +155,32 @@
 
 @ifclear bigpage
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@end ifclear
-
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@html
-&lsquo;\TEXT\&rsquo;
-@end html
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-@html
-&ldquo;\TEXT\&rdquo;
-@end html
-@end macro
+@end ifclear
 
 @end ifhtml
 
@@ -179,38 +188,29 @@
 @ifdocbook
 @c ***** DOCBOOK-XML *****
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-internals}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-internals}
 @end macro
 
-@macro rglos{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,music-glossary}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-@xml
-&lsquo;\TEXT\&rsquo;
-@end xml
-@end macro
-
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-@xml
-&ldquo;\TEXT\&rdquo;
-@end xml
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifdocbook
@@ -219,38 +219,29 @@
 @ifinfo
 @c **** INFO ****
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@inforef{\NAME\,,lilypond-internals}
-@end macro
-
-@macro rglos{NAME}
-@vindex \NAME\
-@inforef{\NAME\,,music-glossary}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@inforef{\TEXT\,,lilypond-internals}
 @end macro
 
-@macro usermanref{NAME}
-@inforef{\NAME\}
+@macro rglos{TEXT}
+@vindex \TEXT\
+@inforef{\TEXT\,,music-glossary}
 @end macro
 
-@macro rprogram{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond-program}
+@macro rprogram{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-program}
 @end macro
 
-@macro ruser{NAME}
-@vindex \NAME\
-@ref{\NAME\,,,lilypond}
+@macro ruser{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond}
 @end macro
 
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
-@end macro
-
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-``\TEXT\''
+@macro rlearning{TEXT}
+@vindex \TEXT\
+@ref{\TEXT\,,,lilypond-learning}
 @end macro
 
 @end ifinfo
@@ -259,57 +250,29 @@
 @c **** TEX ****
 @iftex
 
-@macro internalsref{NAME}
-@vindex \NAME\
-@code{\NAME\}
+@macro internalsref{TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro rglos {NAME}
-@vindex \NAME\
-@code{\NAME\}
+@macro rglos {TEXT}
+@vindex \TEXT\
+@code{\TEXT\}
 @end macro
 
-@macro seeinternals{NAME}
-internals document, @internalsref{\NAME\}
+@macro rprogram{TEXT}
+program usage manual, @internalsref{\TEXT\}
 @end macro
 
-@macro usermanref{NAME}
-user manual, @internalsref{\NAME\}
+@macro ruser{TEXT}
+user manual, @internalsref{\TEXT\}
 @end macro
 
-@macro rprogram{NAME}
-program usage manual, @internalsref{\NAME\}
-@end macro
-
-@alias ruser=usermanref
-
-@c to get decent quotes in `foo'
-@macro q{TEXT}
-`\TEXT\'
-@end macro
-
-@c to get decent quotes in ``foo''
-@macro qq{TEXT}
-``\TEXT\''
+@macro rlearning{TEXT}
+learning manual, @internalsref{\TEXT\}
 @end macro
 
 @end iftex
 
 
-@ifnottex
-@c **** not TEX ****
-
-@macro seeinternals{NAME}
-@internalsref{\NAME\}
-@end macro
-
-@ifnotinfo
-@macro usermanref{NAME}
-@ref{\NAME\}
-@end macro
-@end ifnotinfo
-
-@end ifnottex
-
-
 @c EOF
diff --git a/Documentation/user/music-glossary.tely b/Documentation/user/music-glossary.tely
index 46e4a6b72a..dab6c0d1ab 100644
--- a/Documentation/user/music-glossary.tely
+++ b/Documentation/user/music-glossary.tely
@@ -5,6 +5,8 @@
 @documentencoding UTF-8
 @documentlanguage en
 
+@afourpaper
+
 @c see lilypond.tely for info installation note
 @dircategory LilyPond
 @direntry
@@ -23,16 +25,17 @@ and as @uref{source/Documentation/user/music-glossary-big-page.html,one big page
 @c                             Danish glossary
 @author François Pinard	    @c Original glossary of GNU music project,
 @c                             French glossary
-@author Han-Wen Nienhuys    @c Dutch glossary
-@author Jan Nieuwenhuizen   @c Dutch glossary
+@author Mats Bengtsson      @c Swedish glossary
 @author David González      @c Spanish glossary
 @author Bjoern Jacke        @c German glossary
 @author Neil Jerram         @c English glossary translations
-@author Mats Bengtsson      @c Swedish glossary
-@author Adrian Mariano      @c Italian glossary
 @author Heikki Junes        @c Finnish glossary
+@author Kurtis Kroon		@c English glossary maintenance, beg. Oct. 2007
+@author Adrian Mariano      @c Italian glossary
+@author Han-Wen Nienhuys    @c Dutch glossary
+@author Jan Nieuwenhuizen   @c Dutch glossary
 
-@c Fixes by Jean-Pierre Coulon and `Dirk'
+@c Fixes by Jean-Pierre Coulon and `Dirk', alphabetized by last name, KK, 10/07
 
 Copyright @copyright{} 1999--2007 by the authors
 
@@ -77,14 +80,16 @@ Spanish glossary,
 Original glossary of GNU music project, French glossary,
 @item Han-Wen Nienhuys
 Dutch glossary,
+@item Heikki Junes
+Finnish glossary translations,
 @item Jan Nieuwenhuizen
 Dutch glossary,
+@item Kurtis Kroon
+English glossary,
 @item Mats Bengtsson
 Swedish glossary,
 @item Neil Jerram
-English glossary translations,
-@item Heikki Junes
-Finnish glossary translations.
+English glossary translations.
 @end table
 @*
 Copyright 1999--2007 by the authors
@@ -108,10 +113,10 @@ Copyright 1999--2007 by the authors
 @c arrowref
 @macro aref{word}
 @iftex
-@w{@arrow{}@strong{\word\}}@c
+@w{@expansion{}@strong{\word\}}@c
 @end iftex
 @ifnottex
-@arrow{}@ref{\word\, @strong{\word\}}@c
+@expansion{}@ref{\word\, @strong{\word\}}@c
 @end ifnottex
 @end macro
 
@@ -119,7 +124,6 @@ Copyright 1999--2007 by the authors
 * Musical terms A-Z::           
 * Duration names notes and rests::  
 * Pitch names::                 
-* Literature used::             
 @end menu
 
 @node Musical terms A-Z
@@ -185,6 +189,7 @@ Languages in this order.
 * chromatic scale::             
 * chromaticism::                
 * church mode::                 
+* church rest::                 
 * clef::                        
 * cluster::                     
 * comma::                       
@@ -208,6 +213,7 @@ Languages in this order.
 * diatonic scale::              
 * diminished interval::         
 * diminuendo::                  
+* direct::                      
 * disjunct movement::           
 * dissonance::                  
 * dissonant interval::          
@@ -227,17 +233,21 @@ Languages in this order.
 * duplet::                      
 * duration::                    
 * dydimic comma::               
+* dynamics::                    
 * E::                           
 * ecclesiastical mode::         
 * eighth note::                 
 * eighth rest::                 
+* elision::                     
 * embellishment::               
 * engraving::                   
 * enharmonic::                  
 * equal temperament::           
 * expression mark::             
+* extender line::               
 * F::                           
 * F clef::                      
+* feathered beam::              
 * fermata::                     
 * fifth::                       
 * figured bass::                
@@ -256,6 +266,7 @@ Languages in this order.
 * grand staff::                 
 * grave::                       
 * gruppetto::                   
+* H::                           
 * half note::                   
 * half rest::                   
 * harmonic cadence::            
@@ -278,12 +289,14 @@ Languages in this order.
 * long appoggiatura::           
 * longa::                       
 * lyrics::                      
+* lyric tie::                   
 * major interval::              
 * major::                       
 * meantone temperament::        
 * measure::                     
 * mediant::                     
 * melisma::                     
+* melisma line::                
 * melodic cadence::             
 * meter::                       
 * metronome::                   
@@ -318,6 +331,7 @@ Languages in this order.
 * perfect interval::            
 * phrase::                      
 * phrasing::                    
+* pickup::                      
 * piano::                       
 * pitch::                       
 * pizzicato::                   
@@ -338,6 +352,7 @@ Languages in this order.
 * ritenuto::                    
 * scale::                       
 * scale degree::                
+* scordatura::                  
 * score::                       
 * second::                      
 * semitone::                    
@@ -367,6 +382,7 @@ Languages in this order.
 * subdominant::                 
 * submediant::                  
 * subtonic::                    
+* sul G::                       
 * superdominant::               
 * supertonic::                  
 * symphony::                    
@@ -407,6 +423,7 @@ Languages in this order.
 * woodwind::                    
 @end menu
 
+
 @node A
 @section A
 
@@ -419,6 +436,11 @@ DK: a,
 S: a,
 FI: A, a.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node accent
 @section accent
 
@@ -433,10 +455,14 @@ FI: aksentti, korostus.
 
 The stress of one tone over others.
 
+
 @node accessory
 @section accessory
 
-@aref{ornament}.
+@seealso
+
+@ref{ornament}.
+
 
 @node accidental
 @section accidental
@@ -450,9 +476,9 @@ DK: løst fortegn,
 S: tillfälligt förtecken,
 FI: tilapäinen etumerkki.
 
-An accidental has the effect of an @aref{alteration} of a note.  A
-sharp raises a tone by a @aref{semitone}, a double sharp raises it by
-a @aref{whole tone}, a flat lowers it by a semitone and a double flat
+An accidental has the effect of an @ref{alteration} of a note.  A
+sharp raises a tone by a @ref{semitone}, a double sharp raises it by
+a @ref{whole tone}, a flat lowers it by a semitone and a double flat
 lowers it by a whole tone.  A natural cancels the effect of a previous
 accidental.
 
@@ -461,15 +487,16 @@ accidental.
 << 
   \context Staff \relative c'' {
     \set Staff.extraNatural = ##f
-    gis1 gisis ges geses g!
+    gisis1 gis g! ges geses
   }
   \lyrics {
     \override Lyrics .LyricText #'self-alignment-X = #-1
-    sharp "db. sharp" flat "db. flat" natural
+    "db. sharp" sharp natural flat "db. flat"
   }
 >>
 @end lilypond
 
+
 @node accelerando
 @section accelerando
 
@@ -484,6 +511,7 @@ FI: accelerando, kiihdyttäen.
 
 Increase tempo.
 
+
 @node adagio
 @section adagio
 
@@ -498,9 +526,10 @@ FI: adagio, hitaasti.
 
 It.@: comfortable, easy.
 1.@tie{}Slow tempo, slower -- especially in even meter -- than
-@aref{andante} and faster than @aref{largo}.
+@ref{andante} and faster than @ref{largo}.
 2.@tie{}A movement in slow tempo, especially the second (slow) movement of
-@aref{sonata}s, symphonies, etc.
+@ref{sonata}s, symphonies, etc.
+
 
 @node allegro
 @section allegro
@@ -515,7 +544,8 @@ S: allegro,
 FI: allegro, nopeasti.
 
 It.@: cheerful.  Quick tempo.  Also used as a title for pieces in a quick
-tempo, especially the first and last movements of a @aref{sonata}.
+tempo, especially the first and last movements of a @ref{sonata}.
+
 
 @node alteration
 @section alteration
@@ -530,7 +560,8 @@ S:
 FI:
 
 An alteration is the modification, raising or lowering, of a note's
-pitch.  It is established by an @aref{accidental}.
+pitch.  It is established by an @ref{accidental}.
+
 
 @node alto
 @section alto
@@ -547,7 +578,8 @@ FI: altto, matala naisääni.
 A female voice of low range (@emph{contralto}).  Originally the alto was a
 high male voice (hence the name), which by the use of falsetto reached the
 height of the female voice.  This type of voice is also known as
-@aref{counter tenor}.
+@ref{counter tenor}.
+
 
 @node alto clef
 @section alto clef
@@ -561,8 +593,12 @@ DK: altnøgle,
 S: altklav,
 FI: alttoavain.
 
-C clef setting middle C on the middle line of the staff
-@aref{C clef}.
+C clef setting middle C on the middle line of the staff.
+
+@seealso
+
+@ref{C clef}.
+
 
 @node ambit
 @section ambit
@@ -580,15 +616,35 @@ The term ambit (from latin: ambitus, plural: ambitus) denotes a range
 of pitches for a given voice in a part of music.  It may also denote
 the pitch range that a musical instrument is capable of playing.
 
+
 @node anacrusis
 @section anacrusis
 
-@c  TODO: add more languages for anacrusis
-ES: anacrusa
-F: anacrouse
+ES: anacrusa,
+I: anacrusi,
+F: anacrouse, levée,
+D: Auftakt,
+NL: opmaat,
+DK: optakt,
+S: upptakt,
+FI: kohotahti.
 
 An anacrusis (also known as pickup or upbeat) is an incomplete measure
-of music before a section of music.
+of music before a section of music. It also refers to the initial note(s)
+of a melody occurring in that incomplete measure.
+
+@seealso
+
+@ref{measure}, @ref{meter}.
+
+@lilypond[fragment,line-width=13.0\cm]
+\key f \major
+\time 4/4
+\relative c' {
+  \partial 4 f4 | bes4. a8 bes4 c |
+  bes( a) g f | bes4. a8 bes4 c | f,2. \bar "||" }
+@end lilypond
+
 
 @node ancient minor scale
 @section ancient minor scale
@@ -602,7 +658,9 @@ DK: ren mol,
 S: ren mollskala,
 FI: luonnollinen molliasteikko.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -610,6 +668,7 @@ FI: luonnollinen molliasteikko.
 a1 b c d e f g a }
 @end lilypond
 
+
 @node andante
 @section andante
 
@@ -624,6 +683,7 @@ FI: andante, käyden.
 
 Walking tempo/character.
 
+
 @node appoggiatura
 @section appoggiatura
 
@@ -637,10 +697,11 @@ S: förslag,
 FI: appoggiatura, etuhele.
 
 Ornamental note, usually a second, that is melodically connected with the
-main note following it.  In music before the 19th century a.@: were usually
-performed on the beat, after that mostly before the beat.  While the short
-a.@: is performed as a short note regardless of the duration of the main note
-the duration of the long a.@: is proportional to that of the main note.
+main note following it.  In music before the 19th century appoggiature were
+usually performed on the beat, after that mostly before the beat.  While the
+short appoggiatura is performed as a short note regardless of the duration of
+the main note the duration of the long appoggiatura is proportional to that of
+the main note.
 
 @lilypond[line-width=13.0\cm]
 \context Voice \relative c'' {
@@ -683,6 +744,7 @@ An appoggiatura may have more notes preceding the main note.
 }
 @end lilypond
 
+
 @node arpeggio
 @section arpeggio
 
@@ -715,10 +777,19 @@ FI: arpeggio, murtosointu.
 >>
 @end lilypond
 
+
 @node articulation
 @section articulation
 
-@c TODO: add languages for articulation.
+ES: articulación,
+I: articulazione,
+F: articulation,
+D: Artikulation,
+NL: articulatie,
+DK: ?,
+S: ?,
+FI: ?.
+
 Articulation refers to notation which indicates how a note or notes should
 be played.  Slurs, accents, staccato, and legato are all examples of
 articulartion.
@@ -738,6 +809,7 @@ FI: nouseva intervalli.
 
 A distance between a starting lower note and a higher ending note.
 
+
 @node augmented interval
 @section augmented interval
 
@@ -750,7 +822,10 @@ DK: forstørret interval,
 S: överstigande intervall,
 FI: ylinouseva intervalli.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node autograph
 @section autograph
@@ -770,6 +845,7 @@ with the aid of a straightedge ruler and T-square only,
 which attempts to emulate engraving.
 This required more skill than did engraving.
 
+
 @node B
 @section B
 
@@ -782,15 +858,26 @@ DK: h,
 S: h,
 FI: H, h.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node backfall
 @section backfall
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node bar
 @section bar
 
-@aref{measure}.
+@seealso
+
+@ref{measure}.
+
 
 @node bar line
 @section bar line
@@ -804,6 +891,7 @@ DK: taktstreg,
 S: taktstreck,
 FI: tahtiviiva.
 
+
 @node baritone
 @section baritone
 
@@ -816,11 +904,12 @@ DK: baryton,
 S: baryton,
 FI: baritoni, keskikorkuinen miesääni.
 
-The male voice intermediate between the @aref{bass} and the
-@aref{tenor}.
+The male voice intermediate between the @ref{bass} and the
+@ref{tenor}.
 
 @c F: clef de troisième ligne dropped
 
+
 @node baritone clef
 @section baritone clef
 
@@ -834,14 +923,18 @@ S: barytonklav,
 FI: baritoniavain.
 
 C or F clef setting middle C on the upper staff line.
-@aref{C clef}, @aref{F clef}.
+
+@seealso
+
+@ref{C clef}, @ref{F clef}.
+
 
 @node bass clef
 @section bass clef
 
 ES: clave de fa en cuarta,
 I: chiave di basso,
-F: clé de fa quatrième ligne,
+F: clef de fa quatrième ligne,
 D: Bassschlüssel,
 NL: bassleutel,
 DK: basnøgle,
@@ -849,7 +942,11 @@ S: basklav,
 FI: bassoavain.
 
 A clef setting with middle C on the first top ledger line.
-@aref{F clef}.
+
+@seealso
+
+@ref{F clef}.
+
 
 @node bass
 @section bass
@@ -866,7 +963,11 @@ FI: basso, matala miesääni.
 1.@tie{}The lowest male voice.
 2.@tie{}Sometimes, especially in jazz music, used as
 an abbreviation for double bass.
-@aref{strings}.
+
+@seealso
+
+@ref{strings}.
+
 
 @node beam
 @section beam
@@ -893,6 +994,11 @@ The number of beams determines the note value of the connected notes.
   g64_"1/64"[ s32 g64 s32 g64 s32 g64] s32 }
 @end lilypond
 
+@seealso
+
+@ref{feathered beam}.
+
+
 @node beat
 @section beat
 
@@ -917,10 +1023,14 @@ the start of the music.
 \relative c'' { g8 d' c | b c a | g4. \bar "||"}
 @end lilypond
 
+
 @node bind
 @section bind
 
-@aref{tie}.
+@seealso
+
+@ref{tie}.
+
 
 @node brace
 @section brace
@@ -951,6 +1061,7 @@ orchestral or choral score.
   \relative c \context Staff = SB { \clef bass c1 \bar "|." } >>
 @end lilypond
 
+
 @node brass
 @section brass
 
@@ -967,6 +1078,7 @@ A family of blown musical instruments made of brass, all using a cup formed
 mouth piece.  The brass instruments commonly used in a symphony orchestra are
 trumpet, trombone, french horn, and tube.
 
+
 @node breath mark
 @section breath mark
 
@@ -980,6 +1092,7 @@ S: andningstecken,
 FI: hengitysmerkki.
 
 Indication of where to breathe in vocal and wind instrument parts.
+
 @node breve
 @section breve
 
@@ -992,7 +1105,7 @@ DK: brevis,
 S: brevis,
 FI: brevis.
 
-@aref{note value}, twice as long as a whole note.  Mainly used
+@ref{note value}, twice as long as a whole note.  Mainly used
 in pre-1650 music.
 
 @lilypond[fragment,notime,ragged-right]
@@ -1000,6 +1113,7 @@ in pre-1650 music.
 \relative c'' { g\breve }
 @end lilypond
 
+
 @node C
 @section C
 
@@ -1012,12 +1126,17 @@ DK: c,
 S: c,
 FI: C, c.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node C clef
 @section C clef
 
 ES: clave de do,
 I: chiave di do,
-F: clé d'ut,
+F: clef d'ut,
 D: C-Schlüssel,
 NL: C-sleutel,
 DK: c-nøgle,
@@ -1045,6 +1164,7 @@ lines.
 >>
 @end lilypond
 
+
 @node cadence
 @section cadence
 
@@ -1057,7 +1177,10 @@ DK: kadence,
 S: kadens,
 FI: kadenssi, lopuke.
 
-@aref{harmonic cadence}, @aref{functional harmony}.
+@seealso
+
+@ref{harmonic cadence}, @ref{functional harmony}.
+
 
 @node cadenza
 @section cadenza
@@ -1077,6 +1200,7 @@ to exhibit their technical skill and -- not last -- their ability to
 improvise.  Since the middle of the 19th century, however, most cadences have
 been written down by the composer.
 
+
 @node canon
 @section canon
 
@@ -1089,7 +1213,10 @@ DK: kanon,
 S: kanon,
 FI: kaanon, tarkka jäljittely.
 
-@aref{counterpoint}.
+@seealso
+
+@ref{counterpoint}.
+
 
 @node cent
 @section cent
@@ -1105,13 +1232,20 @@ FI: sentti, puolisävelaskeleen sadasosa tasavireisessä
 viritysjärjestelmässä.
 
 Logarithmic unit of measurement.  1@tie{}cent is 1/1200 of an octave (1/100
-of an equally tempered @aref{semitone}).
-@aref{equal temperament}.
+of an equally tempered @ref{semitone}).
+
+@seealso
+
+@ref{equal temperament}.
+
 
 @node central C
 @section central C
 
-@aref{middle C}.
+@seealso
+
+@ref{middle C}.
+
 
 @node chord
 @section chord
@@ -1129,10 +1263,10 @@ Three or more tones sounding simultaneously.  In traditional European music
 the
 base chord is a @emph{triad} consisting of 2@w{ }thirds.  @emph{Major} (major
 +
-minor @aref{third}) as well as @emph{minor} (minor + major third)
+minor @ref{third}) as well as @emph{minor} (minor + major third)
 chords may be extended with more thirds.  Four-tone @emph{seventh chords}
 and five-tone @emph{ninth} major chords are most often used as dominants
-(@aref{functional harmony}).  A special case is chords having no
+(@ref{functional harmony}).  A special case is chords having no
 third above the lower notes to define their quality as major or minor.  Such
 chords are denoted open chords
 
@@ -1160,6 +1294,7 @@ chords are denoted open chords
 >>
 @end lilypond
 
+
 @node chromatic scale
 @section chromatic scale
 
@@ -1172,13 +1307,14 @@ DK: kromatisk skala,
 S: kromatisk skala,
 FI: kromaattinen asteikko.
 
-A scale consisting of all 12 @aref{semitone}s.
+A scale consisting of all 12 @ref{semitone}s.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
 \relative c' { c1 cis d dis e f fis g gis a ais b c }
 @end lilypond
 
+
 @node chromaticism
 @section chromaticism
 
@@ -1191,7 +1327,8 @@ DK: kromatik,
 S: kromatik,
 FI: kromatiikka.
 
-Use of tones extraneous to a @aref{diatonic scale} (minor, major).
+Use of tones extraneous to a @ref{diatonic scale} (minor, major).
+
 
 @node church mode
 @section church mode
@@ -1205,7 +1342,29 @@ DK: kirketoneart,
 S: kyrkotonart,
 FI: moodi, kirkkosävellaji.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
+
+@node church rest
+@section church rest
+
+ES: compases de espera (estilo de la iglesia),
+I: pausa multipla (della cappella),
+F: pause multiple (style de l'église),
+NL: meermaats rust (?),
+D: Kirchenpause,
+DK: flertaktspause (?),
+S: flertaktspaus (?),
+FI: usean tahdin mittainen tauko (?).
+
+LilyPond-specific term for an older style of multibar rests.  Instead of a long bar with a number, @q{church rest}s use a combination of longa, breve and whole rests to indicate the duration (in measures) of a rest.
+
+@seealso
+
+@ref{multibar rest}.
+
 
 @node clef
 @section clef
@@ -1219,7 +1378,262 @@ DK: nøgle,
 S: klav,
 FI: avain, nuottiavain.
 
-@aref{C clef}, @aref{F clef}, @aref{G clef}.
+@seealso
+
+@ref{C clef}, @ref{F clef}, @ref{G clef}.
+
+The clef indicates which lines of the staff correspond to which
+pitches.  The three clef symbols in common use are:
+
+@lilypond[ragged-right,quote]
+\markup {
+ \column {
+  \line { "The Treble or G clef:   " \musicglyph #"clefs.G" }
+  \line { "The Bass or F clef:     " \musicglyph #"clefs.F" }
+  \line { "The Alto or C clef:     " \musicglyph #"clefs.C" }
+ }
+}
+@end lilypond
+
+Imagine a large staff of 11 lines centered on middle C, sometimes
+called a @q{grand staff}, with the bottom line representing low G
+and the top line high F:
+
+@lilypond[ragged-right,quote]
+\score {
+ <<
+%-- Treble Staff --%
+  \new Staff = "G" {
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(-2 . 2)
+% Allow the treble clef to overlap the lower staves:
+%   \override Staff.Clef #'Y-extent = #'(0 . 0)
+   \override Staff.Clef #'stencil = ##f          % No clef required
+   \clef "G"
+   s1^\markup { "g," \transparent "g" }
+   s^ \markup { "b," \transparent "g" }
+   s^ \markup { "d"  \transparent "g" }
+   s^ \markup { "f"  \transparent "g" }
+   s^ \markup { "a"  \transparent "g" }
+   s^ \markup { \with-color #red c' \transparent "g"}
+   e'^\markup { "e'" \transparent "g" }
+   g'^\markup { "g'" \transparent "g" }
+   b'^\markup { "b'" \transparent "g" }
+   d''^\markup { "d''" \transparent "g" }
+   f''^\markup { "f ''" \transparent "g" }
+   s
+  }
+%-- Alto Staff reduced to a single line on middle C --%
+  \new Staff = "C" {
+   \override Staff.StaffSymbol #'line-count = 1  % One line only
+   \override Staff.StaffSymbol #'color = #red    % Coloured red
+   \override Staff.Clef #'stencil = ##f          % No clef required
+   \clef "C"
+
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(0 . 0)
+% Specify height to give correct spacing between treble and bass staves
+   \override Staff.VerticalAxisGroup #'Y-extent = #'(-1 . 1)
+
+   s1 s s s s  % Space along to align horizonatally
+   \override NoteHead #'color = #red
+    c'1 % A middle C
+    s1 s s s s s % Keep staff (ie the red line) showing
+  }
+%-- Bass Staff --%
+  \new Staff = "F" {
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 2)
+   \override Staff.Clef #'stencil = ##f          % No clef required
+   \clef "F"
+   g,1 b, d f a
+   s s s s s s s % Keep staff showing
+  }
+ >>
+ \layout {
+% Reduce horizontal spacing so semibreves can be used without exceeding 1 line
+  \context { \Score \override SpacingSpanner #'base-shortest-duration = #(ly:make-moment 1 1)
+  }
+% Reduce apparent vertical size of note heads to permit them to overlap other grobs vertically
+  \context { \Score \override NoteHead #'Y-extent = #'(0 . 0)
+  }
+% Remove all barlines
+  \context { \Score \override BarLine #'stencil = ##f
+  }
+% Remove time signature from all staves
+  \context { \Staff \remove Time_signature_engraver
+  }
+ }  % End layout
+}  % End score
+@end lilypond
+
+Staves of five lines are usually used, and the clef superimposed on them
+indicates which five lines have been selected from this @samp{grand staff}.
+For example, the treble or G clef indicates that the top five
+lines have been selected:
+
+@lilypond[ragged-right,quote]
+\score {
+ <<
+%-- Treble Staff --%
+  \new Staff = "G" {
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup 
+    #'minimum-Y-extent = #'(0 . 0)
+% Allow the treble clef to overlap the lower staves:
+%   \override Staff.Clef #'Y-extent = #'(0 . 0)
+   \override Staff.Clef #'stencil = ##f  % No clef required here
+   \clef "G"
+   s1^\markup { "g," \transparent "g" }
+   s^ \markup { "b," \transparent "g" }
+   s^ \markup { "d"  \transparent "g" }
+   s^ \markup { "f"  \transparent "g" }
+   s^ \markup { "a"  \transparent "g" }
+   s^ \markup { \with-color #red c' \transparent "g"}
+   \stopStaff \startStaff
+   \clef "C"  % Dummy to force next clef to be printed
+   s  % Need at least one note for \clef to take effect
+   \override Staff.Clef #'stencil = ##t  % Clef now required
+   \override Staff.Clef #'Y-extent = #'(0 . 0)  % Permit overlap
+   \clef "G"
+   e'^\markup { "e'" \transparent "g" }
+   g'^\markup { "g'" \transparent "g" }
+   b'^\markup { "b'" \transparent "g" }
+   d''^\markup { "d''" \transparent "g" }
+   f''^\markup { "f ''" \transparent "g" }
+  }  % End staff G
+%-- Alto Staff reduced to a single line on middle C --%
+  \new Staff = "C" {
+   \override Staff.StaffSymbol #'line-count = 1  % One line only
+   \override Staff.StaffSymbol #'color = #red    % Coloured red
+   \override Staff.Clef #'stencil = ##f      % No clef required
+   \clef "C"
+
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup 
+    #'minimum-Y-extent = #'(0 . 0)
+% Specify height to give correct spacing between the staves
+   \override Staff.VerticalAxisGroup #'Y-extent = #'(-1 . 1)
+
+   s1 s s s s  % Space along to align horizonatally
+   \override NoteHead #'color = #red
+    c'1 % A middle C
+%    s1 s s s s  % Keep staff (ie the red line) showing
+  }  % End staff C
+%-- Bass Staff --%
+  \new Staff = "F" {
+% Allow this staff to be placed close to the others
+   \override Staff.VerticalAxisGroup 
+    #'minimum-Y-extent = #'(0 . 0)
+   \override Staff.Clef #'stencil = ##f     % No clef required
+   \clef "F"
+   g,1_" " b, d f a
+%   s s s s s s  % Keep staff showing
+  }  % End staff F
+ >>
+ \layout {
+% Reduce horizontal spacing so semibreves can be used 
+% without exceeding 1 line
+  \context { \Score \override SpacingSpanner 
+   #'base-shortest-duration = #(ly:make-moment 1 1)
+  }
+% Reduce apparent vertical size of note heads to 
+% permit them to overlap other grobs vertically
+  \context { \Score \override NoteHead #'Y-extent = #'(0 . 0)
+  }
+% Remove all barlines
+  \context { \Score \override BarLine #'stencil = ##f
+  }
+% Remove time signature from all staves
+  \context { \Staff \remove Time_signature_engraver
+  }
+ }  % End layout
+}  % End score
+@end lilypond
+
+The @q{curl} of the G clef in centered on the line that represents the pitch G.
+
+In the same way, the bass or F clef indicates that the bottom five lines
+have been selected from the @samp{grand staff}, and the alto or C clef
+indicates the middle five lines have been selected.  This relationship is
+shown below, where the notes show an arpeggio on a C major chord.
+
+@lilypond[ragged-right,quote]
+\score {
+<<
+%-- Treble Staff --%
+ \new Staff = "G" \with {
+  \remove Time_signature_engraver
+ }
+ {
+% The following two overrides are required to make the two middle C's overlap
+  \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(0 . 0)
+  \override Staff.VerticalAxisGroup #'Y-extent = #'(-2 . 2)
+
+  \override Staff.Clef #'Y-extent = #'(0 . 0)
+  \clef "G"
+  s1 s s s s e' g' c''
+ }
+%-- Alto Staff --%
+ \new Staff = "C" \with {
+  \remove Time_signature_engraver
+ }
+ {
+  \override Staff.StaffSymbol #'line-count = 1
+  \override Staff.StaffSymbol #'stencil = ##f
+  \once \override Staff.Clef #'stencil = ##f
+  \clef "G"  % A frig. This clef is invisible; use G to force the later C clef to be shown
+  \override Score.BarLine #'stencil = ##f
+
+  % The following two overrides are required to align the C staff to the G and F staves
+  \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(0 . 0)
+  \override Staff.VerticalAxisGroup #'Y-extent = #'(-1 . 1)
+
+  s1 s s s
+  \stopStaff \startStaff
+  \override Staff.VerticalAxisGroup #'Y-extent = #'(-1 . 1)
+  \revert Staff.StaffSymbol #'stencil
+  \override Staff.StaffSymbol #'color = #red
+   b'1 % A frig.  This really shows as a middle C in the score
+   s1 s s s
+  \stopStaff \startStaff
+  \override Staff.StaffSymbol #'line-count = 5
+  \override Staff.StaffSymbol #'Y-extent = #'(0 . 0)
+  \override Staff.Clef #'Y-extent = #'(0 . 0)
+  \revert Staff.StaffSymbol #'color
+  \stopStaff \startStaff
+  \clef "C"
+  s1 s s c e g c' e' g' c''
+ }
+%-- Bass Staff --%
+ \new Staff = "F" \with {
+  \remove Time_signature_engraver
+ }
+ {
+  \override Staff.Clef #'Y-extent = #'(0 . 0)
+% The following two overrides are required to make the two middle C's overlap
+  \override Staff.VerticalAxisGroup #'minimum-Y-extent = #'(0 . 0)
+  \override Staff.VerticalAxisGroup #'Y-extent = #'(-2 . 2)
+
+  \clef "F"
+  c1 e g s s s s s
+ }
+>>
+\layout {
+ \context {
+  \Score \override SpacingSpanner #'base-shortest-duration = #(ly:make-moment 2 1)
+  }
+ \context {
+  \Score \override NoteHead #'Y-extent = #'(0 . 0)
+  }
+ \context {
+  \Score \override NoteHead #'minimum-Y-extent = #'(0 . 0)
+ }
+}
+}
+@end lilypond
+
+
 
 @node cluster
 @section cluster
@@ -1248,10 +1662,11 @@ geometrically describes the development of a range of pitches
 geometrical shape of a cluster covers the area in which any single
 pitch contained in the cluster would be notated as an ordinary note.
 
-@lilypond[fragment,relative=2,verbatim,ragged-right]
+@lilypond[fragment,relative=2,ragged-right]
 \makeClusters { <c e> <b f'> <b g'> <c g> <f e> }
 @end lilypond
 
+
 @node comma
 @section comma
 
@@ -1265,12 +1680,20 @@ S: komma,
 FI: komma, korvinkuultava ero äänenkorkeudessa.
 
 Difference in pitch between a note derived from pure tuning and the same note
-derived from some other tuning method.  @aref{temperament}.
+derived from some other tuning method.
+
+@seealso
+
+@ref{temperament}.
+
 
 @node common meter
 @section common meter
 
-@aref{meter}.
+@seealso
+
+@ref{meter}.
+
 
 @node compound interval
 @section compound interval
@@ -1286,7 +1709,10 @@ FI: oktaavia laajempi intervalli.
 
 Intervals larger than an octave.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node complement
 @section complement
@@ -1300,7 +1726,10 @@ DK: komplementærinterval,
 S: komplementärintervall (?),
 FI: täydentävä intervalli.
 
-@aref{inverted interval}.
+@seealso
+
+@ref{inverted interval}.
+
 
 @node conjunct movement
 @section conjunct movement
@@ -1315,13 +1744,14 @@ S: stegvis rörelse,
 FI: asteittainen liike.
 
 Progressing melodically by intervals of a second.  The opposite of a
-@aref{disjunct movement}.
+@ref{disjunct movement}.
 
 @lilypond[fragment,line-width=13.0\cm]
 \key g \major \time 4/4
 \relative c'' { g4 g g a | b2 a | g4 b a a | g1 \bar "||" }
 @end lilypond
 
+
 @node consonance
 @section consonance
 
@@ -1334,7 +1764,10 @@ DK: konsonans,
 S: konsonans,
 FI: konsonanssi, sopusointi.
 
-@aref{harmony}.
+@seealso
+
+@ref{harmony}.
+
 
 @node contralto
 @section contralto
@@ -1348,7 +1781,10 @@ DK: alt,
 S: alt,
 FI: kontra-altto.
 
-@aref{alto}.
+@seealso
+
+@ref{alto}.
+
 
 @node counterpoint
 @section counterpoint
@@ -1408,6 +1844,7 @@ composition methods.
 >>
 @end lilypond
 
+
 @node counter tenor
 @section counter tenor
 
@@ -1420,7 +1857,10 @@ DK: kontratenor,
 S: kontratenor, counter tenor,
 FI: kontratenori.
 
-@aref{contralto}.
+@seealso
+
+@ref{contralto}.
+
 
 @node copying music
 @section copying music
@@ -1431,6 +1871,7 @@ on stems) varied slightly from those of engravers.  Some of their working
 methods were superior and could well be adopted by music typesetters.  This
 required more skill than engraving.
 
+
 @node crescendo
 @section crescendo
 
@@ -1444,19 +1885,20 @@ S: crescendo,
 FI: cresendo, voimistuen.
 
 Increasing volume.  Indicated by a rightwards opening horizontal wedge or the
-abbreviation @q{cresc.}.
+abbreviation @samp{cresc.}.
 
 @lilypond[fragment,ragged-right]
 \key g \major \time 4/4
 \relative c'' { g4 \< a b c | d1\! \bar "|." }
 @end lilypond
 
+
 @node cue-notes
 @section cue-notes
 
 ES: notas guía,
 I: notine,
-F: petites notes précédent l'entrée d'in instrument, réplique,
+F: petites notes précédent l'entrée d'un instrument, réplique,
 D: Stichnoten,
 NL: stichnoten,
 DK: stiknoder,
@@ -1466,6 +1908,7 @@ FI: vihjenuotit.
 In a separate part notes belonging to another part with the purpose of hinting
 when to start playing.  Usually printed in a smaller type.
 
+
 @node custos
 @section custos
 
@@ -1504,6 +1947,7 @@ of the 20th century
 }
 @end lilypond
 
+
 @node D
 @section D
 
@@ -1516,6 +1960,11 @@ DK: d,
 S: d,
 FI: D, d.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node da capo
 @section da capo
 
@@ -1529,7 +1978,8 @@ S: da capo,
 FI: da capo, alusta.
 
 The term indicates repetition of the piece from the beginning to the end or
-to a certain place marked @emph{fine}.  Mostly abbreviated as @q{D.C.}.
+to a certain place marked @emph{fine}.  Mostly abbreviated as @samp{D.C.}.
+
 
 @node dal segno
 @section dal segno
@@ -1543,7 +1993,7 @@ DK: dal segno,
 S: dal segno,
 FI: dal segno, lähtien merkistä.
 
-Abbreviated @q{d.s.}.  Repetition, not from the beginning, but from
+Abbreviated @samp{D.S.}.  Repetition, not from the beginning, but from
 another place frequently near the beginning marked by a sign:
 
 @lilypond[fragment,ragged-right]
@@ -1559,6 +2009,7 @@ another place frequently near the beginning marked by a sign:
 }
 @end lilypond
 
+
 @node decrescendo
 @section decrescendo
 
@@ -1571,7 +2022,7 @@ S: decrescendo,
 FI: decresendo, hiljentyen.
 
 Decreasing tone volume.  Indicated by a leftwards opening horizontal wedge
-or the abbreviation @q{decresc.}.
+or the abbreviation @samp{decresc.}.
 
 @lilypond[fragment,ragged-right]
 \relative c'' {
@@ -1580,6 +2031,7 @@ or the abbreviation @q{decresc.}.
 }
 @end lilypond
 
+
 @node descending interval
 @section descending interval
 
@@ -1594,6 +2046,7 @@ FI: laskeva intervalli.
 
 A distance between a starting higher note and a lower ending note.
 
+
 @node diatonic scale
 @section diatonic scale
 
@@ -1606,8 +2059,8 @@ DK: diatonisk skala,
 S: diatonisk skala,
 FI: diatoninen asteikko.
 
-A scale consisting of 5@w{ }@aref{whole tone}s and
-2@w{ }@aref{semitone}s (S).  Scales played on the white keys
+A scale consisting of 5@w{ }@ref{whole tone}s and
+2@w{ }@ref{semitone}s (S).  Scales played on the white keys
 of a piano keybord are diatonic.
 
 The church modes are used in gregorial chant and in pre-baroque early
@@ -1763,6 +2216,7 @@ harmonic minor scale type an augmented second (A) occurs between the 6th and
 >>
 @end lilypond
 
+
 @node diminished interval
 @section diminished interval
 
@@ -1775,7 +2229,10 @@ DK: formindsket interval,
 S: förminskat intervall,
 FI: vähennetty intervalli.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node diminuendo
 @section diminuendo
@@ -1789,7 +2246,27 @@ DK: diminuendo,
 S: diminuendo,
 FI: diminuendo, hiljentyen.
 
-@aref{decrescendo}.
+@seealso
+
+@ref{decrescendo}.
+
+
+@node direct
+@section direct
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+@seealso
+
+@ref{custos}.
+
 
 @node disjunct movement
 @section disjunct movement
@@ -1804,7 +2281,7 @@ S: hoppande rörelse,
 FI: melodian hyppivä liike.
 
 Progressing melodically by intervals larger than a major second.
-Opposite of @aref{conjunct movement}.
+Opposite of @ref{conjunct movement}.
 
 @lilypond[fragment,ragged-right]
 \key a \major
@@ -1815,11 +2292,13 @@ Opposite of @aref{conjunct movement}.
   fis2 d4. \bar "||" }
 @end lilypond
 
+
 @node dissonance
 @section dissonance
 
 @ref{dissonant interval}.
 
+
 @node dissonant interval
 @section dissonant interval
 
@@ -1832,7 +2311,10 @@ DK: dissonerende interval, dissonans,
 S: dissonans,
 FI: dissonanssi, dissonoiva intervalli, riitasointi.
 
-@aref{harmony}.
+@seealso
+
+@ref{harmony}.
+
 
 @node dominant ninth chord
 @section dominant ninth chord
@@ -1846,7 +2328,10 @@ DK: dominantnoneakkord,
 S: dominantnonackord,
 FI: dominanttinoonisointu.
 
-@aref{chord}, @aref{functional harmony}.
+@seealso
+
+@ref{chord}, @ref{functional harmony}.
+
 
 @node dominant seventh chord
 @section dominant seventh chord
@@ -1860,7 +2345,10 @@ DK: dominantseptimakkord,
 S: dominantseptimackord,
 FI: dominanttiseptimisointu.
 
-@aref{chord}, @aref{functional harmony}.
+@seealso
+
+@ref{chord}, @ref{functional harmony}.
+
 
 @node dominant
 @section dominant
@@ -1874,8 +2362,8 @@ DK: dominant,
 S: dominant,
 FI: dominantti, huippusointu.
 
-The fifth @aref{scale degree},
-@aref{functional harmony}.
+The fifth @ref{scale degree} in @ref{functional harmony}.
+
 
 @node dorian mode
 @section dorian mode
@@ -1889,7 +2377,10 @@ DK: dorisk skala,
 S: dorisk tonart,
 FI: doorinen moodi.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
 
 @node dot (augmentation dot)
 @section dot (augmentation dot)
@@ -1903,7 +2394,12 @@ DK: punkt,
 S: punkt,
 FI: piste.
 
-@aref{dotted note}.
+@c TODO: fix double redirect -- to "dotted note", and thence to "note value"?
+
+@seealso
+
+@ref{dotted note}.
+
 
 @node dotted note
 @section dotted note
@@ -1917,7 +2413,10 @@ DK: punkteret node,
 S: punkterad not,
 FI: pisteellinen nuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node double appoggiatura
 @section double appoggiatura
@@ -1931,7 +2430,10 @@ DK: dobbelt forslag,
 S: dubbelslag,
 FI: kaksoisappogiatura, kaksoisetuhele.
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node double bar line
 @section double bar line
@@ -1947,6 +2449,7 @@ FI: kaksoistahtiviiva.
 
 Indicates the end of a section within a movement.
 
+
 @node double dotted note
 @section double dotted note
 
@@ -1959,7 +2462,10 @@ DK: dob@-belt@-punk@-te@-ret node,
 S: dub@-bel@-punk@-te@-rad not,
 FI: kaksoispisteellinen nuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node double flat
 @section double flat
@@ -1973,7 +2479,10 @@ DK: dob@-belt-b,
 S: dubbelbe,
 FI: kaksoisalennusmerkki.
 
-@aref{accidental}.
+@seealso
+
+@ref{accidental}.
+
 
 @node double sharp
 @section double sharp
@@ -1987,7 +2496,10 @@ DK: dob@-belt@-kryds,
 S: dubbelkors,
 FI: kaksoisylennysmerkki.
 
-@aref{accidental}.
+@seealso
+
+@ref{accidental}.
+
 
 @node double trill
 @section double trill
@@ -2003,6 +2515,7 @@ FI: kaksoistrilli.
 
 A simultaneous trill on two notes, usually in the distance of a third.
 
+
 @node duple meter
 @section duple meter
 
@@ -2015,7 +2528,10 @@ DK: todelt takt,
 S: tvåtakt,
 FI: kaksoistempo.
 
-@aref{meter}.
+@seealso
+
+@ref{meter}.
+
 
 @node duplet
 @section duplet
@@ -2029,7 +2545,10 @@ DK: duol,
 S: duol,
 FI: duoli.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node duration
 @section duration
@@ -2043,12 +2562,39 @@ DK: varighed,
 S: tonlängd,
 FI: kesto, aika-arvo.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node dydimic comma
 @section dydimic comma
 
-@aref{syntonic comma}.
+@seealso
+
+@ref{syntonic comma}.
+
+
+@node dynamics
+@section dynamics
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+The aspect of music relating to degrees of loudness, or changes from one
+degree to another.  The terms, abbreviations, and symbols used to indicate
+this information are called dynamic marks.
+
+@seealso
+
+@ref{piano}, @ref{forte}, @ref{crescendo}, @ref{decrescendo}, @ref{diminuendo}.
+
 
 @node E
 @section E
@@ -2062,10 +2608,18 @@ DK: e,
 S: e,
 FI: E, e.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node ecclesiastical mode
 @section ecclesiastical mode
 
-@aref{church mode}.
+@seealso
+
+@ref{church mode}.
+
 
 @node eighth note
 @section eighth note
@@ -2080,7 +2634,10 @@ DK: ottendedelsnode,
 S: åttondelsnot,
 FI: kahdeksasosanuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node eighth rest
 @section eighth rest
@@ -2095,13 +2652,24 @@ DK: ottendedelspause,
 S: åttonddelspaus,
 FI: kahdeksasosatauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
+
+@node elision
+@section elision
+
+FIXME: languages, definition
+
 
 @node embellishment
 @section embellishment
 
+@seealso
+
+@ref{ornament}.
 
-@aref{ornament}.
 
 @node engraving
 @section engraving
@@ -2122,6 +2690,7 @@ similar to drafting or engineering drawing, using similar tools.
 The traditional process of music printing is done through cutting in a
 plate of metal.  Now also the term for the art of music typesetting.
 
+
 @node enharmonic
 @section enharmonic
 
@@ -2150,6 +2719,7 @@ but equal pitch.
 >>
 @end lilypond
 
+
 @node equal temperament
 @section equal temperament
 
@@ -2162,8 +2732,13 @@ DK: ligesvævende temperatur,
 S: liksvävande temperatur,
 FI: tasavireinen.
 
-Tuning system dividing the octave into 12 equal @aref{semitone}s
-(precisely 100 @aref{cent}s).  @aref{temperament}.
+Tuning system dividing the octave into 12 equal @ref{semitone}s
+(precisely 100 @ref{cent}s).
+
+@seealso
+
+@ref{temperament}.
+
 
 @node expression mark
 @section expression mark
@@ -2178,27 +2753,90 @@ S: föredragsbeteckning,
 FI: nyanssiosoitus, esitysmerkki.
 
 Performance indications concerning 1. volume, dynamics (for example
-@aref{forte}, @aref{crescendo}), 2. tempo (for example
-@aref{andante}, @aref{allegro}).
+@ref{forte}, @ref{crescendo}), 2. tempo (for example
+@ref{andante}, @ref{allegro}).
 
-@node F
-@section F
 
-ES: fa,
-I: fa,
-F: fa,
-D: F, f,
-NL: f,
-DK: f,
-S: f,
-FI: F, f.
+@node extender line
+@section extender line
+
+FIXME: add languages
+
+ES: línea de extención [de melisma, de bajo cifrado, etc.],
+I: ?,
+F: ligne d'extension [de mélisme, de basse chiffrée, etc.],
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: .
+
+The generic term for a line (or dash) of arbitrary length that
+extends text (without indicating the musical @emph{function} of
+that text).
+
+Used in many contexts, for example:
+
+@itemize
+@item
+In vocal music to indicate the syllable for a melisma.  Called @q{extension}
+in the
+@uref{http://www.dolmetsch.com/defse1.htm,Dolmetsch Online Music Dictionary}.
+
+@item
+In figured (or thorough) bass to indicate that:
+
+	@itemize
+
+	@item The extended note should be held through a change in
+		harmony, when applied to one figure --OR--
+
+	@item The chord thus represented should be held above a moving
+		bass line, when applied to more than one figure.
+
+	@item These uses were not completely standardized, and some
+		composers used a single extender line to indicate the
+		latter case.
+
+	@end itemize
+
+@item
+In string music to indicate that all notes in the passage thus indicated
+should be played on the same string.  On the violin, for example, a series
+of notes to be played on the G string would be indicated @samp{sul G},
+another series to be played on the D string would be indicated @samp{sul D},
+and so on.
+
+@end itemize
+
+@seealso
+
+@ref{melisma}, @ref{sul G}, @ref{thorough bass}
+
+
+@node F
+@section F
+
+ES: fa,
+I: fa,
+F: fa,
+D: F, f,
+NL: f,
+DK: f,
+S: f,
+FI: F, f.
+
+@seealso
+
+@ref{Pitch names}
+
 
 @node F clef
 @section F clef
 
 ES: clave de fa,
 I: chiave di fa,
-F: clé de fa,
+F: clef de fa,
 D: F-Schlüssel,
 NL: F-sleutel,
 DK: F-nøgle,
@@ -2208,9 +2846,9 @@ FI: F-avain.
 The position between the dots of the key symbol is the line of the F below
 central@w{ }C.  Used on the third, fourth and fifth note line.  A
 digit@w{ }8 above the clef symbol indicates that the notes must be played
-an octave higher (for example bass recorder) while 8@w{ }below the clef
-symbol indicates playing an octave lower (for example on double bass
-@aref{strings}).
+an octave higher (for example, bass recorder) while 8@w{ }below the clef
+symbol indicates playing an octave lower (for example, on double bass
+@ref{strings}).
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -2229,17 +2867,44 @@ symbol indicates playing an octave lower (for example on double bass
   f1
 }
  \lyrics {
-  "baritone  "
+  "varbaritone  "
   "bass  "
   "sub-bass  "
-  "octaved up  "
-  "octaved down"
+  "octave up  "
+  "octave down"
 }
 >>
 @end lilypond
 
+@seealso
+
+@ref{baritone clef}
+
 @c F:  'point d'orgue' on a note, 'point d'arret' on a rest.
 
+
+@node feathered beam
+@section feathered beam
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+A type of beam used to indicate that a small group of notes should be
+played at an increasing or decreasing tempo -- depending on the
+direction of @q{feathering} -- but without changing the overall tempo
+of the piece.
+
+@seealso
+
+Program reference: @ruser{Manual beams}
+
+
 @node fermata
 @section fermata
 
@@ -2261,6 +2926,7 @@ Prolonged note or rest of indefinite duration.
 }
 @end lilypond
 
+
 @node fifth
 @section fifth
 
@@ -2273,12 +2939,18 @@ DK: kvint,
 S: kvint,
 FI: kvintti.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node figured bass
 @section figured bass
 
-@aref{thorough bass}.
+@seealso
+
+@ref{thorough bass}.
+
 
 @node fingering
 @section fingering
@@ -2294,6 +2966,7 @@ FI: sormitus.
 
 The methodical use of fingers in the playing of instruments.
 
+
 @node flag
 @section flag
 
@@ -2308,7 +2981,7 @@ FI: lippu, viiri.
 
 Ornament at the end of the stem of a note used for notes with values
 less than a quarter note.  The number of flags determines the
-@aref{note value}.
+@ref{note value}.
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
@@ -2321,6 +2994,7 @@ less than a quarter note.  The number of flags determines the
 }
 @end lilypond
 
+
 @node flat
 @section flat
 
@@ -2333,12 +3007,18 @@ DK: b,
 S: beförtecken,
 FI: alennusmerkki.
 
-@aref{accidental}.
+@seealso
+
+@ref{accidental}.
+
 
 @node forefall
 @section forefall
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node forte
 @section forte
@@ -2352,8 +3032,9 @@ DK: forte,
 S: forte,
 FI: forte, voimakkaasti.
 
-Loud, abbreviated @b{f}, @emph{fortissimo} (@b{ff}) very loud,
-@emph{mezzoforte} (@b{mf}) medium loud.
+Loud, abbreviated @samp{@b{f}}, @emph{fortissimo} (@samp{@b{ff}}) very loud,
+@emph{mezzo forte} (@samp{@b{mf}}) medium loud.
+
 
 @node fourth
 @section fourth
@@ -2367,7 +3048,10 @@ DK: kvart,
 S: kvart,
 FI: kvartti.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node fugue
 @section fugue
@@ -2381,7 +3065,10 @@ DK: fuga,
 S: fuga,
 FI: fuuga.
 
-@aref{counterpoint}.
+@seealso
+
+@ref{counterpoint}.
+
 
 @node functional harmony
 @section functional harmony
@@ -2412,6 +3099,7 @@ variants of the base chords.
 >>
 @end lilypond
 
+
 @node G
 @section G
 
@@ -2424,12 +3112,17 @@ DK: g,
 S: g,
 FI: G, g.
 
+@seealso
+
+@ref{Pitch names}
+
+
 @node G clef
 @section G clef
 
 ES: clave de sol,
 I: chiave di sol,
-F: clé de sol,
+F: clef de sol,
 D: G-Schlüssel, Violinschlüssel,
 NL: G-sleutel,
 DK: g-nøgle,
@@ -2462,12 +3155,13 @@ scores are notated like that).
     \override Lyrics . LyricText #'X-offset = #-5
     "french violin clef"
     "violin clef"
-    "octaved up"
-    "octaved down"
+    "octave up"
+    "octave down"
   }
 >>
 @end lilypond
 
+
 @node glissando
 @section glissando
 
@@ -2482,6 +3176,7 @@ FI: glissando, liukuen.
 
 Letting the pitch slide fluently from one note to the other.
 
+
 @node grace notes
 @section grace notes
 
@@ -2495,7 +3190,10 @@ S: ornament,
 FI: korunuotit.
 
 Notes printed in small types to indicate that their time values are not
-counted in the rhythm of the bar.  @aref{appoggiatura}.
+counted in the rhythm of the bar.
+
+@ref{appoggiatura}.
+
 
 @node grand staff
 @section grand staff
@@ -2509,10 +3207,13 @@ DK: klaversystem,
 S: ackolad, böjd klammer,
 FI: kaksoisnuottiviivasto.
 
-@aref{brace}.
-
 A combination of two staves with a brace.  Usually used for piano music.
 
+@seealso
+
+@ref{brace}.
+
+
 @node grave
 @section grave
 
@@ -2527,10 +3228,34 @@ FI: grave, raskaasti.
 
 Slow, solemn.
 
+
 @node gruppetto
 @section gruppetto
 
-@aref{turn}.
+@seealso
+
+@ref{turn}.
+
+
+@node H
+@section H
+
+ES: si,
+I: si,
+F: si,
+D: H, h,
+NL: b,
+DK: h,
+S: h,
+FI: H, h.
+
+Letter name used for @samp{B natural} in German and Scandinavian usage.  In the
+standard usage of these countries, @samp{B} means @samp{B flat}.
+
+@seealso
+
+@ref{Pitch names}, @ref{B}
+
 
 @node half note
 @section half note
@@ -2545,7 +3270,10 @@ DK: halvnode,
 S: halvnot,
 FI: puolinuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node half rest
 @section half rest
@@ -2560,7 +3288,10 @@ DK: halvnodespause,
 S: halvpaus,
 FI: puolitauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node harmonic cadence
 @section harmonic cadence
@@ -2575,7 +3306,9 @@ S: (harmonisk) kadens,
 FI: harmoninen kadenssi.
 
 A sequence of chords that terminates a musical phrase or
-section.  @aref{functional harmony}.
+section.
+
+@ref{functional harmony}.
 
 @lilypond[fragment,ragged-right]
 \context PianoStaff <<
@@ -2600,6 +3333,7 @@ section.  @aref{functional harmony}.
 
 @end lilypond
 
+
 @node harmony
 @section harmony
 
@@ -2621,7 +3355,7 @@ Consonances:
 \set Score.automaticBars = ##f
 %\override Score.TextScript #'font-style = #'large
 \context Voice \relative c'' {
-  <g g>1_"unisone  " s
+  <g g>1_"unison  " s
   <g b>_"third  " s
   <g c>_"fourth  " s
   <g d'>_"fifth  " s
@@ -2643,7 +3377,8 @@ Dissonances:
 }
 @end lilypond
 
-Three note harmony @aref{chord}.
+Three note harmony @ref{chord}.
+
 
 @node homophony
 @section homophony
@@ -2658,7 +3393,8 @@ S: homofoni,
 FI: homofonia, yksiäänisyys.
 
 Music in which one voice leads melodically followed by the other voices more
-or less in the same rhythm.  In contrast to @aref{polyphony}.
+or less in the same rhythm.  In contrast to @ref{polyphony}.
+
 
 @node interval
 @section interval
@@ -2673,11 +3409,10 @@ S: intervall,
 FI: intervalli, kahden sävelen korkeusero.
 
 Difference in pitch between two notes.  Intervals may be perfect, minor,
-major,
-diminished, or augmented.  The augmented fourth and the diminished fifth are
-identical (@aref{enharmonic}) and are called @emph{tritonus}
-because they consist of three @aref{whole tone}s.  The addition
-of such two intervals forms an octave.
+major, diminished, or augmented.  The augmented fourth and the diminished fifth
+are identical (@ref{enharmonic}) and are called @emph{tritonus} because they
+consist of three @ref{whole tone}s.  The addition of such two intervals forms an
+octave.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -2693,7 +3428,7 @@ of such two intervals forms an octave.
   < g bis >^"augm" 
 }
 \context Lyrics \lyrics {
-  "unisone " "second " "second " "second "
+  "unison " "second " "second " "second "
   "third  " "third " "third " "third"
 }
 >>
@@ -2704,13 +3439,13 @@ of such two intervals forms an octave.
 <<
 \context Staff \relative c'' {
   < g c >1^"perfect" 
-  < g cis >^"augm" 
+  < g cis >^"aug" 
   < g d' >^"perfect" 
-  < g des' > ^"dimin" 
-  < gis es' >^"dimin" 
+  < g des' > ^"dim" 
+  < gis es' >^"dim" 
   < g! es' >^"minor" 
   < g e'! >^"major" 
-  < g eis' >^"augm" 
+  < g eis' >^"aug" 
 }
  \lyrics {
   "fourth  " "fourth  " "fifth  " "fifth  "
@@ -2739,6 +3474,7 @@ of such two intervals forms an octave.
 >>
 @end lilypond
 
+
 @node inverted interval
 @section inverted interval
 
@@ -2763,6 +3499,7 @@ The difference between an interval and an octave.
 }
 @end lilypond
 
+
 @node just intonation
 @section just intonation
 
@@ -2776,7 +3513,10 @@ S: ren stämning,
 FI: puhdas viritys.
 
 Tuning system in which the notes are obtained by adding and subtracting
-natural fifths and thirds.  @aref{temperament}.
+natural fifths and thirds.
+
+@ref{temperament}.
+
 
 @node key
 @section key
@@ -2790,9 +3530,13 @@ DK: toneart,
 S: tonart,
 FI: tonaliteetti.
 
-According to the 12@w{ }tones of the @aref{chromatic scale}
+According to the 12@w{ }tones of the @ref{chromatic scale}
 there are 12@w{ }keys, one on@w{ }c, one on c-sharp, etc.
-@aref{key signature}.
+
+@seealso
+
+@ref{key signature}.
+
 
 @node key signature
 @section key signature
@@ -2807,7 +3551,10 @@ S: tonartssignatur,
 FI: sävellajiosoitus.
 
 The sharps or flats appearing at the beginning of each staff indicating the
-key of the music.  @aref{accidental}.
+key of the music.
+
+@ref{accidental}.
+
 
 @node largo
 @section largo
@@ -2824,6 +3571,7 @@ FI: largo, hitaasti, leveästi.
 Very slow in tempo, usually combined with great
 expressiveness.  @emph{Larghetto} is less slow than largo.
 
+
 @node leading note
 @section leading note
 
@@ -2836,10 +3584,11 @@ DK: ledetone,
 S: ledton,
 FI: johtosävel.
 
-The seventh @aref{scale degree}, a @aref{semitone} below
+The seventh @ref{scale degree}, a @ref{semitone} below
 the tonic; so called because of its strong tendency to @q{lead up} (resolve
 upwards) to the tonic scale degree.
 
+
 @node ledger line
 @section ledger line
 
@@ -2859,6 +3608,7 @@ A ledger line is an extension of the staff.
 \relative c'' { a,1 s c'' }
 @end lilypond
 
+
 @node legato
 @section legato
 
@@ -2873,7 +3623,7 @@ FI: legato, sitoen.
 
 To be performed (a) without any perceptible interruption between the notes,
 unlike (b) @emph{leggiero} or @emph{non-legato}, (c) @emph{portato}, and
-(d) @aref{staccato}.
+(d) @ref{staccato}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -2893,15 +3643,22 @@ unlike (b) @emph{leggiero} or @emph{non-legato}, (c) @emph{portato}, and
 >>
 @end lilypond
 
+
 @node legato curve
 @section legato curve
 
-@aref{slur}, @aref{legato}.
+@seealso
+
+@ref{slur}, @ref{legato}.
+
 
 @node leger line
 @section leger line
 
-@aref{ledger line}.
+@seealso
+
+@ref{ledger line}.
+
 
 @node lilypond
 @section lilypond
@@ -2918,6 +3675,7 @@ FI: liljalampi.
 
 A pond with lilies floating in it, also the name of a music typesetter.
 
+
 @node ligature
 @section ligature
 
@@ -2932,6 +3690,7 @@ soon denoted also the way of performance in the sense of articulation.
 With the invention of the metric system of the white mensural
 notation, the need for ligatures to denote such patterns disappeared.
 
+
 @node line
 @section line
 
@@ -2944,7 +3703,10 @@ DK: nodelinie,
 S: notlinje,
 FI: viiva, nuottiviiva.
 
-@aref{staff}.
+@seealso
+
+@ref{staff}.
+
 
 @node long appoggiatura
 @section long appoggiatura
@@ -2958,7 +3720,10 @@ DK: langt forslag,
 S: långt förslag,
 FI: pitkä appoggiatura, pitkä etuhele.
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node longa
 @section longa
@@ -2972,8 +3737,7 @@ DK: longa,
 S: longa,
 FI: longa.
 
-Note value: double length of @aref{breve}.
-@aref{note value}.
+Note value: double length of @ref{breve}.
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
@@ -2983,6 +3747,11 @@ Note value: double length of @aref{breve}.
 }
 @end lilypond
 
+@seealso
+
+@ref{note value}.
+
+
 @node lyrics
 @section lyrics
 
@@ -2995,6 +3764,17 @@ DK: .,
 S: .,
 FI, sanoitus.
 
+
+@node lyric tie
+@section lyric tie
+
+FIXME: add languages
+
+@seealso
+
+@ref{elision}.
+
+
 @node major interval
 @section major interval
 
@@ -3007,7 +3787,10 @@ DK: stort interval,
 S: stort intervall,
 FI: suuri intervalli.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node major
 @section major
@@ -3021,7 +3804,10 @@ DK: dur,
 S: dur,
 FI: duuri.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
 
 @node meantone temperament
 @section meantone temperament
@@ -3036,10 +3822,11 @@ S: medeltonstemperatur,
 FI: keskisävelviritys.
 
 Temperament yielding acoustically pure thirds by decreasing the natural fifth
-by 16@w{ }@aref{cent}s.  Due to the non-circular character of this
-@aref{temperament} only a limited set of keys are playable.
+by 16@w{ }@ref{cent}s.  Due to the non-circular character of this
+@ref{temperament} only a limited set of keys are playable.
 Used for tuning keyboard instruments for performance of pre-1650 music.
 
+
 @node measure
 @section measure
 
@@ -3052,10 +3839,13 @@ DK: takt,
 S: takt,
 FI: tahti.
 
-A group of @aref{beat}s (units of musical time) the first of which
+A group of @ref{beat}s (units of musical time) the first of which
 bears an accent.  Such groups in numbers of two or more recur consistently
 throughout the composition and are marked from each other by
-bar-lines.  @aref{meter}.
+bar-lines.
+
+@ref{meter}.
+
 
 @node mediant
 @section mediant
@@ -3070,10 +3860,13 @@ S: mediant,
 FI: keskisävel.
 
 1.@tie{}The third @b{scale degree}.
-2.@tie{}A @aref{chord} having its base tone
+2.@tie{}A @ref{chord} having its base tone
 a third from that of another chord.  For example, the tonic chord may be
-replaced by its lower mediant (variant tonic).  @aref{functional
-harmony}, @aref{relative key}.
+replaced by its lower mediant (variant tonic).
+
+@ref{functional
+harmony}, @ref{relative key}.
+
 
 @node melisma
 @section melisma
@@ -3086,10 +3879,24 @@ FI: melisma, laulettavan tavun sävelkuvio.
 A melisma (plural: melismata) is a group of notes or tones sung on one
 syllable in plainsong
 
+
+@node melisma line
+@section melisma line
+
+FIXME: add languages
+
+@seealso
+
+@ref{extender line}.
+
+
 @node melodic cadence
 @section melodic cadence
 
-@aref{cadenza}.
+@seealso
+
+@ref{cadenza}.
+
 
 @node meter
 @section meter
@@ -3103,14 +3910,14 @@ DK: taktart,
 S: taktart,
 FI: aika-arvo.
 
-The basic scheme of @aref{note value}s and
-@aref{accent}s which remains unaltered throughout a composition
-or a section of it.  For instance, 3/4 meter means that the basic
-@aref{note value}s are quarter notes and that a
-@aref{measure} consists of three of those.  According to
-whether there are two, three, or four units to the measure,
-one speaks of @emph{duple} (2/2, 2/4, 2/8), @emph{triple} (3/2, 3/4, 3/8), or
-@emph{quadruple} (4/2, 4/4, 4/8) meter.  4/4 is also called common meter.
+The basic scheme of @ref{note value}s and @ref{accent}s which remains
+unaltered throughout a composition or a section of it.  For instance,
+3/4 meter means that the basic @ref{note value}s are quarter notes and
+that a @ref{measure} consists of three of those.  According to whether
+there are two, three, or four units to the measure, one speaks of
+@emph{duple} (2/2, 2/4, 2/8), @emph{triple} (3/2, 3/4, 3/8), or
+@emph{quadruple} (4/2, 4/4, 4/8) meter.  4/4 is also called common
+meter.
 
 @lilypond[fragment,line-width=13.0\cm]
 \relative c'' {
@@ -3135,6 +3942,7 @@ one speaks of @emph{duple} (2/2, 2/4, 2/8), @emph{triple} (3/2, 3/4, 3/8), or
   g8 g16 g g8 g16 g g8 fis16 g a8 fis16 e d4 \bar "||"}
 @end lilypond
 
+
 @node metronome
 @section metronome
 
@@ -3147,9 +3955,12 @@ DK: me@-tro@-nom,
 S: me@-tro@-nom,
 FI: metronomi.
 
-Device indicating the exact tempo of a piece.  @aref{metronomic
+Device indicating the exact tempo of a piece.
+
+@ref{metronomic
 indication}.
 
+
 @node metronomic indication
 @section metronomic indication
 
@@ -3165,6 +3976,7 @@ FI: metronomiosoitus.
 Exact tempo indication (in beats per minute).  Also denoted by
 M.M.@: (Mälzels Metronom).
 
+
 @node mezzo-soprano
 @section mezzo-soprano
 
@@ -3177,8 +3989,8 @@ DK: mezzosopran,
 S: mezzosopran,
 FI: mezzosopraano.
 
-The female voice between @aref{soprano} and
-@aref{contralto}.
+The female voice between @ref{soprano} and @ref{contralto}.
+
 
 @node middle C
 @section middle C
@@ -3204,6 +4016,7 @@ First C below the 440 Hz A.
 }
 @end lilypond
 
+
 @node minor
 @section minor
 
@@ -3216,7 +4029,10 @@ DK: mol,
 S: moll,
 FI: molli.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
 
 @node minor interval
 @section minor interval
@@ -3230,7 +4046,10 @@ DK: lille interval,
 S: litet intervall,
 FI: pieni intervalli.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node mode
 @section mode
@@ -3244,7 +4063,10 @@ DK: skala,
 S: modus, skala,
 FI: moodi, kirkkosävelasteikko.
 
-@aref{church mode}, @aref{diatonic scale}.
+@seealso
+
+@ref{church mode}, @ref{diatonic scale}.
+
 
 @node modulation
 @section modulation
@@ -3258,11 +4080,12 @@ DK: modulation,
 S: modulering,
 FI: modulaatio, sävellajin vaihdos.
 
-Moving from one @aref{key} to another.  For example, the second
-subject of a @aref{sonata form} movement modulates to the dominant
-key if the key is major and to the @aref{relative key} if the key
+Moving from one @ref{key} to another.  For example, the second
+subject of a @ref{sonata form} movement modulates to the dominant
+key if the key is major and to the @ref{relative key} if the key
 is minor.
 
+
 @node mordent
 @section mordent
 
@@ -3274,12 +4097,18 @@ DK: mordent,
 S: mordent,
 FI: mordent, korukuvio.
 
-@aref{ornament}.
+@seealso
+
+@ref{ornament}.
+
 
 @node motif
 @section motif
 
-@aref{motive}.
+@seealso
+
+@ref{motive}.
+
 
 @node motive
 @section motive
@@ -3314,6 +4143,7 @@ subject.
 }
 @end lilypond
 
+
 @node movement
 @section movement
 
@@ -3326,10 +4156,11 @@ DK: sats,
 S: sats,
 FI: osa.
 
-Greater musical works like @aref{symphony} and
-@aref{sonata} most often consist of several -- more or less --
+Greater musical works like @ref{symphony} and
+@ref{sonata} most often consist of several -- more or less --
 independant pieces called movements.
 
+
 @node multibar rest
 @section multibar rest
 
@@ -3350,10 +4181,14 @@ FI: usean tahdin mittainen tauko.
 }
 @end lilypond
 
+
 @node mixolydian mode
 @section mixolydian mode
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
 
 @node natural sign
 @section natural sign
@@ -3367,12 +4202,18 @@ DK: op@-løsningstegn,
 S: återställningstecken,
 FI: palautusmerkki.
 
-@aref{accidental}.
+@seealso
+
+@ref{accidental}.
+
 
 @node neighbour tones
 @section neighbour tones
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node ninth
 @section ninth
@@ -3386,12 +4227,18 @@ DK: none,
 S: nona,
 FI: nooni.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node non-legato
 @section non-legato
 
-@aref{legato}.
+@seealso
+
+@ref{legato}.
+
 
 @node note
 @section note
@@ -3408,9 +4255,10 @@ FI: nuotti.
 Notes are signs by means of which music is fixed in writing.  The term is also
 used for the sound indicated by a note, and even for the key of the piano
 which produces the sound.  However, a clear distinction between the terms tone
-and @aref{note} is strongly recommended.  Briefly, one sees a note,
+and @ref{note} is strongly recommended.  Briefly, one sees a note,
 and hears a tone.
 
+
 @node note head
 @section note head
 
@@ -3424,12 +4272,13 @@ S: nothuvud,
 FI: nuotin pää.
 
 A head-like sign which indicates pitch by its position on a
-@aref{staff} provided with a @aref{clef}, and duration
+@ref{staff} provided with a @ref{clef}, and duration
 by a variety of shapes such as hollow or black heads with or without
-@aref{stem}s, @aref{flag}s, etc.  For percussion
+@ref{stem}s, @ref{flag}s, etc.  For percussion
 instruments (often having no defined pitch) the note head may indicate the
 instrument.
 
+
 @node note value
 @section note value
 
@@ -3442,11 +4291,13 @@ DK nodeværdi,
 S: notvärde,
 FI: nuotin aika-arvo.
 
-Note values (durations) are measured as fractions, normally 1/2, of the next
-higher note value.  The longest duration normally used is called
-@emph{brevis},
-but sometimes (mostly in pre-baroque music) the double length note value
-@emph{longa} is used.
+Note values (durations) are measured as fractions, normally 1/2, of
+the next higher note value.  The longest duration normally used is
+called @emph{brevis}, but sometimes (mostly in pre-baroque music) the
+double-length note value @emph{longa} or the quadruple-length note
+value @emph{maxima} are used.
+
+@c TODO -- add maxima to this example
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 %\override Score.TextScript #'font-style = #'large
@@ -3459,6 +4310,8 @@ but sometimes (mostly in pre-baroque music) the double length note value
   a16_"1/16" s16 a32_"1/32" s16 a64_"1/64" s32 }
 @end lilypond
 
+@c TODO -- add maxima rest to this example
+
 @lilypond[fragment,notime,line-width=13.0\cm]
 %\override Score.TextScript #'font-style = #'large
 \set Score.automaticBars = ##f
@@ -3481,7 +4334,7 @@ half.  Another dot adds yet a fourth of the duration.
 
 Alternatively note values may be subdivided by other ratios.  Most common is
 subdivision by@w{ }3 (@emph{triplets}) and@w{ }5 (@emph{quintuplets}).
-Subdivisions by@w{ }2 (@emph{tuplets}) or@w{ }4 (@emph{quadruplets}) of
+Subdivisions by@w{ }2 (@emph{duplets}) or@w{ }4 (@emph{quadruplets}) of
 dotted notes are also frequently used.
 
 @lilypond[fragment,line-width=13.0\cm]
@@ -3503,10 +4356,14 @@ dotted notes are also frequently used.
 }
 @end lilypond
 
+
 @node octave sign
 @section octave sign
 
-@aref{G clef}, @aref{F clef}.
+@seealso
+
+@ref{G clef}, @ref{F clef}.
+
 
 @node octave
 @section octave
@@ -3520,7 +4377,10 @@ DK: oktav,
 S: oktav,
 FI: oktaavi.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node ornament
 @section ornament
@@ -3535,7 +4395,7 @@ S: ornament,
 FI: koru, hele.
 
 Most commonly used is the @emph{trill}, the rapid alternation of a given note
-with the diatonic @aref{second} above it.  In the music from the
+with the diatonic @ref{second} above it.  In the music from the
 middle of the 19th century and onwards the trill is performed with the main
 note first while in the music from the preceding baroque and classic periods
 the upper note is played first.
@@ -3578,7 +4438,10 @@ the
 >>
 @end lilypond
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node ossia
 @section ossia
@@ -3596,6 +4459,7 @@ Ossia (otherwise) marks an alternative.  It is an added staff or piano
 score, usually only a few measures long, which presents another version
 of the music, for example for small hands.
 
+
 @node part
 @section part
 
@@ -3609,18 +4473,25 @@ S: stämma,
 FI: stemma, instrumenttiosuus.
 
 1.@tie{}In instrumental or choral music the music for the single instrument
-or voice.  2.@tie{}in contrapuntal music @aref{counterpoint} the single
+or voice.  2.@tie{}in contrapuntal music @ref{counterpoint} the single
 melodic line of the contrapunctal web.
 
+
 @node pause
 @section pause
 
+@seealso
+
 @ref{fermata}.
 
+
 @node pennant
 @section pennant
 
-@aref{flag}.
+@seealso
+
+@ref{flag}.
+
 
 @node percussion
 @section percussion
@@ -3640,6 +4511,7 @@ kettledrums (I: @emph{timpani}, D: @emph{Pauken}), snare drum, bass drum,
 tambourine, cymbals, chinese gong (tam-tam), triangle, celesta, glockenspiel,
 and xylophone.
 
+
 @node perfect interval
 @section perfect interval
 
@@ -3652,7 +4524,10 @@ DK: rent interval,
 S: rent intervall,
 FI: puhdas intervalli.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node phrase
 @section phrase
@@ -3668,6 +4543,7 @@ FI: fraasi, lause.
 
 A natural division of the melodic line, comparable to a sentence of speech.
 
+
 @node phrasing
 @section phrasing
 
@@ -3680,8 +4556,26 @@ DK: frasering,
 S: fra@-se@-ring,
 FI: fraseeraus, jäsentäminen.
 
-The clear rendering in musical performance of the @aref{phrase}s of
-the melody.  Phrasing may be indicated by a @aref{slur}.
+The clear rendering in musical performance of the @ref{phrase}s of
+the melody.  Phrasing may be indicated by a @ref{slur}.
+
+
+@node pickup
+@section pickup
+
+ES: anacrusa,
+I: anacrusi,
+F: anacrouse, levée,
+D: Auftakt,
+NL: opmaat,
+DK: optakt,
+S: upptakt,
+FI: kohotahti.
+
+@seealso
+
+@ref{anacrusis}.
+
 
 @node piano
 @section piano
@@ -3696,7 +4590,8 @@ S: piano,
 FI, piano, hiljaa.
 
 @emph{piano} (@b{p}) soft, @emph{pianissimo} (@b{pp}) very soft,
-@emph{mezzopiano} (@b{mp}) medium soft.
+@emph{mezzo piano} (@b{mp}) medium soft.
+
 
 @node pitch
 @section pitch
@@ -3710,6 +4605,7 @@ DK: tonehøjde,
 S: tonhöjd,
 FI: sävelkorkeus.
 
+
 @node pizzicato
 @section pizzicato
 
@@ -3724,6 +4620,7 @@ FI: pizzicato, näppäillen.
 
 Play by plucking the strings.
 
+
 @node polyphony
 @section polyphony
 
@@ -3737,12 +4634,18 @@ S: polyfoni,
 FI: polyfonia, moniäänisyys.
 
 Music written in a combination of several simultaneous voices (parts) of a
-more or less pronounced individuality.  @aref{counterpoint}.
+more or less pronounced individuality.
+
+@ref{counterpoint}.
+
 
 @node portato
 @section portato
 
-@aref{legato}.
+@seealso
+
+@ref{legato}.
+
 
 @node presto
 @section presto
@@ -3756,9 +4659,10 @@ DK: presto,
 S: presto,
 FI: presto, hyvin nopeasti.
 
-Very quick, i.e., quicker than @aref{allegro}; @emph{prestissimo}
+Very quick, i.e., quicker than @ref{allegro}; @emph{prestissimo}
 denotes the highest possible degree of speed.
 
+
 @node Pythagorean comma
 @section Pythagorean comma
 
@@ -3773,10 +4677,11 @@ FI: pytagorinen komma.
 
 A sequence of fifths starting on@w{ }C eventually circles back to@w{ }C,
 but this@w{ }C, obtained by adding 12@w{ }fifths, is
-24 @aref{cent}s higher than the@w{ }C obtained by adding
+24 @ref{cent}s higher than the@w{ }C obtained by adding
 7@w{ }octaves.  The difference between those two pitches is called the
 Pythagorean comma.
 
+
 @node quadruplet
 @section quadruplet
 
@@ -3789,7 +4694,10 @@ DK: kvartol,
 S: kvartol,
 FI: kvartoli.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node quarter note
 @section quarter note
@@ -3804,7 +4712,10 @@ DK: fjerdedelsnode,
 S: fjärdedelsnot,
 FI: neljännesosanuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node quarter rest
 @section quarter rest
@@ -3819,7 +4730,10 @@ DK:@w{ }fjerdedelspause,
 S: fjärdedelspaus,
 FI: neljännesosatauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node quintuplet
 @section quintuplet
@@ -3833,7 +4747,10 @@ DK: kvintol,
 S: kvintol,
 FI: kvintoli.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node rallentando
 @section rallentando
@@ -3847,7 +4764,10 @@ DK: rallentando,
 S: rallentando,
 FI: rallerdando, hidastuen.
 
-Abbreviation "rall.".  @aref{ritardando}.
+Abbreviation "rall.".
+
+@ref{ritardando}.
+
 
 @node relative key
 @section relative key
@@ -3861,8 +4781,7 @@ DK: paralleltoneart,
 S: parallelltonart,
 FI: rinnakkaissävellaji.
 
-@aref{major} and @aref{minor} @aref{key}
-with the same @aref{key signature}.
+@ref{major} and @ref{minor} @ref{key}s with the same @ref{key signature}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -3883,6 +4802,7 @@ with the same @aref{key signature}.
 }
 @end lilypond
 
+
 @node repeat
 @section repeat
 
@@ -3906,6 +4826,7 @@ FI: toisto.
 @c F: 'pause' if you mean a whole rest, 'silence' if you do not want to
 @c     specify the rest's value.
 
+
 @node rest
 @section rest
 
@@ -3918,7 +4839,10 @@ DK: pause,
 S: paus,
 FI: tauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node rhythm
 @section rhythm
@@ -3932,14 +4856,23 @@ DK: rytme,
 S: rytm,
 FI: rytmi.
 
-(a) Metrical rhythm in which every time value is a multiple or fraction of a
-fixed unit of time, called @aref{beat}, and in which the normal
-@aref{accent} recurs in regular intervals, called
-@aref{measure}.  The basic scheme of time values is called
-@aref{meter}.  (b) Measured rhythm which lacks regularly recurrent
-accent.  In modern notation such music appears as a free alternation of
-different measures.  (c) Free rhythm, i.e., the use of temporal values having
-no common metrical unit (beat).
+@itemize
+
+@item Metrical rhythm in which every time value is a multiple or
+fraction of a fixed unit of time, called @ref{beat}, and in which the
+normal @ref{accent} recurs in regular intervals, called @ref{measure}.
+The basic scheme of time values is called @ref{meter}.
+
+@item Measured rhythm which lacks regularly recurrent accent.  In
+modern notation such music appears as a free alternation of different
+measures.
+
+@item Free rhythm, i.e., the use of temporal values having no common
+metrical unit (beat).
+
+@end itemize
+
+
 
 @node ritardando
 @section ritardando
@@ -3955,6 +4888,7 @@ FI: ritardando, hidastuen,
 
 Gradually slackening in speed.  Mostly abbreviated to rit.@: or ritard.
 
+
 @node ritenuto
 @section ritenuto
 
@@ -3969,6 +4903,7 @@ FI: ritenuto, hidastaen.
 
 Immediate reduction of speed.
 
+
 @node scale
 @section scale
 
@@ -3981,7 +4916,10 @@ DK: Skala,
 S: skala,
 FI: asteikko, sävelasteikko.
 
-@aref{diatonic scale}.
+@seealso
+
+@ref{diatonic scale}.
+
 
 @node scale degree
 @section scale degree
@@ -3995,9 +4933,9 @@ DK: skalatrin,
 S: skalsteg (?),
 FI: sävelaste, asteikon sävel.
 
-Names and symbols used in harmonic analysis to denote tones of the scale as
-roots of chords.  The most important are degrees I = tonic (T), IV =
-sub@-do@-mi@-nant (S) and V = dominant (D).
+Names and symbols used in harmonic analysis to denote tones of the
+scale as roots of chords.  The most important are degrees I = tonic
+(T), IV = sub@-do@-mi@-nant (S) and V = dominant (D).
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -4012,7 +4950,47 @@ sub@-do@-mi@-nant (S) and V = dominant (D).
 >>
 @end lilypond
 
-@aref{functional harmony}.
+@seealso
+
+@ref{functional harmony}.
+
+
+@node scordatura
+@section scordatura
+
+ES: ?,
+I: scordatura,
+F: à cordes ravallées,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+[From Italian, @emph{scordare}, @q{to mistune}.]  Unconventional
+tuning of stringed instruments, particularly lutes or violins.  Used
+to:
+
+@itemize
+
+@item facilitate pitch combinations that would otherwise be difficult
+or impossible
+
+@item alter the characteristic timbre of the instrument, for example,
+to increase brilliance)
+
+@item reinforce certain sonorities or tonalities by making them
+available on open strings
+
+@item imitate other instruments
+
+@item etc.
+
+@end itemize
+
+Tunings that could be called @var{scordatura} first appeared early in
+the 16th Century and became commonplace in the 17th.
+
 
 @node score
 @section score
@@ -4020,15 +4998,16 @@ sub@-do@-mi@-nant (S) and V = dominant (D).
 ES: partitura,
 I: partitura,
 F: partition,
-D: Partitur (full score), Klavierauszug (vocal score)
+D: Partitur (full score), Klavierauszug (vocal score),
 NL: partituur,
 DK: partitur,
 S: partitur,
 FI: partituuri.
 
-A copy of orchestral, choral, or chamber music showing what each instrument is
-to play, each voice to sing, having each part arranged one underneath the
-other on different staves @aref{staff}.
+A copy of orchestral, choral, or chamber music showing what each
+instrument is to play, each voice to sing, having each part arranged
+one underneath the other on different staves @ref{staff}.
+
 
 @node second
 @section second
@@ -4042,10 +5021,11 @@ DK: sekund,
 S: sekund,
 FI: sekunti.
 
-The @aref{interval} between two neigbouring tones of a scale.  A
-@aref{diatonic scale} consists of alternating
-@aref{semitone}s and @aref{whole tone}s, hence the size
-of a se@-cond depends on the scale degrees in question.
+The @ref{interval} between two neigbouring tones of a scale.  A
+@ref{diatonic scale} consists of alternating @ref{semitone}s and
+@ref{whole tone}s, hence the size of a se@-cond depends on the scale
+degrees in question.
+
 
 @node semitone
 @section semitone
@@ -4059,17 +5039,18 @@ DK: halvtone,
 S: halvton,
 FI: puolisävel.
 
-The @aref{interval} of a minor second.  The (usually) smallest
-interval in European composed music.  The interval between two neighbouring
+The @ref{interval} of a minor second.  The (usually) smallest interval
+in European composed music.  The interval between two neighbouring
 tones on the piano keyboard -- including black and white keys -- is a
 semitone.  An octave may be divided into 12@w{ }semitones.
-@aref{interval}, @aref{chromatic scale}.
+@ref{interval}, @ref{chromatic scale}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
 \relative c'' { g1 gis s a bes s b! c }
 @end lilypond
 
+
 @node seventh
 @section seventh
 
@@ -4082,12 +5063,18 @@ DK: septim,
 S: septim,
 FI: septimi.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node sextolet
 @section sextolet
 
-@aref{sextuplet}
+@seealso
+
+@ref{sextuplet}
+
 
 @node sextuplet
 @section sextuplet
@@ -4101,12 +5088,18 @@ DK: sekstol,
 S: sextol,
 FI: sekstoli.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node shake
 @section shake
 
-@aref{trill}.
+@seealso
+
+@ref{trill}.
+
 
 @node sharp
 @section sharp
@@ -4120,12 +5113,18 @@ DK: kryds,
 S: kors@-förtecken,
 FI: korotusmerkki.
 
-@aref{accidental}.
+@seealso
+
+@ref{accidental}.
+
 
 @node short appoggiatura
 @section short appoggiatura
 
-@aref{appoggiatura}.
+@seealso
+
+@ref{appoggiatura}.
+
 
 @node sixteenth note
 @section sixteenth note
@@ -4140,7 +5139,10 @@ DK: sekstendedelsnode,
 S: sextondelsnot,
 FI: kuudestoistaosanuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node sixteenth rest
 @section sixteenth rest
@@ -4155,7 +5157,10 @@ DK: sekstendedelspause,
 S: sextondelspaus,
 FI: kuudesosatauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node sixth
 @section sixth
@@ -4169,7 +5174,10 @@ DK: sekst,
 S: sext,
 FI: seksti.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node sixty-fourth note
 @section sixty-fourth note
@@ -4184,7 +5192,10 @@ DK: fi@-re@-og@-tred@-sinds@-ty@-ven@-de@-dels@-no@-de,
 S: sextiofjärdedelsnot,
 FI: kuudeskymmenesneljäsosanuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node sixty-fourth rest
 @section sixty-fourth rest
@@ -4199,7 +5210,11 @@ DK: fi@-re@-og@-tred@-sinds@-ty@-ven@-de@-dels@-pau@-se,
 S: sextiofjärdedelspaus,
 FI: kuudeskymmenesneljäsosatauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
+
 
 @node slur
 @section slur
@@ -4213,9 +5228,11 @@ DK: legatobue, fraseringsbue,
 S: båge,
 FI: kaari.
 
-A slur above or below a group of notes indicates that they are to be played
-@aref{legato}, e.g., with one stroke of the violin bow or with one
-breath in singing.
+A slur above or below a group of notes indicates that they are to be
+played @ref{legato}, e.g., with one stroke of the violin bow or with
+one breath in singing.
+
+
 
 @node solmization
 @section solmization
@@ -4230,9 +5247,13 @@ S: solmisation,
 FI: suhteelliset laulunimet.
 
 General term for systems of designating the degrees of the
-@aref{scale}, not by letters, but by syllables (@emph{do}
-(@emph{ut}), @emph{re}, @emph{mi}, @emph{fa}, @emph{sol}, @emph{la}, @emph{si}
-(@emph{ti})).  @aref{scale degree}.
+@ref{scale}, not by letters, but by syllables (@emph{do} (@emph{ut}),
+@emph{re}, @emph{mi}, @emph{fa}, @emph{sol}, @emph{la}, @emph{si}
+(@emph{ti})).
+
+@ref{scale degree}.
+
+
 
 @node sonata
 @section sonata
@@ -4246,9 +5267,11 @@ DK: sonate,
 S: sonat,
 FI: sonaatti.
 
-In its present-day meaning a sonata denotes an instrumental composition for
-piano or for some other instrument with piano accompaniment, which consists of
-three or four independant pieces, called movements.
+In its present-day meaning a sonata denotes an instrumental
+composition for piano or for some other instrument with piano
+accompaniment, which consists of three or four independant pieces,
+called movements.
+
 
 @node sonata form
 @section sonata form
@@ -4262,23 +5285,28 @@ DK: sonateform,
 S: sonatform,
 FI: sonaattimuoto.
 
-A form used frequently for single movements of the @aref{sonata},
-@aref{symphony}, quartet, etc.  A movement written in sonata form
-falls into three sections called @emph{exposition}, @emph{development} and
-@emph{recapitulation}.  In the exposition the composer introduces some musical
-ideas, consisting of a number of themes; in the development section the
-composer @q{develops} this material, and in the recapitulation the composer
-repeats the exposition, with certain modifications.  The exposition contains a
-number of themes that fall into two groups, often called first and second
-subject.  Other melodies occurring in each group are considered as
-continuations of these two.  The second theme is in another key, normally in
-the key of the @aref{dominant} if the @aref{tonic} is @aref{major}, and in the
-@aref{relative key} if the tonic is @aref{minor}.
+A form used frequently for single movements of the @ref{sonata},
+@ref{symphony}, quartet, etc.  A movement written in sonata form falls
+into three sections called @emph{exposition}, @emph{development} and
+@emph{recapitulation}.  In the exposition the composer introduces some
+musical ideas, consisting of a number of themes; in the development
+section the composer @q{develops} this material, and in the
+recapitulation the composer repeats the exposition, with certain
+modifications.  The exposition contains a number of themes that fall
+into two groups, often called first and second subject.  Other
+melodies occurring in each group are considered as continuations of
+these two.  The second theme is in another key, normally in the key of
+the @ref{dominant} if the @ref{tonic} is @ref{major}, and in the
+@ref{relative key} if the tonic is @ref{minor}.
+
 
 @node song texts
 @section song texts
 
-@aref{lyrics}.
+@seealso
+
+@ref{lyrics}.
+
 
 @node soprano
 @section soprano
@@ -4294,6 +5322,7 @@ FI: sopraano, korkea naisääni.
 
 The highest female voice.
 
+
 @node staccato
 @section staccato
 
@@ -4306,8 +5335,8 @@ DK: staccato,
 S: staccato,
 FI: staccato, lyhyesti, terävästi.
 
-Playing the note(s) short.  Staccato is indicated by a dot above or below the
-note head.
+Playing the note(s) short.  Staccato is indicated by a dot above or
+below the note head.
 
 @lilypond[fragment,ragged-right]
 \key d \major
@@ -4319,6 +5348,7 @@ note head.
 }
 @end lilypond
 
+
 @node staff
 @section staff
 
@@ -4333,13 +5363,17 @@ FI: nuottiviivasto.
 
 A staff (pl. staves) is a series of (normally five) horizontal lines
 upon and between which the musical notes are written, thus indicating
-(in connection with a @aref{clef}) their pitch.  Staves for
-@aref{percussion} instruments may have fewer lines.
+(in connection with a @ref{clef}) their pitch.  Staves for
+@ref{percussion} instruments may have fewer lines.
+
 
 @node staves
 @section staves
 
-@aref{staff}.
+@seealso
+
+@ref{staff}.
+
 
 @node stem
 @section stem
@@ -4353,8 +5387,10 @@ DK: hals,
 S: skaft,
 FI: nuottipalkki.
 
-Vertical line above or below a @aref{note head} shorter than a
-whole note.  @aref{beam}.
+Vertical line above or below a @ref{note head} shorter than a
+whole note.
+
+@ref{beam}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.autoBeaming = ##f
@@ -4368,6 +5404,7 @@ whole note.  @aref{beam}.
 }
 @end lilypond
 
+
 @node strings
 @section strings
 
@@ -4380,8 +5417,10 @@ DK: strygere,
 S: stråkar,
 FI: jouset.
 
-A family of stringed musical instruments played with a bow.  Strings commonly
-used in a symphony orchestra are violin, viola, violoncello, and double bass.
+A family of stringed musical instruments played with a bow.  Strings
+commonly used in a symphony orchestra are violin, viola, violoncello,
+and double bass.
+
 
 @node strong beat
 @section strong beat
@@ -4395,8 +5434,10 @@ D: betonet taktslag,
 S: betonat taktslag,
 FI: tahdin vahva isku.
 
-@aref{beat}, @aref{accent}, @aref{measure},
-@aref{rhythm}.
+@seealso
+
+@ref{beat}, @ref{accent}, @ref{measure}, @ref{rhythm}.
+
 
 @node subdominant
 @section subdominant
@@ -4410,7 +5451,10 @@ DK: subdominant,
 S: subdominant,
 FI: subdominantti, alidominantti.
 
-The fourth @aref{scale degree}.  @aref{functional harmony}.
+The fourth @ref{scale degree}.
+
+@ref{functional harmony}.
+
 
 @node submediant
 @section submediant
@@ -4424,7 +5468,8 @@ DK: Submediant,
 S: submediant,
 FI: alikeskisävel.
 
-The sixth @aref{scale degree}.
+The sixth @ref{scale degree}.
+
 
 @node subtonic
 @section subtonic
@@ -4438,7 +5483,24 @@ DK: Subtonika,
 S: subtonika,
 FI: subtoonika, alitoonika.
 
-The seventh @aref{scale degree}.
+The seventh @ref{scale degree}.
+
+
+@node sul G
+@section sul G
+
+ES: sobre la G,
+I: sul g,
+F: sur la G,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+Indicates that the indicated passage (or note) should be played on the
+G string.
+
 
 @node superdominant
 @section superdominant
@@ -4452,7 +5514,8 @@ DK: superdominant,
 S: superdominant,
 FI: ylidominantti.
 
-The sixth @aref{scale degree}.
+The sixth @ref{scale degree}.
+
 
 @node supertonic
 @section supertonic
@@ -4466,7 +5529,8 @@ DK: supertonika,
 S: supertonika,
 FI: ylitoonika.
 
-The second @aref{scale degree}.
+The second @ref{scale degree}.
+
 
 @node symphony
 @section symphony
@@ -4480,7 +5544,8 @@ DK: symfoni,
 S: symfoni,
 FI: sinfonia.
 
-A symphony may be defined as a @aref{sonata} for orchestra.
+A symphony may be defined as a @ref{sonata} for orchestra.
+
 
 @node syncopation
 @section syncopation
@@ -4494,12 +5559,13 @@ DK: synkope,
 S: synkop,
 FI: synkooppi.
 
-Any deliberate upsetting of the normal pulse of @aref{meter},
-@aref{accent}, and @aref{rhythm}.  The occidental system of musical
-rhythm rests upon the grouping of equal beats into groups of two or three,
-with a regularly recurrent accent on the first beat of each group.  Any
-deviation from this scheme is felt as a disturbance or contradiction between
-the underlaying (normal) pulse and the actual (abnormal) rhythm.
+Any deliberate upsetting of the normal pulse of @ref{meter},
+@ref{accent}, and @ref{rhythm}.  The occidental system of musical
+rhythm rests upon the grouping of equal beats into groups of two or
+three, with a regularly recurrent accent on the first beat of each
+group.  Any deviation from this scheme is felt as a disturbance or
+contradiction between the underlaying (normal) pulse and the actual
+(abnormal) rhythm.
 
 @lilypond[fragment,ragged-right]
 \time 4/4
@@ -4510,6 +5576,8 @@ the underlaying (normal) pulse and the actual (abnormal) rhythm.
 }
 @end lilypond
 
+
+
 @node syntonic comma
 @section syntonic comma
 
@@ -4520,11 +5588,13 @@ D: syntonisches Komma,
 NL: syntonische komma,
 DK: syntonisk komma,
 S: syntoniskt komma,
-FI: syntoninen komma, terssien taajuusero luonnollisessa ja Pytagorisessa
-viritysjärjestelmässä.
+FI: syntoninen komma, terssien taajuusero luonnollisessa ja
+Pytagorisessa viritysjärjestelmässä.
+
+Difference between the natural third and the third obtained by
+Pythagorean tuning (@ref{Pythagorean comma}), equal to 22@w{ }cents.
+
 
-Difference between the natural third and the third obtained by Pythagorean
-tuning (@aref{Pythagorean comma}), equal to 22@w{ }cents.
 
 @node system
 @section system
@@ -4538,8 +5608,10 @@ DK: system,
 S: system,
 FI: nuottijärjestelmä.
 
-The collection of staves @aref{staff}, two or more, as used for
-writing down of keyboard, chamber, choral, or orchestral music.
+The collection of staves (@ref{staff}), two or more, as used for writing
+down of keyboard, chamber, choral, or orchestral music.
+
+
 
 @node temperament
 @section temperament
@@ -4553,8 +5625,11 @@ DK: temperatur,
 S: temperatur,
 FI: viritysjärjestelmä.
 
-Systems of tuning in which the intervals deviate from the acoustically pure
-intervals.  @aref{meantone temperament}, @aref{equal temperament}.
+Systems of tuning in which the intervals deviate from the acoustically
+pure intervals.
+
+@ref{meantone temperament}, @ref{equal temperament}.
+
 
 @node tempo indication
 @section tempo indication
@@ -4568,10 +5643,11 @@ DK: tempobetegelse,
 S: tempobeteckning,
 FI: tempomerkintä.
 
-The rate of speed of a composition or a section thereof, ranging from the
-slowest to the quickest, as is indicated by tempo marks as
-@aref{largo}, @aref{adagio}, @aref{andante},
-@aref{allegro}, and @aref{presto}.
+The rate of speed of a composition or a section thereof, ranging from
+the slowest to the quickest, as is indicated by tempo marks as
+@ref{largo}, @ref{adagio}, @ref{andante}, @ref{allegro}, and
+@ref{presto}.
+
 
 @node tenor
 @section tenor
@@ -4585,7 +5661,8 @@ DK: tenor,
 S: tenor,
 FI: tenori, korkea miesääni.
 
-The highest male voice (apart from @aref{counter tenor}).
+The highest male voice (apart from @ref{counter tenor}).
+
 
 @node tenth
 @section tenth
@@ -4599,7 +5676,10 @@ DK: decim,
 S: decima,
 FI: desimi.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node tenuto
 @section tenuto
@@ -4616,6 +5696,7 @@ FI: viiva, tenuto.
 An indication that a particular note should be held for the whole
 length, although this can vary depending on the composer and era.
 
+
 @node third
 @section third
 
@@ -4628,7 +5709,10 @@ DK: terts,
 S: ters,
 FI: terssi.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node thirty-second note
 @section thirty-second note
@@ -4643,7 +5727,10 @@ DK: toogtredivtedelsnode,
 S: trettiotvåondelsnot,
 FI: kolmanneskymmeneskahdesosanuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node thirty-second rest
 @section thirty-second rest
@@ -4658,7 +5745,10 @@ DK: toogtredivtedelspause,
 S: trettiotvåondelspaus,
 FI: kolmanneskymmeneskahdesosatauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node thorough bass
 @section thorough bass
@@ -4672,9 +5762,9 @@ DK: generalbas,
 S: generalbas,
 FI: kenraalibasso, numeroitu basso.
 
-A method of indicating an accompaniment part by the bass notes only, together
-with figures designating the chief @aref{interval}s and
-@aref{chord}s to be played above the bass notes.
+A method of indicating an accompaniment part by the bass notes only,
+together with figures designating the chief @ref{interval}s and
+@ref{chord}s to be played above the bass notes.
 
 @lilypond[fragment,line-width=13.0\cm]
 \context GrandStaff <<
@@ -4701,6 +5791,7 @@ with figures designating the chief @aref{interval}s and
 >>
 @end lilypond
 
+
 @node tie
 @section tie
 
@@ -4713,19 +5804,24 @@ DK: bindebue,
 S: bindebåge, överbindning,
 FI: sitominen.
 
-A curved line, identical in appearance with the @aref{slur}, which
-connects two succesive notes of the same pitch, and which has the function of
-uniting them into a single sound (tone) equal to the combined durations.
+A curved line, identical in appearance with the @ref{slur}, which
+connects two succesive notes of the same pitch, and which has the
+function of uniting them into a single sound (tone) equal to the
+combined durations.
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
 \relative c'' { g2 ~ g4. }
 @end lilypond
 
+
 @node time
 @section time
 
-@aref{meter}.
+@seealso
+
+@ref{meter}.
+
 
 @node time signature
 @section time signature
@@ -4739,7 +5835,10 @@ DK: taktangivelse,
 S: taktartssignatur,
 FI: tahtiosoitus.
 
-@aref{meter}.
+@seealso
+
+@ref{meter}.
+
 
 @node tone
 @section tone
@@ -4755,8 +5854,10 @@ FI: ääni.
 
 A sound of definite pitch and duration, as distinct from @emph{noise}.
 Tone is a primary building material of music.
+
 Music from the 20th century may be based on atonal sounds.
 
+
 @node tonic
 @section tonic
 
@@ -4769,8 +5870,12 @@ DK: tonika,
 S: tonika,
 FI: toonika.
 
-The first @aref{scale degree}.
-@aref{functional harmony}.
+The first @ref{scale degree}.
+
+@seealso
+
+@ref{functional harmony}.
+
 
 @node transposition
 @section transposition
@@ -4807,19 +5912,23 @@ relative pitches.
 }
 @end lilypond
 
+
 @node treble clef
 @section treble clef
 
 ES: clave de sol,
 I: chiave di violino,
-F: clé de sol,
+F: clef de sol,
 D: Violinschlüssel, Sopranschlüssel,
 NL: viool sleutel,
 DK:@w{ }diskantnøgle,
 S: diskantklav,
 FI: diskanttiavain.
 
-@aref{G clef}.
+@seealso
+
+@ref{G clef}.
+
 
 @node tremolo
 @section tremolo
@@ -4833,11 +5942,10 @@ DK: tremolo,
 S: tremolo,
 FI: tremolo.
 
-On stringed instruments (@aref{strings}) the quick reiteration of
-the same tone, produced by a rapid up-and-down movement of the bow
-(a).  The term is also used for the rapid alternation (b) between two notes of
-a @aref{chord}, usually in the distance of a third
-(@aref{interval}).
+On stringed instruments (@ref{strings}) the quick reiteration of the
+same tone, produced by a rapid up-and-down movement of the bow (a). 
+The term is also used for the rapid alternation (b) between two notes
+of a @ref{chord}, usually in the distance of a third (@ref{interval}).
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
@@ -4849,6 +5957,7 @@ a @aref{chord}, usually in the distance of a third
 }
 @end lilypond
 
+
 @node triad
 @section triad
 
@@ -4861,7 +5970,10 @@ DK: treklang,
 S: treklang,
 FI: kolmisointu.
 
-@aref{chord}.
+@seealso
+
+@ref{chord}.
+
 
 @node trill
 @section trill
@@ -4875,7 +5987,10 @@ DK: trille,
 S: drill,
 FI: trilli.
 
-@aref{ornament}.
+@seealso
+
+@ref{ornament}.
+
 
 @node triple meter
 @section triple meter
@@ -4889,7 +6004,10 @@ DK: tredelt takt,
 S: tretakt,
 FI: kolmijakoinen.
 
-@aref{meter}.
+@seealso
+
+@ref{meter}.
+
 
 @node triplet
 @section triplet
@@ -4903,7 +6021,10 @@ DK: triol,
 S: triol,
 FI: trioli.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node tritone
 @section tritone
@@ -4917,7 +6038,10 @@ DK: tritonus,
 S: tritonus,
 FI: tritonus.
 
-@aref{interval}.
+@seealso
+
+@ref{interval}.
+
 
 @node tuning fork
 @section tuning fork
@@ -4931,9 +6055,10 @@ DK: stemmegaffel,
 S: stämgaffel,
 FI: viritysavain.
 
-A two-pronged piece of steel used to indicate absolute pitch.  Tuning forks
-give the international pitch for the tone @emph{a} (440 vibrations per
-second).
+A two-pronged piece of steel used to indicate absolute pitch.  Tuning
+forks give the international pitch for the tone @emph{a} (440
+vibrations per second).
+
 
 @node turn
 @section turn
@@ -4947,7 +6072,10 @@ DK: dobbeltslag,
 S: dubbelslag,
 FI: korukuvio.
 
-@aref{ornament}.
+@seealso
+
+@ref{ornament}.
+
 
 @node unison
 @section unison
@@ -4961,9 +6089,10 @@ DK: unison,
 S: unison,
 FI: unisono, yksiäänisesti.
 
-Playing of the same notes or the same melody by various instruments (voices)
-or by the whole orchestra (choir), either at exactly the same pitch or in a
-different octave.
+Playing of the same notes or the same melody by various instruments
+(voices) or by the whole orchestra (choir), either at exactly the same
+pitch or in a different octave.
+
 
 @node upbeat
 @section upbeat
@@ -4977,16 +6106,10 @@ DK: optakt,
 S: upptakt,
 FI: kohotahti.
 
-Initial note(s) of a melody occurring before the first bar
-line.  @aref{measure}, @aref{meter}.
+@seealso
+
+@ref{anacrusis}
 
-@lilypond[fragment,line-width=13.0\cm]
-\key f \major
-\time 4/4
-\relative c' {
-  \partial 4 f4 | bes4. a8 bes4 c |
-  bes( a) g f | bes4. a8 bes4 c | f,2. \bar "||" }
-@end lilypond
 
 @node voice
 @section voice
@@ -5000,10 +6123,11 @@ DK: stemme,
 S: stämma,
 FI: ääni, lauluääni.
 
-1.@tie{}Human voices: @aref{soprano}, @aref{mezzo-soprano},
-@aref{contralto}, @aref{tenor}, @aref{baritone}, @aref{bass}.
+1.@tie{}Human voices: @ref{soprano}, @ref{mezzo-soprano},
+@ref{contralto}, @ref{tenor}, @ref{baritone}, @ref{bass}.
 2.@tie{}A melodic layer or part of a polyphonic composition.
 
+
 @node weak beat
 @section weak beat
 
@@ -5016,7 +6140,10 @@ DK: ubetonet taktslag,
 S: obetonat taktslag,
 FI: tahdin heikko isku.
 
-@aref{beat}, @aref{measure}, @aref{rhythm}.
+@seealso
+
+@ref{beat}, @ref{measure}, @ref{rhythm}.
+
 
 @node whole note
 @section whole note
@@ -5031,7 +6158,10 @@ DK: helnode,
 S: helnot,
 FI: kokonuotti.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
 
 @node whole rest
 @section whole rest
@@ -5046,7 +6176,11 @@ DK: helnodespause,
 S: helpaus,
 FI: kokotauko.
 
-@aref{note value}.
+@seealso
+
+@ref{note value}.
+
+
 
 @node whole tone
 @section whole tone
@@ -5060,10 +6194,13 @@ DK: heltone,
 S: helton,
 FI: kokoaskel.
 
-The @aref{interval} of a major second.  The interval between two
-tones on the piano keyboard with exactly one key between them -- including
+The @ref{interval} of a major second.  The interval between two tones
+on the piano keyboard with exactly one key between them -- including
 black and white keys -- is a whole tone.
 
+
+
+
 @node woodwind
 @section woodwind
 
@@ -5076,9 +6213,13 @@ DK træblæsere,
 S: träblåsare,
 FI: puupuhaltimet.
 
-A family of blown wooden musical instruments.  Today some of these instruments
-are actually made from metal.  The woodwind instruments commonly used in a
-symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
+A family of blown wooden musical instruments.  Today some of these
+instruments are actually made from metal.  The woodwind instruments
+commonly used in a symphony orchestra are flute, oboe, clarinet,
+saxophone, and bassoon.
+
+
+
 
 @node Duration names notes and rests
 @chapter Duration names, notes and rests
@@ -5102,7 +6243,7 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab @strong{FI}
   @tab @strong{ES}
 
-@item
+@c extra @items make this table harder to read, so I removed them.
 
 @item @strong{longa}
   @tab longa
@@ -5117,8 +6258,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab longa
   @tab longa
 
-@item
-
 @item @strong{breve}
   @tab breve
   @tab breve
@@ -5132,8 +6271,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab brevis
   @tab cuadrada
 
-@item
-
 @item @strong{whole}
   @tab semi@-breve
   @tab semi@-breve
@@ -5147,8 +6284,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab koko@-nuotti/@w{-tauko}
   @tab redonda
 
-@item
-
 @item @strong{half}
   @tab minim
   @tab minima
@@ -5162,8 +6297,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab puoli@-nuotti/@w{-tauko}
   @tab blanca
 
-@item
-
 @item @strong{quarter}
   @tab crotchet
   @tab semiminima
@@ -5177,8 +6310,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab neljännesosa@-nuotti/@w{-tauko}
   @tab negra
 
-@item
-
 @item @strong{eighth}
   @tab quaver
   @tab croma
@@ -5192,8 +6323,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab kahdeksasosa@-nuotti/@w{-tauko}
   @tab corchea
 
-@item
-
 @item @strong{sixteenth}
   @tab semiquaver
   @tab semicroma
@@ -5207,8 +6336,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab kuudestoistaosa@-nuotti/@w{-tauko}
   @tab semicorchea
 
-@item
-
 @item @strong{thirty-second}
   @tab demisemiquaver
   @tab biscroma
@@ -5222,8 +6349,6 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab kolmaskymme@-neskahdesosa@-nuotti/@w{-tauko}
   @tab fusa
 
-@item
-
 @item @strong{sixty-fourth}
   @tab hemidemisemiquaver
   @tab semibiscroma
@@ -5238,7 +6363,9 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
   @tab semifusa
 
 @end multitable
-@c @item @tab @tab @tab @tab @tab @tab @tab @tab @tab
+
+
+
 
 @node Pitch names
 @chapter Pitch names
@@ -5248,89 +6375,82 @@ symphony orchestra are flute, oboe, clarinet, saxophone, and bassoon.
 @end table
 
 @c @multitable @columnfractions .105 .145 .125 .125 .125 .125 .125 .125
+@c the extra @item's between each row makes the table hard to read ... so I removed them
+
 @multitable @columnfractions .11 .14 .14 .11 .1 .1 .1 .1 .1
 
+@c TODO -- figure out how to make _real_ table headers in TeXinfo
+
 @item @tab @strong{ES} @tab @strong{I} @tab @strong{F} @tab @strong{D}
 @tab @strong{NL} @tab @strong{DK} @tab @strong{S} @tab @strong{FI}
 
-@item
-
-@item @strong{c} @tab do  @tab do  @tab ut @tab C @tab c @tab c @tab c @tab c
-
-@item
-
-@item @strong{c-sharp} @tab do sostenido  @tab do diesis  @tab ut dièse @tab
-Cis @tab cis @tab
-cis @tab cis @tab cis
+@item @strong{c} @tab do  @tab do  @tab ut @tab C @tab c @tab c @tab c
+@tab c
 
-@item
+@item @strong{c-sharp} @tab do sostenido  @tab do diesis  @tab ut
+dièse @tab Cis  @tab cis  @tab cis  @tab cis  @tab cis
 
-@item @strong{d-flat} @tab re bemol  @tab re bemolle  @tab ré bémol @tab
-Des @tab des @tab
-des @tab des @tab des
+@item @strong{d-flat} @tab re bemol  @tab re bemolle  @tab ré bémol 
+@tab Des @tab des  @tab des  @tab des  @tab des
 
-@item
+@item @strong{d} @tab re  @tab re  @tab ré  @tab D  @tab d  @tab d 
+@tab d  @tab d
 
-@item @strong{d} @tab re  @tab re  @tab ré @tab D @tab d @tab d @tab d @tab d
+@item @strong{e-flat} @tab mi bemol  @tab mi bemolle  @tab mi bémol
+@tab Es @tab es  @tab es  @tab es  @tab es
 
-@item
+@item @strong{e} @tab mi @tab mi @tab mi @tab E @tab e @tab e @tab e
+@tab e
 
-@item @strong{e} @tab mi  @tab mi  @tab mi @tab E @tab e @tab e @tab e @tab e
+@item @strong{f} @tab fa  @tab fa  @tab fa @tab F @tab f @tab f @tab f
+@tab f
 
-@item
+@item @strong{g} @tab sol  @tab sol  @tab sol @tab G @tab g @tab g
+@tab g @tab g
 
-@item @strong{f} @tab fa  @tab fa  @tab fa @tab F @tab f @tab f @tab f @tab f
+@item @strong{a-flat} @tab la bemol  @tab la bemolle  @tab la bémol
+@tab As @tab as  @tab as  @tab as  @tab as
 
-@item
+@item @strong{a} @tab la  @tab la  @tab la @tab A @tab a @tab a @tab a
+@tab a
 
-@item @strong{g} @tab sol  @tab sol  @tab sol @tab G @tab g @tab g @tab g
-@tab g
+@item @strong{a-sharp} @tab la sostenido  @tab la diesis  @tab la
+dièse @tab Ais  @tab ais  @tab ais  @tab ais  @tab ais
 
-@item
+@item @strong{b-flat} @tab si bemol  @tab si bemolle  @tab si bémol 
+@tab B @tab bes  @tab b  @tab b  @tab b
 
-@item @strong{a-flat} @tab la bemol  @tab la bemolle  @tab la bémol @tab As
-@tab as @tab as
-@tab as @tab as
+@item @strong{b} @tab si  @tab si  @tab si @tab H @tab b @tab h @tab h
+@tab h
 
-@item
-
-@item @strong{a} @tab la  @tab la  @tab la @tab A @tab a @tab a @tab a @tab a
-
-@item
-
-@item @strong{a-sharp} @tab la sostenido  @tab la diesis  @tab la dièse @tab
-Ais @tab ais @tab
-ais @tab ais @tab ais
+@end multitable
 
-@item
 
-@item @strong{b-flat} @tab si bemol  @tab si bemolle  @tab si bémol @tab B
-@tab bes @tab b
-@tab b @tab b
 
-@item
 
-@item @strong{b} @tab si  @tab si  @tab si @tab H @tab b @tab h @tab h @tab h
-
-@end multitable
 
+@menu
+* Literature used::             
+@end menu
 
 @node Literature used
-@unnumbered Literature used
+@unnumberedsec Literature used
 
 @itemize
-@item The Harvard Dictionary of Music, London 1944.  Many more or less
-literal quotes from its articles have been included into the item
-explanation texts.
+@item The Harvard Dictionary of Music, London 1944.  Many
+more or less literal quotes from its articles have been included into
+the item explanation texts.
 
 @item Hugo Riemanns Musiklexicon, Berlin 1929.
 
-@item Polyglottes Wörterbuch der musikalischen Terminologie, Kassel 1980.
+@item Polyglottes Wörterbuch der musikalischen Terminologie, Kassel
+1980.
 
-@item Oxford Advanced Learner's Dictionary of Current English, Third Edition
-1974.
+@item Oxford Advanced Learner's Dictionary of Current English, Third
+Edition 1974.
 
 @item Webster's Revised Unabridged Dictionary, Springfield 1913.
+
 @end itemize
 
 @bye
diff --git a/Documentation/user/non-music.itely b/Documentation/user/non-music.itely
index 6462f4122c..558835dbe7 100644
--- a/Documentation/user/non-music.itely
+++ b/Documentation/user/non-music.itely
@@ -33,58 +33,23 @@ The main format of input for LilyPond are text files.  By convention,
 these files end with @samp{.ly}.
 
 @menu
-* File structure (introduction)::  
 * File structure::              
 * A single music expression::   
 * Multiple scores in a book::   
 * Extracting fragments of notation::  
 * Including LilyPond files::    
 * Text encoding::               
+* Different editions from one source::  
 @end menu
 
 
-@node File structure (introduction)
-@subsection File structure (introduction)
-
-A basic example of a lilypond input file is
-
-@example
-\version "2.11.23"
-\score @{
-  @{ @}     % this is a single music expression;
-            % all the music goes in here.
-  \header @{ @}
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-@noindent
-There are many variations of this basic pattern, but this
-example serves as a useful starting place.
-
-The major part of this manual is concerned with entering various
-forms of music in LilyPond.  However, many music expressions are not
-valid input on their own, for example, a @code{.ly} file containing
-only a note
-@example
-c'4
-@end example
-
-@noindent
-will result in a parsing error.  Instead, music should be inside other
-expressions, which may be put in a file by themselves.  Such
-expressions are called toplevel expressions; see @ref{File structure}, for
-a list of all such expressions.
-
-
 @node File structure
 @subsection File structure
 
 A @code{.ly} file contains any number of toplevel expressions, where a
 toplevel expression is one of the following
 
-@itemize @bullet
+@itemize
 @item
 An output definition, such as @code{\paper}, @code{\midi}, and
 @code{\layout}.  Such a definition at the toplevel changes the default
@@ -116,9 +81,9 @@ A @code{\book} block logically combines multiple movements
 (i.e., multiple @code{\score} blocks) in one document.  If there are
 a number of @code{\scores}, one output file will be created for
 each @code{\book} block, in which all corresponding movements are
-concatenated. The only reason to explicitly specify @code{\book} blocks
+concatenated.  The only reason to explicitly specify @code{\book} blocks
 in a @code{.ly} file is if you wish multiple output files from a single
-input file. One exception is within lilypond-book documents, where you
+input file.  One exception is within lilypond-book documents, where you
 explicitly have to add a @code{\book} block if you want more than a
 single @code{\score} or @code{\markup} in the same example.
 
@@ -167,16 +132,15 @@ Markup texts are rendered above, between or below the scores or music
 expressions, wherever they appear.
 
 @cindex variables
-@cindex identifiers
 
 @item
-An identifier, such as
+An variable, such as
 @example
 foo = @{ c4 d e d @}
 @end example
 
 This can be used later on in the file by entering @code{\foo}.  The
-name of an identifier should have alphabetic characters only; no
+name of an variable should have alphabetic characters only; no
 numbers, underscores or dashes.
 
 @end itemize
@@ -201,7 +165,7 @@ toplevel
 At any point in a file, any of the following lexical instructions can
 be entered:
 
-@itemize @bullet
+@itemize
 @item @code{\version}
 @item @code{\include}
 @item @code{\sourcefilename}
@@ -297,10 +261,10 @@ will normally be typeset in the form of a single output file.
 
 However, if you want multiple output files from the same @code{.ly}
 file, then you can add multiple @code{\book} blocks, where each such
-@code{\book} block will result in a separate output. If you do not
+@code{\book} block will result in a separate output.  If you do not
 specify any @code{\book} block in the file, LilyPond will implicitly
 treat the full file as a single @code{\book} block, see @ref{File
-structure}. One important exception is within lilypond-book documents,
+structure}.  One important exception is within lilypond-book documents,
 where you explicitly have to add a @code{\book} block, otherwise only
 the first @code{\score} or @code{\markup} will appear in the output.
 
@@ -335,11 +299,11 @@ the top of the file is inserted.
 @subsection Extracting fragments of notation
 
 It is possible to quote small fragments of a large score directly from
-the output. This can be compared to clipping a piece of a paper score
+the output.  This can be compared to clipping a piece of a paper score
 with scissors.
 
 This is done by definining the measures that need to be cut out
-separately. For example, including the following definition
+separately.  For example, including the following definition
 
 
 @verbatim
@@ -354,14 +318,14 @@ separately. For example, including the following definition
 
 @noindent
 will extract a fragment starting halfway the fifth measure, ending in
-the seventh measure. The meaning of @code{5 1 2} is: after a 1/2 note
+the seventh measure.  The meaning of @code{5 1 2} is: after a 1/2 note
 in measure 5, and @code{7 3 4} after 3 quarter notes in measure 7.
 
 More clip regions can be defined by adding more pairs of
 rhythmic-locations to the list. 
 
 In order to use this feature, LilyPond must be invoked with
-@code{-dclip-systems}. The clips are output as EPS files, and are
+@code{-dclip-systems}.  The clips are output as EPS files, and are
 converted to PDF and PNG if these formats are switched on as well.
 
 For more information on output formats, see @rprogram{Invoking lilypond}.
@@ -471,6 +435,80 @@ To use a Unicode escape sequence, use
 @lsr{text,utf-8.ly}
 
 
+@node Different editions from one source
+@subsection Different editions from one source
+
+@funindex \tag
+@cindex tag
+
+The @code{\tag} command marks music expressions with a name.  These
+tagged expressions can be filtered out later.  With this mechanism it
+is possible to make different versions of the same music source.
+
+In the following example, we see two versions of a piece of music, one
+for the full score, and one with cue notes for the instrumental part
+
+@example
+c1
+<<
+  \tag #'part <<
+    R1 \\
+    @{
+      \set fontSize = #-1
+      c4_"cue" f2 g4 @}
+  >>
+  \tag #'score R1
+>>
+c1
+@end example
+
+The same can be applied to articulations, texts, etc.: they are
+made by prepending
+@example
+-\tag #@var{your-tag}
+@end example
+to an articulation, for example,
+@example
+c1-\tag #'part ^4
+@end example
+
+This defines a note with a conditional fingering indication.
+
+@cindex keepWithTag
+@cindex removeWithTag
+By applying the @code{\keepWithTag} and @code{\removeWithTag}
+commands, tagged expressions can be filtered.  For example,
+@example
+<<
+  @var{the music}
+  \keepWithTag #'score @var{the music}
+  \keepWithTag #'part @var{the music}
+>>
+@end example
+would yield
+
+@lilypondfile[ragged-right,quote]{tag-filter.ly}
+
+The arguments of the @code{\tag} command should be a symbol
+(such as @code{#'score} or @code{#'part}), followed by a
+music expression.  It is possible to put multiple tags on
+a piece of music with multiple @code{\tag} entries,
+
+@example
+  \tag #'original-part \tag #'transposed-part @dots{}
+@end example
+
+
+@seealso
+
+Examples: @lsr{parts,tag@/-filter@/.ly}
+
+
+@refbugs
+
+Multiple rests are not merged if you create the score with both tagged
+sections.
+
 
 @node Titles and headers
 @section Titles and headers
@@ -813,10 +851,10 @@ top-level, or inside a music expression.
 @end verbatim
 
 The markups which are used to format the table of contents are defined
-in the @code{\paper} block. The default ones are @code{tocTitleMarkup},
+in the @code{\paper} block.  The default ones are @code{tocTitleMarkup},
 for formatting the title of the table, and @code{tocItemMarkup}, for
 formatting the toc elements, composed of the element title and page
-number. These variables may be changed by the user:
+number.  These variables may be changed by the user:
 
 @verbatim
 \paper {
@@ -837,7 +875,7 @@ the @code{tocItemMarkup} definition.
 
 New commands and markups may also be defined to build more elaborated
 table of contents:
-@itemize @bullet
+@itemize
 @item first, define a new markup variable in the @code{\paper} block
 @item then, define a music function which aims at adding a toc element
 using this markup paper variable.
@@ -954,11 +992,11 @@ to a score, for example,
 The tempo can be specified using the @code{\tempo} command within the 
 actual music, see @ref{Metronome marks}.  An alternative, which does not
 result in a metronome mark in the printed score, is shown in the example
-above. In this example the tempo of quarter notes is set to 72 beats per
+above.  In this example the tempo of quarter notes is set to 72 beats per
 minute. 
 This kind of tempo
-specification can not take dotted note lengths as an argument. In this
-case, break the dotted notes into smaller units. For example, a tempo
+specification can not take dotted note lengths as an argument.  In this
+case, break the dotted notes into smaller units.  For example, a tempo
 of 90 dotted quarter notes per minute can be specified as 270 eighth
 notes per minute
 
@@ -1051,7 +1089,7 @@ enclose the @code{\new Score} and the @code{\midi} in a @code{\score} block.
 
 
 The MIDI block is analogous to the layout block, but it is somewhat
-simpler.  The @code{\midi} block is similar to @code{\layout}. It can contain
+simpler.  The @code{\midi} block is similar to @code{\layout}.  It can contain
 context definitions.
 
 
@@ -1089,7 +1127,7 @@ instrument is used.
 @node Displaying LilyPond notation
 @section Displaying LilyPond notation
 
-@funindex \displayLilyMusc
+@funindex \displayLilyMusic
 Displaying a music expression in LilyPond notation can be
 done using the music function @code{\displayLilyMusic}.  For example,
 
@@ -1126,7 +1164,7 @@ When entering or copying music, usually only the music near the end (where
 you
 are adding notes) is interesting to view and correct.  To speed up
 this correction process, it is possible to skip typesetting of all but
-the last few measures. This is achieved by putting
+the last few measures.  This is achieved by putting
 
 @verbatim
 showLastLength = R1*5
@@ -1134,17 +1172,17 @@ showLastLength = R1*5
 @end verbatim
 
 @noindent
-in your source file. This will render only the last 5 measures
+in your source file.  This will render only the last 5 measures
 (assuming 4/4 time signature) of every @code{\score} in the input
-file. For longer pieces, rendering only a small part is often an order
+file.  For longer pieces, rendering only a small part is often an order
 of magnitude quicker than rendering it completely
 
 Skipping parts of a score can be controlled in a more fine-grained
 fashion with the property @code{Score.skipTypesetting}.  When it is
 set, no typesetting is performed at all.
 
-This property is also used to control output to the MIDI file. Note that
-it skips all events, including tempo and instrument changes. You have
+This property is also used to control output to the MIDI file.  Note that
+it skips all events, including tempo and instrument changes.  You have
 been warned.
 
 @lilypond[quote,fragment,ragged-right,verbatim]
diff --git a/Documentation/user/notation-appendices.itely b/Documentation/user/notation-appendices.itely
index 77c3d36679..18fe55756b 100644
--- a/Documentation/user/notation-appendices.itely
+++ b/Documentation/user/notation-appendices.itely
@@ -16,6 +16,9 @@
 * List of colors::              
 * The Feta font::               
 * Note head styles::            
+* Overview of text markup commands::  
+* Overview of text markup list commands::  
+* List of articulations::       
 @end menu
 
 
@@ -203,6 +206,60 @@ The following styles may be used for note heads.
 
 @lilypondfile[noindent]{note-head-style.ly}
 
+
+@node Overview of text markup commands
+@appendixsec Overview of text markup commands
+
+The following commands can all be used inside @code{\markup @{ @}}.
+
+@include markup-commands.tely
+
+@node Overview of text markup list commands
+@appendixsec Overview of text markup list commands
+
+The following commands can all be used with @code{\markuplines}.
+
+@include markup-list-commands.tely
+
+@node List of articulations
+@section List of articulations
+
+@cindex accent
+@cindex marcato
+@cindex staccatissimo
+@cindex espressivo
+@cindex fermata
+@cindex stopped
+@cindex staccato
+@cindex portato
+@cindex tenuto
+@cindex upbow
+@cindex downbow
+@cindex foot marks
+@cindex organ pedal marks
+@cindex turn
+@cindex open
+@cindex stopped
+@cindex flageolet
+@cindex reverseturn
+@cindex trill
+@cindex prall
+@cindex mordent
+@cindex prallprall
+@cindex prallmordent
+@cindex prall, up
+@cindex prall, down
+@cindex thumb marking
+@cindex segno
+@cindex coda
+@cindex varcoda
+
+Here is a chart showing all scripts available,
+
+@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+
+
 @ignore
 @n ode All context properties
 @a ppendixsec All context properties
diff --git a/Documentation/user/notation.itely b/Documentation/user/notation.itely
new file mode 100644
index 0000000000..98b4f03347
--- /dev/null
+++ b/Documentation/user/notation.itely
@@ -0,0 +1,33 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Musical notation
+@chapter Musical notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Pitches::            Writing and display the pitches of notes.
+* Rhythms::            Writing and displaying the durations of notes.
+* Expressive marks::   Adding expression to notes.
+* Repeats::            Repeat music.
+* Simultaneous notes:: More than one note at once.
+* Staff notation::     Displaying staves.
+* Educational use::    Special notation to increase legibility.
+* Text::               Adding text to scores.
+@end menu
+
+@include pitches.itely
+@include rhythms.itely
+@include expressive.itely
+@include repeats.itely
+@include simultaneous.itely
+@include staff.itely
+@include educational.itely
+@include text.itely
+
diff --git a/Documentation/user/percussion.itely b/Documentation/user/percussion.itely
new file mode 100644
index 0000000000..dc94f41d94
--- /dev/null
+++ b/Documentation/user/percussion.itely
@@ -0,0 +1,329 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Percussion
+@section Percussion
+
+@menu
+* Percussion sections::         
+@end menu
+
+@node Percussion sections
+@subsection Percussion sections
+
+Rhythmic music is primarily used for percussion and drum notation, but it can
+also be used to show the rhythms of melodies.
+
+@menu
+* Showing melody rhythms::      
+* Entering percussion::         
+* Percussion staves::           
+* Ghost notes::                 
+@end menu
+
+
+@node Showing melody rhythms
+@unnumberedsubsubsec Showing melody rhythms
+
+Sometimes you might want to show only the rhythm of a melody.  This
+can be done with the rhythmic staff.  All pitches of notes on such a
+staff are squashed, and the staff itself has a single line
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new RhythmicStaff {
+  \time 4/4
+  c4 e8 f g2 | r4 g r2 | g1:32 | r1 |
+}
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{RhythmicStaff}.
+
+
+@node Entering percussion
+@unnumberedsubsubsec Entering percussion
+
+@cindex percussion
+@cindex drums
+
+
+Percussion notes may be entered in @code{\drummode} mode, which is
+similar to the standard mode for entering notes.  Each piece of
+percussion has a full name and an abbreviated name, and both can be used
+in input files
+
+@lilypond[quote,ragged-right,verbatim]
+\drums {
+  hihat hh bassdrum bd
+}
+@end lilypond
+
+The complete list of drum names is in the init file
+@file{ly/@/drumpitch@/-init@/.ly}.
+@c TODO: properly document this.
+
+@seealso
+
+Program reference: @internalsref{note-event}.
+
+@node Percussion staves
+@unnumberedsubsubsec Percussion staves
+@cindex percussion
+@cindex drums
+
+A percussion part for more than one instrument typically uses a
+multiline staff where each position in the staff refers to one piece
+of percussion.
+
+
+To typeset the music, the notes must be interpreted in a
+@internalsref{DrumStaff} and @internalsref{DrumVoice} contexts
+
+@lilypond[quote,ragged-right,verbatim]
+up = \drummode { crashcymbal4 hihat8 halfopenhihat hh hh hh openhihat }
+down = \drummode { bassdrum4 snare8 bd r bd sn4 }
+  \new DrumStaff <<
+    \new DrumVoice { \voiceOne \up }
+    \new DrumVoice { \voiceTwo \down }
+  >>
+@end lilypond
+
+The above example shows verbose polyphonic notation.  The short
+polyphonic notation, described in @rlearning{I'm seeing Voices},
+can also be used if the @internalsref{DrumVoice}s are instantiated
+by hand first.  For example,
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new DrumStaff <<
+  \new DrumVoice = "1" { s1 *2 }
+  \new DrumVoice = "2" { s1 *2 }
+  \drummode {
+    bd4 sn4 bd4 sn4
+    <<
+      { \repeat unfold 16 hh16 }
+      \\
+      { bd4 sn4 bd4 sn4 }
+    >>
+  }
+>>
+@end lilypond
+
+
+There are also other layout possibilities.  To use these, set the
+property @code{drumStyleTable} in context @internalsref{DrumVoice}.
+The following variables have been predefined
+
+@table @code
+@item drums-style
+This is the default.  It typesets a typical drum kit on a five-line staff
+
+@lilypond[quote,line-width=10.0\cm]
+nam = \lyricmode {
+  cymc cyms cymr hh hhc hho hhho hhp
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
+mus = \drummode {
+  cymc cyms cymr hh hhc hho hhho hhp \break
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
+\score {
+  << \new DrumStaff \with {
+       \remove Bar_engraver
+       \remove Time_signature_engraver
+       \override Stem #'transparent = ##t
+       \override Stem #'Y-extent-callback = ##f
+       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
+     } \mus
+     \new Lyrics \nam
+  >>
+  \layout {
+    \context {
+      \Score
+      \override LyricText #'font-family = #'typewriter
+      \override BarNumber #'transparent =##T
+    }
+  }
+}
+@end lilypond
+
+The drum scheme supports six different toms.  When there are fewer toms,
+simply select the toms that produce the desired result, i.e., to get toms
+on the three middle lines you use @code{tommh}, @code{tomml}, and
+@code{tomfh}.
+
+@item timbales-style
+This typesets timbales on a two line staff
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { timh ssh timl ssl cb }
+mus = \drummode { timh ssh timl ssl cb s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+    \override StaffSymbol #'line-count = #2
+    \override StaffSymbol #'staff-space = #2
+    \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
+    drumStyleTable = #timbales-style
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item congas-style
+This typesets congas on a two line staff
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { cgh cgho cghm ssh cgl cglo cglm ssl }
+mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    drumStyleTable = #congas-style
+    \override StaffSymbol #'line-count = #2
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item bongos-style
+This typesets bongos on a two line staff
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { boh boho bohm ssh bol bolo bolm ssl }
+mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
+
+<<
+  \new DrumStaff \with {
+    \remove Bar_engraver
+    \remove Time_signature_engraver
+    \override StaffSymbol #'line-count = #2
+    drumStyleTable = #bongos-style
+
+    %% this sucks; it will lengthen stems.
+    \override StaffSymbol #'staff-space = #2
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+
+@item percussion-style
+To typeset all kinds of simple percussion on one line staves.
+
+@lilypond[quote,ragged-right]
+nam = \lyricmode { tri trio trim gui guis guil cb cl tamb cab mar hc }
+mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
+
+<<
+  \new DrumStaff \with{
+    \remove Bar_engraver
+    drumStyleTable = #percussion-style
+    \override StaffSymbol #'line-count = #1
+    \remove Time_signature_engraver
+    \override Stem #'transparent = ##t
+    \override Stem #'Y-extent-callback = ##f
+  } \mus
+  \new Lyrics {
+    \override LyricText #'font-family = #'typewriter
+    \nam
+  }
+>>
+@end lilypond
+@end table
+
+If you do not like any of the predefined lists you can define your own
+list at the top of your file
+
+@lilypond[quote,ragged-right,verbatim]
+#(define mydrums '(
+         (bassdrum     default   #f         -1)
+         (snare        default   #f         0)
+         (hihat        cross     #f         1)
+         (pedalhihat   xcircle   "stopped"  2)
+         (lowtom       diamond   #f         3)))
+up = \drummode { hh8 hh hh hh hhp4 hhp }
+down = \drummode { bd4 sn bd toml8 toml }
+
+\new DrumStaff <<
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
+  \new DrumVoice { \voiceOne \up }
+  \new DrumVoice { \voiceTwo \down }
+>>
+@end lilypond
+
+
+@seealso
+
+Init files: @file{ly/@/drumpitch@/-init@/.ly}.
+
+Program reference: @internalsref{DrumStaff}, @internalsref{DrumVoice}.
+
+@refbugs
+
+Because general MIDI does not contain rim shots, the sidestick is used
+for this purpose instead.
+
+
+@c TODO: check name -gp
+@node Ghost notes
+@unnumberedsubsubsec Ghost notes
+
+Ghost notes for drums and percussion may be created using the
+@code{\parenthesize} command detailed in @ref{Parentheses}.  However,
+the default @code{\drummode} does
+not include the @code{Parenthesis_engraver} plugin which allows
+this.  You
+must add the plugin explicitly in the context definition as
+detailed in @ref{Changing context properties on the fly}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\new DrumStaff \with {
+  \consists "Parenthesis_engraver"
+} <<
+  \context DrumVoice  = "1"  { s1 *2 }
+  \context DrumVoice  = "2" { s1 *2 }
+  \drummode {
+    <<
+      {
+        hh8[ hh] <hh sn> hh16
+        < \parenthesize sn > hh < \parenthesize
+        sn > hh8 <hh sn> hh
+      } \\ {
+        bd4 r4 bd8 bd r8 bd
+      }
+    >>
+  }
+>>
+@end lilypond
+
+@noindent
+Also note that you must add chords (@code{< >} brackets)
+around each @code{\parenthesize} statement.
+
+
+
diff --git a/Documentation/user/piano.itely b/Documentation/user/piano.itely
new file mode 100644
index 0000000000..3c18be1ec9
--- /dev/null
+++ b/Documentation/user/piano.itely
@@ -0,0 +1,276 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Piano music
+@section Piano music
+
+@menu
+* Piano sections::              
+@end menu
+
+@node Piano sections
+@subsection Piano sections
+
+Piano staves are two normal staves coupled with a brace.  The staves
+are largely independent, but sometimes voices can cross between the
+two staves.  The same notation is also used for harps and other key
+instruments.  The @internalsref{PianoStaff} is especially built to
+handle this cross-staffing behavior.  In this section we discuss the
+@internalsref{PianoStaff} and some other pianistic peculiarities.
+
+@menu
+* Automatic staff changes::     
+* Manual staff switches::       
+* Pedals::                      
+* Staff switch lines::          
+* Cross staff stems::           
+@end menu
+
+@refbugs
+
+Dynamics are not centered, but workarounds do exist.  See the
+@q{piano centered dynamics} template in @rlearning{Piano templates}.
+
+@cindex cross staff stem
+@cindex stem, cross staff
+@cindex distance between staves in piano music
+
+
+@node Automatic staff changes
+@unnumberedsubsubsec Automatic staff changes
+@cindex Automatic staff changes
+
+Voices can be made to switch automatically between the top and the bottom
+staff.  The syntax for this is
+
+@quotation
+@example
+\autochange @dots{}@var{music}@dots{}
+@end example
+@end quotation
+
+@noindent
+This will create two staves inside the current PianoStaff, called
+@code{up} and @code{down}.  The lower staff will be in bass clef by
+default.
+
+A @code{\relative} section that is outside of @code{\autochange} has
+no effect on the pitches of @var{music}, so, if necessary, put
+@code{\relative} inside @code{\autochange} like
+
+@quotation
+@example
+\autochange \relative @dots{} @dots{}
+@end example
+@end quotation
+
+
+The autochanger switches on basis of the pitch (middle C is the turning
+point), and it looks ahead skipping over rests to switch in
+advance.  Here is a practical example
+
+@lilypond[quote,verbatim,ragged-right]
+\new PianoStaff
+  \autochange \relative c'
+  {
+    g4 a b c d r4 a g
+  }
+@end lilypond
+
+
+@seealso
+
+In this manual: @ref{Manual staff switches}.
+
+Program reference: @internalsref{AutoChangeMusic}.
+
+
+
+@refbugs
+
+The staff switches may not end up in optimal places.  For high
+quality output, staff switches should be specified manually.
+
+
+@code{\autochange} cannot be inside @code{\times}.
+
+
+@node Manual staff switches
+@unnumberedsubsubsec Manual staff switches
+
+@cindex manual staff switches
+@cindex staff switch, manual
+
+Voices can be switched between staves manually, using the command
+@example
+\change Staff = @var{staffname} @var{music}
+@end example
+
+@noindent
+The string @var{staffname} is the name of the staff.  It switches the
+current voice from its current staff to the Staff called
+@var{staffname}.  Typically @var{staffname} is @code{"up"} or
+@code{"down"}.  The @context{Staff} referred to must already exist, so
+usually the setup for a score will start with a setup of the staves,
+
+@example
+<<
+  \new Staff = "up" @{
+    \skip 1 * 10  % @emph{keep staff alive}
+    @}
+  \new Staff = "down" @{
+    \skip 1 * 10  % @emph{idem}
+    @}
+>>
+@end example
+
+
+and the @context{Voice} is inserted afterwards
+
+@example
+\context Staff = down
+  \new Voice @{ @dots{} \change Staff = up @dots{} @}
+@end example
+
+
+@node Pedals
+@unnumberedsubsubsec Pedals
+@cindex Pedals
+
+Pianos have pedals that alter the way sound is produced.  Generally, a
+piano has three pedals, sustain, una corda, and sostenuto.
+
+
+Piano pedal instruction can be expressed by attaching
+@code{\sustainDown}, @code{\sustainUp}, @code{\unaCorda},
+@code{\treCorde}, @code{\sostenutoDown} and @code{\sostenutoUp} to a
+note or chord
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+c'4\sustainDown c'4\sustainUp
+@end lilypond
+
+What is printed can be modified by setting @code{pedal@var{X}Strings},
+where @var{X} is one of the pedal types: @code{Sustain},
+@code{Sostenuto} or @code{UnaCorda}.  Refer to
+@internalsref{SustainPedal} in the program reference for more
+information.
+
+Pedals can also be indicated by a sequence of brackets, by setting the
+@code{pedalSustainStyle} property to bracket objects
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'bracket
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+A third style of pedal notation is a mixture of text and brackets,
+obtained by setting the @code{pedalSustainStyle} property to
+@code{mixed}
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\set Staff.pedalSustainStyle = #'mixed
+c\sustainDown d e
+b\sustainUp\sustainDown
+b g \sustainUp a \sustainDown \bar "|."
+@end lilypond
+
+The default @q{*Ped.} style for sustain and damper pedals corresponds to
+style @code{#'text}.  The sostenuto pedal uses @code{mixed} style by
+default.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+For fine-tuning the appearance of a pedal bracket, the properties
+@code{edge-width}, @code{edge-height}, and @code{shorten-pair} of
+@code{PianoPedalBracket} objects (see
+@internalsref{PianoPedalBracket} in the Program reference) can be
+modified.  For example, the bracket may be extended to the right edge
+of the note head
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
+c\sostenutoDown d e c, f g a\sostenutoUp
+@end lilypond
+
+@seealso
+
+In this manual: @ref{Ties} (laissez vibrer).
+
+@node Staff switch lines
+@unnumberedsubsubsec Staff switch lines
+
+
+@cindex follow voice
+@cindex staff switching
+@cindex cross staff
+
+@funindex followVoice
+
+Whenever a voice switches to another staff, a line connecting the notes
+can be printed automatically.  This is switched on by setting
+@code{followVoice} to true
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+\new PianoStaff <<
+  \new Staff="one" {
+    \set followVoice = ##t
+    c1
+    \change Staff=two
+    b2 a
+  }
+  \new Staff="two" { \clef bass \skip 1*2 }
+>>
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{VoiceFollower}.
+
+@refcommands
+
+@funindex \showStaffSwitch
+@code{\showStaffSwitch},
+@funindex \hideStaffSwitch
+@code{\hideStaffSwitch}.
+
+
+@node Cross staff stems
+@unnumberedsubsubsec Cross staff stems
+
+Chords that cross staves may be produced by increasing the length
+of the stem in the lower staff, so it reaches the stem in the upper
+staff, or vice versa.
+
+@lilypond[ragged-right,verbatim,quote]
+stemExtend = {
+  \once \override Stem #'length = #10
+  \once \override Stem #'cross-staff = ##t
+}
+noFlag = \once \override Stem #'flag-style = #'no-flag
+\new PianoStaff <<
+  \new Staff {
+    \stemDown \stemExtend
+    f'4
+    \stemExtend \noFlag
+    f'8
+  }
+  \new Staff {
+    \clef bass
+    a4 a8
+  }
+>>
+@end lilypond
+
+
+
+
diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
new file mode 100644
index 0000000000..b1ec14c5d4
--- /dev/null
+++ b/Documentation/user/pitches.itely
@@ -0,0 +1,1444 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+
+@node Pitches
+@section Pitches
+
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{pitches-headword.ly}
+
+This section discusses how to specify the pitch of notes.  There
+are three steps to this process: input, modifying, and output.
+
+@menu
+* Writing pitches::             
+* Changing multiple pitches::   
+* Displaying pitches::          
+@end menu
+
+
+@node Writing pitches
+@subsection Writing pitches
+
+This section discusses how to input pitches.
+
+@menu
+* Absolute octave entry::       
+* Relative octave entry::       
+* Accidentals::                 
+* Note names in other languages::  
+@end menu
+
+
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
+
+@cindex Pitch names
+@cindex pitches
+
+@c don't use @samp here because that might get confused with
+@c octave marks
+A pitch name is specified using lowercase letters @code{a} through
+@code{g}.  An ascending C-major scale is engraved with
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef bass
+c d e f g a b c'
+@end lilypond
+
+There are two different ways to enter these note names with regard
+to octave placement: absolute and relative.  The relative mode
+will in most cases be the most convenient, but the absolute mode
+is more fundamental and will be presented first.
+
+@cindex Absolute
+@cindex Absolute octave specification
+
+@c don't use @samp here because that might get confused with
+@c octave marks
+In absolute mode, every note is placed explicitly in a certain
+octave.  The note names @code{c} to @code{b} are engraved in the
+octave below middle C, as in the previous example.
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\clef treble
+c1
+\clef bass
+c1
+@end lilypond
+
+@funindex '
+@funindex ,
+
+If a note should be in another octave than this, an octave
+specification must be given.  It takes the form of a series of
+single quote (@code{'}) or comma (@code{,}) characters.  Each
+@code{'} raises the pitch by one octave; each @code{,} lowers the
+pitch by an octave.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\clef treble
+c' c'' e' g d'' d' d c
+\clef bass
+c, c,, e, g d,, d, d c
+@end lilypond
+
+@seealso
+
+Snippets: @lsrdir{pitch}
+
+Program reference: @internalsref{LedgerLineSpanner},
+@internalsref{NoteHead}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octaves entry
+
+@cindex Relative
+@cindex Relative octave specification
+@funindex \relative
+
+The absolute mode requires a lot of octave specifications, which
+not only becomes tedious but also easily leads to errors.
+Therefore, it is usually more convenient to let notes be entered
+relative to the previous note.  This is done with the relative
+mode.  
+
+@example
+\relative @var{startpitch} @var{musicexpr}
+@end example
+
+In relative mode, each note is assumed to be as close to the
+previous note as possible.  This means that the octave of notes
+that appear in @var{musicexpr} are calculated as follows:
+
+@itemize
+@item 
+The pitch of the first note is relative to @code{\relative
+@var{startpitch} }.  
+
+@item
+If no octave changing marks are used, the basic interval between a
+note and the one that precedes it is always taken to be a fourth
+or less.
+
+@item
+This distance is determined without regarding alterations or the
+actual sounding pitches; a @code{fisis} following a @code{ceses}
+will be put above the @code{ceses}.  In other words, a
+doubly-augmented fourth is considered a smaller interval than a
+diminished fifth, even though the doubly-augmented fourth spans
+seven semitones while the diminished fifth only spans six
+semitones.
+
+@item
+The octave changing marks @code{'} and @code{,} can be added to
+raise or lower the pitch by an extra octave from the basic
+interval.
+
+@item
+Multiple octave changing marks can be used.  @code{''} will raise
+the pitch by two octaves.
+
+@end itemize 
+
+Here is the relative mode shown in action:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+Octave changing marks are used for intervals greater than a
+fourth:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+A note sequence without a single octave mark can nevertheless span
+large intervals:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c {
+  c f b e a d g
+}
+@end lilypond
+
+If the preceding item is a chord, the first note of the chord is
+used as the reference point for the octave placement of a
+following note or chord:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g> c
+}
+@end lilypond
+
+The @var{startpitch} (after @code{\relative}) is a note name in
+absolute mode.  In principle it can be any note name, but common
+practice is to use @code{c} in various octave positions. 
+
+When octaves are specified as above by adding @code{'} and
+@code{,} to pitch names, it is easy to accidentally put a pitch in
+the wrong octave.  The relative octave mode prevents these errors
+since most of the time it is not necessary to indicate any octaves
+at all.  Furthermore, in absolute mode, a single mistake may be
+difficult to spot; in relative mode, a single error puts the rest
+of the piece off by one octave.
+
+@seealso
+
+Snippets: @lsrdir{pitch}
+
+
+@refbugs
+
+The relative conversion will not affect @code{\transpose},
+@code{\chordmode} or @code{\relative} sections in its argument.
+To use relative within transposed music, an additional
+@code{\relative} must be placed inside @code{\transpose}.
+
+@c DEPRECATED
+If no @var{startpitch} is specified for @code{\relative}, then
+@code{c'} is assumed.  However, this is a deprecated option and
+may disappear in future versions, so its use is discouraged.
+
+
+
+@node Accidentals
+@unnumberedsubsubsec Accidentals
+
+@warning{New users are sometimes confused about accidentals and
+key signatures.  In LilyPond, note names are the raw input; key
+signatures and clefs determine how this raw input is displayed.
+An unaltered note like @code{c} means @q{C natural}, regardless of
+the key signature or clef.  For more information, see
+@rlearning{Accidentals and key signatures}.}
+
+@cindex note names, Dutch
+@cindex note names, default
+
+A @notation{sharp} pitch is made by adding @code{is} to the name,
+and a @notation{flat} pitch by adding @code{es}.  As you might
+expect, a @notation{double sharp} or @notation{double flat} is
+made by adding @code{isis} or @code{eses}.  This syntax derived
+from note naming conventions in Nordic and Germanic languages,
+like German and Dutch.  To use other names for accidentals, see
+@ref{Note names in other languages}.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a2 ais a aes
+a2 aisis a aeses
+@end lilypond
+
+@noindent
+These are the Dutch note names.  In Dutch, @code{aes} is
+contracted to @code{as}, but both forms are accepted.  Similarly,
+both @code{es} and @code{ees} are accepted:
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a2 as e es
+@end lilypond
+
+A natural will cancel the effect of an accidental or key
+signature.  However, naturals are not encoded into the note name
+syntax with a suffix; a natural pitch is shown as a simple note
+name:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a4 aes a2
+@end lilypond
+
+
+@cindex accidental, reminder
+@cindex accidental, cautionary
+@cindex accidental, parenthesized
+@cindex reminder accidental
+@funindex ?
+@cindex cautionary accidental
+@cindex parenthesized accidental
+@funindex !
+
+Normally accidentals are printed automatically, but you may also
+print them manually.  A reminder accidental can be forced by
+adding an exclamation mark @code{!} after the pitch.  A cautionary
+accidental (i.e., an accidental within parentheses) can be
+obtained by adding the question mark @code{?} after the pitch.
+These extra accidentals can be used to produce natural signs, too.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
+cis cis cis! cis? c c? c! c
+@end lilypond
+
+
+@cindex quarter tones
+@cindex semi-flats, semi-sharps
+
+Half-flats and half-sharps are formed by adding @code{eh} and
+@code{ih}; the following is a series of Cs with increasing
+pitches
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Micro tones are also exported to the MIDI file.
+
+
+@commonprop
+
+In accordance with standard typesetting rules, a natural sign is
+printed before a sharp or flat if a previous accidental needs to
+be cancelled.  To change this behavior, use
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+ceses4 ces cis c
+\set Staff.extraNatural = ##f
+ceses4 ces cis c
+@end lilypond
+
+
+@seealso
+
+Music glossary: @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
+@rglos{double flat}.
+
+Notation reference: @ref{Automatic accidentals}, @ref{Musica ficta
+accidentals}.
+
+Snippets: @lsrdir{pitch}
+
+
+@refbugs
+
+There are no generally accepted standards for denoting
+three-quarter flats, so LilyPond's symbol does not conform to any
+standard.
+
+
+
+@node Note names in other languages
+@unnumberedsubsubsec Note names in other languages
+
+There are predefined sets of note names for various other
+languages.  To use them, include the language specific init file.
+For example, add @code{\include "english.ly"} to the top of the
+input file.  The available language files and the note names they
+define are:
+
+@cindex note names, other languages
+
+@example
+@multitable @columnfractions .2 .6 .05 .05 .05 .05
+@headitem Language
+  @tab Note names
+  @tab sharp @tab flat @tab double sharp @tab double flat
+@item netherlands.ly
+  @tab c d e f g a bes b
+  @tab -is @tab -es @tab -isis @tab -eses
+@item english.ly
+  @tab c d e f g a bf b 
+  @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
+    @tab -ff/-flatflat
+@item deutsch.ly
+  @tab c d e f g a b h 
+  @tab -is @tab -es @tab -isis @tab -eses
+@item norsk.ly
+  @tab c d e f g a b h 
+  @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
+    @tab -essess/-eses
+@item svenska.ly
+  @tab c d e f g a b h 
+  @tab -iss @tab -ess @tab -ississ @tab -essess
+@item italiano.ly
+  @tab do re mi fa sol la sib si 
+  @tab -d @tab -b @tab -dd @tab -bb
+@item catalan.ly
+  @tab do re mi fa sol la sib si 
+  @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
+@item espanol.ly
+  @tab do re mi fa sol la sib si 
+  @tab -s @tab -b @tab -ss @tab -bb
+@end multitable
+@end example
+
+@noindent
+Note that in Dutch, German, Norwegian, and Swedish, the flat
+alterations of @code{a} like for example @code{aes} and
+@code{aeses} are usually contracted to @code{as} and @code{ases}
+(or more commonly @code{asas}).  Sometimes only these contracted
+names are defined in the corresponding language files (this also
+applies to the suffixes for quartertones below).
+
+@noindent
+Some music uses microtones whose alterations are fractions of a
+@q{normal} sharp or flat.  The note names for quartertones defined
+in the various language files are listed in the following table.
+Here the prefixes @q{semi-} and @q{sesqui-} mean @q{half} and
+@q{one and a half}, respectively.  For Norwegian, Swedish, Catalan
+and Spanish no special names have been defined yet.
+
+
+@c What about Turkish Maquam music and similar microtonal systems?
+@c
+@c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code 
+@c is actually misleading since the alteration is in fact one and a half
+@c of a regular sharp/flat.  Whence the naming "sesqui-sharp/-flat" used below.
+
+@example
+@multitable @columnfractions .2 .6 .05 .05 .05 .05
+@headitem Language
+  @tab Note names
+  @tab semi- @tab semi- @tab sesqui- @tab sesqui-
+
+@item nederlands.ly
+  @tab c d e f g a bes b 
+  @tab -ih @tab -eh @tab -isih @tab -eseh
+@item english.ly
+  @tab c d e f g a bf b 
+  @tab -qs @tab -qf @tab -tqs @tab -tqf
+@item deutsch.ly
+  @tab c d e f g a b h 
+  @tab -ih @tab -eh @tab -isih @tab -eseh
+@c @item norsk.ly
+@c   @tab c d e f g a b h 
+@c @item svenska.ly
+@c   @tab c d e f g a b h 
+@item italiano.ly
+  @tab do re mi fa sol la sib si 
+  @tab -sd @tab -sb @tab -dsd @tab -bsb
+@c @item catalan.ly 
+@c   @tab do re mi fa sol la sib si 
+@c @item  espanol.ly 
+@c   @tab do re mi fa sol la sib si 
+@end multitable
+@end example
+
+@seealso
+
+Snippets: @lsrdir{pitch}
+
+
+
+@node Changing multiple pitches
+@subsection Changing multiple pitches
+
+This section discusses how to modify pitches.
+
+@menu
+* Octave check::                
+* Transpose::                   
+@end menu
+
+@node Octave check
+@unnumberedsubsubsec Octave check
+
+@cindex Octave check
+
+In relative mode, it is easy to forget an octave changing mark.
+Octave checks make such errors easier to correct. A note may be
+followed by @code{=}@var{quotes} to indicate what its absolute
+octave should be.  In the following example,
+
+@example
+\relative c'' @{ c g d='' @}
+@end example
+
+@noindent
+the @code{d} will generate a warning, because a
+@code{d''} is expected, as indicated by the octave check
+@code{=''}, but a @code{d'} is found, since both @code{c}-@code{g}
+and @code{g}-@code{d} without octavation marks are descending
+fourths.  In the output, the octave is corrected to be a
+@code{d''} and the next note is calculated relative to @code{d''}
+instead of @code{d'}.
+
+There is also an octave check that produces no visible output.
+The syntax is:
+
+@example
+@var{pitch} \octave @var{controlpitch}
+@end example
+
+where @var{pitch} is a regular note within a music expression in
+relative mode and @var{controlpitch} is a pitch in absolute mode.
+This checks that @var{pitch} lies within the octave surrounding
+@var{controlpitch}, i.e. not more than a fourth above or below it.
+If this is not the case, a warning is printed and the octave is
+corrected.  The @var{controlpitch} is not printed as a note.
+
+In the example below, the first check passes without incident,
+since the @code{e} (in @code{relative} mode) is within the octave
+range of @code{a'}.  However, the second check produces a warning,
+since the @code{e} is not within the octave range of @code{b'}.
+The warning message is printed, and the octave is adjusted so that
+the following notes are in the correct octave once again.
+
+@example
+\relative c' @{
+  e
+  \octave a'
+  \octave b'
+@}
+@end example
+
+
+The octave of a note following an @code{\octave} check is
+determined with respect to the note preceding it, as modified by
+the outcome of the octave check.  In the next fragment, the first
+note, an @code{e'}, lies within the octave of @code{b}, and the
+@code{\octave} check passes successfully. The second note is then
+calculated relative to (absolute) @code{e'}, which yields an 
+@code{a'}, above middle C.  In this case, the check had no
+influence on the output of the piece.
+
+The second @code{\octave} check fails: @code{a'} is not within the
+range of @code{b}. A warning is issued, and the last note is
+calculated relative to @code{a}, not to @code{a'}, and we get a
+@code{d'}.  Without the last @code{\octave} check, the last note
+would have been a @code{d''}
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' {
+  e
+  \octave b
+  a
+  \octave b
+  d
+}
+@end lilypond
+
+@seealso
+
+Snippets: @lsrdir{pitch}
+
+
+@node Transpose
+@unnumberedsubsubsec Transpose
+
+@cindex Transpose
+@cindex Transposition of pitches
+@funindex \transpose
+
+A music expression can be transposed with @code{\transpose}.  The
+syntax is
+
+@example
+\transpose @var{from} @var{to} @var{musicexpr}
+@end example
+
+This means that @var{musicexpr} is transposed by the interval
+between the pitches @var{from} and @var{to}: any note with pitch
+@var{from} is changed to @var{to} and any other note is transposed
+by the same interval.
+
+Consider a piece written in the key of D-major.  If this piece is
+a little too low for its performer, it can be transposed up to
+E-major with
+
+@example
+\transpose d e @dots{}
+@end example
+
+Consider a part written for violin (a C instrument).  If this part
+is to be played on the A clarinet (for which an A is notated as a
+C, and thus sounds a minor third lower than notated), the
+following transposition will produce the appropriate part:
+
+@example
+\transpose a c @dots{}
+@end example
+
+@code{\transpose} will also transpose key signatures:
+
+@lilypond[quote,ragged-right,verbatim]
+mus = { \key d \major cis d fis g }
+\new Staff {
+  \clef "F" \mus
+  \clef "G"
+  \transpose c g' \mus
+  \transpose c f' \mus
+}
+@end lilypond
+
+@code{\transpose} distinguishes between enharmonic pitches: both
+@code{\transpose c cis} or @code{\transpose c des} will transpose
+up half a tone.  The first version will print sharps and the notes
+will remain on the same scale step, the second version will print
+flats on the scale step above.
+
+@lilypond[quote,ragged-right,verbatim]
+mus = { c d e f }
+\new Staff {
+  \transpose c cis { \relative c' \mus }
+  \transpose c des { \relative c' \mus }
+}
+@end lilypond
+
+@code{\transpose} may also be used to input written notes for a
+transposing instrument.  The previous examples show how to enter
+pitches in C (or @notation{concert pitch}) and typeset them for a
+transposing instrument, but the opposite is also possible if you
+for example have a set of instrumental parts and want to print a
+conductor's score. For example, when entering music for a B-flat
+trumpet which begins on a notated E (concert D), one would write:
+
+@example
+musicInBflat = @{ e4 @dots{} @}
+\transpose c bes \musicInBflat
+@end example
+
+To print this music in F (e.g., rearranging to a french horn) you
+would wrap the existing music with another @code{\transpose}
+
+@example
+musicInBflat = @{ e4 @dots{} @}
+\transpose f c @{ \transpose c bes \musicInBflat @}
+@end example
+
+@seealso
+
+Snippets: @lsrdir{pitch}, @lsr{scheme,
+transpose-pitches-with-minimum-accidentals.ly}.
+
+Program reference: @internalsref{TransposedMusic}.
+
+@refbugs
+
+If you want to use both @code{\transpose} and @code{\relative},
+you must put @code{\transpose} outside of @code{\relative}, since
+@code{\relative} will have no effect on music that appears inside
+a @code{\transpose}. See the previous example. 
+
+
+@node Displaying pitches
+@subsection Displaying pitches
+
+This section discusses how to alter the output of pitches.
+
+@menu
+* Clef::                        
+* Key signature::               
+* Ottava brackets::             
+* Instrument transpositions::   
+* Automatic accidentals::       
+@end menu
+
+@node Clef
+@unnumberedsubsubsec Clef
+
+@funindex \clef
+
+@cindex G clef
+@cindex C clef
+@cindex F clef
+@cindex treble clef
+@cindex violin clef
+@cindex alto clef
+@cindex tenor clef
+@cindex bass clef
+@cindex french clef
+@cindex soprano clef
+@cindex mezzosoprano clef
+@cindex baritone clef
+@cindex varbaritone clef
+@cindex subbass clef
+
+The clef is set with the @code{\clef} @var{clefname} 
+command:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+  \new Staff {
+    % treble clef by default
+    c'1^"middle C"
+  }
+  \new Staff {
+    \clef alto
+    c'1^"middle C"
+  }
+  \new Staff {
+    \clef bass
+    c'1^"middle C"
+  }
+>>
+@end lilypond
+
+The clef can also be changed inside the staff:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new PianoStaff <<
+  \new Staff {
+    \time 2/4
+    \clef treble
+    r16
+    \clef bass
+    e g c' e' e g c'
+  }
+  \new Staff {
+    \clef bass
+    c,8 r \clef treble g''4
+  }
+>>
+@end lilypond
+
+These same clef symbols are used in different positions on
+the staff to change the range of notes shown by that staff.
+The treble (alto, bass) clef is always positioned to show
+the line on which a g' (c', f) note is printed.
+ 
+Supported clefs include
+
+@multitable @columnfractions .4 .6
+@headitem Clef @tab Position
+@item @code{treble, violin, G, G2} @tab
+G clef (g') on 2nd line
+@item @code{alto, C} @tab
+C clef (c') on 3rd line
+@item @code{tenor} @tab
+C clef (c') on 4th line.
+@item @code{bass, F} @tab
+F clef (f) on 4th line
+@item @code{french} @tab
+G clef (g') on 1st line, so-called French violin clef
+@item @code{soprano} @tab
+C clef (c') on 1st line
+@item @code{mezzosoprano} @tab
+C clef (c') on 2nd line
+@item @code{baritone} @tab
+C clef (c') on 5th line
+@item @code{varbaritone} @tab
+F clef (f) on 3rd line
+@item @code{subbass} @tab
+F clef (f) on 5th line
+@item @code{percussion} @tab
+percussion clef
+@item @code{tab} @tab
+tablature clef
+@end multitable
+
+Further supported clefs are described under @ref{Ancient clefs}.
+
+By adding @code{_8} or @code{^8} to the clef name, the clef is
+transposed one octave down or up, respectively, and @code{_15} and
+@code{^15} transposes by two octaves.  The argument @var{clefname}
+must be enclosed in quotes when it contains underscores or digits.
+For example,
+
+@cindex choral tenor clef
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
+\clef "G_8" c4
+@end lilypond
+
+@commonprop
+
+When a clef change takes place at a line break the new clef symbol
+is printed at both the end of the previous line and the beginning
+of the new line by default.  If the warning clef at the end of the
+previous line in not required it can be suppressed by setting the
+@code{explicitClefVisibility} Staff property to the value
+@var{end-of-line-invisible}:  @code{\set
+Staff.explicitClefVisibility = #end-of-line-invisible} The default
+behaviour can be recovered with @code{\unset
+Staff.explicitClefVisibility}
+
+The command @code{\clef "treble_8"} is equivalent to setting
+@code{clefGlyph}, @code{clefPosition} (which controls the Y
+position of the clef), @code{middleCPosition} and
+@code{clefOctavation}.  A clef is printed when either the
+@code{clefGlyph}, @code{clefPosition} or @code{clefOctavation}
+properties are changed.  Note that changing the glyph, the
+position of the clef, or the octavation, does not in itself change
+the position of subsequent notes on the staff: the position of
+middle C must also be specified to do this.  The positional
+parameters are relative to the staff centre line, positive numbers
+displacing upwards, counting 1 for each line and space.  The
+clefOctavation value would normally be set to 7, -7, 15 or -15,
+but other values are not invalid.
+
+The following examples show the possibilities when setting these
+properties manually.  First some manual changes which preserve the
+standard relative positioning of clefs and notes:
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  % The default treble clef
+  c'4
+  % The standard bass clef
+  \set Staff.clefGlyph = #"clefs.F"
+  \set Staff.clefPosition = #2
+  \set Staff.middleCPosition = #6
+  c'4
+  % The baritone clef
+  \set Staff.clefGlyph = #"clefs.C"
+  \set Staff.clefPosition = #4
+  \set Staff.middleCPosition = #4
+  c'4
+  % The standard choral tenor clef
+  \set Staff.clefGlyph = #"clefs.G"
+  \set Staff.clefPosition = #-2
+  \set Staff.clefOctavation = #-7
+  \set Staff.middleCPosition = #1
+  c'4
+  % A non-standard clef
+  \set Staff.clefPosition = #0
+  \set Staff.clefOctavation = #0
+  \set Staff.middleCPosition = #-4
+  c'4
+}
+@end lilypond
+
+and some which do not:
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  \set Staff.clefGlyph = #"clefs.F"
+  \set Staff.clefPosition = #2
+  c'4
+  \set Staff.clefGlyph = #"clefs.G"
+  c'4
+  \set Staff.clefGlyph = #"clefs.C"
+  c'4
+  \set Staff.clefOctavation = #7
+  c'4
+  \set Staff.clefOctavation = #0
+  \set Staff.clefPosition = #0
+  c'4
+  \set Staff.middleCPosition = #4
+  c'4
+}
+@end lilypond
+
+@seealso
+
+Notation reference: @ref{Ancient clefs}.
+
+Snippets: @lsrdir{pitch}
+
+Program reference: @internalsref{Clef}.
+
+
+@node Key signature
+@unnumberedsubsubsec Key signature
+
+@cindex Key signature
+@funindex \key
+
+@warning{New users are sometimes confused about accidentals and
+key signatures.  In LilyPond, note names are the raw input; key
+signatures and clefs determine how this raw input is displayed.
+An unaltered note like @code{c} means @q{C natural}, regardless of
+the key signature or clef.  For more information, see
+@rlearning{Accidentals and key signatures}.}
+
+The key signature indicates the tonality in which a piece is
+played.  It is denoted by a set of alterations (flats or sharps)
+at the start of the staff.
+
+Setting or changing the key signature is done with the @code{\key}
+command:
+
+@example
+\key @var{pitch} @var{type}
+@end example
+
+@funindex \minor
+@funindex \major
+@funindex \minor
+@funindex \ionian
+@funindex \locrian
+@funindex \aeolian
+@funindex \mixolydian
+@funindex \lydian
+@funindex \phrygian
+@funindex \dorian
+@cindex church modes
+
+Here, @var{type} should be @code{\major} or @code{\minor} to get
+@var{pitch}-major or @var{pitch}-minor, respectively.  You may
+also use the standard mode names (also called @q{church modes}):
+@code{\ionian}, @code{\locrian}, @code{\aeolian},
+@code{\mixolydian}, @code{\lydian}, @code{\phrygian}, and
+@code{\dorian}.
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\key g \major
+f1
+fis
+@end lilypond
+
+
+@commonprop
+
+A natural sign is printed to cancel any previous accidentals.
+This may be altered:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+\set Staff.printKeyCancellation = ##f
+\key d \major
+a b cis d
+\key g \minor
+a bes c d
+@end lilypond
+
+The @code{\key} command sets the context property
+@code{Staff.keySignature}.  Non-standard key signatures can be
+specified by setting this property directly.  The format of this
+command is a list:
+
+@example
+\set Staff.keySignature = #'((@var{octave} .  @var{step}) . @var{alter})
+@end example
+
+@noindent
+where, for each element in the list, @var{octave} specifies the
+octave (0 being the octave from middle C to the B above),
+@var{step} specifies the note within the octave (0 means C and 6
+means B), and @var{alter} is ,SHARP ,FLAT ,DOUBLE-SHARP etc.
+(Note the leading comma.)  Here is an example of a possible key
+signature for generating a whole-tone scale:
+
+@lilypond[quote,ragged-right,verbatim]
+\relative c'
+  \new Staff {
+    \set Staff.keySignature = 
+      #`(((0 .  3) . ,SHARP) ((0 . 5) . ,FLAT) ((0 . 6) . ,FLAT))
+    c d e fis aes bes c
+}
+@end lilypond
+
+@seealso
+
+Music glossary: @rglos{Church mode}, @rglos{scordatura}.
+
+Snippets: @lsrdir{pitch},
+FIXME link to snippet 248,
+FIXME link to a snippet about scordatura.
+
+Program reference: @internalsref{KeyCancellation},
+@internalsref{KeySignature}, @internalsref{Key_engraver}
+
+
+@node Ottava brackets
+@unnumberedsubsubsec Ottava brackets
+
+@cindex ottava
+@cindex 15ma
+@cindex 8va
+@cindex 8ve
+@cindex octavation
+
+@notation{Ottava brackets} introduce an extra transposition of an
+octave for the staff:
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c''' {
+  a2 b
+  #(set-octavation 1)
+  a b
+  #(set-octavation 0)
+  a b
+}
+@end lilypond
+
+The @code{set-octavation} function also takes -1 (for 8va bassa),
+2@tie{}(for 15ma), and -2 (for 15ma bassa) as arguments.
+Internally the function sets the properties @code{ottavation}
+(e.g., to @code{"8va"} or @code{"8vb"}) and
+@code{middleCPosition}.  To override the text of the bracket, set
+@code{ottavation} after invoking @code{set-octavation}, i.e.,
+
+@lilypond[quote,ragged-right,verbatim]
+{
+  #(set-octavation 1)
+  \set Staff.ottavation = #"8"
+  c'''
+}
+@end lilypond
+
+
+@seealso
+
+Snippets: @lsrdir{pitch}
+
+Program reference: @internalsref{OttavaBracket}.
+
+
+@refbugs
+
+@code{set-octavation} will get confused when clef changes happen
+during an octavation bracket.
+
+
+@node Instrument transpositions
+@unnumberedsubsubsec Instrument transpositions
+
+@cindex transposition, MIDI
+@cindex transposition, instrument
+
+The key of a @notation{transposing instrument} can be specified.
+This applies to many wind instruments, for example, clarinets
+(B-flat, A, and E-flat), horn (F) and trumpet (B-flat, C, D, and
+E-flat).
+
+The transposition is entered with the command
+
+@example
+\transposition @var{pitch}
+@end example
+
+@noindent
+where @var{pitch} specifies the key in which the instrument plays.
+For example, a part for B-flat clarinet would include
+
+@example
+\transposition bes
+@end example
+
+This command sets the property @code{instrumentTransposition}.
+The value of this property is used for MIDI output and quotations.
+MIDI output is transposed to play at concert pitch, and cue notes
+and quotations are automatically transposed to the key of the
+instrument in which they are quoted.  For more information about
+quotations, see @ref{Quoting other voices}.
+
+The pitch to use for @code{\transposition} should correspond to
+the real sound heard when a @code{c'} written on the staff is
+played by the transposing instrument.  @code{\transposition}
+should be used when the music is entered from an orchestral part
+written for the instrument.  For example, in classical horn parts,
+the tuning of the instrument is often changed during a piece.
+Here are a few notes for a violin and a B-flat clarinet where the
+parts have been entered using the notes and key as they appear in
+each part or the conductor's score:
+
+@lilypond[quote,ragged-right,verbatim]
+\new GrandStaff <<
+    \new Staff = "Violin I" {
+      \set Staff.instrumentName = "Vln"
+      \set Staff.midiInstrument="violin"
+      \key c \major
+      \transposition c
+      g'4( c''8) r c'' r c''4
+    }
+    \new Staff = "Clarinet" {
+      \set Staff.instrumentName = "Cl"
+      \set Staff.midiInstrument="clarinet"
+      \key d \major
+      \transposition bes
+      a'4( d''8) r d'' r d''4
+    }
+>>
+@end lilypond
+
+Without the @code{\transposition} command the midi output of this
+music would play the notes a tone apart; with it the notes are
+played correctly in unison.
+
+However, when entering the notes of a score in concert pitch, when
+all voices are entered in C, they may be prefaced by (the default)
+@code{\transposition c'}:
+
+@example
+clarinet = @{
+  \transposition c'
+  ...
+@}
+saxophone = @{
+  \transposition c'
+  ...
+@}
+@end example
+
+@noindent
+to serve as a reminder that these parts are written in C.
+
+
+@seealso
+
+Notation reference: @ref{Quoting other voices}, @ref{Transpose}.
+
+Snippets: @lsrdir{pitch}
+
+
+@node Automatic accidentals
+@unnumberedsubsubsec Automatic accidentals
+@cindex Automatic accidentals
+
+Common rules for typesetting accidentals have been placed in a
+function.  This function is called as follows
+
+@funindex set-accidental-style
+@example
+#(set-accidental-style 'STYLE)
+@end example
+
+@c TODO: check the context stuff below
+@c -does it *really* work?
+@c -the default contexts as specified in
+@c  scm/music-function.scm seem to be different -vv
+
+Optionally, the function can take two arguments: the name of the
+accidental style, and an optional argument that denotes the context that
+should be changed:
+
+@example
+#(set-accidental-style 'STYLE #('CONTEXT#))
+@end example
+
+If no context name is supplied, @code{Staff} is the default,
+but you may wish to apply the accidental style to a single @code{Voice}
+instead.
+
+The following accidental styles are supported:
+
+@table @code
+@item default
+This is the default typesetting behavior.  It corresponds
+to 18th century common practice: Accidentals are
+remembered to the end of the measure in which they occur and
+only on their own octave.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       %#(set-accidental-style 'default) 
+       \musicA }
+       \context Staff = "down"{
+	       %#(set-accidental-style 'default)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+}
+@end lilypond
+
+@item voice
+The normal behavior is to remember the accidentals on
+Staff-level.  This variable, however, typesets accidentals
+individually for each voice.  Apart from that, the rule is similar to
+@code{default}.
+
+@example
+ \new Staff <<
+        #(set-accidental-style 'voice)
+	@{ @dots{} @}
+	>>
+@end example
+
+As a result, accidentals from one voice do not get canceled in other
+voices, which is often an unwanted result: in the following example, it
+is hard to determine whether the second @samp{a} should be played
+natural or sharp.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'voice) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+}
+@end lilypond
+
+The @code{voice} option should be used if the voices
+are to be read solely by individual musicians.  If the staff is to be
+used by one musician (e.g., a conductor) then
+@code{modern} or @code{modern-cautionary}
+should be used instead.
+
+@item modern
+@funindex modern style accidentals
+This rule corresponds to the common practice in the 20th century.  This rule
+prints the same accidentals as @code{default}, but temporary
+accidentals also are canceled in other octaves.  Furthermore,
+in the same octave, they also get canceled in the following
+measure: in the following example, notice the two natural signs which appear
+in the second bar of the upper staff.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'modern) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'modern)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
+}
+@end lilypond
+
+@item @code{modern-cautionary}
+@funindex modern-cautionary
+This rule is similar to @code{modern}, but the @q{extra} accidentals
+(the ones not typeset by @code{default}) are typeset as cautionary
+accidentals.  They are printed in reduced size or (by default)
+with parentheses -- this can be set by definig the @code{cautionary-style}
+property of the @internalsref{AccidentalSuggestion} object.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'modern-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'modern-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
+}
+@end lilypond
+
+@funindex modern-voice
+@item modern-voice
+This rule is used for multivoice accidentals to be read both by musicians
+playing one voice and musicians playing all voices.  Accidentals are
+typeset for each voice, but they @emph{are} canceled across voices in
+the same @internalsref{Staff}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'modern-voice) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'modern-voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
+}
+@end lilypond
+
+@funindex modern-voice-cautionary
+@item modern-voice-cautionary
+This rule is the same as @code{modern-voice}, but with the extra
+accidentals (the ones not typeset by @code{voice}) typeset
+as cautionaries.  Even though all accidentals typeset by
+@code{default} @emph{are} typeset by this variable,
+some of them are typeset as cautionaries.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'modern-voice-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'modern-voice-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
+}
+@end lilypond
+
+@item piano
+@funindex piano accidentals
+This accidental style takes place in a GrandStaff context.  However, you have to 
+explicitly set it for @emph{each} individual Staff of the GrandStaff:
+
+@example
+\new GrandStaff @{ <<
+  \new Staff = "up" @{ <<
+    #(set-accidental-style 'piano)
+    @{ @dots{} @}
+  >> @}
+  \new Staff = "down"@{ <<
+    #(set-accidental-style 'piano)
+  @{ @dots{} @}
+  >> @}
+>> @}
+@end example
+
+This rule reflects 20th century practice for piano notation.  Its behavior is very
+similar to @code{modern} style, but here accidentals also get canceled
+across the staves in the same @internalsref{GrandStaff} or
+@internalsref{PianoStaff}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'piano) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'piano)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
+}
+@end lilypond
+
+@item piano-cautionary
+@funindex #(set-accidental-style 'piano-cautionary)
+Same as @code{#(set-accidental-style 'piano)} but with the extra
+accidentals typeset as cautionaries.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'piano-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'piano-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
+}
+@end lilypond
+
+@item no-reset
+@funindex no-reset accidental style
+This is the same as @code{default} but with accidentals lasting
+@q{forever} and not only until the next measure:
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'no-reset) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'no-reset)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+}
+@end lilypond
+
+@item forget
+This is sort of the opposite of @code{no-reset}: Accidentals
+are not remembered at all -- and hence all accidentals are
+typeset relative to the key signature, regardless of what was
+before in the music
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+	\change Staff = up cis' \change Staff = down <fis, a>  
+	\change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+	<f a d>2 |  } }}
+
+\score { 
+	\new PianoStaff {
+       << \context Staff = "up" {
+	       #(set-accidental-style 'forget) 
+       \musicA }
+       \context Staff = "down"{
+	       #(set-accidental-style 'forget)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
+}
+@end lilypond
+@end table
+
+
+@seealso
+
+Program reference: @internalsref{Accidental_engraver},
+@internalsref{Accidental}, @internalsref{AccidentalSuggestion} and @internalsref{AccidentalPlacement}.
+
+
+@refbugs
+
+Simultaneous notes are considered to be entered in sequential
+mode.  This means that in a chord the accidentals are typeset as if the
+notes in the chord happen one at a time, in the order in which
+they appear in the input file.  This is a problem when accidentals
+in a chord depend on each other,
+which does not happen for the default accidental style.  The problem
+can be solved by manually inserting @code{!} and @code{?} for the
+problematic notes.
+
+
+
diff --git a/Documentation/user/policy.txt b/Documentation/user/policy.txt
new file mode 100644
index 0000000000..98010e43a7
--- /dev/null
+++ b/Documentation/user/policy.txt
@@ -0,0 +1,305 @@
+DOCUMENTATION POLICY
+--------------------
+
+
+%%%%% BOOKS
+
+There are four parts to the documentation: the Learning Manual,
+the Notation Reference, the Program Reference, and the Music
+Glossary.
+
+* Learning Manual: long, chatty, friendly explanations go here.
+  This is aimed at users learning something for the first time --
+  not necessarily just learning lilypond notation, but also things
+  like learning how to deal with projects, tweaking, preparing parts
+  for orchestras, etc.  Less formal language may be used here.
+
+Users are encouraged to read the complete Learning Manual from
+start-to-finish.
+
+
+* Notation Reference: a (hopefully complete) description of
+  LilyPond input notation.  Some material from here may be
+  duplicated in the Learning Manual (for teaching).  The material is
+  presented in an approximate order of increasing difficulty, but
+  the goal is _not_ to provide a step-by-step learning environment.
+  For example, all material under "Pitches" should remain in that
+  section, even though microtonal accidentals may seem more advanced
+  than info about clefs or time signatures -- "Pitches" should be a
+  one-stop reference about the pitch portion of notes.  This section
+  is written in formal technical writing style.
+
+Users are not expected to read this manual from start to finish.
+However, they should be familiar with the material in the Learning
+Manual (particularly ``Fundamental Concepts''), so do not repeat
+that material in this book.  Also, you should assume that users
+know what the notation means; explaining musical concepts happens
+in the Music Glossary.
+
+
+* Program Usage: information about using the program lilypond with
+  other programs (lilypond-book, operating systems, GUIs,
+  convert-ly, etc).  This section is written in formal technical
+  writing style.
+
+Users are not expected to read this manual from start to finish.
+
+
+* Music Glossary: information about the music notation itself.
+  Explainations and translations about notation terms go here.
+
+Users are not expected to read this manual from start to finish.
+
+
+%%%%% SECTION ORGANIZATION
+
+The order of headings inside documentation sections should be:
+
+main docs
+@commonprop
+@seealso
+@refbugs
+
+* You _must_ include a @seealso.  The order of items inside the
+  @seealso section is
+
+    Music glossary: @rglos{foo}, @rglos{bar}.
+
+    Learning Manual: @rlearning{baz}, @rlearning{foozle}
+
+    Notation Reference: @ruser{faazle}, @ruser{boo}.
+
+    Snippets: @lsrdir{section}, @lsr{specific/example-name.ly}
+
+    Program reference: @internalsref{fazzle}, @internalsref{booar}.
+
+    Installed files: @file{blahz}.
+
+  ("Snippets" is REQUIRED; the others are optional)
+
+* To create links, use @ref{} if the link is within the same
+  manual.
+
+* @commonprop and @refbugs are optional.
+
+* Do not include any real info in second-level sections (ie 1.1
+  Pitches).  A first-level section may have introductory material,
+  but other than that all material goes into third-level sections
+  (ie 1.1.1 Writing Pitches).
+
+
+%%%%% LILYPOND FORMATTING
+
+* Use two spaces for indentation in lilypond examples.  (no tabs)
+
+* If possible, only write one bar per line.  The notes on each
+  line should be an independent line.
+  Bad:
+    \override textscript #'padding = #3 c1^"hi"
+  Good:
+    \override textscript #'padding = #3
+    c1^"hi"
+
+* LilyPond input should be produce via
+    @lilypond[verbatim,quote,ragged-right]
+  with `fragment' and `relative=2' optional.
+
+  Examples about page layout may alter the quote/ragged-right
+  options.  Omitting `verbatim' is not allowed.
+
+* Inspirational headwords are produced with
+  @lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+  {pitches-headword.ly}
+
+* Avoid long stretches of input code.  Noone is going to read them
+  in print.  Instead refer to an example input file with @lsr{}.
+
+* If you want to work on an example outside of the manual (for
+  easier/faster processing), use this header:
+
+\paper {
+  #(define dump-extents #t)
+  indent = 0\mm
+  line-width = 160\mm - 2.0 * 0.4\in
+  ragged-right = ##t
+  force-assignment = #""
+  line-width = #(- line-width (* mm  3.000000))
+}
+
+\layout {
+}
+
+  You may not change any of these values.  If you are making an
+  example demonstrating special \paper{} values, contact the
+  Documentation Editor.
+
+
+%%%%% TEXT FORMATTING
+
+* Lines should be less than 72 characters long.  (I personally
+  recommend writing with 66-char lines, but don't bother modifying
+  existing material.)
+
+* Do not use tabs.  They expand to nothing in DVI output.
+
+* Do not use spaces at the beginning of a line (except in @example
+  or @verbatim environments), and do not use more than a single
+  space between words.  `makeinfo' copies the input lines verbatim
+  without removing those spaces.
+
+* Use two spaces after a period.
+
+* Variables or numbers which consist of a single character
+  (probably followed by a punctuation mark) should be tied
+  properly, either to the previous or the next word.  Example:
+
+      The variable@tie{}@var{a} ...
+
+* To get consistent indentation in the DVI output it is better to
+  avoid the @verbatim environment.  Use the @example environment
+  instead if possible, but without extraneous indentation.  For
+  example, this
+
+    @example
+      foo {
+        bar
+      }
+    @end example
+
+  should be replaced with
+
+    @example
+    foo {
+      bar
+    }
+    @end example
+
+  where `@example' starts the line (without leading spaces).
+
+* Do not compress the input vertically; this is, do not use
+
+    Beginning of logical unit
+    @example
+    ...
+    @end example
+    continuation of logical unit
+
+  but
+
+    Beginning of logical unit
+
+    @example
+    ...
+    @end example
+
+    @noindent
+    continuation of logical unit
+
+  This makes it easier to avoid forgetting the `@noindent'.  Only
+  use @noindent if the material is discussing the same material;
+  new material should simply begin without anything special on the
+  line above it.
+
+* in @itemize use @item on a separate line like this:
+  @itemize
+  @item
+  Foo
+
+  @item
+  Bar
+
+  Do not use @itemize @bullet.
+
+* Specially-marked text:
+
+    @code{}: actual lilypond code or property/context names.
+    @samp{}: ditto, for single-letter code.
+
+
+      ** Any `\' used inside the commands below must be       **
+      ** written as `\\'.  Even if they are inside a @code{}. **
+            ( this should only affect @warning{} )
+
+	@notation{}: refers to pieces of notation, such as
+	  "@notation{crescendo} is often abbreviated as
+      @notation{cresc.}"  This should also be used to refer to
+      specific lyrics ("the @notation{A - men} is centered...")
+	@q{}: used for `vague' terms in English (and other natural
+      languages).
+	@qq{}: only for actual quotes -- i.e. "he said" or "she
+      wrote".
+	@warning{}: produces a "Note: " box.  Use for important
+      messages.
+
+* References must occur at the end of a sentence, for more
+  information see @ref{the texinfo manual}.  Ideally this should
+  also be the final sentence of a paragraph, but this is not
+  required.  Any link in a doc section must be duplicated in the
+  @seealso section at the bottom.
+
+* Introducing examples may be done with
+     . (ie finish the previous sentence/paragaph)
+     : (ie `in this example:')
+     , (ie `may add foo with the blah construct,')
+
+
+%%%%% READABILITY
+
+* Non-ASCII characters which are in utf-8 should be directly used;
+  this is, don't say `Ba@ss{}tuba' but `Baßtuba'.  This ensures that
+  all such characters appear in all output formats.
+
+* Don't use a @ref{link to another section} in the middle of a
+  sentence.  It looks ok in HTML, moderately bad in PDF, and
+  utterly horrible in INFO.  Instead, reword the sentence so that
+  users are encouraged to see @ref{link to another section}.
+  (at the end of the sentence)
+
+* Do not forget to create @cindex entries for new sections of text.
+  Enter commands with @funindex, i.e.
+    @cindex pitches, writing in different octaves
+    @funindex \relative
+  do not bother with the @code{} (they are added automatically).  These
+  items are added to both the command index and the unified index.
+
+  Both index commands should go in front of the actual material.
+
+* Abbrevs in caps, e.g., HTML, DVI, MIDI, etc.
+
+* Colon usage
+
+  1. To introduce lists
+  2. When beginning a quote: "So, he said,..."
+     This usage is rarer.  Americans often just use a comma.
+  3. When adding a defining example at the end of a sentence.
+
+
+%%%%% TECHNICAL WRITING STYLE
+
+* Do not refer to LilyPond in the text.  The reader knows what the
+  manual is about.  If you do, capitalization is LilyPond.
+
+* If you explicitly refer to `lilypond' the program (or any other
+  command to be executed), say `@command{lilypond}'.
+
+* Do not explicitly refer to the reader/user.  There is no one
+  else besides the reader and the writer.
+
+* Do not use abbreviations (don't, won't, etc.).  If you do, use a
+  comma after it:
+
+    blabla blabla, i.e., blabla blabla
+
+* Avoid fluff (``Notice that,'' ``as you can see,''
+  ``Currently,'').
+
+* The use of the word `illegal' is inappropriate in most cases.
+  Say `invalid' instead.
+
+
+FOR DOC EDITOR ONLY
+
+* sectioning commands (@node and @section) must not appear inside
+  an @ignore.  Separate those commands with a space, ie @n ode.
+
+
diff --git a/Documentation/user/programming-interface.itely b/Documentation/user/programming-interface.itely
index abc9776367..e26293b43f 100644
--- a/Documentation/user/programming-interface.itely
+++ b/Documentation/user/programming-interface.itely
@@ -12,7 +12,7 @@
 
 Advanced tweaks may be performed by using Scheme.  If you are
 not familiar with Scheme, you may wish to read our
-@ref{Scheme tutorial}.
+@rlearning{Scheme tutorial}.
 
 @menu
 * Music functions::             
@@ -230,7 +230,7 @@ turning off Point and Click).  To do this, we return a @code{void}
 music expression.
 
 That is why the form
-that is returned is the @code{(make-music ...)}. With the
+that is returned is the @code{(make-music ...)}.  With the
 @code{'void} property set to @code{#t}, the parser is told to
 actually disregard this returned music
 expression.  Thus the important part of the void music function is the
@@ -251,7 +251,7 @@ noPointAndClick =
 @subsection Functions without arguments
 
 In most cases a function without arguments should be written
-with an identifier,
+with an variable,
 
 @example
 dolce = \markup@{ \italic \bold dolce @}
@@ -359,7 +359,7 @@ traLaLa = { c'4 d'4 }
 Due to parser lookahead
 
 In this example, the assignment happens after parser has verified that
-nothing interesting happens after @code{traLaLa = @{ ... @}}. Without
+nothing interesting happens after @code{traLaLa = @{ ... @}}.  Without
 the dummy statement in the above example, the @code{newLa} definition
 is executed before @code{traLaLa} is defined, leading to a syntax
 error.
@@ -391,7 +391,7 @@ define some Scheme code in a macro (to be called later), use
 
 @refbugs
 
-Mixing Scheme and LilyPond identifiers is not possible with the
+Mixing Scheme and LilyPond variables is not possible with the
 @code{--safe} option.
 
 
@@ -404,7 +404,7 @@ it takes up time.  Time is a rational number that measures the length
 of a piece of music in whole notes.
 
 A music object has three kinds of types:
-@itemize @bullet
+@itemize
 @item
 music name: Each music expression has a name.  For example, a note
 leads to a @internalsref{NoteEvent}, and @code{\simultaneous} leads to
@@ -1143,8 +1143,8 @@ First, the function gets the indent width, a property here named
 is not found, the default value is @code{2}.  Then, a list of justified
 lines is made using the @code{make-justified-lines-markup-list}
 function, which is related to the @code{\justified-lines}
-built-in markup list command. An horizontal space is added at the
-begining using the @code{make-hspace-markup} function. Finally, the
+built-in markup list command.  An horizontal space is added at the
+begining using the @code{make-hspace-markup} function.  Finally, the
 markup list is interpreted using the @code{interpret-markup-list}
 function.
 
@@ -1159,8 +1159,8 @@ This new markup list command can be used as follows:
   @}
   \override-lines #'(par-indent . 4) \paragraph @{
     The plate would be inked, the depressions caused by the cutting
-    and stamping would hold ink. An image was formed by pressing paper
-    to the plate. The stamping and cutting was completely done by
+    and stamping would hold ink.  An image was formed by pressing paper
+    to the plate.  The stamping and cutting was completely done by
     hand.
   @}
 @}
@@ -1219,7 +1219,7 @@ where @var{proc} is a Scheme function, taking three arguments.
 When interpreted, the function @var{proc} is called for every layout
 object found in the context @var{context}, with the following
 arguments:
-@itemize @bullet
+@itemize
 @item the layout object itself,
 @item the context where the layout object was created, and
 @item the context where @code{\applyOutput} is processed.
@@ -1299,8 +1299,8 @@ can be inserted with a grob closure.  Here is a setting from
 @noindent
 In this example, both @code{ly:self-alignment-interface::x-aligned-on-self} and
 @code{ly:self-alignment-interface::centered-on-x-parent} are called
-with the grob as argument. The results are added with the @code{+}
-function. To ensure that this addition is properly executed, the whole
+with the grob as argument.  The results are added with the @code{+}
+function.  To ensure that this addition is properly executed, the whole
 thing is enclosed in @code{ly:make-simple-closure}.
 
 In fact, using a single procedure as property value is equivalent to
diff --git a/Documentation/user/putting.itely b/Documentation/user/putting.itely
deleted file mode 100644
index 8090efd6df..0000000000
--- a/Documentation/user/putting.itely
+++ /dev/null
@@ -1,594 +0,0 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
-    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
-
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
-@end ignore
-
-@node Putting it all together
-@chapter Putting it all together
-
-This chapter discusses general LilyPond concepts and how to
-create @code{\score} blocks.
-
-
-@menu
-* Extending the templates::     
-* How LilyPond files work::     
-* Score is a single musical expression::  
-* An orchestral part::          
-@end menu
-
-
-@node Extending the templates
-@section Extending the templates
-
-You've read the tutorial, you know how to write music.  But how can you
-get the staves that you want?  The templates are ok, but what if you
-want something that isn't covered?
-
-Start off with the template that seems closest to what you want to end
-up with.  Let's say that you want to write something for soprano and
-cello.  In this case, we would start with @q{Notes and lyrics} (for the
-soprano part).
-
-@example
-\version "2.11.23"
-melody = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-text = \lyricmode @{
-  Aaa Bee Cee Dee
-@}
-
-\score@{
-  <<
-    \new Voice = "one" @{
-      \autoBeamOff
-      \melody
-    @}
-    \new Lyrics \lyricsto "one" \text
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-Now we want to add a cello part.  Let's look at the @q{Notes only} example:
-
-@example
-\version "2.11.23"
-melody = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-\score @{
-\new Staff \melody
-\layout @{ @}
-\midi @{ @}
-@}
-@end example
-
-We don't need two @code{\version} commands.  We'll need the @code{melody}
-section.  We don't want two @code{\score} sections -- if we had two
-@code{\score}s, we'd get the two parts separately.  We want them together,
-as a duet.  Within the @code{\score} section, we don't need two
-@code{\layout} or @code{\midi}.
-
-If we simply cut and paste the @code{melody} section, we would end up with
-two @code{melody} sections.  So let's rename them.  We'll call the section
-for the soprano @code{sopranoMusic} and the section for the cello
-@code{celloMusic}.  While we're doing this, let's rename @code{text}
-to be @code{sopranoLyrics}.  Remember to rename both instances of all
-these names -- both the initial definition (the
-@code{melody = relative c' @{ } part) and the name's use (in the
-@code{\score} section).
-
-While we're doing this, let's change the cello part's staff -- celli
-normally use bass clef.  We'll also give the cello some different
-notes.
-
-@example
-\version "2.11.23"
-sopranoMusic = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-sopranoLyrics = \lyricmode @{
-  Aaa Bee Cee Dee
-@}
-
-celloMusic = \relative c @{
-  \clef bass
-  \key c \major
-  \time 4/4
-
-  d4 g fis8 e d4
-@}
-
-\score@{
-  <<
-    \new Voice = "one" @{
-      \autoBeamOff
-      \sopranoMusic
-    @}
-    \new Lyrics \lyricsto "one" \sopranoLyrics
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-This is looking promising, but the cello part won't appear in the
-score -- we haven't used it in the @code{\score} section.  If we
-want the cello part to appear under the soprano part, we need to add
-
-@example
-\new Staff \celloMusic
-@end example
-
-@noindent
-underneath the soprano stuff.  We also need to add @code{<<} and
-@code{>>} around the music -- that tells LilyPond that there's
-more than one thing (in this case, @code{Staff}) happening at once.  The
-@code{\score} looks like this now
-
-@example
-\score@{
-  <<
-    <<
-      \new Voice = "one" @{
-        \autoBeamOff
-        \sopranoMusic
-      @}
-      \new Lyrics \lyricsto "one" \sopranoLyrics
-    >>
-    \new Staff \celloMusic
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-@noindent
-This looks a bit messy; the indentation is messed up now.  That is
-easily fixed.  Here's the complete soprano and cello template.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.23"
-sopranoMusic = \relative c' {
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-}
-
-sopranoLyrics = \lyricmode {
-  Aaa Bee Cee Dee
-}
-
-celloMusic = \relative c {
-  \clef bass
-  \key c \major
-  \time 4/4
-
-  d4 g fis8 e d4
-}
-
-\score{
-  <<
-    <<
-      \new Voice = "one" {
-        \autoBeamOff
-        \sopranoMusic
-      }
-      \new Lyrics \lyricsto "one" \sopranoLyrics
-    >>
-    \new Staff \celloMusic
-  >>
-  \layout { }
-  \midi { }
-}
-@end lilypond
-
-
-
-@node How LilyPond files work
-@section How LilyPond files work
-
-The LilyPond input format is quite free-form, giving experienced
-users a lot of flexibility to structure their files however they
-wish.  However, this flexibility can make things confusing for
-new users.  This section will explain some of this structure, but
-may gloss over some details in favor of simplicity.  For a complete
-description of the input format, see @ref{File structure}.
-
-Most examples in this manual are little snippets -- for example
-
-@example
-c4 a b c
-@end example
-
-As you are (hopefully) aware by now, this will not compile by
-itself.  These examples are shorthand for complete
-examples.  They all need at least curly braces to compile
-
-@example
-@{
-  c4 a b c
-@}
-@end example
-
-Most examples also make use of the @code{\relative c'}
-(or @code{c''}) command.  This is not necessary to merely
-compile the examples, but in most cases the output will
-look very odd if you omit the @code{\relative c'}.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  c4 a b c
-}
-@end lilypond
-
-Now we get to the only real stumbling block: LilyPond
-input in this form is actually @emph{another}
-shorthand.  Although it compiles and displays the
-correct output, it is shorthand for
-
-@example
-\score @{
-  \relative c'' @{
-    c4 a b c
-  @}
-@}
-@end example
-
-A @code{\score} must begin with a single music
-expression.  Remember that a music expression could
-be anything from a single note to a huge
-
-@example
-@{
-  \new GrandStaff <<
-    insert the whole score of a Wagner opera in here
-  >>
-@}
-@end example
-
-@noindent
-Since everything is inside @code{@{ ... @}}, it counts
-as one music expression.
-
-The @code{\score} can contain other things, such as
-
-@example
-\score @{
-  @{ c'4 a b c' @}
-  \layout @{ @}
-  \midi @{ @}
-  \header @{ @}
-@}
-@end example
-
-@noindent
-Some people put some of those commands outside the
-@code{\score} block -- for example, @code{\header} is
-often placed above the @code{\score}.  That's just
-another shorthand that LilyPond accepts.
-
-@cindex variables
-@cindex identifiers
-
-Another great shorthand is the ability to define
-variables.  All the templates use this
-
-@example
-melody = \relative c' @{
-  c4 a b c
-@}
-
-\score @{
-  @{ \melody @}
-@}
-@end example
-
-When LilyPond looks at this file, it takes the value of
-@code{melody} (everything after the equals sign) and
-inserts it whenever it sees
-@code{\melody}.  There's nothing special about the
-names -- it could be @code{melody}, @code{global},
-@code{pianorighthand}, or @code{foofoobarbaz}.  You
-can use whatever variable names you want.  For
-more details, see
-@ref{Saving typing with identifiers and functions}.
-
-For a complete definition
-of the input format, see @ref{File structure}.
-
-
-@node Score is a single musical expression
-@section Score is a single musical expression
-
-In the previous section, @ref{How LilyPond files work},
-we saw the general organization of LilyPond input
-files.  But we seemed to skip over the most important
-part: how do we figure out what to write after
-@code{\score}?
-
-We didn't skip over it at all.  The big mystery is simply
-that there @emph{is} no mystery.  This line explains it
-all:
-
-@quotation
-@emph{A @code{\score} must begin with a single music expression.}
-@end quotation
-
-@noindent
-You may find it useful to review
-@ref{Music expressions explained}.  In that section, we
-saw how to build big music expressions from small
-pieces -- we started from notes, then chords, etc.  Now
-we're going to start from a big music expression and
-work our way down.
-
-@example
-\score @{
-  @{   % this brace begins the overall music expression
-    \new GrandStaff <<
-      insert the whole score of a Wagner opera in here
-    >>
-  @}   % this brace ends the overall music expression
-  \layout @{ @}
-@}
-@end example
-
-A whole Wagner opera would easily double the length of
-this manual, so let's just do a singer and piano.  We
-don't need a @code{GrandStaff} for this ensemble, so we
-shall remove it.  We @emph{do} need a singer and a piano,
-though.
-
-@example
-\score @{
-  @{
-    <<
-      \new Staff = "singer" <<
-      >>
-      \new PianoStaff = piano <<
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-Remember that we use @code{<<} and @code{>>} to show
-simultaneous music.  And we definitely want to show
-the vocal part and piano part at the same time!
-
-@example
-\score @{
-  @{
-    <<
-      \new Staff = "singer" <<
-        \new Voice = "vocal" @{ @}
-      >>
-      \new Lyrics \lyricsto vocal \new Lyrics @{ @}
-      \new PianoStaff = "piano" <<
-        \new Staff = "upper" @{ @}
-        \new Staff = "lower" @{ @}
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-Now we have a lot more details.  We have the singer's
-staff: it contains a @code{Voice} (in LilyPond, this
-term refers to a set of notes, not necessarily vocal
-notes -- for example, a violin generally plays one
-voice) and some lyrics.  We also have a piano staff:
-it contains an upper staff (right hand) and a lower
-staff (left hand).
-
-At this stage, we could start filling in notes.  Inside
-the curly braces next to @code{\new Voice = vocal},
-we could start writing
-
-@example
-\relative c'' @{
-  a4 b c d
-@}
-@end example
-
-But if we did that, the @code{\score} section would
-get pretty long, and it would be harder to understand
-what was happening.  So let's use identifiers (or
-variables) instead.
-
-@example
-melody = @{ @}
-text = @{ @}
-upper = @{ @}
-lower = @{ @}
-\score @{
-  @{
-    <<
-      \new Staff = "singer" <<
-        \new Voice = "vocal" @{ \melody @}
-      >>
-      \new Lyrics \lyricsto vocal \new Lyrics @{ \text @}
-      \new PianoStaff = "piano" <<
-        \new Staff = "upper" @{ \upper @}
-        \new Staff = "lower" @{ \lower @}
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-@noindent
-Remember that you can use almost any name you like.  The
-limitations on identifier names are detailed in
-@ref{File structure}.
-
-When writing a @code{\score} section, or when reading
-one, just take it slowly and carefully.  Start with
-the outer layer, then work on each smaller
-layer.  It also really helps to be strict with
-indentation -- make sure that each item on the same
-layer starts on the same horizontal position in your
-text editor!
-
-
-
-
-
-
-@node An orchestral part
-@section An orchestral part
-
-In orchestral music, all notes are printed twice.  Once in a part for
-the musicians, and once in a full score for the conductor.  Identifiers can
-be used to avoid double work.  The music is entered once, and stored in
-a variable.  The contents of that variable is then used to generate
-both the part and the full score.
-
-It is convenient to define the notes in a special file.  For example,
-suppose that the file @file{horn-music.ly} contains the following part
-of a horn/@/bassoon duo
-
-@example
-hornNotes = \relative c @{
-  \time 2/4
-  r4 f8 a cis4 f e d
-@}
-@end example
-
-@noindent
-Then, an individual part is made by putting the following in a file
-
-@example
-\include "horn-music.ly"
-\header @{
-  instrument = "Horn in F"
-@}
-
-@{
- \transpose f c' \hornNotes
-@}
-@end example
-
-The line
-
-@example
-\include "horn-music.ly"
-@end example
-
-@noindent
-substitutes the contents of @file{horn-music.ly} at this position in
-the file, so @code{hornNotes} is defined afterwards.  The command
-@code{\transpose f@tie{}c'} indicates that the argument, being
-@code{\hornNotes}, should be transposed by a fifth upwards.  Sounding
-@samp{f} is denoted by notated @code{c'}, which corresponds with the
-tuning of a normal French Horn in@tie{}F.  The transposition can be seen
-in the following output
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
-  \time 2/4
-  r4 f8 a cis4 f e d
-}
-@end lilypond
-
-In ensemble pieces, one of the voices often does not play for many
-measures.  This is denoted by a special rest, the multi-measure
-rest.  It is entered with a capital @samp{R} followed by a duration
-(@code{1}@tie{}for a whole note, @code{2}@tie{}for a half note,
-etc.).  By multiplying the
-duration, longer rests can be constructed.  For example, this rest
-takes 3@tie{}measures in 2/4 time
-
-@example
-R2*3
-@end example
-
-When printing the part, multi-rests
-must be condensed.  This is done by setting a run-time variable
-
-@example
-\set Score.skipBars = ##t
-@end example
-
-@noindent
-This command sets the property @code{skipBars} in the
-@code{Score} context to true (@code{##t}).  Prepending the rest and
-this option to the music above, leads to the following result
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
-  \time 2/4
-  \set Score.skipBars = ##t
-  R2*3
-  r4 f8 a cis4 f e d
-}
-@end lilypond
-
-
-The score is made by combining all of the music together.  Assuming
-that the other voice is in @code{bassoonNotes} in the file
-@file{bassoon-music.ly}, a score is made with
-
-@example
-\include "bassoon-music.ly"
-\include "horn-music.ly"
-
-<<
-  \new Staff \hornNotes
-  \new Staff \bassoonNotes
->>
-@end example
-
-@noindent
-leading to
-
-@lilypond[quote,ragged-right]
-\relative c <<
-  \new Staff {
-    \time 2/4 R2*3
-    r4 f8 a cis4 f e d
-  }
-  \new Staff {
-    \clef bass
-    r4 d,8 f | gis4 c | b bes |
-    a8 e f4 | g d | gis f
-  }
->>
-@end lilypond
-
-More in-depth information on preparing parts and scores can be found
-in the notation manual; see @ref{Orchestral music}.
-
-Setting run-time variables (@q{properties}) is discussed in
-@ref{Changing context properties on the fly}.
-
-
-
diff --git a/Documentation/user/repeats.itely b/Documentation/user/repeats.itely
new file mode 100644
index 0000000000..4c9ac133f3
--- /dev/null
+++ b/Documentation/user/repeats.itely
@@ -0,0 +1,415 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Repeats
+@section Repeats
+
+Repetition is a central concept in music, and multiple notations
+exist for repetitions.
+
+@menu
+* Writing repeats::             
+* Other repeats::               
+@end menu
+
+@node Writing repeats
+@subsection Writing repeats
+
+Blah blah
+
+@menu
+* Normal repeats::              
+* Repeat syntax::               
+* Manual repeat commands::      
+* Repeats and MIDI::            
+@end menu
+
+@node Normal repeats
+@unnumberedsubsubsec Normal repeats
+
+@cindex volta
+@cindex prima volta
+@cindex seconda volta
+@funindex \repeat
+
+Normal repeats, with or without alternate repeats, may be printed:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\repeat volta 2 { c4 d e f }
+\repeat volta 2 { g f e d }
+  \alternative {
+    { cis2 g' }
+    { cis,2 b }
+  }
+c1
+@end lilypond
+
+Repeats with upbeats may be created.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 e |
+  \repeat volta 4 { c2 d2 | e2 f2 | }
+  \alternative { { g4 g g e } { a a a a | b2. } }
+}
+@end lilypond
+
+@noindent
+or
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Staff {
+  \partial 4 
+  \repeat volta 4 { e | c2 d2 | e2 f2 | }
+  \alternative { { \partial 4*3 g4 g g } { a a a a | b2. } }
+}
+@end lilypond
+
+
+@funindex \repeatTie
+
+Ties may be added to a second ending,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1
+\repeat volta 2 {c4 d e f ~ }
+\alternative { {f2 d} {f\repeatTie f,} }
+@end lilypond
+
+It is possible to shorten volta brackets by setting
+@code{voltaSpannerDuration}.  In the next example, the bracket
+only lasts one measure, which is a duration of 3/4.
+
+@lilypond[verbatim,ragged-right,quote]
+\relative c''{
+  \time 3/4
+  c c c
+  \set Score.voltaSpannerDuration = #(ly:make-moment 3 4)
+  \repeat volta 5 { d d d }
+  \alternative { { e e e f f f }
+  { g g g } }
+}
+@end lilypond
+
+If you want to start a repeat at the beginning of a line and have
+a double bar at the end of the previous line, use
+
+@example
+@dots{} \bar "||:" \break 
+\repeat volta 2 @{ @dots{} 
+@end example
+
+see @ref{Bar lines} for more information.
+
+@seealso
+
+Program reference: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic},
+@internalsref{VoltaRepeatedMusic}, and
+@internalsref{UnfoldedRepeatedMusic}.
+
+Examples:
+
+Brackets for the repeat are normally only printed over the topmost
+staff.  This can be adjusted by moving @code{Volta_engraver} to
+the Staff context where you want the brackets to appear; see
+@ref{Modifying context plug-ins} and
+@lsr{repeats,volta@/-multi@/-staff@/.ly}.
+
+
+@refbugs
+
+@cindex repeat, ambiguous
+
+A nested repeat like
+
+@example
+\repeat @dots{}
+\repeat @dots{}
+\alternative
+@end example
+
+@noindent
+is ambiguous, since it is is not clear to which @code{\repeat} the
+@code{\alternative} belongs.  This ambiguity is resolved by always
+having the @code{\alternative} belong to the inner @code{\repeat}.
+For clarity, it is advisable to use braces in such situations.
+
+Timing information is not remembered at the start of an
+alternative, so after a repeat timing information must be reset by
+hand; for example, by setting @code{Score.measurePosition} or
+entering @code{\partial}.  Similarly, slurs or ties are also not
+repeated.
+
+
+
+@node Repeat syntax
+@unnumberedsubsubsec Repeat syntax
+
+@cindex repeats
+
+LilyPond has one syntactic construct for specifying different
+types of repeats.  The syntax is
+
+@example
+\repeat @var{variant} @var{repeatcount} @var{repeatbody}
+@end example
+
+If you have alternative endings, you may add
+@funindex \alternative
+@example
+\alternative @{
+  @var{alternative1}
+  @var{alternative2}
+  @var{alternative3}
+  @dots{}
+@}
+@end example
+
+@noindent
+where each @var{alternative} is a music expression.  If you do not
+give enough alternatives for all of the repeats, the first
+alternative is assumed to be played more than once.
+
+The following types of repetition are supported
+
+@table @code
+@item unfold
+Repeated music is fully written (played) out.  This is useful when
+entering repetitious music.  This is the only kind of repeat that
+is included in MIDI output.
+
+@item volta
+Repeats are not written out, but alternative endings (volte) are
+printed, left to right with brackets.  This is the standard
+notation for repeats with alternatives.  These are not played in
+MIDI output by default.
+
+
+@item tremolo
+Make tremolo beams.  These are not played in MIDI output by
+default.
+
+@item percent
+Make beat or measure repeats.  These look like percent signs.
+These are not played in MIDI output by default.  Percent repeats
+must be declared within a @code{Voice} context.
+
+@end table
+
+
+@node Manual repeat commands
+@unnumberedsubsubsec Manual repeat commands
+
+@funindex repeatCommands
+
+The property @code{repeatCommands} can be used to control the
+layout of repeats.  Its value is a Scheme list of repeat commands.
+
+@table @asis
+@item @code{start-repeat}
+Print a @code{|:} bar line.
+
+@item @code{end-repeat}
+Print a @code{:|} bar line.
+
+@item @code{(volta @var{text})}
+Print a volta bracket saying @var{text}: The text can be specified
+as a text string or as a markup text, see @ref{Text markup}.  Do
+not forget to change the font, as the default number font does not
+contain alphabetic characters;
+
+@item @code{(volta #f)}
+Stop a running volta bracket.
+@end table
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+c4
+  \set Score.repeatCommands = #'((volta "93") end-repeat)
+c4 c4
+  \set Score.repeatCommands = #'((volta #f))
+c4 c4
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{VoltaBracket},
+@internalsref{RepeatedMusic}, @internalsref{VoltaRepeatedMusic},
+and @internalsref{UnfoldedRepeatedMusic}.
+
+@node Repeats and MIDI
+@unnumberedsubsubsec Repeats and MIDI
+
+@cindex expanding repeats
+@funindex \unfoldRepeats
+
+With a little bit of tweaking, all types of repeats can be present
+in the MIDI output.  This is achieved by applying the
+@code{\unfoldRepeats} music function.  This function changes all
+repeats to unfold repeats.
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+  \repeat tremolo 8 {c'32 e' }
+  \repeat percent 2 { c''8 d'' }
+  \repeat volta 2 {c'4 d' e' f'}
+  \alternative {
+    { g' a' a' g' }
+    {f' e' d' c' }
+  }
+}
+\bar "|."
+@end lilypond
+
+When creating a score file using @code{\unfoldRepeats} for MIDI,
+it is necessary to make two @code{\score} blocks: one for MIDI
+(with unfolded repeats) and one for notation (with volta, tremolo,
+and percent repeats).  For example,
+
+@example
+\score @{
+  @var{..music..}
+  \layout @{ .. @}
+@}
+\score @{
+  \unfoldRepeats @var{..music..}
+  \midi @{ .. @}
+@}
+@end example
+
+
+@node Other repeats
+@subsection Other repeats
+
+@menu
+* Tremolo repeats::             
+* Tremolo subdivisions::        
+* Measure repeats::             
+@end menu
+
+@node Tremolo repeats
+@unnumberedsubsubsec Tremolo repeats
+
+@cindex tremolo beams
+
+To place tremolo marks between notes, use @code{\repeat} with
+tremolo style
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat tremolo 8 { c16 d16 }
+  \repeat tremolo 4 { c16 d16 }
+  \repeat tremolo 2 { c16 d16 }
+}
+@end lilypond
+
+Tremolo marks can also be put on a single note.  In this case, the
+note should not be surrounded by braces.
+
+@lilypond[quote,verbatim,ragged-right]
+\repeat tremolo 4 c'16
+@end lilypond
+
+Similar output is obtained using the tremolo subdivision,
+described in @ref{Tremolo subdivisions}.
+
+
+@seealso
+
+In this manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
+
+Program reference: @internalsref{Beam},
+@internalsref{StemTremolo}.
+
+
+@node Tremolo subdivisions
+@unnumberedsubsubsec Tremolo subdivisions
+
+@cindex tremolo marks
+@funindex tremoloFlags
+
+Tremolo marks can be printed on a single note by adding
+@q{@code{:}[@var{number}]} after the note.  The number indicates
+the duration of the subdivision, and it must be at least 8.  A
+@var{length} value of 8 gives one line across the note stem.  If
+the length is omitted, the last value (stored in
+@code{tremoloFlags}) is used
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+c'2:8 c':32 | c': c': |
+@end lilypond
+
+
+@refbugs
+
+Tremolos entered in this way do not carry over into the MIDI
+output.
+
+
+@seealso
+
+In this manual: @ref{Tremolo repeats}.
+
+Elsewhere: @internalsref{StemTremolo}.
+
+
+@node Measure repeats
+@unnumberedsubsubsec Measure repeats
+
+@cindex percent repeats
+@cindex measure repeats
+
+In the @code{percent} style, a note pattern can be repeated.  It
+is printed once, and then the pattern is replaced with a special
+sign.  Patterns of one and two measures are replaced by
+percent-like signs, patterns that divide the measure length are
+replaced by slashes.  Percent repeats must be declared within a
+@code{Voice} context.
+
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+  \repeat percent 4 { c4 }
+  \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
+}
+@end lilypond
+
+Measure repeats of more than 2 measures get a counter, if you
+switch on the @code{countPercentRepeats} property,
+
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+  \repeat percent 4 { c1 }
+}
+@end lilypond
+
+
+
+Isolated percents can also be printed.  This is done by putting a
+multi-measure rest with a different print function,
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+  = #ly:multi-measure-rest::percent
+R1
+@end lilypond
+
+
+
+
+@seealso
+
+Program reference: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
+
+
+
diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely
new file mode 100644
index 0000000000..7c0f521b6f
--- /dev/null
+++ b/Documentation/user/rhythms.itely
@@ -0,0 +1,2182 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Rhythms
+@section Rhythms
+
+@lilypondfile[ragged-right,line-width=16\cm,staffsize=16,quote]
+{rhythms-headword.ly}
+
+This section discusses rhythms, durations, and bars.
+
+@menu
+* Writing rhythms::             
+* Writing rests::               
+* Displaying rhythms::          
+* Beams::                       
+* Bars::                        
+* Special rhythmic concerns::   
+@end menu
+
+
+@node Writing rhythms
+@subsection Writing rhythms
+
+@menu
+* Durations::                   
+* Tuplets::                     
+* Scaling durations::           
+@end menu
+
+@node Durations
+@unnumberedsubsubsec Durations
+
+@cindex duration
+@funindex \longa
+@funindex \breve
+@funindex \maxima
+
+When entering notes, durations are designated by numbers and dots:
+durations are entered as their reciprocal values.  For example, a
+quarter note is entered using a @code{4} (since it is a 1/4 note),
+while a half note is entered using a @code{2} (since it is a 1/2
+note).  For notes longer than a whole you must use the
+@code{\longa} (a double breve) and @code{\breve} commands.  Note
+durations as short as 64th notes may be specified.
+
+@c Two 64th notes are needed to obtain beams
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\time 8/1
+c\longa c\breve c1 c2
+c4 c8 c16 c32 c64 c64
+@end lilypond
+
+@noindent
+and the same durations with automatic beaming turned off 
+see @ref{Automatic beams}:
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\time 8/1
+\autoBeamOff
+c\longa c\breve c1 c2
+c4 c8 c16 c32 c64 c64
+@end lilypond
+
+If the duration is omitted then it is set to the previously
+entered duration.  The default for the first note is a quarter
+note.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+a a a2 a a4 a a1 a
+@end lilypond
+
+
+@funindex .
+
+To obtain dotted note lengths, simply add a dot (@samp{.}) to the
+number.  Double-dotted notes are produced in a similar way.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+a4 b c4. b8 a4. b4.. c8.
+@end lilypond
+
+Some durations cannot be entered using only binary durations
+and dots, and can only be represented by tying two or more 
+notes together.  Tied notes are covered in @ref{Ties}.
+
+@refcommands
+
+Dots are normally moved up to avoid staff lines, except in
+polyphonic situations.  The following commands may be used to
+force a particular direction manually
+
+@funindex \dotsUp
+@code{\dotsUp},
+@funindex \dotsDown
+@code{\dotsDown},
+@funindex \dotsNeutral
+@code{\dotsNeutral}.
+
+@c TODO: after deciding the link question, fix these.  -gp
+Durations are entered in the same way in @code{drummode},
+@code{chordmode}, @code{figuremode} and (optionally) 
+in @code{lyricmode}.
+
+@seealso
+
+For ways of specifying durations for the syllables of lyrics
+and ways of aligning lyrics to notes see @ref{Vocal music}
+
+For a description of how to enter rests see @ref{Writing rests}
+
+A note with the duration of a quadruple breve may be
+entered with \maxima, but this is supported only within
+ancient music notation.  See @ref{Ancient notation}
+
+Optionally, notes can be spaced proportionately to their duration.
+For details of this and other settings which control
+proportional notation see @ref{Proportional notation}.
+
+Program reference: @internalsref{Dots}, and
+@internalsref{DotColumn}.
+
+
+@node Tuplets
+@unnumberedsubsubsec Tuplets
+
+@cindex tuplets
+@cindex triplets
+@funindex \times
+
+@c TODO Add Tuplet to glossary
+
+Tuplets are made out of a music expression by multiplying all
+durations with a fraction
+
+@example
+\times @var{fraction} @var{musicexpr}
+@end example
+
+@noindent
+The duration of @var{musicexpr} will be multiplied by the 
+fraction.  The fraction's denominator will be printed over or 
+under the notes, optionally with a bracket.  The most common 
+tuplet is the triplet in which 3 notes have the length of 2, so 
+the notes are 2/3 of their written length.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+g4 \times 2/3 {c4 c c} d4 d4
+@end lilypond
+
+Tuplets may be nested, for example,
+
+@lilypond[fragment,ragged-right,verbatim,relative=2]
+\override TupletNumber #'text = #tuplet-number::calc-fraction-text
+\times 4/6 {
+  a4 a
+  \times 3/5 { a a a a a }
+}
+@end lilypond
+
+@refcommands
+
+@funindex \tupletUp
+@code{\tupletUp},
+@funindex \tupletDown
+@code{\tupletDown},
+@funindex \tupletNeutral
+@code{\tupletNeutral}.
+
+
+@commonprop
+
+@funindex tupletNumberFormatFunction
+@cindex tuplet formatting
+
+The property @code{tupletSpannerDuration} specifies how long each
+bracket should last.  With this, you can make lots of tuplets
+while typing @code{\times} only once, thus saving lots of typing.
+In the next example, there are two triplets shown, while
+@code{\times} was only used once
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\set tupletSpannerDuration = #(ly:make-moment 1 4)
+\times 2/3 { c8 c c c c c }
+@end lilypond
+
+@noindent
+For more information about @code{make-moment}, see
+@ref{Time administration}.
+
+The format of the number is determined by the property @code{text}
+in @code{TupletNumber}.  The default prints only the denominator,
+but if it is set to the function
+@code{tuplet-number::calc-fraction-text}, @var{num}:@var{den} will
+be printed instead.
+
+To avoid printing tuplet numbers, use
+
+@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+\override TupletNumber #'transparent = ##t
+\times 2/3 { c8 c c } \times 2/3 { c8 c c }
+@end lilypond
+
+Use the @code{\tweak} function to override nested tuplets
+beginning at the same music moment.  In this example,
+@code{\tweak} specifies fraction text for the outer
+@code{TupletNumber} and denominator text for the
+@code{TupletNumber} of the first of the three inner tuplets.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\tweak #'text #tuplet-number::calc-fraction-text
+\times 4/3 {
+   \tweak #'text #tuplet-number::calc-denominator-text
+   \times 2/3 { c8[ c8 c8] }
+   \times 2/3 { c8[ c8 c8] }
+   \times 2/3 { c8[ c8 c8] }
+}
+@end lilypond
+
+Here @code{\tweak} and @code{\override} work together to specify
+@code{TupletBracket} direction.  The first @code{\tweak} positions
+the @code{TupletBracket} of the outer tuplet above the staff.  The
+second @code{\tweak} positions the @code{TupletBracket} of the
+first of the three inner tuplets below the staff.  Note that this
+pair of @code{\tweak} functions affects only the outer tuplet and
+the first of the three inner tuplets because only those two
+tuplets begin at the same music moment.  We use @code{\override}
+in the usual way to position the @code{TupletBrackets} of the
+second and third of the inner tuplets below the staff.
+
+@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+\tweak #'text #tuplet-number::calc-fraction-text
+\tweak #'direction #up
+\times 4/3 {
+   \tweak #'direction #down
+   \times 2/3 { c8[ c8 c8] }
+   \override TupletBracket #'direction = #down
+   \times 2/3 { c8[ c8 c8] }
+   \times 2/3 { c8[ c8 c8] }
+}
+@end lilypond
+
+Tuplet brackets can be made to run to prefatory matter or the next
+note
+
+@lilypond[ragged-right]
+\new RhythmicStaff {
+  \set tupletFullLength = ##t
+  \time 4/4
+  \times 4/5 {
+    c4 c1
+  }
+  \set tupletFullLengthNote = ##t
+  \time 2/4
+  \times 2/3 {
+    c4 c c 
+  }
+  \time 3/4
+  c4 
+}
+@end lilypond
+
+Tuplets which cross barlines will prevent a line break at that
+point.
+
+@seealso
+
+Program reference: @internalsref{TupletBracket},
+@internalsref{TupletNumber}, and @internalsref{TimeScaledMusic}.
+
+
+
+@node Scaling durations
+@unnumberedsubsubsec Scaling durations
+
+You can alter the length of a duration by a fraction @var{N/M}
+by appending @samp{*@var{N/M}} (or @samp{*@var{N}} if @var{M=1}).
+This will not affect the appearance of the notes or rests
+produced, but the altered duration will be used in calculating the
+position within the bar and setting the duration in the MIDI
+output.  Multiplying factors may be combined
+such as @samp{*M*N}.
+
+In the following example, the first three notes take up exactly
+two beats, but no triplet bracket is printed.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\time 2/4
+a4*2/3 gis4*2/3 a4*2/3
+a4 a4 a4*2
+b16*4 c4
+@end lilypond
+
+The duration of skip or spacing notes may also be modified by
+a multiplier.  This is useful for skipping many bars, e.g., 
+@samp{s1*23}.
+
+@seealso
+
+This manual: @ref{Tuplets}, @ref{Skips}.
+
+
+
+
+@node Writing rests
+@subsection Writing rests
+
+@menu
+* Rests::                       
+* Skips::                       
+* Multi measure rests::         
+@end menu
+
+@node Rests
+@unnumberedsubsubsec Rests
+@cindex Rests
+
+@funindex \rest
+@funindex r
+@funindex \maxima
+
+Rests are entered like notes with the note name @code{r}
+
+@c \time 16/1 is used to avoid spurious barlines
+@c and long tracts of empty bars
+@lilypond[fragment,quote,ragged-right,verbatim]
+\new Staff {
+  \time 16/1
+  \override Staff.TimeSignature #'stencil = ##f
+  r\maxima
+  r\longa r\breve r1 r2
+  r4 r8 r16 r32 r64
+}
+@end lilypond
+
+Whole bar rests, centered in middle of the bar, must be entered as
+multi-measure rests.  They can be used for a single bar as well as
+many bars, and are discussed in @ref{Multi measure rests}.
+
+To explicitly specify a rest's vertical position, write a note
+followed by @code{\rest}.  A rest will be placed in the position
+where the note would appear,
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a4\rest d4\rest
+@end lilypond
+
+@noindent
+This makes manual formatting of polyphonic music much easier,
+since the automatic rest collision formatter will leave these
+rests alone.
+
+@seealso
+
+Program reference: @internalsref{Rest}.
+
+
+@node Skips
+@unnumberedsubsubsec Skips
+
+@cindex Skip
+@cindex Invisible rest
+@cindex Space note
+@funindex \skip
+@funindex s
+
+An invisible rest (also called a @q{skip}) can be entered like a
+note with note name @samp{s} or with @code{\skip @var{duration}}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+a4 a4 s4 a4 \skip 1 a4
+@end lilypond
+
+The @code{s} syntax is only available in note mode and chord mode.
+In other situations, for example, when entering lyrics, you should
+use the @code{\skip} command
+
+@lilypond[quote,ragged-right,verbatim,relative=2]
+<<
+  { a2 a2 }
+  \new Lyrics \lyricmode { \skip 2 bla2 }
+>>
+@end lilypond
+
+The skip command is merely an empty musical placeholder.  It does
+not produce any output, not even transparent output.
+
+The @code{s} skip command does create @internalsref{Staff} and
+@internalsref{Voice} when necessary, similar to note and rest
+commands.  For example, the following results in an empty staff.
+
+@lilypond[quote,ragged-right,verbatim]
+{ s4 }
+@end lilypond
+
+The fragment @code{@{ \skip 4 @} } would produce an empty page.
+
+@seealso
+
+Program reference: @internalsref{SkipMusic}.
+
+
+@node Multi measure rests
+@unnumberedsubsubsec Multi measure rests
+
+@cindex multi measure rests
+@cindex full measure rests
+@cindex Rests, multi measure
+@cindex Rests, full measure
+@cindex whole rests for a full measure
+@funindex R
+
+Rests for one or more full measures are entered using
+@code{R} followed by a duration (see @ref{Durations}).
+The duration should correspond to an integral number 
+of bars, otherwise a barcheck warning is printed.  
+Multi-measure rests are principally used to indicate
+that a part in a multi-part score should be silent:
+
+@lilypond[quote,fragment,verbatim,relative=2]
+\set Score.skipBars = ##t
+R1*4
+R1*24
+R1*4
+b2^"Tutti" b4 a4
+@end lilypond
+
+A multi-measure rest can be expanded in the printed score
+to show all the rest bars explicitly, or, as above, it can be 
+condensed to a single bar
+containing a multi-measure rest symbol, with the number of
+bars of rest printed above the bar.  This expansion
+is controlled by the property @code{Score.skipBars}.  If this is
+set to true, empty measures will condensed to a single bar.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\time 4/4 r1 | R1 | R1*2 | 
+\time 2/4 R2 | 
+\time 4/4
+\set Score.skipBars = ##t 
+R1*17 | R1*4 |
+@end lilypond
+
+The @code{1} in @code{R1} is similar to the duration notation 
+used for notes and is the length of a bar in 2/2 or 4/4 time.
+The duration in a multi-measure rest must always be an integral
+number of bar-lengths, so in other time signatures augmentation
+dots or fractions must be used:
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+\time 3/4
+R2. | R2.*2
+\time 13/8
+R1*13/8 | R1*13/8*12 |
+\time 10/8 
+R4*5*4 |
+@end lilypond
+
+An @code{R} spanning a single measure is printed as either a whole
+or breve rest, centered in the measure, regardless of the time
+signature.
+
+If there are 10 or fewer measures of rest, LilyPond prints
+@rglos{church rests} (a series of longa and breve rests)
+in the staff and
+prints a simple line otherwise.  This default number of 10
+may be changed by overriding 
+@code{MultiMeasureRest.expand-limit}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\set Score.skipBars = ##t
+R1*2 | R1*5 | R1*9
+\override MultiMeasureRest #'expand-limit = 3
+R1*2 | R1*5 | R1*9
+@end lilypond
+
+Note that the vertical position on the staff of the multi-measure
+rest symbol of either form cannot be changed.
+
+@cindex text on multi-measure rest
+@cindex script on multi-measure rest
+@cindex fermata on multi-measure rest
+
+Text can be added to multi-measure rests by using the
+@var{note}-@code{markup} syntax @ref{Text markup}.  A variable
+(@code{\fermataMarkup}) is provided for adding fermatas
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\set Score.skipBars = ##t
+\time 3/4
+R2.*10^\markup { \italic "ad lib." }
+R2.^\fermataMarkup
+@end lilypond
+
+@warning{Text attached to a multi-measure rest is created 
+by @code{MultiMeasureRestText}, not
+@code{TextScript}.  Overrides must be directed to the correct
+object, or they will be ignored.  See the following example.}
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\override TextScript #'padding = #5
+R1^"low"
+\override MultiMeasureRestText #'padding = #5
+R1^"high"
+@end lilypond
+
+Text attached to a multi-measure rest will be centered above
+(or below) it.  Long text attached in this way does not cause
+the bar to expand, and may collide with text in adjacent bars.
+Long text is better attached to a zero-length skip note preceding
+the rest, preceded by @code{\fatText}, since this will cause the
+bar to expand to accommodate the length of the text:
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\set Score.skipBars = ##t
+\fatText
+s1*0^\markup {[MAJOR GENERAL]}
+R1*19
+s1*0^\markup {[MABEL] }
+s1*0_\markup {\italic {Cue: ... it is yours}}
+R1*30
+s1^\markup {CHORUS} % Chorus notes would go here
+@end lilypond
+
+
+@seealso
+
+This manual: @ref{Text}
+
+Program reference: 
+
+@internalsref{MultiMeasureRest}.
+
+The layout object @internalsref{MultiMeasureRestNumber} is for the
+default number, and @internalsref{MultiMeasureRestText} for user
+specified texts.
+
+
+@refbugs
+
+If an attempt is made to use fingerings (e.g., 
+@code{R1*10-4}) to put numbers over multi-measure rests, the
+fingering numeral (4) may collide with the bar counter 
+numeral (10).  
+
+@cindex condensing rests
+
+There is no way to automatically condense multiple rests into a
+single multi-measure rest.  Multi-measure rests do not take part
+in rest collisions.
+
+Be careful when entering multi-measure rests followed by whole
+notes.  The following will enter two notes lasting four measures
+each
+
+@example
+R1*4 cis cis
+@end example
+
+
+@node Displaying rhythms
+@subsection Displaying rhythms
+
+@menu
+* Time signature::              
+* Upbeats::                     
+* Unmetered music::             
+* Polymetric notation::         
+* Automatic note splitting::    
+* Setting automatic beam behavior::  
+@end menu
+
+@node Time signature
+@unnumberedsubsubsec Time signature
+
+@cindex Time signature
+@cindex meter
+@funindex \time
+
+Time signature indicates the meter of a piece: a regular pattern
+of strong and weak beats.  It is denoted by a fraction at the
+start of the staff.
+
+The time signature is set with the @code{\time} command
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c2 \time 3/4 c2.
+@end lilypond
+
+@commonprop
+
+The symbol that is printed can be customized with the @code{style}
+property.  Setting it to @code{#'()} uses fraction style for 4/4
+and 2/2 time,
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\time 4/4 c1
+\time 2/2 c1
+\override Staff.TimeSignature #'style = #'()
+\time 4/4 c1
+\time 2/2 c1
+@end lilypond
+
+A time signature is normally printed whenever the time signature
+changes.  If this takes place at the end of a line a warning time
+signature sign is printed at the end of the line and again at the
+start of a new line.  This default behaviour can be modified by
+setting the value of the @code{break-visibility} property.  This
+takes three values which may be set to @code{#t} or @code{#f} to
+specify whether the corresponding time signature is visible or not.
+The order of the three values is @code{end of line visible},
+@code{middle of line visible}, @code{beginning of line visible}.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+% Do not print any time signatures at end of line
+\override Staff.TimeSignature #'break-visibility = ##(#f #t #t)
+\time 4/4 c1
+\time 3/4 c2.
+% Do not print the following 9/8 time signature
+\once \override Staff.TimeSignature #'break-visibility = ##(#t #f #t)
+\time 9/8 c4. c c
+\time 2/2 c1
+\break
+\time 9/8 c4. c c
+\time 12/8 c2. c2.
+@end lilypond
+
+There are many more options for its layout.  See @ref{Ancient time
+signatures}, for more examples.
+
+@code{\time} sets the property @code{timeSignatureFraction},
+@code{beatLength} and @code{measureLength} in the @code{Timing}
+context, which is normally aliased to @internalsref{Score}.  The
+property @code{measureLength} determines where barlines should be
+inserted, and how automatic beams should be generated.  Changing
+the value of @code{timeSignatureFraction} also causes the symbol
+to be printed.
+
+@cindex Measure groupings
+ 
+More options are available through the Scheme function
+@code{set-time-signature}.  In combination with the
+@internalsref{Measure_grouping_engraver}, it will create
+@internalsref{MeasureGrouping} signs.  Such signs ease reading
+rhythmically complex modern music.  In the following example, the
+9/8 measure is subdivided in 2, 2, 2 and 3.  This is passed to
+@code{set-time-signature} as the third argument @code{(2 2 2 3)}
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \relative c'' {
+    #(set-time-signature 9 8 '(2 2 2 3))
+    g8[ g] d[ d] g[ g] a8[( bes g]) |
+    #(set-time-signature 5 8 '(3 2))
+    a4. g4
+  }
+  \layout {
+    \context {
+      \Staff
+      \consists "Measure_grouping_engraver"
+    }
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{TimeSignature}, and
+@internalsref{Timing_translator}.
+
+Examples: @lsr{contemporary,compound-time-signature.ly}.
+
+
+@refbugs
+
+Automatic beaming does not use the measure grouping specified with
+@code{set-time-signature}.
+
+
+@node Upbeats
+@unnumberedsubsubsec Upbeats
+
+@cindex anacrusis
+@cindex upbeat
+@cindex partial measure
+@cindex measure, partial
+@cindex shorten measures
+@funindex \partial
+
+Partial measures, such as an anacrusis or upbeat, are entered
+using the
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\partial 16*5 c16 cis d dis e | a2. c,4 | b2
+@end lilypond
+
+The syntax for this command is
+
+@example
+\partial @var{duration}
+@end example
+
+where @code{duration} is the rhythmic length to be added before
+the next bar.
+
+This is internally translated into
+
+@example
+\set Timing.measurePosition = -@var{length of duration}
+@end example
+
+The property @code{measurePosition} contains a rational number
+indicating how much of the measure has passed at this point.  Note
+that this is a negative number; @code{\partial 4} is internally
+translated to mean @qq{there is a quarter note left in the bar.}
+
+
+@refbugs
+
+This command does not take into account grace notes at the start
+of the music.  When a piece starts with graces notes in the
+pickup, then the @code{\partial} should follow the grace notes
+
+@lilypond[verbatim,quote,ragged-right,relative,fragment]
+\grace f16
+\partial 4
+g4
+a2 g2
+@end lilypond
+
+@code{\partial} is only intended to be used at the beginning of a
+piece.  If you use it after the beginning, some odd warnings may
+occur.
+
+
+@node Unmetered music
+@unnumberedsubsubsec Unmetered music
+
+@cindex cadenza
+@funindex \cadenzaOn
+@funindex \cadenzaOff
+
+Barlines and bar numbers are calculated automatically.  For
+unmetered music (cadenzas, for example), this is not desirable.
+To turn off automatic barlines and bar numbers, use the commands
+@code{\cadenzaOn} and @code{\cadenzaOff}.
+
+@lilypond[verbatim,quote,ragged-right,relative=2,fragment]
+c4 d e d
+\cadenzaOn
+c4 c d8 d d f4 g4.
+\cadenzaOff
+\bar "|"
+d4 e d c
+@end lilypond
+
+
+@refbugs
+
+LilyPond will only insert line breaks and page breaks at a
+barline.  Unless the unmetered music ends before the end of the
+staff line, you will need to insert invisible barlines
+
+@example
+\bar ""
+@end example
+
+@noindent
+to indicate where breaks can occur.
+
+
+@node Polymetric notation
+@unnumberedsubsubsec Polymetric notation
+
+@cindex double time signatures
+@cindex signatures, polymetric
+@cindex polymetric signatures
+@cindex meter, polymetric
+
+Double time signatures are not supported explicitly, but they can
+be faked.  In the next example, the markup for the time signature
+is created with a markup text.  This markup text is inserted in
+the @internalsref{TimeSignature} grob.  See also
+@lsr{contemporary,compound-time-signature}.
+
+@lilypond[verbatim,ragged-right]
+% create 2/4 + 5/8
+tsMarkup =\markup {
+  \override #'(baseline-skip . 2) \number {
+    \column { "2" "4" }
+    \vcenter "+"
+    \bracket \column { "5" "8" }
+  }
+}
+
+{
+  \override Staff.TimeSignature #'stencil =
+    #ly:text-interface::print
+  \override Staff.TimeSignature #'text = #tsMarkup
+  \time 3/2
+  c'2 \bar ":" c'4 c'4.
+}
+@end lilypond
+
+Each staff can also have its own time signature.  This is done by
+moving the @internalsref{Timing_translator} to the
+@internalsref{Staff} context.
+
+@example
+\layout @{
+  \context @{ \Score
+     \remove "Timing_translator"
+     \remove "Default_bar_line_engraver"
+  @}
+  \context @{
+    \Staff
+    \consists "Timing_translator"
+    \consists "Default_bar_line_engraver"
+  @}
+
+@}
+@end example
+
+
+Now, each staff has its own time signature.
+
+@example
+<<
+  \new Staff @{
+    \time 3/4
+    c4 c c | c c c |
+  @}
+  \new Staff @{
+    \time 2/4
+    c4 c | c c | c c
+  @}
+  \new Staff @{
+    \time 3/8
+    c4. c8 c c c4. c8 c c
+  @}
+>>
+@end example
+
+@lilypond[quote,ragged-right]
+\layout{
+  \context{
+     \Score
+     \remove "Timing_translator"
+     \remove "Default_bar_line_engraver"
+    }
+  \context{ \Staff
+    \consists "Timing_translator"
+    \consists "Default_bar_line_engraver"
+  }
+}
+
+\relative c' <<
+  \new Staff {
+    \time 3/4
+    c4 c c | c c c |
+  }
+  \new Staff {
+    \time 2/4
+    c4 c | c c | c c
+  }
+  \new Staff {
+    \time 3/8
+    c4. c8 c c c4. c8 c c
+  }
+>>
+@end lilypond
+
+
+A different form of polymetric notation is where note lengths have
+different values across staves, but the bars are all the same 
+length.
+
+This notation can be created by setting a common time signature
+for each staff but replacing it manually using
+@code{timeSignatureFraction} to the desired fraction.  Then the
+printed durations in each staff are scaled to the common time
+signature.  The latter is done with @code{\compressMusic}, which
+is used in a similar way to @code{\times}, but does not create 
+a tuplet bracket.  The syntax is 
+
+@example 
+\compressMusic 
+#'(@var{numerator} . @var{denominator}) @var{musicexpr} 
+@end example
+
+
+
+In this example, music with the time signatures of 3/4, 9/8, and
+10/8 are used in parallel.  In the second staff, shown durations
+are multiplied by 2/3, so that 2/3 * 9/8 = 3/4, and in the third
+staff, shown durations are multiplied by 3/5, so that 3/5 * 10/8 =
+3/4.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\relative c' { <<
+  \new Staff {
+    \time 3/4
+    c4 c c | c c c |
+  }
+  \new Staff {
+    \time 3/4
+    \set Staff.timeSignatureFraction = #'(9 . 8)
+    \compressMusic #'(2 . 3)
+      \repeat unfold 6 { c8[ c c] }
+  }
+  \new Staff {
+    \time 3/4
+    \set Staff.timeSignatureFraction = #'(10 . 8)
+    \compressMusic #'(3 . 5) {
+      \repeat unfold 2 { c8[ c c] }
+      \repeat unfold 2 { c8[ c] }
+      | c4. c4. \times 2/3 { c8 c c } c4
+    }
+  }
+>> }
+@end lilypond
+
+
+@refbugs
+
+When using different time signatures in parallel, the spacing is
+aligned vertically, but barlines distort the regular spacing.
+
+
+@node Automatic note splitting
+@unnumberedsubsubsec Automatic note splitting
+
+Long notes which overrun barlines can be converted 
+automatically to tied notes.  This is
+done by replacing the @internalsref{Note_heads_engraver} by the
+@internalsref{Completion_heads_engraver}.  In the following
+examples, notes crossing the barline are split and tied.
+
+@lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
+\new Voice \with {
+  \remove "Note_heads_engraver"
+  \consists "Completion_heads_engraver"
+} {
+  c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
+}
+@end lilypond
+
+This engraver splits all running notes at the barline, and
+inserts ties.  One of its uses is to debug complex scores: if the
+measures are not entirely filled, then the ties exactly show how
+much each measure is off.
+
+If you want to allow line breaking on the barlines where
+@internalsref{Completion_heads_engraver} splits notes, you must
+also remove @internalsref{Forbid_line_break_engraver}.
+
+
+@refbugs
+
+Not all durations (especially those containing tuplets) can be
+represented exactly with normal notes and dots, but the engraver
+will not insert tuplets.
+
+@code{Completion_heads_engraver} only affects notes; it does not
+split rests.
+
+
+@seealso
+
+Program reference: @internalsref{Completion_heads_engraver}.
+
+
+@node Setting automatic beam behavior
+@unnumberedsubsubsec Setting automatic beam behavior
+
+@funindex autoBeamSettings
+@funindex (end * * * *)
+@funindex (begin * * * *)
+@cindex automatic beams, tuning
+@cindex tuning automatic beaming
+
+@c [TODO: use \applyContext]
+
+In normal time signatures, automatic beams can start on any note but can
+only end in a few positions within the measure: beams can end on a beat,
+or at durations specified by the properties in
+@code{autoBeamSettings}.  The properties in @code{autoBeamSettings}
+consist of a list of rules for where beams can begin and end.  The
+default @code{autoBeamSettings} rules are defined in
+@file{scm/@/auto@/-beam@/.scm}.
+
+In order to add a rule to the list, use
+@example
+#(override-auto-beam-setting '(be p q n m) a b [context])
+@end example
+
+@itemize
+
+@item @code{be} is either "begin" or "end".
+
+@item @code{p/q} is the duration of the note for which you want
+to add a rule.  A beam is considered to have the duration of its
+shortest note.  Set @code{p} and @code{q} to @code{'*'} to
+have this apply to any beam.
+
+@item @code{n/m} is the time signature to which
+this rule should apply.  Set @code{n} and @code{m} to @code{'*'}
+to have this apply in any time signature.
+
+@item @code{a/b} is the position in the bar at which the beam should
+begin/end.
+
+@item @code{context} is optional, and it specifies the context at which
+the change should be made.  The default is @code{'Voice}.
+@code{#(score-override-auto-beam-setting '(A B C D) E F)} is equivalent to
+@code{#(override-auto-beam-setting '(A B C D) E F 'Score)}.
+
+@end itemize
+
+For example, if automatic beams should always end on the first quarter
+note, use
+
+@example
+#(override-auto-beam-setting '(end * * * *) 1 4)
+@end example
+
+You can force the beam settings to only take effect on beams whose shortest
+note is a certain duration
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\time 2/4
+#(override-auto-beam-setting '(end 1 16 * *) 1 16)
+a16 a a a a a a a |
+a32 a a a a16 a a a a a |
+#(override-auto-beam-setting '(end 1 32 * *) 1 16)
+a32 a a a a16 a a a a a |
+@end lilypond
+
+You can force the beam settings to only take effect in certain time
+signatures
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\time 5/8
+#(override-auto-beam-setting '(end * * 5 8) 2 8)
+c8 c d d d
+\time 4/4
+e8 e f f e e d d
+\time 5/8
+c8 c d d d
+@end lilypond
+
+You can also remove a previously set beam-ending rule by using
+
+@example
+#(revert-auto-beam-setting '(be p q n m) a b [context])
+@end example
+
+@noindent
+be, p, q, n, m, a, b and context are the same as above.  Note that the
+default rules are specified in @file{scm/@/auto@/-beam@/.scm},
+so you can revert rules that you did not explicitly create.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\time 4/4
+a16 a a a a a a a a a a a a a a a
+#(revert-auto-beam-setting '(end 1 16 4 4) 1 4)
+a16 a a a a a a a a a a a a a a a
+@end lilypond
+
+The rule in a revert-auto-beam-setting statement must exactly match the
+original rule.  That is, no wildcard expansion is taken into account.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\time 1/4
+#(override-auto-beam-setting '(end 1 16 1 4) 1 8)
+a16 a a a
+#(revert-auto-beam-setting '(end 1 16 * *) 1 8) % this won't revert it!
+a a a a
+#(revert-auto-beam-setting '(end 1 16 1 4) 1 8) % this will
+a a a a
+@end lilypond
+
+
+
+@c TODO:  old material -- not covered by above stuff, I think.
+If automatic beams should end on every quarter in 5/4 time, specify
+all endings
+@example
+#(override-auto-beam-setting '(end * * * *) 1 4 'Staff)
+#(override-auto-beam-setting '(end * * * *) 1 2 'Staff)
+#(override-auto-beam-setting '(end * * * *) 3 4 'Staff)
+#(override-auto-beam-setting '(end * * * *) 5 4 'Staff)
+@dots{}
+@end example
+
+The same syntax can be used to specify beam starting points.  In this
+example, automatic beams can only end on a dotted quarter note
+@example
+#(override-auto-beam-setting '(end * * * *) 3 8)
+#(override-auto-beam-setting '(end * * * *) 1 2)
+#(override-auto-beam-setting '(end * * * *) 7 8)
+@end example
+In 4/4 time signature, this means that automatic beams could end only on
+3/8 and on the fourth beat of the measure (after 3/4, that is 2 times
+3/8, has passed within the measure).
+
+If any unexpected beam behaviour occurs, check the default automatic beam
+settings in @file{scm/@/auto@/-beam@/.scm}
+for possible interference, because the beam
+endings defined there will still apply on top of your own overrides.  Any
+unwanted endings in the default vales must be reverted for your time
+signature(s).
+
+For example, to typeset @code{(3 4 3 2)}-beam endings in 12/8, begin
+with
+
+@example
+%%% revert default values in scm/auto-beam.scm regarding 12/8 time
+#(revert-auto-beam-setting '(end * * 12 8) 3 8)
+#(revert-auto-beam-setting '(end * * 12 8) 3 4)
+#(revert-auto-beam-setting '(end * * 12 8) 9 8)
+
+%%% your new values
+#(override-auto-beam-setting '(end 1 8 12 8) 3 8)
+#(override-auto-beam-setting '(end 1 8 12 8) 7 8)
+#(override-auto-beam-setting '(end 1 8 12 8) 10 8)
+@end example
+
+@cindex automatic beam generation
+@cindex autobeam
+@funindex autoBeaming
+@cindex lyrics
+
+If beams are used to indicate melismata in songs, then automatic
+beaming should be switched off with @code{\autoBeamOff}.
+
+
+@refcommands
+
+@funindex \autoBeamOff
+@code{\autoBeamOff},
+@funindex \autoBeamOn
+@code{\autoBeamOn}.
+
+@commonprop
+
+Beaming patterns may be altered with the @code{beatGrouping} property,
+
+@lilypond[quote,verbatim,relative=2,fragment,ragged-right]
+\time 5/16
+\set beatGrouping = #'(2 3)
+c8[^"(2+3)" c16 c8]
+\set beatGrouping = #'(3 2)
+c8[^"(3+2)" c16 c8]
+@end lilypond
+
+
+@refbugs
+
+If a score ends while an automatic beam has not been ended and is
+still accepting notes, this last beam will not be typeset at all.  The
+same holds polyphonic voices, entered with @code{<< @dots{} \\ @dots{}
+>>}.  If a polyphonic voice ends while an automatic beam is still
+accepting notes, it is not typeset.
+
+
+
+
+@node Beams
+@subsection Beams
+
+@menu
+* Automatic beams::             
+* Manual beams::                
+@end menu
+
+@node Automatic beams
+@unnumberedsubsubsec Automatic beams
+
+By default beams are inserted automatically
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c c c
+\time 6/8 c c c c8. c16 c8
+@end lilypond
+
+When these automatic decisions are not good enough, beaming 
+can be entered explicitly.  It is also possible to define beaming
+patterns that differ from the defaults.  See @ref{Manual beams}
+and @ref{Setting automatic beam behavior}.
+
+@cindex autoBeamOn
+@cindex autoBeamOff
+
+@noindent
+Automatic beaming may be turned off and on with
+@code{\autoBeamOff} and @code{\autoBeamOn} commands:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c4 c8 c8. c16 c8. c16 c8
+\autoBeamOff
+c4 c8 c8. c16 c8.
+\autoBeamOn
+c16 c8
+@end lilypond
+
+
+@commonprop
+
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
+
+LilyPond can automatically determine beaming patterns within a
+beam, but this automatic behavior can sometimes produce odd
+results; therefore the @code{stemLeftBeamCount} and
+@code{stemRightBeamCount} properties can be used to override the
+defaults.  If either property is set, its value will be used only
+once, and then it is erased.
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+   f8[ r16
+      f g a]
+   f8[ r16
+   \set stemLeftBeamCount = #1
+      f g a]
+}
+@end lilypond
+
+The property @code{subdivideBeams} can be set in order to
+subdivide all 16th or shorter beams.
+When set, multiple beams will be sub-divided at beat 
+positions, defined by the current value of @code{beatLength},
+by drawing only one beam over the beat.
+
+@lilypond[fragment,ragged-right,quote,relative=2,verbatim]
+c16[ c c c c c c c]
+\set subdivideBeams = ##t
+c16[ c c c c c c c]
+\set Score.beatLength = #(ly:make-moment 1 8)
+c16[ c c c c c c c]
+@end lilypond
+@funindex subdivideBeams
+
+@noindent
+For more information about @code{make-moment}, see
+@ref{Time administration}.
+
+@c TODO Consider whether the section Setting automatic
+@c beam behavior should all be moved here.  For now
+@c here's a link to it.
+
+For details about modifying the automatic beam behaviour
+see @ref{Setting automatic beam behavior}
+
+@funindex breakable
+
+Line breaks are normally forbidden when beams cross barlines.
+This behavior can be changed by setting the @code{breakable} 
+property: @code{\override Beam #'breakable = ##t}.
+
+@cindex beams and line breaks
+@cindex beams, kneed
+@cindex kneed beams
+@cindex auto-knee-gap
+
+Kneed beams are inserted automatically when a large gap is
+detected between the note heads.  This behavior can be tuned
+through the @code{auto-knee-gap} property.  A kneed beam is
+drawn if the gap is larger than the value of 
+@code{auto-knee-gap} plus the width of the beam object (which
+depends on the duration of the notes and the slope of the beam).
+By default @code{auto-knee-gap} is set to 5.5 staff spaces.
+
+@lilypond[fragment,ragged-right,quote,verbatim]
+f8 f''8 f8 f''8
+\override Beam #'auto-knee-gap = #6
+f8 f''8 f8 f''8
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{Beam}.
+
+
+@refbugs
+
+Automatically kneed cross-staff beams cannot be used together with
+hidden staves.  See @ref{Hiding staves}.
+
+Beams can collide with noteheads and accidentals in other voices
+
+@node Manual beams
+@unnumberedsubsubsec Manual beams
+
+@cindex beams, manual
+
+Individual notes may be marked with @code{\noBeam} to prevent them
+from being beamed:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\time 2/4 c8 c\noBeam c c
+@end lilypond
+
+@funindex ]
+@funindex [
+
+In some cases it may be necessary to override the automatic
+beaming algorithm.  For example, the autobeamer will not put beams
+over rests or barlines, and in choral scores the beaming is
+often set to follow the meter of the lyrics rather than the
+notes. Such beams can be specified manually by
+marking the begin and end point with @code{[} and @code{]}
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+{
+  r4 r8[ g' a r8] r8 g[ | a] r8
+}
+@end lilypond
+
+@cindex beams, feathered
+@funindex \featherDurations 
+
+Feathered beams are used to indicate that a small group of notes
+should be played at an increasing (or decreasing) tempo, without
+changing the overall tempo of the piece.  The extent of the 
+feathered beam must be indicated manually using @code{[} and
+@code{]}, and the beam feathering is turned on by specifying a 
+direction to the Beam property @code{grow-direction}.
+
+If the placement of the notes and the sound in the MIDI output
+is to reflect the ritardando or accelerando indicated by the
+feathered beam the notes must be grouped as a
+music expression delimited by braces and preceded by a
+@code{featheredDurations} command which specifies the ratio
+between the durations of the first and last notes in the group.
+
+The square brackets
+show the extent of the beam and the braces show
+which notes are to have their durations modified.  Normally 
+these would delimit the same group of notes, but this is not
+required: the two commands are independent. 
+
+In the following example the eight 16th notes occupy exactly
+the same time as a half note, but the first note is twice
+as short as the last one, with the intermediate notes gradually
+lengthening.  The first four 32nd notes gradually speed up,
+while the last four 32nd notes are at a constant tempo.
+
+@lilypond[ragged-right,relative=1,fragment,verbatim,quote]
+\override Beam #'grow-direction = #LEFT
+\featherDurations #(ly:make-moment 2 1)
+{ c16[ c c c c c c c] }
+\override Beam #'grow-direction = #RIGHT
+\featherDurations #(ly:make-moment 2 3)
+{ c32[ d e f] }
+% revert to non-feathered beams
+\override Beam #'grow-direction = #'()
+{ g32[ a b c] }
+@end lilypond
+
+@noindent
+The spacing in the printed output represents the 
+note durations only approximately, but the midi output is exact.
+
+
+@commonprop
+
+Line breaking is prevented by beams which straddle barlines. The
+@samp{breakable} property of @code{Beam} allows this behaviour
+to be overridden:
+
+@lilypond[ragged-right,relative=2,fragment,verbatim,quote]
+\override Beam #'breakable = ##t
+c8 \repeat unfold 15 {c[ c] } c
+@end lilypond
+
+
+@refbugs
+
+The @code{\featherDurations} command only works with very short
+music snippets, and when numbers in the fraction are small.
+
+
+@node Bars
+@subsection Bars
+
+
+@menu
+* Bar lines::                   
+* Bar numbers::                 
+* Bar and bar number checks::   
+* Rehearsal marks::             
+@end menu
+
+@node Bar lines
+@unnumberedsubsubsec Bar lines
+
+@cindex Bar lines
+@cindex Barlines
+@funindex \bar
+@cindex measure lines
+@cindex repeat bars
+
+Barlines delimit measures, and are also used to indicate
+repeats.  Normally, simple barlines are automatically inserted
+into the printed output at places based on the current time 
+signature.  
+
+The simple barlines inserted automatically can be changed to 
+other types with the @code{\bar} command.  For example, a closing
+double barline is usually placed at the end of a piece:
+
+@lilypond[quote,ragged-right,relative=1,fragment,verbatim]
+e4 d c2 \bar "||"
+@end lilypond
+
+@warning{An incorrect duration can lead to poorly formatted
+music.}
+ 
+It is not invalid if the final note in a bar does not 
+end on the automatically entered barline: the note is assumed 
+to carry over into the next bar.  But if a long sequence
+of such carry-over bars appears the music can appear compressed
+or even flowing off the page.  This is because automatic line
+breaks happen only at the end of complete bars, i.e. where 
+the end of a note coincides with the end of a bar.
+
+Line breaks are also permitted at manually inserted barlines
+even within incomplete bars.  To allow a line break without 
+printing a barline, use
+
+@example
+\bar ""
+@end example
+
+@noindent
+This will insert an invisible barline and allow (but not
+force) a line break to occur at this point.  The bar number 
+counter is not increased.  To force a line break see 
+@ref{Line breaking}.
+
+This and other special barlines may be inserted manually at any
+point.  When they coincide with the end of a bar they replace
+the simple barline which would have been inserted there 
+automatically.  When they do not coincide
+with the end of a bar the specified barline is inserted at that
+point in the printed output.  Such insertions do not affect
+the calculation and placement of subsequent automatic barlines.  
+
+The simple barline and four types of double barline are available
+for manual insertion:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+f1 \bar "|" g \bar "||" a \bar ".|" b \bar ".|." c \bar "|." d
+@end lilypond
+
+@noindent
+together with dotted and dashed barlines:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+f1 \bar ":" g \bar "dashed" a
+@end lilypond
+
+@noindent
+and three types of repeat barline:
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+f1 \bar "|:" g \bar ":|:" a \bar ":|" b
+@end lilypond
+
+Although the barline types signifying repeats may be inserted
+manually they do not in themselves cause LilyPond to recognise
+a repeated section.  Such repeated sections are better entered
+using the various repeat commands (see @ref{Repeats}), which
+automatically print the appropriate barlines.
+
+In addition, you can specify @code{"||:"}, which is equivalent to
+@code{"|:"} except at line breaks, where it gives a double bar
+line at the end of the line and a start repeat at the beginning of
+the next line. 
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+\override Score.RehearsalMark #'padding = #3
+c c c c
+\bar "||:" 
+c c c c \break
+\bar "||:" 
+c c c c
+@end lilypond
+
+In scores with many staves, a @code{\bar} command in one staff is
+automatically applied to all staves.  The resulting barlines are
+connected between different staves of a @code{StaffGroup},
+@code{PianoStaff}, or @code{GrandStaff}.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+<<
+  \new StaffGroup <<
+    \new Staff {
+      e'4 d'
+      \bar "||"
+      f' e'
+    }
+    \new Staff { \clef bass c4 g e g }
+  >>
+  \new Staff { \clef bass c2 c2 }
+>>
+@end lilypond
+
+
+@commonprop
+
+@funindex whichBar
+@funindex defaultBarType
+
+The command @code{\bar }@var{bartype} is a short cut for
+@code{\set Timing.whichBar = }@var{bartype}.  A barline is 
+created whenever the @code{whichBar} property is
+set.  
+
+The default bar type used for automatically inserted barlines is
+@code{"|"}.  This may be changed at any time
+with @code{\set Timing.defaultBarType = }@var{bartype}.  
+
+@seealso
+
+In this manual: @ref{Repeats}, @ref{System start delimiters}.
+
+Program reference: @internalsref{BarLine} (created at
+@internalsref{Staff} level), @internalsref{SpanBar} (across
+staves), @internalsref{Timing_translator} (for Timing 
+properties).
+
+
+@node Bar numbers
+@unnumberedsubsubsec Bar numbers
+
+@cindex Bar numbers
+@cindex measure numbers
+@funindex currentBarNumber
+
+Bar numbers are typeset by default at the start of every line
+except the first line.  The
+number itself is stored in the @code{currentBarNumber} property,
+which is normally updated automatically for every measure.  It
+may also be set manually:
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+c1 c c c
+\break
+\set Score.currentBarNumber = #50
+c1 c c c
+@end lilypond
+
+
+@commonprop
+
+@funindex barNumberVisibility
+@cindex bar numbers, regular spacing
+
+Bar numbers can be typeset at regular intervals instead of just at
+the beginning of every line.  To do this the default behaviour
+must be overridden to permit bar numbers to be printed at places
+other than the start of a line.  This is controlled by the
+@code{break-visibility} property of @code{BarNumber}.  This takes
+three values which may be set to @code{#t} or @code{#f} to specify
+whether the corresponding bar number is visible or not.  The order
+of the three values is @code{end of line visible}, @code{middle of
+line visible}, @code{beginning of line visible}.  In the following
+example bar numbers are printed at all possible places:
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\override Score.BarNumber #'break-visibility = ##(#t #t #t)
+\set Score.currentBarNumber = #11
+\bar ""  % Permit first bar number to be printed
+c1 c c c
+\break
+c c c c
+@end lilypond
+
+@c  All the rest of these examples will be added to LSR
+@c  and moved into the Snippets.  -gp
+
+@noindent
+and here the bar numbers are printed every two bars
+except at the end of the line:
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\override Score.BarNumber #'break-visibility = ##(#f #t #t)
+\set Score.currentBarNumber = #11
+\bar ""  % Permit first bar number to be printed
+% Print a bar number every 2nd bar
+\set Score.barNumberVisibility = #(every-nth-bar-number-visible 2)
+c1 c c c c
+\break
+c c c c c
+@end lilypond
+
+The size of the bar number may be changed.  This is illustrated
+in the following example, which also shows how to enclose bar 
+numbers in boxes and circles, and shows an alternative way
+of specifying @samp{#(#f #t #t)} for @code{break-visibility}.
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+% Prevent bar numbers at the end of a line and permit them elsewhere
+\override Score.BarNumber #'break-visibility
+  = #end-of-line-invisible
+
+% Increase the size of the bar number by 2 
+\override Score.BarNumber #'font-size = #2
+\repeat unfold 3 { c1 } \bar "|"
+
+% Draw a box round the following bar number(s)
+\override Score.BarNumber  #'stencil
+  = #(make-stencil-boxer 0.1 0.25 ly:text-interface::print)
+\repeat unfold 3 { c1 } \bar "|"
+
+% Draw a circle round the following bar number(s)
+\override Score.BarNumber  #'stencil
+  = #(make-stencil-circler 0.1 0.25 ly:text-interface::print)
+\repeat unfold 4 { c1 } \bar "|."
+@end lilypond
+
+@cindex Bar number alignment
+
+Bar numbers by default are left-aligned to their parent object.
+This is usually the left edge of a line or, if numbers are printed
+within a line, the left barline of the bar.  The numbers may also
+be positioned directly on the barline or right-aligned to the 
+barline:
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\set Score.currentBarNumber = #111
+\override Score.BarNumber #'break-visibility = ##(#t #t #t)
+% Increase the size of the bar number by 2
+\override Score.BarNumber #'font-size = #2
+% Print a bar number every 2nd bar
+\set Score.barNumberVisibility = #(every-nth-bar-number-visible 2)
+c1 c1
+% Centre-align bar numbers
+\override Score.BarNumber #'self-alignment-X = #0
+c1 c1
+% Right-align bar numbers
+\override Score.BarNumber #'self-alignment-X = #-1
+c1 c1
+@end lilypond
+
+Bar numbers can be removed entirely by removing the Bar number
+engraver from the score context.
+
+@lilypond[verbatim,ragged-right,quote]
+\layout {
+  \context {
+    \Score
+    \remove "Bar_number_engraver"
+  }
+}
+\relative c''{
+  c4 c c c \break
+  c4 c c c
+}
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{BarNumber}.
+
+Examples: @lsrdir{bar number}
+
+
+@refbugs
+
+Bar numbers can collide with the top of the 
+@internalsref{StaffGroup} bracket, if there is one.
+To solve this, the @code{padding} property of 
+@internalsref{BarNumber} can be used to
+position the number correctly.
+
+Bar numbers may only be printed at barlines; to print a bar
+number at the beginning of a piece, an empty barline must be
+inserted there, and a value other than @code{1} must be placed
+in @code{currentBarNumber}:
+
+@lilypond[verbatim,ragged-right,quote,fragment,relative]
+\set Score.currentBarNumber = #50
+\bar ""
+c1 c c c
+c1 c c c
+\break
+@end lilypond
+
+
+
+@node Bar and bar number checks
+@unnumberedsubsubsec Bar and bar number checks
+
+@cindex Bar check
+@funindex barCheckSynchronize
+@funindex |
+
+Bar checks help detect errors in the entered durations.
+A bar check may be entered using the bar symbol, @samp{|}, 
+at any place where a barline is expected to fall.  
+If bar check lines are encountered at other places, 
+a list of warnings is printed in the log file,
+showing the line numbers and lines  
+in which the bar checks failed.  In the next
+example, the second bar check will signal an error
+
+@example
+\time 3/4 c2 e4 | g2 |
+@end example
+
+Bar checks can also be used in lyrics, for example
+
+@example
+\lyricmode @{
+  \time 2/4
+  Twin -- kle | Twin -- kle |
+@}
+@end example
+
+An incorrect duration can result in a completely garbled score,
+especially if the score is polyphonic, so a good place to start
+correcting input is by scanning for failed bar checks and
+incorrect durations.
+
+@funindex |
+@funindex pipeSymbol
+
+It is also possible to redefine the action taken when a bar check 
+or pipe symbol, @samp{|}, is encountered in the input, so that 
+it does something other than a bar check.  This is done by 
+assigning a music expression to @code{pipeSymbol}.  
+In the following example @samp{|} is set to insert a double bar 
+line wherever it appears in the input, rather than checking 
+for end of bar.
+
+@lilypond[quote,ragged-right,verbatim]
+pipeSymbol = \bar "||"
+{ 
+  c'2 c'2 |
+  c'2 c'2
+  c'2 | c'2
+  c'2 c'2
+}
+@end lilypond
+
+When copying large pieces of music, it can be helpful to check
+that the LilyPond bar number corresponds to the original that you
+are entering from.  This can be checked with
+@code{\barNumberCheck}, for example,
+
+@verbatim
+\barNumberCheck #123
+@end verbatim
+
+@noindent
+will print a warning if the @code{currentBarNumber} is not 123
+when it is processed.
+
+
+@node Rehearsal marks
+@unnumberedsubsubsec Rehearsal marks
+
+@cindex Rehearsal marks
+@funindex \mark
+
+To print a rehearsal mark, use the @code{\mark} command
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+c1 \mark \default
+c1 \mark \default
+c1 \mark #8
+c1 \mark \default
+c1 \mark \default
+@end lilypond
+
+@noindent
+The letter@tie{}@q{I} is skipped in accordance with engraving
+traditions.  If you wish to include the letter @q{I}, then use
+
+@example
+\set Score.markFormatter = #format-mark-alphabet
+@end example
+
+The mark is incremented automatically if you use @code{\mark
+\default}, but you can also use an integer argument to set the
+mark manually.  The value to use is stored in the property
+@code{rehearsalMark}.
+
+The style is defined by the property @code{markFormatter}.  It is
+a function taking the current mark (an integer) and the current
+context as argument.  It should return a markup object.  In the
+following example, @code{markFormatter} is set to a pre-defined
+procedure.  After a few measures, it is set to a procedure that
+produces a boxed number.
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\set Score.markFormatter = #format-mark-numbers
+c1 \mark \default
+c1 \mark \default
+\set Score.markFormatter = #format-mark-box-numbers
+c1 \mark \default
+c1 \mark \default
+c1
+@end lilypond
+
+The file @file{scm/@/translation@/-functions@/.scm} contains the
+definitions of @code{format-mark-numbers} (the default format),
+@code{format-mark-box-numbers}, @code{format-mark-letters} and
+@code{format-mark-box-letters}.  These can be used as inspiration
+for other formatting functions.
+
+You may use @code{format-mark-barnumbers},
+@code{format-mark-box-barnumbers}, and
+@code{format-mark-circle-barnumbers} to get bar numbers instead of
+incremented numbers or letters.
+
+Other styles of rehearsal mark can be specified manually
+
+@example
+\mark "A1"
+@end example
+
+@noindent
+@code{Score.markFormatter} does not affect marks specified in this
+manner.  However, it is possible to apply a @code{\markup} to the
+string.
+
+@example
+\mark \markup@{ \box A1 @}
+@end example
+
+@cindex segno
+@cindex coda
+@cindex D.S al Fine
+
+Music glyphs (such as the segno sign) may be printed inside a
+@code{\mark}
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative]
+c1 \mark \markup { \musicglyph #"scripts.segno" }
+c1 \mark \markup { \musicglyph #"scripts.coda" }
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+See @ref{The Feta font}, for a list of symbols which may be
+printed with @code{\musicglyph}.
+
+For common tweaks to the positioning of rehearsal marks, see
+@ref{Text marks}.
+
+@seealso
+
+This manual: @ref{Text marks}.
+
+Program reference: @internalsref{RehearsalMark}.
+
+Init files: @file{scm/@/translation@/-functions@/.scm} contains
+the definition of @code{format-mark-numbers} and
+@code{format-mark-letters}.  They can be used as inspiration for
+other formatting functions.
+
+Examples: @lsr{parts,rehearsal-mark-numbers.ly}
+
+
+@node Special rhythmic concerns
+@subsection Special rhythmic concerns
+
+
+@menu
+* Grace notes::                 
+* Aligning to cadenzas::        
+* Time administration::         
+@end menu
+
+@node Grace notes
+@unnumberedsubsubsec Grace notes
+
+@funindex \grace
+@cindex ornaments
+@cindex grace notes
+@cindex appoggiatura
+@cindex acciaccatura
+
+Grace notes are ornaments that are written out.  The most common
+ones are acciaccatura, which should be played as very short.  It
+is denoted by a slurred small note with a slashed stem.  The
+appoggiatura is a grace note that takes a fixed fraction of the
+main note, and is denoted as a slurred note in small print without
+a slash.  They are entered with the commands @code{\acciaccatura}
+and @code{\appoggiatura}, as demonstrated in the following example
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+b4 \acciaccatura d8 c4 
+\appoggiatura e8 d4
+\acciaccatura { g16[ f] } e4
+@end lilypond
+
+Both are special forms of the @code{\grace} command.  By prefixing
+this keyword to a music expression, a new one is formed, which
+will be printed in a smaller font and takes up no logical time in
+a measure.
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+c4 \grace c16 c4
+\grace { c16[ d16] } c2 c4
+@end lilypond
+
+@noindent
+Unlike @code{\acciaccatura} and @code{\appoggiatura}, the
+@code{\grace} command does not start a slur.
+
+The placement of grace notes is synchronized between different
+staves.  In the following example, there are two sixteenth grace
+notes for every eighth grace note
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \grace { c16[ d e f] } e4 }
+   \new Staff { c4 \grace { g8[ b] } c4 } >>
+@end lilypond
+
+@funindex \afterGrace
+
+If you want to end a note with a grace, use the @code{\afterGrace}
+command.  It takes two arguments: the main note, and the grace
+notes following the main note.
+
+@lilypond[ragged-right, verbatim,relative=2,fragment]
+c1 \afterGrace d1 { c16[ d] } c4
+@end lilypond
+
+This will put the grace notes after a @q{space} lasting 3/4 of the
+length of the main note.  The fraction 3/4 can be changed by
+setting @code{afterGraceFraction}, ie.
+
+@example
+#(define afterGraceFraction (cons 7 8))
+@end example
+
+@noindent
+will put the grace note at 7/8 of the main note.
+
+The same effect can be achieved manually by doing
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  << { d1^\trill_( }
+     { s2 \grace { c16[ d] } } >>
+  c4)
+}
+@end lilypond
+
+@noindent
+By adjusting the duration of the skip note (here it is a
+half-note), the space between the main-note and the grace
+may be adjusted.
+
+A @code{\grace} music expression will introduce special
+typesetting settings, for example, to produce smaller type, and
+set directions.  Hence, when introducing layout tweaks, they
+should be inside the grace expression, for example,
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\new Voice {
+  \acciaccatura {
+    \stemDown
+    f16->
+    \stemNeutral
+  }
+  g4
+}
+@end lilypond
+
+@noindent
+The overrides should also be reverted inside the grace expression.
+
+The layout of grace expressions can be changed throughout the
+music using the function @code{add-grace-property}.  The following
+example undefines the @code{Stem} direction for this grace, so
+that stems do not always point up.
+
+@example
+\new Staff @{
+  #(add-grace-property 'Voice 'Stem 'direction '())
+  @dots{}
+@}
+@end example
+
+@noindent
+Another option is to change the variables @code{startGraceMusic},
+@code{stopGraceMusic}, @code{startAcciaccaturaMusic},
+@code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic},
+@code{stopAppoggiaturaMusic}.  The default values of these can be
+seen in the file @file{ly/@/grace@/-init@/.ly}.  By redefining
+them other effects may be obtained.
+
+@noindent
+The slash through the stem in acciaccaturas can be obtained in
+other situations by @code{\override Stem  #'stroke-style =
+#"grace"}.
+
+
+@commonprop
+
+Grace notes may be forced to use align with regular notes
+in other staves by setting @code{strict-grace-spacing} to
+##t:
+
+@lilypond[relative=2,ragged-right]
+<<
+  \override Score.SpacingSpanner #'strict-grace-spacing = ##t
+  \new Staff {
+     c'4
+     \afterGrace
+     c'4
+     { c'16[ c'8 c'16] }
+     c'4
+  }  
+  \new Staff {
+     c'16[ c'16 c'16 c'16]
+     c'16[ c'16 c'16 c'16]
+     c'4
+  }
+>>
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{GraceMusic}.
+
+
+@refbugs
+
+A multi-note beamed acciaccatura is printed without a slash, 
+and looks exactly the same as a multi-note beamed appoggiatura.
+@c TODO Add link to LSR snippet to add slash when available 
+
+Grace note synchronization can also lead to surprises.  Staff
+notation, such as key signatures, barlines, etc., are also
+synchronized.  Take care when you mix staves with grace notes and
+staves without, for example,
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" d4 } >>
+@end lilypond
+
+@noindent
+This can be remedied by inserting grace skips of the corresponding
+durations in the other staves.  For the above example
+
+@lilypond[quote,ragged-right,relative=2,verbatim,fragment]
+<< \new Staff { e4 \bar "|:" \grace c16 d4 }
+   \new Staff { c4 \bar "|:" \grace s16 d4 } >>
+@end lilypond
+
+Grace sections should only be used within sequential music
+expressions.  Nesting or juxtaposing grace sections is not
+supported, and might produce crashes or other errors.
+
+@node Aligning to cadenzas
+@unnumberedsubsubsec Aligning to cadenzas
+
+In an orchestral context, cadenzas present a special problem: when
+constructing a score that includes a cadenza, all other
+instruments should skip just as many notes as the length of the
+cadenza, otherwise they will start too soon or too late.
+
+A solution to this problem are the functions
+@code{mmrest-of-length} and @code{skip-of-length}.  These Scheme
+functions take a piece of music as argument, and generate a
+multi-rest or @code{\skip}, exactly as long as the piece.  The use
+of @code{mmrest-of-length} is demonstrated in the following
+example.
+
+@lilypond[verbatim,ragged-right,quote]
+cadenza = \relative c' {
+  c4 d8 << { e f g } \\ { d4. } >>
+  g4 f2 g4 g
+}
+
+\new GrandStaff <<
+  \new Staff { \cadenza c'4 }
+  \new Staff {
+    #(ly:export (mmrest-of-length cadenza))
+    c'4
+  }
+>>
+@end lilypond
+
+
+@node Time administration
+@unnumberedsubsubsec Time administration
+
+@cindex Time administration
+
+@funindex currentBarNumber
+@funindex measurePosition
+@funindex measureLength
+
+Time is administered by the
+@code{Timing_translator}, which by default is
+to be found in the @code{Score} context.  An
+alias, @code{Timing}, is added to the context in which
+the @code{Timing_translator} is placed.
+
+The following properties of @code{Timing} are used
+to keep track of timing within the score.
+ 
+@table @code
+@item currentBarNumber
+The current measure number.  For an example showing the
+use of this property see @ref{Bar numbers}.
+
+@item measureLength
+The length of the measures in the current time signature.  For a
+4/4 time this is@tie{}1, and for 6/8 it is 3/4.  Its value
+determines when barlines are inserted and how automatic beams
+should be generated.
+
+@item measurePosition
+The point within the measure where we currently are.  This
+quantity is reset by subtracting @code{measureLength} whenever
+@code{measureLength} is reached or exceeded.  When that happens, 
+@code{currentBarNumber} is incremented.
+
+@item timing
+If set to true, the above variables are updated for every time
+step.  When set to false, the engraver stays in the current
+measure indefinitely.
+
+@end table
+
+Timing can be changed by setting any of these variables
+explicitly.  In the next example, the default 4/4 time 
+signature is printed, but @code{measureLength} is set to 5/4.
+At 4/8 though the third bar, the @code{measurePosition} is
+advanced by 1/8 to 5/8, shortening that bar by 1/8.
+The next barline then falls at 9/8 rather than 5/4.
+
+@lilypond[quote,ragged-right,verbatim,relative,fragment]
+\set Score.measureLength = #(ly:make-moment 5 4)
+c1 c4
+c1 c4
+c4 c4
+\set Score.measurePosition = #(ly:make-moment 5 8)
+b4 b4 b8
+c4 c1
+@end lilypond
+
+@noindent
+As the example illustrates, @code{ly:make-moment n m} constructs a
+duration of n/m of a whole note.  For example,
+@code{ly:make-moment 1 8} is an eighth note duration and
+@code{ly:make-moment 7 16} is the duration of seven sixteenths
+notes.
+
+@seealso
+
+This manual: @ref{Bar numbers}, @ref{Unmetered music}
+
+Program Reference: @internalsref{Timing_translator},
+@internalsref{Score}
+
+
+
diff --git a/Documentation/user/running.itely b/Documentation/user/running.itely
index 0b992069c1..88cb790510 100644
--- a/Documentation/user/running.itely
+++ b/Documentation/user/running.itely
@@ -130,7 +130,7 @@ Example: @code{lilypond -fpng filename.ly}
 
 @item -d,--define-default=@var{var}=@var{val}
 This sets the internal program option @var{var} to the Scheme value
-@var{val}. If @var{val} is not supplied, then @var{#t} is used. To
+@var{val}.  If @var{val} is not supplied, then @var{#t} is used.  To
 switch off an option, @code{no-} may be prefixed to @var{var}, e.g.
 
 @cindex point and click, command line
@@ -311,7 +311,7 @@ accomplished in a safe way using @command{sudo}.
 
 Setting up a jail is a slightly delicate matter, as we must be sure that
 LilyPond is able to find whatever it needs to compile the source
-@emph{inside the jail}. A typical setup comprises the following items:
+@emph{inside the jail}.  A typical setup comprises the following items:
 
 @table @asis
 @item Setting up a separate filesystem
@@ -383,9 +383,9 @@ This selects the language for the warning messages.
 
 @item LILYPOND_GC_YIELD
 With this variable the memory footprint and performance can be
-adjusted. It is a percentage tunes memory management behavior. With
+adjusted.  It is a percentage tunes memory management behavior.  With
 higher values, the program uses more memory, with smaller values, it
-uses more CPU time. The default value is @code{70}.
+uses more CPU time.  The default value is @code{70}.
 
 @end table
 
@@ -564,7 +564,7 @@ interfaces is quite unlikely; be prepared to tweak scheme code
 manually.
 
 @verbatim
-There are a few things that the convert-ly cannot handle. Here's a list
+There are a few things that the convert-ly cannot handle.  Here's a list
 of limitations that the community has complained about.
 
 This bug report structure has been chosen because convert-ly has a
@@ -573,12 +573,12 @@ Thus this is just a wishlist, placed here for reference.
 
 1.6->2.0:
  Doesn't always convert figured bass correctly, specifically things like {<
->}. Mats' comment on working around this:
+>}.  Mats' comment on working around this:
    To be able to run convert-ly
    on it, I first replaced all occurencies of '{<' to some dummy like '{#'
-   and similarly I replaced '>}' with '&}'. After the conversion, I could
+   and similarly I replaced '>}' with '&}'.  After the conversion, I could
    then change back from '{ #' to '{ <' and from '& }' to '> }'.
- Doesn't convert all text markup correctly. In the old markup syntax,
+ Doesn't convert all text markup correctly.  In the old markup syntax,
  it was possible to group a number of markup commands together within
 parentheses, e.g.
    -#'((bold italic) "string")
@@ -625,7 +625,7 @@ converted.
 @cindex reporting bugs
 
 If you have input that results in a crash or an erroneous output, then
-that is a bug. There is a list of current bugs on our google bug tracker,
+that is a bug.  There is a list of current bugs on our google bug tracker,
 
 @uref{http://code.google.com/p/lilypond/issues/list}
 
diff --git a/Documentation/user/scheme-tutorial.itely b/Documentation/user/scheme-tutorial.itely
index 1655535cb5..eb5ec6b07a 100644
--- a/Documentation/user/scheme-tutorial.itely
+++ b/Documentation/user/scheme-tutorial.itely
@@ -151,14 +151,14 @@ is put into the @code{thickness} variable of a @code{Stem}
 object.  @code{thickness} is measured relative to the thickness of
 staff lines, so these stem lines will be @code{2.6} times the
 width of staff lines.  This makes stems almost twice as thick as their
-normal size. To distinguish between variables defined in input files (like
+normal size.  To distinguish between variables defined in input files (like
 @code{twentyFour} in the example above) and variables of internal
 objects, we will call the latter @q{properties} and the former
-@q{identifiers.}  So, the stem object has a @code{thickness} property,
-while @code{twentyFour} is an identifier.
+@q{variables.}  So, the stem object has a @code{thickness} property,
+while @code{twentyFour} is an variable.
 
-@cindex properties vs. identifiers
-@cindex identifiers vs. properties
+@cindex properties vs. variables
+@cindex variables vs. properties
 
 Two-dimensional offsets (X and Y coordinates) as well as object sizes
 (intervals with a left and right point) are entered as @code{pairs}.  A
diff --git a/Documentation/user/setup.itely b/Documentation/user/setup.itely
index 0283957fa5..63599d440d 100644
--- a/Documentation/user/setup.itely
+++ b/Documentation/user/setup.itely
@@ -36,7 +36,7 @@ operating systems.
 @subsection MacOS X on the command-line
 
 The scripts (such as lilypond-book, convert-ly, abc2ly, and even
-lilypond itself) are included inside MacOS X .app. They can be run from
+lilypond itself) are included inside MacOS X .app.  They can be run from
 the command line by invoking them directly, e.g.
 
 @example
@@ -206,7 +206,7 @@ in the PDF viewer.  This makes it easier to find input that causes
 some error in the sheet music.
 
 When this functionality is active, LilyPond adds hyperlinks to the PDF
-file. These hyperlinks are sent to the web-browser, which opens a
+file.  These hyperlinks are sent to the web-browser, which opens a
 text-editor with the cursor in the right place.
 
 To make this chain work, you should configure your PDF viewer to
@@ -222,7 +222,7 @@ urlCommand     "lilypond-invoke-editor %s"
 @end example
 
 The program @file{lilypond-invoke-editor} is a small helper
-program. It will invoke an editor for the special @code{textedit}
+program.  It will invoke an editor for the special @code{textedit}
 URIs, and run a web browser for others.  It tests the environment
 variable @code{EDITOR} for the following patterns,
 
@@ -245,10 +245,10 @@ this will invoke
 @end example
 @end table
 
-The environment variable @code{LYEDITOR} is used to override this. It
+The environment variable @code{LYEDITOR} is used to override this.  It
 contains the command line to start the editor, where @code{%(file)s},
 @code{%(column)s}, @code{%(line)s} is replaced with the file, column
-and line respectively. The  setting
+and line respectively.  The  setting
 
 @example
 emacsclient --no-wait +%(line)s:%(column)s %(file)s
@@ -261,7 +261,7 @@ invocation.
 
 @cindex file size, output
 
-The point and click links enlarge the output files significantly. For
+The point and click links enlarge the output files significantly.  For
 reducing the size of PDF and PS files, point and click may be switched
 off by issuing
 
diff --git a/Documentation/user/simultaneous.itely b/Documentation/user/simultaneous.itely
new file mode 100644
index 0000000000..cf3beb3b78
--- /dev/null
+++ b/Documentation/user/simultaneous.itely
@@ -0,0 +1,404 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Simultaneous notes
+@section Simultaneous notes
+
+Polyphony in music refers to having more than one voice occurring
+in a piece of music.  Polyphony in LilyPond refers to having more
+than one voice on the same staff.
+
+@menu
+* Single voice::                
+* Multiple voices::             
+@end menu
+
+
+@node Single voice
+@subsection Single voice
+
+@menu
+* Chorded notes::                      
+* Clusters::                    
+@end menu
+
+@node Chorded notes
+@unnumberedsubsubsec Chorded notes
+
+@cindex Chords
+
+A chord is formed by a enclosing a set of pitches between @code{<}
+and @code{>}.  A chord may be followed by a duration, and a set of
+articulations, just like simple notes:
+
+@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
+<c e g>4 <c>8
+@end lilypond
+
+For more information about chords, see @ref{Introducing chord
+names}.
+
+@refbugs
+
+Music expressions like @code{<< @{ g8 e8 @} a4 >>} are not printed
+accurately.  Use @code{<g a>8 <e a>8} instead.
+
+
+
+@node Clusters
+@unnumberedsubsubsec Clusters
+
+@cindex cluster
+
+A cluster indicates a continuous range of pitches to be played.
+They can be denoted as the envelope of a set of notes.  They are
+entered by applying the function @code{makeClusters} to a sequence
+of chords, e.g.,
+
+@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
+\makeClusters { <c e > <b f'> }
+@end lilypond
+
+Ordinary notes and clusters can be put together in the same staff,
+even simultaneously.  In such a case no attempt is made to
+automatically avoid collisions between ordinary notes and
+clusters.
+
+@seealso
+
+Program reference: @internalsref{ClusterSpanner},
+@internalsref{ClusterSpannerBeacon},
+@internalsref{Cluster_spanner_engraver}.
+
+Examples: @lsr{contemporary,cluster@/.ly}.
+
+
+
+@node Multiple voices
+@subsection Multiple voices
+
+@menu
+* Collision resolution::        
+* Automatic part combining::    
+* Writing music in parallel::   
+@end menu
+
+@node Collision resolution
+@unnumberedsubsubsec Collision resolution
+
+Normally, note heads with a different number of dots are not
+merged, but when the object property
+@code{merge-differently-dotted} is set in the
+@internalsref{NoteCollision} object, they are merged:
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+\new Voice << {
+  g8 g8
+  \override Staff.NoteCollision
+    #'merge-differently-dotted = ##t
+  g8 g8
+} \\ { g8.[ f16] g8.[ f16] } >>
+@end lilypond
+
+Similarly, you can merge half note heads with eighth notes, by
+setting @code{merge-differently-headed}:
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\new Voice << {
+  c8 c4.
+  \override Staff.NoteCollision
+    #'merge-differently-headed = ##t
+c8 c4. } \\ { c2 c2 } >>
+@end lilypond
+
+@noindent
+@code{merge-differently-headed} and
+@code{merge-differently-dotted} only apply to opposing stem
+directions (ie. Voice 1 & 2).
+
+LilyPond also vertically shifts rests that are opposite of a stem,
+for example
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\new Voice << c''4 \\ r4 >>
+@end lilypond
+
+If three or more notes line up in the same column,
+@code{merge-differently-headed} cannot successfully complete the
+merge of the two notes that should be merged.  To allow the merge
+to work properly, apply a @code{\shift} to the note that should
+not be merged.  In the first measure of following example,
+@code{merge-differently-headed} does not work (the half-note head
+is solid).  In the second measure, @code{\shiftOn} is applied to
+move the top @code{g} out of the column, and
+@code{merge-differently-headed} works properly.
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+\override Staff.NoteCollision #'merge-differently-headed = ##t
+<<
+  { d=''2 g2 } \\
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+<<
+  { d'=''2 \shiftOn g2 } \\ 
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+@end lilypond
+
+In some instances of complex polyphonic music, you may need
+additional voices to avoid collisions between notes.  Additional
+voices are added by defining an variable, as shown below:
+
+@lilypond[quote,verbatim,ragged-right,relative=2]
+voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
+
+\relative c''' <<
+  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
+  { \voiceThree  b4} \\
+  { \voiceFive d,} \\
+  { \voiceTwo g,}
+>>
+@end lilypond
+
+
+
+@refcommands
+
+@funindex \oneVoice
+@code{\oneVoice},
+@funindex \voiceOne
+@code{\voiceOne},
+@funindex \voiceTwo
+@code{\voiceTwo},
+@funindex \voiceThree
+@code{\voiceThree},
+@funindex \voiceFour
+@code{\voiceFour}.
+
+@funindex \shiftOn
+@code{\shiftOn},
+@funindex \shiftOnn
+@code{\shiftOnn},
+@funindex \shiftOnnn
+@code{\shiftOnnn},
+@funindex \shiftOff
+@code{\shiftOff}: these commands specify the degree to which
+chords of the current voice should be shifted.  The outer voices
+(normally: voice one and two) have @code{\shiftOff}, while the
+inner voices (three and four) have @code{\shiftOn}.
+@code{\shiftOnn} and @code{\shiftOnnn} define further shift
+levels.
+
+When LilyPond cannot cope, the @code{force-hshift} property of the
+@internalsref{NoteColumn} object and pitched rests can be used to
+override typesetting decisions.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative <<
+{
+  <d g>
+  <d g>
+} \\ {
+  <b f'>
+  \once \override NoteColumn #'force-hshift = #1.7
+  <b f'>
+} >>
+@end lilypond
+
+
+@seealso
+
+Program reference: the objects responsible for resolving
+collisions are @internalsref{NoteCollision} and
+@internalsref{RestCollision}.
+
+
+@refbugs
+
+When using @code{merge-differently-headed} with an upstem eighth
+or a shorter note, and a downstem half note, the eighth note gets
+the wrong offset.
+
+There is no support for clusters where the same note occurs with
+different accidentals in the same chord.  In this case, it is
+recommended to use enharmonic transcription, or to use special
+cluster notation (see @ref{Clusters}).
+
+
+@node Automatic part combining
+@unnumberedsubsubsec Automatic part combining
+@cindex automatic part combining
+@cindex part combiner
+
+Automatic part combining is used to merge two parts of music onto
+a staff.  It is aimed at typesetting orchestral scores.  When the
+two parts are identical for a period of time, only one is shown.
+In places where the two parts differ, they are typeset as separate
+voices, and stem directions are set automatically.  Also, solo and
+@emph{a due} parts are identified and can be marked.
+
+The syntax for part combining is
+
+@example
+\partcombine @var{musicexpr1} @var{musicexpr2}
+@end example
+
+
+The following example demonstrates the basic functionality of the
+part combiner: putting parts on one staff, and setting stem
+directions and polyphony
+
+@lilypond[quote,verbatim,ragged-right,fragment]
+\new Staff \partcombine
+  \relative g' { g g a( b) c c r r }
+  \relative g' { g g r4 r e e g g }
+@end lilypond
+
+The first @code{g} appears only once, although it was specified
+twice (once in each part).  Stem, slur, and tie directions are set
+automatically, depending whether there is a solo or unisono.  The
+first part (with context called @code{one}) always gets up stems,
+and @q{Solo}, while the second (called @code{two}) always gets
+down stems and @q{Solo II}.
+
+If you just want the merging parts, and not the textual markings,
+you may set the property @code{printPartCombineTexts} to false
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Staff.printPartCombineTexts = ##f
+  \partcombine
+    \relative g' { g a( b) r }
+    \relative g' { g r4 r f }
+>>
+@end lilypond
+
+To change the text that is printed for solos or merging, you may
+set the @code{soloText}, @code{soloIIText}, and @code{aDueText}
+properties.
+
+@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+\new Staff <<
+  \set Score.soloText = #"ichi"
+  \set Score.soloIIText = #"ni"
+  \set Score.aDueText = #"tachi"
+  \partcombine
+    \relative g' { g4 g a( b) r }
+    \relative g' { g4 g r r f }
+>>
+@end lilypond
+
+Both arguments to @code{\partcombine} will be interpreted as
+@internalsref{Voice} contexts.  If using relative octaves,
+@code{\relative} should be specified for both music expressions,
+i.e.,
+
+@example
+\partcombine
+  \relative @dots{} @var{musicexpr1}
+  \relative @dots{} @var{musicexpr2}
+@end example
+
+@noindent
+A @code{\relative} section that is outside of @code{\partcombine}
+has no effect on the pitches of @var{musicexpr1} and
+@var{musicexpr2}.
+
+@seealso
+
+Program reference: @internalsref{PartCombineMusic}.
+
+@refbugs
+
+When @code{printPartCombineTexts} is set, when the two voices play
+the same notes on and off, the part combiner may typeset @code{a2}
+more than once in a measure.
+
+@code{\partcombine} cannot be inside @code{\times}.
+
+@code{\partcombine} cannot be inside @code{\relative}.
+
+Internally, the @code{\partcombine} interprets both arguments as
+@code{Voice}s named @code{one} and @code{two}, and then decides
+when the parts can be combined.  Consequently, if the arguments
+switch to differently named @internalsref{Voice} contexts, the
+events in those will be ignored.
+
+
+@node Writing music in parallel
+@unnumberedsubsubsec Writing music in parallel
+
+@cindex Writing music in parallel
+@cindex Interleaved music
+
+Music for multiple parts can be interleaved
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+  r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c'' e''] |
+  c'2                               c'2                         |
+  r8 a'16[ d''] f''[ a' d'' f''] r8 a'16[ d''] f''[ a' d'' f''] |
+  c'2                               c'2                         |
+}
+\new StaffGroup <<
+  \new Staff \new Voice \voiceA
+  \new Staff \new Voice \voiceB
+>>
+@end lilypond
+
+This works quite well for piano music
+
+@c  It would be nice if the first bar fit onto one 66-char line.
+@c  Maybe simplify the example?  -gp
+@lilypond[quote,verbatim]
+music = {
+  \key c \major
+  \time 4/4
+  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
+    % Bar 1
+    r8  g'16[ c''] e''[ g' c'' e'']
+      r8 g'16[ c''] e''[ g' c'' e''] |
+    c'2
+      c'2 |
+    r8  a16[ d'] f'[ a d' f']
+      r8  a16[ d'] f'[ a d' f'] |
+    c2
+      c2 |
+
+    % Bar 2
+    a'8 b'      c'' d''    e'' f''    g'' a'' |
+    d'4         d'         d'         d' |
+    c16 d e f   d e f g    e f g a    f g a b |
+    a,4         a,4        a,4        a,4 |
+
+    % Bar 3 ...
+  }
+}
+
+\score {
+  \new PianoStaff <<
+    \music
+    \new Staff <<
+      \voiceA \\
+      \voiceB
+    >>
+    \new Staff {
+      \clef bass
+      <<
+        \voiceC \\
+        \voiceD
+      >>
+    }
+  >>
+}
+@end lilypond
+
+
+
diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely
index 4fb67ec991..e33182425b 100644
--- a/Documentation/user/spacing.itely
+++ b/Documentation/user/spacing.itely
@@ -23,8 +23,8 @@ many pages a piece of music takes.
 Globally speaking, this procedure happens in four steps: first,
 flexible distances (@q{springs}) are chosen, based on durations.  All
 possible line breaking combinations are tried, and a @q{badness} score
-is calculated for each. Then the height of each possible system is
-estimated. Finally, a page breaking and line breaking combination is chosen
+is calculated for each.  Then the height of each possible system is
+estimated.  Finally, a page breaking and line breaking combination is chosen
 so that neither the horizontal nor the vertical spacing is too cramped
 or stretched.
 
@@ -124,58 +124,58 @@ false.
 
 @funindex print-page-number
 @item print-page-number
-If set to false, page numbers will not be printed. Default is true.
+If set to false, page numbers will not be printed.  Default is true.
 
 @funindex paper-width
 @item paper-width
-The width of the page. The default is taken from the current paper size,
+The width of the page.  The default is taken from the current paper size,
 see @ref{Paper size}. 
 
 @funindex paper-height
 @item paper-height
-The height of the page. The default is taken from the current paper size,
+The height of the page.  The default is taken from the current paper size,
 see @ref{Paper size}. 
 
 @funindex top-margin
 @item top-margin
-Margin between header and top of the page. Default is@tie{}5mm.
+Margin between header and top of the page.  Default is@tie{}5mm.
 
 @funindex bottom-margin
 @item bottom-margin
-Margin between footer and bottom of the page. Default is@tie{}6mm.
+Margin between footer and bottom of the page.  Default is@tie{}6mm.
 
 @funindex left-margin
 @item left-margin
 Margin between the left side of the page and the beginning of the
-music. Unset by default, which means that the margins is determined
+music.  Unset by default, which means that the margins is determined
 based on the @code{paper-width} and @code{line-width} to center the
 score on the paper. 
 
 @funindex line-width
 @item line-width
-The length of the systems. Default is @code{paper-width} minus @tie{}20mm.
+The length of the systems.  Default is @code{paper-width} minus @tie{}20mm.
 
 @funindex head-separation
 @item head-separation
-Distance between the top-most music system and the page header. Default
+Distance between the top-most music system and the page header.  Default
 is@tie{}4mm. 
 
 @funindex foot-separation
 @item foot-separation
 Distance between the bottom-most music system and the page
-footer. Default is@tie{}4mm.
+footer.  Default is@tie{}4mm.
 
 @funindex page-top-space
 @item page-top-space
 Distance from the top of the printable area to the center of the first
-staff. This only works for staves which are vertically small. Big staves
+staff.  This only works for staves which are vertically small.  Big staves
 are set with the top of their bounding box aligned to the top of the
-printable area. Default is@tie{}12mm.
+printable area.  Default is@tie{}12mm.
 
 @funindex ragged-bottom
 @item ragged-bottom
 If set to true, systems will not be spread vertically across the page.  This
-does not affect the last page. Default is false.
+does not affect the last page.  Default is false.
 
 This should be set to true for pieces that have only two or three
 systems per page, for example orchestral scores.
@@ -183,7 +183,7 @@ systems per page, for example orchestral scores.
 @funindex ragged-last-bottom
 @item ragged-last-bottom
 If set to false, systems will be spread vertically to fill the last
-page. Default is true.
+page.  Default is true.
 
 Pieces that amply fill two pages or more should have this set to
 true.
@@ -191,13 +191,13 @@ true.
 @funindex system-count
 @item system-count
 This variable, if set, specifies into how many lines a score should be
-broken. Unset by default.
+broken.  Unset by default.
 
 @funindex between-system-space
 @item between-system-space
 This dimensions determines the distance between systems.  It is the
 ideal distance between the center of the bottom staff of one system
-and the center of the top staff of the next system. Default is@tie{}20mm.
+and the center of the top staff of the next system.  Default is@tie{}20mm.
 
 Increasing this will provide a more even appearance of the page at the
 cost of using more vertical space.
@@ -206,7 +206,7 @@ cost of using more vertical space.
 @item between-system-padding
 This dimension is the minimum amount of white space that will always
 be present between the bottom-most symbol of one system, and the
-top-most of the next system. Default is@tie{}4mm.
+top-most of the next system.  Default is@tie{}4mm.
 
 Increasing this will put systems whose bounding boxes almost touch
 farther apart.
@@ -215,30 +215,30 @@ farther apart.
 @item page-breaking-between-system-padding
 This variable tricks the page breaker into thinking that
 @code{between-system-padding} is set to something different than it
-really is. For example, if this variable is set to something substantially
+really is.  For example, if this variable is set to something substantially
 larger than @code{between-system-padding}, then the page-breaker will put
 fewer systems on each page.
 
 @funindex horizontal-shift
 @item horizontal-shift
 All systems (including titles and system separators) are shifted by
-this amount to the right. Page markup, such as headers and footers are
-not affected by this. The purpose of this variable is to make space
-for instrument names at the left. Default is@tie{}0.
+this amount to the right.  Page markup, such as headers and footers are
+not affected by this.  The purpose of this variable is to make space
+for instrument names at the left.  Default is@tie{}0.
 
 @funindex after-title-space
 @item after-title-space
-Amount of space between the title and the first system. Default is@tie{}5mm.
+Amount of space between the title and the first system.  Default is@tie{}5mm.
 
 @funindex before-title-space
 @item before-title-space
 Amount of space between the last system of the previous piece and the
-title of the next. Default is@tie{}10mm.
+title of the next.  Default is@tie{}10mm.
 
 @funindex between-title-space
 @item between-title-space
 Amount of space between consecutive titles (e.g., the title of the
-book and the title of a piece). Default is@tie{}2mm.
+book and the title of a piece).  Default is@tie{}2mm.
 
 @funindex printallheaders
 @item printallheaders
@@ -248,7 +248,7 @@ output.  Normally only the piece and opus \headers are printed.
 @funindex systemSeparatorMarkup
 @item systemSeparatorMarkup
 This contains a markup object, which will be inserted between
-systems.  This is often used for orchestral scores. Unset by default.
+systems.  This is often used for orchestral scores.  Unset by default.
 
 The markup command @code{\slashSeparator} is provided as a sensible
 default,  for example
@@ -268,8 +268,8 @@ default,  for example
 @funindex blank-page-force
 @item blank-page-force
 The penalty for having a blank page in the middle of a
-score. This is not used by @code{ly:optimal-breaking} since it will
-never consider blank pages in the middle of a score. Default value
+score.  This is not used by @code{ly:optimal-breaking} since it will
+never consider blank pages in the middle of a score.  Default value
 is 10.
 
 @funindex blank-last-page-force
@@ -280,7 +280,7 @@ Default value is 0.
 @funindex page-spacing-weight
 @item page-spacing-weight
 The relative importance of page (vertical) spacing and line (horizontal)
-spacing. High values will make page spacing more important. Default
+spacing.  High values will make page spacing more important.  Default
 value is 10.
 
 @funindex auto-first-page-number
@@ -297,17 +297,17 @@ result in the first page number remaining as is or being increased by one.
 @commonprop
 
 The header and footer are created by the functions make-footer and
-make-header, defined in \paper. The default implementations are in
+make-header, defined in \paper.  The default implementations are in
 ly/paper-defaults.ly and ly/titling-init.ly.
 
 The page layout itself is done by two functions in the \paper block,
-page-music-height and page-make-stencil. The former tells the
+page-music-height and page-make-stencil.  The former tells the
 line-breaking algorithm how much space can be spent on a page, the
 latter creates the actual page given the system to put on it.
 
-You can define paper block values in Scheme. In that case mm, in, pt,
+You can define paper block values in Scheme.  In that case mm, in, pt,
 and cm are variables defined in paper-defaults.ly with values in
-millimeters. That is why the value 2 cm must be multiplied in the
+millimeters.  That is why the value 2 cm must be multiplied in the
 example
 
 @example
@@ -535,6 +535,7 @@ be altered for page formatting, set @code{annotate-spacing} in the
 @code{\paper} block, like this
 
 
+@c need to have \book{} otherwise we get  the separate systems. -hwn
 @lilypond[verbatim]
 #(set-default-paper-size "a6" 'landscape)
 
@@ -544,10 +545,9 @@ be altered for page formatting, set @code{annotate-spacing} in the
 }
 @end lilypond
 
-@c need to have \book{} otherwise we get  the separate systems. -hwn
 
+@c  TODO: really bad vagueness due to bug in annotate-spacing.  -gp
 @noindent
-@c  FIXME: really bad vagueness due to bug in annotate-spacing.  -gp
 Some unit dimensions are measured in staff spaces, while others
 are measured in millimeters.
 The pairs
@@ -666,7 +666,7 @@ inserted at top-level, between scores and top-level markups.
 Page breaks are computed by the @code{page-breaking} function.  LilyPond
 provides three algorithms for computing page breaks,
 @code{ly:optimal-breaking}, @code{ly:page-turn-breaking} and
-@code{ly:minimal-breaking}. The default is @code{ly:optimal-breaking},
+@code{ly:minimal-breaking}.  The default is @code{ly:optimal-breaking},
 but the value can be changed in the @code{\paper} block:
 
 @example
@@ -676,7 +676,7 @@ but the value can be changed in the @code{\paper} block:
 @end example
 
 The old page breaking algorithm is called
-@code{optimal-page-breaks}. If you are having trouble with the new page
+@code{optimal-page-breaks}.  If you are having trouble with the new page
 breakers, you can enable the old one as a workaround.
 
 @refcommands
@@ -693,8 +693,8 @@ breakers, you can enable the old one as a workaround.
 @funindex ly:optimal-breaking
 
 The @code{ly:optimal-breaking} function is LilyPond's default method of
-determining page breaks. It attempts to find a page breaking that minimizes
-cramping and stretching, both horizontally and vertically. Unlike
+determining page breaks.  It attempts to find a page breaking that minimizes
+cramping and stretching, both horizontally and vertically.  Unlike
 @code{ly:page-turn-breaking}, it has no concept of page turns.
 
 
@@ -704,26 +704,26 @@ cramping and stretching, both horizontally and vertically. Unlike
 @funindex ly:page-turn-breaking
 
 Often it is necessary to find a page breaking configuration so that there is
-a rest at the end of every second page. This way, the musician can turn the
-page without having to miss notes. The @code{ly:page-turn-breaking} function
+a rest at the end of every second page.  This way, the musician can turn the
+page without having to miss notes.  The @code{ly:page-turn-breaking} function
 attempts to find a page breaking minimizing cramping and stretching, but with
 the additional restriction that it is only allowed to introduce page turns
 in specified places.
 
-There are two steps to using this page breaking function. First, you
+There are two steps to using this page breaking function.  First, you
 must enable it in the @code{\paper} block, as explained in @ref{Page
-breaking}. Then you must tell the function where you would like to allow
+breaking}.  Then you must tell the function where you would like to allow
 page breaks.
 
-There are two ways to achieve the second step. First, you can specify each
+There are two ways to achieve the second step.  First, you can specify each
 potential page turn manually, by inserting @code{\allowPageTurn} into your
 input file at the appropriate places.
 
 If this is too tedious, you can add a @code{Page_turn_engraver} to a Staff or
-Voice context. The @code{Page_turn_engraver} will scan the context for
+Voice context.  The @code{Page_turn_engraver} will scan the context for
 sections without notes (note that it does not scan for rests; it scans for
-the absence of notes. This is so that single-staff polyphony with rests in one
-of the parts does not throw off the @code{Page_turn_engraver}). When it finds
+the absence of notes.  This is so that single-staff polyphony with rests in one
+of the parts does not throw off the @code{Page_turn_engraver}).  When it finds
 a sufficiently long section without notes, the @code{Page_turn_engraver} will
 insert an @code{\allowPageTurn} at the final barline in that section, unless
 there is a @q{special} barline (such as a double bar), in which case the
@@ -733,8 +733,8 @@ the section.
 @funindex minimumPageTurnLength
 The @code{Page_turn_engraver} reads the context property
 @code{minimumPageTurnLength} to determine how long a note-free section must
-be before a page turn is considered. The default value for
-@code{minimumPageTurnLength} is @code{#(ly:make-moment 1 1)}. If you want
+be before a page turn is considered.  The default value for
+@code{minimumPageTurnLength} is @code{#(ly:make-moment 1 1)}.  If you want
 to disable page turns, you can set it to something very large.
 
 @example
@@ -752,10 +752,10 @@ to disable page turns, you can set it to something very large.
 @end example
 
 @funindex minimumRepeatLengthForPageTurn
-The @code{Page_turn_engraver} detects volta repeats. It will only allow a page
+The @code{Page_turn_engraver} detects volta repeats.  It will only allow a page
 turn during the repeat if there is enough time at the beginning and end of the
-repeat to turn the page back. The @code{Page_turn_engraver} can also disable
-page turns if the repeat is very short. If you set the context property
+repeat to turn the page back.  The @code{Page_turn_engraver} can also disable
+page turns if the repeat is very short.  If you set the context property
 @code{minimumRepeatLengthForPageTurn} then the @code{Page_turn_engraver} will
 only allow turns in repeats whose duration is longer than this value.
 
@@ -774,7 +774,7 @@ top-level markups.
 
 @refbugs
 
-There should only be one @code{Page_turn_engraver} in a score. If there is more
+There should only be one @code{Page_turn_engraver} in a score.  If there is more
 than one, they will interfere with each other.
 
 @node Minimal page breaking
@@ -974,17 +974,17 @@ After page breaks are determined, the vertical spacing within each
 system is reevaluated in order to fill the page more evenly; if a page
 has space left over, systems are stretched in order to fill that space.
 The amount of stretching can be configured though the @code{max-stretch}
-property of the @internalsref{VerticalAlignment} grob. To disable this
+property of the @internalsref{VerticalAlignment} grob.  To disable this
 stretching entirely, set @code{max-stretch} to zero.
 
 In some situations, you may want to stretch most of a system while
-leaving some parts fixed. For example, if a piano part occurs in the
+leaving some parts fixed.  For example, if a piano part occurs in the
 middle of an orchestral score, you may want to leave the piano staves
-close to each other while stretching the rest of the score. The
+close to each other while stretching the rest of the score.  The
 @code{keep-fixed-while-stretching} property of
-@internalsref{VerticalAxisGroup} can be used to achieve this. When set
+@internalsref{VerticalAxisGroup} can be used to achieve this.  When set
 to @code{##t}, this property keeps its staff (or line of lyrics) from
-moving relative to the one directly above it. In the example above,
+moving relative to the one directly above it.  In the example above,
 you would override @code{keep-fixed-while-stretching} to @code{##t} in
 the second piano staff:
 
@@ -1029,7 +1029,7 @@ the second piano staff:
 @seealso
 
 Internals: Vertical alignment of staves is handled by the
-@internalsref{VerticalAlignment} object. The context parameters
+@internalsref{VerticalAlignment} object.  The context parameters
 specifying the vertical extent are described in connection with
 the @internalsref{Axis_group_engraver}.
 
@@ -1053,19 +1053,19 @@ Space between systems are controlled by four @code{\paper} variables,
 
 When only a couple of flat systems are placed on a page, the resulting
 vertical spacing may be non-eleguant: one system at the top of the page,
-and the other at the bottom, with a huge gap between them. To avoid this
-situation, the space added between the systems can be limited. This
+and the other at the bottom, with a huge gap between them.  To avoid this
+situation, the space added between the systems can be limited.  This
 feature is activated by setting to @code{#t} the
 @code{page-limit-inter-system-space} variable in the @code{\paper}
-block. The paper variable @code{page-limit-inter-system-space-factor}
+block.  The paper variable @code{page-limit-inter-system-space-factor}
 determines how much the space can be increased: for instance, the value
 @code{1.3} means that the space can be 30% larger than what it would be
 on a ragged-bottom page.
 
 In the following example, if the inter system space were not limited,
-the second system of page 1 would be placed at the page bottom. By
+the second system of page 1 would be placed at the page bottom.  By
 activating the space limitation, the second system is placed closer to
-the first one. By setting @code{page-limit-inter-system-space-factor} to
+the first one.  By setting @code{page-limit-inter-system-space-factor} to
 @code{1}, the spacing would the same as on a ragged-bottom page, like
 the last one.
 
@@ -1168,7 +1168,7 @@ by looking at an example that includes no overrides at all.
 @end lilypond
 
 This score isolates line- and page-breaking information in a dedicated
-voice. This technique of creating a breaks voice will help keep layout
+voice.  This technique of creating a breaks voice will help keep layout
 separate from music entry as our example becomes more complicated.
 See @ref{Using an extra voice for breaks}.
 
@@ -1297,8 +1297,8 @@ passed to these different settings will avoid this.
 @subsection Two-pass vertical spacing
 
 Warning: two-pass vertical spacing is deprecated and will be removed in
-a future version of LilyPond. Systems are now stretched automatically
-in a single pass. See @ref{Vertical spacing inside a system}.
+a future version of LilyPond.  Systems are now stretched automatically
+in a single pass.  See @ref{Vertical spacing inside a system}.
 
 In order to automatically stretch systems so that they should fill the
 space left on a page, a two-pass technique can be used:
@@ -1507,7 +1507,7 @@ c2 c4. c8 c4. c16[ c] c4. c8 c8 c8 c4 c4 c4
 @end lilypond
 
 
-In the introduction (see @ref{Engraving}), it was explained that stem
+In the introduction (see @rlearning{Engraving}), it was explained that stem
 directions influence spacing.  This is controlled with the
 @code{stem-spacing-correction} property in the
 @internalsref{NoteSpacing}, object.  These are generated for every
@@ -1705,8 +1705,8 @@ paragraph, the last line simply takes its natural horizontal length.
 
 LilyPond supports proportional notation, a type of horizontal spacing
 in which each note consumes an amount of horizontal space exactly
-equivalent to its rhythmic duration. This type of proportional spacing
-is comparable to horizontal spacing on top of graph paper. Some late
+equivalent to its rhythmic duration.  This type of proportional spacing
+is comparable to horizontal spacing on top of graph paper.  Some late
 20th- and early 21st-century scores use proportional notation to
 clarify complex rhythmic relationships or to faciliate the placement
 of timelines or other graphics directly in the score.
@@ -1786,8 +1786,8 @@ The @code{proportionalNotationDuration} setting takes a single argument,
 which is the reference duration against which all music will be
 spaced.  The LilyPond Scheme function make-moment takes two arguments
 -- a numerator and denominator which together express some fraction of
-a whole note. The call @code{#(ly:make-moment 1 20)} therefore produces a
-reference duration of a twentieth note. The values
+a whole note.  The call @code{#(ly:make-moment 1 20)} therefore produces a
+reference duration of a twentieth note.  The values
 @code{#(ly:make-moment 1 16)}, @code{#(ly:make-moment 1 8)}, and
 @code{#(ly:make-moment 3 97)} are all possible as well.
 
@@ -1915,16 +1915,23 @@ turn on @code{uniform-stretching}, which is a property of
 >>
 @end lilypond
 
-Our two-staff example now spaces exactly, our rhythmic relationships
-are visually clear, and we can include a measured timeline or graphic
-if we want.
+Our two-staff example now spaces exactly, our rhythmic
+relationships are visually clear, and we can include a measured
+timeline or graphic if we want.
+
+Note that the LilyPond's proportional notation package expects
+that all proportional scores set the SpacingSpanner's
+'uniform-stretching attribute to ##t. Setting
+proportionalNotationDuration without also setting the
+SpacingSpanner's 'uniform-stretching attribute to ##t will, for
+example, cause Skips to consume an incorrect amount of horizontal
+space.
 
-The @code{SpacingSpanner} is an abstract grob that lives in the
-@context{Score} context.  As with our settings of
-@code{proportionalNotationDuration},
-overrides to the @code{SpacingSpanner} can occur in any of three different
-places in our input file -- in the Score @code{\with} block, in a
-Score @code{\context} block, or in note entry directly.
+The SpacingSpanner is an abstract grob that lives in the Score
+context. As with our settings of proportionalNotationDuration,
+overrides to the SpacingSpanner can occur in any of three
+different places in our input file – in the Score \with block, in
+a Score \context block, or in note entry directly.
 
 There is by default only one @code{SpacingSpanner} per @code{Score}.  This
 means that, by default, @code{uniform-stretching} is either turned on for the
@@ -2011,65 +2018,15 @@ property of @code{SpacingSpanner}.  Compare the two scores below:
 }
 @end lilypond
 
-Both scores are proportional, but the spacing in the first score is
-too loose because of the clef change.  The spacing of the second score
-remains strict, however, because @code{strict-note-spacing} is turned
-on.  Turning on @code{strict-note-spacing} causes the width of time
-signatures, key signatures and clefs to play no part in the spacing
-algorithm.  Accidentals are a different matter, however.  By default, all
-accidentals consume a little extra space, as the following pair of
-scores shows.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Staff {
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-}
-
-\new Staff {
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
-  c'16
-  cis'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-}
-@end lilypond
-
-Both scores are proportional but the second score exhibits spacing
-irregularities due to accidentals.  Turning on @code{strict-note-spacing}
-does not work for accidentals.  Instead,
-we override the @code{X-extent} of all accidentals to zero and then move the
-accidentals to the left of the notes they modify.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Staff {
-  \set Score.proportionalNotationDuration = #(ly:make-moment 1 32)
-  \override Accidental #'X-extent = #'(0 . 0)
-  \override Accidental #'extra-offset = #'(-1 . 0)
-  c'16
-  cis'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-  c'16
-}
-@end lilypond
+Both scores are proportional, but the spacing in the first score
+is too loose because of the clef change. The spacing of the second
+score remains strict, however, because strict-note-spacing is
+turned on.  Turning on strict-note-spacing causes the width of
+time signatures, key signatures, clefs and accidentals to play no
+part in the spacing algorithm.
 
-In addition to the settings given here, there are other settings that
-frequently appear in proportional scores.  These include:
+In addition to the settings given here, there are other settings
+that frequently appear in proportional scores. These include:
 
 @itemize
 @item @code{\override SpacingSpanner #'strict-grace-spacing = ##t}
diff --git a/Documentation/user/specialist.itely b/Documentation/user/specialist.itely
new file mode 100644
index 0000000000..4dd74f23e9
--- /dev/null
+++ b/Documentation/user/specialist.itely
@@ -0,0 +1,34 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Specialist notation
+@chapter Specialist notation
+
+This chapter explains how to create musical notation.
+
+@menu
+* Vocal music::
+* Chords::
+* Piano music::
+* Percussion::
+* Guitar::
+* Orchestral strings::
+* Bagpipes::
+* Ancient notation::
+@end menu
+
+@include vocal.itely
+@include chords.itely
+@include piano.itely
+@include percussion.itely
+@include guitar.itely
+@include strings.itely
+@include bagpipes.itely
+@include ancient.itely
+
+
diff --git a/Documentation/user/staff.itely b/Documentation/user/staff.itely
new file mode 100644
index 0000000000..4fec973d42
--- /dev/null
+++ b/Documentation/user/staff.itely
@@ -0,0 +1,695 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Staff notation
+@section Staff notation
+
+Notes, dynamic signs, etc., are grouped with a set of horizontal
+lines, called a staff (plural @q{staves}).  In LilyPond, these
+lines are drawn using a separate layout object called @code{staff
+symbol}.
+
+Two or more staves can be grouped vertically in a
+@internalsref{GrandStaff}, a @internalsref{StaffGroup}, or a
+@internalsref{ChoirStaff}.
+
+
+@menu
+* Displaying staves::           
+* Writing parts::               
+@end menu
+
+
+@node Displaying staves
+@subsection Displaying staves
+
+@menu
+* System start delimiters::     
+* Staff symbol::                
+* Hiding staves::               
+@end menu
+
+@node System start delimiters
+@unnumberedsubsubsec System start delimiters
+
+@cindex start of system
+@cindex Staff, multiple
+@cindex bracket, vertical
+@cindex brace, vertical
+@cindex grand staff
+@cindex staff group
+@cindex staff, choir
+
+Many scores consist of more than one staff.  These staves can be
+grouped in several different ways:
+
+@itemize
+@item
+In a @internalsref{GrandStaff}, the group is started with a brace
+at the left, and bar lines are connected between the staves. 
+
+@lilypond[verbatim,ragged-right,quote]
+\new GrandStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item
+In a @internalsref{StaffGroup}, the barlines will be drawn through
+all the staves, but the group is started with a bracket.
+
+@lilypond[verbatim,ragged-right,quote]
+\new StaffGroup
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item
+In a @internalsref{ChoirStaff}, the group is started with a
+bracket, but bar lines are not connected. 
+
+@lilypond[verbatim,ragged-right,quote]
+\new ChoirStaff
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+
+@item
+If no context is specified, the default properties for the score
+will be used: the group is started with a vertical line, and the
+bar lines are not connected.  
+
+@lilypond[verbatim,ragged-right,quote]
+\relative <<
+  \new Staff { c1 c }
+  \new Staff { c c }
+>>
+@end lilypond
+@end itemize
+
+In addition to these four staff group types, other groupings can
+be produced by changing various properties. E.g., the
+@q{Mensurstriche} layout common in Renaissance music, with
+barlines running between but not through the staves, can be
+produced from a @code{StaffGroup} or @code{GrandStaff} context if
+the barlines are made transparent in the @code{Staff} itself, with
+the command @code{\override Staff.BarLine #'transparent = ##t}
+
+@cindex staff, nested
+
+Staff groups can be nested, using the context
+@code{InnerStaffGroup} or @code{InnerChoirStaff}; see
+@lsr{staff,staff-brackets.ly}
+@c snippet 137
+
+@commonprop
+
+More complex nesting can be accomplished using the property
+@internalsref{systemStartDelimiterHierarchy}: 
+
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup
+\relative <<
+  \set StaffGroup.systemStartDelimiterHierarchy
+    = #'(SystemStartSquare (SystemStartBracket a
+                             (SystemStartSquare b)) d)
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+  \new Staff { c1 }
+>>
+@end lilypond
+
+@seealso
+
+Each staff group context sets the property
+@code{systemStartDelimiter} to one of the values
+@internalsref{SystemStartBar}, @internalsref{SystemStartBrace},
+and @internalsref{SystemStartBracket}.  A fourth delimiter,
+@code{systemStartSquare}, is also available, but must be
+instantiated manually.
+
+@commonprop
+
+To display a bracket even if there is only one staff, see
+@lsr{staff,display-bracket-with-only-one-staff-in-a
+system.ly}
+@c snippet 201
+
+@node Staff symbol
+@unnumberedsubsubsec Staff symbol
+
+@cindex adjusting staff symbol
+
+The layout object which draws the lines of a staff is called
+@code{staff symbol}.  The staff symbol may be tuned in the number,
+thickness and distance of lines, using properties.  This is
+demonstrated in the example files
+@lsr{staff,changing-the-number-of-lines-in-a-staff.ly} and
+@lsr{staff,changing-the-staff-size.ly}.
+
+In addition, staves may be started and stopped at will.  This is
+done with @code{\startStaff} and @code{\stopStaff}.
+
+@lilypond[verbatim,relative=2,fragment]
+b4 b
+\override Staff.StaffSymbol #'line-count = 2
+\stopStaff \startStaff
+b b
+\revert Staff.StaffSymbol #'line-count
+\stopStaff \startStaff
+b b
+@end lilypond
+
+In combination with Frenched staves, this may be used to typeset
+@emph{ossia} sections.  An example is shown here
+
+@cindex staves, Frenched 
+@cindex ossia
+
+@lilypond[verbatim,relative=2,quote]
+<<
+  \new Staff \with
+  {
+    \remove "Time_signature_engraver"
+    fontSize = #-2
+    \override StaffSymbol #'staff-space = #(magstep -2)
+    firstClef = ##f
+  }
+  \relative c'' {
+    \stopStaff
+    \skip 2
+
+    \startStaff
+    \clef treble
+    bes8[^"ossia" g bes g]
+    \stopStaff
+
+    s2
+
+    \startStaff
+    f8 d g4 
+  }
+  \new Staff  \relative
+  {
+    \time 2/4
+    c4 c g' g a a g2
+  }
+
+>>
+@end lilypond
+
+@cindex staff lines, setting number of
+@cindex staff lines, setting thickness of
+@cindex thickness of staff lines, setting
+@cindex number of staff lines, setting
+
+@seealso
+
+Program reference: @internalsref{StaffSymbol},
+@internalsref{DrumStaff}.
+
+Examples: @lsrdir{staff}
+
+
+@node Hiding staves
+@unnumberedsubsubsec Hiding staves
+
+@cindex Frenched scores
+@cindex staves, hiding 
+
+In orchestral scores, staff lines that only have rests are usually
+removed; this saves some space.  This style is called @q{French
+Score}.  For @internalsref{Lyrics}, @internalsref{ChordNames} and
+@internalsref{FiguredBass}, this is switched on by default.  When
+the lines of these contexts turn out empty after the line-breaking
+process, they are removed.
+
+For normal staves, a specialized @internalsref{Staff} context is
+available, which does the same: staves containing nothing (or only
+multi-measure rests) are removed.  The context definition is
+stored in @code{\RemoveEmptyStaffContext} variable.  Observe how
+the second staff in this example disappears in the second line
+
+@lilypond[quote,ragged-right,verbatim]
+\layout {
+  \context { \RemoveEmptyStaffContext }
+}
+
+{
+  \relative c' <<
+    \new Staff { e4 f g a \break c1 }
+    \new Staff { c4 d e f \break R1 }
+  >>
+}
+@end lilypond
+
+The first system shows all staves in full.  If empty staves should
+be removed from the first system too, set @code{remove-first} to
+true in @internalsref{VerticalAxisGroup}.
+
+@example
+\override Score.VerticalAxisGroup #'remove-first = ##t
+@end example
+
+To remove other types of contexts, use
+@code{\AncientRemoveEmptyStaffContext} or
+@code{\RemoveEmptyRhythmicStaffContext}.
+
+Another application of the @code{\RemoveEmptyStaffContext} is to
+make ossia sections, i.e., alternative melodies on a separate
+piece of staff, with help of a Frenched staff.  See @ref{Staff
+symbol}. 
+
+You can make the staff lines invisible by removing the
+@code{Staff_symbol_engraver} from the @code{Staff} context.
+
+
+@lilypond[quote,ragged-right,verbatim]
+\score {
+  \context Staff \relative c'' { c8 c c16 c c c }
+  \layout{
+    \context {
+      \Staff
+      \remove Staff_symbol_engraver
+    }
+  }
+}
+@end lilypond
+
+@node Writing parts
+@subsection Writing parts
+
+@menu
+* Metronome marks::             
+* Instrument names::            
+* Quoting other voices::        
+* Formatting cue notes::        
+@end menu
+
+@node Metronome marks
+@unnumberedsubsubsec Metronome marks
+
+@cindex Tempo
+@cindex beats per minute
+@cindex metronome marking
+
+Metronome settings can be entered as follows
+
+@example
+\tempo @var{duration} = @var{per-minute}
+@end example
+
+In the MIDI output, they are interpreted as a tempo change.  In
+the layout output, a metronome marking is printed
+
+@funindex \tempo
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\tempo 8.=120 c''1
+@end lilypond
+
+
+@commonprop
+
+To change the tempo in the MIDI output without printing anything,
+make the metronome marking invisible @example \once \override
+Score.MetronomeMark #'transparent = ##t @end example
+
+To print other metronome markings, use these markup commands
+@lilypond[quote,ragged-right,verbatim,relative,fragment]
+c4^\markup {
+  (
+  \smaller \general-align #Y #DOWN \note #"16." #1
+  =
+  \smaller \general-align #Y #DOWN \note #"8" #1
+  ) }
+@end lilypond
+
+@noindent
+For more details, see @ref{Text markup}.
+
+
+@seealso
+
+Program reference: @internalsref{MetronomeMark}, @ref{MIDI
+output}.
+
+
+@refbugs
+
+Collisions are not checked.  If you have notes above the top line
+of the staff (or notes with articulations, slurs, text, etc), then
+the metronome marking may be printed on top of musical symbols.
+If this occurs, increase the padding of the metronome mark to
+place it further away from the staff.
+
+@example
+\override Score.MetronomeMark #'padding = #2.5
+@end example
+
+@c perhaps also an example of how to move it horizontally?
+
+@node Instrument names
+@unnumberedsubsubsec Instrument names
+
+In an orchestral score, instrument names are printed at the left
+side of the staves.
+
+This can be achieved by setting
+@internalsref{Staff}.@code{instrumentName} and
+@internalsref{Staff}.@code{shortInstrumentName}, or
+@internalsref{PianoStaff}.@code{instrumentName} and
+@internalsref{PianoStaff}.@code{shortInstrumentName}.  This will
+print text before the start of the staff.  For the first staff,
+@code{instrumentName} is used.  If set, @code{shortInstrumentName}
+is used for the following staves.
+
+@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
+\set Staff.instrumentName = "Ploink "
+\set Staff.shortInstrumentName = "Plk "
+c1
+\break
+c''
+@end lilypond
+
+You can also use markup texts to construct more complicated
+instrument names, for example
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\set Staff.instrumentName = \markup {
+  \column { "Clarinetti"
+            \line { "in B" \smaller \flat } } }
+c''1
+@end lilypond
+
+If you wish to center the instrument names, you must center all of
+them individually:
+
+@lilypond[quote,verbatim,ragged-right]
+{ <<
+\new Staff {
+  \set Staff.instrumentName = \markup {
+    \center-align { "Clarinetti"
+      \line { "in B" \smaller \flat } } }
+  c''1
+}
+\new Staff {
+  \set Staff.instrumentName =
+       \markup{ \center-align { Vibraphone }}
+  c''1
+}
+>>
+}
+@end lilypond
+
+For longer instrument names, it may be useful to increase the
+@code{indent} setting in the @code{\layout} block.
+
+To center instrument names while leaving extra space to the right,
+
+@lilypond[quote,verbatim,ragged-right]
+\new StaffGroup \relative
+<<
+  \new Staff {
+    \set Staff.instrumentName =
+        \markup { \hcenter-in #10 "blabla" }
+    c1 c1
+  }
+  \new Staff {
+    \set Staff.instrumentName =
+         \markup { \hcenter-in #10 "blo" }
+    c1 c1
+  }
+>>
+@end lilypond
+
+To add instrument names to other contexts (such as
+@code{GrandStaff}, @code{ChoirStaff}, or @code{StaffGroup}), the
+engraver must be added to that context.
+
+@example
+\layout@{
+  \context @{\GrandStaff \consists "Instrument_name_engraver"@}
+@}
+@end example
+
+@noindent
+More information about adding and removing engravers can be found
+in @ref{Modifying context plug-ins}.
+
+Instrument names may be changed in the middle of a piece,
+
+@lilypond[quote,fragment,verbatim,ragged-right]
+\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
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{InstrumentName}.
+
+
+@node Quoting other voices
+@unnumberedsubsubsec Quoting other voices
+
+@cindex cues
+
+With quotations, fragments of other parts can be inserted into a
+part directly.  Before a part can be quoted, it must be marked
+especially as quotable.  This is done with the @code{\addQuote}
+command.
+
+@example
+\addQuote @var{name} @var{music}
+@end example
+
+
+@noindent
+Here, @var{name} is an identifying string.  The @var{music} is any
+kind of music.  Here is an example of @code{\addQuote}
+
+@example
+\addQuote clarinet \relative c' @{
+  f4 fis g gis
+@}
+@end example
+
+This command must be entered at toplevel, i.e., outside any music
+blocks.  Typically, one would use an already defined music event
+as the @var{music}:
+
+@example
+clarinet = \relative c' @{
+  f4 fis g gis
+@}
+\addQuote clarinet @{ \clarinet @}
+@end example
+
+
+After calling @code{\addQuote}, the quotation may then be done
+with @code{\quoteDuring} or @code{\cueDuring},
+
+@example
+\quoteDuring #@var{name} @var{music}
+@end example
+
+During a part, a piece of music can be quoted with the
+@code{\quoteDuring} command.
+
+@example
+\quoteDuring #"clarinet" @{ s2. @}
+@end example
+
+This would cite three quarter notes (the duration of @code{s2.})
+of the previously added @code{clarinet} voice.
+
+More precisely, it takes the current time-step of the part being
+printed, and extracts the notes at the corresponding point of the
+@code{\addQuote}d voice.  Therefore, the argument to
+@code{\addQuote} should be the entire part of the voice to be
+quoted, including any rests at the beginning.
+
+It is possible to use another music expression instead of
+@code{s}, thus creating a polyphonic section, but this may not
+always give the desired result.
+
+Quotations take into account the transposition of both source and
+target instruments, if they are specified using the
+@code{\transposition} command.
+
+@lilypond[quote,ragged-right,verbatim]
+\addQuote clarinet \relative c' {
+  \transposition bes
+  f4 fis g gis
+}
+
+{
+  e'8 f'8 \quoteDuring #"clarinet" { s2 }
+}
+@end lilypond
+
+The type of events that are present in the quoted music can be
+trimmed with the @code{quotedEventTypes} property.  The default
+value is @code{(note-event rest-event)}, which means that only
+notes and rests of the quoted voice end up in the
+@code{\quoteDuring}.  Setting
+
+@example
+\set Staff.quotedEventTypes =
+       #'(note-event articulation-event dynamic-event)
+@end example
+
+@noindent
+will quote notes (but no rests), together with scripts and
+dynamics.
+
+@refbugs
+
+Only the contents of the first @internalsref{Voice} occurring in
+an @code{\addQuote} command will be considered for quotation, so
+@var{music} can not contain @code{\new} and @code{\context Voice}
+statements that would switch to a different Voice.
+
+Quoting grace notes is broken and can even cause LilyPond to
+crash.
+
+Quoting nested triplets may result in poor notation.
+
+In earlier versions of LilyPond (pre 2.11), @code{addQuote} was
+written entirely in lower-case letters: @code{\addquote}.
+
+@seealso
+
+In this manual: @ref{Instrument transpositions}.
+
+Examples: @lsr{parts,quote.ly},
+@lsr{parts,quote-transportation.ly}
+
+Program reference: @internalsref{QuoteMusic}.
+
+
+@node Formatting cue notes
+@unnumberedsubsubsec Formatting cue notes
+
+@cindex cues, formatting
+
+The previous section deals with inserting notes from another
+voice.  There is a more advanced music function called
+@code{\cueDuring}, which makes formatting cue notes easier.
+
+The syntax is
+
+@example
+  \cueDuring #@var{name} #@var{updown} @var{music}
+@end example
+
+This will insert notes from the part @var{name} into a
+@internalsref{Voice} called @code{cue}.  This happens
+simultaneously with @var{music}, which usually is a rest.  When
+the cue notes start, the staff in effect becomes polyphonic for a
+moment.  The argument @var{updown} determines whether the cue
+notes should be notated as a first or second voice.
+
+
+@lilypond[verbatim,ragged-right]
+smaller = {
+  \set fontSize = #-2
+  \override Stem #'length-fraction = #0.8
+  \override Beam #'thickness = #0.384
+  \override Beam #'length-fraction = #0.8
+}
+
+\addQuote clarinet \relative {
+  R1*20
+  r2 r8 c' f f
+}
+
+\new Staff \relative  <<
+
+  % setup a context for cue notes.
+  \new Voice = "cue" { \smaller \skip 1*21 }
+
+  \set Score.skipBars = ##t
+
+  \new Voice {
+    R1*20
+    \cueDuring #"clarinet" #UP {
+      R1
+    }
+    g4 g2.
+  }
+>>
+@end lilypond
+
+
+Here are a couple of hints for successful cue notes
+
+@itemize
+@item
+Cue notes have smaller font sizes.
+
+@item
+the cued part is marked with the instrument playing the cue.
+
+@item
+when the original part takes over again, this should be marked
+with the name of the original instrument.
+
+Any other changes introduced by the cued part should also be
+undone.  For example, if the cued instrument plays in a different
+clef, the original clef should be stated once again.
+
+@end itemize
+
+The macro @code{\transposedCueDuring} is useful to add cues to
+instruments which use a completely different octave range (for
+example, having a cue of a piccolo flute within a contra bassoon
+part).
+
+@lilypond[verbatim,ragged-right,quote]
+picc = \relative c''' {
+  \clef "treble^8"
+  R1 |
+  c8 c c e g2 |
+  a4 g g2 |
+}
+\addQuote "picc" { \picc }
+
+cbsn = \relative c, {
+  \clef "bass_8"
+  c4 r g r
+  \transposedCueDuring #"picc" #UP c,, { R1 } |
+  c4 r g r |
+}
+
+<<
+  \context Staff = "picc" \picc
+  \context Staff = "cbsn" \cbsn
+>>
+@end lilypond
+
+
+
+
+
+
diff --git a/Documentation/user/strings.itely b/Documentation/user/strings.itely
new file mode 100644
index 0000000000..83a0b57e8d
--- /dev/null
+++ b/Documentation/user/strings.itely
@@ -0,0 +1,41 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Orchestral strings
+@section Orchestral strings
+
+This section includes extra information for writing for orchestral
+strings.
+
+@menu
+* Orchestral strings sections::  
+@end menu
+
+
+
+@node Orchestral strings sections
+@subsection Orchestral strings sections
+
+@menu
+* Artificial harmonics (strings)::  
+@end menu
+
+@node Artificial harmonics (strings)
+@unnumberedsubsubsec Artificial harmonics (strings)
+
+@cindex artificial harmonics
+
+Artificial harmonics are notated with a different notehead style.  They
+are entered by marking the harmonic pitch with @code{\harmonic}.
+
+@lilypond[ragged-right,verbatim,quote,fragment,relative=1]
+<c g'\harmonic>4
+@end lilypond
+
+
+
diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely
new file mode 100644
index 0000000000..19d550503b
--- /dev/null
+++ b/Documentation/user/text.itely
@@ -0,0 +1,909 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Text
+@section Text
+
+This section explains how to include text (with various
+formatting) in your scores.
+
+@cindex Text, other languages
+To write accented and special text (such as characters from other
+languages), simply insert the characters directly into the
+lilypond file.  The file must be saved as UTF-8.  For more
+information, see @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::                 
+* Special text concerns::       
+@end menu
+
+
+@node Writing text
+@subsection Writing text
+
+@menu
+* Overview of text entry::      
+* Text scripts::                
+* Text spanners::               
+* Text marks::                  
+@end menu
+
+@node Overview of text entry
+@unnumberedsubsubsec Overview of text entry
+
+There are four ways to add text to scores:
+
+@itemize
+@item
+@ref{Text scripts}: blah blah
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+c4^"text" c c c
+@end lilypond
+
+@item
+@ref{Text spanners}: blah blah
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+c1
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \upright "rall" } 
+c2\startTextSpan b c\stopTextSpan a
+@end lilypond
+
+@item
+@ref{Text marks}: blah blah
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+c4\mark "foo" c c c
+@end lilypond
+
+@item
+@ref{Vocal music}: blah blah, not in this section.
+
+@lilypond[verbatim,quote,ragged-right]
+<<
+  \relative c'' { c4 c c c }
+  \addlyrics { one two three four }
+>>
+@end lilypond
+
+@end itemize
+
+
+
+@node Text scripts
+@unnumberedsubsubsec Text scripts
+
+@cindex Text scripts
+@cindex text items, non-empty
+@cindex non-empty texts
+
+It is possible to place arbitrary strings of text or @ref{Text
+markup}, above or below notes by using a string @code{c^"text"}.
+By default, these indications do not influence the note spacing,
+but by using the command @code{\fatText}, the widths will be taken
+into account
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+c4^"longtext" \fatText c4_"longlongtext" c4
+@end lilypond
+
+@noindent
+To prevent text from influencing spacing, use @code{\emptyText}.
+
+More complex formatting may also be added to a note by using the
+markup command,
+
+@lilypond[fragment,ragged-right,verbatim,quote]
+c'4^\markup { bla \bold bla }
+@end lilypond
+
+The @code{\markup} is described in more detail in @ref{Text
+markup}.
+
+
+@refcommands
+
+@funindex \fatText
+@code{\fatText},
+@funindex \emptyText
+@code{\emptyText}.
+
+
+@commonprop
+
+Checking to make sure that text scripts and lyrics are within the
+margins is a relatively large computational task.  To speed up
+processing, lilypond does not perform such calculations by
+default; to enable it, use
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+
+@seealso
+
+In this manual: @ref{Text markup}.
+
+Program reference: @internalsref{TextScript}.
+
+
+@node Text spanners
+@unnumberedsubsubsec Text spanners
+
+@cindex Text spanners
+
+Some performance indications, e.g., @i{rallentando} or
+@i{accelerando}, are written as text and are extended over many
+measures with dotted lines.  Such texts are created using text
+spanners; attach @code{\startTextSpan} and @code{\stopTextSpan} to
+the first and last notes of the spanner.
+
+The string to be printed, as well as the style, is set through
+object properties
+
+@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+c1
+\textSpannerDown
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \upright "rall" } 
+c2\startTextSpan b c\stopTextSpan a
+\break
+\textSpannerUp
+\override TextSpanner #'bound-details #'left #'text =
+  \markup { \italic "rit" } 
+c2\startTextSpan b c\stopTextSpan a
+@end lilypond
+
+@refcommands
+
+@funindex textSpannerUp
+@code{\textSpannerUp},
+@funindex textSpannerDown
+@code{\textSpannerDown},
+@funindex textSpannerNeutral
+@code{\textSpannerNeutral}.
+
+
+@commonprop
+
+To print a solid line, use
+
+@example
+\override TextSpanner #'dash-fraction = #'()
+@end example
+
+
+@seealso
+
+Program reference: @internalsref{TextSpanner}.
+
+
+@node Text marks
+@unnumberedsubsubsec Text marks
+
+@cindex coda on bar line
+@cindex segno on bar line
+@cindex fermata on bar line
+@cindex bar lines, symbols on
+@funindex \mark
+
+The @code{\mark} command is primarily used for @ref{Rehearsal
+marks}, but it can also be used to put signs like coda, segno, and
+fermata on a bar line.  Use @code{\markup} to access the
+appropriate symbol (symbols are listed in @ref{The Feta font}).
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+c1 \mark \markup { \musicglyph #"scripts.ufermata" }
+c1
+@end lilypond
+
+@noindent
+@code{\mark} is only typeset above the top stave of the score.  If
+you specify the @code{\mark} command at a bar line, the resulting
+mark is placed above the bar line.  If you specify it in the
+middle of a bar, the resulting mark is positioned between notes.
+If it is specified before the beginning of a score line, it is
+placed before the first note of the line.  Finally, if the mark
+occurs at a line break, the mark will be printed at the beginning
+of the next line.
+
+@c  IMO this is a bug; hopefully it'll be fixed soon, so I can
+@c  delete this sentence.   -gp
+If there is no next line, then the mark will not be printed at
+all.
+
+
+@commonprop
+
+To print the mark at the end of the current line, use
+
+@example
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+@end example
+
+@code{\mark} is often useful for adding text to the end of bar.
+In such cases, changing the @code{#'self-alignment} is very useful
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\override Score.RehearsalMark
+  #'break-visibility = #begin-of-line-invisible
+c1 c c c4 c c c
+\once \override Score.RehearsalMark #'self-alignment-X = #right
+\mark "D.S. al Fine "
+@end lilypond
+
+Text marks may be aligned with notation objects other than bar
+lines,
+
+@lilypond[fragment,quote,ragged-right,verbatim,relative=2]
+\relative {
+  c1
+  \key cis \major
+  \clef alto
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  \mark "on key"
+  cis
+  \key ces \major
+  \override Score.RehearsalMark #'break-align-symbols = #'(clef)
+  \clef treble
+  \mark "on clef"
+  ces
+  \override Score.RehearsalMark #'break-align-symbols = #'(time-signature)
+  \key d \minor
+  \clef tenor
+  \time 3/4
+  \mark "on time"
+  c
+}
+@end lilypond
+
+Possible symbols for the @code{break-align-symbols} list are
+@code{ambitus}, @code{breathing-sign}, @code{clef}, @code{custos},
+@code{staff-bar}, @code{left-edge}, @code{key-cancellation},
+@code{key-signature}, and @code{time-signature}.
+
+The text marks will, by default, be aligned with the middle of the
+notation object, but this can be changed by overriding the
+@code{break-align-anchor-alignment} and @code{break-align-anchor}
+properties for the appropriate grob.
+
+@lilypond[fragment,quote,ragged-right,verbatim]
+{
+  \override Score.RehearsalMark #'break-align-symbols = #'(key-signature)
+  c1
+  \key cis \major
+
+  % the RehearsalMark will be aligned with the left edge of the KeySignature
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #LEFT
+  \mark \default
+  cis1
+  \key ces \major
+
+  % the RehearsalMark will be aligned with the right edge of the KeySignature
+  \once \override Staff.KeySignature #'break-align-anchor-alignment = #RIGHT
+  \mark \default
+  ces1
+  \key cis \major
+
+  % the RehearsalMark will be aligned with the left edge of the KeySignature
+  % and then shifted right by 2 units.
+  \once \override Staff.KeySignature #'break-align-anchor = #2
+  \mark \default
+  ces1
+}
+@end lilypond
+
+Although text marks are normally only printed above the topmost
+staff, you may alter this to print them on every staff,
+
+@lilypond[quote,ragged-right,verbatim,relative=2]
+{
+  \new Score \with {
+    \remove "Mark_engraver"
+  }
+  <<
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c''1 \mark "foo" c'' }
+    \new Staff \with {
+      \consists "Mark_engraver"
+    }
+    { c'1 \mark "foo" c' }
+  >>
+}
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{RehearsalMark}.
+
+
+
+@node Text markup
+@subsection Text markup
+
+@menu
+* Text markup introduction::    
+* Nested scores::               
+* Page wrapping text::          
+* Font selection::              
+@end menu
+
+@node Text markup introduction
+@unnumberedsubsubsec Text markup introduction
+
+@cindex markup
+@cindex text markup
+@cindex markup text
+@cindex typeset text
+
+Use @code{\markup} to typeset text.  Commands are entered with the
+backslash @code{\}.  To enter @code{\} and @code{#}, use double
+quotation marks.
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { hello }
+c1_\markup { hi there }
+c1^\markup { hi \bold there, is \italic {anyone home?} }
+c1_\markup { "\special {weird} #characters" }
+@end lilypond
+
+@noindent
+See @ref{Overview of text markup commands}, for a list of all
+commands.
+
+@code{\markup} is primarily used for @internalsref{TextScript}s,
+but it can also be used anywhere text is called in lilypond
+
+@lilypond[quote,verbatim]
+\header{ title = \markup{ \bold { foo \italic { bar! } } } }
+\score{
+  \relative c'' {
+    \override Score.RehearsalMark
+      #'break-visibility = #begin-of-line-invisible
+    \override Score.RehearsalMark #'self-alignment-X = #right
+
+    \set Staff.instrumentName = \markup{ \column{ Alto solo } }
+    c2^\markup{ don't be \flat }
+    \override TextSpanner #'bound-details #'left #'text = \markup{\italic rit }
+    b2\startTextSpan
+    a2\mark \markup{ \large \bold Fine }
+    r2\stopTextSpan
+    \bar "||"
+  }
+  \addlyrics { bar, foo \markup{ \italic bar! } }
+}
+@end lilypond
+
+A @code{\markup} command can also be placed on its own, away from
+any @code{\score} block, see @ref{Multiple scores in a book}.
+
+@lilypond[quote,ragged-right,verbatim]
+\markup{ Here is some text. }
+@end lilypond
+
+@cindex font switching
+
+The markup in the example demonstrates font switching commands.
+The command @code{\bold} and @code{\italic} apply to the first
+following word only; to apply a command to more than one word,
+enclose the words with braces,
+
+@example
+\markup @{ \bold @{ hi there @} @}
+@end example
+
+@noindent
+For clarity, you can also do this for single arguments, e.g.,
+
+@example
+\markup @{ is \italic @{ anyone @} home @}
+@end example
+
+In markup mode you can compose expressions, similar to
+mathematical expressions, XML documents, and music expressions.
+You can stack expressions grouped vertically with the command
+@code{\column}.  Similarly, @code{\center-align} aligns texts by
+their center lines:
+
+@lilypond[quote,verbatim,fragment,relative=1]
+c1^\markup { \column { a bbbb \line { c d } } }
+c1^\markup { \center-align { a bbbb c } }
+c1^\markup { \line { a b c } }
+@end lilypond
+
+Lists with no previous command are not kept distinct.  The
+expression
+
+@example
+\center-align @{ @{ a b @} @{ c d @} @}
+@end example
+
+@noindent
+
+is equivalent to
+
+@example
+\center-align @{ a b c d @}
+@end example
+
+@noindent
+
+To keep lists of words distinct, please use quotes @code{"} or
+the @code{\line} command
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c4^\markup{ \center-align { on three lines } }
+c4^\markup{ \center-align { "all one line" } }
+c4^\markup{ \center-align { { on three lines } } }
+c4^\markup{ \center-align { \line { on one line } } }
+@end lilypond
+
+Markups can be stored in variables and these variables may be
+attached to notes, like
+
+@example
+allegro = \markup @{ \bold \large @{ Allegro @} @}
+ @{ a^\allegro b c d @}
+@end example
+
+Some objects have alignment procedures of their own, which cancel
+out any effects of alignments applied to their markup arguments as
+a whole.  For example, the @internalsref{RehearsalMark} is
+horizontally centered, so using @code{\mark \markup @{ \left-align
+.. @}} has no effect.
+
+In addition, vertical placement is performed after creating the
+text markup object.  If you wish to move an entire piece of
+markup, you need to use the #'padding property or create an
+@q{anchor} point inside the markup (generally with @code{\hspace
+#0}).
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c'4^\markup{ \raise #5 "not raised" }
+\once \override TextScript #'padding = #3
+c'4^\markup{ raised }
+c'4^\markup{ \hspace #0 \raise #1.5 raised }
+@end lilypond
+
+Some situations (such as dynamic marks) have preset font-related
+properties.  If you are creating text in such situations, it is
+advisable to cancel those properties with @code{normal-text}.  See
+@ref{Overview of text markup commands}, for more details.
+
+
+@seealso
+
+This manual: @ref{Overview of text markup commands}.
+
+Program reference: @internalsref{TextScript}.
+
+Init files: @file{scm/@/new@/-markup@/.scm}.
+
+
+@refbugs
+
+Kerning or generation of ligatures is only done when the @TeX{}
+backend is used.  In this case, LilyPond does not account for them
+so texts will be spaced slightly too wide.
+
+Syntax errors for markup mode are confusing.
+
+
+@node Nested scores
+@unnumberedsubsubsec Nested scores
+
+It is possible to nest music inside markups, by adding a
+@code{\score} block to a markup expression.  Such a score must
+contain a @code{\layout} block.
+
+@lilypond[quote,verbatim,ragged-right]
+\relative {
+  c4 d^\markup {
+    \score {
+      \relative { c4 d e f }
+      \layout { }
+    }
+  }
+  e f
+}
+@end lilypond
+
+@node Page wrapping text
+@unnumberedsubsubsec Page wrapping text
+
+Whereas @code{\markup} is used to enter a non-breakable block of
+text, @code{\markuplines} can be used at top-level to enter lines
+of text that can spread over multiple pages:
+
+@verbatim
+\markuplines {
+  \justified-lines {
+    A very long text of justified lines.
+    ...
+  }
+  \justified-lines {
+    An other very long paragraph.
+    ...
+  }
+  ...
+}
+@end verbatim
+
+@code{\markuplines} accepts a list of markup, that is either the
+result of a markup list command, or a list of markups or of markup
+lists.  The built-in markup list commands are described in
+@ref{Overview of text markup list commands}.
+
+@seealso
+
+This manual: @ref{Overview of text markup list commands}, @ref{New
+markup list command definition}.
+
+@refcommands
+
+@funindex \markuplines
+@code{\markuplines}
+
+@node Font selection
+@unnumberedsubsubsec Font selection
+
+@cindex font selection
+@cindex font magnification
+@funindex font-interface
+
+By setting the object properties described below, you can select a
+font from the preconfigured font families.  LilyPond has default
+support for the feta music fonts.  Text fonts are selected through
+Pango/FontConfig.  The serif font defaults to New Century
+Schoolbook, the sans and typewriter to whatever the Pango
+installation defaults to.
+
+
+@itemize
+@item @code{font-encoding}
+is a symbol that sets layout of the glyphs.  This should only be
+set to select different types of non-text fonts, e.g.
+
+@code{fetaBraces} for piano staff braces, @code{fetaMusic} the
+standard music font, including ancient glyphs, @code{fetaDynamic}
+for dynamic signs and @code{fetaNumber} for the number font.
+
+@item @code{font-family}
+is a symbol indicating the general class of the typeface.
+Supported are @code{roman} (Computer Modern), @code{sans}, and
+@code{typewriter}.
+
+@item @code{font-shape}
+is a symbol indicating the shape of the font.  There are typically
+several font shapes available for each font family.  Choices are
+@code{italic}, @code{caps}, and @code{upright}.
+
+@item @code{font-series}
+is a symbol indicating the series of the font.  There are
+typically several font series for each font family and shape.
+Choices are @code{medium} and @code{bold}.
+
+@end itemize
+
+Fonts selected in the way sketched above come from a predefined
+style sheet.  If you want to use a font from outside the style
+sheet, then set the @code{font-name} property,
+
+@lilypond[fragment,verbatim]
+{
+  \override Staff.TimeSignature #'font-name = #"Charter"
+  \override Staff.TimeSignature #'font-size = #2
+  \time 3/4
+  c'1_\markup {
+    \override #'(font-name . "Vera Bold")
+      { This text is in Vera Bold }
+  }
+}
+@end lilypond
+
+@noindent
+Any font can be used, as long as it is available to
+Pango/FontConfig.  To get a full list of all available fonts, run
+the command
+
+@example
+lilypond -dshow-available-fonts blabla
+@end example
+
+(the last argument of the command can be anything, but has to be
+present).
+
+
+The size of the font may be set with the @code{font-size}
+property.  The resulting size is taken relative to the
+@code{text-font-size} as defined in the @code{\paper} block.
+
+@cindex font size
+@cindex font magnification
+
+
+It is also possible to change the default font family for the
+entire document.  This is done by calling the
+@code{make-pango-font-tree} from within the @code{\paper} block.
+The function takes names for the font families to use for roman,
+sans serif and monospaced text.  For example,
+
+@cindex font families, setting
+@cindex Pango
+
+
+@lilypond[verbatim]
+\paper  {
+  myStaffSize = #20
+
+  #(define fonts
+    (make-pango-font-tree "Times New Roman"
+                          "Nimbus Sans"
+                          "Luxi Mono"
+                           (/ myStaffSize 20)))
+}
+
+{
+  c'^\markup { roman: foo \sans bla \typewriter bar }
+}
+@end lilypond
+
+@c we don't do Helvetica / Courier, since GS incorrectly loads
+@c Apple TTF fonts
+
+
+
+@seealso
+
+Examples: @lsr{text,font@/-family@/-override.ly}.
+
+
+@node Special text concerns
+@subsection Special text concerns
+
+
+
+@menu
+* New dynamic marks::           
+* Text and line spanners::      
+@end menu
+
+@node New dynamic marks
+@unnumberedsubsubsec New dynamic marks
+
+It is possible to print new dynamic marks or text that should be
+aligned with dynamics.  Use @code{make-dynamic-script} to create
+these marks.  Note that the dynamic font only contains the
+characters @code{f,m,p,r,s} and @code{z}.
+
+Some situations (such as dynamic marks) have preset font-related
+properties.  If you are creating text in such situations, it is
+advisable to cancel those properties with @code{normal-text}.  See
+@ref{Overview of text markup commands}, for more details.
+
+@cindex make-dynamic-script
+
+@lilypond[quote,verbatim,ragged-right]
+sfzp = #(make-dynamic-script "sfzp")
+\relative c' {
+  c4 c c\sfzp c
+}
+@end lilypond
+
+@cindex Dynamics, editorial
+@cindex Dynamics, parenthesis
+
+It is also possible to print dynamics in round parenthesis or
+square brackets.  These are often used for adding editorial
+dynamics.
+
+@lilypond[quote,verbatim,ragged-right]
+rndf = \markup{ \center-align {\line { \bold{\italic (}
+  \dynamic f \bold{\italic )} }} }
+boxf = \markup{ \bracket { \dynamic f } }
+{ c'1_\rndf c'1_\boxf }
+@end lilypond
+
+
+@node Text and line spanners
+@unnumberedsubsubsec Text and line spanners
+
+Some performance indications, e.g., @i{rallentando} and
+@i{accelerando} and @i{trills} are written as text and are
+extended over many measures with lines, sometimes dotted or wavy.
+
+These all use the same routines as the glissando for drawing the
+texts and the lines, and tuning their behavior is therefore also
+done in the same way.  It is done with a spanner, and the routine
+responsible for drawing the spanners is
+@code{ly:line-interface::print}.  This routine determines the
+exact location of the two @i{span points} and draws a line in
+between, in the style requested.
+
+Here is an example of the different line styles available, and how
+to tune them.
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+d2 \glissando d'2
+\once \override Glissando #'dash-fraction = #0.5
+d,2 \glissando d'2
+\override Glissando #'style = #'dotted-line
+d,2 \glissando d'2
+\override Glissando #'style = #'zigzag
+d,2 \glissando d'2
+\override Glissando #'style = #'trill
+d,2 \glissando d'2
+@end lilypond
+
+The information that determines the end-points is computed
+on-the-fly for every graphic object, but it is possible to
+override these. 
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+e2 \glissando f
+\once \override Glissando #'bound-details #'right #'Y = #-2
+e2 \glissando f
+@end lilypond
+
+The @code{Glissando} object, like any other using the
+@code{ly:line-interface::print} routine, carries a nested
+association list.  In the above statement, the value for @code{Y}
+is set to @code{-2} for the association list corresponding to the
+right end point.  Of course, it is also possible to adjust the
+left side with @code{left} instead of @code{right}.
+
+If @code{Y} is not set, the value is computed from the vertical
+position of right attachment point of the spanner. 
+
+In case of a line break, the values for the span-points are
+extended with contents of the @code{left-broken} and
+@code{right-broken} sublists, for example
+
+@lilypond[relative=2,ragged-right,verbatim,fragment]
+\override Glissando #'breakable = ##T 
+\override Glissando #'bound-details #'right-broken #'Y = #-3
+c1 \glissando \break
+f1
+@end lilypond
+
+The following properties can be used for the
+
+@table @code
+@item Y
+This sets the Y-coordinate of the end point, in staff space.  By
+default, it is the center of the bound object, so for a glissando
+it points to the vertical center of the note head.
+
+For horizontal spanners, such as text spanner and trill spanners,
+it is hardcoded to 0.
+
+@item attach-dir
+This determines where the line starts and ends in X-direction,
+relative to the bound object.  So, a value of @code{-1} (or
+@code{LEFT}) makes the line start/end at the left side of the note
+head it is attached to.
+
+@item X
+This is the absolute coordinate of the end point.  It is usually
+computed on the fly, and there is little use in overriding it. 
+
+@item stencil
+Line spanners may have symbols at the beginning or end, which is
+contained in this sub-property.  This is for internal use, it is
+recommended to use @code{text}.
+
+@item text
+This is a markup that is evaluated to yield stencil.  It is used
+to put @i{cresc.} and @i{tr} on horizontal spanners.
+
+@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
+\override TextSpanner #'bound-details #'left #'text
+   = \markup { \small \bold Slower }
+c2\startTextSpan b c a\stopTextSpan
+@end lilypond
+
+@item stencil-align-dir-y
+@item stencil-offset
+Without setting this, the stencil is simply put there at the
+end-point, as defined by the @code{X} and @code{Y} sub properties.
+Setting either @code{stencil-align-dir-y} or @code{stencil-offset}
+will move the symbol at the edge relative to the end point of the
+line
+
+@lilypond[relative=1,fragment,verbatim]
+\override TextSpanner #'bound-details
+  #'left #'stencil-align-dir-y = #DOWN
+\override TextSpanner #'bound-details
+  #'right #'stencil-align-dir-y = #UP
+
+\override TextSpanner #'bound-details
+  #'left #'text = #"gggg"
+\override TextSpanner #'bound-details
+  #'right #'text = #"hhhh"
+c4^\startTextSpan c c c \stopTextSpan
+@end lilypond
+
+@item arrow
+Setting this sub property to @code{#t} produce an arrowhead at the
+end of the line.
+
+@item padding
+This sub property controls the space between the specified
+end-point of the line and the actual end.  Without padding, a
+glissando would start and end in the center of each note head.
+
+@end table
+
+TODO: add this somewhere
+
+@verbatim
+\new Staff {
+  \override TextSpanner #'bound-details #'left-broken #'text = ##f
+   \override TextSpanner #'bound-details #'left #'text = \markup {
+"start" }
+   c'1 \startTextSpan \break
+   c'1
+   c'1 \stopTextSpan
+}
+@end verbatim
+
+
+The music function \endSpanners terminates spanners and hairpins
+after exactly one note.
+
+@lilypond[verbatim,quote,raged-right,relative=2,fragment]
+\endSpanners
+c2 \startTextSpan c2
+c2 \< c2
+@end lilypond
+
+When using \endSpanners it is not necessary to close
+\startTextSpan with \stopTextSpan, nor is it necessary to close
+hairpins with \!.
+
+
+
+@seealso
+
+Program reference: @internalsref{TextSpanner},
+@internalsref{Glissando}, @internalsref{VoiceFollower},
+@internalsref{TrillSpanner},
+@internalsref{line-spanner-interface}.
+
+Examples: @lsr{expressive,line-styles.ly},
+@lsr{expressive,line-arrows.ly}
+
+
+
diff --git a/Documentation/user/tutorial.itely b/Documentation/user/tutorial.itely
index 20ac59980a..5644a0150f 100644
--- a/Documentation/user/tutorial.itely
+++ b/Documentation/user/tutorial.itely
@@ -1,5 +1,5 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
@@ -8,59 +8,31 @@
 @end ignore
 
 @ignore
-Tutorial guidelines:
+Tutorial guidelines:  (different from policy.txt!)
 - unless you have a really good reason, use either
-    @l ilypond[quote,ragged-right,verbatim]
+    @lilypond[verbatim,quote,ragged-right]
   or
-    @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
-  (without spaces)
+    @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+
   Don't use any other relative=X commands (make it a non-fragment
   example), and don't use fragment without relative=2.
-- use "aes" and "ees" instead of "as" and "aes".  I know it's not
-  correct Dutch naming, but let's not confuse people with this until
-  we get to the Basic notation chapter.
-@end ignore
-
 
+- use "aes" and "ees" instead of "as" and "es".  I know it's not
+  correct Dutch naming, but let's not confuse people with this
+  until we get to the Basic notation chapter.
 
-@c   old info that will probably be removed.
-@c TODO:
-@c   * more details about running lilypond; error messages,
-@c     compiling/viewing (emacs?)
-@c   * where to go from First steps+More basics?
+- Add "Music glossary: @rglos{foo}" to the _top_ of the relevant
+  portions of the tutorial.
 
-@c  wherever possible, do not include index entries here; the
-@c  index should point to stuff in the reference manual.  -gp
+@end ignore
 
-@c Your first LilyPond score in 10 minutes?
 
 @node Tutorial
 @chapter Tutorial
 
 This tutorial starts with an introduction to the LilyPond music
-language and how to produce printed music.  After this first contact we
-will explain how to create common musical notation.
-
-@ifhtml
-Many people learn programs by trying and fiddling around with the
-program.  This is also possible with LilyPond.  If you click on a
-picture in the HTML version of this manual, you will see the exact
-LilyPond input that was used to generate that image.
-Try it on this image
-
-@c no verbatim here
-@lilypond[quote,ragged-right]
-\relative c'' {
-  c-\markup { \bold \huge { Click here.  } }
-}
-@end lilypond
-
-By cutting and pasting everything in the @qq{ly snippet} section, you have a
-starting template for experiments.  If you like learning in this way,
-you will probably want to print out or bookmark the
-@ref{Cheat sheet}, which is a table listing of the most common
-commands for quick reference.
-@end ifhtml
+language and how to produce printed music.  After this first
+contact we will explain how to create common musical notation.
 
 @menu
 * First steps::                 
@@ -87,9 +59,9 @@ This section gives a basic introduction to working with LilyPond.
 @node Compiling a file
 @subsection Compiling a file
 
-The first example demonstrates how to start working with LilyPond.  To
-create sheet music, we write a text file that specifies the
-notation.  For example, if we write
+The first example demonstrates how to start working with LilyPond.
+To create sheet music, we write a text file that specifies the
+notation.  For example, if we write:
 
 @example
 @{
@@ -98,7 +70,7 @@ notation.  For example, if we write
 @end example
 
 @noindent
-the result looks like this
+the result looks like this:
 
 @c  in this case we don't want verbatim
 @lilypond[quote,ragged-right]
@@ -107,148 +79,149 @@ the result looks like this
 }
 @end lilypond
 
-@strong{Warning:} Every piece of LilyPond input needs to have @strong{@{ curly
-braces @}} placed around the input.  The braces should also be
-surrounded by a space unless they are at the beginning or end of a
-line to avoid ambiguities.  These may be omitted in some examples in this
-manual, but don't forget them in your own music!
+@warning{Every piece of LilyPond input needs to have
+@strong{@{ curly braces @}} placed around the input.  The braces
+should also be surrounded by a space unless they are at the
+beginning or end of a line to avoid ambiguities.  The braces may
+be omitted in some examples in this manual, but don't forget them
+in your own music!  For more information about the display of
+examples in the manual, see @ref{How to read the tutorial}.}
 
 @cindex Case sensitive
-In addition, LilyPond input is @strong{case sensitive}.  @code{ @{c d e @}}
-is valid input; @code{@{ C D E @}} will produce an error message.
+In addition, LilyPond input is @strong{case sensitive}.  @code{
+@{ c d e @}} is valid input; @code{@{ C D E @}} will produce an
+error message.
 
-@sp 1
+@smallspace
 
 @subheading Entering music and viewing output
 
-In this section we will explain what commands to run
-and how to view or print the output.
+@cindex PDF file
+@cindex Viewing music
 
-@subsubheading MacOS X
+In this section we will explain what commands to run and how to
+view or print the output.
 
-If you double click @code{LilyPond.app}, it will open with an example
-file.  Save it, for example, to @file{test.ly} on your Desktop, and
-then process it with the menu command @samp{Compile > Typeset File}.
-The resulting PDF file will be displayed on your screen.
+Note that there are several other text editors available with
+better support for LilyPond.  For more information, see
+@rprogram{Text editor support}.
 
-Be warned that the first time you ever run LilyPond, it will take a minute
-or two because all of the system fonts have to be analyzed first.
+@warning{the first time you ever run LilyPond, it may take a
+minute or two because all of the system fonts have to be analyzed
+first.  After this, LilyPond will be much faster!}
+
+@subsubheading MacOS X
+
+If you double click @code{LilyPond.app}, it will open with an
+example file.  Save it, for example, to @file{test.ly} on your
+Desktop, and then process it with the menu command @samp{Compile >
+Typeset File}.  The resulting PDF file will be displayed on your
+screen.
 
 For future use of LilyPond, you should begin by selecting @q{New}
-or @q{Open}.  You must save your file before typesetting it.  If any errors
-occur in processing, please see the log window.
+or @q{Open}.  You must save your file before typesetting it.  If
+any errors occur in processing, please see the log window.
+
 
 @subsubheading Windows
 
-On Windows, if you double-click in the LilyPond icon on the Desktop, it
-will open a simple text editor with an example file. Save it, for
-example, to @file{test.ly} on your Desktop and then double-click on the
-file to process it (the file icon looks like a note).  After some
-seconds, you will get a file @file{test.pdf} 
-on your desktop.  Double-click on this PDF file to view the typeset
+On Windows, if you double-click in the LilyPond icon on the
+Desktop, it will open a simple text editor with an example file.
+Save it, for example, to @file{test.ly} on your Desktop and then
+double-click on the file to process it (the file icon looks like a
+note).  After some seconds, you will get a file @file{test.pdf} on
+your desktop.  Double-click on this PDF file to view the typeset
 score.  An alternative method to process the @file{test.ly} file
-is to drag and drop it onto the LilyPond icon using your mouse pointer.
-
-To edit an existing @file{.ly} file, right-click on it and select
-@qq{Edit source}. To get an empty file to start from, run the editor
-as described above and use @qq{New} in the @qq{File} menu.
+is to drag and drop it onto the LilyPond icon using your mouse
+pointer.
 
-Double-clicking the file does not only result in a PDF file, but also
-produces a @file{.log} file that contains some information on what LilyPond
-has done to the file.  If any errors occur, please examine this file.
+To edit an existing @file{.ly} file, right-click on it and
+select @qq{Edit source}.  To get an empty file to start from, run
+the editor as described above and use @qq{New} in
+the @qq{File} menu.
 
-Note that there are several other text editors available, with better
-support for LilyPond, see @rprogram{Text editor support}, for more information.
+Double-clicking the file does not only result in a PDF file, but
+also produces a @file{.log} file that contains some information on
+what LilyPond has done to the file.  If any errors occur, please
+examine this file.
 
 @subsubheading Unix
 
-Begin by opening a terminal window and starting a text editor.  For
-example, you could open an xterm and execute
-@code{joe}@footnote{There are macro files for VIM addicts, and there
-is a @code{LilyPond-mode} for Emacs addicts.  If they have not been
-installed already, refer to the file @file{INSTALL.txt}.  The
-easiest editing environment is @file{LilyPondTool}.  See
-@rprogram{Text editor support}, for more information.}.  In your
-text editor, enter the following input and save the file as
-@file{test.ly}
-
-@verbatim
-{
+Create a file (such as @file{test.ly}) and enter:
+
+@example
+@{
   c' e' g' e'
-}
-@end verbatim
+@}
+@end example
 
-@noindent
-To process @file{test.ly}, proceed as follows
+To process @file{test.ly}, proceed as follows:
 
 @example
 lilypond test.ly
 @end example
 
 @noindent
-You will see something resembling
+You will see something resembling:
 
 @example
 lilypond test.ly
-GNU LilyPond 2.10.0
+GNU LilyPond 2.12.0
 Processing `test.ly'
 Parsing...
-Interpreting music... [1]
+Interpreting music...
 Preprocessing graphical objects...
-Calculating line breaks... [2]
+Finding the ideal number of pages...
+Fitting music on 1 page...
+Drawing systems...
 Layout output to `test.ps'...
 Converting to `test.pdf'...
 @end example
 
-@cindex PDF file
-@cindex Viewing music
-
-@noindent
-The result is the file @file{test.pdf} which you can print or view
-with the standard facilities of your operating system.@footnote{If
-your system does not have any such tools installed, you can try
-@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript}, a freely
-available package for viewing and printing PDF and PostScript files.}
-
 
 @node Simple notation
 @subsection Simple notation
 
-LilyPond will add some notation elements automatically.  In the next
-example, we have only specified four pitches, but LilyPond has
-added a clef, time signature, and rhythms.
+LilyPond will add some notation elements automatically.  In the
+next example, we have only specified four pitches, but LilyPond
+has added a clef, time signature, and rhythms.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 {
   c' e' g' e'
 }
 @end lilypond
 
 @noindent
-This behavior may be altered, but in most cases these automatic values
-are useful.
+This behavior may be altered, but in most cases these automatic
+values are useful.
 
 
 @subheading Pitches
 
-The easiest way to enter notes is by using @code{\relative} mode.  In
-this mode, the @rglos{interval} between the previous note and the
-current note is assumed to be within a @rglos{fourth}.  We begin by
-entering the most elementary piece of music, a @rglos{scale}.
+Music glossary: @rglos{pitch}, @rglos{interval}, @rglos{fourth},
+@rglos{scale}, @rglos{middle C}, @rglos{octave}.
+
+The easiest way to enter notes is by using @code{\relative} mode.
+In this mode, the @notation{interval} between the previous note and
+the current note is assumed to be within a @notation{fourth}.  We
+begin by entering the most elementary piece of music, a
+@notation{scale}.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c' {
   c d e f
   g a b c
 }
 @end lilypond
 
-The initial note is @rglos{middle C}.  Each successive note
-is within a fourth of the previous note -- in other words, the first
-@samp{c} is the closest C to middle C.  This is followed by the closest
-D to the previous note.  We can create melodies which have larger intervals:
+The initial note is @notation{middle C}.  Each successive note is
+within a fourth of the previous note -- in other words, the first
+@code{c} is the closest C to middle C.  This is followed by the
+closest D to the previous note.  We can create melodies which
+have larger intervals:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c' {
   d f a g
   c b f d
@@ -257,13 +230,14 @@ D to the previous note.  We can create melodies which have larger intervals:
 
 @noindent
 As you may notice, this example does not start on middle C.  The first
-note -- the @samp{d} -- is the closest D to middle C.
+note -- the @code{d} -- is the closest D to middle C.
 
-To add intervals that are larger than a fourth, we can raise the octave
-by adding a single quote @code{'} (or apostrophe) to the note name.  We can
-lower the octave by adding a comma @code{,} to the note name.
+To add intervals that are larger than a fourth, we can raise
+the @notation{octave} by adding a single quote @code{'} (or apostrophe)
+to the note name.  We can lower the octave by adding a comma @code{,} to
+the note name.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   a a, c' f,
   g g'' a,, f'
@@ -271,20 +245,24 @@ lower the octave by adding a comma @code{,} to the note name.
 @end lilypond
 
 @noindent
-To change a note by two (or more!) octaves, we use multiple @code{''} or
-@code{,,} -- but be careful that you use two single quotes @code{''} and
-not one double quote @code{"}@tie{}!  The initial value in
-@code{\relative c'} may also be modified like this.
+To change a note by two (or more!) octaves, we use multiple
+@code{''} or @code{,,} -- but be careful that you use two single
+quotes @code{''} and not one double quote @code{"}@tie{}!  The
+initial value in @code{\relative c'} may also be modified like
+this.
 
 
 @subheading Durations (rhythms)
 
-The @rglos{duration} of a note is specified by a number after the note
-name.  @samp{1} for a @rglos{whole note}, @samp{2} for a @rglos{half note},
-@samp{4} for a @rglos{quarter note} and so on.  Beams are added
-automatically.
+Music glossary: @rglos{beam}, @rglos{duration}, @rglos{whole note},
+@rglos{half note}, @rglos{quarter note}, @rglos{dotted note}.
 
-@lilypond[quote,ragged-right,verbatim]
+The @notation{duration} of a note is specified by a number after
+the note name.  @samp{1} for a @notation{whole note}, @samp{2} for
+a @notation{half note}, @samp{4} for a @notation{quarter note} and
+so on.  @notation{Beams} are added automatically.
+
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   a1
   a2 a4 a8 a
@@ -294,11 +272,13 @@ automatically.
 
 @noindent
 If you do not specify a duration, the previous duration is used
-for the next note.  The duration of the first note defaults to a quarter.
+for the next note.  The duration of the first note defaults to a
+quarter.
 
-To create @rglos{dotted note}s, add a dot @samp{.} to the duration number.
+To create @notation{dotted notes}, add a dot @samp{.} to the duration
+number.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   a a a4. a8
   a8. a16 a a8. a8 a4.
@@ -308,9 +288,11 @@ To create @rglos{dotted note}s, add a dot @samp{.} to the duration number.
 
 @subheading Rests
 
-A @rglos{rest} is entered just like a note with the name @samp{r}:
+Music glossary: @rglos{rest}.
+
+A @notation{rest} is entered just like a note with the name @samp{r}:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   a r r2
   r8 a r4 r4. r8
@@ -320,9 +302,12 @@ A @rglos{rest} is entered just like a note with the name @samp{r}:
 
 @subheading Time signature
 
-The @rglos{time signature}) can be set with the @code{\time} command:
+Music glossary: @rglos{time signature}.
+
+The @notation{time signature} can be set with the @code{\time}
+command:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   \time 3/4
   a4 a a
@@ -336,9 +321,11 @@ The @rglos{time signature}) can be set with the @code{\time} command:
 
 @subheading Clef
 
-The @rglos{clef} can be set using the @code{\clef} command:
+Music glossary: @rglos{clef}.
 
-@lilypond[quote,ragged-right,verbatim]
+The @notation{clef} can be set using the @code{\clef} command:
+
+@lilypond[verbatim,quote,ragged-right]
 \relative c' {
   \clef treble
   c1
@@ -356,7 +343,7 @@ The @rglos{clef} can be set using the @code{\clef} command:
 
 Here is a small example showing all these elements together:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c, {
   \time 3/4
   \clef bass
@@ -365,93 +352,94 @@ Here is a small example showing all these elements together:
 }
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Entering pitches and durations
-see @ref{Pitches}, and @ref{Durations}.
-@item Rests
-see @ref{Rests}.
-@item Time signatures and other timing commands
-see @ref{Time signature}.
-@item Clefs
-see @ref{Clef}.
-@end table
-@end quotation
+
+@seealso
+
+Notation reference: @ruser{Writing pitches}, @ruser{Writing rhythms},
+@ruser{Writing rests}, @ruser{Time signature}, @ruser{Clef}.
 
 
+@c HERE's where I started
+
 @node Working on text files
 @subsection Working on text files
 
-LilyPond input files are similar to source files in many common programming languages.
-They are case sensitive, and white-space is generally equivalent.  Expressions are
-formed with curly braces @{ @}, and comments are denoted with @code{%} or
-@code{%@{ ... %@}}.
+LilyPond input files are similar to source files in many common
+programming languages.  They are case sensitive, and white-space
+is generally equivalent.  Expressions are formed with curly braces
+@{ @}, and comments are denoted with @code{%} or @code{%@{ ...
+%@}}.
 
-If the previous sentence sounds like nonsense, don't worry!  We'll explain
-what all these terms mean:
+If the previous sentence sounds like nonsense, don't worry!  We'll
+explain what all these terms mean:
 
 @itemize
 
 @cindex Case sensitive
-@item @strong{Case sensitive}:
-it matters whether you enter a letter
-in lower case (i.e. @code{a, b, s, t}) or upper case (i.e.
-@code{A, B, S, T}).  Notes are lower case: @code{@{ c d e @}}
-is valid input; @code{@{ C D E @}} will produce an error message.
-
-@item @strong{Whitespace insensitive}:
-it does not matter how many
-spaces (or new lines) you add.  @code{@{ c d e @}} means the same thing
-as @code{@{ c @tie{} @tie{} @tie{} d e @}} and
+@item
+@strong{Case sensitive}:
+it matters whether you enter a letter in lower case (e.g. @code{a,
+b, s, t}) or upper case (e.g.  @code{A, B, S, T}).  Notes are
+lower case: @code{@{ c d e @}} is valid input; @code{@{ C D E @}}
+will produce an error message.
+
+@item
+@strong{Whitespace insensitive}:
+it does not matter how many spaces (or new lines) you add.
+@code{@{ c d e @}} means the same thing as @code{@{ c @tie{}
+@tie{} @tie{} d e @}} and:
+
 @example
-          @{
-c                        d
-  e @}
+@{ c                        d
+                   e   @}
 @end example
 
 @noindent
-Of course, the previous example is hard to read.  A good rule of thumb
-is to indent code blocks with either a tab or two spaces:
+Of course, the previous example is hard to read.  A good rule of
+thumb is to indent code blocks with either a tab or two spaces:
+
 @example
 @{
   c d e
 @}
 @end example
 
-@item @strong{Expressions:}
-Every piece of LilyPond input needs to have
-@strong{@{ curly braces @}} placed around the input.  These braces tell
-LilyPond that the input is a single music expression, just like
-parenthesis @samp{()} in mathematics.  The braces should
-be surrounded by a space unless they are at the beginning or end of a
-line to avoid ambiguities.
+@item
+@strong{Expressions:}
+Every piece of LilyPond input needs to have @strong{@{ curly
+braces @}} placed around the input.  These braces tell LilyPond
+that the input is a single music expression, just like parentheses
+@samp{()} in mathematics.  The braces should be surrounded by a
+space unless they are at the beginning or end of a line to avoid
+ambiguities.
 
-A function (such as @code{\relative @{ @}}) also counts as a single
-music expression.
+A function (such as @code{\relative @{ @}}) also counts as a
+single music expression.
 
 @cindex comments
 @cindex line comment
 @cindex block comment
-@item @strong{Comments}:
-A comment is a remark for the human reader of the music input; it is
-ignored while parsing, so it has no effect on the printed output.
-There are two types of comments.  The percent symbol @samp{%}
-introduces a line comment; anything after @samp{%} on that line is
-ignored.  A block comment marks a whole section of music
-input as a comment.  Anything that is enclosed in @code{%@{} and @code{%@}} is
-ignored.  (Comments do not nest.)  The following fragment shows possible uses for comments
+@item
+@strong{Comments}:
+A comment is a remark for the human reader of the music input; it
+is ignored while parsing, so it has no effect on the printed
+output.  There are two types of comments.  The percent symbol
+@samp{%} introduces a line comment; anything after @samp{%} on
+that line is ignored.  A block comment marks a whole section of
+music input as a comment.  Anything that is enclosed in @code{%@{}
+and @code{%@}} is ignored.  (Comments do not nest.)  The following
+fragment shows possible uses for comments:
 
 @example
 % notes for twinkle twinkle follow
   c4 c g' g a a g2
 
 %@{
-    This line, and the notes below
-    are ignored, since they are in a
-    block comment.
+  This line, and the notes below
+  are ignored, since they are in a
+  block comment.
 
-    g g f f e e d d c2
+  g g f f e e d d c2
 %@}
 @end example
 
@@ -464,15 +452,12 @@ There are more tips for constructing input files in
 @node How to read the tutorial
 @subsection How to read the tutorial
 
-As we saw in @ref{Working on text files}, LilyPond input must be
-surrounded by @{ @} marks or a @code{\relative c'' @{ ... @}}.  For the
-rest of this manual, most examples will omit this.
-
-If you are reading the HTML documentation and wish to see the exact
-exact LilyPond code that was used to create the example, simply click
-on the picture.  If you are not reading the HTML version, you could
-copy and paste the displayed input, but you @strong{must} add the
-@code{\relative c'' @{ @}} like this:
+LilyPond input must be surrounded by @{ @} marks or a
+@code{\relative c'' @{ ... @}}, as we saw in @ref{Working on text
+files}.  For the rest of this manual, most examples will omit
+this.  To replicate the examples, you may copy and paste the
+displayed input but you @strong{must} add the @code{\relative c''
+@{ @}} like this:
 
 @example
 \relative c'' @{
@@ -480,13 +465,36 @@ copy and paste the displayed input, but you @strong{must} add the
 @}
 @end example
 
-Why omit the braces?  Most examples
-in this manual can be inserted into the middle of a longer piece of
-music.  For these examples, it does not make sense to add
-@code{\relative c'' @{ @}} -- you should not place a @code{\relative}
-inside another @code{\relative}, so you would not be able to copy
-a small documentation example and paste it inside a longer piece
-of your own.
+Why omit the braces?  Most examples in this manual can be inserted
+into the middle of a longer piece of music.  For these examples,
+it does not make sense to add @code{\relative c'' @{ @}} -- you
+should not place a @code{\relative} inside another
+@code{\relative}!  If we included @code{\relative c'' @{ @}}
+around every example, you would not be able to copy a small
+documentation example and paste it inside a longer piece of your
+own.  Most people want to add material to an existing piece, so we
+format the manual this way.
+
+
+@subheading Clickable examples
+
+Many people learn programs by trying and fiddling around with the
+program.  This is also possible with LilyPond.  If you click on a
+picture in the HTML version of this manual, you will see the exact
+LilyPond input that was used to generate that image.  Try it on
+this image:
+
+@c no verbatim here
+@lilypond[quote,ragged-right]
+\relative c'' {
+  c-\markup { \bold \huge { Click here.  } }
+}
+@end lilypond
+
+By cutting and pasting everything in the @qq{ly snippet} section,
+you have a starting template for experiments.  To see exactly the
+same output (line-width and all), copy everything from @qq{Start
+cut-&-pastable section} to the bottom of the file.
 
 
 @node Single staff notation
@@ -500,6 +508,7 @@ on one staff.
 * Accidentals and key signatures::  
 * Ties and slurs::              
 * Articulation and dynamics::   
+* Adding text::                 
 * Automatic and manual beams::  
 * Advanced rhythmic commands::  
 @end menu
@@ -508,118 +517,133 @@ on one staff.
 @node Relative note names
 @subsection Relative note names
 
-As we saw in @ref{Simple notation}, LilyPond calculates the pitch of
-each note relative to the previous one@footnote{There is another mode of
-entering pitches, @ref{Absolute note names}, but in practice relative
-mode is much easier and safer to use.}.  If no extra octave marks
-(@code{'} and @code{,}) are added, it assumes that each pitch is within
-a fourth of the previous note.
+Music glossary: @rglos{octave}, @rglos{fourth}, @rglos{fifth}.
 
-LilyPond examines pitches based on the note names -- in other words,
-an augmented fourth is @emph{not} the same as a diminished fifth.  If we
-begin at a C, then an F-sharp will be placed a higher than the C, while
-a G-flat will be placed lower than the C.
+LilyPond calculates the pitch of each note relative to the
+previous one@footnote{There is another mode of entering pitches,
+@ruser{Absolute note names}. However, in practice relative mode is
+much easier and safer to use.}, as we saw in @ref{Simple
+notation}.  If no extra @notation{octave} marks (@code{'} and
+@code{,}) are added, it assumes that each pitch is within a
+@notation{fourth} of the previous note.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+LilyPond examines pitches based on the note names -- in other
+words, an augmented fourth is @emph{not} treated the same as a
+diminished fifth.  If we begin at a C, then an F-sharp will be placed a
+higher than the C, while a G-flat will be placed lower than the C.
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c2 fis
 c2 ges
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Relative octaves
-see @ref{Relative octaves}.
+see @ruser{Relative octaves}.
 @item Octave check
-see @ref{Octave check}.
+see @ruser{Octave check}.
 @end table
 @end quotation
 
 
-
 @node Accidentals and key signatures
 @subsection Accidentals and key signatures
 
 @subheading Accidentals
 
-A @rglos{sharp} pitch is made by adding @samp{is} to
-the name, and a @rglos{flat} pitch by adding @samp{es}.  As
-you might expect, a @rglos{double sharp} or @rglos{double flat} is
-made by adding @samp{isis} or @samp{eses}@footnote{This syntax
-derived from note naming conventions in Nordic and Germanic languages,
-like German and Dutch.  To use other names for accidentals, see
-@ref{Note names in other languages}.}
+Music glossary: @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
+@rglos{double flat}, @rglos{accidental}.
+
+A @notation{sharp} pitch is made by adding @samp{is} to the name, and
+a @notation{flat} pitch by adding @samp{es}.  As you might expect, a
+@notation{double sharp} or @notation{double flat} is made by adding
+@samp{isis} or @samp{eses}.  This syntax derived from note
+naming conventions in Nordic and Germanic languages, like German
+and Dutch.  To use other names for @notation{accidentals}, see
+@ruser{Note names in other languages}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 cis1 ees fisis, aeses
 @end lilypond
 
 @cindex key signature, setting
 @subheading Key signatures
 
-The key signature is set with the command @code{\key} followed by
-a pitch and @code{\major} or @code{\minor}.
+Music glossary: @rglos{key signature}, @rglos{major}, @rglos{minor}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+The @notation{key signature} is set with the command @code{\key}
+followed by a pitch and @code{\major} or @code{\minor}.
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 \key d \major
 a1
 \key c \minor
 a
 @end lilypond
 
-@sp 1
+@smallspace
 
 @subheading Warning: key signatures and pitches
 
-To determine whether to print an accidental, LilyPond examines the
-pitches and the key signature.  The key signature only affects
-the @emph{printed} accidentals, not the actual pitches!  This is a
-feature that often causes confusion to newcomers, so let us explain it
-in more detail.
+Music glossary: @rglos{accidental}, @rglos{key signature},
+@rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
+@rglos{transposition}.
 
-LilyPond makes a sharp distinction between musical content and
-layout.  The alteration (flat, natural or sharp) of a note is part of
-the pitch, and is therefore musical content.  Whether an accidental (a
-@emph{printed} flat, natural or sharp sign) is printed in front of the
-corresponding note is a question of layout.  Layout is something that
-follows rules, so accidentals are printed automatically according to
-those rules.  The pitches in your music are works of art, so they will
-not be added automatically, and you must enter what you want to hear.
+To determine whether to print an @notation{accidental}, LilyPond
+examines the pitches and the @notation{key signature}.  The key
+signature only affects the @emph{printed} accidentals, not the note's
+@notation{pitch}!  This is a feature that often causes confusion to
+newcomers, so let us explain it in more detail.
 
-In this example
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+LilyPond makes a sharp distinction between musical content and
+layout.  The alteration (@notation{flat}, @notation{natural} or
+@notation{sharp}) of a note is part of the pitch, and is therefore
+musical content.  Whether an accidental (a @emph{printed} flat, natural
+or sharp sign) is printed in front of the corresponding note is a
+question of layout.  Layout is something that follows rules, so
+accidentals are printed automatically according to those rules.  The
+pitches in your music are works of art, so they will not be added
+automatically, and you must enter what you want to hear.
+
+In this example:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 \key d \major
 d cis fis
 @end lilypond
 
 @noindent
-No note has a printed accidental, but you must still add the @samp{is} to
-@code{cis} and @code{fis}.
+No note has a printed accidental, but you must still add the
+@samp{is} to @code{cis} and @code{fis}.
 
-The code @samp{e} does not mean @qq{print a black dot just below the
-first line of the staff.}  Rather, it means: @qq{there is a note with
-pitch E-natural.}  In the key of A-flat major, it @emph{does} get an
-accidental:
+The code @samp{e} does not mean @qq{print a black dot just below
+the first line of the staff.}  Rather, it means @qq{there is a
+note with pitch E-natural.}  In the key of A-flat major, it
+@emph{does} get an accidental:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 \key aes \major
 e
 @end lilypond
 
-Adding all alterations explicitly might require a little more effort
-when typing, but the advantage is that transposing is easier, and
-accidentals can be printed according to different conventions.  See
-@ref{Automatic accidentals}, for some examples how accidentals can be printed
-according to different rules.
+Adding all alterations explicitly might require a little more
+effort when typing, but the advantage is that
+@notation{transposing} is easier, and accidentals can be printed
+according to different conventions.  For some examples how
+accidentals can be printed according to different rules, see
+@ruser{Automatic accidentals}.
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Accidentals
-see @ref{Accidentals}, and @ref{Automatic accidentals}.
+see @ruser{Accidentals}, and @ruser{Automatic accidentals}.
 @item Key signature
-see @ref{Key signature}.
+see @ruser{Key signature}
+@item Pitch names
+see @rglos{Pitch names}.
 @end table
 @end quotation
 
@@ -629,10 +653,13 @@ see @ref{Key signature}.
 
 @cindex ties
 @subheading Ties
-A @rglos{tie} is created by appending a tilde @samp{~} to the first
-note being tied
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+Music glossary: @rglos{tie}.
+
+A @notation{tie} is created by appending a tilde @samp{~} to the
+first note being tied
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 g4~ g c2~
 c4 ~ c8 a8 ~ a2
 @end lilypond
@@ -640,10 +667,13 @@ c4 ~ c8 a8 ~ a2
 @cindex slurs
 @subheading Slurs
 
-A @rglos{slur} is a curve drawn across many notes.  The starting note
-and ending note are marked with @samp{(} and @samp{)} respectively.
+Music glossary: @rglos{slur}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+A @notation{slur} is a curve drawn across many notes.  The starting
+note and ending note are marked with @samp{(} and @samp{)}
+respectively.
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 d4( c16) cis( d e c cis d) e( d4)
 @end lilypond
 
@@ -651,39 +681,43 @@ d4( c16) cis( d e c cis d) e( d4)
 @cindex phrasing slurs
 @subheading Phrasing slurs
 
-Slurs to indicate longer phrasing can be entered with @code{\(} and
-@code{\)}.  You can have both legato slurs and phrasing slurs at the
-same time, but you cannot have simultaneous slurs or simultaneous
-phrasing slurs.
+Music glossary: @rglos{phrasing}, @rglos{legato}.
+
+Slurs to indicate longer @notation{phrasing} can be entered with
+@code{\(} and @code{\)}.  You can have both @notation{legato} slurs and
+phrasing slurs at the same time, but you cannot have simultaneous legato
+slurs or simultaneous phrasing slurs.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 a8(\( ais b c) cis2 b'2 a4 cis,\)
 @end lilypond
 
-@sp 1
+@smallspace
 
 @cindex slurs versus ties
 @subheading Warnings: slurs vs. ties
 
-A slur looks like a @rglos{tie}, but it has a different meaning.  A
-tie simply makes the first note longer, and can only be used on
-pairs of notes with the same pitch.  Slurs indicate the articulations
-of notes, and can be used on larger groups of notes.  Slurs and ties
-can be nested.
+Music glossary: @rglos{articulation}, @rglos{slur}, @rglos{tie}.
+
+A @notation{slur} looks like a @notation{tie}, but it has a different
+meaning.  A tie simply makes the first note longer, and can only be
+used on pairs of notes with the same pitch.  Slurs indicate the
+@notation{articulation} of notes, and can be used on larger groups of
+notes.  Slurs and ties can be nested.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Ties
-see @ref{Ties}.
+see @ruser{Ties}.
 @item Slurs
-see @ref{Slurs}.
+see @ruser{Slurs}.
 @item Phrasing slurs
-see @ref{Phrasing slurs}.
+see @ruser{Phrasing slurs}.
 @end table
 @end quotation
 
@@ -696,36 +730,46 @@ see @ref{Phrasing slurs}.
 @cindex staccato
 @subheading Articulations
 
-Common @rglos{articulation}s can be added to a note using a dash @samp{-}
-and a single character:
+Music glossary: @rglos{articulation}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+Common @notation{articulations} can be added to a note using a
+dash @samp{-} and a single character:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c-. c-- c-> c-^ c-+ c-_
 @end lilypond
 
 @cindex fingering
 @subheading Fingerings
-Similarly, fingering indications can be added to a note using a dash
-(@samp{-}) and the digit to be printed:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+Music glossary: @rglos{fingering}.
+
+Similarly, @notation{fingering} indications can be added to a note using
+a dash (@samp{-}) and the digit to be printed:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c-3 e-5 b-2 a-1
 @end lilypond
 
-Articulations and fingerings are usually placed automatically, but you
-can specify a direction using @samp{^} (up) or @samp{_} (down).  You can
-also use multiple articulations on the same note.  However, in most cases
-it is best to let LilyPond determine the articulation directions.
+Articulations and fingerings are usually placed automatically, but
+you can specify a direction using @samp{^} (up) or @samp{_}
+(down).  You can also use multiple articulations on the same note.
+However, in most cases it is best to let LilyPond determine the
+articulation directions.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c_-^1 d^. f^4_2-> e^-_+
 @end lilypond
 
 @subheading Dynamics
-Dynamic signs are made by adding the markings (with a backslash) to
-the note
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+Music glossary: @rglos{dynamics}, @rglos{crescendo},
+@rglos{decrescendo}.
+
+@notation{Dynamic} signs are made by adding the markings (with a
+backslash) to the note:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c\ff c\mf c\p c\pp
 @end lilypond
 
@@ -733,53 +777,84 @@ c\ff c\mf c\p c\pp
 @cindex decrescendo
 @cindex crescendo
 
-Crescendi and decrescendi are started with the commands @code{\<} and
-@code{\>}.  An ending dynamic, for example @code{\f}, will finish the
-(de)crescendo, or the command @code{\!} can be used
+@notation{Crescendi} and @notation{decrescendi} are started with
+the commands @code{\<} and @code{\>}.  An ending dynamic, for
+example @code{\f}, will finish the (de)crescendo, or the command
+@code{\!} can be used:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Articulations
-see @ref{Articulations}.
+see @ruser{Articulations}.
 @item Fingering
-see @ref{Fingering instructions}.
+see @ruser{Fingering instructions}.
 @item Dynamics
-see @ref{Dynamics}.
+see @ruser{Dynamics} (Notation reference) and @rglos{dynamics}
+(Glossary).
 @end table
 @end quotation
 
+@c CONTINUE HERE
+
+@node Adding text
+@subsection Adding text
+
+Text may be added to your scores:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+c1^"espr" a_"legato"
+@end lilypond
+
+Extra formatting may be added with the @code{\markup} command:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
+c1^\markup{ \bold espr}
+a1_\markup{
+  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
+}
+@end lilypond
+
+
+@c Kurt: leave this alone for now.
+
+@seealso
+
+Notation reference: @ruser{Writing text}.
+
 
 @node Automatic and manual beams
 @subsection Automatic and manual beams
 
+Music glossary: @rglos{beam}.
+
 @cindex beams, by hand
-All @rglos{beam}s are drawn automatically:
+All @notation{beams} are drawn automatically:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 a8 ais d ees r d c16 b a8
 @end lilypond
 
 @noindent
 If you do not like the automatic beams, they may be overridden
-manually.  Mark the first note to be beamed with @samp{[} and the last one
-with @samp{]}.
+manually.  Mark the first note to be beamed with @samp{[} and the
+last one with @samp{]}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Automatic beams
-see @ref{Automatic beams}.
+see @ruser{Automatic beams}.
 @item Manual beams
-see @ref{Manual beams}.
+see @ruser{Manual beams}.
 @end table
 @end quotation
 
@@ -788,15 +863,17 @@ see @ref{Manual beams}.
 @subsection Advanced rhythmic commands
 
 @cindex pickup
-@cindex anacruse
+@cindex anacrusis
 @cindex partial measure
 @subheading Partial measure
 
-A pickup (or @rglos{anacrusis}) is entered with the keyword
-@code{\partial}.  It is followed by a duration: @code{\partial 4} is
-a quarter note pickup and @code{\partial 8} an eighth note.
+Music glossary: @rglos{anacrusis}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+A pickup (or @notation{anacrusis}) is entered with the keyword
+@code{\partial}.  It is followed by a duration: @code{\partial 4}
+is a quarter note pickup and @code{\partial 8} an eighth note.
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 \partial 8
 f8 c2 d
 @end lilypond
@@ -805,12 +882,15 @@ f8 c2 d
 @cindex triplets
 @subheading Tuplets
 
-Tuplets are made with the @code{\times} keyword.  It takes two
-arguments: a fraction and a piece of music.  The duration of the piece
-of music is multiplied by the fraction.  Triplets make notes occupy
-2/3 of their notated duration, so a triplet has 2/3 as its fraction
+Music glossary: @rglos{note value}, @rglos{triplet}.
+
+@notation{Tuplets} are made with the @code{\times} keyword.  It
+takes two arguments: a fraction and a piece of music.  The
+duration of the piece of music is multiplied by the fraction.
+Triplets make notes occupy 2/3 of their notated duration, so a
+@notation{triplet} has 2/3 as its fraction
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 \times 2/3 { f8 g a }
 \times 2/3 { c r c }
 \times 2/3 { f,8 g16[ a g a] }
@@ -822,25 +902,27 @@ of music is multiplied by the fraction.  Triplets make notes occupy
 @cindex appoggiatura
 @subheading Grace notes
 
-Grace notes are created with the @code{\grace} command, although they
-can also be created by prefixing a music expression with the
-keyword @code{\appoggiatura} or @code{\acciaccatura}
+Music glossary: @rglos{grace notes}, @rglos{appoggiatura}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@notation{Grace notes} are created with the @code{\grace} command,
+although they can also be created by prefixing a music expression
+with the keyword @code{\appoggiatura} or @code{\acciaccatura}:
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 c2 \grace { a32[ b] } c2
 c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
 @table @asis
 @item Grace notes
-see @ref{Grace notes},
+see @ruser{Grace notes},
 @item Tuplets
-see @ref{Tuplets},
+see @ruser{Tuplets},
 @item Pickups
-see @ref{Partial measures}.
+see @ruser{Partial measures}.
 @end table
 @end quotation
 
@@ -848,13 +930,13 @@ see @ref{Partial measures}.
 @node Multiple notes at once
 @section Multiple notes at once
 
-This section introduces having more than one note at the same time:
-multiple instruments, multiple staves for a single instrument (i.e. piano),
-and chords.
+This section introduces having more than one note at the same
+time: multiple instruments, multiple staves for a single
+instrument (i.e. piano), and chords.
 
-Polyphony in music refers to having more than one voice occurring in
-a piece of music.  Polyphony in LilyPond refers to having more than
-one voice on the same staff.
+Polyphony in music refers to having more than one voice occurring
+in a piece of music.  Polyphony in LilyPond refers to having more
+than one voice on the same staff.
 
 @menu
 * Music expressions explained::  
@@ -869,38 +951,42 @@ one voice on the same staff.
 @subsection Music expressions explained
 
 In LilyPond input files, music is represented by @emph{music
-expressions}.  A single note is a music expression, although it is not
-valid input all on its own.
+expressions}.  A single note is a music expression:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 a4
 @end lilypond
 
-Enclosing a group of notes in braces creates a new music expression:
+Enclosing a note in braces creates a @emph{compound music
+expression}.  Here we have created a compound music expression
+with two notes:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 { a4 g4 }
 @end lilypond
 
-Putting a group of music expressions (e.g. notes) in braces means that
-they are in sequence (i.e. each one follows the previous one).  The result
-is another music expression:
+Putting a group of music expressions (e.g. notes) in braces means
+that they are in sequence (i.e. each one follows the previous
+one).  The result is another music expression:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 { { a4 g } f g }
 @end lilypond
 
 @subheading Simultaneous music expressions: multiple staves
 
-This technique is useful for polyphonic music.  To enter music
-with more voices or more staves, we combine expressions in
-parallel.  To indicate that two voices should play at the same time,
-simply enter a simultaneous combination of music expressions.  A
-@q{simultaneous} music expression is formed by enclosing expressions inside
-@code{<<} and @code{>>}.  In the following example, three sequences (all
-containing two separate notes) are combined simultaneously:
+Music glossary: @rglos{polyphony}.
+
+This technique is useful for @notation{polyphonic} music.  To
+enter music with more voices or more staves, we combine
+expressions in parallel.  To indicate that two voices should play
+at the same time, simply enter a simultaneous combination of music
+expressions.  A @q{simultaneous} music expression is formed by
+enclosing expressions inside @code{<<} and @code{>>}.  In the
+following example, three sequences (all containing two separate
+notes) are combined simultaneously:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   <<
     { a4 g }
@@ -910,23 +996,24 @@ containing two separate notes) are combined simultaneously:
 }
 @end lilypond
 
-Note that we have indented each level of the input with a different
-amount of space.  LilyPond does not care how much (or little) space there
-is at the beginning of a line, but indenting LilyPond code like this makes
-it much easier for humans to read.
+Note that we have indented each level of the input with a
+different amount of space.  LilyPond does not care how much (or
+little) space there is at the beginning of a line, but indenting
+LilyPond code like this makes it much easier for humans to read.
 
-@strong{Warning}: each note is relative to the
-previous note in the input, not relative to the @code{c''} in the
-initial @code{\relative} command.
+@warning{each note is relative to the previous note in
+the input, not relative to the @code{c''} in the initial
+@code{\\relative} command.}
 
 
 @subheading Simultaneous music expressions: single staff
 
-To determine the number of staves in a piece, LilyPond looks at the first
-expression.  If it is a single note, there is one staff; if there is a
-simultaneous expression, there is more than one staff.
+To determine the number of staves in a piece, LilyPond looks at
+the first expression.  If it is a single note, there is one staff;
+if there is a simultaneous expression, there is more than one
+staff.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   c2 <<c e>>
   << { e f } { c <<b d>> } >>
@@ -937,10 +1024,10 @@ simultaneous expression, there is more than one staff.
 @cindex music expression
 @subheading Analogy: mathematical expressions
 
-This mechanism is similar to mathematical
-formulas: a big formula is created by composing small formulas.  Such
-formulas are called expressions, and their definition is recursive so
-you can make arbitrarily complex and large expressions.  For example,
+This mechanism is similar to mathematical formulas: a big formula
+is created by composing small formulas.  Such formulas are called
+expressions, and their definition is recursive so you can make
+arbitrarily complex and large expressions.  For example,
 
 @example
 1
@@ -952,28 +1039,30 @@ you can make arbitrarily complex and large expressions.  For example,
 ((1 + 2) * 3) / (4 * 5)
 @end example
 
-This is a sequence of expressions, where each expression is contained
-in the next (larger) one.  The simplest expressions are numbers, and larger
-ones are made by combining expressions with operators (like @samp{+},
-@samp{*} and @samp{/}) and parentheses.  Like mathematical expressions,
-music expressions can be nested arbitrarily deep, which is necessary
-for complex music like polyphonic scores.
+This is a sequence of expressions, where each expression is
+contained in the next (larger) one.  The simplest expressions are
+numbers, and larger ones are made by combining expressions with
+operators (like @samp{+}, @samp{*} and @samp{/}) and parentheses.
+Like mathematical expressions, music expressions can be nested
+arbitrarily deep, which is necessary for complex music like
+polyphonic scores.
 
 
 @node Multiple staves
 @subsection Multiple staves
 
-As we saw in @ref{Music expressions explained}, LilyPond input files
-are constructed out of music expressions.  If the score begins with
-simultaneous music expressions, LilyPond creates multiples staves.  However,
-it is easier to see what happens if we create each staff explicitly.
+LilyPond input files are constructed out of music expressions, as
+we saw in @ref{Music expressions explained}.  If the score begins
+with simultaneous music expressions, LilyPond creates multiples
+staves.  However, it is easier to see what happens if we create
+each staff explicitly.
 
 To print more than one staff, each piece of music that makes up a
 staff is marked by adding @code{\new Staff} before it.  These
-@code{Staff} elements are then combined in parallel with @code{<<} and
-@code{>>}:
+@code{Staff} elements are then combined in parallel with @code{<<}
+and @code{>>}:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   <<
     \new Staff { \clef treble c }
@@ -982,28 +1071,28 @@ staff is marked by adding @code{\new Staff} before it.  These
 }
 @end lilypond
 
-The command @code{\new} introduces a @q{notation context.}  A notation
-context is an environment in which musical events (like notes or
-@code{\clef} commands) are interpreted.  For simple pieces, such
-notation contexts are created automatically.  For more complex pieces, it
-is best to mark contexts explicitly.
+The command @code{\new} introduces a @q{notation context.}  A
+notation context is an environment in which musical events (like
+notes or @code{\clef} commands) are interpreted.  For simple
+pieces, such notation contexts are created automatically.  For
+more complex pieces, it is best to mark contexts explicitly.
 
 There are several types of contexts.  @code{Score}, @code{Staff},
-and @code{Voice} handle melodic notation, while @code{Lyrics} sets lyric
-texts and @code{ChordNames} prints chord names.
+and @code{Voice} handle melodic notation, while @code{Lyrics} sets
+lyric texts and @code{ChordNames} prints chord names.
 
 In terms of syntax, prepending @code{\new} to a music expression
-creates a bigger music expression.  In this way it resembles the minus
-sign in mathematics.  The formula @math{(4+5)} is an expression, so
-@math{-(4+5)} is a bigger expression.
+creates a bigger music expression.  In this way it resembles the
+minus sign in mathematics.  The formula @math{(4+5)} is an
+expression, so @math{-(4+5)} is a bigger expression.
 
-Time signatures entered in one staff affects all other 
-staves@footnote{This behavior may be changed if desired; see
-@ref{Polymetric notation}, for details.}. On the other hand, 
+Time signatures entered in one staff affects all other
+staves@footnote{This behavior may be changed if desired; for
+details, see @ruser{Polymetric notation}.}.  On the other hand,
 the key signature of one staff does @emph{not} affect other
 staves.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   <<
     \new Staff { \clef treble \time 3/4 c }
@@ -1020,9 +1109,14 @@ staves.
 
 @cindex staff switch, manual
 @cindex cross staff voice, manual
-Piano music is typeset in two staves connected by a brace.  Printing
-such a staff is similar to the polyphonic example in @ref{Multiple staves},
-but now this entire expression is inserted inside a @code{PianoStaff}:
+
+Music glossary: @rglos{brace}.
+
+Piano music is typeset in two staves connected by a
+@notation{brace}.
+Printing such a staff is similar to the polyphonic example in
+@ref{Multiple staves}.  However, now this entire expression is
+inserted inside a @code{PianoStaff}:
 
 @example
 \new PianoStaff <<
@@ -1031,9 +1125,9 @@ but now this entire expression is inserted inside a @code{PianoStaff}:
 >>
 @end example
 
-Here is a small example
+Here is a small example:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   \new PianoStaff <<
     \new Staff { \time 2/4 c4 e g g, }
@@ -1042,9 +1136,9 @@ Here is a small example
 }
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-See @ref{Piano music}.
+See @ruser{Piano music}.
 @end quotation
 
 
@@ -1052,21 +1146,25 @@ See @ref{Piano music}.
 @subsection Combining notes into chords
 
 @cindex chords
-Chords can be made by surrounding pitches with single angle brackets.  Angle
-brackets are the symbols @samp{<} and @samp{>}.
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+Music glossary: @rglos{chord}.
+
+@notation{Chords} can be made by surrounding pitches with single
+angle brackets.  Angle brackets are the symbols @samp{<} and
+@samp{>}.
+
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 r4 <c e g>4 <c f a>2
 @end lilypond
 
-You can combine markings like beams and ties with chords.  They must
-be placed outside the angle brackets
+You can combine markings like beams and ties with chords.  They
+must be placed outside the angle brackets
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 r4 <c e g>8[ <c f a>]~ <c f a>2
 @end lilypond
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
 @end lilypond
 
@@ -1077,28 +1175,29 @@ r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
 @cindex polyphony
 @cindex multiple voices
 @cindex voices, more -- on a staff
-When different melodic lines are combined on a single staff they are
-printed as polyphonic voices; each voice has its own stems, slurs and
-beams, and the top voice has the stems up, while the bottom voice has
-them down.
+When different melodic lines are combined on a single staff they
+are printed as polyphonic voices; each voice has its own stems,
+slurs and beams, and the top voice has the stems up, while the
+bottom voice has them down.
 
-Entering such parts is done by entering each voice as a sequence (with
-@code{@{...@}}) and combining these simultaneously, separating the
-voices with @code{\\}
+Entering such parts is done by entering each voice as a sequence
+(with @code{@{...@}}) and combining these simultaneously,
+separating the voices with @code{\\}
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { r4 g4 f2 f4 }
 >>
 @end lilypond
 
-For polyphonic music typesetting, spacer rests can also be convenient;
-these are rests that do not print.  They are useful for filling up
-voices that temporarily do not play.  Here is the same example with a
-spacer rest (@samp{s}) instead of a normal rest (@samp{r}),
+For polyphonic music typesetting, spacer rests can also be
+convenient; these are rests that do not print.  They are useful
+for filling up voices that temporarily do not play.  Here is the
+same example with a spacer rest (@samp{s}) instead of a normal
+rest (@samp{r}),
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { s4 g4 f2 f4 }
@@ -1108,7 +1207,7 @@ spacer rest (@samp{s}) instead of a normal rest (@samp{r}),
 @noindent
 Again, these expressions can be nested arbitrarily.
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,ragged-right,fragment,relative=2]
 <<
   \new Staff <<
     { a4 g2 f4~ f4 } \\
@@ -1122,9 +1221,9 @@ Again, these expressions can be nested arbitrarily.
 >>
 @end lilypond
 
-@moreinfo
+@seealso
 @quotation
-See @ref{Basic polyphony}.
+See @ruser{Simultaneous notes}.
 @end quotation
 
 
@@ -1134,144 +1233,241 @@ See @ref{Basic polyphony}.
 This section introduces vocal music and simple song sheets.
 
 @menu
-* Printing lyrics::             
-* A lead sheet::                
+* Setting simple songs::        
+* Aligning lyrics to a melody::  
+* Lyrics to multiple staves::   
 @end menu
 
 
-@node Printing lyrics
-@subsection Printing lyrics
+@node Setting simple songs
+@subsection Setting simple songs
 
 @cindex Lyrics
 @cindex Songs
-Consider a simple melody:
 
-@lilypond[quote,ragged-right,verbatim]
+Music glossary: @rglos{lyrics}.
+
+Here is the start of the melody to a nursery
+rhyme, @qq{Girls and boys come out to play}:
+
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
-  a4 e c8 e r4
-  b2 c4( d)
+  \key g \major
+  \time 6/8
+  d4 b8 c4 a8 d4 b8 g4
 }
 @end lilypond
 
-The lyrics can be set to these notes, combining both with the
-@code{\addlyrics} keyword.  Lyrics are entered by separating each
-syllable with a space.
+The @notation{lyrics} can be set to these notes, combining both
+with the @code{\addlyrics} keyword.  Lyrics are entered by
+separating each syllable with a space.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 <<
   \relative c'' {
-    a4 e c8 e r4
-    b2 c4( d)
+    \key g \major
+    \time 6/8
+    d4 b8 c4 a8 d4 b8 g4
+  }
+  \addlyrics {
+    Girls and boys come out to play,
   }
-  \addlyrics { One day this shall be free }
 >>
 @end lilypond
 
+Note the curly brackets delimiting both the music and the lyrics,
+and the angle brackets @code{<< ... >>} around the whole piece to
+show that the music and lyrics are to occur at the same time.
+
+@node Aligning lyrics to a melody
+@subsection Aligning lyrics to a melody
+
+Music glossary: @rglos{melisma}, @rglos{extender line}.
+
 @cindex melisma
 @cindex extender line
-This melody ends on a @rglos{melisma}, a single syllable (@q{free})
-sung to more than one note.  This is indicated with an @emph{extender
-line}.  It is entered as two underscores @code{__}:
+@cindex hyphens
+@cindex underscore
 
-@lilypond[quote,ragged-right,verbatim]
+The next line in the nursery rhyme is @q{The moon doth shine as
+bright as day}.  Let's extend it:
+
+@lilypond[verbatim,quote,ragged-right]
 <<
   \relative c'' {
-    a4 e c8 e r4
-    b2 c4( d)
+    \key g \major
+    \time 6/8
+    d4 b8 c4 a8 d4 b8 g4 
+    g8 a4 b8 c b a d4 b8 g4.
+  }
+  \addlyrics {
+    Girls and boys come out to play,
+    The moon doth shine as bright as day;
   }
-  \addlyrics { One day this shall be free __ }
 >>
 @end lilypond
 
-Similarly, hyphens between words can be entered as two dashes,
-resulting in a centered hyphen between two syllables
+We see the extra lyrics do not align properly with the notes.  The
+word @q{shine} should be sung on two notes, not one.  This is
+called a @notation{melisma}, a single syllable sung to more than one
+note.  There are several ways to spread a syllable over multiple
+notes, the simplest being to add a slur across them (see @ref{Ties
+and slurs}):
 
-@c no ragged-right here because otherwise the hypens get lost.
-@lilypond[quote,verbatim]
+@lilypond[verbatim,quote,ragged-right]
 <<
-  \relative c' {
-    \time 2/4
-    f4 f c c
+  \relative c'' {
+    \key g \major
+    \time 6/8
+    d4 b8 c4 a8 d4 b8 g4 
+    g8 a4 b8 c([ b)] a d4 b8 g4.
   }
-  \addlyrics { A -- le -- gri -- a }
->>
+  \addlyrics {
+    Girls and boys come out to play,
+    The moon doth shine as bright as day;
+  }
+>> 
 @end lilypond
 
-@moreinfo
-@quotation
-More options, such as putting multiple stanzas below a melody, are
-discussed in @ref{Vocal music}.
-@end quotation
+Here we have also used manual beaming (the square brackets @code{[
+]} ) to generate the beaming which is customarily used with lyrics
+(see @ref{Automatic and manual beams}).
 
+If a syllable extends over several notes or a single very long
+note an @notation{extender line} is usually drawn from the syllable
+extending under all the notes for that syllable.  It is entered as
+two underscores @code{__}.  Here is an example from the first
+three bars of Dido's Lament, from Purcell's Dido and Æneas:
 
-@node A lead sheet
-@subsection A lead sheet
-
-@cindex Lead sheets
-@cindex chords
-@cindex chord names
+@lilypond[verbatim,quote,ragged-right]
+<<
+  \relative c'' {
+    \key g \minor
+    \time 3/2
+    g2 a bes bes( a) 
+    b c4.( bes8 a4. g8 fis4.) g8 fis1
+  }
+  \addlyrics {
+    When I am laid, 
+    am laid __ in earth,
+  }
+>>
+@end lilypond
 
-In popular music it is common to denote accompaniment with chord names.
-Such chords can be entered like notes,
+None of the examples so far have involved words containing more
+than one syllable.  Such words are usually split one syllable to a
+note, with hyphens between syllables.  Such hyphens are entered as
+two dashes, resulting in a centered hyphen between the syllables.
+Here is an example showing this and everything we have learned so
+far about aligning lyrics to notes.
 
-@lilypond[quote,ragged-right,verbatim]
-\chordmode { c2 f4. g8 }
+@c no ragged-right here because otherwise the hyphens get lost,
+@c but the example is long enough to avoid looking strange.
+@lilypond[verbatim,quote]
+<<
+  \relative c' {
+    \key g \major
+    \time 3/4
+    \partial 4
+    d4 g4 g a8( b) g4 g4 
+    b8( c) d4 d e4 c2
+  }
+  \addlyrics {
+    A -- way in a __ man -- ger, 
+    no __ crib for a bed, __
+  }
+>>
 @end lilypond
 
-Now each pitch is read as the root of a chord instead of a note.
-This mode is switched on with @code{\chordmode}.  Other chords can be
-created by adding modifiers after a colon.  The
-following example shows a few common modifiers:
-
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
+Some lyrics, especially those in Italian, require the opposite:
+setting more than one syllable to a single note.  This is
+achieved by linking the syllables together with a single
+underscore @code{_} (with no spaces), or enclosing them in
+quotes.  Here's an example from Rossini's Figaro, where
+@q{al} has to be sung on the same note as the @q{go} of 
+@q{Largo} in Figaro's aria @q{Largo al factotum}:
+
+@c no ragged-right here because otherwise the hyphens get lost,
+@c but the example is long enough to avoid looking strange.
+@lilypond[verbatim,quote]
+<<
+  \relative c' {
+    \clef bass
+    \key c \major
+    \time 6/8
+    c4.~ c8 d b c([ d)] b c d b c
+  }
+  \addlyrics {
+    Lar -- go_al fac -- to -- tum del -- la cit -- tà
+  }
+>>
 @end lilypond
 
-For lead sheets, chords are not printed on staves, but as names on a
-line for themselves.  This is achieved by using @code{\chords} instead
-of @code{\chordmode}.  This uses the same syntax as @code{\chordmode},
-but renders the notes in a @code{ChordNames} context, with the
-following result:
 
-@lilypond[quote,verbatim,ragged-right]
-\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
-@end lilypond
+@seealso
+@quotation
+More options, such as inserting explicit rhythms into lyrics,
+inserting lyric ties (e.g., between @q{go al}) above, 
+alternative ways of handling melismata,
+and adding extra verses,
+are discussed in @ruser{Vocal music}.
+@end quotation
 
-@cindex lead sheet
-When put together, chord names, lyrics and a melody form
-a lead sheet,
+@node Lyrics to multiple staves
+@subsection Lyrics to multiple staves
 
-@lilypond[quote,verbatim,ragged-right]
+The simple approach using @code{\addlyrics} can be used for
+placing lyrics under more than one staff.  Here is an
+example from Handel's Judas Maccabæus:
+
+@lilypond[verbatim,quote,ragged-right]
 <<
-  \chords { c2 g:sus4 f e }
+  {
+    \time 6/8
+    \partial 8
+  }
   \relative c'' {
-    a4 e c8 e r4
-    b2 c4( d)
+    \key f \major
+    c8 c([ bes)] a a([ g)] f f'4. b, c4.~ c4
+  }
+  \addlyrics {
+    Let flee -- cy flocks the hills a -- dorn, __
+  }
+  \relative c' {
+    \key f \major
+    r8 r4. r4 c8 a'([ g)] f f([ e)] d e([ d)] c bes'4
+  }
+  \addlyrics {
+    Let flee -- cy flocks the hills a -- dorn,
   }
-  \addlyrics { One day this shall be free __ }
 >>
 @end lilypond
 
+but scores any more complex than this simple example are
+better produced by separating out the staff structure
+from the notes and lyrics with variables.  These are
+discussed later (see @ref{Organizing pieces with variables}).
 
-@moreinfo
+@seealso
 @quotation
-A complete list of modifiers and other options for layout can be found
-in @ref{Chords}.
+More options, such as putting multiple stanzas below the score,
+setting choral music, and lyrics to divided voices, 
+are discussed in @ruser{Vocal music}.
 @end quotation
 
 
 @node Final touches
 @section Final touches
 
-This is the final section of the tutorial; it demonstrates how to add the
-final touches to simple pieces, and provides an introduction to the rest
-of the manual.
+This is the final section of the tutorial; it demonstrates how to
+add the final touches to simple pieces, and provides an
+introduction to the rest of the manual.
 
 @menu
 * Version number::              
 * Adding titles::               
 * Absolute note names::         
-* Organizing pieces with identifiers::  
+* Organizing pieces with variables::  
 * After the tutorial::          
 * How to read the manual::      
 @end menu
@@ -1281,29 +1477,30 @@ of the manual.
 @subsection Version number
 
 @cindex versioning
-The @code{\version} statement records the version of LilyPond that was
-used to write the file:
+The @code{\version} statement records the version of LilyPond that
+was used to write the file:
 
 @example
 \version "2.11.23"
 @end example
 
 @noindent
-by convention, this is placed at the top of your LilyPond file.
+By convention, this is placed at the top of your LilyPond file.
 
-These annotations make future upgrades of LilyPond go more smoothly.
-Changes in the syntax are handled with a special program,
-@file{convert-ly} (see @rprogram{Updating files with convert-ly}), and
-it uses @code{\version} to determine what rules to apply.
+These annotations make future upgrades of LilyPond go more
+smoothly.  Changes in the syntax are handled with a special
+program, @file{convert-ly}, and it uses @code{\version} to
+determine what rules to apply.  For details, see
+@rprogram{Updating files with convert-ly}.
 
 
 @node Adding titles
 @subsection Adding titles
 
-The title, composer, opus number, and similar information are entered
-in the @code{\header} block.  This exists outside of the main
-music expression; the @code{\header} block is usually placed underneath
-the @ref{Version number}.
+The title, composer, opus number, and similar information are
+entered in the @code{\header} block.  This exists outside of the
+main music expression; the @code{\header} block is usually placed
+underneath the @ref{Version number}.
 
 @example
 \version "2.11.23"
@@ -1318,24 +1515,25 @@ the @ref{Version number}.
 @}
 @end example
 
-When the file is processed, the title and composer are printed above
-the music.  More information on titling can be found in @ref{Creating
-titles}.
+When the file is processed, the title and composer are printed
+above the music.  More information on titling can be found in
+@ruser{Creating titles}.
 
 
 @node Absolute note names
 @subsection Absolute note names
 
-So far we have always used @code{\relative} to define pitches.  This is
-the easiest way to enter most music, but another way of defining pitches
-exists: absolute mode.
+So far we have always used @code{\relative} to define pitches.
+This is the easiest way to enter most music, but another way of
+defining pitches exists: absolute mode.
 
 If you omit the @code{\relative}, LilyPond treats all pitches as
-absolute values.  A @code{c'} will always mean middle C, a @code{b} will
-always mean the note one step below middle C, and a @code{g,} will
-always mean the note on the bottom staff of the bass clef.
+absolute values.  A @code{c'} will always mean middle C, a
+@code{b} will always mean the note one step below middle C, and a
+@code{g,} will always mean the note on the bottom staff of the
+bass clef.
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 {
   \clef bass
   c' b g, g,
@@ -1345,7 +1543,7 @@ always mean the note on the bottom staff of the bass clef.
 
 Here is a four-octave scale:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 {
   \clef bass
   c, d, e, f,
@@ -1360,10 +1558,10 @@ Here is a four-octave scale:
 }
 @end lilypond
 
-As you can see, writing a melody in the treble clef involves a lot of
-quote ' marks.  Consider this fragment from Mozart:
+As you can see, writing a melody in the treble clef involves a lot
+of quote @code{'} marks.  Consider this fragment from Mozart:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 {
   \key a \major
   \time 6/8
@@ -1372,11 +1570,11 @@ quote ' marks.  Consider this fragment from Mozart:
 }
 @end lilypond
 
-All these quotes makes the input less readable and it is a source of
-errors.  With @code{\relative}, the previous example is much easier
-to read:
+All these quotes makes the input less readable and it is a source
+of errors.  With @code{\relative}, the previous example is much
+easier to read:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 \relative c'' {
   \key a \major
   \time 6/8
@@ -1385,25 +1583,29 @@ to read:
 }
 @end lilypond
 
-If you make a mistake with an octave mark (@code{'} or @code{,}) while
-working in @code{\relative} mode, it is very obvious -- many notes will
-be in the wrong octave.  When working in absolute mode, a single mistake
-will not be as visible, and will not be as easy to find.
+If you make a mistake with an octave mark (@code{'} or @code{,})
+while working in @code{\relative} mode, it is very obvious -- many
+notes will be in the wrong octave.  When working in absolute mode,
+a single mistake will not be as visible, and will not be as easy
+to find.
 
-However, absolute mode is useful for music which has large intervals, and
-is extremely useful for computer-generated LilyPond files.
+However, absolute mode is useful for music which has large
+intervals, and is extremely useful for computer-generated LilyPond
+files.
 
 
-@node Organizing pieces with identifiers
-@subsection Organizing pieces with identifiers
+@node Organizing pieces with variables
+@subsection Organizing pieces with variables
 
 When all of the elements discussed earlier are combined to produce
-larger files, the music expressions get a lot bigger.  In polyphonic
-music with many staves, the input files can become very confusing.  We can
-reduce this confusion by using @emph{identifiers}.
+larger files, the music expressions get a lot bigger.  In
+polyphonic music with many staves, the input files can become very
+confusing.  We can reduce this confusion by using
+@emph{variables}.
 
-With identifiers (also known as variables or macros), we can break up
-complex music expressions.  An identifier is assigned as follows
+With variables (also known as identifiers or macros), we can break
+up complex music expressions.  An variable is assigned as
+follows:
 
 @example
 namedMusic = @{ @dots{} @}
@@ -1411,10 +1613,11 @@ namedMusic = @{ @dots{} @}
 
 The contents of the music expression @code{namedMusic} can be used
 later by placing a backslash in front of the name
-(@code{\namedMusic}, just like a normal LilyPond command).  Identifiers
-must be defined @emph{before} the main music expression.
+(@code{\namedMusic}, just like a normal LilyPond command).
+Variables must be defined @emph{before} the main music
+expression.
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote,ragged-right]
 violin = \new Staff { \relative c'' {
   a4 b c b
 }}
@@ -1431,11 +1634,11 @@ cello = \new Staff { \relative c {
 @end lilypond
 
 @noindent
-The name of an identifier must have alphabetic characters only: no
+The name of an variable must have alphabetic characters only, no
 numbers, underscores, or dashes.
 
-It is possible to use variables for many other types of objects in the
-input.  For example,
+It is possible to use variables for many other types of objects in
+the input.  For example,
 
 @example
 width = 4.5\cm
@@ -1443,7 +1646,7 @@ name = "Wendy"
 aFivePaper = \paper @{ paperheight = 21.0 \cm @}
 @end example
 
-Depending on its contents, the identifier can be used in different
+Depending on its contents, the variable can be used in different
 places.  The following example uses the above variables:
 
 @example
@@ -1459,41 +1662,42 @@ places.  The following example uses the above variables:
 @subsection After the tutorial
 
 After finishing the tutorial, you should probably try writing a
-piece or two.  Start with one of the @ref{Templates}, and
-add notes.  If you need any notation that was not covered in the
+piece or two.  Start by adding notes to one of the @ref{Templates}.
+If you need any notation that was not covered in the
 tutorial, look at the Notation Reference, starting with
-@ref{Basic notation}.  If you want to write for an instrument
-ensemble that is not covered in the templates,
-take a look at @ref{Extending the templates}.
+@ruser{Musical notation}.  If you want to write for an instrument
+ensemble that is not covered in the templates, take a look at
+@ref{Extending the templates}.
 
-Once you have written a few short pieces, read the rest of
-the Learning Manual (chapters 3-5).  There's nothing wrong
-with reading it now, of course!  However, the rest of the
-Learning Manual assumes that you are familiar with
-LilyPond input.  You may wish to skim these chapters right
-now, and come back to them after you have more experience.
+Once you have written a few short pieces, read the rest of the
+Learning Manual (chapters 3-5).  There's nothing wrong with
+reading it now, of course!  However, the rest of the Learning
+Manual assumes that you are familiar with LilyPond input.  You may
+wish to skim these chapters right now, and come back to them after
+you have more experience.
 
 
 @node How to read the manual
 @subsection How to read the manual
 
-As we saw in @ref{How to read the tutorial}, many examples in the
-tutorial omitted a @code{\relative c'' @{ ... @}} around the printed
-example.
+Many examples in the tutorial omitted a @code{\relative c'' @{
+... @}} around the printed example, as we saw in
+@ref{How to read the tutorial}.
 
-In the rest of the manual, we are much more lax about the
-printed examples: sometimes they may have omitted a
-@code{\relative c'' @{ ... @}}, but other times a different initial
-pitch may be used (such as @code{c'} or @code{c,,}), and in some cases
-the whole example is in absolute note mode!  However, ambiguities like
-this only exist where the pitches are not important.  In any example
-where the pitch matters, we have explicitly stated @code{\relative}
-or absolute-mode @code{@{ @}}.
+In the rest of the manual, we are much more lax about the printed
+examples: sometimes they may have omitted a @code{\relative c'' @{
+... @}}, but other times a different initial pitch may be used
+(such as @code{c'} or @code{c,,}), and in some cases the whole
+example is in absolute note mode!  However, ambiguities like this
+only exist where the pitches are not important.  In any example
+where the pitch matters, we have explicitly stated
+@code{\relative} or absolute-mode @code{@{ @}}.
 
 If you are still confused about the exact LilyPond input that was
-used in an example, read the HTML version (if you are not already doing
-so) and click on the picture of the music.  This will display the exact
-input that LilyPond used to generate this manual.
+used in an example, read the HTML version (if you are not already
+doing so) and click on the picture of the music.  This will
+display the exact input that LilyPond used to generate this
+manual.
 
 For information about the structure of the rest of the manual, see
 @ref{About this manual}.
diff --git a/Documentation/user/tweaks.itely b/Documentation/user/tweaks.itely
index eb03d1f699..bc7efc796a 100644
--- a/Documentation/user/tweaks.itely
+++ b/Documentation/user/tweaks.itely
@@ -1,5 +1,5 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
@@ -13,28 +13,33 @@
 This chapter discusses how to modify output.  LilyPond is extremely
 configurable; virtually every fragment of output may be changed.
 
+TODO: explain what/why.  maybe in other sections.
+
+@menu
+* Common tweaks::               
+* TODO other name::             
+@end menu
+
+
+@node Common tweaks
+@section Common tweaks
+
+blah blah
 
 @menu
 * Moving objects::              
 * Fixing overlapping notation::  
-* Common tweaks::               
-* Default files::               
+* Other common tweaks::         
 * Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
 @end menu
 
-
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 This may come as a surprise, but LilyPond is not perfect.  Some notation
 elements can overlap.  This is unfortunate, but (in most cases) is easily
 solved.
 
-@c  FIXME: find a better example for 5.1 Moving Objects.  -gp
-@c  yes, I want this TODO to be visible to end-users.  It's better
-@c  than having nothing at all.
 TODO: with the new spacing features in 2.12, these specific examples are no
 longer relevant.  However, they still demonstrate powerful features
 of lilypond, so they remain until somebody creates some better examples.
@@ -52,7 +57,7 @@ The easiest solution is to increase the distance between the object
 instead) and the note.  In LilyPond, this is called the
 @code{padding} property; it is measured in staff spaces.  For most
 objects, this value is around 1.0 or less (it varies with each
-object). We want to increase it, so let's try 1.5
+object).  We want to increase it, so let's try 1.5
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
   % temporary code to break this example:
@@ -135,7 +140,7 @@ no text, this tweak does nothing (and does @strong{not} wait until
 the next bit of text).  To change the behavior of everything after
 the command, omit the @code{\once}.  To stop this tweak, use a
 @code{\revert}.  This is explained in depth in
-@ref{The \override command}.
+@ruser{The \override command}.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
   % temporary code to break this example:
@@ -157,11 +162,11 @@ c4^"piu mosso" d e f
 
 @seealso
 
-This manual: @ref{The \override command}, @ref{Common tweaks}.
+This manual: @ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 In @ref{Moving objects}, we saw how to move a @code{TextScript}
 object.  The same mechanism can be used to move other types of
@@ -170,7 +175,7 @@ another object.
 
 To find the object name, look at the @q{@strong{see also}} at
 bottom of the relevant documentation page.  For example, at
-the bottom of @ref{Dynamics}, we see
+the bottom of @ruser{Dynamics}, we see
 
 @quotation
 @seealso
@@ -203,8 +208,8 @@ common objects.
 @end multitable
 
 
-@node Common tweaks
-@section Common tweaks
+@node Other common tweaks
+@subsection Other common tweaks
 
 Some overrides are so common that predefined commands are provided as
 short-cuts, such as @code{\slurUp} and @code{\stemDown}.  These
@@ -216,7 +221,7 @@ object (like slurs or beams) are documented in the Program
 Reference.  However, many layout objects share properties which can be
 used to apply generic tweaks.
 
-@itemize @bullet
+@itemize
 
 @cindex padding
 
@@ -247,7 +252,7 @@ Note in the second example how important it is to figure out what
 context handles a certain object.  Since the @code{MetronomeMark} object
 is handled in the @code{Score} context, property changes in the
 @code{Voice} context will not be noticed.  For more details, see
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
 
 @cindex extra-offset
 
@@ -333,42 +338,8 @@ are measured in staff-spaces.  For more information, see the
 relevant portion of the program reference.
 
 
-@node Default files
-@section Default files
-
-The Program Reference documentation contains a lot of information
-about LilyPond, but even more information can be gathered from
-looking at the internal LilyPond files.
-
-Some default settings (such as the definitions for
-@code{\header@{@}}s) are stored as @code{.ly} files.  Other
-settings (such as the definitions of markup commands) are
-stored as @code{.scm} (Scheme) files.  Further explanation is
-outside the scope of this manual; users should be warned that
-a substantial amount of technical knowledge or time is required
-to understand these files.
-
-@itemize @bullet
-
-@item Linux: @file{@var{installdir}/lilypond/usr/share/lilypond/current/}
-
-@item OSX:
-@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
-To access this, either @code{cd} into this directory from the
-Terminal, or control-click on the LilyPond application and select
-@q{Show Package Contents}.
-
-@item Windows: @file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
-
-@end itemize
-
-The @file{ly/} and @file{scm/} directories will be of
-particular interest.  Files such as @file{ly/property-init.ly} and
-@file{ly/declarations-init.ly} define all the common tweaks.
-
-
 @node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
+@subsection Fitting music onto fewer pages
 
 Sometimes you can end up with one or two staves on a second
 (or third, or fourth...) page.  This is annoying, especially
@@ -377,7 +348,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 @ref{Displaying spacing}, for more
+layout spacing commands; see @ruser{Displaying spacing}, for more
 details.  From the output of @code{annotate-spacing}, we can
 see which margins we may wish to alter.
 
@@ -431,7 +402,7 @@ a system.
 
 @item
 Alter the horizontal spacing via @code{SpacingSpanner}.  See
-@ref{Changing horizontal spacing}, for more details.
+@ruser{Changing horizontal spacing}, for more details.
 
 @lilypond[verbatim,quote]
 \score {
@@ -454,15 +425,59 @@ Alter the horizontal spacing via @code{SpacingSpanner}.  See
 @end itemize
 
 
+@node TODO other name
+@section TODO other name
+
+@menu
+* Default files::               
+* Advanced tweaks with Scheme::  
+* Avoiding tweaks with slower processing::  
+* The three methods of tweaking::  
+@end menu
+
+@node Default files
+@subsection Default files
+
+The Program Reference documentation contains a lot of information
+about LilyPond, but even more information can be gathered from
+looking at the internal LilyPond files.
+
+Some default settings (such as the definitions for
+@code{\header@{@}}s) are stored as @code{.ly} files.  Other
+settings (such as the definitions of markup commands) are
+stored as @code{.scm} (Scheme) files.  Further explanation is
+outside the scope of this manual; users should be warned that
+a substantial amount of technical knowledge or time is required
+to understand these files.
+
+@itemize
+
+@item Linux: @file{@var{installdir}/lilypond/usr/share/lilypond/current/}
+
+@item OSX:
+@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
+To access this, either @code{cd} into this directory from the
+Terminal, or control-click on the LilyPond application and select
+@q{Show Package Contents}.
+
+@item Windows: @file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
+
+@end itemize
+
+The @file{ly/} and @file{scm/} directories will be of
+particular interest.  Files such as @file{ly/property-init.ly} and
+@file{ly/declarations-init.ly} define all the common tweaks.
+
+
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 We have seen how LilyPond output can be heavily modified using
 commands like
 @code{\override TextScript #'extra-offset = ( 1 . -1)}.  But
 we have even more power if we use Scheme.  For a full explantion
 of this, see the @ref{Scheme tutorial}, and
-@ref{Interfaces for programmers}.
+@ruser{Interfaces for programmers}.
 
 We can use Scheme to simply @code{\override} commands,
 
@@ -515,7 +530,7 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 
 
 @node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
 LilyPond can perform extra checks while it processes files.  These
 commands will take extra time, but the result may require fewer
@@ -524,7 +539,43 @@ manual tweaks.
 @example
 %%  makes sure text scripts and lyrics are within the paper margins
 \override Score.PaperColumn #'keep-inside-line = ##t 
+\override Score.NonMusicalPaperColumn #'keep-inside-line = ##t
 @end example
 
+In some cases (see issue 246), this must be done before
+@code{\override} commands can be processed.
+
+@verbatim
+\new Score \with {
+    \override PaperColumn #'keep-inside-line = ##t 
+    \override NonMusicalPaperColumn #'keep-inside-line = ##t
+  } {
+   ..
+}
+@end verbatim
+
+
+@node The three methods of tweaking
+@subsection The three methods of tweaking
+
+TODO write this.
+
+@verbatim
+\override
+@end verbatim
+
+@verbatim
+\with {
+
+}
+@end verbatim
+
+@verbatim
+\layout{ \context
+
+}}
+@end verbatim
+
+
 
 
diff --git a/Documentation/user/vocal.itely b/Documentation/user/vocal.itely
new file mode 100644
index 0000000000..6830cf42d2
--- /dev/null
+++ b/Documentation/user/vocal.itely
@@ -0,0 +1,1070 @@
+@c -*- coding: utf-8; mode: texinfo; -*-
+@ignore
+    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+    When revising a translation, copy the HEAD committish of the
+    version that you are working on.  See TRANSLATION for details.
+@end ignore
+
+@node Vocal music
+@section Vocal music
+
+Since LilyPond input files are text, there are two issues to
+consider when working with vocal music:
+
+@itemize
+@item
+Song texts must be entered as text, not notes.  For example, the
+input@tie{}@code{d} should be interpreted as a one letter syllable, not the
+note@tie{}D.
+
+@item
+Song texts must be aligned with the notes of their melody.
+@end itemize
+
+There are a few different ways to define lyrics; we shall begin
+by examining the simplest method, and gradually increase complexity.
+
+@menu
+* TODO subsection vocal music::  
+@end menu
+
+
+@commonprop
+
+Checking to make sure that text scripts and lyrics are within the margins is
+a relatively large computational task.  To speed up processing, lilypond does
+not perform such calculations by default; to enable it, use
+
+@example
+\override Score.PaperColumn #'keep-inside-line = ##t
+@end example
+
+To make lyrics avoid barlines as well, use
+@example
+\layout @{
+  \context @{
+    \Lyrics
+      \consists "Bar_engraver"
+      \consists "Separating_line_group_engraver"
+      \override BarLine #'transparent = ##t
+  @}
+@}
+@end example
+
+
+@node TODO subsection vocal music
+@subsection TODO subsection vocal music
+
+@menu
+* Setting simple songs::        
+* Entering lyrics::             
+* Aligning lyrics to a melody::  
+* Automatic syllable durations::  
+* Another way of entering lyrics::  
+* Assigning more than one syllable to a single note::  
+* More than one note on a single syllable::  
+* Extenders and hyphens::       
+* Working with lyrics and variables::  
+* Flexibility in placement::    
+* Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Lyrics independent of notes::  
+* Spacing lyrics::              
+* More about stanzas::          
+* Other vocal issues::          
+@end menu
+
+@node Setting simple songs
+@unnumberedsubsubsec Setting simple songs
+
+@cindex \addlyrics
+
+The easiest way to add lyrics to a melody is to append
+
+@example
+\addlyrics @{ @var{the lyrics} @}
+@end example
+
+@noindent
+to a melody.  Here is an example,
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+@end lilypond
+
+More stanzas can be added by adding more
+@code{\addlyrics} sections
+
+@lilypond[ragged-right,verbatim,fragment,quote]
+\time 3/4
+\relative { c2 e4 g2. }
+\addlyrics { play the game }
+\addlyrics { speel het spel }
+\addlyrics { joue le jeu }
+@end lilypond
+
+The command @code{\addlyrics} cannot handle polyphony settings.  For these
+cases you should use @code{\lyricsto} and @code{\lyricmode}, as will be
+introduced in @ref{Entering lyrics}.
+
+
+
+@node Entering lyrics
+@unnumberedsubsubsec Entering lyrics
+
+@cindex lyrics
+@funindex \lyricmode
+@cindex punctuation
+@cindex spaces, in lyrics
+@cindex quotes, in lyrics
+
+Lyrics are entered in a special input mode, which can be introduced
+by the keyword @code{\lyricmode}, or by using @code{\addlyrics} or
+@code{\lyricsto}.  In this mode you can enter lyrics,
+with punctuation and accents, and the input @code{d} is not parsed as
+a pitch, but rather as a one letter syllable.  Syllables are entered
+like notes, but with pitches replaced by text.  For example,
+
+@example
+\lyricmode @{ Twin-4 kle4 twin- kle litt- le star2 @}
+@end example
+
+There are two main methods to specify the horizontal placement
+of the syllables, either by specifying the duration of each syllable
+explicitly, like in the example above, or by automatically aligning
+the lyrics to a melody or other voice of music, using @code{\addlyrics}
+or @code{\lyricsto}.
+@c  TODO: broken
+@c For more details see @ref{The Lyrics context}.
+
+A word or syllable of lyrics begins with an alphabetic character, and ends
+with
+any space or digit.  The following characters can be any character
+that is not a digit or white space.
+
+Any character that is not a digit or white space will be regarded as
+part of the syllable; one important consequence of this is that a word
+can end with @code{@}}, which often leads to the following mistake:
+
+@example
+\lyricmode @{ lah- lah@}
+@end example
+
+In this example, the @code{@}} is included in the final syllable, so the
+opening brace is not balanced and the input file will probably not
+compile.
+
+
+@funindex \property in \lyricmode
+
+@noindent
+Similarly, a period which follows an alphabetic sequence is included in
+the resulting string.  As a consequence, spaces must be inserted around
+property commands: do @emph{not} write
+
+@example
+\override Score.LyricText #'font-shape = #'italic
+@end example
+
+@noindent
+but instead use
+
+@example
+\override Score . LyricText #'font-shape = #'italic
+@end example
+
+@funindex _
+@cindex spaces, in lyrics
+@cindex quotes, in lyrics
+@cindex ties, in lyrics
+
+In order to assign more than one syllable to a single note, you can
+surround them with quotes or use a @code{_} character, to get spaces
+between syllables, or use tilde  symbol (@code{~}) to get a lyric tie.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+The lyric tie is implemented with the Unicode character U+203F, so be
+sure to have a font (Like DejaVuLGC) installed that includes this
+glyph.
+
+
+To enter lyrics with characters from non-English languages, or with
+accented and special characters (such as the heart symbol or slanted quotes),
+simply insert the characters directly into the input file and save
+it with utf-8 encoding.  See @ref{Text encoding}, for more info.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative { e4 f e d e f e2 }
+\addlyrics { He said: “Let my peo ple go”. }
+@end lilypond
+
+To use normal quotes in lyrics, add a backslash before the
+quotes.  For example,
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' { \time 3/4 e4 e4. e8 d4 e d c2. }
+\addlyrics { "\"I" am so lone- "ly\"" said she }
+@end lilypond
+
+The full definition of a word start in Lyrics mode is somewhat more
+complex.
+
+A word in Lyrics mode begins with: an alphabetic character, @code{_},
+@code{?}, @code{!}, @code{:}, @code{'}, the control characters @code{^A}
+through @code{^F}, @code{^Q} through @code{^W}, @code{^Y}, @code{^^},
+any 8-bit character with ASCII code over 127, or a two-character
+combination of a backslash followed by one of @code{`}, @code{'},
+@code{"}, or @code{^}.
+
+To define variables containing lyrics, the function @code{lyricmode}
+must be used.
+
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+  <<
+    \new Voice = "one" \relative c'' @{
+      \autoBeamOff
+      \time 2/4
+      c4 b8. a16 g4. f8 e4 d c2
+    @}
+    \addlyrics @{ \verseOne @}
+  >>
+@}
+@end example
+
+
+@seealso
+
+Program reference: @internalsref{LyricText}, @internalsref{LyricSpace}.
+
+
+
+@node Aligning lyrics to a melody
+@unnumberedsubsubsec Aligning lyrics to a melody
+
+@funindex \lyricmode
+@funindex \addlyrics
+@funindex \lyricsto
+
+
+Lyrics are printed by interpreting them in the context called
+@internalsref{Lyrics}.
+
+@example
+\new Lyrics \lyricmode @dots{}
+@end example
+
+There are two main methods to specify the horizontal placement
+of the syllables:
+
+@itemize
+@item
+by automatically aligning
+the lyrics to a melody or other voice of music, using @code{\addlyrics}
+or @code{\lyricsto}.
+
+@item
+or by specifying the duration of each syllable
+explicitly, using @code{\lyricmode}
+@end itemize
+
+@menu
+* Automatic syllable durations::  
+* Another way of entering lyrics::  
+* Assigning more than one syllable to a single note::  
+* More than one note on a single syllable::  
+* Extenders and hyphens::       
+@end menu
+
+@node Automatic syllable durations
+@unnumberedsubsubsec Automatic syllable durations
+
+@cindex automatic syllable durations
+@cindex lyrics and melodies
+
+The lyrics can be aligned under a given melody
+automatically.  This is achieved by combining the
+melody and the lyrics with the @code{\lyricsto} expression
+
+@example
+\new Lyrics \lyricsto @var{name} @dots{}
+@end example
+
+This aligns the lyrics to the
+notes of the @internalsref{Voice} context called @var{name}, which must
+already exist.  Therefore normally the @code{Voice} is specified first, and
+then the lyrics are specified with @code{\lyricsto}.  The command
+@code{\lyricsto} switches to @code{\lyricmode} mode automatically, so the
+@code{\lyricmode} keyword may be omitted.
+
+The following example uses different commands for entering lyrics.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+<<
+  \new Voice = "one" \relative c'' {
+    \autoBeamOff
+    \time 2/4
+    c4 b8. a16 g4. f8 e4 d c2
+  }
+  \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
+  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
+  \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
+>>
+@end lilypond
+
+The second stanza is not properly aligned because the durations
+were not specified.  A solution for that would be to use @code{\lyricsto}.
+
+The @code{\addlyrics} command is actually just a convenient way
+to write a more complicated LilyPond structure that sets up the
+lyrics.
+
+@example
+@{ MUSIC @}
+\addlyrics @{ LYRICS @}
+@end example
+
+@noindent
+is the same as
+
+@example
+\new Voice = "blah" @{ music @}
+\new Lyrics \lyricsto "blah" @{ LYRICS @}
+@end example
+
+@node Another way of entering lyrics
+@unnumberedsubsubsec Another way of entering lyrics
+
+Lyrics can also be entered without @code{\addlyrics} or
+@code{\lyricsto}.  In this case,
+syllables are entered like notes -- but with pitches replaced by text -- and the
+duration of each syllable must be entered explicitly.  For example:
+ 
+@example
+play2 the4 game2.
+sink2 or4 swim2.
+@end example
+ 
+The alignment to a melody can be specified with the
+@code{associatedVoice} property,
+ 
+@example
+\set associatedVoice = #"lala"
+@end example
+ 
+@noindent
+The value of the property (here: @code{"lala"}) should be the name of
+a @internalsref{Voice} context.  Without this setting, extender lines
+will not be formatted properly.
+ 
+Here is an example demonstrating manual lyric durations,
+ 
+@lilypond[relative=1,ragged-right,verbatim,fragment,quote]
+<< \new Voice = "melody" {
+    \time 3/4
+    c2 e4 g2.
+ }
+ \new Lyrics \lyricmode {
+   \set associatedVoice = #"melody"
+   play2 the4 game2.
+ } >>
+@end lilypond
+
+@seealso
+ 
+Program reference: @internalsref{Lyrics}.
+
+
+@node Assigning more than one syllable to a single note
+@unnumberedsubsubsec Assigning more than one syllable to a single note
+
+
+@funindex _
+@cindex ties, in lyrics
+
+In order to assign more than one syllable to a single note, you can
+surround them with quotes or use a @code{_} character, to get spaces
+between syllables, or use tilde  symbol (@code{~}) to get a lyric
+tie@footnote{The lyric ties is implemented with the Unicode character
+U+203F, so be
+sure to have a font (Like DejaVuLGC) installed that includes this
+glyph.}.
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+\time 3/4
+\relative { c2 e4 g2 e4 }
+\addlyrics { gran- de_a- mi- go }
+\addlyrics { pu- "ro y ho-" nes- to }
+\addlyrics { pu- ro~y~ho- nes- to }
+@end lilypond
+
+@seealso
+
+Program reference: @internalsref{LyricCombineMusic}.
+
+@c Here come the section which used to be "Melismata"
+@c the new title might be more self-explanatory
+
+
+@node More than one note on a single syllable
+@unnumberedsubsubsec More than one note on a single syllable
+
+@cindex melisma
+@cindex melismata
+@cindex phrasing, in lyrics
+
+Sometimes, particularly in Medieval music, several notes are to be sung on one
+single syllable; such vocalises are called melismas, or melismata.
+
+@c this method seems to be the simplest; therefore
+@c it might be better to present it first - vv
+
+You can define melismata entirely in the lyrics, by entering @code{_}
+for every note
+that is part of the melisma.
+
+@lilypond[relative=1,verbatim,fragment,quote]
+{ \set melismaBusyProperties = #'()
+ c d( e) f f( e) e e  }
+\addlyrics
+ { Ky -- _ _ ri __ _ _ _  e }
+@end lilypond
+
+In this case, you can also have ties and slurs in the melody if you
+set @code{melismaBusyProperties}, as is done in the example above.
+
+However, the @code{\lyricsto} command can also
+detect melismata automatically: it only puts one
+syllable under a tied or slurred group of notes.  If you want to force
+an unslurred group of notes to be a melisma, insert @code{\melisma}
+after the first note of the group, and @code{\melismaEnd} after the
+last one, e.g.,
+
+@lilypond[quote,relative=2,ragged-right,fragment,verbatim]
+<<
+  \new Voice = "lala" {
+    \time 3/4
+    f4 g8
+    \melisma
+    f e f
+    \melismaEnd
+    e2
+  }
+  \new Lyrics \lyricsto "lala" {
+    la di __ daah
+  }
+>>
+@end lilypond
+
+In addition, notes are considered a melisma if they are manually
+beamed, and automatic beaming (see @ref{Setting automatic beam
+behavior}) is switched off.
+
+@c TODO: there might be some more relevant place for 
+@c the following link (?)
+
+@cindex SATB
+@cindex choral score
+
+A complete example of a SATB score setup is in section
+@rlearning{Vocal ensembles}.
+
+
+@refcommands
+
+@code{\melisma}, @code{\melismaEnd}
+@funindex \melismaEnd
+@funindex \melisma
+
+@seealso
+
+Program reference: @internalsref{Melisma_translator}.
+
+@lsr{vocal,lyric@/-combine.ly}.
+
+@refbugs
+
+Melismata are not detected automatically, and extender lines must be
+inserted by hand.
+
+@node Extenders and hyphens
+@unnumberedsubsubsec Extenders and hyphens
+
+@cindex melisma
+@cindex extender
+
+Melismata are indicated with a horizontal line centered between a syllable
+and the next one.  Such a line is called an extender line, and it is entered
+as @samp{ __ } (note the spaces before and after the two underscore
+characters).
+
+@cindex hyphens
+
+Centered hyphens are entered as @samp{ -- } between syllables of a same word
+(note the spaces before and after the two hyphen characters).  The hyphen
+will be centered between the syllables, and its length will be adjusted
+depending on the space between the syllables.
+
+In tighly engraved music, hyphens can be removed.  Whether this
+happens can be controlled with the @code{minimum-distance} (minimum
+distance between two syllables) and the @code{minimum-length}
+(threshold below which hyphens are removed).
+
+@seealso
+
+Program reference: @internalsref{LyricExtender},
+@internalsref{LyricHyphen}
+
+
+@node Working with lyrics and variables
+@unnumberedsubsubsec Working with lyrics and variables
+@cindex lyrics, variables
+
+To define variables containing lyrics, the function @code{\lyricmode}
+must be used.  You do not have to enter durations though, if you add
+@code{\addlyrics} or @code{\lyricsto}
+when invoking your variable.
+ 
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+ <<
+   \new Voice = "one" \relative c'' @{
+     \autoBeamOff
+     \time 2/4
+     c4 b8. a16 g4. f8 e4 d c2
+   @}
+   \addlyrics @{ \verseOne @}
+ >>
+@}
+@end example
+ 
+For different or more complex orderings, the best way is to setup the
+hierarchy of staves and lyrics first, e.g.,
+@example
+\new ChoirStaff <<
+  \new Voice = "soprano" @{ @emph{music} @}
+  \new Lyrics = "sopranoLyrics" @{ s1 @}
+  \new Lyrics = "tenorLyrics" @{ s1 @}
+  \new Voice = "tenor" @{ @emph{music} @}
+>>
+@end example
+ 
+and then combine the appropriate melodies and lyric lines
+ 
+@example
+\context Lyrics = sopranoLyrics \lyricsto "soprano"
+@emph{the lyrics}
+@end example
+ 
+@noindent
+
+The final input would resemble
+ 
+@example
+<<\new ChoirStaff << @emph{setup the music} >>
+ \lyricsto "soprano" @emph{etc}
+ \lyricsto "alto" @emph{etc}
+@emph{etc}
+>>
+@end example
+ 
+@seealso
+ 
+@c TODO: document \new Staff << Voice \lyricsto >> bug
+Program reference: @internalsref{LyricCombineMusic},
+@internalsref{Lyrics}.  
+
+
+@node Flexibility in placement
+@unnumberedsubsubsec Flexibility in placement
+
+Often, different stanzas of one song are put to one melody in slightly
+differing ways.  Such variations can still be captured with
+@code{\lyricsto}.
+
+@menu
+* Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Lyrics independent of notes::  
+@end menu
+
+
+@node Lyrics to multiple notes of a melisma
+@unnumberedsubsubsec Lyrics to multiple notes of a melisma
+
+One possibility is that the text has a melisma in one stanza, but
+multiple syllables in another one.  One solution is to make the faster
+voice ignore the melisma.  This is done by setting
+@code{ignoreMelismata} in the Lyrics context.
+
+There is one tricky aspect: the setting for @code{ignoreMelismata}
+must be set one syllable @emph{before} the non-melismatic syllable
+in the text, as shown here,
+
+@c  TODO: breaks compile
+@lilypond[verbatim,ragged-right,quote]
+%{
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    \slurDotted
+    f8.[( g16])
+    a4
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    more slow -- ly
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    \set ignoreMelismata = ##t % applies to "fas"
+    go fas -- ter
+    \unset ignoreMelismata
+    still
+  }
+>>
+%}
+@end lilypond
+
+
+The @code{ignoreMelismata} applies to the syllable @q{fas}, so it
+should be entered before @q{go}.
+
+The reverse is also possible: making a lyric line slower than the
+standard.  This can be achieved by insert @code{\skip}s into the
+lyrics.  For every @code{\skip}, the text will be delayed another note.
+For example,
+
+@lilypond[verbatim,ragged-right,quote]
+\relative { c c g' }
+\addlyrics {
+  twin -- \skip 4
+  kle
+}
+@end lilypond
+
+
+@node Divisi lyrics
+@unnumberedsubsubsec Divisi lyrics
+
+You can display alternate (or divisi) lyrics by naming voice
+contexts and attaching lyrics to those specific contexts.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" {
+    \relative c' {
+      c4
+      <<
+        { \voiceOne c8 e }
+        \new Voice = "splitpart" { \voiceTwo c4 }
+      >>
+      \oneVoice c4 c | c
+    }
+  }
+  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
+  \new Lyrics \lyricsto "splitpart" { will }
+>> }
+@end lilypond
+
+
+You can use this trick to display different lyrics for a repeated
+section.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" \relative c' {
+    c2 e | g e | c1 |
+    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
+    a2 b | c1}
+  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
+    do mi sol mi do
+    la si do }
+  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
+   do re mi fa sol }
+  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
+   dodo rere mimi fafa solsol }
+>>
+}
+@end lilypond
+
+
+
+@node Switching the melody associated with a lyrics line
+@unnumberedsubsubsec Switching the melody associated with a lyrics line
+
+More complex variations in text underlay are possible.  It is possible
+to switch the melody for a line of lyrics during the text.  This is
+done by setting the @code{associatedVoice} property.  In the example
+
+@lilypond[ragged-right,quote]
+<<
+  \relative \new Voice = "lahlah" {
+    \set Staff.autoBeaming = ##f
+    c4
+    <<
+      \new Voice = "alternative" {
+        \voiceOne
+        \times 2/3 {
+          % show associations clearly.
+          \override NoteColumn #'force-hshift = #-3
+          f8 f g
+        }
+      }
+      {
+        \voiceTwo
+        f8.[ g16]
+        \oneVoice
+      } >>
+    a8( b) c
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    Ju -- ras -- sic Park
+  }
+  \new Lyrics \lyricsto "lahlah" {
+    % Tricky: need to set associatedVoice
+    % one syllable too soon!
+    \set associatedVoice = alternative % applies to "ran"
+    Ty --
+    ran --
+    no --
+    \set associatedVoice = lahlah % applies to "rus"
+    sau -- rus Rex
+  } >>
+@end lilypond
+
+@noindent
+the text for the first stanza is set to a melody called @q{lahlah},
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  Ju -- ras -- sic Park
+@}
+@end example
+
+
+The second stanza initially is set to the @code{lahlah} context, but
+for the syllable @q{ran}, it switches to a different melody.
+This is achieved with
+@example
+\set associatedVoice = alternative
+@end example
+
+@noindent
+Here, @code{alternative} is the name of the @code{Voice} context
+containing the triplet.
+
+Again, the command must be one syllable too early, before @q{Ty} in
+this case.
+
+@example
+\new Lyrics \lyricsto "lahlah" @{
+  \set associatedVoice = alternative % applies to "ran"
+  Ty --
+  ran --
+  no --
+  \set associatedVoice = lahlah % applies to "rus"
+  sau -- rus Rex
+@}
+@end example
+
+@noindent
+The underlay is switched back to the starting situation by assigning
+@code{lahlah} to @code{associatedVoice}.
+
+
+@node Lyrics independent of notes
+@unnumberedsubsubsec Lyrics independent of notes
+
+In some complex vocal music, it may be desirable to place
+lyrics completely independently of notes.  Music defined
+inside @code{lyricrhythm} disappears into the
+@code{Devnull} context, but the rhythms can still be used
+to place the lyrics.
+
+@lilypond[quote,verbatim,ragged-right]
+voice = {
+  c''2
+  \tag #'music { c''2 }
+  \tag #'lyricrhythm { c''4. c''8 }
+  d''1
+}
+
+lyr = \lyricmode { I like my cat! }
+
+<<
+  \new Staff \keepWithTag #'music \voice
+  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
+  \new Lyrics \lyricsto "nowhere" \lyr
+  \new Staff { c'8 c' c' c' c' c' c' c'
+  c' c' c' c' c' c' c' c' }
+>>
+@end lilypond
+
+
+@node Spacing lyrics
+@unnumberedsubsubsec Spacing lyrics
+
+@cindex Spacing lyrics
+@cindex Lyrics, increasing space between
+
+To increase the spacing between lyrics, set the minimum-distance property of
+LyricSpace.
+
+@lilypond[relative,verbatim,fragment,quote,ragged-right]
+{
+  c c c c
+  \override Lyrics.LyricSpace #'minimum-distance = #1.0
+  c c c c
+}
+\addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+}
+@end lilypond
+
+To make this change for all lyrics in the score, set the property in the
+layout.
+
+@lilypond[relative,verbatim,quote,ragged-right]
+\score {
+  \relative c' {
+  c c c c
+  c c c c
+  }
+  \addlyrics {
+  longtext longtext longtext longtext
+  longtext longtext longtext longtext
+  }
+  \layout {
+    \context {
+      \Lyrics
+      \override LyricSpace #'minimum-distance = #1.0
+    }
+  }
+}
+@end lilypond
+
+
+@node More about stanzas
+@unnumberedsubsubsec More about stanzas
+
+@cindex stanza number
+@unnumberedsubsubsec Adding stanza numbers 
+
+Stanza numbers can be added by setting @code{stanza}, e.g.,
+
+@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set stanza = "1. "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set stanza = "2. "
+  Oh, ché -- ri, je t'aime
+}
+@end lilypond
+
+@noindent
+These numbers are put just before the start of the first syllable.
+
+
+@unnumberedsubsubsec Adding dynamics marks
+
+Stanzas differing in loudness may be indicated by putting a
+dynamics mark before each stanza.  In Lilypond, everthing coming in
+front of a stanza goes into the @code{StanzaNumber} object; dynamics marks
+are no different.  For technical reasons, you have to set the stanza
+outside @code{\lyricmode}:
+
+@lilypond[quote,ragged-right,verbatim]
+text = {
+  \set stanza = \markup { \dynamic "ff" "1. " }
+  \lyricmode {
+    Big bang
+  }
+}
+
+<<
+  \new Voice = "tune" {
+    \time 3/4
+    g'4 c'2
+  }
+\new Lyrics \lyricsto "tune" \text
+>>
+@end lilypond
+
+@cindex singer name
+@cindex name of singer
+@unnumberedsubsubsec Adding singer names
+
+Names of singers can also be added.  They are printed at the start of
+the line, just like instrument names.  They are created by setting
+@code{vocalName}.  A short version may be entered as @code{shortVocalName}.
+
+@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
+\new Voice {
+  \time 3/4 g2 e4 a2 f4 g2.
+} \addlyrics {
+  \set vocalName = "Bert "
+  Hi, my name is Bert.
+} \addlyrics {
+  \set vocalName = "Ernie "
+  Oh, che -- ri, je t'aime
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end 
+
+Sometimes it is appropriate to have one stanza set
+to the music, and the rest added in verse form at
+the end of the piece.  This can be accomplished by adding
+the extra verses into a @code{\markup} section outside
+of the main score block.  Notice that there are two
+different ways to force linebreaks when using
+@code{\markup}.
+
+@lilypond[ragged-right,verbatim,quote]
+melody = \relative c' {
+e d c d | e e e e |
+d d e d | c1 |
+}
+
+text = \lyricmode {
+\set stanza = "1." Ma- ry had a lit- tle lamb,
+its fleece was white as snow.
+}
+
+\score{ <<
+  \new Voice = "one" { \melody }
+  \new Lyrics \lyricsto "one" \text
+>>
+  \layout { }
+}
+\markup { \column{
+  \line{ Verse 2. }
+  \line{ All the children laughed and played }
+  \line{ To see a lamb at school. }
+  }
+}
+\markup{
+  \wordwrap-string #"
+  Verse 3.
+
+  Mary took it home again,
+
+  It was against the rule."
+}
+@end lilypond
+
+
+@unnumberedsubsubsec Printing stanzas at the end in multiple columns 
+
+When a piece of music has many verses, they are often printed in
+multiple columns across the page.  An outdented verse number often
+introduces each verse.  The following example shows how to produce such
+output in Lilypond.
+
+@lilypond[ragged-right,quote,verbatim]
+melody = \relative c' {
+  c c c c | d d d d
+}
+ 
+text = \lyricmode {
+  \set stanza = "1." This is verse one.
+  It has two lines.
+}
+
+\score{ <<
+    \new Voice = "one" { \melody }
+    \new Lyrics \lyricsto "one" \text
+   >>
+  \layout { }
+}
+
+\markup {
+  \fill-line {
+    \hspace #0.1 % moves the column off the left margin; can be removed if
+        % space on the page is tight
+     \column {
+      \line { \bold "2."
+        \column {
+          "This is verse two."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "3."
+        \column {
+          "This is verse three."
+          "It has two lines."
+        }
+      }
+    }
+    \hspace #0.1  % adds horizontal spacing between columns; if they are
+        % still too close, add more " " pairs until the result 
+        % looks good
+     \column {
+      \line { \bold "4."
+        \column {
+          "This is verse four."
+          "It has two lines."
+        }
+      }
+      \hspace #0.1 % adds vertical spacing between verses
+      \line { \bold "5."
+        \column {
+          "This is verse five."
+          "It has two lines."
+        }
+      }
+    }
+  \hspace #0.1 % gives some extra space on the right margin; can
+      % be removed if page space is tight
+  }
+}
+@end lilypond
+
+
+@seealso
+
+Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
+@internalsref{VocalName}.
+
+
+
+@node Other vocal issues
+@unnumberedsubsubsec Other vocal issues
+
+@ignore
+yeah, I'm giving up somewhat by stuffing a bunch of things in
+here.  But at least they're in the manual now; it's easier to
+move them around in the manual once they're already here.
+
+Besides, if users complain about everything stuffed in here, I
+can ask them for specific instructions about where to move these
+examples, and that might get them more involved in the docs.  -gp
+@end ignore
+
+@q{Parlato} is spoken without pitch but still with rhythm; it is
+notated by cross noteheads.  This is demonstrated in
+@ref{Special noteheads}.
+
+
+
+
diff --git a/Documentation/user/working.itely b/Documentation/user/working.itely
index 1cc6ea71ef..e3832409a9 100644
--- a/Documentation/user/working.itely
+++ b/Documentation/user/working.itely
@@ -1,5 +1,5 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
 @ignore
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
@@ -18,11 +18,7 @@ this chapter.
 
 @menu
 * Suggestions for writing LilyPond files::  
-* Saving typing with identifiers and functions::  
-* Style sheets::                
-* Updating old files::          
-* Troubleshooting (taking it all apart)::  
-* Minimal examples::            
+* When things don't work::      
 @end menu
 
 
@@ -37,7 +33,7 @@ As long as LilyPond can understand your files and produces the output
 that you want, it doesn't matter what your files look like.  However,
 there are a few other things to consider when writing lilypond files.
 
-@itemize @bullet
+@itemize
 @item What if you make a mistake?  The structure of a lilypond
 file can make certain errors easier (or harder) to find.
 
@@ -52,13 +48,15 @@ with a later version of lilypond?  The input syntax changes
 occasionally as lilypond improves.  Most changes can be
 done automatically with @code{convert-ly}, but some changes
 might require manual assistance.  Lilypond files can be
-structured in order to be easier (or header) to update.
+structured in order to be easier (or harder) to update.
 @end itemize
 
 @menu
 * General suggestions::         
 * Typesetting existing music::  
 * Large projects::              
+* Saving typing with variables and functions::  
+* Style sheets::                
 @end menu
 
 
@@ -68,21 +66,21 @@ structured in order to be easier (or header) to update.
 Here are a few suggestions that can help you to avoid or fix
 problems:
 
-@itemize @bullet
+@itemize
 @item @strong{Include @code{\version} numbers in every file}.  Note that all
-templates contain a @code{\version "2.11.23"} string.  We
+templates contain @code{\version} information.  We
 highly recommend that you always include the @code{\version}, no matter
 how small your file is.  Speaking from personal experience, it's
 quite frustrating to try to remember which version of LilyPond you were
 using a few years ago.  @code{convert-ly} requires you to declare
 which version of LilyPond you used.
 
-@item @strong{Include checks}: @ref{Bar check}, @ref{Octave check}, and
-@ref{Barnumber check}.  If you
-include checks every so often, then if you make a mistake, you can pinpoint
-it quicker.  How often is @q{every so often}?  It depends on the complexity
-of the music.  For very simple music, perhaps just once or twice.  For
-very complex music, perhaps every bar.
+@item @strong{Include checks}: @ruser{Bar and barnumber checks},
+@ruser{Octave check}.  If you include checks every so often, then
+if you make a mistake, you can pinpoint it quicker.  How often is
+@q{every so often}?  It depends on the complexity of the music.
+For very simple music, perhaps just once or twice.  For very
+complex music, perhaps every bar.
 
 @item @strong{One bar per line of text}.  If there is anything complicated,
 either in the music
@@ -105,12 +103,12 @@ imbalance
 in the number of @code{@{} and @code{@}}.
 
 @item @strong{Explicitly add durations} at the beginnings of sections
-and identifiers.  If you specify @code{c4 d e} at the beginning of a
+and variables.  If you specify @code{c4 d e} at the beginning of a
 phrase (instead of just @code{c d e}) you can save yourself some
 problems if you rearrange your music later.
 
 @item @strong{Separate tweaks} from music definitions.  See
-@ref{Saving typing with identifiers and functions}, and
+@ref{Saving typing with variables and functions}, and
 @ref{Style sheets}.
 
 @end itemize
@@ -122,13 +120,13 @@ problems if you rearrange your music later.
 If you are entering music from an existing score (i.e., typesetting a
 piece of existing sheet music),
 
-@itemize @bullet
+@itemize
 
 @item Enter one manuscript (the physical copy) system at a time (but still
 only one bar per line of text), and
 check each system when you finish it.  You may use the
 @code{showLastLength} command to speed up processing -- see
-@ref{Skipping corrected music}.
+@ruser{Skipping corrected music}.
 
 @item Define @code{mBreak = @{ \break @}} and insert @code{\mBreak}
 in the input file whenever the manuscript has a line break.  This
@@ -147,9 +145,9 @@ best.
 When working on a large project, having a clear structure to your
 lilypond files becomes vital.
 
-@itemize @bullet
+@itemize
 
-@item @strong{Use an identifier for each voice}, with a minimum of
+@item @strong{Use an variable for each voice}, with a minimum of
 structure inside the definition.  The structure of the
 @code{\score} section is the most likely thing to change;
 the @code{violin} definition is extremely unlikely to change
@@ -170,7 +168,7 @@ g4 c'8. e16
 @end example
 
 @item @strong{Separate tweaks from music definitions}.  This
-point was made in @ref{General suggestions}, but for large
+point was made in previously, but for large
 projects it is absolutely vital.  We might need to change
 the definition of @code{fthenp}, but then we only need
 to do this once, and we can still avoid touching anything
@@ -187,11 +185,11 @@ g4\fthenp c'8. e16
 @end itemize
 
 
-@node Saving typing with identifiers and functions
-@section Saving typing with identifiers and functions
+@node Saving typing with variables and functions
+@subsection Saving typing with variables and functions
 
 @cindex variables
-@cindex identifiers
+@cindex variables
 
 By this point, you've seen this kind of thing:
 
@@ -217,7 +215,7 @@ violin = \new Staff { \fragA \fragA \fragB \fragA }
 }
 @end lilypond
 
-However, you can also use these identifiers (also known as
+However, you can also use these variables (also known as
 variables, macros, or (user-defined) command) for tweaks:
 
 @lilypond[quote,verbatim,ragged-right]
@@ -240,11 +238,11 @@ violin = \relative c'' {
 }
 @end lilypond
 
-These identifiers are obviously useful for saving
+These variables are obviously useful for saving
 typing.  But they're worth considering even if you
 only use them once -- they reduce complexity.  Let's
 look at the previous example without any
-identifiers.  It's a lot harder to read, especially
+variables.  It's a lot harder to read, especially
 the last line.
 
 @example
@@ -283,7 +281,7 @@ padText =
 }
 @end lilypond
 
-Using identifiers is also a good way to reduce work if the
+Using variables is also a good way to reduce work if the
 LilyPond input syntax changes (see @ref{Updating old files}).  If
 you have a single definition (such as @code{\dolce}) for all your
 files (see @ref{Style sheets}), then if the syntax changes, you
@@ -292,7 +290,7 @@ instead of making changes throughout every @code{.ly} file.
 
 
 @node Style sheets
-@section Style sheets
+@subsection Style sheets
 
 The output that LilyPond produces can be heavily modified; see
 @ref{Tweaking output}, for details.  But what if you have many
@@ -546,8 +544,17 @@ file with @code{\include "../global.ly"}, which contains
 @end example
 
 
+@node When things don't work
+@section When things don't work
+
+@menu
+* Updating old files::          
+* Troubleshooting (taking it all apart)::  
+* Minimal examples::            
+@end menu
+
 @node Updating old files
-@section Updating old files
+@subsection Updating old files
 
 The LilyPond input syntax occasionally changes.  As LilyPond itself
 improves, the syntax (input language) is modified accordingly.  Sometimes
@@ -575,7 +582,7 @@ your old LilyPond files.
 
 
 @node Troubleshooting (taking it all apart)
-@section Troubleshooting (taking it all apart)
+@subsection Troubleshooting (taking it all apart)
 
 Sooner or later, you will write a file that LilyPond cannot
 compile.  The messages that LilyPond gives may help
@@ -630,7 +637,7 @@ Another very useful debugging technique is constructing
 
 
 @node Minimal examples
-@section Minimal examples
+@subsection Minimal examples
 
 A minimal example is an example which is as small as possible.  These
 examples are much easier to understand than long examples.  Minimal
diff --git a/buildscripts/add_html_footer.py b/buildscripts/add_html_footer.py
index 653e4b4af5..1721ad7187 100644
--- a/buildscripts/add_html_footer.py
+++ b/buildscripts/add_html_footer.py
@@ -87,7 +87,7 @@ def build_pages_dict (filelist):
 def source_links_replace (m, source_val):
     return 'href="' + os.path.join (source_val, m.group (1)) + '"'
 
-splitted_docs_re = re.compile ('Documentation/user/out-www/(lilypond|music-glossary|lilypond-program)/')
+splitted_docs_re = re.compile ('Documentation/user/out-www/(lilypond|music-glossary|lilypond-program|lilypond-learning)/')
 
 # On systems without symlinks (e.g. Windows), docs are not very usable
 # Get rid of symlinks references here
diff --git a/buildscripts/texi-langutils.py b/buildscripts/texi-langutils.py
index 66900268bc..ac63f21ba2 100644
--- a/buildscripts/texi-langutils.py
+++ b/buildscripts/texi-langutils.py
@@ -31,7 +31,6 @@ intro_blurb = '''@c -*- coding: utf-8; mode: texinfo%(doclang)s -*-
 @c This file is part of %(topfile)s
 @ignore
     Translation of GIT committish: %(head_committish)s
-
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
diff --git a/input/GNUmakefile b/input/GNUmakefile
index 65db9aaa23..910b78db57 100644
--- a/input/GNUmakefile
+++ b/input/GNUmakefile
@@ -1,6 +1,8 @@
 depth = ..
 
-SUBDIRS = regression tutorial mutopia manual lsr new 
+### FIXME: change this back before merging with main!!!
+#SUBDIRS = regression tutorial mutopia manual lsr new 
+SUBDIRS = tutorial mutopia manual lsr new 
 
 examples = typography-demo les-nereides wilhelmus proportional bach-schenker cary
 
diff --git a/input/manual/bar-lines.ly b/input/manual/bar-lines.ly
deleted file mode 100644
index b5cdc8492d..0000000000
--- a/input/manual/bar-lines.ly
+++ /dev/null
@@ -1,33 +0,0 @@
-
-\version "2.10.0"
-
-\header {
-    
-    texidoc = "There are many types of bar lines available."
-
-}
-
-\layout { ragged-right = ##t }
-
-\relative {
-    \override Score.RehearsalMark #'padding = #3
-    
-    c4 \bar "|" \mark \markup {  \simple #"|" }
-    c \bar "|:" \mark \markup {  \simple #"|:" }
-    c \bar "||" \mark \markup {  \simple #"||" }
-    c \bar ":|" \mark \markup {  \simple #":|" }
-    c \bar ".|" \mark \markup {  \simple #".|" }
-    c \bar ".|." \mark \markup {  \simple #".|." }
-    c \bar ":|:" \mark \markup {  \simple #":|:" }
-    c \bar "|." \mark \markup {  \simple #"|." }
-    c \bar ":" \mark \markup {  \simple #":" }
-    c c c \bar "dashed" \mark \markup { \simple #"dashed" }
-    c c c c
-    \bar "||:" \mark \markup { \tiny \typewriter "unbroken" \simple
-#"||:" }
-    c c c c
-    \break
-    \bar "||:" \mark \markup { \tiny \typewriter "broken" \simple
-#"||:" }
-    c
-}
diff --git a/input/manual/bar-number-regular-interval.ly b/input/manual/bar-number-regular-interval.ly
deleted file mode 100644
index a294fb42c1..0000000000
--- a/input/manual/bar-number-regular-interval.ly
+++ /dev/null
@@ -1,24 +0,0 @@
-\header {
-    texidoc = "
-
-Bar numbers can be printed at regular intervals, inside a box or a circle.
-
-" }
-
-\version "2.10.0"
-
-\relative c'{
-   \override Score.BarNumber  #'break-visibility = #end-of-line-invisible
-   \set Score.barNumberVisibility = #(every-nth-bar-number-visible 4)
-   \override Score.BarNumber #'font-size = #2
-
-   \override Score.BarNumber  #'stencil
-   = #(make-stencil-boxer 0.1 0.25 ly:text-interface::print)
-   \repeat unfold 5 { c1 } \bar "|"
-
-   \override Score.BarNumber  #'stencil
-   = #(make-stencil-circler 0.1 0.25 ly:text-interface::print)
-   \repeat unfold 4 { c1 } \bar "|."
-}
-
-
diff --git a/input/manual/ossia.ly b/input/manual/ossia.ly
deleted file mode 100644
index 9b2b5540bb..0000000000
--- a/input/manual/ossia.ly
+++ /dev/null
@@ -1,36 +0,0 @@
-
-\header { texidoc = "Ossia fragments can be done with starting and
-stopping staves. " }
-
-\version "2.10.0"
-\paper { ragged-right = ##t }
-
-<<
-  \new Staff \with
-  {
-    \remove "Time_signature_engraver"
-    fontSize = #-2
-    \override StaffSymbol #'staff-space = #(magstep -2)
-    firstClef = ##f
-  }
-  \relative c'' {
-    \stopStaff
-    \skip 2
-
-    \startStaff
-    \clef treble
-    bes8[^"ossia" g bes g]
-    \stopStaff
-
-    s2
-
-    \startStaff
-    f8 d g4 
-  }
-  \new Staff  \relative
-  {
-    \time 2/4
-    c4 c g' g a a g2
-  }
-
->>
diff --git a/input/manual/pitches-headword.ly b/input/manual/pitches-headword.ly
new file mode 100644
index 0000000000..abeca9094a
--- /dev/null
+++ b/input/manual/pitches-headword.ly
@@ -0,0 +1,6 @@
+\version "2.11.32"
+\include "english.ly"
+
+\markup{ Example removed temporarily}
+
+
diff --git a/input/manual/rhythms-headword.ly b/input/manual/rhythms-headword.ly
new file mode 100644
index 0000000000..f1ea438455
--- /dev/null
+++ b/input/manual/rhythms-headword.ly
@@ -0,0 +1,113 @@
+\version "2.11.33"
+
+\layout {
+   \context { \Score
+      \override NonMusicalPaperColumn #'line-break-system-details =
+      #'((alignment-offsets . (0 -14 -32 -46)))
+   }
+}
+
+\new Score <<
+   \set Score.proportionalNotationDuration = #(ly:make-moment 1 96)
+   \set Score.autoBeaming = ##f
+   \set Score.tupletFullLength = ##t
+   \override Score.TupletBracket #'staff-padding = #5
+   \new StaffGroup <<
+      \new RhythmicStaff {
+         \time 4/8
+         c64 [
+         c64
+         c16
+         c64
+         c64
+         c64
+         c64
+         c16
+         c64
+         c64 ]
+         c64 [
+         \set stemLeftBeamCount = #4
+         \set stemRightBeamCount = #4
+         c64
+         \set stemLeftBeamCount = #4
+         \set stemRightBeamCount = #3
+         c64
+         c32.
+         c64
+         c64
+         c64
+         c64
+         c64
+         \set stemRightBeamCount = #4
+         c64
+         \set stemLeftBeamCount = #4
+         \set stemRightBeamCount = #3
+         c64
+         \set stemRightBeamCount = #2
+         c32.
+         \time 1/8
+         \set stemLeftBeamCount = #2
+         c64
+         c64
+         c16
+         c64
+         c64 ]
+      }
+      \new RhythmicStaff {
+         \set stemLeftBeamCount = #0
+         c16 [ ]
+         r8.
+         \times 2/3 {
+            c16 [
+            c16
+            c16
+            c16
+            c16
+            c16
+         }
+         \times 2/3 {
+            c32
+            c32
+            c32
+            c32
+            c32 ]
+            r32
+         }
+      }
+   >>
+   \new StaffGroup <<
+      \new RhythmicStaff {
+         \times 4/5 {
+            \set stemLeftBeamCount = #0
+            c32 [ ]
+            r16.
+            \set stemLeftBeamCount = #2
+            c16. [
+            c32
+            \set stemRightBeamCount = #3
+            c32 ] 
+            r32
+         }
+         \times 8/11 {
+            c16. [
+            c8
+            c8 ]
+         }
+         c8
+      }
+      \new RhythmicStaff {
+         \times 2/3 {
+            c16 [
+            c8. ]
+            c4
+            r4
+         }
+         \times 4/5 {
+            r16
+            \set stemLeftBeamCount = #2
+            \set stemRightBeamCount = #0
+            c16. [ ]
+         }
+      }
+   >>
+>>
diff --git a/input/manual/script-abbreviations.ly b/input/manual/script-abbreviations.ly
deleted file mode 100644
index dedda6ab0f..0000000000
--- a/input/manual/script-abbreviations.ly
+++ /dev/null
@@ -1,26 +0,0 @@
-
-% this chart is used in the manual too.
-
-\version "2.10.0"
-\header { texidoc = "@cindex Script Abbreviations
-
-Some articulations may be entered using an abbreviation.
-
-"
-	  
-}
-
-\score {
-     \context Voice {
-      \override TextScript  #'font-family = #'typewriter
-      \override TextScript  #'font-shape = #'upright
-      c''4-._"c-."      s4
-      c''4--_"c--"      s4
-      c''4-+_"c-+"      s4
-      c''4-|_"c-|"      s4
-      c''4->_"c->"      s4
-      c''4-^_"c-^"      s4
-      c''4-__"c-_"      s4      
-    }
-  }
-