Doc: NR - Chord Repetition - examples and wording

Updated the .ly examples to show many different instances of how
this symbol can be used.
Reworded some uncomfortable syntax for the explanations and descriptions.

diff --git a/Documentation/notation/simultaneous.itely b/Documentation/notation/simultaneous.itely
index 2efaf4f63b62f3b7fd0c0910e36ae09d747d47ea..7f0a71a738d68087e92593b6dcce2eea5e65aa4b 100644 (file)
--- a/Documentation/notation/simultaneous.itely
+++ b/Documentation/notation/simultaneous.itely
@@ -86,25 +86,23 @@ In order to save typing, a shortcut can be used to repeat the preceding
 chord.  The chord repetition symbol is @code{q}:
 
 @lilypond[verbatim,quote,relative=1]
-<c e g> q q q
+<c e g>4 q q q
 @end lilypond
 
-As in the case of regular chords, the chord repetition symbol can be
-followed by a duration and articulations.  Only the pitches of the
-previous chord are duplicated; articulations, dynamics, etc, are not
-repeated.
+As with regular chords, the chord repetition symbol can be used with
+durations, articulations, markups, slurs, beams, etc. as only the
+pitches of the previous chord are duplicated.
 
 @lilypond[verbatim,quote,relative=1]
-<c e g>8\p q q4-| q8.^"text" q16 q4-|
+<c e g>4\p q^"text"( q8)[-| q8.] q16-1-2-3
 @end lilypond
 
-Note chords (entered using angle brackets) only are memorized in order
-to be repeated by @code{q}: it is possible to repeat a chord even if for
-instance a simple note (without angle brackets) or a rest have been
-entered meanwhile.
+The chord repetition symbol always remembers the last instance of
+a chord so it is possible to repeat the most recent chord even if
+other non-chorded notes or rests have been added since.
 
 @lilypond[verbatim,quote,relative=1]
-<c e g>8 c' q c r4 q
+<c e g>8 c'4 q r8 q
 @end lilypond
 
 @seealso