DOCS -- Modify chord documentation

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

diff --git a/Documentation/user/chords.itely b/Documentation/user/chords.itely
index 3382c43d2f7f73b0cb3ab48b5d1551edb1b7a427..9c44ec986924a9db5406ca6cfea831d19a1f8299 100644 (file)
--- a/Documentation/user/chords.itely
+++ b/Documentation/user/chords.itely
@@ -73,7 +73,6 @@ Chord mode and note mode can be mixed in sequential music:
 
 
 @seealso
-
 Music Glossary:
 @rglos{chord}.
 
@@ -84,6 +83,7 @@ Notation Reference:
 Snippets:
 @rlsr{Chords}
 
+
 @knownissues
 
 When chord mode and note mode are mixed in sequential music, and
@@ -164,7 +164,7 @@ The default action; produces a major triad.
 }
 @end lilypond
 
-@item 
+@item
 m, m7
 @tab
 The minor chord.  This modifier lowers the 3rd and (if present) the
@@ -178,7 +178,7 @@ The minor chord.  This modifier lowers the 3rd and (if present) the
 @end lilypond
 
 
-@item 
+@item
 dim, dim7
 @tab
 The diminished chord.  This modifier lowers the 3rd, 5th and (if
@@ -191,7 +191,7 @@ present) the 7th step.
 }
 @end lilypond
 
-@item 
+@item
 aug
 @tab
 The augmented chord.  This modifier raises the 5th step.
@@ -203,7 +203,7 @@ The augmented chord.  This modifier raises the 5th step.
 }
 @end lilypond
 
-@item 
+@item
 maj, maj7
 @tab
 The major 7th chord.  This modifier adds a raised 7th step.  The
@@ -221,13 +221,22 @@ to create a major triad.
 
 
 @seealso
-
 Notation Reference:
-@ref{Common chord modifiers}.
+@ref{Common chord modifiers},
+@ref{Extended and altered chords}.
 
 Snippets:
 @rlsr{Chords}.
 
+@knownissues
+Only one quality modifier should be used per chord, typically on the 
+highest step present in the chord.  Chords with more than quality
+modifier will be parsed without an error or warning, but the results
+are unpredictable.  Chords that cannot be achieved with a single
+quality modifier should be altered by individual pitches, as described
+in @ref{Extended and altered chords}.
+
+
 @node Extended and altered chords
 @unnumberedsubsubsec Extended and altered chords
 
@@ -304,11 +313,11 @@ as part of the basic chord structure, add it as an altered step.
 
 @funindex ^
 
-Following any steps to be added, a series of steps to be removed 
-is introduced in a modifier string with a prefix of @code{^}.  
+Following any steps to be added, a series of steps to be removed
+is introduced in a modifier string with a prefix of @code{^}.
 If more than one step is to be removed, the steps to be
 removed are separated by @code{.} following the
-initial @code{^}. 
+initial @code{^}.
 
 @lilypond[quote,verbatim,fragment,relative=1]
 \chordmode {
@@ -356,17 +365,18 @@ moved as part of an inversion, by using @code{/+}@var{pitch}.
 @end lilypond
 
 Chord modifiers that can be used to produce a variety of
-standard chords are shown in 
+standard chords are shown in
 @ref{Common chord modifiers}.
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{Common chord modifiers}.
 
 Snippets:
 @rlsr{Chords}
 
+
 @knownissues
 
 Each step can only be present in a chord once.  The following
@@ -470,15 +480,12 @@ of the mode of entry, unless there are inversions or added bass notes:
 
 
 @seealso
-
 Music Glossary:
 @rglos{chord}.
 
-
 Notation Reference:
 @ref{Writing music in parallel}.
 
-
 Snippets:
 @rlsr{Chords}.
 
@@ -489,6 +496,7 @@ Internals Reference:
 @rinternals{Volta_engraver},
 @rinternals{Bar_engraver}.
 
+
 @knownissues
 
 Chords containing inversions or altered bass notes are not named
@@ -590,8 +598,8 @@ The spacer is not used when the root is altered.
 
 @end table
 
-@predefined
 
+@predefined
 @funindex major seven symbols
 @code{\whiteTriangleMarkup},
 @code{\blackTriangleMarkup},
@@ -603,6 +611,7 @@ The spacer is not used when the root is altered.
 @code{\italianChords},
 @funindex \frenchChords
 @code{\frenchChords}.
+@endpredefined
 
 
 @snippets
@@ -626,7 +635,6 @@ The spacer is not used when the root is altered.
 
 
 @seealso
-
 Notation Reference:
 @ref{Chord name chart},
 @ref{Common chord modifiers}.
@@ -642,6 +650,7 @@ Snippets:
 @c Internals Reference:
 @c @r internals{}.
 
+
 @knownissues
 
 Chord names are determined from both the pitches that are present
@@ -726,8 +735,8 @@ example, the vertical spacing of the figures may be set with
 @code{baseline-skip}.
 @end ignore
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{figured bass}.
 
@@ -899,33 +908,34 @@ End of continuation line
 @end multitable
 
 
-
 @predefined
 @cindex figured bass extender lines
 @code{\bassFigureExtendersOn},
 @code{\bassFigureExtendersOff}.
+@endpredefined
 
 
 @snippets
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {changing-the-positions-of-figured-bass-alterations.ly}
 
+
 @seealso
 @c Music Glossary:
 @c @rglos{}.
-
+@c
 @c Learning Manual:
 @c @rlearning{}.
-
+@c
 @c Notation Reference:
 @c @ref{}.
-
+@c
 @c Application Usage:
 @c @rprogram{}.
-
+@c
 @c Installed Files:
 @c @file{}.
-
+@c
 Snippets:
 @rlsr{Chords}.
 
@@ -937,8 +947,10 @@ Internals Reference:
 @rinternals{BassFigureContinuation},
 @rinternals{FiguredBass}.
 
+
 @c @knownissues
 
+
 @node Displaying figured bass
 @unnumberedsubsubsec Displaying figured bass
 
@@ -1014,25 +1026,28 @@ or below the staff.
 @code{\bassFigureStaffAlignmentDown},
 @code{\bassFigureStaffAlignmentUp},
 @code{\bassFigureStaffAlignmentNeutral}.
+@endpredefined
+
 
 @c @snippets
 
+
 @seealso
 @c Music Glossary:
 @c @rglos{}.
-
+@c
 @c Learning Manual:
 @c @rlearning{}.
-
+@c
 @c Notation Reference:
 @c @ref{}.
-
+@c
 @c Application Usage:
 @c @rprogram{}.
-
+@c
 @c Installed Files:
 @c @file{}.
-
+@c
 Snippets:
 @rlsr{Chords}.
 
@@ -1044,6 +1059,7 @@ Internals Reference:
 @rinternals{BassFigureContinuation},
 @rinternals{FiguredBass}.
 
+
 @knownissues
 
 To ensure that continuation lines work properly, it is