]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/instrument-notation.itely
Fix some bugs in the dynamic engraver and PostScript backend
[lilypond.git] / Documentation / user / instrument-notation.itely
index 1f6d223745a559e2075623831f6b54a631f26fcc..30f112dcc4c8fbfe6b6677f7fa28922e1dd6fc21 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 
-@c A menu is needed before every deeper *section nesting of @node's; run 
+@c A menu is needed before every deeper *section nesting of @node's; run
 @c     M-x texinfo-all-menus-update
 @c to automatically fill in these menus before saving changes
 
@@ -229,7 +229,7 @@ In this manual: @ref{Laissez vibrer ties}
 @cindex staff switching
 @cindex cross staff
 
-@cindex @code{followVoice}
+@findex followVoice
 
 Whenever a voice switches to another staff, a line connecting the notes
 can be printed automatically.  This is switched on by setting
@@ -253,9 +253,9 @@ Program reference: @internalsref{VoiceFollower}.
 
 @refcommands
 
-@cindex @code{\showStaffSwitch}
+@findex \showStaffSwitch
 @code{\showStaffSwitch},
-@cindex @code{\hideStaffSwitch}
+@findex \hideStaffSwitch
 @code{\hideStaffSwitch}.
 
 
@@ -413,11 +413,11 @@ Modifiers can be mixed with additions
 @end lilypond
 
 @cindex modifiers, in chords.
-@cindex @code{aug}
-@cindex @code{dim}
-@cindex @code{maj}
-@cindex @code{sus}
-@cindex @code{m}
+@findex aug
+@findex dim
+@findex maj
+@findex sus
+@findex m
 
 Since an unaltered 11 does not sound good when combined with an
 unaltered 3, the 11 is removed in this case (unless it is added
@@ -426,7 +426,7 @@ explicitly)
 \chordmode { c:13 c:13.11 c:m13 }
 @end lilypond
 
-@cindex @code{/}
+@findex /
 
 An inversion (putting one pitch of the chord on the bottom), as well
 as bass notes, can be specified by appending
@@ -434,7 +434,7 @@ as bass notes, can be specified by appending
 @lilypond[quote,ragged-right,fragment,verbatim]
 \chordmode { c1 c/g c/f }
 @end lilypond
-@cindex @code{/+}
+@findex /+
 
 A bass note can be added instead transposed out of the chord,
 by using @code{/+}@var{pitch}.
@@ -526,7 +526,7 @@ Klaus Ignatzek (see @ref{Literature list}).  It can be tuned through the
 following properties
 
 @table @code
-@cindex @code{chordNameExceptions}
+@findex chordNameExceptions
 @item chordNameExceptions
 This is a list that contains the chords that have special formatting.
 
@@ -555,14 +555,14 @@ For an example of tuning this property, see also
 @cindex exceptions, chord names.
 
 
-@cindex @code{majorSevenSymbol}
+@findex majorSevenSymbol
 @item majorSevenSymbol
 This property contains the markup object used for the 7th step, when
 it is major.  Predefined options are @code{whiteTriangleMarkup} and
 @code{blackTriangleMarkup}.  See
 @inputfileref{input/@/regression,chord@/-name@/-major7@/.ly} for an example.
 
-@cindex @code{chordNameSeparator}
+@findex chordNameSeparator
 @item chordNameSeparator
 Different parts of a chord name are normally separated by a
 slash.  By setting @code{chordNameSeparator}, you can specify other
@@ -576,31 +576,31 @@ separators, e.g.,
 }
 @end lilypond
 
-@cindex @code{chordRootNamer}
+@findex chordRootNamer
 @item chordRootNamer
 The root of a chord is usually printed as a letter with an optional
 alteration.  The transformation from pitch to letter is done by this
 function.  Special note names (for example, the German ``H'' for a
 B-chord) can be produced by storing a new function in this property.
 
