Misc updates, thanks Mark Knoop.

[lilypond.git] / Documentation / user / simultaneous.itely

diff --git a/Documentation/user/simultaneous.itely b/Documentation/user/simultaneous.itely
index 4b1b48ee5f579bd4613b616075cb1055854ee5c8..eafcc36d243f2d7e4b7439b9807dc6df4be4282a 100644 (file)
--- a/Documentation/user/simultaneous.itely
+++ b/Documentation/user/simultaneous.itely
@@ -48,7 +48,11 @@ names}.
 
 @seealso
 
-Snippets: @lsrdir{simultaneous}
+Music Glossary: @rglos{chord}.
+
+Notation Reference: @ref{Introducing chord names}.
+
+Snippets: @lsrdir{simultaneous}.
 
 @refbugs
 
@@ -78,7 +82,7 @@ clusters.
 
 @seealso
 
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{simultaneous}.
 
 Internals Reference: @internalsref{ClusterSpanner},
 @internalsref{ClusterSpannerBeacon},
@@ -100,6 +104,9 @@ Examples: @lsr{contemporary,cluster@/.ly}.
 @node Collision resolution
 @unnumberedsubsubsec 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
 @code{merge-differently-dotted} is set in the
@@ -128,7 +135,7 @@ c8 c4. } \\ { c2 c2 } >>
 @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
@@ -137,6 +144,8 @@ 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
@@ -161,6 +170,10 @@ move the top @code{g} out of the column, and
 >>
 @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:
@@ -237,7 +250,7 @@ override typesetting decisions.
 
 @seealso
 
-Snippets: @lsrdir{simultaneous}
+Snippets: @lsrdir{simultaneous}.
 
 Internals Reference: the objects responsible for resolving
 collisions are @internalsref{NoteCollision} and
@@ -260,6 +273,7 @@ cluster notation (see @ref{Clusters}).
 @unnumberedsubsubsec 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
@@ -277,7 +291,7 @@ The syntax for part combining is
 
 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
@@ -293,7 +307,7 @@ and @q{Solo}, while the second (called @code{two}) always gets
 down stems and @q{Solo II}.
 
 If you just want the merging parts, and not the textual markings,
-you may set the property @code{printPartCombineTexts} to false
+you may set the property @code{printPartCombineTexts} to false.
 
 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
 \new Staff <<
@@ -337,13 +351,15 @@ has no effect on the pitches of @var{musicexpr1} and
 
 @seealso
 
-Snippets: @lsrdir{simultaneous}
+Music Glossary: @rglos{a due}.
+
+Snippets: @lsrdir{simultaneous}.
 
-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.
 
@@ -364,7 +380,7 @@ events in those will be ignored.
 @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) {
@@ -379,7 +395,7 @@ Music for multiple parts can be interleaved
 >>
 @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