DOCS -- Modify chord documentation

Add known issue to clarify that only one modifier is
allowed per chord

Adjust appendix table of chords to be consistent
with this policy

diff --git a/Documentation/user/chords.itely b/Documentation/user/chords.itely
index c66c74f2246ae3faffa7aed2b7975a5676271a2e..9c44ec986924a9db5406ca6cfea831d19a1f8299 100644 (file)
--- a/Documentation/user/chords.itely
+++ b/Documentation/user/chords.itely
@@ -222,11 +222,20 @@ 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

diff --git a/Documentation/user/notation-appendices.itely b/Documentation/user/notation-appendices.itely
index 105bb775eda5b205d7e2668b6469dbbfeb1ad040..a5b436d75fb83867197c7339cfbc6a704b6eceae 100644 (file)
--- a/Documentation/user/notation-appendices.itely
+++ b/Documentation/user/notation-appendices.itely
@@ -198,11 +198,11 @@ Half-diminished seventh
 @tab
 Diminished triad, minor seventh
 @tab
-@code{dim5m7}
+@code{m7.5-}
 @tab
 @lilypond[line-width=3\cm,noragged-right, notime]
 \chordmode {
-  c1:dim5m7
+  c1:m7.5-
 }
 @end lilypond
 
@@ -211,11 +211,11 @@ Minor-major seventh
 @tab
 Minor triad, major seventh
 @tab
-@code{maj7m5}
+@code{maj7.5-}
 @tab
 @lilypond[line-width=3\cm,noragged-right, notime]
 \chordmode {
-  c1:maj7m5
+  c1:maj7.5-
 }
 @end lilypond