]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/de/user/tutorial.itely
Merge master into nested-bookparts
[lilypond.git] / Documentation / de / user / tutorial.itely
index 65095abfe8912176f28a8fcf0d8d90c471c09740..ba65e514d4c5b51a12672718428902febbc4ba35 100644 (file)
@@ -1,21 +1,23 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 718cc970304f6b9a3bb990259a048c06e56f4e48
+    Translation of GIT committish: 579452b61befcfd488fe53eda9a4b7166edca3d8
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c \version "2.11.61"
+
 @ignore
 Tutorial guidelines:
 - unless you have a really good reason, use either
-    @l ilypond[quote,ragged-right,verbatim]
+    @l ilypond[quote,verbatim]
   or
-    @l ilypond[quote,ragged-right,verbatim,fragment,relative=2]
+    @l ilypond[quote,verbatim,fragment,relative=2]
   (without spaces)
-  Don't use any other relative=X commands (make it a non-fragment
-  example), and don't use fragment without relative=2.
+  Don't use any other relative=X commands.
+  
 - 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.
@@ -23,55 +25,21 @@ Tutorial guidelines:
 @end ignore
 
 
-
-@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?
-
-@c  wherever possible, do not include index entries here; the
-@c  index should point to stuff in the reference manual.  -gp
-
-@c Your first LilyPond score in 10 minutes?
-
 @node Tutorial
 @chapter Tutorial
 
 Diese Übung führt ein in die Notationssprache des Programmes LilyPond
 und erklärt, wie man damit Noten setzen kann. Nach einer ersten
-Einleitung wird erklärt, wie die häufigsten Notenbilder im Druck umgesetzt
-werden können.
+Einleitung wird erklärt, wie die häufigsten Notenbilder in
+schönen Notendruck umgesetzt werden können.
 
-@ifhtml
-Viele Leute lernen Programme, indem sie einfach herumprobieren. Das
-geht auch mit LilyPond. Wenn Sie in der HTML-Version dieses Handbuchs
-eine Abbildung anklicken, erhalten sie exakt den LilyPond-Code, der
-zum Satz der Abbildung benutzt wurde. Versuchen Sie es mit dieser
-Abbildung:
-
-@c no verbatim here
-@lilypond[quote,ragged-right]
-\relative c'' {
-  c-\markup { \bold \huge { Click here.  } }
-}
-@end lilypond
-
-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
-ein Lesezeichen dafür im Browser zu setzen. Hier sind die wichtigsten
-LilyPond-Befehle zum schnellen Nachschlagen aufgelistet.
-@end ifhtml
 
 @menu
-* First steps::
-* Single staff notation::
-* Multiple notes at once::
-* Songs::
-* Final touches::
+* First steps::                 
+* Single staff notation::       
+* Multiple notes at once::      
+* Songs::                       
+* Final touches::               
 @end menu
 
 
@@ -82,20 +50,25 @@ In diesem Abschnitt werden die Grundlagen zur Benutzung
 des Programmes erklärt.
 
 @menu
-* Compiling a file::
-* Simple notation::
-* Working on text files::
-* How to read the tutorial::
+* Compiling a file::            
+* Simple notation::             
+* Working on input files::       
+* How to read the manual::      
 @end menu
 
 
 @node Compiling a file
 @subsection Compiling a file
 
