From 4269f54b663421ca2c5c2c57baa5d9c49709d6d2 Mon Sep 17 00:00:00 2001
From: James Lowe <pkx16h@gmail.com>
Date: Sun, 25 Dec 2011 10:16:55 +0000
Subject: [PATCH] Doc: NR Improve 'visibility' of 'q' operation

Improve visibility of q (repeated chord) operation within NR
a few users have noted that this has been hard to find

Added some cindexes and additional paragraph in repeats.itely
Edited/added some @seealso and @cindex to frettd-strings.itely
and simultaneous.itely
---
 Documentation/notation/fretted-strings.itely | 14 ++++-----
 Documentation/notation/repeats.itely         | 32 ++++++++++----------
 Documentation/notation/simultaneous.itely    |  3 ++
 3 files changed, 25 insertions(+), 24 deletions(-)

diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely
index 4574e9bda1..dd304696ff 100644
--- a/Documentation/notation/fretted-strings.itely
+++ b/Documentation/notation/fretted-strings.itely
@@ -254,6 +254,8 @@ minimumFret is 0.
 @end lilypond
 
 @funindex \tabChordRepetition
+@cindex Chord, repetiton
+@cindex repetiton, using @code{q}
 
 Chord constructs can be repeated by the chord repetition symbol
 @code{q}. To use this feature in combination with tablature,
@@ -280,7 +282,6 @@ guitar = \relative c' {
 >>
 @end lilypond
 
-
 Ties over a line break are parenthesized by default.  The same holds for
 the second alternative of a repeat.
 
@@ -423,9 +424,7 @@ ratioHarmonics = {
 }
 @end lilypond
 
-
 @snippets
-
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {stem-and-beam-behavior-in-tablature.ly}
 
@@ -444,12 +443,13 @@ ratioHarmonics = {
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {chord-glissando-in-tablature.ly}
 
-
 @seealso
 Notation Reference:
-@ref{Stems},
+@ref{Chord repetition},
+@ref{Glissando},
 @ref{Harmonics},
-@ref{Glissando}.
+@ref{Stems},
+@ref{Written-out repeats}.
 
 Snippets:
 @rlsr{Fretted strings}.
@@ -460,9 +460,7 @@ Internals Reference:
 @rinternals{TabVoice},
 @rinternals{Beam}.
 
-
 @knownissues
-
 Chords are not handled in a special way, and hence the automatic
 string selector may easily select the same string for two notes in
 a chord.
diff --git a/Documentation/notation/repeats.itely b/Documentation/notation/repeats.itely
index 7af38d2d29..57a5dfb8fe 100644
--- a/Documentation/notation/repeats.itely
+++ b/Documentation/notation/repeats.itely
@@ -52,7 +52,7 @@ This is used to write tremolo beams.
 
 This section discusses how to input long (usually multi-measure)
 repeats.  The repeats can take two forms: repeats enclosed between
-repeat signs; or written out repeats, used to input repetitious music.
+repeat signs; or written-out repeats, used to input repetitious music.
 Repeat signs can also be controlled manually.
 
 @menu
@@ -444,18 +444,17 @@ Internals Reference:
 @unnumberedsubsubsec Written-out repeats
 
 @cindex written-out repeats
-@cindex repetitious music
 @cindex repeats, written-out
-@cindex repeat, unfold
-@cindex unfold music
+@cindex repeats, unfold
+@cindex repeats, alternative
 @cindex unfold repeat
-@cindex unfold repeat with alternate endings
-@cindex unfold music with alternate endings
-@cindex alternate ending in written-out repeats
+@cindex unfold repeat, alternate endings
+@cindex alternate repeats
+@cindex alternate endings, repeats
 @funindex unfold
 
-By using the @code{unfold} command, repeats can be used to simplify
-the writing out of repetitious music.  The syntax is
+By using the @code{unfold} command, repeats can be used to simplify the
+writing out of repetitious music.  The syntax is
 
 @example
 \repeat unfold @var{repeatcount} @var{musicexpr}
@@ -485,7 +484,6 @@ is not equivalent to
 a'4 b c | a'4 b c
 @end example
 
-
 Unfold repeats can be made with alternate endings.
 
 @lilypond[verbatim,quote,relative=2]
@@ -539,14 +537,17 @@ without alternate endings).
 c1
 @end lilypond
 
+Chord constructs can be repeated by the chord repetition symbol
+@code{q}.  See @ref{Chord repetition}.
 
-@warning{If you include @code{@bs{}relative} inside a
-@code{@bs{}repeat} without explicitly instantiating the
-@code{Voice} context, extra (unwanted) staves will appear.  See
-@rprogram{An extra staff appears}.}
-
+@warning{If you include @code{@bs{}relative} inside a @code{@bs{}repeat}
+without explicitly instantiating the @code{Voice} context, extra
+(unwanted) staves will appear.  See @rprogram{An extra staff appears}.}
 
 @seealso
+Notation Reference:
+@ref{Chord repetition}.
+
 Snippets:
 @rlsr{Repeats}.
 
@@ -554,7 +555,6 @@ Internals Reference:
 @rinternals{RepeatedMusic},
 @rinternals{UnfoldedRepeatedMusic}.
 
-
 @node Short repeats
 @subsection Short repeats
 
diff --git a/Documentation/notation/simultaneous.itely b/Documentation/notation/simultaneous.itely
index 47dfcf364a..9f539879ee 100644
--- a/Documentation/notation/simultaneous.itely
+++ b/Documentation/notation/simultaneous.itely
@@ -133,6 +133,9 @@ enharmonic transcription of one or more pitches,
 @node Chord repetition
 @unnumberedsubsubsec Chord repetition
 
+@cindex Chord, repetiton
+@cindex repetiton, using @code{q}
+
 In order to save typing, a shortcut can be used to repeat the preceding
 chord.  The chord repetition symbol is @code{q}:
 
-- 
2.39.2