X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fchords.itely;h=753d82bb3d4b781096701ebfcb1a7a11ad58b555;hb=32a34dcef0c0041c6d62677487a380b5c8b85712;hp=1109075d66eb9dfb0283e5b0e39c90db5b004817;hpb=f41973ff763d5972a85995b6d40c864281ec6714;p=lilypond.git diff --git a/Documentation/notation/chords.itely b/Documentation/notation/chords.itely index 1109075d66..753d82bb3d 100644 --- a/Documentation/notation/chords.itely +++ b/Documentation/notation/chords.itely @@ -7,7 +7,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.14.0" +@c \version "2.16.0" @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 @@ -229,7 +227,6 @@ to create a major triad. @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 @@ -512,16 +506,15 @@ Rests passed to a @code{ChordNames} context will cause the @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} - @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. @@ -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 { + % add9 + \set additionalPitchPrefix = #"add" + % 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 @@ -673,23 +731,22 @@ The spacer is not used when the root is altered. @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} - @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}. @@ -975,26 +1027,10 @@ End of continuation line @snippets -@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +@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 @@ -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. @@ -1179,4 +1190,3 @@ begins the extender line and turn them off at the end of the extender line. } >> @end lilypond -