-Das erste Beispiel zeigt, wie LilyPond arbeitet. Um
-Noten zu erzeugen, muss man eine Text-Datei schreiben,
-in der die Notation beschrieben wird. Zum Beispiel
-ergibt die Datei
+@qq{Kompilation} ist der Begriff, der benutzt wird, um eine
+Lilypond-Eingabedatei mit dem Programm LilyPond in eine
+Notenausgabe umzuwandeln, die ausgedruckt werden kann. 
+Zusätzlich besteht die Option, eine MIDI-Datei zu produzieren,
+die abgespielt werden kann. Das erste Beispiel zeigt, wie
+solch eine einfache Eingabedatei ausschauen kann.
+
+Um Notensatz zu erstellen, muss die Notation in der Eingabedatei
+beschrieben werden. Wenn man z.@w{}B. schreibt:
 
 @example
 @{
@@ -104,17 +77,18 @@ ergibt die Datei
 @end example
 
 @noindent
-folgendes Resultat.
+so erhält man folgendes Resultat:
 
 @c  in this case we don't want verbatim
-@lilypond[quote,ragged-right]
+@lilypond[quote]
 {
   c' e' g' e'
 }
 @end lilypond
 
-@strong{Warnung:} In jeder LilyPond-Datei müssen
+@warning{In jeder LilyPond-Datei müssen
 @strong{@{ geschweifte Klammern @}} um die Noten
+oder Gesangstext
 gesetzt werden. Vor und hinter den Klammern sollten
 Leerzeichen eingegeben werden, damit keine Unklarheiten
 in Verbindung mit den eigentlichen Notensymbolen entstehen.
@@ -122,35 +96,47 @@ An Anfang und Ende der Zeile können diese Leerzeichen auch
 weggelassen werden. Es kann sein, dass in diesem Handbuch
 die Klammern in manchen Beispielen fehlen, aber man sollte
 immer daran denken, sie in den eigenen Dateien zu benutzen!
+Mehr Informationen zu der Darstellung der Beispiele in diesem
+Handbuch gibt der Abschnitt @ref{How to read the manual}.}
 
 @cindex Groß- und Kleinschreibung
 @cindex Großbuchstaben
 @cindex Kleinbuchstaben
 Zusätzlich unterscheidet LilyPond @strong{Groß- und Kleinschreibung}.
-  @code{ @{ c d e @} } ist zulässiger Code,
- @code{ @{ C D E @} } dagegen resultiert in einer Fehlermeldung.
+@w{@code{ @{ c d e @}}} ist zulässiger Code,
+@w{@code{ @{ C D E @}}} dagegen resultiert in einer Fehlermeldung.
 
-@sp 1
+@smallspace
 
 @subheading Entering music and viewing output
 
+@cindex PDF-Datei
+@cindex Noten anzeigen
+@cindex Anzeigen der Noten
+@cindex Ansicht von Noten
+
 In diesem Kapitel zeigen wir, welche Kommandos
-eingegeben werden müssen und wie das Resultat
-dann betrachtet werden kann.
+eingegeben werden müssen, um ein Notenbild zu erzeugen, und wie 
+das Resultat dann betrachtet werden kann.
+
+Beachten Sie, dass es eine Reihe an Texteditoren mit besserer 
+Unterstützung für LilyPond gibt. Mehr dazu im Abschnitt
+@rprogram{Text editor support}.
+
+@warning{Das erste Mal, wenn Sie LilyPond benutzen, kann es eine 
+Minute oder länger dauern, weil das Programm zuerst alle Schriftarten,
+die auf dem System zur Verfügung stehen, untersucht. Aber nach 
+diesem ersten Mal läuft LilyPond sehr viel schneller.}
 
 @subsubheading MacOS X
 
-Wenn Sie das @code{LilyPond.app}-Symbol doppelt klicken, öffnet
+Wenn Sie das @command{LilyPond.app}-Symbol doppelt klicken, öffnet
 sich eine Beispiel-Datei. Speichern Sie sie etwa als
  @file{test.ly} auf dem Desktop und übersetzen Sie sie
-mit dem Menü-Befehl  @qq{Compile > Typeset File}.
+mit dem Menü-Befehl  @w{@qq{Compile > Typeset File}}.
 Die PDF-Datei mit dem fertigen Notensatz wird automatisch
 geöffnet.
 
-Das erste Mal, wenn LilyPond aufgerufen wird, kann es etwa eine
-Minute dauern, bis die Eingabedatei übersetzt wird, weil die
-Schriften des Betriebssystems erst überprüft werden müssen.
-
 Das nächste Mal, wenn Sie LilyPond benutzen, sollten Sie
  @qq{New} oder @qq{Open} wählen.  Sie müssen die Datei
 speichern, bevor Sie sie übersetzen können. Wenn es Fehler gibt,
@@ -161,7 +147,8 @@ lesen Sie die Meldungen im Log-Fenster.
 Wenn sie auf das LilyPond-Symbol auf dem Desktop doppelklicken,
 öffnet sich ein einfacher Texteditor mit einer Beispieldatei. Speichern
 Sie sie z. B. als @file{test.ly} auf dem Desktop und klicken Sie dann
-doppelt auf die Datei, um die Übersetzung zu beginnen. Nach einigen
+doppelt auf die Datei, um die Übersetzung zu beginnen (das Dateisymbol 
+ist eine Note). Nach einigen
 Sekunden wird eine Datei @file{test.pdf} auf dem Desktop erscheinen.
 Mit einem Doppelklick kann das fertige Notenbild in 
 der PDF-Datei angezeigt werden.
@@ -172,87 +159,79 @@ Um eine schon existierende Datei zu bearbeiten, klicken Sie mit der rechten
 Maustaste auf die Datei und wählen Sie @qq{Edit source}. Um eine leere 
 Datei zu erhalten, mit der Sie ein neues Stück beginnen können, öffnen Sie 
 den Texteditor durch Doppelklick auf das LilyPond-Symbol und benutzen Sie 
-@qq{New} im @qq{File}-Menü.
+@qq{New} im @qq{File}-Menü, oder klicken Sie mit der rechten
+Maustaste auf den Desktop und wählen Sie @qq{Neu...Textdatei},
+ändern Sie dann den Namen so wie Sie möchten und ändern Sie 
+die Dateiendung in @code{.ly}. Doppelklicken Sie auf die Datei,
+um Ihren LilyPond-Eingabecode einzugeben.
 
 Mit dem Doppelklick wird nicht nur die PDF-Datei erstellt, sondern
 auch eine @file{.log}-Datei. Hier wird gespeichert, was LilyPond aus
-der Quelldatei gelesen hat. Sollten Fehler auftreten, hilft oft ein Blick in
-diese Datei.
+der Quelldatei gelesen hat. Sollten Fehler auftreten, hilft oft ein 
+Blick in diese Datei.
 
-Es gibt einige andere Editoren mit besserer Unterstützung für LilyPond; Einzelheiten 
-dazu können Sie im Kapitel @rprogram{Editor support} nachlesen.
+@subsubheading UNIX
 
-@subsubheading Unix
+Erstellen Sie eine Text-Datei mit dem Namen @file{test.ly} und 
+geben Sie folgenden Text ein:
 
-Öffnen Sie ein Kommandozeilenfenster und einen Texteditor. Zum
-Beispiel können Sie xterm öffnen und
-@code{joe} ausführen.@footnote{Es gibt Makros für VIM-Süchtige
-und es gibt einen @code{LilyPond-Modus} für Emacs.  Wenn diese noch
-nicht installiert sind, lesen Sie die Datei @file{INSTALL.txt}.}
-Die einfachste Bearbeitunsumgebung ist das  @file{LilyPondTool}.
-Siehe auch @rprogram{Editor support} für mehr Information. Geben Sie
-folgendes in Ihrem Editor ein und speichern Sie die Datei als @file{test.ly}:
-
-@verbatim
-{
+@example
+@{
   c' e' g' e'
-}
-@end verbatim
+@}
+@end example
 
-@noindent
 Um die Datei zu bearbeiten, geben sie an der Konsole
 
 @example
 lilypond test.ly
 @end example
 
-ein.
 @noindent
+ein.
 Sie werden ungefähr folgende Meldungen sehen:
 
 
 @example
-user@@domain:~$ lilypond test.ly
-GNU LilyPond 2.11.23
+lilypond test.ly
+GNU LilyPond @version{}
 »test.ly« wird verarbeitet
 Analysieren...
 Interpretation der Musik...
 Vorverarbeitung der grafischen Elemente...
+Ideale Seitenanzahl wird gefunden...
+Musik wird auf eine Seite angepasst...
+Systeme erstellen...
 Layout nach »test.ps« ausgeben...
 Konvertierung nach »test.pdf«...
 @end example
 
-@cindex PDF-Datei
-@cindex Betrachten von Noten
-@cindex Anschauen von Noten
-@cindex Notenausgabe
-
-@noindent
 Als Ergebnis erhalten Sie ein @file{test.pdf}, das Sie mit den
-Standardprogrammen Ihres Betriebssystemes anschauen können.@footnote{Wenn
-derartige Programme nicht installiert sind, können Sie
-@uref{http://@/www@/.cs@/.wisc@/.edu/@/~ghost/,Ghostscript} ausprobieren,
-ein frei erhältliches Paket zur Ansicht von PDF- und PostScript-Dateien.}
+Standardprogrammen Ihres Betriebssystemes anschauen können.
 
 @node Simple notation
 @subsection Simple notation
 
 LilyPond fügt einige Bestandteile des Notenbildes automatisch hinzu. Im
-nächsten Beispiel sind nur drei Tonhöhen angegeben, aber LilyPond setzt
+nächsten Beispiel sind nur vier Tonhöhen angegeben, aber LilyPond setzt
 trotzdem einen Schlüssel, eine Taktangabe und Notendauern.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 {
   c' e' g' e'
 }
 @end lilypond
 
 @noindent
-Diese Einstellungen können verändert werden, aber in den meisten Fällen sind
-die automatischen Werte durchaus brauchbar.
+Diese Einstellungen können verändert werden, aber in den meisten Fällen
+sind die automatischen Werte durchaus brauchbar.
 
 @subheading Pitches
 
+Glossar: @rglos{pitch}, @rglos{interval},
+@rglos{scale}, @rglos{middle C}, @rglos{octave},
+@rglos{accidental}.
+
 @c Addition for German users about pitch naming conventions
 Die Tonhöhen werden mit Kleinbuchstaben eingegeben, die den Notennamen
 entsprechen. Es ist jedoch wichtig zu wissen, dass LilyPond in seiner
@@ -260,32 +239,39 @@ Standardeinstellung die englischen Notennamen verwendet. Bis auf eine
 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,
+wird als bes notiert, ein his dagegen würde bis geschrieben. Siehe auch
+@ruser{Accidentals} und @ruser{Note names in other languages}, hier
+wird beschrieben,
 wie sich die deutschen Notennamen benutzen lassen.
 @c end addition
 
 Am einfachsten können Noten im @code{\relative}-Modus
-eingegeben werden. In diesem Modus wird automatisch
-angenommen, dass das @rglos{interval} zwischen der vorhergehenden
-und der aktuellen Note höchstens eine @rglos{fourth} beträgt.  Fangen
-wir unser erstes Notationsbeispiel mit einer @rglos{scale} an.
-
-@lilypond[quote,ragged-right,verbatim]
+eingegeben werden. In diesem Modus wird die Oktave der Note automatisch
+gewählt, indem angenommen wird, dass die folgende Note immer so nah 
+wie möglich in Bezug auf die vorhergehende gesetzt wird, d. h. sie 
+wird höchstens drei Notenzeilen höher oder tiefer als die vorhergehende 
+Note gesetzt. Fangen
+wir unser erstes Notationsbeispiel mit einer @notation{scale} an, wo also
+die nächste Note immer nur eine Notenlinie über der vorherigen steht.
+
+@c KEEP LY
+@lilypond[verbatim,quote]
+% Beginnpunkt auf das mittlere C setzen
 \relative c' {
   c d e f
   g a b c
 }
 @end lilypond
 
-Die erste Note ist ein @rglos{middle C}. Jede folgende Note
-befindet sich höchstens eine Quarte von der vorhergehenden
-entfernt -- das erste @q{C} ist also das nächste C vom
+Die erste Note ist ein @notation{eingestrichenes C}. Jede folgende Note
+befindet sich so nah wie möglich bei der vorherigen -- das erste 
+@q{C} ist also das nächste C vom
 eingestrichenen C aus gerechnet. Darauf folgt das nächstmögliche
 D in Bezug auf die vorhergehende Note. Mit diesen Regeln können
-auch Melodien mit größeren Intervallen gebildet werden:
+auch Melodien mit größeren Intervallen im @code{\relative}-Modus
+gebildet werden:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c' {
   d f a g
   c b f d
@@ -293,17 +279,54 @@ auch Melodien mit größeren Intervallen gebildet werden:
 @end lilypond
 
 @noindent
-Dieses Beispiel beginnt nicht mit dem eingestrichenen C. Die
-erste Note (das @q{D}) ist das nächste D 
+Es ist nicht notwendig, dass die erste Note der Melodie mit der 
+Note beginnt, die die erste Tonhöhe angibt.
+Die erste Note (das @q{D}) des vorigen Beispiels ist das nächste D 
 vom eingestrichenen C aus gerechnet.
 
-Um Intervalle zu notieren, die größer als eine Quarte sind, können
-wir die Oktave verändern. Mit einem Apostroph @code{'} (Taste Shift+#)
-direkt hinter dem Notennamen wird die Oktave um eins erhöht, mit einem Komma
-@code{,} um eins
-erniedrigt.
+Indem man Apostrophe @code{'} (Taste Shift+#) oder Kommata @code{,} 
+zu dem @w{@code{\relative c' @{}} hinzufügt oder entfernt, kann die 
+Oktave der ersten Tonhöhe verändert werden:
+
+@c KEEP LY
+@lilypond[verbatim,quote]
+% zweigestrichenes C
+\relative c'' {
+  e c a c
+}
+@end lilypond
+
+Der relative Modus kann zunächst verwirrend erscheinen, aber es ist die 
+einfachste Art, die meisten Melodien zu notieren. Schauen wir uns an, 
+wie diese relative Berechnung in der Praxis funktioniert. Wenn wir mit 
+einem H beginnen (@code{b} in der LilyPond-Syntax), welches sich auf der 
+mittleren Linie im Violinschlüssel befindet, können wir C, D und E 
+aufwärts notieren, und A, G und F unter dem H. Wenn also die Note, die 
+auf das H folgt, ein C, D oder E ist, setzt LilyPond es oberhalb des 
+Hs, wenn es ein A, G oder F ist, wird es darunter gesetzt.
+
+@c KEEP LY
+@lilypond[verbatim,quote]
+\relative c'' {
+  b c  % c ist 1 Zeile aufwärts, also c über dem b
+  b d  % d ist 2 Zeilen aufwärts, oder 5 runter, also d über dem b
+  b e  % e ist 3 aufwärts oder 4 runter, also e über dem b
+  b a  % a ist 6 aufwärts oder 1 runter, also a unter dem b
+  b g  % g ist 5 aufwärts oder 2 runter, also g unter dem b
+  b f  % f ist 4 aufwärts oder 3 runter, also f unter dem b
+}
+@end lilypond
+
+Die gleiche Berechnung findet auch statt, wenn eine der Noten erhöht 
+oder erniedrigt ist. @notation{Versetzungszeichen} werden 
+@strong{vollständig ignoriert} bei der Berechnung. Genau die 
+gleiche Berechnung wird analog von jeder folgenden Tonhöhe aus 
+für die nächste Tonhöhe neu ausgeführt.
 
-@lilypond[quote,ragged-right,verbatim]
+Um Intervalle zu notieren, die größer als drei Notenzeilen sind, kann man die Oktave verändern. Mit einem Apostroph @code{'} (Taste Shift+#)
+direkt hinter dem Notennamen wird die Oktave um eins erhöht, mit einem Komma @code{,} um eins erniedrigt.
+
+@lilypond[verbatim,quote]
 \relative c'' {
   a a, c' f,
   g g'' a,, f'
@@ -311,22 +334,30 @@ erniedrigt.
 @end lilypond
 
 @noindent
-Um eine Notenhöhe um zwei oder mehr Oktaven zu verändern,
+Um eine Notenhöhe um zwei (oder mehr!) Oktaven zu verändern,
 werden sukzessive @code{''} oder @code{,,} benutzt -- es muss
 sich dabei wirklich um zwei einzelne Apostrophen und nicht um das
-Anführungszeichen @code{"}@tie{} (Taste Shift+2) handeln. Auch
-die Anfangsoktave für einen @code{\relative c'}-Abschnitt kann so
+Anführungszeichen @code{"}@tie{} (Taste Shift+2) handeln! Auch
+die Anfangsoktave für einen @w{@code{\relative c'}}-Abschnitt kann so
 verändert werden.
 
 @subheading Durations (rhythms)
 
-Die @rglos{duration} einer Note wird durch eine Zahl bezeichnet,
+Glossar: @rglos{beam}, @rglos{duration},
+@rglos{whole note}, @rglos{half note}, @rglos{quarter note},
+@rglos{dotted note}.
+
+Die @notation{Dauer} einer Note wird durch eine Zahl bezeichnet,
 die direkt auf den Notennamen folgend eingegeben wird.
-  @q{1} für eine @rglos{whole note}, @q{2} für eine @rglos{half note},
-@q{4} für eine @rglos{quarter note} und so weiter.  Notenhälse
-werden automatisch hinzugefügt.
+@code{1} für eine @notation{ganze Note}, @code{2} für eine 
+@notation{halbe Note}, @code{4} für eine @notation{Viertelnote} 
+und so weiter. @notation{Notenhälse} und @notation{Balken} werden
+automatisch hinzugefügt.
 
-@lilypond[quote,ragged-right,verbatim]
+Wenn keine Dauer bezeichnet wird, wird die der vorhergehenden Note
+verwendet. Für die erste Note ist eine Viertel als Standard definiert.
+
+@lilypond[verbatim,quote]
 \relative c'' {
   a1
   a2 a4 a8 a
@@ -334,14 +365,12 @@ werden automatisch hinzugefügt.
 }
 @end lilypond
 
-@noindent
-Wenn keine Dauer bezeichnet wird, wird die der vorhergehenden Note
-verwendet. Für die erste Note ist eine Viertel als Standard definiert.
-
-Um @rglos{dotted note}s zu erzeugen, wird einfach ein Punkt @q{.}
-hinter die Notendauer geschrieben.
+Um @notation{punktierte Noten} zu erzeugen, wird einfach ein Punkt 
+@code{.} hinter die Notendauer geschrieben. Die Dauer einer 
+punktierten Note muss explizit, also inklusive der Nummer, 
+angegeben werden.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   a a a4. a8
   a8. a16 a a8. a8 a4.
@@ -351,10 +380,10 @@ hinter die Notendauer geschrieben.
 
 @subheading Rests
 
-Eine @rglos{rest} wird genauso wie eine Noten eingegeben; ihre
-Bezeichnung ist @q{r}.
+Eine @notation{Pause} wird genauso wie eine Noten eingegeben; ihre
+Bezeichnung ist @code{r}@tie{}:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   a r r2
   r8 a r4 r4. r8
@@ -364,9 +393,12 @@ Bezeichnung ist @q{r}.
 
 @subheading Time signature
 
-Die @rglos{time signature} kann mit dem @code{\time}-Befehl definiert werden:
+Glossar: @rglos{time signature}.
+
+Die @notation{Taktart} kann mit dem 
+@code{\time}-Befehl definiert werden:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   \time 3/4
   a4 a a
@@ -380,9 +412,12 @@ Die @rglos{time signature} kann mit dem @code{\time}-Befehl definiert werden:
 
 @subheading Clef
 
-Der @rglos{clef} kann mit dem @code{\clef}-Befehl gesetzt werden:
+Glossar: @rglos{time signature}.
 
-@lilypond[quote,ragged-right,verbatim]
+Der @notation{Notenschlüssel} kann mit dem @code{\clef}-Befehl 
+gesetzt werden:
+
+@lilypond[verbatim,quote]
 \relative c' {
   \clef treble
   c1
@@ -400,7 +435,7 @@ Der @rglos{clef} kann mit dem @code{\clef}-Befehl gesetzt werden:
 
 Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c, {
   \time 3/4
   \clef bass
@@ -409,27 +444,19 @@ Hier ist ein kleines Beispiel, dass all diese Definitionen beinhaltet:
 }
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Eingabe von Tonhöhen und -dauern
-siehe @ref{Pitches} und @ref{Durations}.
-@item Pausen
-siehe @ref{Rests}.
-@item Taktangeben und andere Zeitangaben
-siehe @ref{Time signature}.
-@item Notenschlüssel
-siehe @ref{Clef}.
-@end table
-@end quotation
+@seealso
+Benutzerhandbuch: @ruser{Writing pitches},
+@ruser{Writing rhythms}, @ruser{Writing rests},
+@ruser{Time signature}, @ruser{Clef}.
+
 
 
-@node Working on text files
-@subsection Working on text files
+@node Working on input files
+@subsection Working on input files
 
 LilyPonds Quelldateien ähneln Dateien in den meisten
 Programmiersprachen: Es ist auf Groß- und Kleinschreibung
-zu achten und Leerzeichen sind gleichwertig. Ausdrücke werden 
+zu achten und Leerzeichen werden ignoriert. Ausdrücke werden 
 mit geschweiften Klammern @{ @} eingeklammert und Kommentare 
 mit dem Prozentzeichen @code{%} auskommentiert
 oder mit @code{%@{ ... %@}} umgeben.
@@ -441,18 +468,19 @@ Wenn das jetzt unverständlich erscheint, sind hier die  Erklärungen:
 @cindex Groß- und Kleinschreibung
 @cindex Kleinbuchstaben
 @cindex Großbuchstaben
-@item @strong{Groß- und Kleinschreibung:}
+@item
+@strong{Groß- und Kleinschreibung:}
 Die Bedeutung eines Zeichens verändert sich, je
-nachdem, ob es groß (@code{A, B, S, T}) oder klein
- (@code{a, b, s, t}) geschrieben wird. Noten müssen
-immer klein geschrieben werden,  @code{@{ c d e @}} funktioniert,
-während @code{@{ C D E @}} einen Fehler produziert.
+nachdem, ob es groß (@w{@code{A, B, S, T}}) oder klein
+ (@w{@code{a, b, s, t}}) geschrieben wird. Noten müssen
+immer klein geschrieben werden,  @w{@code{@{ c d e @}}} funktioniert,
+während @w{@code{@{ C D E @}}} einen Fehler produziert.
 
 @item @strong{Leerzeichen:}
 Es spielt keine Rolle, wie viele Leerzeichen oder leere Zeilen sich zwischen
 den Zeichen der Quelldatei befinden.
-  @code{@{ c d e @}} bedeutet das Gleiche wie
- @code{@{ c @ @ @ @ @  d e @}} oder
+@w{@code{@{ c d e @}}} bedeutet das Gleiche wie
+@w{@code{@{ c @ @ @ @ @  d e @}}} oder
 @example
           @{
 c                        d
@@ -461,11 +489,11 @@ c                        d
 
 @noindent
 Natürlich ist das letzte Beispiel etwas schwer zu lesen. Eine gute Daumenregel
-ist es, Code-Blöcke mit der Tab-Taste oder zwei Leerzeichen einzurücken,
+ist es, Code-Blöcke mit der Tab-Taste oder zwei Leerzeichen einzurücken:
 @example
 @{
   c d e
-@}.
+@}
 @end example
 
 @item @strong{Ausdrücke:}
@@ -474,25 +502,40 @@ Auch der kleinste Abschnitt an LilyPond-Code muss in
 Klammern zeigen LilyPond an, dass es sich um einen zusammengehörenden
 musikalischen Ausdruck handelt, genauso wie Klammern @q{()} in der Mathematik.
 Die Klammern sollten von jeweils einem Leerzeichen umgeben sein, um
-Zweideutigkeiten
-auszuschließen, es sei denn, sie
+Zweideutigkeiten auszuschließen, es sei denn, sie
 befinden sich am Anfang oder Ende einer Zeile.
-Eine Funktion (wie etwa @code{\relative @{ @}}) wird auch als ein einzelner
-Musikausdruck gewertet.
+Ein LilyPond-Befehl gefolgt von einem einfachen Ausdruck
+in Klammern (wie etwa @code{\relative @{ @}}) 
+wird auch als ein einzelner Musikausdruck gewertet.
 
 @cindex Kommentare
 @cindex Zeilenkommentare
 @cindex Blockkommentare
-@item @strong{Kommentare:}
+@item 
+@strong{Kommentare:}
 Ein Kommentar ist eine Bemerkung für den menschlichen Leser
 einer Quelldatei, es wird bei der Dateianalyse durch das Programm
 ignoriert, so dass es also keine Auswirkung auf die Druckausgabe der
 Noten hat. Es gibt zwei verschiedene Typen von Kommentaren. Das
 Prozentzeichen @q{%} geht einem Zeilen-Kommentar voraus: Alles
-nach diesem Zeichen wird in dieser Zeile ignoriert. Ein Block-Kommentar
-ist ein ganzer Abschnitt mit einem Kommentar. Alles, was von @code{%@{}
- und @code{%@}} umgeben ist, wird ignoriert. (Kommentare könne nicht 
-geschachtelt werden.) Das folgende Beispiel zeigt
+nach diesem Zeichen wird in dieser Zeile ignoriert. 
+Üblicherweise wird ein Kommentar @emph{über} dem Code gesetzt,
+auf den es sich bezieht.
+
+@example
+a4 a a a
+% Dieser Kommentar bezieht sich auf das H
+b2 b
+@end example
+
+
+Ein Block-Kommentar ist ein ganzer Abschnitt mit einem
+Kommentar. Alles, was von @code{%@{}
+und @code{%@}} umgeben ist, wird ignoriert. Das heißt,
+dass sich ein Block-Kommentar nicht ein einem anderen
+Blockkommentar befinden kann. Wenn Sie das versuchen sollten,
+beendet schon das erste @code{%@}} @emph{beide} 
+Block-Kommentare. Das folgende Beispiel zeigt eine
 mögliche Anwendung von Kommentaren:
 
 @example
@@ -504,31 +547,24 @@ mögliche Anwendung von Kommentaren:
     ignoriert, weil sie sich in einem Block-Kommentar
     befinden.
 
-    g g f f e e d d c2
+    f f e e d d c2
 %@}
 @end example
 
 @end itemize
 
-Weitere Vorschläge zur Konstruktion von Quelldateien
-finden sich in
-@ref{Suggestions for writing LilyPond files}.
-
 
-@node How to read the tutorial
-@subsection How to read the tutorial
+@node How to read the manual
+@subsection How to read the manual
 
-Wie wir in @ref{Working on text files} gesehen haben, muss LilyPond-Code
-immer von  @{ @} Zeichen oder einem @code{\relative c'' @{ ... @}} umgeben sein.
+LilyPond-Code muss immer von  @{ @} Zeichen oder einem 
+@w{@code{\relative c'' @{ ... @}}} umgeben sein, wie
+gezeigt in @ref{Working on input files}.
 Im Rest dieses Handbuchs werden die meisten Beispiel allerdings darauf
-verzichten.
-
-Wenn Sie in der HTML-Version der Dokumentation lesen und den exakten
-LilyPond-Code eines Notenbildes sehen wollen, klicken Sie einfach auf
-das Notenbild. Wenn Sie nicht die HTML-Version lesen, können Sie die
-angezeigten
-Code-Beispiele kopieren und in einen Editor einfügen. Sie müssen dabei
-aber @code{\relative c'' @{ @}} einfügen, wie hier gezeigt:
+verzichten. Um sie zu reproduzieren, können Sie den entsprechenden 
+Quellcode kopieren und in eine Textdatei einfügen, aber Sie 
+@strong{müssen} dabei
+@w{@code{\relative c'' @{ @}}} einfügen, wie hier gezeigt:
 
 @example
 \relative c'' @{
@@ -539,11 +575,48 @@ aber @code{\relative c'' @{ @}} einfügen, wie hier gezeigt:
 Warum werden die Klammern hier meist weggelassen? Die meisten
 der Beispiele können in ein längeres Musikstück hineinkopiert
 werden, und dann ist es natürlich nicht sinnvoll, wenn auch noch
-@code{\relative c'' @{ @}} dazukommt; ein @code{\relative} sollte
+@w{@code{\relative c'' @{ @}}} dazukommt; ein @code{\relative} darf
 nicht innerhalb eines anderen @code{\relative} gesetzt werden,
 deshalb wird es hier weggelassen, damit die Beispiele auch innerhalb
-eines anderen Kontextes funktionieren.
+eines anderen Kontextes funktionieren. Wenn bei jedem 
+Beispiel @w{@code{\relative c'' @{ @}}} eingesetzt würde,
+könnten Sie die kleinen Beispiele der Dokumentation
+nicht einfach zu Ihrem eigenen Notentext hinzufügen. 
+Die meisten Benutzer wollen 
+Noten zu einer schon bestehenden Datei irgendwo in der Mitte
+hinzufügen, deshalb wurde der relative Modus für die Beispiele
+im Handbuch weggelassen.
+
+@subheading Clickable examples
+
+Viele Leute lernen Programme, indem sie einfach herumprobieren. Das
+geht auch mit LilyPond. Wenn Sie in der HTML-Version dieses Handbuchs
+eine Abbildung anklicken, erhalten sie exakt den LilyPond-Code, der
+zum Satz der Abbildung benutzt wurde. Versuchen Sie es mit dieser
+Abbildung:
+
+@c no verbatim here
+@c KEEP LY
+@lilypond[quote]
+\relative c'' {
+  c-\markup { \bold \huge { Hier klicken!  } }
+}
+@end lilypond
+
+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. Damit Sie genau das gleiche Erscheinungsbild wie 
+bei dem Beispiel selber erreichen, müssen Sie alles kopieren ab der 
+Zeile @qq{Start
+cut-&-pastable section} bis ganz zum Ende der Datei.
+
+@seealso
 
+Mehr Hinweise dazu, wie LilyPond-Eingabedateien konstruiert werden 
+sollten, finden sich in @ref{Suggestions for writing LilyPond input files}. 
+Es ist aber wahrscheinlich am Besten, zuerst
+die gesamte Übung zu lesen.
 
 
 @node Single staff notation
@@ -553,52 +626,15 @@ Dieses Kapitel lehrt grundlegende Bestandteile der Notation,
 die für eine Stimme auf einem System gebraucht werden.
 
 @menu
-* Relative note names::
-* Accidentals and key signatures::
-* Ties and slurs::
-* Articulation and dynamics::
-* Automatic and manual beams::
-* Advanced rhythmic commands::
+* Accidentals and key signatures::  
+* Ties and slurs::              
+* Articulation and dynamics::   
+* Adding text::                 
+* Automatic and manual beams::  
+* Advanced rhythmic commands::  
 @end menu
 
 
-@node Relative note names
-@subsection Relative note names
-
-Wie wir im Kapitel @ref{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
-der relative Modus viel einfacher und sicherer zu benutzen.} Wenn
-keine
-zusätzlichen Oktavierungszeichen (@code{'} und @code{,}) gesetzt sind,
-wird angenommen, dass die folgende Tonhöhe sich innerhalb einer Quarte in
-Bezug auf die vorhergehende befindet.
-
-LilyPond errechnet die Tonhöhen aus den Notenbezeichnungen -- eine
-übermäßige Quarte ist also @emph{nicht} das selbe wie eine verminderte
-Quinte. Wenn wir von C aus rechnen, wird ein Fis höher als das C
-gesetzt,
-während ein Ges in der Quarte @emph{unter} dem C gesetzt wird.
-
-
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
-c2 fis
-c2 ges
-@end lilypond
-
-@moreinfo
-@quotation
-@table @asis
-@item Relativer Oktaveintrag
-siehe @ref{Relative octaves}.
-@item Oktaveüberprüfung
-siehe @ref{Octave check}.
-@end table
-@end quotation
-
-
-
 @node Accidentals and key signatures
 @subsection Accidentals and key signatures
 
@@ -606,21 +642,24 @@ siehe @ref{Octave check}.
 @cindex Versetzungszeichen
 @cindex Akzidentien
 
-Ein @rglos{sharp}-Versetzungszeichen@footnote{In der Umgangssprache
+Glossar: @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
+@rglos{double flat}, @rglos{accidental}.
+
+Ein @notation{Kreuz}-Versetzungszeichen@footnote{In der Umgangssprache
 werden die Versetzungszeichen häufig auch Vorzeichen genannt. In 
 diesem Handbuch wird jedoch zwischen Vorzeichen zur generellen Angabe
-der Tonart und den Versetzungszeichen, die direkt im Notentext erscheinen, 
-unterschieden.} wird eingegeben, indem an den
-Notennamen ein @q{is} gehängt wird, ein  @rglos{flat}-Vorzeichen
+der Tonart und den Versetzungszeichen, die direkt im Notentext
+erscheinen, unterschieden.} wird eingegeben, indem an den
+Notennamen ein @q{is} gehängt wird, ein  @notation{B}-Versetzungszeichen
 durch Anhängen von @q{es}. Logischerweise wird dann ein
- @rglos{double sharp} oder @rglos{double flat} durch Anhängen
-von @q{isis} oder @q{eses} geschrieben.@footnote{Diese Syntax
+ @notation{Doppelkreuz} oder @notation{Doppel-B} durch Anhängen
+von @q{isis} oder @q{eses} geschrieben. 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}.}
+deutsche Benutzer kein Problem. Es ist aber möglich, die Namen für die 
+@notation{Versetzungszeichen} in anderen
+Sprachen zu benutzen, siehe @ruser{Note names in other languages}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 cis1 ees fisis, aeses
 @end lilypond
 
@@ -628,21 +667,29 @@ cis1 ees fisis, aeses
 @cindex Vorzeichen
 @subheading Key signatures
 
-Die Tonart eines Stückes wird erstellt mit dem Befehl @code{\key}, gefolgt
-von einer Notenbezeichnung und  @code{\major} (für Dur) oder @code{\minor}
+Glossar: @rglos{key signature}, @rglos{major},
+@rglos{minor}.
+
+Die @notation{Tonart} eines Stückes wird erstellt mit dem 
+Befehl @code{\key}, gefolgt von einer Notenbezeichnung und  
+@code{\major} (für Dur) oder @code{\minor}
 (für Moll).
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 \key d \major
 a1
 \key c \minor
 a
 @end lilypond
 
-@sp 1
+@smallspace
 
 @subheading Warning: key signatures and pitches
 
+Glossar: @rglos{accidental}, @rglos{key signature},
+@rglos{pitch}, @rglos{flat}, @rglos{natural}, @rglos{sharp},
+@rglos{transposition}.
+
 Um zu bestimmen, ob vor einer bestimmten Note ein Versetzungszeichen
 erscheinen soll, untersucht LilyPond die Notenhöhen und die
 Tonart. Die Tonart beeinflusst nur die @emph{gedruckten}
@@ -651,12 +698,13 @@ scheint am Anfang oft verwirrend, so dass sie hier etwas
 genauer betrachtet wird.
 
 LilyPond unterscheidet strickt zwischen dem musikalischen Inhalt
-und dem Satz (Layout). Die Alteration (Kreuz, Auflösungszeichen
-oder b) einer Note gehört zur Tonhöhe dazu und ist deshalb
-musikalischer
-Inhalt. Ob ein Versetzungszeichen (also ein @emph{gedrucktes} Kreuz, b oder
-Auflösungszeichen) auch vor der Note erscheint, hängt vom Kontext, also
-vom Layout ab. Das Layout gehorcht bestimmten Regeln, und Versetzungszeichen
+und dem Satz (Layout). Die Alteration (@notation{B}, 
+@notation{Kreuz} oder @notation{Auflösungszeichen}) einer Note gehört 
+zur Tonhöhe dazu und ist deshalb musikalischer
+Inhalt. Ob ein Versetzungszeichen (also ein @emph{gedrucktes} Kreuz, b
+oder Auflösungszeichen) auch vor der Note erscheint, hängt vom Kontext,
+also vom Layout ab. Das Layout gehorcht bestimmten Regeln, und
+Versetzungszeichen
 werden automatisch nach diesen Regeln gesetzt. Die Versetzungszeichen im
 fertigen Notenbild sind nach den Regeln des Notensatzes gesetzt. Deshalb
 wird automatisch entschieden, wo sie erscheinen, und man muss
@@ -664,14 +712,14 @@ den Ton eingeben, den man @emph{hören} will.
 
 In diesem Beispiel
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 \key d \major
 d cis fis
 @end lilypond
 
 @noindent
-hat keine Note ein Versetzungszeichen, trotzdem muss im Quelltext das
- @q{is} für @code{cis} und @code{fis} notiert werden.
+hat keine der Noten ein Versetzungszeichen, trotzdem muss im Quelltext
+das @q{is} für @code{cis} und @code{fis} notiert werden.
 
 Der Code @q{e} heißt also nicht: @qq{Zeichne einen schwarzen Punkt
 auf die erste Linie des Systems.} Im Gegenteil, er heißt vielmehr:
@@ -679,28 +727,26 @@ auf die erste Linie des Systems.} Im Gegenteil, er heißt vielmehr:
 In der Tonart As-Dur @emph{bekommt} sie ein Versetzungszeichen:
 
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 \key aes \major
 e
 @end lilypond
 
 Alle diese Versetzungszeichen ausdrücklich zu schreiben, bedeutet vielleicht
-etwas mehr Schreibarbeit, hat aber den großen Vorteil, das
-Transposition
-sehr viel einfacher gemacht wird und der Druck von Versetzungszeichen nach
+etwas mehr Schreibarbeit, hat aber den großen Vorteil, dass
+@notation{Transpositionen} 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
-@quotation
-@table @asis
-@item Versetzungszeichen
-siehe @ref{Accidentals} und @ref{Automatic accidentals}.
-@item Tonart (Vorzeichen)
-siehe @ref{Key signature}.
-@end table
-@end quotation
+@seealso
+
+Benutzerhandbuch: @ruser{Note names in other languages},
+@ruser{Accidentals}, @ruser{Automatic accidentals},
+@ruser{Key signature}.
+
+Glossar: @rglos{Pitch names}.
 
 
 @node Ties and slurs
@@ -708,10 +754,13 @@ siehe @ref{Key signature}.
 
 @cindex Bindebögen
 @subheading Ties
-Ein @rglos{tie} wird geschrieben, indem man eine Tilde @q{~} and die
-erste der zu verbindenden Noten hängt.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+Glossar: @rglos{tie}.
+
+Ein @notation{Bindebogen} wird geschrieben, indem man eine Tilde @code{~} 
+an die erste der zu verbindenden Noten hängt.
+
+@lilypond[verbatim,quote,fragment,relative=2]
 g4~ g c2~
 c4 ~ c8 a8 ~ a2
 @end lilypond
@@ -719,11 +768,13 @@ c4 ~ c8 a8 ~ a2
 @cindex Legatobögen
 @subheading Slurs
 
-Ein @rglos{slur} ist ein Bogen, der sich über mehrere Noten ersetreckt. Die
-Note, and der er beginnt, und die Note, an der er endet, werden mit
- @q{(} beziehungsweise @q{)} markiert.
+Glossar: @rglos{slur}.
+
+Ein @notation{Legatobogen} ist ein Bogen, der sich über mehrere Noten
+erstreckt. Seine 
+Beginn- und Endnote werden mit @q{(} beziehungsweise @q{)} markiert.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 d4( c16) cis( d e c cis d) e( d4)
 @end lilypond
 
@@ -732,6 +783,8 @@ d4( c16) cis( d e c cis d) e( d4)
 
 @subheading Phrasing slurs
 
+Glossar: @rglos{slur}, @rglos{phrasing}.
+
 Bögen, die längere Phrasierungseinheiten markieren
 (Phrasierungsbögen), werden mit @code{\(} und
 @code{\)} eingegeben.  Es können sowohl Legato- als auch
@@ -739,7 +792,7 @@ Phrasierungsbögen gleichzeitig vorkommen, aber es kann nicht mehr
 als jeweils einen Legato- und einen Phrasierungsbogen gleichzeitig
 geben.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,fragment,relative=2]
 a8(\( ais b c) cis2 b'2 a4 cis,\)
 @end lilypond
 
@@ -748,6 +801,8 @@ a8(\( ais b c) cis2 b'2 a4 cis,\)
 @cindex Binde- versus Legatobogen
 @subheading Warnings: slurs vs. ties
 
+Glossar: @rglos{articulation}, @rglos{slur}, @rglos{tie}.
+
 Ein Legatobogen sieht aus wie ein @rglos{tie}, hat aber eine 
 andere Bedeutung. Ein Bindebogen verlängert nur die vorhergehende
 Note und kann also nur bei zwei Noten gleicher Tonhöhe benutzt werden.
@@ -755,21 +810,14 @@ Legatobögen dagegen zeigen die Artikulation von Noten an und können
 für größere Notengruppen gesetzt werden. Binde- und Legatobögen können
 geschachtelt werden.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2~( c8 fis fis4 ~ fis2 g2)
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Bindebögen
-siehe @ref{Ties}.
-@item Legatobögen
-siehe @ref{Slurs}.
-@item Phrasierungsbögen
-siehe @ref{Phrasing slurs}.
-@end table
-@end quotation
+@seealso
+
+Benutzerhandbuch: @ruser{Ties}, @ruser{Slurs},
+@ruser{Phrasing slurs}.
 
 
 @node Articulation and dynamics
@@ -780,39 +828,49 @@ siehe @ref{Phrasing slurs}.
 @cindex Staccato
 @subheading Articulations
 
-Übliche @rglos{articulation}s können durch Anfügen von Minus
+Glossar: @rglos{articulation}.
+
+Übliche @notation{Artikulationszeichen} können durch Anfügen von Minus
 (@q{-}) und einem entsprechenden Zeichen eingegeben werden:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c-. c-- c-> c-^ c-+ c-_
 @end lilypond
 
 @cindex Fingersatz
 @subheading Fingerings
+
+Glossar: @rglos{fingering}.
+
 Auf gleiche Weise können Fingersatzbezeichnungen hinzugefügt
 werden, indem nach dem Minus (@q{-}) eine Zahl geschrieben wird:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c-3 e-5 b-2 a-1
 @end lilypond
 
 Artikulationszeichen und Fingersätze werden normalerweise
 automatisch platziert, aber man kann ihre Position auch vorgeben
 durch die Zeichen @q{^} (oben) oder @q{_} (unten) anstelle
-des Minus.  An eine Note können auch mehrfache Artikulationszeichen
+des Minuszeichen. An eine Note können auch mehrfache
+Artikulationszeichen
 gehängt werden. Meistens findet aber LilyPond alleine die beste
 Möglichkeit, wie die Artikulationen platziert werden sollen.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c_-^1 d^. f^4_2-> e^-_+
 @end lilypond
 
 @subheading Dynamics
+
+Glossar: @rglos{dynamics}, @rglos{crescendo},
+@rglos{decrescendo}.
+
 Die Dynamik innerhalb eines Stückes wird eingegeben, indem man
-die Markierungen (mit einem Backslash, @q{@value{backslash}}) an die Note
-hängt:
+die Markierungen (mit einem Backslash) an 
+die Note hängt:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c\ff c\mf c\p c\pp
 @end lilypond
 
@@ -821,58 +879,82 @@ c\ff c\mf c\p c\pp
 @cindex Decrescendo
 @cindex Crescendo
 
-Crescendo und Decrescendo werden mit dem Befehl @code{\<}
-beziehungsweise @code{\>} begonnen.  Ein Dynamik-Zeichen, etwa
- @code{\f}, beendet das (De)Crescendo. Auch mit dem Befehl
- @code{\!} kann es explizit beendet werden.
+@notation{Crescendi} und @notation{Decrescendi} werden mit dem 
+Befehl @code{\<}
+beziehungsweise @code{\>} begonnen.  Das nächste absolute 
+Dynamik-Zeichen, etwa @code{\f}, beendet das (De)Crescendo. 
+Auch mit dem Befehl @code{\!} kann es explizit beendet werden.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2\< c2\ff\> c2 c2\!
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Artikulationszeichen
-siehe @ref{Articulations}.
-@item Fingersatz
-siehe @ref{Fingering instructions}.
-@item Dynamik
-siehe @ref{Dynamics}.
-@end table
-@end quotation
+@seealso
+
+Benutzerhandbuch: @ruser{Articulations and ornamentations},
+@ruser{Fingering instructions}, @ruser{Dynamics}.
+
+
+@node Adding text
+@subsection Adding text
+
+Text können Sie auf folgende Art in die Partitur einfügen:
+
+@lilypond[verbatim,quote,relative=2]
+c1^"espr" a_"legato"
+@end lilypond
+
+Zusätzliche Formatierung kann eingesetzt werden, wenn Sie den
+@code{\markup}-Befehl benutzen:
+
+@lilypond[verbatim,quote,relative=2]
+c1^\markup{ \bold espr}
+a1_\markup{
+  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
+}
+@end lilypond
+
+@seealso
+
+Benutzerhandbuch: @ruser{Writing text}.
 
 
 @node Automatic and manual beams
 @subsection Automatic and manual beams
 
 @cindex Balken, manuell
-Alle @rglos{beam} werden automatisch gesetzt:
+Alle @notation{Balken} werden automatisch gesetzt:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a8 ais d ees r d c16 b a8
 @end lilypond
 
 @noindent
 Wenn diese automatisch gesetzten Balken nicht gewollt sind,
-können sie manuell geändert werden. Die Note, an der der Balken
-anfängt, erhält ein @q{[} (AltGr+8) und die, an der er endet, ein 
+können sie manuell geändert werden. Wenn nur ein Balken
+hier und da korrigiert werde muss, erhält die Note, an der der Balken
+anfängt, ein @q{[} (AltGr+8) und die, an der er enden soll, ein 
 @q{]} (AltGr+9).
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a8[ ais] d[ ees r d] a b
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Automatische Balken
-siehe @ref{Automatic beams}.
-@item Manuelle Balken
-siehe @ref{Manual beams}.
-@end table
-@end quotation
+Wenn Sie die automatischen Balken vollständig oder für 
+einen längeren Abschnitt ausschalten wollen, benutzen Sie
+den Befehl @code{\autoBeamOff}, um die Balken abzuschalten,
+und @code{\autoBeamOn}, um sie wieder einzuschalten.
+
+@lilypond[verbatim,quote,relative=2]
+\autoBeamOff
+a8 c b4 d8. c16 b4
+\autoBeamOn
+a8 c b4 d8. c16 b4
+@end lilypond
+
+@seealso
 
+Benutzerhandbuch: @ruser{Automatic beams}, @ruser{Manual beams}.
 
 @node Advanced rhythmic commands
 @subsection Advanced rhythmic commands
@@ -881,26 +963,30 @@ siehe @ref{Manual beams}.
 @cindex Auftakt
 @subheading Partial measure
 
-Ein @rglos{anacrusis} wird mit dem Befehl @code{\partial}
+Ein @notation{Auftakt} wird mit dem Befehl @code{\partial}
 eingegeben. Darauf folgt die Länge des Auftaktes: @code{\partial 4}
 heißt eine Viertelnote Auftakt und @code{\partial 8} eine Achtelnote.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \partial 8
 f8 c2 d
 @end lilypond
 
 @cindex N-tolen
 @cindex Triolen
+@cindex Rhythmische Aufteilungen
 @subheading Tuplets
 
-Triolen und N-tolen werden mit dem @code{\times}-Befehl erzeugt. Er braucht
+Glossar: @rglos{note value}, @rglos{triplet}.
+
+@notation{Triolen} und @notation{N-tolen} werden mit dem 
+@code{\times}-Befehl erzeugt. Er braucht
 zwei Argumente: einen Bruch und die Noten, auf die er sich bezieht.
-Die Dauer des Abschnittes wird mit dem Bruch multipliziert. In einer Triole
-dauern die Noten 2/3 ihrer normalen Länge, also hat eine Triole 2/3 als
-Bruch:
+Die Dauer des Abschnittes wird mit dem Bruch multipliziert. 
+In einer Triole dauern die Noten 2/3 ihrer normalen Länge, 
+also hat eine Triole 2/3 als Bruch:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 \times 2/3 { f8 g a }
 \times 2/3 { c r c }
 \times 2/3 { f,8 g16[ a g a] }
@@ -912,27 +998,23 @@ Bruch:
 @cindex Vorhalt
 @subheading Grace notes
 
+Glossar: @rglos{grace notes}, @rglos{acciaccatura},
+@rglos{appoggiatura}.
+
 Verzierungen werden mit dem Befehl @code{\grace}
 eingegeben, Vorhalte durch den Befehl @code{\appoggiatura}
 und Vorschläge mit @code{\acciaccatura}.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 c2 \grace { a32[ b] } c2
 c2 \appoggiatura b16 c2
 c2 \acciaccatura b16 c2
 @end lilypond
 
-@moreinfo
-@quotation
-@table @asis
-@item Vorschläge, Verzierungen
-siehe @ref{Grace notes},
-@item Triolen
-siehe @ref{Tuplets},
-@item Auftakt
-siehe @ref{Partial measures}.
-@end table
-@end quotation
+@seealso
+
+Benutzerhandbuch: @ruser{Grace notes}, @ruser{Tuplets},
+@ruser{Upbeats}.
 
 
 @node Multiple notes at once
@@ -949,31 +1031,33 @@ in einem Stück. Polyphonie bzw. Mehrstimmigkeit heißt für LilyPond allerdings
 das Vorkommen von mehr als einer Stimme pro System.
 
 @menu
-* Music expressions explained::
-* Multiple staves::
-* Piano staves::
-* Single staff polyphony::
-* Combining notes into chords::
+* Music expressions explained::  
+* Multiple staves::             
+* Staff groups::                
+* Combining notes into chords::  
+* Single staff polyphony::      
 @end menu
 
 
 @cindex Musikalischer Ausdruck
+@cindex Ausdruck
 @node Music expressions explained
 @subsection Music expressions explained
 
 In LilyPond-Quelldateien wird Musik durch  @emph{musikalische
 Ausdrücke} dargestellt. Eine einzelne Note ist ein musikalischer
-Ausdruck, auch wenn sie ganz allein ohne Kontext keinen gültigen
-Code darstellt.
+Ausdruck.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 a4
 @end lilypond
 
 Eine Gruppe von Noten innerhalb von Klammern bildet einen neuen
-Ausdruck.
+Ausdruck. Dieser ist nun ein @emph{zusammengesetzter musikalischer 
+Ausdruck}. Hier wurde solch ein zusammengesetzter musikalischer 
+Ausdruck mit zwei Noten erstellt:
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 { a4 g4 }
 @end lilypond
 
@@ -982,23 +1066,55 @@ Noten) in geschweifte Klammern gesetzt wird, bedeutet das, dass eine
 Gruppe nach der anderen gesetzt wird. Das Resultat ist ein neuer
 musikalischer Ausdruck.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 { { a4 g } f g }
 @end lilypond
 
+
+@subheading Analogy: mathematical expressions
+
+Die Anordnung von Ausrücken funktioniert ähnlich wie mathematische
+Gleichungen. Eine längere Gleichung entsteht durch die
+Kombination kleinerer Gleichungen. Solche Gleichungen
+werden auch Ausdruck genannt und ihre Definition ist
+rekursiv, sodass beliebig komplexe und lange Ausdrücke
+erstellt werden können. So etwa hier:
+
+@example
+1
+
+1 + 2
+
+(1 + 2) * 3
+
+((1 + 2) * 3) / (4 * 5)
+@end example
+
+Das ist eine Folge von (mathematischen) Ausdrücken, in denen
+jeder Ausdruck in dem folgenden (größeren) enthalten ist. Die
+einfachsten Ausdrücke sind Zahlen, und größere werden durch die
+Kombination von Ausdrücken mit Hilfe von Operatoren (wie @q{+},
+@q{*} und @q{/}) sowie Klammern. Genauso wie mathematische
+Ausdrücke können auch musikalische Ausdrücke beliebig tief verschachtelt
+werden. Das wird benötigt für komplexe Musik mit vielen Stimmen.
+
+
 @subheading Simultaneous music expressions: multiple staves
 
-Mit dieser Technik kann polyphone Musik gesetzt werden. Musikalische
-Ausdrücke werden einfach paralell kombiniert, damit sie gleichzeitig
+Glossar: @rglos{polyphony}.
+
+
+Mit dieser Technik kann @notation{polyphone} Musik gesetzt werden.
+Musikalische
+Ausdrücke werden einfach parallel kombiniert, damit sie gleichzeitig
 als eigene Stimmen in dem gleichen Notensystem gesetzt werden. Um
 anzuzeigen, dass an dieser Stelle gleichzeitige Noten gesetzt werden,
 muss nur ein Kombinationszeichen eingefügt werden. Parallel werden
-musikalische Ausdrücke kombiniert, indem man sie mit @code{<<} und @code{>>}
-einrahmt. Im folgenden Beispiel sind drei Ausdrücke (jeder mit zwei
-Noten)
-parallel kombiniert:
+musikalische Ausdrücke kombiniert, indem man sie mit @code{<<} und 
+@code{>>} einrahmt. Im folgenden Beispiel sind drei Ausdrücke 
+(jeder mit zwei Noten) parallel kombiniert:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
     { a4 g }
@@ -1010,28 +1126,27 @@ parallel kombiniert:
 
 Es ist noch zu bemerken, dass wir hier für jede Ebene innerhalb der
 Quelldatei eine andere Einrückung geschrieben haben. Für LilyPond
-spielt es keine Rolle, wieviel Leerzeichen am Anfang einer Zeile sind,
+spielt es keine Rolle, wie viele Leerzeichen am Anfang einer Zeile sind,
 aber für Menschen ist es eine große Hilfe, sofort zu sehen, welche
 Teile des Quelltextes zusammen gehören.
 
-@strong{Warnung}: Jede Note ist relativ zu der vorhergehenden in der
+@warning{Jede Note ist relativ zu der vorhergehenden in der
 Datei, nicht relativ zu dem zweigestrichenen C (@code{c''}), das im
-@code{\relative}-Befehl angegeben ist. Die Klammern haben darauf
-keinen Einfluss.
+@code{@bs{}relative}-Befehl angegeben ist. Die Klammern haben darauf
+keinen Einfluss.}
 
 
 @subheading Simultaneous music expressions: single staff
 
-Um die Anzahl der Notensysteme zu bestimmen, analysiert LilyPond den
-ersten Ausdruck. Wenn es sich um eine einzelne Note handelt, wird nur
+Um die Anzahl der Notensysteme zu bestimmen, analysiert 
+LilyPond den Anfang des ersten Ausdrucks. Wenn sich hier
+eine einzelne Note befindet, wird nur
 ein System gesetzt, wenn es sich um eine parallele Anordnung von
-Ausdrücken
-handelt, wird mehr als ein System gesetzt. Das folgende Beispiel
-beginnt
-mit einer Note:
+Ausdrücken handelt, wird mehr als ein System gesetzt. Das 
+folgende Beispiel beginnt mit einer Note:
 
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   c2 <<c e>>
   << { e f } { c <<b d>> } >>
@@ -1039,34 +1154,6 @@ mit einer Note:
 @end lilypond
 
 
-@subheading Analogy: mathematical expressions
-
-Die Anordnung von Ausrücken funktioniert ähnlich wie mathematische
-Gleichungen. Eine längere Gleichung entsteht durch die
-Kombination kleinerer Gleichungen. Solche Gleichungen
-werderden auch Ausdruck genannt und ihre Definition ist
-rekursiv, sodass beliebig komplexe und lange Ausdrücke
-erstellt werden können. So etwa hier:
-
-@example
-1
-
-1 + 2
-
-(1 + 2) * 3
-
-((1 + 2) * 3) / (4 * 5)
-@end example
-
-Das ist eine Folge von (mathematischen) Ausdrücken, in denen
-jeder Ausdruck in dem folgenden (größeren) enthalten ist. Die
-einfachsten Ausdrücke sind Zahlen, und größere werden durch die
-Kombination von Ausdrücken mit Hilfe von Operatoren (wie @q{+},
-@q{*} und @q{/}) sowie Klammern. Genauso wie mathematische
-Ausdrücke könen auch musikalische Ausdrücke beliebig tief verschachtelt
-werden. Das wird benötigt für komplexe Musik mit vielen Stimmen.
-
-
 @node Multiple staves
 @subsection Multiple staves
 
@@ -1078,10 +1165,11 @@ zu verstehen, wenn diese Systeme explizit erstellt werden.
 
 Um mehr als ein System zu schreiben, wird jedem Notenausdruck, der
 in einem eigenen System stehen soll, der Befehl @code{\new Staff}
-vorne angefügt. Diese @code{Staff} (engl. für Notensystem)-Elemente werden dann
-parallel angeordnet mit den @code{<<} und @code{>>}-Zeichen:
+vorne angefügt. Diese @code{Staff} (engl. für Notensystem)-Elemente
+werden dann parallel angeordnet mit den @code{<<} und 
+@code{>>}-Zeichen:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
     \new Staff { \clef treble c }
@@ -1090,58 +1178,63 @@ parallel angeordnet mit den @code{<<} und @code{>>}-Zeichen:
 }
 @end lilypond
 
-Der Befehl @code{\new} beginnt einen neuen @q{Notationskontext}. Ein
+Der Befehl @code{\new} beginnt einen neuen @qq{Notationskontext}. Ein
 solcher Notationskontext ist eine Umgebung, in der musikalische
 Ereignisse (wie Noten oder @code{\clef} (Schlüssel)-Befehle)
-interpretiert
-werden. Für einfache Stücke werden diese Umgebungen automatisch
-erstellt. Für kompliziertere Musik ist es aber am besten, die
-Umgebungen explizit zu erstellen.
+interpretiert werden. Für einfache Stücke werden diese 
+Umgebungen automatisch erstellt. Für kompliziertere Musik 
+ist es aber am besten, die Umgebungen explizit zu erstellen.
 
 Es gibt verschiedene Kontext-Typen. @code{Score} (Partitur),
-@code{Staff}
- (Notensystem) und @code{Voice} (Stimme) verarbeiten die Eingabe von
-Noten, während die @code{Lyrics} (Text)-Umgebung zum Setzen von
-Liedtexten
-und die @code{ChordNames} (Akkordbezeichnungs)-Umgebung für Akkordsymbole
-verwendet wird.
-
-Die Syntax des @code{\new}-Befehls erinnert an das Minuszeichen
+@code{Staff} (Notensystem) und @code{Voice} (Stimme) 
+verarbeiten die Eingabe von Noten, während die @code{Lyrics} 
+(Text)-Umgebung zum Setzen von Liedtexten
+und die @code{ChordNames} (Akkordbezeichnungs)-Umgebung 
+für Akkordsymbole verwendet wird.
+
+Indem @code{\new} vor einen musikalischen Ausdruck gesetzt wird,
+wird ein größerer Ausdruck erstellt. In diesem Sinne erinnert
+die Syntax des @code{\new}-Befehls an das Minuszeichen
 in der Mathematik. Genauso wie @math{(4+5)} ein Ausdruck ist, der
 durch @math{-(4+5)} zu einem größeren Ausdruck erweitert wurde,
 werden auch musikalische Ausdrücke durch den @code{\new}-Befehl
 erweitert.
 
 Die Taktangabe, die in einem einzelnen System angegeben wird, wirkt
-sich auf alle anderen System aus, während die
-Angabe der Tonart sich nur auf ein einzigen System
-beschränkt.@footnote{Dies kann natürlich auch geändert
-werden, siehe
-@ref{Changing defaults} für Einzelheiten.}
+sich auf alle anderen System aus. Die 
+Angabe der Tonart in einem System hingegen beeinflusst @emph{nicht} die 
+Tonart der anderen Systeme. Dieses Verhalten ist darin begründet,
+dass Partituren mit transponierenden Instrumenten häufiger sind 
+als Partituren mit unterschiedlichen Taktarten.
+
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   <<
-    \new Staff { \clef treble \time 3/4 c }
-    \new Staff { \clef bass \key d \major c,, }
+    \new Staff { \clef treble \key d \major \time 3/4 c }
+    \new Staff { \clef bass c,, }
   >>
 }
 @end lilypond
 
 
-
-
-@node Piano staves
-@subsection Piano staves
+@node Staff groups
+@subsection Staff groups
 
 @cindex Akkolade
 @cindex Klaviersysteme
 @cindex Systemwechsel, manuell
 @cindex Wechsel zwischen Systemen, manuell
 @cindex Stimmwechsel zwischen Systemen, manuell
+@cindex Chorpartitur
+@cindex Klaviersystem
+@cindex Partitur
+
+Glossar: @rglos{brace}.
+
 Musik für das Klavier wird üblicherweise auf zwei Systemen notiert,
-die durch eine geschweifte Klammer verbunden sind (Akkolade). 
-Um ein derartiges
+die durch eine @notation{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
 eine @code{PianoStaff}-Umgebung eingefügt wird.
@@ -1155,7 +1248,7 @@ eine @code{PianoStaff}-Umgebung eingefügt wird.
 
 Hier ein kleines Beispiel:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 \relative c'' {
   \new PianoStaff <<
     \new Staff { \time 2/4 c4 e g g, }
@@ -1164,10 +1257,52 @@ Hier ein kleines Beispiel:
 }
 @end lilypond
 
-@moreinfo
-@quotation
-Siehe @ref{Piano music}.
-@end quotation
+Andere typische Gruppen von Notensystemen können mit den 
+Befehlen @code{\new StaffGroup} für Orchestersätze und 
+@code{\new ChoirStaff} für ein Chorsystem erstellt 
+werden. Jede dieser Systemgruppen erstellt einen 
+neuen Kontext, der dafür sorgt, dass die Klammern zu Beginn
+des Systems erstellt werden und der zusätzlich auch 
+darüber entscheidet, ob die Taktlinien nur auf dem System 
+oder auch zwischen System gesetzt werden.
+
+@seealso
+
+Benutzerhandbuch: @ruser{Keyboard instruments},
+@ruser{Displaying staves}.
+
+
+@node Combining notes into chords
+@subsection Combining notes into chords
+
+@cindex Akkorde
+
+Glossar: @rglos{chord}.
+
+Wir haben schon weiter oben gesehen, wie Akkorde ersetellt
+werden können, indem sie mit spitzen Klammern eingeschlossen
+und somit als gleichzeitig erklingend markiert werden.
+Die normale Art, Akkorde zu notieren, ist aber, sie in
+@emph{einfache} spitze Klammern (@q{<} und @q{>})
+einzuschließen. Beachten Sie, 
+dass alle Noten eines Akkordes die gleiche Dauer haben müssen, und 
+diese Dauer wird nach der schließenden Klammer geschrieben.
+
+@lilypond[verbatim,quote,relative=2]
+r4 <c e g>4 <c f a>2
+@end lilypond
+
+Akkorde sind im Grunde gleichwertig mit einfachen Noten:
+Fast alle Markierungen, die an einfache Noten angehängt 
+werden können, kann man auch an Akkorde hängen.
+So können Markierungen wie Balken oder Bögen mit
+den Akkorden kombiniert werden. Sie müssen jedoch außerhalb der
+spitzen Klammern gesetzt werden.
+
+@lilypond[verbatim,quote,relative=2]
+r4 <c e g>8[ <c f a>]~ <c f a>2
+r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)
+@end lilypond
 
 
 @node Single staff polyphony
@@ -1183,11 +1318,11 @@ und die Hälse der oberen Stimme zeigen immer nach oben, während
 die Hälse der unteren Stimme nach unten zeigen.
 
 Diese Art von Notenbild wird erstellt, indem jede Stimme für sich
-als Abfolge notiert wird (mit @code{@{...@}}) und diese dann
-parallel kombiniert werden, indem @code{\\} zwischen die einzelnen
-Stimmen gesetzt wird.
+als Abfolge notiert wird (mit @w{@code{@{...@}}}) und diese dann
+parallel kombiniert werden, indem die einzelnen Stimmen durch 
+@code{\\} voneinander getrennt werden.
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { r4 g4 f2 f4 }
@@ -1195,11 +1330,11 @@ Stimmen gesetzt wird.
 @end lilypond
 
 Für den Satz von mehrstimmigen Stücken kann es auch angebracht sein,
-unsichtbare Pausen zu verwenden. Hiermit könne Stimmen ausgefüllt
-werden, die gerade nicht aktiv sind. Hier ist ein Beispiel mit einer
-unsichtbaren Pause (@q{s}) anstelle einer normalen (@q{r}):
+unsichtbare Pausen zu verwenden. Hiermit können Stimmen ausgefüllt
+werden, die gerade nicht aktiv sind. Hier ist das obige Beispiel 
+mit einer unsichtbaren Pause (@q{s}) anstelle einer normalen (@q{r}):
 
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
 <<
   { a4 g2 f4~ f4 } \\
   { s4 g4 f2 f4 }
@@ -1210,7 +1345,7 @@ unsichtbaren Pause (@q{s}) anstelle einer normalen (@q{r}):
 Auch diese Ausdrücke wiederum könne beliebig miteinander
 kombiniert werden.
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,relative=2]
 <<
   \new Staff <<
     { a4 g2 f4~ f4 } \\
@@ -1224,34 +1359,9 @@ kombiniert werden.
 >>
 @end lilypond
 
-@moreinfo
-@quotation
-Siehe @ref{Basic polyphony}.
-@end quotation
-
-
-@node Combining notes into chords
-@subsection Combining notes into chords
-
-@cindex Akkorde
-Akkorde werden notiert, indem die Tonhöhen von spitzen
-Klammern (@q{<} und @q{>}) umgeben werden.
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>4 <c f a>2
-@end lilypond
-
-Auch andere Markierungen wie Balken oder Bögen können mit
-den Akkorden kombiniert werden. Sie müssen jedoch außerhalb der
-spitzen Klammern gesetzt werden.
+@seealso
 
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8[ <c f a>]~ <c f a>2
-@end lilypond
-
-@lilypond[quote,fragment,verbatim,relative=2,fragment]
-r4 <c e g>8\>( <c e g> <c e g>4 <c f a>\!)
-@end lilypond
+Benutzerhandbuch: @ruser{Simultaneous notes}.
 
 
 @node Songs
@@ -1262,23 +1372,29 @@ Text eingeführt und die Erstellung einfacher Song-Blätter
 gezeigt.
 
 @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 Text
 @cindex Lieder
 @cindex Liedtext
-Hier haben wir eine einfache Melodie:
 
-@lilypond[quote,ragged-right,verbatim]
+Glossar: @rglos{lyrics}.
+
+Hier ist der Beginn eines einfachen Kinderliedes, 
+@notation{Girls and boys come out to play}:
+
+@lilypond[verbatim,quote]
 \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
 
@@ -1286,139 +1402,344 @@ Zu diesen Noten kann Text hinzugefügt werden, indem beide
 mit dem @code{\addlyrics}-Befehl kombiniert werden. Text
 wird eingegeben, indem jede Silbe durch ein Leerzeichen getrennt wird.
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[verbatim,quote]
 <<
   \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
-@c this would be German version
-@c \addlyrics { Frei und froh denkt der Mensch }
 
-@cindex Melismen
-@cindex Unterstrich zur Silbenverlängerung
-Diese Melodie endet in einem @rglos{melisma}, d. h. eine einzige Silbe
-wird auf mehr als einer Note gesungen. Das wird im Text meistens mit
-einem Unterstrich hinter der Silbe dargestellt. Dieser Strich wird
-durch zwei Unterstriche (@code{__}), von Leerzeichen umgeben, notiert.
+Sowohl die Noten als auch der Text sind jeweils in geschweifte 
+Klammern eingefasst, und der gesamte Ausdruck ist zwischen 
+@w{@code{<< ... >>}} positioniert. Damit wird garantiert, dass 
+Text und Noten gleichzeitig gesetzt werden.
+
+
+@node Aligning lyrics to a melody
+@subsection Aligning lyrics to a melody
+
+Glossar: @rglos{melisma}, @rglos{extender line}.
 
-@lilypond[quote,ragged-right,verbatim]
+@cindex Melisma
+@cindex Unterstrich
+@cindex Bindestrich
+@cindex Fülllinie
+
+Die nächste Zeile des Kinderliedes lautet:
+@notation{The moon doth shine as bright as day}. So sieht es 
+notiert aus:
+
+@lilypond[verbatim,quote]
 <<
   \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
 
-Auf gleiche Art können Trennstriche zwischen einzelnen Silben
-eines Wortes mit zwei Minuszeichen (@code{--}) eingegeben werden.
-Sie werden im Notenbild als eine oder mehrere zentrierte Trennstriche
-dargestellt.
+Die zusätzlichen Noten sind nicht korrekt an den Noten 
+positioniert. Das Wort @notation{shine} sollte eigentlich zu 
+zwei Noten gesungen werden, nicht nur zu einer. Das wird als 
+@notation{Melisma} bezeichnet, wenn eine Silbe zu mehreren 
+Noten gesungen wird. Es gibt mehrere Möglichkeiten, eine 
+Silbe über mehrere Noten zu erweitern. Die einfachste ist,
+einen Legatobogen über die 
+betroffenen Noten zu notieren, zu Einzelheiten siehe 
+@ref{Ties and slurs}.
+
+@lilypond[verbatim,quote]
+<<
+  \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 {
+    Girls and boys come out to play,
+    The moon doth shine as bright as day;
+  }
+>> 
+@end lilypond
+
+Die Wörter orientieren sich jetzt richtig an den Noten,
+aber der automatische Balken für die Noten zu
+@notation{shine as} sieht nicht richtig aus.
+Wir können das korrigieren, indem wir die Balkenlänge
+manuell eingrenzen, damit sie der üblichen Notationsweise
+für Gesang entspricht. Für Einzelheiten siehe 
+@ref{Automatic and manual beams}.
 
-@c no ragged-right here because otherwise the hypens get lost.
-@lilypond[quote,verbatim]
+@lilypond[verbatim,quote]
 <<
-  \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 {
+    Girls and boys come out to play,
+    The moon doth shine as bright as day;
   }
-  \addlyrics { A -- le -- gri -- a }
 >>
 @end lilypond
-@c \addlyrics { In -- te -- res -- sant }
 
-@moreinfo
-@quotation
-Mehr Möglichkeiten, wie etwa mehrere Strophen unter der gleichen
-Melodie, werden im Kapitel @ref{Vocal music} gezeigt.
-@end quotation
+Alternativ kann das Melisma auch im Text notiert werden, indem
+für jede Note, die übersprungen werden soll, ein Unterstrich
+@code{_} im Text geschrieben wird:
 
+@lilypond[verbatim,quote]
+<<
+  \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 {
+    Girls and boys come out to play,
+    The moon doth shine _ as bright as day;
+  }
+>>
+@end lilypond
 
-@node A lead sheet
-@subsection A lead sheet
+Wenn die letzte Silbe eines Wortes sich über mehrere Noten oder 
+eine sehr lange Note erstreckt, wird üblicherweise eine Fülllinie 
+gesetzt, die sich über alle Noten erstreckt, die zu der Silbe
+gehören. Diese Fülllinie wird mit zwei Unterstrichen @code{__}
+notiert. Hier ein Beispiel der ersten drei Takte aus 
+@notation{Didos Klage},
+aus Purcells @notation{Dido and Æneas}:
 
-@cindex lead sheet
-@cindex Song-Blatt
-@cindex Akkorde
-@cindex Akkordbezeichnungen
+@lilypond[verbatim,quote]
+<<
+  \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 der Pop-Musik wird die Begleitung gerne mit Akkordsymbolen
-angegeben. Diese Bezeichnungen können in der @code{\chordmode}-Umgebung
-wie Noten eingegeben werden:
+Keins der bisherigen Beispiele hat bisher Wörter benutzt, die länger
+als eine Silbe waren. Solche Wörter werden üblicherweise auf die
+Noten aufgeteilt, eine Silbe pro Note, mit Bindestrichen zwischen 
+den Silben. Diese Silben werden durch zwei Minuszeichen notiert und
+von LilyPond als ein zentrierter Bindestrich zwischen den Silben 
+gesetzt. Hier ein Beispiel, das dies und alle anderen Tricks
+zeigt, mit denen Text an den Noten ausgerichtet werden kann:
+
+@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
 
-@lilypond[quote,ragged-right,verbatim]
-\chordmode { c2 f4. g8 }
+Einige Texte, besonders in italienischer Sprache, brauchen das 
+Gegenteil: mehr als eine Silbe muss zu einer einzelnen Note 
+gesetzt werden. Das ist möglich, indem die Silben durch einen 
+einzelnen Unterstrich @code{_} zusammengekoppelt werden. Dazwischen
+dürfen sich keine Leerzeichen befinden, oder indem man die 
+relevanten Silben in Anführungszeichen @code{"} setzt.
+Hier ein Beispiel aus dem @notation{Figaro} von Rossini, wo die Silbe 
+@notation{al} auf der selben Note wie @notation{go} des Wortes @notation{Largo} 
+in Figaros Arie @notation{Largo al factotum} gesungen werden mus.
+
+@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
 
-Jede Tonhöhe wird als die Basis eines Akkordes interpretiert. Andere
-Akkorde als die Grundakkorde können durch Anhängen besonderer 
-Bezeichnungen erstellt werden.
-Diese Bezeichnungen müssen an den Tonhöhenbuchstaben gehängt werden,
- getrennt von einem Doppelpunkt. Im nächsten Beispiel werden einige der
-gängigsten Bezeichnungen dargestellt:
 
-@lilypond[quote,verbatim,ragged-right]
-\chordmode { c2 f4:m g4:maj7 gis1:dim7 }
-@end lilypond
+@seealso
 
-Für Liederblätter werden die Akkorde jedoch meistens nicht als Noten
-dargestellt, sondern als Symbole über dem Text. Das erreicht man durch
-die Umgebung @code{\chord} anstelle des eben verwendeten
-@code{\chordmode}.
-Es kann die gleiche Syntax verwendet werden, aber die Tonbezeichnungen
-ergeben jetzt Akkordsymbole:
+Benutzerhandbuch: @ruser{Vocal music}.
 
-@lilypond[quote,verbatim,ragged-right]
-\chords { c2 f4.:m g4.:maj7 gis8:dim7 }
-@end lilypond
 
-Indem man jetzt die Akkordsymbole, den Text und eine Melodie
-kombiniert, hat man ein Song-Blatt.
+@node Lyrics to multiple staves
+@subsection Lyrics to multiple staves
+
+Die einfache Lösung mit @code{\addlyrics} kann benutzt werden, um 
+Text zu einem oder mehreren Systemen zu setzen. Hier ein Beispiel
+aus Händels @notation{Judas Maccabäus}:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 <<
-  \chords { c2 g:sus4 f e }
   \relative c'' {
-    a4 e c8 e r4
-    b2 c4( d)
+    \key f \major
+    \time 6/8
+    \partial 8
+    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
+    \time 6/8
+    \partial 8
+    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
-@c \addlyrics { Frei und froh denkt der Mensch __ }
 
-@moreinfo
-@quotation
-Eine vollständige Liste der Akkordbezeichnungen und andere
-Optionen für das Layout sind im Kapitel @ref{Chords} zu
-finden.
-@end quotation
+Aber Partituren, die komplizierter als dieses Beispiel sind, 
+werden besser notiert, indem man die Systemstruktur von den 
+Noten und dem Gesangstext durch Variablen trennt. Die Benutzung 
+von Variablen wird erklärt im Abschnitt @ref{Organizing pieces with variables}.
+
+@seealso
+
+Benutzerhandbuch: @ruser{Vocal music}.
 
 
 @node Final touches
 @section Final touches
 
 Das ist das letzte Kapitel der Übung. Hier soll demonstriert werden,
-wie
-man den letzten Schliff an einfachen Stücken anbringen kann.
-Gleichzeitig
-dient es als Einleitung zum Rest des Handbuches.
+wie man den letzten Schliff an einfachen Stücken anbringen kann.
+Gleichzeitig dient es als Einleitung zum Rest des Handbuches.
 
 @menu
+* Organizing pieces with variables::
 * Version number::
 * Adding titles::
 * Absolute note names::
-* Organizing pieces with identifiers::
 * After the tutorial::
-* How to read the manual::
 @end menu
 
 
+@node Organizing pieces with variables
+@subsection Organizing pieces with variables
+
+Wenn alle die Elemente, die angesprochen wurden, zu größeren Dateien
+zusammengefügt werden, werden auch die musikalischen Ausdrücke sehr
+viel größer. In polyphonen Dateien mit vielen Systemen kann das
+sehr chaotisch aussehen. Das Chaos kann aber deutlich reduziert werden,
+wenn @code{Variablen} definiert und verwendet werden.
+
+Variablen (die auch als Bezeichner oder Makros bezeichnet werden)
+können einen Teil der Musik aufnehmen. Sie werden wie folgt definiert:
+
+@example
+bezeichneteMusik = @{ @dots{} @}
+@end example
+
+Der Inhalt des musikalischen Ausdrucks @code{bezeichneteMusik} kann
+dann später wieder benutzt werden, indem man einen Backslash davor setzt
+(@code{\bezeichneteMusik}), genau wie bei jedem LilyPond-Befehl.
+
+@c KEEP LY
+@lilypond[quote,verbatim]
+Geige = \new Staff
+  { \relative c'' {
+    a4 b c b
+  }
+}
+Cello = \new Staff
+  { \relative c {
+    \clef bass
+    e2 d
+  }
+}
+{
+  <<
+    \Geige
+    \Cello
+  >>
+}
+@end lilypond
+
+@noindent
+In den Namen der Variablen dürfen nur Buchstaben des
+Alphabets verwendet werden, keine Zahlen oder Striche.
+
+Variable müssen @emph{vor} dem eigentlichen musikalischen
+Ausdruck definiert werden. Sie können dann aber beliebig oft 
+verwendet werden, nachdem sie einmal definiert worden sind. Sie 
+können sogar eingesetzt werden, um später in der Datei eine neue 
+Variable zu erstellen. Damit kann die Schreibarbeit erleichtert 
+werden, wenn Notengruppen sich oft wiederholen.
+
+@c KEEP LY
+@lilypond[verbatim,quote]
+trioleA = \times 2/3 { c,8 e g }
+TaktA = { \trioleA \trioleA \trioleA \trioleA }
+
+\relative c'' {
+ \TaktA \TaktA
+}
+@end lilypond
+
+Man kann diese Variablen auch für viele andere Objekte
+verwenden, etwa:
+
+@example
+Breite = 4.5\cm
+Name = "Tim"
+aFünfPapier = \paper @{ paperheight = 21.0 \cm @}
+@end example
+
+Abhängig vom Kontext kann solch ein Bezeichner in verschiedenen
+Stellen verwendet werden. Das folgende Beispiel zeigt die
+Benutzung der eben definierten Bezeichner:
+
+@example
+\paper @{
+  \aFünfPapier
+  line-width = \width
+@}
+@{ 
+  c4^\Name 
+@}
+@end example
+
+
 @node Version number
 @subsection Version number
 
@@ -1427,7 +1748,7 @@ Der @code{\version}-Befehl zeigt an, welche LilyPond-Version
 für eine bestimmte Quelldatei benutzt worden ist:
 
 @example
-\version "2.11.23"
+\version @w{"@version{}"}
 @end example
 
 @noindent
@@ -1436,9 +1757,9 @@ für eine bestimmte Quelldatei benutzt worden ist:
 Durch diese Versionsmarkierung werden zukünftige Aktualisierungen
 des LilyPond-Programmes einfacher gemacht. Syntax-Änderungen
 zwischen den Programmversionen werden von einem speziellen
-Programm, @file{convert-ly}, vorgenommen (siehe @rprogram{Updating
-files with convert-ly}). Dieses Programm braucht @code{\version},
- um zu entscheiden, welche Regeln angewandt werden müssen.
+Programm, @command{convert-ly}, vorgenommen. Dieses Programm braucht
+@code{\version}, um zu entscheiden, welche Regeln angewandt werden
+müssen. Für Einzelheiten, siehe @rprogram{Updating files with convert-ly}.
 
 @node Adding titles
 @subsection Adding titles
@@ -1446,11 +1767,10 @@ files with convert-ly}). Dieses Programm braucht @code{\version},
 Titel, Komponist, Opusnummern und ähnliche Information werden in
 einer @code{\header}-Umgebung eingefügt. Diese Umgebung befindet sich
 außerhalb der musikalischen Ausdrücke, meistens wird die
-@code{\header}-Umgebung
-direkt nach der Versionsnummer eingefügt.
+@code{\header}-Umgebung direkt nach der @ref{Version number} eingefügt.
 
 @example
-\version "2.11.23"
+\version @w{"@version{}"}
 \header @{
   title = "Symphony"
   composer = "Ich"
@@ -1464,8 +1784,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
-titles}.
+sich im Kapitel @ruser{Creating titles}.
 
 
 @node Absolute note names
@@ -1482,7 +1801,7 @@ eingestrichene C, ein @code{b} ist immer das kleine h unter dem
 eingestrichenen C, und ein @code{g,} ist immer das große G -- also die
 Note auf der letzten Linie im Bass-Schlüssel.
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 {
   \clef bass
   c' b g, g,
@@ -1492,7 +1811,7 @@ Note auf der letzten Linie im Bass-Schlüssel.
 
 Hier eine Tonleiter über vier Oktaven:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 {
   \clef bass
   c, d, e, f,
@@ -1511,7 +1830,7 @@ Wie leicht zu sehen ist, muss man sehr viele Apostrophe schreiben,
 wenn die Melodie im Sopranschlüssel notiert ist. Siehe etwa dieses
 Fragment von Mozart:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 {
   \key a \major
   \time 6/8
@@ -1524,7 +1843,7 @@ Alle diese Apostrophe machen den Quelltext schlecht lesbar und sind
 eine mögliche Fehlerquelle. Mit dem  @code{\relative}-Befehl ist das Beispiel
 sehr viel einfacher zu lesen:
 
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
 \relative c'' {
   \key a \major
   \time 6/8
@@ -1543,91 +1862,6 @@ Trotz allem ist der absolute Modus gut für Musik mit sehr großen
 Sprüngen und vor allem für computergenerierte LilyPond-Dateien.
 
 
-@node Organizing pieces with identifiers
-@subsection Organizing pieces with identifiers
-
-Wenn alle die Elemente, die angesprochen wurden, zu großeren Dateien
-zusammengefügt werden, werden auch die musikalischen Ausdrücke sehr
-viel größer. In polyphonen Dateien mit vielen Systemen kann das
-sehr chaotisch aussehen. Das Chaos kann aber deutlich reduziert werden,
-wenn @code{Bezeichner} definiert und verwendet werden.
-
-Bezeichner (die auch als Variablen oder Makros bezeichnet werden)
-können
-einen Teil der Musik aufnehmen. Sie werden wie folgt definiert:
-
-@example
-bezeichneteMusik = @{ @dots{} @}
-@end example
-
-Der Inhalt des musikalischen Ausdrucks @code{bezeichneteMusik} kann
-dann
-später wieder benutzt werden, indem man einen Backslash davor setzt
-(@code{\bezeichneteMusik}), genau wie bei jedem LilyPond-Befehl.
-Bezeichner müssen @emph{vor} dem eigentlichen musikalischen
-Ausdruck definiert werden.
-
-@ignore
-German version
-@lilypond[quote,verbatim,ragged-right]
-Violine = \new Staff { \relative c'' {
-  a4 b c b
-}}
-Cello = \new Staff { \relative c {
-  \clef bass
-  e2 d
-}}
-{
-  <<
-    \Violine
-    \Cello
-  >>
-}
-@end lilypond
-@end ignore
-
-@lilypond[quote,verbatim,ragged-right]
-violin = \new Staff { \relative c'' {
-  a4 b c b
-}}
-cello = \new Staff { \relative c {
-  \clef bass
-  e2 d
-}}
-{
-  <<
-    \violin
-    \cello
-  >>
-}
-@end lilypond
-
-@noindent
-In den Namen der Bezeichner dürfen nur Buchstaben des
-Alphabets verwendet werden, keine Zahlen oder Striche.
-
-Man kann diese Variablen auch für alle anderen Objekte
-verwenden, etwa:
-
-@example
-width = 4.5\cm
-Name = "Wendy"
-aFünfPapier = \paper @{ paperheight = 21.0 \cm @}
-@end example
-
-Abhängig vom Kontext kann solch ein Bezeichner in verschiedenen
-Stellen verwendet werden. Das folgende Beispiel zeigt die
-Benutzung der eben definierten Bezeichner:
-
-@example
-\paper @{
-  \aFünfPapier
-  line-width = \width
-@}
-@{ c4^\Name @}
-@end example
-
-
 @node After the tutorial
 @subsection After the tutorial
 
@@ -1636,43 +1870,31 @@ besten ein paar Stücke selber notieren. Beginnen Sie mit
 den @ref{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{Musical 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}.
+wollen, für das es keine Vorlage gibt, schauen Sie
+sich @ref{Extending the templates} an.
 
 Wenn Sie ein paar kurze Stücke notiert haben, lesen Sie
-den Rest des Lernhandbuchs (Kapitel 3--5). Natürlich können
+den Rest des Handbuchs zum Lernen (Kapitel 3--5). Natürlich können
 Sie auch sofort weiterlesen. Die nächsten Kapitel sind
 aber mit der Annahme geschrieben, dass Sie die Eingabesprache
 von LilyPond beherrschen. Sie können die weiteren Kapitel auch
 überfliegen und dann darauf wieder zurückkommen, wenn
-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,
-haben wir bei vielen Beispielen in der Übung die
-@code{\relative c''}-Umgebung weggelassen.
-
-Im Rest des Handbuches wurde noch viel nachlässiger vorgegangen:
-In manchen Fällen fehlt nur das @code{\relative c'' @{ ... @}}, in anderen
-wurde eine andere Oktave als Startpunkt benutzt (etwa @code{c'} oder
- @code{c,,}), manchmal ist das ganze Beispiel im absoluten Modus
-geschrieben. Solche Mehrdeutigkeiten treten aber nur in Fällen auf, in
-denen die Tonhöhe nicht wichtig ist. In allen Beispielen, in denen
-die Tonhöhe eine Rolle spielt, sind entweder @code{\relative} oder
-die Klammern @code{@{ @}} für den absoluten Modus vermerkt.
-
-Wenn Sie noch nicht genau verstanden haben, wie eigentlich der
-Quellcode genau aussehen soll, schauen Sie sich am besten die HTML-Version
-dieses Dokuments an (wenn Sie das nicht schon tun) und klicken
-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}.
-
+Sie einige Erfahrungen im Notieren gewonnen haben.
+
+In dieser Übung, genauso wie im gesamten Handbuch zum Lernen,
+befindet sich ein Abschnitt @strong{Siehe auch} am Ende jedes
+Abschnittes, wo sich Verweise auf andere Abschnitte befinden.
+Diesen Verweisen sollten Sie nicht beim ersten Durchlesen
+folgen; erst wenn Sie das gesamte Handbuch zum Lernen gelesen 
+haben, können Sie bei Bedarf diesen Verweisen folgen, um ein
+Thema zu vertiefen.
+
+Bitte lesen Sie jetzt @ref{About the documentation}, wenn Sie
+es bisher noch nicht getan haben. Es gibt ungeheuer viel 
+Information über LilyPond, so dass Neulinge sich nicht sofort
+zurecht finden. Wenn Sie auch nur ein paar Minuten in diesem
+Abschnitt lesen, können Sie sich Stunden frustrierendes Suchen
+an der falschen Stelle ersparen!