4915: NR: Mention standalone accidentals in figuremode

[lilypond.git] / Documentation / notation / chords.itely

diff --git a/Documentation/notation/chords.itely b/Documentation/notation/chords.itely
index 3005e88b4475d4158a5444e5f66676df916ea351..acc8f14f9d1488d100d5b5c6e31d10c08c1f8d6a 100644 (file)
--- a/Documentation/notation/chords.itely
+++ b/Documentation/notation/chords.itely
@@ -258,7 +258,8 @@ larger value is interpreted as 13.
 @end lilypond
 
 @noindent
-Note that both @code{c:5} and @code{c} produce a C major triad.
+As a special exception, @code{c:5} produces a @q{power chord} only
+consisting of root and fifth.
 
 Since an unaltered 11 does not sound good when combined with an
 unaltered 13, the 11 is removed from a @code{:13} chord (unless it
@@ -322,14 +323,15 @@ initial @code{^}.
 @funindex sus
 
 The modifier @code{sus} can be added to the modifier string to
-create suspended chords.  This removes the 3rd step from the chord.
-Append either @code{2} or @code{4} to add the 2nd or 4th step to the
-chord.  @code{sus} is equivalent to @code{^3}; @code{sus4} is
-equivalent to @code{.4^3}.
+create suspended chords.  This removes the 3rd step from the
+chord.  Append either @code{2} or @code{4} to add the 2nd or 4th
+step to the chord.  When @code{sus} is followed by either a 2nd or
+4th step, it is equivalent to @code{^3}, otherwise to @code{sus4},
+namely @code{5.4}.
 
 @lilypond[quote,ragged-right,verbatim]
 \chordmode {
-  c1:5 c:sus2 c:sus4 c:5.4
+  c1:sus c:sus2 c:sus4 c:5.4
 }
 @end lilypond
 
@@ -846,11 +848,16 @@ In figure mode, a group of bass figures is delimited by
 @end lilypond
 
 
-Accidentals (including naturals) can be added to figures:
+Accidentals (including naturals) may be used for modifying scale steps.
+These are entered by appending @code{+} (for sharps), @code{-} (for flats)
+or @code{!} (for naturals) after the number.  For double accidentals the
+modifier is applied twice.  For the modification of the third step the
+number is often omitted, which can be achieved by using @code{_} instead
+of a number.
 
 @lilypond[verbatim,quote,ragged-right]
 \figures {
-  <7! 6+ 4-> <5++> <3-->
+  <7! 6+ 4-> <5++> <3--> < _+ > < 7 _!>
 }
 @end lilypond
 
@@ -871,11 +878,11 @@ sixth steps) can be created:
 }
 @end lilypond
 
-Vertical spaces and brackets can be included in figures:
+Brackets can be included in figures:
 
 @lilypond[verbatim,quote,ragged-right]
 \figures {
-  <[12 _!] 8 [6  4]>
+  <[12] 8 [6  4]>
 }
 @end lilypond