Add todo from issue tracker.

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

diff --git a/Documentation/user/chords.itely b/Documentation/user/chords.itely
index eb4af9a7058371b0f994cb74fa6a1ef6b0436a58..e6bd3c8a21caa877294ea677a93555dc6935a300 100644 (file)
--- a/Documentation/user/chords.itely
+++ b/Documentation/user/chords.itely
@@ -125,7 +125,7 @@ Minor, augmented, and diminished triads are entered by placing
 \chordmode { c2:m f4:aug g:dim }
 @end lilypond
 
-Seventh chords may be created:
+Seventh chords can be created:
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
 \chordmode { c1:7 c:m7 c:maj7 c:dim7 c:aug7 }
@@ -343,7 +343,7 @@ Chords can be entered as simultaneous notes or through the use of
 chord mode.  The displayed chord name will be the same, regardless
 of the mode of entry, unless there are inversions or added bass notes:
 
-@lilypond[quote,ragged-right,verbatim]
+@lilypond[quote,ragged-right,verbatim,relative=1]
 <<
   \new ChordNames {
     <c e g>2  <f bes c>
@@ -364,9 +364,8 @@ of the mode of entry, unless there are inversions or added bass notes:
 
 @funindex{\chords}
 
-@code{\chords} is a shortcut method used to create a
-@code{ChordNames} context and change the input mode to
-@code{\chordmode}:
+@code{\chords @{ ... @}} is a shortcut notation for
+@code{\new ChordNames @{\chordmode @{ ... @}@}}.
 
 @lilypond[verbatim,quote,ragged-right, relative=1]
 \chords {
@@ -563,12 +562,11 @@ and @q{m}.  The spacer is not used when the root is altered.
 
 
 @snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{chord-names-jazz.ly}
 
+@c TODO fix indentation of snippet -- lots of tabs!
+@cindex exceptions, chord names.
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {chord-name-exceptions.ly}
-@cindex exceptions, chord names.
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {chord-name-major7.ly}
@@ -595,6 +593,9 @@ can be set to any markup.
 
 @seealso
 
+Notation Reference:
+@ref{Chord name chart}.
+
 Installed Files:
 @file{scm/@/chords@/-ignatzek@/.scm},
 @file{scm/@/chord@/-entry@/.scm},
@@ -641,10 +642,15 @@ Figured bass notation can be displayed.
 @unnumberedsubsubsec Introduction to figured bass
 
 @cindex Basso continuo
+@cindex Thorough bass
+@cindex Figured bass
+@cindex Bass, thorough
+@cindex Bass, figured
 
 @c TODO: musicological blurb about FB
 
-LilyPond has support for figured bass
+LilyPond has support for figured bass, also called thorough bass
+or basso continuo:
 
 @lilypond[quote,ragged-right,verbatim,fragment]
 <<
@@ -663,17 +669,17 @@ The support for figured bass consists of two parts: there is an
 input mode, introduced by @code{\figuremode}, that accepts
 entry of bass figures, and there is a context named
 @code{FiguredBass} that takes care of displaying
-@code{BassFigure} objects.
+@code{BassFigure} objects.  Figured bass can also be displayed
+in @code{Staff} contexts.
 
-@code{\figures@{ ..@}} is a shortcut notation for
-@code{\new FiguredBass @{\figuremode @{ ..@}@}}.
+@code{\figures@{ ... @}} is a shortcut notation for
+@code{\new FiguredBass @{\figuremode @{ ... @}@}}.
 
 
 Although the support for figured bass may superficially resemble chord
 support, it is much simpler.  @code{\figuremode} mode simply
 stores the figures and the @code{FiguredBass} context prints them
-as entered.  There is no conversion to pitches.  Figured bass has
-no effect on the MIDI file.
+as entered.  There is no conversion to pitches.
 
 Figures are created as markup texts.  Any of the standard markup
 properties can be used to modify the display of figures.  For
@@ -711,7 +717,7 @@ can be notated.
 
 @lilypond[verbatim,quote,ragged-right,fragment]
 \figures {
-  <7/> <6\+ 5/>
+  <6\+ 5/> <7/>
 }
 @end lilypond
 
@@ -734,9 +740,8 @@ Any text markup can be inserted as a figure:
 
 Continuation lines can be used to indicate repeated figures:
 
-@c  I know I'm not supposed to use \set, but I think
-@c  it's part of the notation -- suggestions?  -cds
-
+@c  \set to be replaced with predefined command once it is
+@c   included in property-init.ly
 @lilypond[verbatim,quote,ragged-right,fragment]
 \figures {
   \set useBassFigureExtenders = ##t
@@ -757,6 +762,7 @@ depending on the @code{figuredBassAlterationDirection} and
 @code{figuredBassPlusDirection}
 properties
 
+@c  TODO Need to set predefined commands for these directions as well. -cs
 @lilypond
   \figures {
     <6\+> <5+> <6 4-> r
@@ -807,7 +813,7 @@ or in most staff contexts.
 When displayed in a @code{FiguredBass} context, the vertical location
 of the figures is independent of the notes on the staff.
 
-@lilypond[ragged-right,fragment,quote]
+@lilypond[verbatim,ragged-right,fragment,quote]
 <<
   \relative c'' {
     c4 c'8 r8 c,4 c'
@@ -827,14 +833,12 @@ explicitly instantiated to avoid creating a second (empty) staff.
 
 
 Figured bass can also be added to @code{Staff} contexts
-directly.  In this case, their vertical position is adjusted
-automatically.
-
-@c  This example uses /override, because the default
-@c    of 'direction is #UP,
-@c    even though UP is never used for figured bass.
-@c    I recommend that we leave it -cds
-@lilypond[ragged-right,fragment,quote]
+directly.  In this case, the vertical position of the
+figures is adjusted automatically.
+
+@c  TODO change to use predefined command once it is added to
+@c  property-init.ly  -cds
+@lilypond[verbatim,ragged-right,fragment,quote]
 <<
   \new Staff = myStaff
   \figuremode {
@@ -906,7 +910,7 @@ To ensure that continuation lines work properly, it is
 safest to use the same rhythm in the figure line as in
 the bass line.
 
-@lilypond[ragged-right,fragment,quote]
+@lilypond[verbatim,ragged-right,fragment,quote]
 <<
   {
     \clef bass
@@ -935,6 +939,7 @@ the bass line.
 @end lilypond
 
 @c I have no idea what this means -cds
+@c A predefined command for changing this has been proposed -cds
 When using figured bass above the staff with extender lines and
 @code{implicitBassFigures} the lines may become swapped around.
 Maintaining order consistently will be impossible when multiple figures