-@cindex @code{chordNoteNamer}
+@findex chordNoteNamer
 @item chordNoteNamer
 The default is to print single pitch, e.g., the bass note, using the
 @code{chordRootNamer}.  The @code{chordNoteNamer} property can be set
 to a specialized function to change this behavior.  For example, the
 base can be printed in lower case.
 
-@cindex @code{chordPrefixSpacer}
+@findex chordPrefixSpacer
 @item chordPrefixSpacer
-The ``m'' for minor chords is usually printed right after the root of 
-the chord. By setting @code{chordPrefixSpacer}, you can fix a spacer 
+The ``m'' for minor chords is usually printed right after the root of
+the chord. By setting @code{chordPrefixSpacer}, you can fix a spacer
 between the root and ``m''. The spacer is not used when the root
 is altered.
 
 @end table
 
 The predefined variables @code{\germanChords},
-@code{\semiGermanChords}, @code{\italianChords} and @code{\frenchChords} 
+@code{\semiGermanChords}, @code{\italianChords} and @code{\frenchChords}
 set these variables.  The effect is
 demonstrated here,
 
@@ -619,13 +619,13 @@ chart}.  Turning on these styles is described in the input file
 
 @refcommands
 
-@cindex @code{\germanChords}
+@findex \germanChords
 @code{\germanChords},
-@cindex @code{\semiGermanChords}
+@findex \semiGermanChords
 @code{\semiGermanChords}.
-@cindex @code{\italianChords}
+@findex \italianChords
 @code{\italianChords}.
-@cindex @code{\frenchChords}
+@findex \frenchChords
 @code{\frenchChords}.
 
 
@@ -678,8 +678,7 @@ way is to use the @code{\addlyrics} function.
 * Melismata::                   
 * Another way of entering lyrics::  
 * Flexibility in placement::    
-* Switching the melody associated with a lyrics line::  
-* Specifying melismata within the lyrics::  
+* Spacing lyrics::              
 * More about stanzas::          
 * Ambitus::                     
 * Other vocal issues::          
@@ -688,10 +687,12 @@ way is to use the @code{\addlyrics} function.
 
 @commonprop
 
-Checking to make sure that text scripts and lyrics are within the margins is a relatively large computational task.  To speed up processing, lilypond does not perform such calculations by default; to enable it, use
+Checking to make sure that text scripts and lyrics are within the margins is
+a relatively large computational task.  To speed up processing, lilypond does
+not perform such calculations by default; to enable it, use
 
 @example
-\override Score.PaperColumn #'keep-inside-line = ##t 
+\override Score.PaperColumn #'keep-inside-line = ##t
 @end example
 
 To make lyrics avoid barlines as well, use
@@ -736,7 +737,8 @@ More stanzas can be added by adding more
 \addlyrics { joue le jeu }
 @end lilypond
 
-The command @code{\addlyrics} cannot handle polyphony settings.  For these cases you should use @code{\lyricsto} and @code{\lyricmode}.
+The command @code{\addlyrics} cannot handle polyphony settings.  For these
+cases you should use @code{\lyricsto} and @code{\lyricmode}.
 
 
 
@@ -744,7 +746,7 @@ The command @code{\addlyrics} cannot handle polyphony settings.  For these cases
 @subsection Entering lyrics
 
 @cindex lyrics
-@cindex @code{\lyricmode}
+@findex \lyricmode
 @cindex punctuation
 
 Lyrics are entered in a special input mode.  This mode is introduced
@@ -763,17 +765,20 @@ explicitly, like in the example above, or by automatically aligning
 the lyrics to a melody or other voice of music, using @code{\addlyrics}
 or @code{\lyricsto}.  For more details see @ref{The Lyrics context}.
 
-A word or syllable of lyrics begins with an alphabetic character, and ends with
+A word or syllable of lyrics begins with an alphabetic character, and ends
+with
 any space or digit.  The following characters can be any character
 that is not a digit or white space.  One important consequence of this
 is that a word can end with @code{@}}.  The following example is
