X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fsimultaneous.itely;h=0b9b14c57648869eecc48f0456b5ef4db6c89c29;hb=7eabbc26946c8a99e31d8512dacfbbdda7679265;hp=71b3a166ea86a5cd2a1ddbdbd679960078bc3828;hpb=b2a8663a7a20f55b0c3ce51671c9a0e920c60d50;p=lilypond.git

diff --git a/Documentation/user/simultaneous.itely b/Documentation/user/simultaneous.itely
index 71b3a166ea..0b9b14c576 100644
--- a/Documentation/user/simultaneous.itely
+++ b/Documentation/user/simultaneous.itely
@@ -6,6 +6,8 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c \version "2.11.38"
+
 @node Simultaneous notes
 @section Simultaneous notes
 
@@ -32,26 +34,35 @@ than one voice on the same staff.
 @node Chorded notes
 @subsubsection Chorded notes
 
-@cindex Chords
+@cindex chords
+@cindex brackets, angle
+@funindex <
+@funindex >
+@funindex <...>
 
-A chord is formed by a enclosing a set of pitches between @code{<}
-and @code{>}.  A chord may be followed by a duration, and a set of
+A chord is formed by a enclosing a set of pitches between @code{<} and
+@code{>}.  A chord may be followed by a duration and/or a set of
 articulations, just like simple notes:
 
 @lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
+<c e g>1 <c e g>->
 @end lilypond
 
-For more information about chords, see @ref{Introducing chord
-names}.
+For more information about chords, see @ref{Modern chords}.
 
 @seealso
 
-Music Glossary: @rglos{chord}.
+Music Glossary:
+@rglos{chord}.
+
+Learning Manual:
+@rlearning{Combining notes into chords}.
 
-Notation Reference: @ref{Introducing chord names}.
+Notation Reference:
+@ref{Modern chords}.
 
-Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
+Snippets:
+@lsrdir{Simultaneous,Simultaneous-notes}.
 
 @knownissues
 
@@ -59,37 +70,48 @@ Music expressions like @code{<< @{ g8 e8 @} a4 >>} are not printed
 accurately.  Use @code{<g a>8 <e a>8} instead.
 
 
-
 @node Clusters
 @subsubsection Clusters
 
 @cindex cluster
+@funindex \makeClusters
 
-A cluster indicates a continuous range of pitches to be played.
-They can be denoted as the envelope of a set of notes.  They are
-entered by applying the function @code{makeClusters} to a sequence
-of chords, e.g.,
+A cluster indicates a continuous range of pitches to be played.  They
+can be denoted as the envelope of a set of notes.  They are entered by
+applying the function @code{\makeClusters} to a sequence of chords,
+e.g.,
 
 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-\makeClusters { <c e > <b f'> }
+\makeClusters { <g b>2 <c g'> }
 @end lilypond
 
 Ordinary notes and clusters can be put together in the same staff,
 even simultaneously.  In such a case no attempt is made to
-automatically avoid collisions between ordinary notes and
-clusters.
+automatically avoid collisions between ordinary notes and clusters.
 
 @seealso
 
-Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
+Music Glossary:
+@rglos{cluster}.
 
-Internals Reference: @internalsref{ClusterSpanner},
+Snippets:
+@lsrdir{Simultaneous,Simultaneous-notes}.
+
+Internals Reference:
+@internalsref{ClusterSpanner},
 @internalsref{ClusterSpannerBeacon},
 @internalsref{Cluster_spanner_engraver}.
 
-Examples: @c @lsr{contemporary,cluster@/.ly}.
+@c Examples: @lsr{contemporary,cluster@/.ly}.
+
+@knownissues
 
+Clusters only look good if they span at least two chords; otherwise
+they appear too narrow.
 
+Clusters do not have a stem and can not indicate durations by
+themselves.  Separate clusters would need a separating rest between
+them.
 
 @node Multiple voices
 @subsection Multiple voices
@@ -249,10 +271,12 @@ override typesetting decisions.
 
 @seealso
 
-Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
+Snippets:
+@lsrdir{Simultaneous,Simultaneous-notes}.
 
-Internals Reference: the objects responsible for resolving
-collisions are @internalsref{NoteCollision} and
+Internals Reference: the objects responsible for resolving collisions
+are
+@internalsref{NoteCollision} and
 @internalsref{RestCollision}.
 
 
@@ -350,11 +374,15 @@ has no effect on the pitches of @var{musicexpr1} and
 
 @seealso
 
-Music Glossary: @rglos{a due}.
+Music Glossary:
+@rglos{a due}.
 
-Snippets: @lsrdir{Simultaneous,Simultaneous-notes}.
+Snippets:
+@lsrdir{Simultaneous,Simultaneous-notes}.
 
-Internals Reference: @internalsref{PartCombineMusic}, @internalsref{Voice}.
+Internals Reference:
+@internalsref{PartCombineMusic},
+@internalsref{Voice}.
 
 @knownissues
 
@@ -443,5 +471,6 @@ music = {
 
 @seealso
 
-Snippets: @lsrdir{Simultaneous,Simultaneous-notes}
+Snippets:
+@lsrdir{Simultaneous,Simultaneous-notes}.