@end menu
@node Chorded notes
-@unnumberedsubsubsec Chorded notes
+@subsubsection Chorded notes
@cindex Chords
@seealso
-Snippets: @lsrdir{simultaneous}
+Music Glossary: @rglos{chord}.
+
+Notation Reference: @ref{Introducing chord names}.
+
+Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
@refbugs
@node Clusters
-@unnumberedsubsubsec Clusters
+@subsubsection Clusters
@cindex cluster
@seealso
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
Internals Reference: @internalsref{ClusterSpanner},
@internalsref{ClusterSpannerBeacon},
@internalsref{Cluster_spanner_engraver}.
-Examples: @lsr{contemporary,cluster@/.ly}.
+Examples: @c @lsr{contemporary,cluster@/.ly}.
@end menu
@node Collision resolution
-@unnumberedsubsubsec Collision resolution
+@subsubsection Collision resolution
+
+@cindex merging notes
+@cindex note collisions
Normally, note heads with a different number of dots are not
merged, but when the object property
@noindent
@code{merge-differently-headed} and
@code{merge-differently-dotted} only apply to opposing stem
-directions (ie. Voice 1 & 2).
+directions (i.e. Voice 1 & 2).
LilyPond also vertically shifts rests that are opposite of a stem,
for example
\new Voice << c''4 \\ r4 >>
@end lilypond
+@cindex shift note
+
If three or more notes line up in the same column,
@code{merge-differently-headed} cannot successfully complete the
merge of the two notes that should be merged. To allow the merge
>>
@end lilypond
+@cindex multiple voices
+@cindex polyphonic music
+@cindex shifting voices
+
In some instances of complex polyphonic music, you may need
additional voices to avoid collisions between notes. Additional
voices are added by defining an variable, as shown below:
@seealso
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
Internals Reference: the objects responsible for resolving
collisions are @internalsref{NoteCollision} and
@node Automatic part combining
-@unnumberedsubsubsec Automatic part combining
+@subsubsection Automatic part combining
@cindex automatic part combining
@cindex part combiner
+@cindex combining parts
Automatic part combining is used to merge two parts of music onto
a staff. It is aimed at typesetting orchestral scores. When the
The following example demonstrates the basic functionality of the
part combiner: putting parts on one staff, and setting stem
-directions and polyphony
+directions and polyphony.
@lilypond[quote,verbatim,ragged-right,fragment]
\new Staff \partcombine
down stems and @q{Solo II}.
If you just want the merging parts, and not the textual markings,
-you may set the property @code{printPartCombineTexts} to false
+you may set the property @code{printPartCombineTexts} to false.
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
\new Staff <<
@seealso
-Snippets: @lsrdir{simultaneous}
+Music Glossary: @rglos{a due}.
+
+Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
-Internals Reference: @internalsref{PartCombineMusic}.
+Internals Reference: @internalsref{PartCombineMusic}, @internalsref{Voice}.
@refbugs
-When @code{printPartCombineTexts} is set, when the two voices play
+When @code{printPartCombineTexts} is set, if the two voices play
the same notes on and off, the part combiner may typeset @code{a2}
more than once in a measure.
@node Writing music in parallel
-@unnumberedsubsubsec Writing music in parallel
+@subsubsection Writing music in parallel
@cindex Writing music in parallel
@cindex Interleaved music
-Music for multiple parts can be interleaved
+Music for multiple parts can be interleaved:
@lilypond[quote,fragment,verbatim]
\parallelMusic #'(voiceA voiceB) {
>>
@end lilypond
-This works quite well for piano music
+This works quite well for piano music.
@c It would be nice if the first bar fit onto one 66-char line.
@c Maybe simplify the example? -gp
@seealso
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{Simultaneous,Simultaneous-notes}