]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/de/notation/simultaneous.itely
Issue 4894: Remove unescaped @funindex entries
[lilypond.git] / Documentation / de / notation / simultaneous.itely
index 08206d09d7ab2f27662f93e03f48b76f417488b2..982bac08e00f2b814434a3dee847b9de389b027f 100644 (file)
@@ -1,13 +1,13 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @ignore
-    Translation of GIT committish: aa632c095138aaaa0f50f73c90e72efb4b61d745
+    Translation of GIT committish: e5a609e373eae846857f9a6d70a402a3d42b7d94
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes.
 @end ignore
 
-@c \version "2.13.36"
+@c \version "2.19.29"
 
 @c Translators: Till Paala
 
@@ -15,7 +15,7 @@
 @section Gleichzeitig erscheinende Noten
 @translationof Simultaneous notes
 
-@lilypondfile[quote]{simultaneous-headword.ly}
+@lilypondfile[quote,ragged-right,line-width=16\cm]{simultaneous-headword.ly}
 
 Polyphonie bedeutet in der musikalischen Terminologie das
 Vorhandensein von mehr als einer (eigenständigen) Stimme
@@ -59,30 +59,56 @@ zwischen spitze Klammern (@code{<} und @code{>}) gesetzt werden.
 Auf einen Akkord kann eine Dauer-Angabe folgen, genauso wie bei
 einfachen Noten.
 
-@lilypond[verbatim,quote,relative=2]
-<a c e>1 <a c e>2 <f a c e>4 <a c>8. <g c e>16
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1 <a c e>2 <f a c e>4 <a c>8. <g c e>16
+}
 @end lilypond
 
 Akkorde können auch von Artikulationen gefolgt werden, genau wie
 auch einfache Noten.
 
-@lilypond[verbatim,quote,relative=2]
-<a c e>1\fermata <a c e>2-> <f a c e>4\prall <a c>8.^| <g c e>16-.
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1\fermata <a c e>2-> <f a c e>4\prall <a c>8.^! <g c e>16-.
+}
 @end lilypond
 
 Die Noten innerhalb der Akkorde konnen auch von Artikulationen oder
 Ornamenten gefolgt werden.
 
-@lilypond[verbatim,quote,relative=2]
-<a c\prall e>1 <a-> c-^ e>2 <f-. a c-. e-.>4 <a-+ c-->8. <g\fermata c e\turn>16
+@lilypond[verbatim,quote]
+\relative {
+  <a' c\prall e>1 <a-> c-^ e>2 <f-. a c-. e-.>4
+  <a-+ c-->8. <g\fermata c e\turn>16
+}
 @end lilypond
 
 Manche Notationselemente, wie etwa Dynamik, Crescendo-Klammern und
 Legatobögen müssen an den gesamten Akkord gehängt werden und nicht
 an einzelne Noten, damit sie ausgegeben werden.
 
-@lilypond[verbatim,quote,relative=2]
-<a\f c( e>1 <a c) e>\f <a\< c e>( <a\! c e>) <a c e>\< <a c e> <a c e>\!
+@lilypond[verbatim,quote]
+\relative {
+  <a'\f c( e>1 <a c) e>\f <a\< c e>( <a\! c e>)
+  <a c e>\< <a c e> <a c e>\!
+}
+@end lilypond
+
+Ein Akkord ist sozusagen ein Container für die Noten, ihre Artikulationen
+und andere angehänge Elemente.  Demzufolge hat also auch ein Akkord ohne
+wirkliche Noten innerhalb der Klammern keine Dauer.  Alle angehängten
+Artikulationen geschehen zur selben musikalischen Zeit wie die folgende
+Note oder der folgende Akkord und werden damit kombiniert (für
+komplexere Möglichkeiten, derartige Elemente zu kombinieren, siehe
+@ref{Gleichzeitige Ausdrücke}.
+
+@lilypond[verbatim,quote]
+\relative {
+  \grace { g'8( a b }
+  <> ) \p \< -. -\markup \italic "sempre staccato"
+  \repeat unfold 4 { c4 e }  c1\f
+}
 @end lilypond
 
 @cindex relative Tonhöhe, Akkorde
@@ -94,8 +120,10 @@ vorherigen Akkordes, oder mit der Tonhöhe der letzten Note vor dem
 Akkord (wenn kein Akkord vorhergeht).  Alle anderen Noten innerhalb
 des Akkordes sind relativ zu der Note vorher innerhalb des selben Akkordes.
 
-@lilypond[verbatim,quote,relative=2]
-<a c e>1 <f a c> <a c e> <f' a c> <b, e b,>
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1 <f a c> <a c e> <f' a c> <b, e b,>
+}
 @end lilypond
 
 Mehr Information über Akkorden findet sich in @ref{Notation von Akkorden}.
@@ -110,21 +138,47 @@ Handbuch zum Lernen:
 Notationsreferenz:
 @ref{Notation von Akkorden},
 @ref{Artikulationszeichen und Verzierungen},
-@ref{Relative Oktavenbezeichnung}.
+@ref{Relative Oktavenbezeichnung},
+@ref{Mehrere Stimmen}.
 
 Schnipsel:
 @rlsr{Simultaneous notes}.
 
