Guide, node Updating translation committishes..
@end ignore
-@c \version "2.13.36"
+@c \version "2.14.0"
@node Chord notation
@funindex maj
@funindex m
-The table belows shows the actions of the quality modifiers on
+The table below shows the actions of the quality modifiers on
triads and seventh chords. The default seventh step added to
chords is a minor or flatted seventh, which makes the dominant
seventh the basic seventh chord. All alterations are relative to
@cindex chords, suppressing repeated
@funindex chordChanges
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{showing-chords-at-changes.ly}
-@c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
@c {adding-bar-lines-to-chordnames-context.ly}
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{simple-lead-sheet.ly}
system can be modified as described below. An alternate jazz
chord system has been developed using these modifications.
The Ignatzek and alternate
-Jazz notation are shown on the chart in @ref{Chord
-name chart}.
+Jazz notation are shown on the chart in @ref{Chord name chart}.
@c TODO -- Change this so we don't have a non-verbatim example.
@c Make short example in docs, then move longer example to
options are @code{whiteTriangleMarkup} and
@code{blackTriangleMarkup}.
+@funindex additionalPitchPrefix
+
+@item additionalPitchPrefix
+
+When the chord name contains additional pitches, they can optionally
+be prefixed with some text. The default is no prefix, in order to
+avoid too much visual clutter, but for small numbers of additional
+pitches this can be visually effective.
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+ <c e g d'> % add9
+ \set additionalPitchPrefix = #"add"
+ <c e g d'> % add9
+}
+@end lilypond
+
@funindex chordNoteNamer
@item chordNoteNamer
@item chordNameSeparator
-Different parts of a chord name are normally separated by a slash.
-By setting @code{chordNameSeparator}, you can use any desired markup
-for a separator.
+Different parts of a chord name are normally separated by a small
+amount of horizontal space. By setting @code{chordNameSeparator}, you
+can use any desired markup for a separator. This does not affect the
+separator between a chord and its bass note; to customize that, use
+@code{slashChordSeparator}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:7.9- c:7.9-/g
+ \set chordNameSeparator = \markup { "/" }
+ \break
+ c4:7.9- c:7.9-/g
+}
+@end lilypond
+
+@funindex slashChordSeparator
+
+@item slashChordSeparator
+
+Chords can be played over a bass note other than the conventional root
+of the chord. These are known as ``inversions'' or ``slash chords'',
+because the default way of notating them is with a forward slash
+between the main chord and the bass note. Therefore the value of
+@code{slashChordSeparator} defaults to a forward slash, but you can
+change it to any markup you choose.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:7.9- c:7.9-/g
+ \set slashChordSeparator = \markup { " over " }
+ \break
+ c4:7.9- c:7.9-/g
+}
+@end lilypond
@funindex chordNameExceptions
The second item is a markup that will follow the @code{chordRootNamer}
output to create the chord name.
+@funindex minorChordModifier
+
+@item minorChordModifier
+
+Minor chords are often denoted via a @q{m} suffix to the right of the
+root of the chord. However some idioms prefer other suffices, such as
+a minus sign.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:min f:min7
+ \set minorChordModifier = \markup { "-" }
+ \break
+ c4:min f:min7
+}
+@end lilypond
+
@funindex chordPrefixSpacer
+
@item chordPrefixSpacer
-The @q{m} for minor chords is usually printed immediately to the
-right of the root of the chord. A spacer can be placed between
-the root and @q{m} by setting @code{chordPrefixSpacer}.
-The spacer is not used when the root is altered.
+The modifier for minor chords as determined by
+@code{minorChordModifier} is usually printed immediately to the right
+of the root of the chord. A spacer can be placed between the root and
+the modifier by setting @code{chordPrefixSpacer}. The spacer is not
+used when the root is altered.
@end table
@snippets
@cindex exceptions, chord names.
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{chord-name-exceptions.ly}
@c TODO - tweak snippet to use \blackTriangleMarkup as well
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{chord-name-major7.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{adding-bar-lines-to-chordnames-context.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{volta-below-chords.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-chord-separator.ly}
@ref{Chord name chart},
@ref{Common chord modifiers}.
+Essay on automated music engraving:
+@ressay{Literature list}.
+
Installed Files:
-@file{scm/@/chords@/-ignatzek@/.scm},
-@file{scm/@/chord@/-entry@/.scm},
-@file{ly/@/chord@/-modifier@/-init@/.ly}.
+@file{scm/chords-ignatzek.scm},
+@file{scm/chord-entry.scm},
+@file{ly/chord-modifier-init.ly}.
Snippets:
@rlsr{Chords}.
@snippets
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-the-positions-of-figured-bass-alterations.ly}