]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/chords.itely
Doc: Minor fixes.
[lilypond.git] / Documentation / notation / chords.itely
index 50ac2bf9ed2277191bae3c5a9a8be1c3670f74c9..593e04a05aef1df1047b3b21edc2a8b6e787bec9 100644 (file)
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.14.0"
+@c \version "2.17.6"
 
 
 @node Chord notation
@@ -75,7 +75,6 @@ Chord mode and note mode can be mixed in sequential music:
 \chordmode { f2 g }
 @end lilypond
 
-
 @seealso
 Music Glossary:
 @rglos{chord}.
@@ -87,9 +86,7 @@ Notation Reference:
 Snippets:
 @rlsr{Chords}.
 
-
 @knownissues
-
 Predefined shorthands for articulations and ornaments cannot be used
 on notes in chord mode, see @ref{Articulations and ornamentations}.
 
@@ -112,6 +109,7 @@ To avoid this behavior, explicitly create the @code{Staff} context:
 }
 @end lilypond
 
+
 @node Common chords
 @unnumberedsubsubsec Common chords
 
@@ -170,7 +168,7 @@ The default action; produces a major triad.
 @tab
 @lilypond[line-width=4\cm, noragged-right]
 \chordmode {
-  \override Staff.TimeSignature #'stencil = ##f
+  \override Staff.TimeSignature.stencil = ##f
   c1
 }
 @end lilypond
@@ -182,7 +180,7 @@ The minor chord.  This modifier lowers the 3rd.
 @tab
 @lilypond[line-width=4\cm, noragged-right]
 \chordmode {
-  \override Staff.TimeSignature #'stencil = ##f
+  \override Staff.TimeSignature.stencil = ##f
   c1:m c:m7
 }
 @end lilypond
@@ -196,7 +194,7 @@ present) the 7th step.
 @tab
 @lilypond[line-width=4\cm, noragged-right]
 \chordmode {
-  \override Staff.TimeSignature #'stencil = ##f
+  \override Staff.TimeSignature.stencil = ##f
   c1:dim c:dim7
 }
 @end lilypond
@@ -208,7 +206,7 @@ The augmented chord.  This modifier raises the 5th step.
 @tab
 @lilypond[line-width=4\cm, noragged-right]
 \chordmode {
-  \override Staff.TimeSignature #'stencil = ##f
+  \override Staff.TimeSignature.stencil = ##f
   c1:aug
 }
 @end lilypond
@@ -222,14 +220,13 @@ to create a major triad.
 @tab
 @lilypond[line-width=4\cm, noragged-right]
 \chordmode {
-  \override Staff.TimeSignature #'stencil = ##f
+  \override Staff.TimeSignature.stencil = ##f
   c1:maj c:maj7
 }
 @end lilypond
 
 @end multitable
 
-
 @seealso
 Notation Reference:
 @ref{Common chord modifiers},
@@ -238,7 +235,6 @@ Notation Reference:
 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
@@ -383,7 +379,6 @@ Chord modifiers that can be used to produce a variety of
 standard chords are shown in
 @ref{Common chord modifiers}.
 
-
 @seealso
 Notation Reference:
 @ref{Common chord modifiers}.
@@ -391,9 +386,7 @@ Notation Reference:
 Snippets:
 @rlsr{Chords}.
 
-
 @knownissues
-
 Each step can only be present in a chord once.  The following
 simply produces the augmented chord, since @code{5+} is
 interpreted last.
@@ -412,6 +405,7 @@ the chord.
 }
 @end lilypond
 
+
 @node Displaying chords
 @subsection Displaying chords
 