+@knownissues
+Akkorde, die mehr als zwei Tonhöhen für einen Notenlinenzwischenraum enthalten
+(wie etwa @samp{<e f! fis!>}) produzieren überlappende Notenköpfe.  Abhängig von
+der Situation kann eines der folgenden Dinge helfen, die Darstellung zu verbessern:
+
+@itemize
+
+@item
+Kurzzeitig mehrere Stimmen benutzen, siehe @ref{Mehrere Stimmen}:
+@samp{<y f! \\ <e fis!> >>},
+
+@item
+enharmonische Transkription für einen oder mehrere Tonhöhen vornehmen:
+@samp{<e f ges>} oder
+
+@item
+Cluster, siehe @ref{Cluster}.
+
+@end itemize
+
 
 @node Akkord-Wiederholungen
 @unnumberedsubsubsec Akkord-Wiederholungen
 @translationof Chord repetition
 
+@cindex Akkorde, Wiederholung
+@cindex Wiederholung mit @code{q}
+
 Um Schreibarbeit zu ersparen, kann ein Zeichen benutzt werden, um den
 vorhergehenden Akkord zu wiederholen.  Das Symbol hierzu ist @code{q}:
 
-@lilypond[verbatim,quote,relative=2]
-<a c e>1 q <f a c>2 q
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1 q <f a c>2 q
+}
 @end lilypond
 
 Genauso wie normale Akkorde kann auch das Akkord-Wiederholungssymbol
@@ -132,24 +186,83 @@ in Verbindung mit Tondauern, Artikulationen, Beschriftungen, Legatobögen,
 Balken usw. benutzt werden, weil nur die Tonhöhen des vorangehenden
 Akkordes wiederholgt werden.
 
-@lilypond[verbatim,quote,relative=2]
-<a c e>1\p^"text" q2\<( q8)[-| q8.]\! q16-1-2-3 q8\prall
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1\p^"text" q2\<( q8)[-! q8.]\! q16-1-2-3 q8\prall
+}
+@end lilypond
+
+Das Akkordwiederholungssymbol erinnert sich an das letzte Vorkommen
+eines Akkordes, sodass man den letzten Akkord wiederholen kann, auch
+wenn in der Zwischenzeit nicht-Akkord-Noten oder -Pause auftetreten
+sind.
+
+@lilypond[verbatim,quote]
+\relative {
+  <a' c e>1 c'4 q2 r8 q8 |
+  q2 c, |
+}
 @end lilypond
 
 Das Akkord-Wiederholungssymbol behält keine Dynamikzeichen, Artikulationen
 oder Ornamente, die in oder an den vorhergehenden Akkord gehängt waren.
 
 @lilypond[verbatim,quote,relative=2]
-<a-. c\prall e>1\sfz c4 q2 r8 q8
+<a-. c\prall e>1\sfz c'4 q2 r8 q8 |
+q2 c, |
+@end lilypond
+
+Damit auch diese Zeichen erhalten bleiben, kann die Funktion @code{\chordRepeats}
+explizit mit einem zusätzlichen Argument aufgerufen werden, um
+eine Liste an Ereignistypen (engl. event) zu spezifizieren, die mit
+wiederholt werden, es sei denn, der gleiche Ereignistyp wird selber mit
+dem @code{q} verwendet:
+
+@lilypond[verbatim,quote]
+\relative {
+  \chordRepeats #'(articulation-event)
+  { <a'-. c\prall e>1\sfz c'4 q2 r8 q8-. } |
+  q2 c, |
+}
 @end lilypond
 
+Die Benutzung von @code{\chordRepeats} innerhalb einer @code{\relative}-Konstruktion
+führt zu unerwarteten Ergebnissen:  Nachdem die Akkordereignisse einmal
+erweitert sind, können sie nicht mehr von normal eingegebenen Akkorden
+unterschieden werden.  Dadurch fügt @code{\relative} einen Oktavsprung
+entsprechend des aktuellen Kontexts ein.
+
+Weil geschachtelte @code{\relative}-Umgebungen sich nicht gegenseitig
+beeinflussen, kann man eine zusätzliche @code{\relative}-Umgebung
+innerhalb von  @code{\chordRepeats} benutzen, um die Oktavbeziehungen
+darzustellen, bevor die wiederholten Akkorde eingesetzt werden.  In diesem
+Fall beeinflusst der gesamte Inhalt der inneren @code{\relative}-Umgebung
+nicht die äußere. Daraus ergibt sich die unterschiedliche Oktave der
+letzten Note in diesem Beispiel:
+
+@c Without \new Voice, implicit voice creation does the dumbest thing.
+@lilypond[verbatim,quote]
+\new Voice
+\relative c'' {
+  \chordRepeats #'(articulation-event)
+  \relative
+  { <a'-. c\prall e>1\sfz c'4 q2 r8 q8-. } |
+  q2 c |
+}
+@end lilypond
+
+Derartige Probleme mit @code{\relative} treten nur auf, wenn @code{\chordRepeats}
+explizit aufgerufen wird: die Verarbeitung von einfachem @code{q} wird
+erst vorgenommen, wenn alle @code{\relative}-Umgebungen schon verarbeitet
+sind.
+
 @seealso
 Notationsreferenz:
 @ref{Notation von Akkorden},
 @ref{Artikulationszeichen und Verzierungen}.
 
 Installierte Dateien:
-@file{ly/@/chord-repetition-init@/.ly}.
+@file{ly/chord-repetition-init.ly}.
 
 
 @node Gleichzeitige Ausdrücke
@@ -167,32 +280,73 @@ Systemen gesetzt.
 Das nächste Beispiel zeigt simultane Konstruktionen auf einem
 System:
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
 \new Voice {  % explicit single voice
-  << { a4 b g2 } { d4 g c,2 } >>
+  << \relative { a'4 b g2 }
+     \relative { d'4 g c,2 } >>
 }
 @end lilypond
 
-@lilypond[quote,verbatim,relative=2]
-% single first note
-a << { a4 b g } { d4 g c, } >>
+@lilypond[quote,verbatim]
+\relative {
+  % single first note
+  a' << \relative { a'4 b g }
+       \relative { d'4 g c, } >>
+}
 @end lilypond
 
 Dass kann benutzt werden, wenn die simultanen Abschnitte einen
 identischen Rhythmus haben, aber wenn versucht wird, Noten mit
 unterschiedlicher Dauer an denselben Hals zu setzen, gibt es
-Fehlermeldungen.
+Fehlermeldungen.  Noten, Artikulationen und Eigenschaftsänderungen
+in einer @emph{einzelnen} @samp{Voice} werden gesammelt und
+in musikalischer Reihenfolge gesetzt:
+
+@lilypond[quote,verbatim]
+\relative {
+  <a' c>4-.  <>-. << c a >>  << { c-. <c a> } { a s-. } >>
+}
+@end lilypond
+
+Mehrfache Hälse oder Balken oder unterschiedliche Notendauern
+oder Eigenschaften zur selben musikalischen Zeit erfordern den
+Einsatz von mehreren Stimmen.
 
 Das nächste Beispiel zeigt, wie ein simultaner Ausdruck implizit
 mehrere Systeme erstellt:
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
 % no single first note
-<< { a4 b g2 } { d4 g2 c,4 } >>
+<< \relative { a'4 b g2 }
+   \relative { d'4 g2 c,4 } >>
 @end lilypond
 
-In diesem Fall stellt der unterschiedliche Rhythmus kein Problem dar.
+In diesem Fall stellt der unterschiedliche Rhythmus kein Problem dar,
+weil sie in unterschiedlichen Stimmen interpretiert werden.
+
+@cindex Zusammenstöße, kollidierende Notenkolumnen
+@cindex Zusammenstöße, ignorieren
+
+@knownissues
+Wenn Noten zweier oder mehrerer Stimmen mit Hälsen in die gleiche Richtung
+an der selben Position auf dem System gesetzt werden und keinen Versatz
+durch @code{shift} aufweisen (oder den gleichen Versatz besitzen), erscheint
+die Nachricht
+
+@example
+Warnung: zu viele kollidierende Notenspalten werden ignoriert
+@end example
+
+@noindent
+während der Kompilation.  Diese Nachricht kann unterdrückt werden durch
 
+@example
+\override NoteColumn.ignore-collision = ##t
+@end example
+
+Das unterdrückt jedoch nicht nur die Warnungen, sondern schaltet auch
+die Auflösung von Zusammenstößen ab und kann also zu unbeabsichtigten
+Resultaten führen. (Siehe auch @ref{Auflösung von Zusammenstößen}.)
 
 @node Cluster
 @unnumberedsubsubsec Cluster
@@ -202,7 +356,6 @@ In diesem Fall stellt der unterschiedliche Rhythmus kein Problem dar.
 @cindex Notencluster
 
 @funindex \makeClusters
-@funindex makeClusters
 
 Ein Cluster zeigt an, dass alle Tonhöhen in einem Bereich gleichzeitig
 gespielt werden sollen.  Cluster können gedeutet werden als eine
@@ -210,8 +363,8 @@ Zusammenfassung einer ganzen Anzahl von Noten.  Sie werden notiert,
 indem die Funktion @code{\makeClusters} auf eine Reihe von Akkorden
 angewendet wird:
 
-@lilypond[quote,relative=2,verbatim]
-\makeClusters { <g b>2 <c g'> }
+@lilypond[quote,verbatim]
+\relative \makeClusters { <g' b>2 <c g'> }
 @end lilypond
 
 Normale Noten und Cluster können zusammen im selben System notiert
@@ -272,11 +425,9 @@ oder mehreren Systemen.
 @cindex Mehrstimmigkeit
 @cindex Polyphonie
 @funindex \voiceOne
-@funindex voiceOne
 @funindex \voiceOne ... \voiceFour
 @funindex Voice
 @funindex \oneVoice
-@funindex oneVoice
 
 @strong{@i{Stimmen explicit beginnen}}
 
@@ -284,18 +435,18 @@ Die grundlegende Struktur, die man benötigt, um mehrere
 unabhängige Stimmen in einem Notensystem zu setzen,
 ist im Beispiel unten dargestellt:
 
-@lilypond[quote,relative=3,verbatim]
+@lilypond[quote,verbatim]
 \new Staff <<
   \new Voice = "first"
-    { \voiceOne r8 r16 g e8. f16 g8[ c,] f e16 d }
+    \relative { \voiceOne r8 r16 g'' e8. f16 g8[ c,] f e16 d }
   \new Voice= "second"
-    { \voiceTwo d16 c d8~ d16 b c8~ c16 b c8~ c16 b8. }
+    \relative { \voiceTwo d''16 c d8~ 16 b c8~ 16 b c8~ 16 b8. }
 >>
 @end lilypond
 
 @noindent
 Stimmen werden hier explizit erstellt und erhalten Bezeichnungen
-zugewiesen.  Die @code{\voiceOne} ... @code{\voiceFour}-Befehle
+zugewiesen.  Die @code{\voiceOne} @dots{} @code{\voiceFour}-Befehle
 stellen die Stimmen so ein, dass für die erste und dritte Stimme
 die Hälse nach oben zeigen, für die zweite und vierte Stimme
 hingegen nach unten.  Die Noten der dritten und vierten Stimme
@@ -324,10 +475,10 @@ der eckigen Klammern werden anderen Stimmennummern zugewiesen.
 Damit lassen sich auch Gesangstexte einer durchgehenden Stimme
 vor, während und nach dem polyphonen Abschnitt zuweisen:
 
-@lilypond[quote, verbatim, relative=2]
-<<
+@lilypond[quote,verbatim]
+\relative <<
   \new Voice = "melody" {
-    a4
+    a'4
     <<
       {
         \voiceOne
@@ -366,11 +517,11 @@ erstellt und haben die festen Bezeichnungen @code{"1"},
 
 Das erste Beispiel könnte also auch wie folgt notiert werden:
 
-@lilypond[quote,relative=3,verbatim]
+@lilypond[quote,verbatim]
 <<
-  { r8 r16 g e8. f16 g8[ c,] f e16 d }
+  \relative { r8 r16 g'' e8. f16 g8[ c,] f e16 d }
   \\
-  { d16 c d8~ d16 b c8~ c16 b c8~ c16 b8. }
+  \relative { d''16 c d8~ 16 b c8~ 16 b c8~ 16 b8. }
 >>
 @end lilypond
 
@@ -378,7 +529,7 @@ Diese Syntax kann benutzt werden, wenn es keine Rolle spielt,
 ob vorübergehend Stimmen erstellt werden und dann wieder
 verworfen werden.  Diese implizit erstellten Stimmen erhalten
 die Einstellungen, die in den Befehlen
-@code{\voiceOne} ... @code{\voiceFour} enthalten sind, in
+@code{\voiceOne} @dots{} @code{\voiceFour} enthalten sind, in
 der Reihenfolge, in der sie im Quelltext auftauchen.
 
 Im nächsten Beispiel zeigen die Hälse der zeitweiligen Stimme
@@ -387,13 +538,13 @@ notiert, damit sie die Eigenschaften von @code{voiceThree}
 zugewiesen bekommt.  Unsichtbare Pause werden eingesetzt, damit
 keine doppelten Pausen ausgegeben werden.
 
-@lilypond[quote,relative=3,verbatim]
+@lilypond[quote,verbatim]
 <<
-  { r8 g g  g g f16 ees f8 d }
+  \relative { r8 g'' g  g g f16 ees f8 d }
   \\
-  { ees,8 r ees r d r d r }
+  \relative { ees'8 r ees r d r d r }
   \\
-  { d'8 s c s bes s a s }
+  \relative { d''8 s c s bes s a s }
 >>
 @end lilypond
 
@@ -437,6 +588,9 @@ Hälse nach oben, die graden Stimmen Hälse nach unten:
 >>
 @end lilypond
 
+@warning{Gesangstext und Strecker (etwa Bögen, Bindebögen, Crescendoklammern
+usw.) können nicht zwischen zwei Stimmen erstellt werden.}
+
 @strong{@i{Identische Rhythmen}}
 
 Wenn parallele Abschnitte gesetzt werden sollen,
@@ -446,10 +600,10 @@ sich Akkorde ergeben.  Um das zu erreichen, müssen sie einfach
 von spitzen Klammern innerhalb einer expliziten Stimme
 umgeben werden:
 
-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,verbatim]
 \new Voice <<
-  { e4 f8 d e16 f g8 d4 }
-  { c4 d8 b c16 d e8 b4 }
+  \relative { e''4 f8 d e16 f g8 d4 }
+  \relative { c''4 d8 b c16 d e8 b4 }
 >>
 @end lilypond
 
@@ -497,15 +651,15 @@ Schnipsel:
 Stimmen können unterschiedliche Farben erhalten, um einfach
 erkennbar zu sein:
 
-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,verbatim]
 <<
-  { \voiceOneStyle d4 c2 b4 }
+  \relative { \voiceOneStyle d''4 c2 b4 }
   \\
-  { \voiceTwoStyle e,2 e }
+  \relative { \voiceTwoStyle e'2 e }
   \\
-  { \voiceThreeStyle b2. c4 }
+  \relative { \voiceThreeStyle b2. c4 }
   \\
-  { \voiceFourStyle g'2 g }
+  \relative { \voiceFourStyle g'2 g }
 >>
 @end lilypond
 
@@ -547,21 +701,13 @@ Schnipsel:
 @cindex Pausen verschieben, automatisch
 @cindex Verschieben von Pausen, automatisch
 @funindex \shiftOn
-@funindex shiftOn
 @funindex \shiftOnn
-@funindex shiftOnn
 @funindex \shiftOnnn
-@funindex shiftOnnn
 @funindex \shiftOff
-@funindex shiftOff
 @funindex \mergeDifferentlyDottedOn
-@funindex mergeDifferentlyDottedOn
 @funindex \mergeDifferentlyDottedOff
-@funindex mergeDifferentlyDottedOff
 @funindex \mergeDifferentlyHeadedOn
-@funindex mergeDifferentlyHeadedOn
 @funindex \mergeDifferentlyHeadedOff
-@funindex mergeDifferentlyHeadedOff
 
 Die Notenköpfe von Noten in unterschiedlichen Stimmen mit derselben
 Tonhöhe, demselben Notenkopf und den Hälsen in entgegengesetzte
@@ -573,18 +719,20 @@ folgende Beispiel zeigt drei unterschiedliche Situationen, auf
 Taktposition 1 und 3 in Takt 1 und Taktposition 1 in Takt 2, wo das
 automatische Verschmelzen nicht funktioniert.
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
 <<
-  {
-    c8 d e d c d c4
+  \relative {
+    c''8 d e d c d c4
     g'2 fis
-  } \\ {
-    c2 c8. b16 c4
+  } \\
+  \relative {
+    c''2 c8. b16 c4
     e,2 r
-  } \\ {
+  } \\
+  \relative {
     \oneVoice
     s1
-    e8 a b c d2
+    e'8 a b c d2
   }
 >>
 @end lilypond
@@ -594,19 +742,21 @@ werden, mit der Ausnahme von Halben- und Viertelnotenköpfen, wie
 im Beispiel unten gezeigt.  Hier werden die Notenköpfe auf Taktposition
 1 im ersten Takt verschmolzen:
 
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim]
 <<
-  {
+  \relative {
     \mergeDifferentlyHeadedOn
-    c8 d e d c d c4
+    c''8 d e d c d c4
     g'2 fis
-  } \\ {
-    c2 c8. b16 c4
+  } \\
+  \relative {
+    c''2 c8. b16 c4
     e,2 r
-  } \\ {
+  } \\
+  \relative {
     \oneVoice
     s1
-    e8 a b c d2
+    e'8 a b c d2
   }
 >>
 @end lilypond
@@ -614,20 +764,22 @@ im Beispiel unten gezeigt.  Hier werden die Notenköpfe auf Taktposition
 Auch Köpfe mit unterschiedlichen Punktierungen wie auf Taktposition
 3 im ersten Takt können verschmolzen werden:
 
-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,verbatim]
 <<
-  {
+  \relative {
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
-    c8 d e d c d c4
+    c''8 d e d c d c4
     g'2 fis
-  } \\ {
-    c2 c8. b16 c4
+  } \\
+  \relative {
+    c''2 c8. b16 c4
     e,2 r
-  } \\ {
+  } \\
+  \relative {
     \oneVoice
     s1
-    e8 a b c d2
+    e'8 a b c d2
   }
 >>
 @end lilypond
@@ -645,21 +797,23 @@ Kolumne zu entfernen.  Jetzt funktioniert
 @code{\mergeDifferentlyHeadedOn} (verschmelze Noten mit unterschiedlichen
 Köpfen) so wie es soll.
 
-@lilypond[quote,relative=2,verbatim]
+@lilypond[quote,verbatim]
 <<
-  {
+  \relative {
     \mergeDifferentlyHeadedOn
     \mergeDifferentlyDottedOn
-    c8 d e d c d c4
+    c''8 d e d c d c4
     \shiftOn
     g'2 fis
-  } \\ {
-    c2 c8. b16 c4
+  } \\
+  \relative {
+    c''2 c8. b16 c4
     e,2 r
-  } \\ {
+  } \\
+  \relative {
     \oneVoice
     s1
-    e8 a b c d2
+    e'8 a b c d2
   }
 >>
 @end lilypond
@@ -687,10 +841,10 @@ der Stimmen in der Eingabedatei nicht die gleiche sein wie die vertikale
 Anordnung der Stimmen im Notensystem!}
 
 @lilypond[quote,verbatim]
-\new Staff \relative c'' {
+\new Staff \relative {
   %% abbreviated entry
   <<
-    { f2  }  % 1: highest
+    { f''2  }  % 1: highest
     \\
     { g,2 }  % 2: lowest
     \\
@@ -732,10 +886,10 @@ Richtungen gedreht sind).
 
 @snippets
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {additional-voices-to-avoid-collisions.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {forcing-horizontal-shift-of-notes.ly}
 
 @seealso
@@ -745,7 +899,7 @@ Musikglossar:
 Handbuch zum Lernen:
 @rlearning{Mehrere Noten auf einmal},
 @rlearning{Voice enthält Noten},
-@rlearning{Beispiele aus dem Leben}.
+@rlearning{Beispiel aus dem Leben}.
 
 Schnipsel:
 @rlsr{Simultaneous notes}.
@@ -756,17 +910,25 @@ Referenz der Interna:
 @rinternals{RestCollision}.
 
 @knownissues
+Die Benutzung von @code{\override NoteColumn.ignore-collision = ##t}
+führt dazu, dass Noten mit unterschiedlichen Köpfen in unterschiedlichen
+Stimmen falsch verschmolzen werden.
+
+@lilypond[quote,verbatim,fragment]
+\mergeDifferentlyHeadedOn
+<< \relative { c'16 a' b a } \\ \relative { c'2 } >>
+\override NoteColumn.ignore-collision = ##t
+<< \relative { c'16 a' b a } \\ \relative { c'2 } >>
+@end lilypond
+
 @ignore
+@knownissues
+
 @c TODO investigate! Sometimes it works, sometimes not. --FV
 The requirements for successfully merging different note heads that
 are at the same time differently dotted are not clear.
 @end ignore
 
-Es gibt keine Unterstützung für Akkorde, in denen die gleiche
-Note mit unterschiedlichen Versetzungszeichen im selben Akkord
-auftaucht.  In diesem Fall wird empfohlen, enharmonische
-Töne zu verwenden, oder die besondere Cluster-Notation (siehe @ref{Cluster}).
-
 
 @node Automatische Kombination von Stimmen
 @unnumberedsubsubsec Automatische Kombination von Stimmen
@@ -778,19 +940,18 @@ Töne zu verwenden, oder die besondere Cluster-Notation (siehe @ref{Cluster}).
 @cindex a due-Stellen
 @cindex solo-Stellen
 @funindex \partcombine
-@funindex partcombine
 
 Automatische Kombination von Stimmen wird verwendet, um zwei
-Stimmen auf einem Notensystem zu setzen.  Es wird vor allem
-in Orchesterpartituren eingesetzt.  Wenn beide Stimmen für
-einige Noten identisch sind, wird nur eine dargestellt.
-An den Stellen, an denen die beiden Stimmen sich unterscheiden,
-werden sie als unterschiedliche Stimmen gesetzt, und die
+selbständige Stimmen auf einem Notensystem zu setzen.  Es wird vor allem
+in Orchesterpartituren eingesetzt.  Wenn beide Stimmen
+die gleichen Noten haben, wird nur eine Stimme gesetzt, wenn
+sie sich unterscheiden, werden sie als unterschiedliche Stimmen
+(@code{Voice}) gesetzt, und die
 Richtung der Hälse wird automatisch bestimmt.  Zusätzlich
 werden @notation{solo} und @notation{a due}-Stellen erkannt
 und bezeichnet.
 
-Die Syntax zur Stimmenkombination lautet:
+Die Syntax zur automatischen Stimmenkombination lautet:
 
 @example
 \partcombine @var{musikAusdr1} @var{musikAusdr2}
@@ -798,24 +959,24 @@ Die Syntax zur Stimmenkombination lautet:
 
 Das nächste Beispiel zeigt, wie die Kombination funktioniert.
 Hier werden die Stimmen erst auf einem jeweils eigenen System
-und dann kombiniert gesetzt, beachten Sie, wie sich
-die Einstellungen für Polyphonie ändern.
+und dann kombiniert gesetzt.  Die gleichen Variablen werden
+für die Stimmen und das kombinierte System benutzt.
 
 @lilypond[quote,verbatim]
-instrumentOne = \relative c' {
-  c4 d e f
-  R1
-  d'4 c b a
-  b4 g2 f4
-  e1
+instrumentOne = \relative {
+  c'4 d e f |
+  R1 |
+  d'4 c b a |
+  b4 g2 f4 |
+  e1 |
 }
 
-instrumentTwo = \relative g' {
-  R1
-  g4 a b c
-  d c b a
-  g f( e) d
-  e1
+instrumentTwo = \relative {
+  R1 |
+  g'4 a b c |
+  d4 c b a |
+  g4 f( e) d |
+  e1 |
 }
 
 <<
@@ -825,16 +986,17 @@ instrumentTwo = \relative g' {
 >>
 @end lilypond
 
-Die Noten des dritten Taktes werden nur einfach ausgegeben, obwohl
-sie ein beiden Stimmen definiert sind.  Die Richtung von Hälsen und
+Beide Stimmen haben die gleichen Noten im dritten Takt, sodass
+sie nur als eine Stimme gesetzt werden.  Die Richtung von Hälsen und
 Bögen werden automatisch gewählt, abhängig davon ob es eine
 Solo-Stelle oder Unisono ist.  In polyphonen Situationen erhält
-die erste Stimme immer Hälse nach oben, die zweite Stimme
+die erste Stimme (mit dem Kontext @code{one}) immer Hälse nach oben,
+die zweite Stimme (mit dem Kontext @code{two})
 Hälse nach unten.  An Solo-Stellen werden die Stimmen mit
 @qq{Solo} bzw. @qq{Solo II} bezeichnet.  Die Unisono-Stellen
 (@notation{a due}) werden mit dem Text @qq{a2} gekennzeichnet.
 
-Beide Argumente von @code{\partcombine} werden als
+Beide Argumente von @code{\partcombine} werden als eigenständige
 @code{Voice}-Kontexte interpretiert.  Wenn relative Oktaven
 benutzt werden, muss @code{\relative} für beide Stimmen
 benutzt werden, also:
@@ -846,15 +1008,88 @@ benutzt werden, also:
 @end example
 
 @noindent
-Ein @code{\relative}-Abschnitt, der sich außerhalb von@code{\partcombine} befindet, hat keinen Einfluss auf
+Ein @code{\relative}-Abschnitt, der @code{\partcombine} umschließt, hat
+keinen Einfluss auf
 die Tonhöhen von @code{@var{musikAusdr1}} oder @code{@var{musikAusdr2}}.
 
+@funindex \partcombineChords
+@funindex \partcombineApart
+@funindex \partcombineUnisono
+@funindex \partcombineSoloI
+@funindex \partcombineSoloII
+@funindex \partcombineAutomatic
+
+In professionellen Partituren werden Stimmen oft für lange Strecken auseinander
+gehalten, auch wenn eine oder mehrere Noten tatsälich aufeinander treffen und
+einfach als Unisono gesetzt werden könnten.  Noten zu Akkorden zusammenzufassen
+oder eine Stimme als Solo anzuzeigen ist darum nicht ideal, weil die
+@code{\partcombine}-Funktion jede Note separat betrachtet.  Aus diesem
+Grund kann die @code{\partcombine}-Funktion mit folgenden Befehlen verändert
+werden:
+
+Befehle, die auf @code{@dots{} Once} enden, gelten nur für die nächste
+Note eines musikalischen Ausdrucks.
+
+@itemize
+@item
+@code{\partcombineApart} und @code{\once \partcombineApart}
+erhalten die Noten als zwei unterschiedliche Stimmen, auch wenn sie als Akkord
+oder Unisono kombiniert werden könnten.
+
+@item
+@code{\partcombineChords} und @code{\once \partcombineChords}
+kombinieren die Noten als Akkord.
+
+@item
+@code{\partcombineUnisono} und @code{\once \partcombineUnisono}
+kombinieren beide Stimmen als Unisono.
+
+@item
+@code{\partcombineSoloI} und @code{\once \partcombineSoloI}
+setzen nur Stimme eins und markieren sie als @qq{Solo}.
+
+@item
+@code{\partcombineSoloII} und @code{\once \partcombineSoloII}
+setzen nur Stimme zwei und markieren sie als @qq{Solo}.
+
+@item
+@code{\partcombineAutomatic} und @code{\once \partcombineAutomatic}
+beenden die Wirkung der Befehle oben und stellt das
+normale Verhalten des Kombinationsmechanismus wieder her.
+
+@end itemize
+
+@lilypond[quote,verbatim]
+instrumentOne = \relative c' {
+  \partcombineApart c2^"apart" e |
+  \partcombineAutomatic e2^"auto" e |
+  \partcombineChords e'2^"chord" e |
+  \partcombineAutomatic c2^"auto" c |
+  \partcombineApart c2^"apart" \once \partcombineChords e^"chord once" |
+  c2 c |
+}
+instrumentTwo = \relative {
+  c'2 c |
+  e2 e |
+  a,2 c |
+  c2 c' |
+  c2 c |
+  c2 c |
+}
+
+<<
+  \new Staff { \instrumentOne }
+  \new Staff { \instrumentTwo }
+  \new Staff { \partcombine \instrumentOne \instrumentTwo }
+>>
+@end lilypond
+
 @snippets
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {combining-two-parts-on-the-same-staff.ly}
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
 {changing-partcombine-texts.ly}
 
 @seealso
@@ -874,34 +1109,40 @@ Referenz der Interna:
 
 @knownissues
 
-@code{\partcombine} kann nur zwei Stimmen bearbeiten.
-
-Wenn @code{printPartCombineTexts} (drucke Stimmenkombinationstext)
-gesetzt ist und die Stimmen die gleichen Noten wiederholt
-spielen, kann @code{a2} in einem Takt mehrmals gesetzt werden.
-
-@code{\partcombine} kann nicht innerhalb von @code{\times} benutzt
-werden.
-
-@code{\partcombine} kann nicht innerhalb von @code{\relative}
-benutzt werden.
-
-Intern werden beide Argumente von @code{\partcombine} als
-Stimmen (@code{Voice}) interpretiert und entschieden, wann
-die Stimmen kombiniert werden können.  Wenn sie unterschiedliche
-Dauern haben, können sie nicht kombiniert werden und erhalten
-die Bezeichnung @code{one} und @code{two}  Darum werden
-Wechsel zu einem @code{Voice}-Kontext, der eine andere
-Bezeichnung hat, ignoriert.  Genausowenig ist die Stimmenkombination
-dazu ausgelegt, Gesangtext zu verarbeiten: wenn eine der
-Stimmen eine explizite Bezeichnung erhält, damit Text damit
-verknüpft werden kann, hört die Stimmenkombination auf zu
-arbeiten.
-
-@code{\partcombine} findet nur den Beginn von Noten.  Es kann
-nicht bestimmen, ob eine vorher begonnene Noten weiterklingt,
-was zu verschiedenen Problemen führen kann.
-
+Alle @code{\partcombine...}-Funktionen können nur zwei Stimmen
+aufnehmen und sind nicht für die Behandlung von Gesangstext geeignet.
+Das heißt, dass die Funktion nicht funktioniert, wenn einer der
+Kontexte explizit eine Bezeichnung erhält, um ihm etwa Gesangstext
+zuweisen zu können.
+
+@code{\partcombine...}-Funktionen können nicht innerhalb von 
+@code{\times}- oder @code{\relative}-Umgebungen geschrieben werden.
+
+Wenn @code{printPartCombineTexts} definiert ist und die zwei Stimmen
+die gleichen Noten abwechselnd spielen, kann es sein, dass die
+Kombinationsfunktion den Text @qq{a2} mehr als einmal im gleichen
+Takt setzt.
+
+@code{\partcombine} merkt nur, wenn eine Note in einer @code{Voice}-Umgebung
+beginnt; Information, dass eine Note in einer Stimme etwa schon
+begonnen hat, wenn die andere Stimme die gleiche Note spielt,
+fehlt.  Das kann zu einigen unerwarteten Problemen führen, wie etwa
+dass @qq{Solo} bzw. @qq{Unison} falsch gesetzt werden.
+
+@code{\partcombine} hält alle Strecker (Haltebögen, Legatobögen,
+Klammern usw.) in der gleichen @code{Voice}-Umgebung, sodass es
+sein kann, dass diese Strecker nicht korrekt erscheinen, wenn sie
+in einer anderen Stimme enden.
+
+Wenn die @code{\partcombine}-Funktion beide Noten nicht kombinieren
+kann (beispielsweise weil beide Stimmen unterschiedliche Dauern haben),
+werden die Stimmen intern in @code{one} und @code{two} benannt.  Das
+heißt, dass jeglicher Kontextwechsel zu einem @code{Voice}-Kontext
+mit anderer Bezeichnung ignoriert wird.
+
+Lesen Sie auch den Abschnitt @emph{Bekannte Probleme und Warnungen},
+wenn Sie @code{\partcombine} in Tabulaturen benutzen
+(siehe @ref{Standardtabulaturen}).
 
 @node Musik parallel notieren
 @unnumberedsubsubsec Musik parallel notieren
@@ -911,7 +1152,6 @@ was zu verschiedenen Problemen führen kann.
 @cindex Eingabe von Noten parallel
 @cindex Verschachtelte Musik
 @funindex \parallelMusic
-@funindex parallelMusic
 
 Noten für mehrere Stimmen können verschachtelt notiert werden.
 Die Funktion @code{\parallelMusic} akzeptiert eine Liste mit
@@ -928,12 +1168,12 @@ die Takte müssen die gleiche Länge haben.}
 \parallelMusic #'(voiceA voiceB voiceC) {
   % Bar 1
   r8 g'16 c'' e'' g' c'' e'' r8 g'16 c'' e'' g' c'' e'' |
-  r16 e'8.~   e'4            r16 e'8.~   e'4            |
+  r16 e'8.~   4              r16 e'8.~   4              |
   c'2                        c'2                        |
 
   % Bar 2
   r8 a'16 d'' f'' a' d'' f'' r8 a'16 d'' f'' a' d'' f'' |
-  r16 d'8.~   d'4            r16 d'8.~   d'4            |
+  r16 d'8.~   4              r16 d'8.~   4              |
   c'2                        c'2                        |
 
 }
@@ -954,12 +1194,12 @@ relative Noten von @code{voiceA} die Noten von @code{voiceB}.
 \parallelMusic #'(voiceA voiceB voiceC) {
   % Bar 1
   r8 g16 c e g, c e r8 g,16 c e g, c e  |
-  r16 e8.~ e4       r16 e8.~  e4        |
+  r16 e8.~ 4        r16 e8.~  4         |
   c2                c                   |
 
   % Bar 2
   r8 a,16 d f a, d f r8 a,16 d f a, d f |
-  r16 d8.~  d4       r16 d8.~  d4       |
+  r16 d8.~  4        r16 d8.~  4        |
   c2                 c                  |
 
  }
@@ -1018,7 +1258,7 @@ global = {
 
 @seealso
 Handbuch zum Lernen:
-@rlearning{Stücke durch Bezeichner organisieren}.
+@rlearning{Stücke durch Variablen organisieren}.
 
 Schnipsel:
 @rlsr{Simultaneous notes}.