@seealso
-Snippets: @lsrdir{simultaneous}
+Music Glossary: @rglos{chord}.
+
+Notation Reference: @ref{Introducing chord names}.
+
+Snippets: @lsrdir{simultaneous}.
@refbugs
@seealso
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{simultaneous}.
Internals Reference: @internalsref{ClusterSpanner},
@internalsref{ClusterSpannerBeacon},
@node Collision resolution
@unnumberedsubsubsec Collision resolution
-@cindex Merging noteheads
+@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}.
Internals Reference: the objects responsible for resolving
collisions are @internalsref{NoteCollision} and
@seealso
-Snippets: @lsrdir{simultaneous}
+@c FIXME: add Music Glossary: @rglos{a due}. after glossary addition.
+
+Snippets: @lsrdir{simultaneous}.
Internals Reference: @internalsref{PartCombineMusic}.