-usually a mistake in the input file.  The syllable includes a @code{@}}, so the
+usually a mistake in the input file.  The syllable includes a @code{@}}, so
+the
 opening brace is not balanced
 @example
 \lyricmode @{ twinkle@}
 @end example
 
-@cindex @code{\property}, in @code{\lyricmode}
+@findex \property in \lyricmode
+
 @noindent
 Similarly, a period which follows an alphabetic sequence is included in
 the resulting string.  As a consequence, spaces must be inserted around
@@ -782,7 +787,7 @@ property commands
 \override Score . LyricText #'font-shape = #'italic
 @end example
 
-@cindex @code{_}
+@findex _
 @cindex spaces, in lyrics
 @cindex quotes, in lyrics
 
@@ -801,9 +806,10 @@ non-ascii characters (such as the heart symbol or slanted quotes),
 simply insert the characters directly into the input file and save
 it with utf-8 encoding.  See @ref{Text encoding} for more info.
 
-@example
-\lyricmode @{ He said: “Let my peo ple go”. @}
-@end example
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative { e4 f e d e f e2 }
+\addlyrics { He said: “Let my peo ple go”. }
+@end lilypond
 
 To use normal quotes in lyrics, add a backslash before the
 quotes.  For example,
@@ -823,6 +829,23 @@ any 8-bit character with ASCII code over 127, or a two-character
 combination of a backslash followed by one of @code{`}, @code{'},
 @code{"}, or @code{^}.
 
+To define indentifiers containing lyrics, the function @code{lyricmode}
+must be used.
+
+@example
+verseOne = \lyricmode @{ Joy to the world the Lord is come @}
+\score @{
+  <<
+    \new Voice = "one" \relative c'' @{
+      \autoBeamOff
+      \time 2/4
+      c4 b8. a16 g4. f8 e4 d c2
+    @}
+    \addlyrics @{ \verseOne @}
+  >>
+@}
+@end example
+
 
 @seealso
 
@@ -861,14 +884,15 @@ Program reference: @internalsref{LyricHyphen}, @internalsref{LyricExtender}.
 @node The Lyrics context
 @subsection The Lyrics context
 
-Lyrics are printed by interpreting them in the context caleld @internalsref{Lyrics}.
+Lyrics are printed by interpreting them in the context caleld
+@internalsref{Lyrics}.
 
 @example
 \new Lyrics \lyricmode @dots{}
 @end example
 
 @cindex automatic syllable durations
-@cindex @code{\lyricsto}
+@findex \lyricsto
 @cindex lyrics and melodies
 
 This will place the lyrics according to the durations that were
@@ -882,8 +906,8 @@ melody and the lyrics with the @code{\lyricsto} expression
 @end example
 
 This aligns the lyrics to the
-notes of the @internalsref{Voice} context called @var{name}, which has
-to exist.  Therefore, normally the @code{Voice} is specified first, and
+notes of the @internalsref{Voice} context called @var{name}, which must
+already exist.  Therefore normally the @code{Voice} is specified first, and
 then the lyrics are specified with @code{\lyricsto}.  The command
 @code{\lyricsto} switches to @code{\lyricmode} mode automatically, so the
 @code{\lyricmode} keyword may be omitted.
@@ -891,14 +915,14 @@ then the lyrics are specified with @code{\lyricsto}.  The command
 The following example uses different commands for entering lyrics.
 
 @lilypond[quote,fragment,ragged-right,verbatim]
-<< 
+<<
   \new Voice = "one" \relative c'' {
     \autoBeamOff
     \time 2/4
-    c4 b8. a16 g4. f8 e4 d c2 
+    c4 b8. a16 g4. f8 e4 d c2
   }
   \new Lyrics \lyricmode { Joy4 to8. the16 world!4. the8 Lord4 is come.2 }
-  \new Lyrics \lyricmode { Joy to the earth! the Sav -- our reigns. }
+  \new Lyrics \lyricmode { Joy to the earth! the Sa -- viour reigns. }
   \new Lyrics \lyricsto "one" { No more let sins and sor -- rows grow. }
 >>
 @end lilypond
@@ -906,26 +930,9 @@ The following example uses different commands for entering lyrics.
 The second stanza is not properly aligned because the durations
 were not specified.  A solution for that would be to use @code{\lyricsto}.
 
-To define indentifiers containing lyrics, the function @code{lyricsmode}
-must be used.
-
-@example
-verseOne = \lyricmode @{ Joy to the world the Lord is come @}
-\score @{
-  << 
-    \new Voice = "one" \relative c'' @{
-      \autoBeamOff
-      \time 2/4
-      c4 b8. a16 g4. f8 e4 d c2 
-    @}
-    \addlyrics @{ \verseOne @}
-  >>
-@}
-@end example
-
-The @code{\addlyrics} command is actually just a convienient way
+The @code{\addlyrics} command is actually just a convenient way
 to write a more complicated LilyPond structure that sets up the
-lyrics. 
+lyrics.
 
 @example
 @{ MUSIC @}
@@ -1014,8 +1021,8 @@ A complete example of a SATB score setup is in section
 @refcommands
 
 @code{\melisma}, @code{\melismaEnd}
-@cindex @code{\melismaEnd}
-@cindex @code{\melisma}
+@findex \melismaEnd
+@findex \melisma
 
 @seealso
 
@@ -1078,10 +1085,14 @@ differing ways.  Such variations can still be captured with
 
 @menu
 * Lyrics to multiple notes of a melisma::  
+* Divisi lyrics::               
+* Switching the melody associated with a lyrics line::  
+* Specifying melismata within the lyrics::  
+* Lyrics independent of notes::  
 @end menu
 
 @node Lyrics to multiple notes of a melisma
-@subsubsection Lyrics to multiple notes of a melisma 
+@subsubsection Lyrics to multiple notes of a melisma
 
 
 One possibility is that the text has a melisma in one stanza, but
@@ -1132,8 +1143,54 @@ For example,
 @end lilypond
 
 
+@node Divisi lyrics
+@subsubsection Divisi lyrics
+
+You can display alternate (or divisi) lyrics by naming voice
+contexts and attaching lyrics to those specific contexts.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" {
+    \relative c' {
+      c4
+      <<
+        { \voiceOne c8 e }
+        \new Voice = "splitpart" { \voiceTwo c4 }
+      >>
+      \oneVoice c4 c | c
+    }
+  }
+  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
+  \new Lyrics \lyricsto "splitpart" { will }
+>> }
+@end lilypond
+
+
+You can use this trick to display different lyrics for a repeated
+section.
+
+@lilypond[verbatim,ragged-right,quote]
+\score{ <<
+  \new Voice = "melody" \relative c' {
+    c2 e | g e | c1 |
+    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
+    a2 b | c1}
+  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
+    do mi sol mi do
+    la si do }
+  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
+   do re mi fa sol }
+  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
+   dodo rere mimi fafa solsol }
+>>
+}
+@end lilypond
+
+
+
 @node Switching the melody associated with a lyrics line
-@subsection Switching the melody associated with a lyrics line
+@subsubsection Switching the melody associated with a lyrics line
 
 More complex variations in text underlay are possible.  It is possible
 to switch the melody for a line of lyrics during the text.  This is
@@ -1216,13 +1273,13 @@ The underlay is switched back to the starting situation by assigning
 
 
 @node Specifying melismata within the lyrics
-@subsection Specifying melismata within the lyrics
+@subsubsection Specifying melismata within the lyrics
 
 It is also possible to define melismata entirely in the lyrics. This
 can be done by entering @code{_} for every note that is part of the
-melisma. 
+melisma.
 
-@lilypond[relative=1,verbatim,fragment] 
+@lilypond[relative=1,verbatim,fragment]
 { \set melismaBusyProperties = #'()
   c d( e) f f( e) e e  }
 \addlyrics
@@ -1232,7 +1289,7 @@ melisma.
 In this case, you can also have ties and slurs in the melody, if you
 set @code{melismaBusyProperties}, as is done in the example above.
 
-@lilypond[relative=1,verbatim,fragment]
+@lilypond[relative=1,verbatim,fragment,quote]
 {
  \set melismaBusyProperties = #'()
   c d( e) f f( e) e e
@@ -1241,12 +1298,38 @@ set @code{melismaBusyProperties}, as is done in the example above.
  { Ky -- _ _ ri __ _ _ _  e }
 @end lilypond
 
-@menu
-* Spacing lyrics::              
-@end menu
+
+@node Lyrics independent of notes
+@subsubsection Lyrics independent of notes
+
+In some complex vocal music, it may be desirable to place
+lyrics completely independently of notes.  Music defined
+inside @code{lyricrhythm} disappears into the
+@code{Devnull} context, but the rhythms can still be used
+to place the lyrics.
+
+@lilypond[quote,verbatim,ragged-right]
+voice = {
+  c''2
+  \tag #'music { c''2 }
+  \tag #'lyricrhythm { c''4. c''8 }
+  d''1
+}
+
+lyr = \lyricmode { I like my cat! }
+
+<<
+  \new Staff \keepWithTag #'music \voice
+  \new Devnull="nowhere" \keepWithTag #'lyricrhythm \voice
+  \new Lyrics \lyricsto "nowhere" \lyr
+  \new Staff { c'8 c' c' c' c' c' c' c'
+  c' c' c' c' c' c' c' c' }
+>>
+@end lilypond
+
 
 @node Spacing lyrics
-@subsubsection Spacing lyrics
+@subsection Spacing lyrics
 
 @cindex Spacing lyrics
 @cindex Lyrics, increasing space between
@@ -1255,7 +1338,7 @@ To increase the spacing between lyrics, set the minimum-distance property of
 LyricSpace.
 
 @lilypond[relative,verbatim,fragment,quote,ragged-right]
-{ 
+{
   c c c c
   \override Lyrics.LyricSpace #'minimum-distance = #1.0
   c c c c
@@ -1266,7 +1349,8 @@ LyricSpace.
 }
 @end lilypond
 
-To make this change for all lyrics in the score, set the property in the layout.
+To make this change for all lyrics in the score, set the property in the
+layout.
 
 @lilypond[relative,verbatim,quote,ragged-right]
 \score {
@@ -1375,51 +1459,11 @@ the line, just like instrument names.  They are created by setting
 }
 @end lilypond
 
-You can display alternate (or divisi) lyrics by naming voice
-contexts and attaching lyrics to those specific contexts.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" {
-    \relative c' {
-      c4
-      <<
-        { \voiceOne c8 e }
-        \new Voice = "splitpart" { \voiceTwo c4 }
-      >>
-      \oneVoice c4 c | c
-    }
-  }
-  \new Lyrics \lyricsto "melody" { we shall not o- ver- come }
-  \new Lyrics \lyricsto "splitpart" { will }
->> }
-@end lilypond
-
-
-You can use this trick to display different lyrics for a repeated
-section.
-
-@lilypond[verbatim,ragged-right,quote]
-\score{ <<
-  \new Voice = "melody" \relative c' {
-    c2 e | g e | c1 |
-    \new Voice = "verse" \repeat volta 2 {c4 d e f | g1 | }
-    a2 b | c1}
-  \new Lyrics = "mainlyrics" \lyricsto melody \lyricmode {
-    do mi sol mi do
-    la si do }
-  \context Lyrics = "mainlyrics" \lyricsto verse \lyricmode {
-   do re mi fa sol }
-  \new Lyrics = "repeatlyrics" \lyricsto verse \lyricmode {
-   dodo rere mimi fafa solsol }
->>
-}
-@end lilypond
-
 
 @seealso
 
-Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber}, @internalsref{VocalName}.
+Program reference: @internalsref{LyricText}, @internalsref{StanzaNumber},
+@internalsref{VocalName}.
 
 
 
@@ -1545,6 +1589,7 @@ also be used to show the rhythms of melodies.
 * Showing melody rhythms::      
 * Entering percussion::         
 * Percussion staves::           
+* Ghost notes::                 
 @end menu
 
 
@@ -1618,7 +1663,7 @@ down = \drummode { bassdrum4 snare8 bd r bd sn4 }
 @end lilypond
 
 The above example shows verbose polyphonic notation.  The short
-polyphonic notation, described in @ref{Polyphony}, can also be used if
+polyphonic notation, described in @ref{Basic polyphony}, can also be used if
 the @internalsref{DrumVoice}s are instantiated by hand first.  For example,
 
 @lilypond[quote,ragged-right,fragment,verbatim]
@@ -1811,6 +1856,42 @@ Because general MIDI does not contain rim shots, the sidestick is used
 for this purpose instead.
 
 
+@c FIXME: check name -gp
+@node Ghost notes
+@subsection Ghost notes
+
+Ghost notes for drums and percussion may be created using the
+@code{\parenthesize} command detailed in @ref{Parentheses}.  However,
+the default @code{\drummode} does
+not include the @code{Parenthesis_engraver} plugin which allows
+this.  You
+must add the plugin explicitly in the context definition as
+detailed in @ref{Changing context properties on the fly}.
+
+@lilypond[quote,ragged-right,verbatim,fragment]
+\new DrumStaff \with {
+  \consists "Parenthesis_engraver"
+} <<
+  \context DrumVoice  = "1"  { s1 *2 }
+  \context DrumVoice  = "2" { s1 *2 }
+  \drummode {
+    <<
+      {
+        hh8[ hh] <hh sn> hh16
+        < \parenthesize sn > hh < \parenthesize
+        sn > hh8 <hh sn> hh
+      } \\ {
+        bd4 r4 bd8 bd r8 bd
+      }
+    >>
+  }
+>>
+@end lilypond
+
+@noindent
+Also note that you must add chords (@code{< >} brackets)
+around each @code{\parenthesize} statement.
+
 
 @node Guitar
 @section Guitar
@@ -1833,7 +1914,7 @@ for this purpose instead.
 @cindex String numbers
 
 String numbers can be added to chords, by indicating the string number
-with @code{\}@var{number}, 
+with @code{\}@var{number},
 
 @lilypond[relative,relative=1,ragged-right,fragment]
 <c\1 e\2 g\3>
@@ -1870,7 +1951,7 @@ are printed as tablature, by using @internalsref{TabStaff} and
 }
 @end lilypond
 
-@cindex @code{minimumFret}
+@findex minimumFret
 @cindex fret
 
 When no string is specified, the first string that does not give a
@@ -1949,13 +2030,15 @@ and bass guitar.
 \set TabStaff.stringTunings = #bass-tuning
 @end example
 
-The default string tuning is @code{guitar-tuning} (the standard EADGBE tuning).
+The default string tuning is @code{guitar-tuning} (the standard EADGBE
+tuning).
 Some other predefined tunings are @code{guitar-open-g-tuning},
 @code{mandolin-tuning} and @code{banjo-open-g-tuning}.
 
 @seealso
 
-The file @file{scm/@/output@/-lib@/.scm} contains the predefined string tunings.
+The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
+tunings.
 Program reference: @internalsref{Tab_note_heads_engraver}.
 
 @refbugs
@@ -1969,7 +2052,8 @@ No guitar special effects have been implemented.
 @cindex Banjo tablatures
 
 LilyPond has basic support for five stringed banjo.  When making tablatures
-for five stringed banjo, use the banjo tablature format function to get correct
+for five stringed banjo, use the banjo tablature format function to get
+correct
 fret numbers for the fifth string:
 
 @lilypond[quote,ragged-right,fragment,verbatim]
@@ -2068,9 +2152,9 @@ e16 b16 g16 d16
 @end lilypond
 
 
-Stopped (X) note heads are used in guitar music to signal a place where the 
-guitarist must play a certain note or chord, with its fingers just 
-touching the strings instead of fully pressing them.  This gives the sound a 
+Stopped (X) note heads are used in guitar music to signal a place where the
+guitarist must play a certain note or chord, with its fingers just
+touching the strings instead of fully pressing them.  This gives the sound a
 percussive noise-like sound that still maintains part of the original
 pitch.  It is notated with cross noteheads; this is
 demonstrated in @ref{Special noteheads}.
@@ -2115,16 +2199,16 @@ notes in the appropiate octaves, so you do not need to worry about
 { \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
 @end lilypond
 
-Bagpipe music nominally uses the key of D Major (even though that 
-isn't really true). However, since that is the only key that can be used, 
-the key signature is normally not written out. To set this up correctly, 
-always start your music with @code{\hideKeySignature}. If you for some 
+Bagpipe music nominally uses the key of D Major (even though that
+isn't really true). However, since that is the only key that can be used,
+the key signature is normally not written out. To set this up correctly,
+always start your music with @code{\hideKeySignature}. If you for some
 reason want to show the key signature, you can use @code{\showKeySignature}
 instead.
 
 Some modern music use cross fingering on c and f to flatten those notes.
 This can be indicated by @code{cflat} or @code{fflat}. Similarly, the
-piobaireachd high g can be written @code{gflat} when it occurs in light 
+piobaireachd high g can be written @code{gflat} when it occurs in light
 music.
 
 
@@ -2150,7 +2234,7 @@ notation.
 {
   \hideKeySignature
   \time 3/4
-  \grg \partial 4 a8. d16 
+  \grg \partial 4 a8. d16
   \slurd d2 \grg f8[ e32 d16.]
   \grg f2 \grg f8 e
   \thrwd d2 \grg b4
@@ -2417,7 +2501,8 @@ There are no rests in Gregorian Chant notation; instead, it uses
 
 @seealso
 
-In this manual: @ref{Rests} gives a general introduction into the use of rests.
+In this manual: @ref{Rests} gives a general introduction into the use of
+rests.
 
 
 @node Ancient clefs
@@ -2722,25 +2807,35 @@ following table
 {
   \set Score.timing = ##f
   \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph #"timesig.neomensural44" }
+  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural44" }
   s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph #"timesig.neomensural22" }
+  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural22" }
   s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph #"timesig.neomensural64" }
+  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural64" }
   s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph #"timesig.neomensural68" }
+  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural68" }
   \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph #"timesig.neomensural32" }
+  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+#"timesig.neomensural32" }
   s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph #"timesig.neomensural34" }
+  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural34" }
   s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph #"timesig.neomensural94" }
+  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural94" }
   s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph #"timesig.neomensural98" }
+  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural98" }
   \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph #"timesig.neomensural48" }
+  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+#"timesig.neomensural48" }
   s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph #"timesig.neomensural24" }
+  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+#"timesig.neomensural24" }
 }
 @end lilypond
 
@@ -2941,17 +3036,17 @@ Therefore, @file{gregorian@/-init@/.ly} also defines @code{\virgula} and
 
 @refcommands
 
-@cindex @code{\virgula}
+@findex \virgula
 @code{\virgula},
-@cindex @code{\caesura}
+@findex \caesura
 @code{\caesura},
-@cindex @code{\divisioMinima}
+@findex \divisioMinima
 @code{\divisioMinima},
-@cindex @code{\divisioMaior}
+@findex \divisioMaior
 @code{\divisioMaior},
-@cindex @code{\divisioMaxima}
+@findex \divisioMaxima
 @code{\divisioMaxima},
-@cindex @code{\finalis}
+@findex \finalis
 @code{\finalis}.
 
 @seealso
@@ -4011,35 +4106,35 @@ ligatures can be created.
 
 The following head prefixes are supported
 
-@cindex @code{\virga}
+@findex \virga
 @code{\virga},
-@cindex @code{\stropha}
+@findex \stropha
 @code{\stropha},
-@cindex @code{\inclinatum}
+@findex \inclinatum
 @code{\inclinatum},
-@cindex @code{\auctum}
+@findex \auctum
 @code{\auctum},
-@cindex @code{\descendens}
+@findex \descendens
 @code{\descendens},
-@cindex @code{\ascendens}
+@findex \ascendens
 @code{\ascendens},
-@cindex @code{\oriscus}
+@findex \oriscus
 @code{\oriscus},
-@cindex @code{\quilisma}
+@findex \quilisma
 @code{\quilisma},
-@cindex @code{\deminutum}
+@findex \deminutum
 @code{\deminutum},
-@cindex @code{\cavum}
+@findex \cavum
 @code{\cavum},
-@cindex @code{\linea}
+@findex \linea
 @code{\linea}.
 
 Head prefixes can be accumulated, though restrictions apply.  For
 example, either @code{\descendens} or @code{\ascendens} can be applied
 to a head, but not both to the same head.
 
-@cindex @code{\pes}
-@cindex @code{\flexa}
+@findex \pes
+@findex \flexa
 Two adjacent heads can be tied together with the @code{\pes} and
 @code{\flexa} infix commands for a rising and falling line of melody,
 respectively.
@@ -4124,18 +4219,19 @@ to chromatically alter notes at their own initiative. This is called
 ``Musica Ficta''. In modern transcriptions, these accidentals are
 usually printed over the note.
 
+@cindex Accidental, musica ficta
 @cindex Musica ficta
 
 Support for such suggested accidentals is included, and can be
 switched on by setting @code{suggestAccidentals} to true.
 
-@cindex @code{suggestAccidentals}
+@findex suggestAccidentals
 
 @lilypond[verbatim,fragment,relative=1]
 fis gis
 \set suggestAccidentals = ##t
 ais bis
-@end lilypond 
+@end lilypond
 
 @seealso
 
@@ -4211,7 +4307,7 @@ It is also possible to use continuation lines for repeated figures,
     c4 c c
   }
   \figures {
-    \set useBassFigureExtenders = ##t 
+    \set useBassFigureExtenders = ##t
     <4 6> <3 6> <3 7>
   }
 >>
@@ -4219,7 +4315,7 @@ It is also possible to use continuation lines for repeated figures,
 
 @noindent
 In this case, the extender lines always replace existing figures.
+
 The @code{FiguredBass} context doesn't pay attention to the actual
 bass line. As a consequence, you may have to insert extra figures to
 get extender lines below all notes, and you may have to add @code{\!}
@@ -4227,9 +4323,9 @@ to avoid getting an extender line, e.g.
 
 @lilypond[relative=1]
 <<
-  \new Voice 
+  \new Voice
   \figures {
-    \set useBassFigureExtenders = ##t 
+    \set useBassFigureExtenders = ##t
     <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
   }
   {
@@ -4242,20 +4338,21 @@ to avoid getting an extender line, e.g.
 When using continuation lines, common figures are always put in the
 same vertical position. When this is unwanted, you can insert a rest
 with @code{r}. The rest will clear any previous alignment.  For
-example, you can write 
+example, you can write
 
 @example
   <4 6>8 r8
 @end example
 
 @noindent
-instead of 
+instead of
 @example
   <4 6>4
 @end example
 
 Accidentals and plus signs can appear before or after the numbers,
-depending on the @code{figuredBassAlterationDirection} and @code{figuredBassPlusDirection}
+depending on the @code{figuredBassAlterationDirection} and
+@code{figuredBassPlusDirection}
 properties
 
 @lilypond