@@ -521,7 +515,6 @@ Rests passed to a @code{ChordNames} context will cause the
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {simple-lead-sheet.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{chord}.
@@ -539,9 +532,7 @@ Internals Reference:
 @rinternals{Volta_engraver},
 @rinternals{Bar_engraver}.
 
-
 @knownissues
-
 Chords containing inversions or altered bass notes are not named
 properly if entered using simultaneous music.
 
@@ -572,7 +563,7 @@ Jazz notation are shown on the chart in @ref{Chord name chart}.
 
 In addition to the different naming systems, different note names
 are used for the root in different languages.  The predefined
-variables @code{\germanChords}, @code{\semiGermanChords},
+commands @code{\germanChords}, @code{\semiGermanChords},
 @code{\italianChords} and @code{\frenchChords} set these variables.
 The effect is demonstrated here:
 
@@ -616,6 +607,23 @@ of @code{chordRootNamer} to identify a major 7 chord.  Predefined
 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
@@ -631,9 +639,40 @@ bass note can be printed in lower case.
 
 @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
 
@@ -644,13 +683,32 @@ is a set of pitches used to identify the steps present in the chord.
 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
 
@@ -689,7 +747,6 @@ The spacer is not used when the root is altered.
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {changing-chord-separator.ly}
 
-
 @seealso
 Notation Reference:
 @ref{Chord name chart},
@@ -706,12 +763,7 @@ Installed Files:
 Snippets:
 @rlsr{Chords}.
 
-@c Internals Reference:
-@c @r internals{}.
-
-
 @knownissues
-
 Chord names are determined from both the pitches that are present
 in the chord and the information on the chord structure that may
 have been entered in @code{\chordmode}.  If the simultaneous pitches
@@ -733,7 +785,8 @@ myChords = \relative c' {
 @node Figured bass
 @subsection Figured bass
 
-@lilypondfile[quote]{figured-bass-headword.ly}
+@c Line width hack because of instrument names
+@lilypondfile[quote,staffsize=18,line-width=14.5\cm]{figured-bass-headword.ly}
 
 Figured bass notation can be displayed.
 
@@ -794,7 +847,6 @@ example, the vertical spacing of the figures may be set with
 @code{baseline-skip}.
 @end ignore
 
-
 @seealso
 Music Glossary:
 @rglos{figured bass}.
@@ -978,23 +1030,7 @@ End of continuation line
 @lilypondfile[verbatim,quote,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}.
 
@@ -1007,9 +1043,6 @@ Internals Reference:
 @rinternals{FiguredBass}.
 
 
-@c @knownissues
-
-
 @node Displaying figured bass
 @unnumberedsubsubsec Displaying figured bass
 
@@ -1044,13 +1077,13 @@ figures is adjusted automatically.
 
 @lilypond[verbatim,ragged-right,quote]
 <<
-  \new Staff = myStaff
+  \new Staff = "myStaff"
   \figuremode {
     <4>4 <10 6>8 s8
     <6 4>4 <6 4>
   }
   %% Put notes on same Staff as figures
-  \context Staff = myStaff
+  \context Staff = "myStaff"
   {
     \clef bass
     c4 c'8 r8 c4 c'
@@ -1064,14 +1097,14 @@ or below the staff.
 
 @lilypond[verbatim,ragged-right,quote]
 <<
-  \new Staff = myStaff
+  \new Staff = "myStaff"
   \figuremode {
     <4>4 <10 6>8 s8
     \bassFigureStaffAlignmentDown
     <6 4>4 <6 4>
   }
   %% Put notes on same Staff as figures
-  \context Staff = myStaff
+  \context Staff = "myStaff"
   {
     \clef bass
     c4 c'8 r8 c4 c'
@@ -1079,7 +1112,6 @@ or below the staff.
 >>
 @end lilypond
 
-
 @predefined
 @cindex figured bass alignment
 @code{\bassFigureStaffAlignmentDown},
@@ -1087,26 +1119,7 @@ or below the staff.
 @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}.
 
@@ -1118,9 +1131,7 @@ Internals Reference:
 @rinternals{BassFigureContinuation},
 @rinternals{FiguredBass}.
 
-
 @knownissues
-
 To ensure that continuation lines work properly, it is
 safest to use the same rhythm in the figure line as in
 the bass line.
@@ -1151,32 +1162,3 @@ the bass line.
   }
 >>
 @end lilypond
-
-When using extender lines, adjacent figures with the same number in
-a different figure location can cause the figure positions to invert.
-
-@lilypond[verbatim,ragged-right,quote,relative=1]
-<<
-  { fis4 g g, e' }
-  \figures {
-    \bassFigureExtendersOn
-    <6 5>4 <5\! 4> < 5 _!> <6>
-  }
->>
-@end lilypond
-
-To avoid this problem, simply turn on extenders after the figure that
-begins the extender line and turn them off at the end of the extender line.
-
-@lilypond[verbatim,ragged-right,quote,relative=1]
-<<
-  { fis4 g g, e' }
-  \figures {
-    <6 5>4 <5 4>
-    \bassFigureExtendersOn
-    < 5 _!>4 <6>
-    \bassFigureExtendersOff
-  }
->>
-@end lilypond
-