update framework for command index. DOC WRITERS: use @funindex
instead of @cindex @code{}.
+ * Documentation/user/ various: replace @cindex @code{} => @funindex
+
2006-05-19 Han-Wen Nienhuys <hanwen@lilypond.org>
* lily/beam.cc (set_stem_lengths): trigger 'beaming callback, in
@refcommands
-@cindex @code{\fatText}
+@funindex \fatText
@code{\fatText},
-@cindex @code{\emptyText}
+@funindex \emptyText
@code{\emptyText}.
@cindex segno on bar line
@cindex fermata on bar line
@cindex bar lines, symbols on
-@cindex @code{\mark}
+@funindex \mark
The @code{\mark} command is primarily used for
@ref{Rehearsal marks},
@cindex font selection
@cindex font magnification
-@cindex @code{font-interface}
+@funindex font-interface
By setting the object properties described below, you can select a
font from the preconfigured font families. LilyPond has default
@cindex Rests, multi measure
@cindex Rests, full measure
@cindex whole rests for a full measure
-@cindex @code{R}
+@funindex R
Rests for one full measure (or many bars) are entered using `@code{R}'. It
is specifically meant for full bar rests and for entering parts: the rest
In the MIDI output, they are interpreted as a tempo change. In the
layout output, a metronome marking is printed
-@cindex @code{\tempo}
+@funindex \tempo
@lilypond[quote,ragged-right,verbatim,fragment]
\tempo 8.=120 c''1
@end lilypond
@subsection Rehearsal marks
@cindex Rehearsal marks
-@cindex @code{\mark}
+@funindex \mark
To print a rehearsal mark, use the @code{\mark} command
@cindex Bar numbers
@cindex measure numbers
-@cindex @code{currentBarNumber}
+@funindex currentBarNumber
Bar numbers are printed by default at the start of the line. The
number itself is stored in the @code{currentBarNumber} property, which
@node Different editions from one source
@subsection Different editions from one source
-@cindex @code{\tag}
+@funindex \tag
@cindex tag
The @code{\tag} command marks music expressions with a name. These
@cindex Invisible notes
@cindex Transparent notes
-@cindex @code{\hideNotes}
-@cindex @code{\unHideNotes}
+@funindex \hideNotes
+@funindex \unHideNotes
Hidden (or invisible or transparent) notes can be useful in preparing theory
or composition exercises.
@refcommands
-@cindex @code{\setEasyHeads}
+@funindex \setEasyHeads
@code{\setEasyHeads}
c1
@end lilypond
-@cindex @code{'}
-@cindex @code{,}
+@funindex '
+@funindex ,
The optional octave specification takes the form of a series of
single quote (`@code{'}') characters or a series of comma
@cindex accidental, cautionary
@cindex accidental, parenthesized
@cindex reminder accidental
-@cindex @code{?}
+@funindex ?
@cindex cautionary accidental
@cindex parenthesized accidental
-@cindex @code{!}
+@funindex !
Normally accidentals are printed automatically, but you may also
print them manually. A reminder accidental
@cindex Rests
-@cindex @code{\rest}
-@cindex @code{r}
+@funindex \rest
+@funindex r
Rests are entered like notes with the note name @code{r}
@cindex Skip
@cindex Invisible rest
@cindex Space note
-@cindex @code{\skip}
-@cindex @code{s}
+@funindex \skip
+@funindex s
An invisible rest (also called a `skip') can be entered like a note
with note name `@code{s}' or with @code{\skip @var{duration}}
@subsection Durations
@cindex duration
-@cindex @code{\longa}
-@cindex @code{\breve}
-@cindex @code{\maxima}
+@funindex \longa
+@funindex \breve
+@funindex \maxima
In Note, Chord, and Lyrics mode, durations are designated by numbers and
dots: durations are entered as their reciprocal values. For example, a
@node Augmentation dots
@subsection Augmentation dots
-@cindex @code{.}
+@funindex .
To obtain dotted note lengths, simply add a dot (`@code{.}') to
the number. Double-dotted notes are produced in a similar way.
situations. The following commands may be used to force a particular
direction manually
-@cindex @code{\dotsUp}
+@funindex \dotsUp
@code{\dotsUp},
-@cindex @code{\dotsDown}
+@funindex \dotsDown
@code{\dotsDown},
-@cindex @code{\dotsNeutral}
+@funindex \dotsNeutral
@code{\dotsNeutral}.
@seealso
@cindex tuplets
@cindex triplets
-@cindex @code{\times}
+@funindex \times
Tuplets are made out of a music expression by multiplying all durations
with a fraction
@refcommands
-@cindex @code{\tupletUp}
+@funindex \tupletUp
@code{\tupletUp},
-@cindex @code{\tupletDown}
+@funindex \tupletDown
@code{\tupletDown},
-@cindex @code{\tupletNeutral}
+@funindex \tupletNeutral
@code{\tupletNeutral}.
@commonprop
-@cindex @code{tupletNumberFormatFunction}
+@funindex tupletNumberFormatFunction
@cindex tuplet formatting
The property @code{tupletSpannerDuration} specifies how long each
@refcommands
-@cindex @code{\stemUp}
+@funindex \stemUp
@code{\stemUp},
-@cindex @code{\stemDown}
+@funindex \stemDown
@code{\stemDown},
-@cindex @code{\stemNeutral}
+@funindex \stemNeutral
@code{\stemNeutral}.
@cindex Relative
@cindex Relative octave specification
-@cindex @code{\relative}
+@funindex \relative
Octaves are specified by adding @code{'} and @code{,} to pitch names.
When you copy existing music, it is easy to accidentally put a pitch
@cindex Transpose
@cindex transposition of pitches
-@cindex @code{\transpose}
+@funindex \transpose
A music expression can be transposed with @code{\transpose}. The
syntax is
@subsection Bar check
@cindex Bar check
-@cindex @code{barCheckSynchronize}
-@cindex @code{|}
+@funindex barCheckSynchronize
+@funindex |
Bar checks help detect errors in the durations. A bar check is
entered using the bar symbol, `@code{|}'. Whenever it is encountered
especially if the score is polyphonic, so a good place to start correcting
input is by scanning for failed bar checks and incorrect durations.
-@cindex @code{|}
-@cindex @code{pipeSymbol}
+@funindex |
+@funindex pipeSymbol
It is also possible to redefine the meaning of @code{|}. This is done
by assigning a music expression to @code{pipeSymbol},
@subsection Skipping corrected music
-@cindex @code{skipTypesetting}
-@cindex @code{showLastLength}
+@funindex skipTypesetting
+@funindex showLastLength
When entering or copying music, usually only the music near the end (where
you
@node Clef
@subsection Clef
-@cindex @code{\clef}
+@funindex \clef
The clef indicates which lines of the staff correspond to which
pitches. The clef is set with the @code{\clef} command
@subsection Key signature
@cindex Key signature
-@cindex @code{\key}
+@funindex \key
The key signature indicates the tonality in which a piece is played. It
is denoted by a set of alterations (flats or sharps) at the start of the
@code{\key} @var{pitch} @var{type}
@end example
-@cindex @code{\minor}
-@cindex @code{\major}
-@cindex @code{\minor}
-@cindex @code{\ionian}
-@cindex @code{\locrian}
-@cindex @code{\aeolian}
-@cindex @code{\mixolydian}
-@cindex @code{\lydian}
-@cindex @code{\phrygian}
-@cindex @code{\dorian}
+@funindex \minor
+@funindex \major
+@funindex \minor
+@funindex \ionian
+@funindex \locrian
+@funindex \aeolian
+@funindex \mixolydian
+@funindex \lydian
+@funindex \phrygian
+@funindex \dorian
@cindex church modes
Here, @var{type} should be @code{\major} or @code{\minor} to get
@cindex Time signature
@cindex meter
-@cindex @code{\time}
+@funindex \time
Time signature indicates the metrum of a piece: a regular pattern of
strong and weak beats. It is denoted by a fraction at the start of the
@cindex partial measure
@cindex measure, partial
@cindex shorten measures
-@cindex @code{\partial}
+@funindex \partial
Partial measures, such as an anacrusis or upbeat, are entered using the
@subsection Bar lines
@cindex Bar lines
-@cindex @code{\bar}
+@funindex \bar
@cindex measure lines
@cindex repeat bars
@commonprop
-@cindex @code{whichBar}
-@cindex @code{repeatCommands}
-@cindex @code{defaultBarType}
+@funindex whichBar
+@funindex repeatCommands
+@funindex defaultBarType
The command @code{\bar }@var{bartype} is a short cut for doing
@code{\set Timing.whichBar = }@var{bartype}. Whenever @code{whichBar}
@subsection Unmetered music
@cindex cadenza
-@cindex @code{\cadenzaOn}
-@cindex @code{\cadenzaOff}
+@funindex \cadenzaOn
+@funindex \cadenzaOff
Bar lines and bar numbers are calculated automatically. For unmetered
music (cadenzas, for example), this is not desirable. To turn off
@subsection Ties
@cindex tie
-@cindex @code{~}
+@funindex ~
A tie connects two adjacent note heads of the same pitch. The tie in
effect extends the length of a note. Ties should not be confused with
@refcommands
-@cindex @code{\tieUp}
+@funindex \tieUp
@code{\tieUp},
-@cindex @code{\tieDown}
+@funindex \tieDown
@code{\tieDown},
-@cindex @code{\tieNeutral}
+@funindex \tieNeutral
@code{\tieNeutral},
-@cindex @code{\tieDotted}
+@funindex \tieDotted
@code{\tieDotted},
-@cindex @code{\tieDashed}
+@funindex \tieDashed
@code{\tieDashed},
-@cindex @code{\tieSolid}
+@funindex \tieSolid
@code{\tieSolid}.
@refcommands
-@cindex @code{\slurUp}
+@funindex \slurUp
@code{\slurUp},
-@cindex @code{\slurDown}
+@funindex \slurDown
@code{\slurDown},
-@cindex @code{\slurNeutral}
+@funindex \slurNeutral
@code{\slurNeutral},
-@cindex @code{\slurDashed}
+@funindex \slurDashed
@code{\slurDashed},
-@cindex @code{\slurDotted}
+@funindex \slurDotted
@code{\slurDotted},
-@cindex @code{\slurSolid}
+@funindex \slurSolid
@code{\slurSolid}.
@seealso
@refcommands
-@cindex @code{\phrasingSlurUp}
+@funindex \phrasingSlurUp
@code{\phrasingSlurUp},
-@cindex @code{\phrasingSlurDown}
+@funindex \phrasingSlurDown
@code{\phrasingSlurDown},
-@cindex @code{\phrasingSlurNeutral}
+@funindex \phrasingSlurNeutral
@code{\phrasingSlurNeutral}.
@subsection Manual beams
@cindex beams, manual
-@cindex @code{]}
-@cindex @code{[}
+@funindex ]
+@funindex [
In some cases it may be necessary to override the automatic beaming
algorithm. For example, the autobeamer will not put beams over rests
@commonprop
-@cindex @code{stemLeftBeamCount}
-@cindex @code{stemRightBeamCount}
+@funindex stemLeftBeamCount
+@funindex stemRightBeamCount
Normally, beaming patterns within a beam are determined automatically.
If necessary, the properties @code{stemLeftBeamCount} and
\set Score.beatLength = #(ly:make-moment 1 8)
c16[ c c c c c c c]
@end lilypond
-@cindex @code{subdivideBeams}
+@funindex subdivideBeams
@noindent
For more information about @code{make-moment}, see
Line breaks are normally forbidden when beams cross bar lines. This
behavior can be changed by setting @code{allowBeamBreak}.
-@cindex @code{allowBeamBreak}
+@funindex allowBeamBreak
@cindex beams and line breaks
@cindex beams, kneed
@cindex kneed beams
@node Grace notes
@subsection Grace notes
-@cindex @code{\grace}
+@funindex \grace
@cindex ornaments
@cindex grace notes
@cindex appoggiatura
\new Staff { c4 \grace { g8[ b] } c4 } >>
@end lilypond
-@cindex @code{\afterGrace}
+@funindex \afterGrace
If you want to end a note with a grace, use the @code{\afterGrace}
command. It takes two arguments: the main note, and the grace notes
@subsection Dynamics
@cindex Dynamics
-@cindex @code{\pppp}
-@cindex @code{\ppp}
-@cindex @code{\pp}
-@cindex @code{\p}
-@cindex @code{\mp}
-@cindex @code{\mf}
-@cindex @code{\f}
-@cindex @code{\ff}
-@cindex @code{\fff}
-@cindex @code{\ffff}
-@cindex @code{\fp}
-@cindex @code{\sf}
-@cindex @code{\sff}
-@cindex @code{\sp}
-@cindex @code{\spp}
-@cindex @code{\sfz}
-@cindex @code{\rfz}
+@funindex \pppp
+@funindex \ppp
+@funindex \pp
+@funindex \p
+@funindex \mp
+@funindex \mf
+@funindex \f
+@funindex \ff
+@funindex \fff
+@funindex \ffff
+@funindex \fp
+@funindex \sf
+@funindex \sff
+@funindex \sp
+@funindex \spp
+@funindex \sfz
+@funindex \rfz
Absolute dynamic marks are specified using a command after a note
@code{c4\ff}. The available dynamic marks are @code{\ppppp},
c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
@end lilypond
-@cindex @code{\<}
-@cindex @code{\>}
-@cindex @code{\!}
+@funindex \<
+@funindex \>
+@funindex \!
A crescendo mark is started with @code{\<} and terminated with
@code{\!} or an absolute dynamic. A decrescendo is started with
@refcommands
-@cindex @code{\dynamicUp}
+@funindex \dynamicUp
@code{\dynamicUp},
-@cindex @code{\dynamicDown}
+@funindex \dynamicDown
@code{\dynamicDown},
-@cindex @code{\dynamicNeutral}
+@funindex \dynamicNeutral
@code{\dynamicNeutral}.
@refcommands
@code{\startTrillSpan},
-@cindex @code{\startTrillSpan}
+@funindex \startTrillSpan
@code{\stopTrillSpan}.
-@cindex @code{\stopTrillSpan}
+@funindex \stopTrillSpan
@seealso
@subsection Glissando
@cindex Glissando
-@cindex @code{\glissando}
+@funindex \glissando
A glissando is a smooth change in pitch. It is denoted by a line or a
wavy line between two notes. It is requested by attaching
@cindex Arpeggio
@cindex broken chord
-@cindex @code{\arpeggio}
+@funindex \arpeggio
You can specify an arpeggio sign (also known as broken chord) on a
chord by attaching an @code{\arpeggio} to a chord
@refcommands
@code{\arpeggio},
-@cindex @code{\arpeggioUp}
+@funindex \arpeggioUp
@code{\arpeggioUp},
-@cindex @code{\arpeggioDown}
+@funindex \arpeggioDown
@code{\arpeggioDown},
-@cindex @code{\arpeggioNeutral}
+@funindex \arpeggioNeutral
@code{\arpeggioNeutral},
-@cindex @code{\arpeggioBracket}
+@funindex \arpeggioBracket
@code{\arpeggioBracket}.
is to enter each voice as a sequence (with @code{@{...@}}), and combine
them simultaneously, separating the voices with @code{\\}
-@cindex @code{\\}
+@funindex \\
@lilypond[quote,verbatim,fragment]
\new Staff \relative c' {
@refcommands
-@cindex @code{\oneVoice}
+@funindex \oneVoice
@code{\oneVoice},
-@cindex @code{\voiceOne}
+@funindex \voiceOne
@code{\voiceOne},
-@cindex @code{\voiceTwo}
+@funindex \voiceTwo
@code{\voiceTwo},
-@cindex @code{\voiceThree}
+@funindex \voiceThree
@code{\voiceThree},
-@cindex @code{\voiceFour}
+@funindex \voiceFour
@code{\voiceFour}.
-@cindex @code{\shiftOn}
+@funindex \shiftOn
@code{\shiftOn},
-@cindex @code{\shiftOnn}
+@funindex \shiftOnn
@code{\shiftOnn},
-@cindex @code{\shiftOnnn}
+@funindex \shiftOnnn
@code{\shiftOnnn},
-@cindex @code{\shiftOff}
+@funindex \shiftOff
@code{\shiftOff}: these commands specify in what chords of the current
voice should be shifted. The outer voices (normally: voice one and
two) have @code{\shiftOff}, while the inner voices (three and four)
@subsection Repeat types
@cindex repeats
-@cindex @code{\repeat}
+@funindex \repeat
The following types of repetition are supported
@end example
If you have alternative endings, you may add
-@cindex @code{\alternative}
+@funindex \alternative
@example
\alternative @{
@var{alternative1}
@subsection Repeats and MIDI
@cindex expanding repeats
-@cindex @code{\unfoldRepeats}
+@funindex \unfoldRepeats
With a little bit of tweaking, all types of repeats can be present
in the MIDI output. This is achieved by applying the
@node Manual repeat commands
@subsection Manual repeat commands
-@cindex @code{repeatCommands}
+@funindex repeatCommands
The property @code{repeatCommands} can be used to control the layout of
repeats. Its value is a Scheme list of repeat commands.
@subsection Tremolo subdivisions
@cindex tremolo marks
-@cindex @code{tremoloFlags}
+@funindex tremoloFlags
Tremolo marks can be printed on a single note by adding
`@code{:}[@var{number}]' after the note. The number indicates the
Common rules for typesetting accidentals have been placed in a
function. This function is called as follows
-@cindex @code{set-accidental-style}
+@funindex set-accidental-style
@example
#(set-accidental-style 'STYLE #('CONTEXT#))
@end example
should be used instead.
@item modern
-@cindex @code{modern} style accidentals
+@funindex modern style accidentals
This rule corresponds to the common practice in the 20th century. This rule
prints the same accidentals as @code{default}, but temporary
accidentals also are canceled in other octaves. Furthermore,
@end lilypond
@item @code{modern-cautionary}
-@cindex @code{modern-cautionary}
+@funindex modern-cautionary
This rule is similar to @code{modern}, but the ``extra'' accidentals
(the ones not typeset by @code{default}) are typeset as cautionary
accidentals. They are printed in reduced size or with parentheses
cis' c'' cis'2 | c'' c'
@end lilypond
-@cindex @code{modern-voice}
+@funindex modern-voice
@item modern-voice
This rule is used for multivoice accidentals to be read both by musicians
playing one voice and musicians playing all voices. Accidentals are
typeset for each voice, but they @emph{are} canceled across voices in
the same @internalsref{Staff}.
-@cindex @code{modern-voice-cautionary}
+@funindex modern-voice-cautionary
@item modern-voice-cautionary
This rule is the same as @code{modern-voice}, but with the extra
accidentals (the ones not typeset by @code{voice}) typeset
some of them are typeset as cautionaries.
@item piano
-@cindex @code{piano} accidentals
+@funindex piano accidentals
This rule reflects 20th century practice for piano notation. Very similar to
@code{modern} but accidentals also get canceled
across the staves in the same @internalsref{GrandStaff} or
@internalsref{PianoStaff}.
@item piano-cautionary
-@cindex @code{#(set-accidental-style 'piano-cautionary)}
+@funindex #(set-accidental-style 'piano-cautionary)
Same as @code{#(set-accidental-style 'piano)} but with the extra
accidentals typeset as cautionaries.
@item no-reset
-@cindex @code{no-reset} accidental style
+@funindex no-reset accidental style
This is the same as @code{default} but with accidentals lasting
``forever'' and not only until the next measure
@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
@node Setting automatic beam behavior
@subsection Setting automatic beam behavior
-@cindex @code{autoBeamSettings}
-@cindex @code{(end * * * *)}
-@cindex @code{(begin * * * *)}
+@funindex autoBeamSettings
+@funindex (end * * * *)
+@funindex (begin * * * *)
@cindex automatic beams, tuning
@cindex tuning automatic beaming
@cindex automatic beam generation
@cindex autobeam
-@cindex @code{autoBeaming}
+@funindex autoBeaming
@cindex lyrics
If beams are used to indicate melismata in songs, then automatic
@refcommands
-@cindex @code{\autoBeamOff}
+@funindex \autoBeamOff
@code{\autoBeamOff},
-@cindex @code{\autoBeamOn}
+@funindex \autoBeamOn
@code{\autoBeamOn}.
The easiest command is @code{\new}, and it also the quickest to type.
It is prepended to a music expression, for example
-@cindex @code{\new}
+@funindex \new
@cindex new contexts
@cindex Context, creating
context already earlier with the same name.
-@cindex @code{\context}
+@funindex \context
@item
Like @code{\new}, the @code{\context} command also directs a music
@subsection Changing context properties on the fly
@cindex properties
-@cindex @code{\set}
+@funindex \set
@cindex changing properties
Each context can have different @emph{properties}, variables contained
`on-the-fly', during the music, so that the setting only affects the
second group of eighth notes.
-@cindex @code{\unset}
+@funindex \unset
There is also an @code{\unset} command,
@example
starting a new context with @code{\new} or @code{\context}, and
modifying it,
-@cindex @code{\with}
+@funindex \with
@example
\new @var{context} \with @{
@}
@end example
-@cindex @code{\accepts}
+@funindex \accepts
Contexts form hierarchies. We want to hang the @context{ImproVoice}
under @context{Staff}, just like normal @code{Voice}s. Therefore, we
modify the @code{Staff} definition with the @code{\accepts}
@}
@end example
-@cindex @code{\denies}
+@funindex \denies
The opposite of @code{\accepts} is @code{\denies},
which is sometimes needed when reusing existing context definitions.
@cindex finding graphical objects
@cindex graphical object descriptions
@cindex tweaking
-@cindex @code{\override}
+@funindex \override
@cindex internal documentation
We demonstrate how to glean this information from the notation manual
@node Objects connected to the input
@subsection Objects connected to the input
-@cindex @code{\tweak}
+@funindex \tweak
In some cases, it is possible to take a short-cut for tuning graphical
objects. For objects that result directly from a piece of the input,
@node Including LilyPond files
@subsection Including LilyPond files
-@cindex @code{\include}
+@funindex \include
@cindex including files
A large project may be split up into separate files. To refer to another
}
@end lilypond
-@cindex @code{printallheaders}
+@funindex printallheaders
@noindent
You may change this behavior (and print all the headers when defining
@code{\header} inside @code{\score}) by using
@file{ly/titling-init.ly} lists the default layout.
@table @code
-@cindex @code{bookTitleMarkup}
+@funindex bookTitleMarkup
@item bookTitleMarkup
This is the title put over an entire @code{\book} block. Typically,
it has the composer and the title of the piece
-@cindex @code{scoreTitleMarkup}
+@funindex scoreTitleMarkup
@item scoreTitleMarkup
This is the title put over a @code{\score} block within a
@code{\book}. Typically, it has the name of the movement (@code{piece}
field).
-@cindex @code{oddHeaderMarkup}
+@funindex oddHeaderMarkup
@item oddHeaderMarkup
This is the page header for odd-numbered pages.
-@cindex @code{evenHeaderMarkup}
+@funindex evenHeaderMarkup
@item evenHeaderMarkup
This is the page header for even-numbered pages. If unspecified,
the odd header is used instead.
By default, headers are defined such that the page number is on the
outside edge, and the instrument is centered.
-@cindex @code{oddFooterMarkup}
+@funindex oddFooterMarkup
@item oddFooterMarkup
This is the page footer for odd-numbered pages.
-@cindex @code{evenFotterMarkup}
+@funindex evenFotterMarkup
@item evenFooterMarkup
This is the page footer for even-numbered pages. If unspecified,
the odd header is used instead.
@cindex paper size
@cindex page size
-@cindex @code{papersize}
+@funindex papersize
To change the paper size, there are two commands,
@example
LilyPond will do page layout, set margins, and add headers and
footers to each page.
-@cindex @code{annotate-spacing}
+@funindex annotate-spacing
@cindex Spacing, display of properties
To graphically display the dimensions of properties that may
The default layout responds to the following settings in the
@code{\paper} block.
-@cindex @code{\paper}
+@funindex \paper
@quotation
@table @code
-@cindex @code{first-page-number}
+@funindex first-page-number
@item first-page-number
The value of the page number of the first page. Default is@tie{}1.
-@cindex @code{printfirst-page-number}
+@funindex printfirst-page-number
@item printfirst-page-number
If set to true, will print the page number in the first page. Default is
false.
-@cindex @code{print-page-number}
+@funindex print-page-number
@item print-page-number
If set to false, page numbers will not be printed.
-@cindex @code{paper-width}
+@funindex paper-width
@item paper-width
The width of the page.
-@cindex @code{paper-height}
+@funindex paper-height
@item paper-height
The height of the page.
-@cindex @code{top-margin}
+@funindex top-margin
@item top-margin
Margin between header and top of the page.
-@cindex @code{bottom-margin}
+@funindex bottom-margin
@item bottom-margin
Margin between footer and bottom of the page.
-@cindex @code{left-margin}
+@funindex left-margin
@item left-margin
Margin between the left side of the page and the beginning of the music.
-@cindex @code{line-width}
+@funindex line-width
@item line-width
The length of the systems.
-@cindex @code{head-separation}
+@funindex head-separation
@item head-separation
Distance between the top-most music system and the page header.
-@cindex @code{foot-separation}
+@funindex foot-separation
@item foot-separation
Distance between the bottom-most music system and the page footer.
-@cindex @code{page-top-space}
+@funindex page-top-space
Distance from the top of the printable area to the center of the first
staff. This only works for staves which are vertically small. Big staves
are set with the top of their bounding box aligned to the top of the
printable area.
-@cindex @code{ragged-bottom}
+@funindex ragged-bottom
@item ragged-bottom
If set to true, systems will not be spread vertically across the page. This
does not affect the last page.
This should be set to true for pieces that have only two or three
systems per page, for example orchestral scores.
-@cindex @code{ragged-last-bottom}
+@funindex ragged-last-bottom
@item ragged-last-bottom
If set to false, systems will be spread vertically to fill the last page.
Pieces that amply fill two pages or more should have this set to
true.
-@cindex @code{system-count}
+@funindex system-count
@item system-count
This variable, if set, specifies into how many lines a score should be
broken.
-@cindex @code{between-system-space}
+@funindex between-system-space
@item between-system-space
This dimensions determines the distance between systems. It is the
ideal distance between the center of the bottom staff of one system
Increasing this will provide a more even appearance of the page at the
cost of using more vertical space.
-@cindex @code{between-system-padding}
+@funindex between-system-padding
@item between-system-padding
This dimension is the minimum amount of white space that will always
be present between the bottom-most symbol of one system, and the
farther apart.
-@cindex @code{horizontal-shift}
+@funindex horizontal-shift
@item horizontal-shift
All systems (including titles and system separators) are shifted by
this amount to the right. Page markup, such as headers and footers are
not affected by this. The purpose of this variable is to make space
for instrument names at the left.
-@cindex @code{after-title-space}
+@funindex after-title-space
@item after-title-space
Amount of space between the title and the first system.
-@cindex @code{after-title-space}
+@funindex after-title-space
@item before-title-space
Amount of space between the last system of the previous piece and the
title of the next.
-@cindex @code{between-title-space}
+@funindex between-title-space
@item between-title-space
Amount of space between consecutive titles (e.g., the title of the
book and the title of a piece).
-@cindex @code{printallheaders}
+@funindex printallheaders
@item printallheaders
Setting this to #t will print all headers for each \score in a
\book. Normally only the piece and opus \headers are printed.
-@cindex @code{systemSeparatorMarkup}
+@funindex systemSeparatorMarkup
@item systemSeparatorMarkup
This contains a markup object, which will be inserted between
systems. This is often used for orchestral scores.
@cindex font size, setting
@cindex staff size, setting
-@cindex @code{layout} file
+@funindex layout file
To set the global staff size, use @code{set-global-staff-size}.
The following commands set @code{fontSize} for the current voice:
-@cindex @code{\tiny}
+@funindex \tiny
@code{\tiny},
-@cindex @code{\small}
+@funindex \small
@code{\small},
-@cindex @code{\normalsize}
+@funindex \normalsize
@code{\normalsize}.
@node Score layout
@subsection Score layout
-@cindex @code{\layout}
+@funindex \layout
While @code{\paper} contains settings that relate to the page formatting
of the whole document, @code{\layout} contains settings for score-specific
this sets the base duration for spacing. The maximum duration for this
base (normally an 8th), is set through @code{base-shortest-duration}.
-@cindex @code{common-shortest-duration}
-@cindex @code{base-shortest-duration}
-@cindex @code{stem-spacing-correction}
-@cindex @code{spacing}
+@funindex common-shortest-duration
+@funindex base-shortest-duration
+@funindex stem-spacing-correction
+@funindex spacing
Notes that are even shorter than the common shortest note are
followed by a space that is proportional to their duration relative to
@cindex page breaks
@cindex breaking pages
-@cindex @code{indent}
-@cindex @code{line-width}
-@cindex @code{ragged-right}
-@cindex @code{ragged-last}
+@funindex indent
+@funindex line-width
+@funindex ragged-right
+@funindex ragged-last
@c Although line-width can be set in \layout, it should be set in paper
@c block, to get page layout right.
@refcommands
@code{\break}, and @code{\noBreak}.
-@cindex @code{\break}
-@cindex @code{\noBreak}
+@funindex \break
+@funindex \noBreak
@seealso
@refcommands
-@cindex @code{\pageBreak}
+@funindex \pageBreak
@code{\pageBreak}
-@cindex @code{\noPageBreak}
+@funindex \noPageBreak
@code{\noPageBreak}
@}
@end example
-@cindex @code{\book}
+@funindex \book
The movements and texts are combined together in a @code{\book} block,
like
@subsection MIDI instrument names
@cindex instrument names
-@cindex @code{Staff.midiInstrument}
+@funindex Staff.midiInstrument
The MIDI instrument name is set by the @code{Staff.midiInstrument}
property. The instrument name should be chosen from the list in
@node Displaying LilyPond notation
@section Displaying LilyPond notation
-@cindex @code{\displayLilyMusc}
+@funindex \displayLilyMusc
Displaying a music expression in LilyPond notation can be
done using the music function @code{\displayLilyMusic}. For example,
@cindex staff switching
@cindex cross staff
-@cindex @code{followVoice}
+@funindex followVoice
Whenever a voice switches to another staff, a line connecting the notes
can be printed automatically. This is switched on by setting
@refcommands
-@cindex @code{\showStaffSwitch}
+@funindex \showStaffSwitch
@code{\showStaffSwitch},
-@cindex @code{\hideStaffSwitch}
+@funindex \hideStaffSwitch
@code{\hideStaffSwitch}.
@end lilypond
@cindex modifiers, in chords.
-@cindex @code{aug}
-@cindex @code{dim}
-@cindex @code{maj}
-@cindex @code{sus}
-@cindex @code{m}
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex sus
+@funindex 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
\chordmode { c:13 c:13.11 c:m13 }
@end lilypond
-@cindex @code{/}
+@funindex /
An inversion (putting one pitch of the chord on the bottom), as well
as bass notes, can be specified by appending
@lilypond[quote,ragged-right,fragment,verbatim]
\chordmode { c1 c/g c/f }
@end lilypond
-@cindex @code{/+}
+@funindex /+
A bass note can be added instead transposed out of the chord,
by using @code{/+}@var{pitch}.
following properties
@table @code
-@cindex @code{chordNameExceptions}
+@funindex chordNameExceptions
@item chordNameExceptions
This is a list that contains the chords that have special formatting.
@cindex exceptions, chord names.
-@cindex @code{majorSevenSymbol}
+@funindex 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}
+@funindex chordNameSeparator
@item chordNameSeparator
Different parts of a chord name are normally separated by a
slash. By setting @code{chordNameSeparator}, you can specify other
}
@end lilypond
-@cindex @code{chordRootNamer}
+@funindex 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}
+@funindex 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}
+@funindex 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
@refcommands
-@cindex @code{\germanChords}
+@funindex \germanChords
@code{\germanChords},
-@cindex @code{\semiGermanChords}
+@funindex \semiGermanChords
@code{\semiGermanChords}.
-@cindex @code{\italianChords}
+@funindex \italianChords
@code{\italianChords}.
-@cindex @code{\frenchChords}
+@funindex \frenchChords
@code{\frenchChords}.
@subsection Entering lyrics
@cindex lyrics
-@cindex @code{\lyricmode}
+@funindex \lyricmode
@cindex punctuation
Lyrics are entered in a special input mode. This mode is introduced
\lyricmode @{ twinkle@}
@end example
-@cindex @code{\property}, in @code{\lyricmode}
+@funindex \property, in @code{\lyricmode
@noindent
Similarly, a period which follows an alphabetic sequence is included in
the resulting string. As a consequence, spaces must be inserted around
\override Score . LyricText #'font-shape = #'italic
@end example
-@cindex @code{_}
+@funindex _
@cindex spaces, in lyrics
@cindex quotes, in lyrics
@end example
@cindex automatic syllable durations
-@cindex @code{\lyricsto}
+@funindex \lyricsto
@cindex lyrics and melodies
This will place the lyrics according to the durations that were
@refcommands
@code{\melisma}, @code{\melismaEnd}
-@cindex @code{\melismaEnd}
-@cindex @code{\melisma}
+@funindex \melismaEnd
+@funindex \melisma
@seealso
}
@end lilypond
-@cindex @code{minimumFret}
+@funindex minimumFret
@cindex fret
When no string is specified, the first string that does not give a
@refcommands
-@cindex @code{\virgula}
+@funindex \virgula
@code{\virgula},
-@cindex @code{\caesura}
+@funindex \caesura
@code{\caesura},
-@cindex @code{\divisioMinima}
+@funindex \divisioMinima
@code{\divisioMinima},
-@cindex @code{\divisioMaior}
+@funindex \divisioMaior
@code{\divisioMaior},
-@cindex @code{\divisioMaxima}
+@funindex \divisioMaxima
@code{\divisioMaxima},
-@cindex @code{\finalis}
+@funindex \finalis
@code{\finalis}.
@seealso
The following head prefixes are supported
-@cindex @code{\virga}
+@funindex \virga
@code{\virga},
-@cindex @code{\stropha}
+@funindex \stropha
@code{\stropha},
-@cindex @code{\inclinatum}
+@funindex \inclinatum
@code{\inclinatum},
-@cindex @code{\auctum}
+@funindex \auctum
@code{\auctum},
-@cindex @code{\descendens}
+@funindex \descendens
@code{\descendens},
-@cindex @code{\ascendens}
+@funindex \ascendens
@code{\ascendens},
-@cindex @code{\oriscus}
+@funindex \oriscus
@code{\oriscus},
-@cindex @code{\quilisma}
+@funindex \quilisma
@code{\quilisma},
-@cindex @code{\deminutum}
+@funindex \deminutum
@code{\deminutum},
-@cindex @code{\cavum}
+@funindex \cavum
@code{\cavum},
-@cindex @code{\linea}
+@funindex \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}
+@funindex \pes
+@funindex \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.
Support for such suggested accidentals is included, and can be
switched on by setting @code{suggestAccidentals} to true.
-@cindex @code{suggestAccidentals}
+@funindex suggestAccidentals
@lilypond[verbatim,fragment,relative=1]
fis gis
@section Updating with @command{convert-ly}
@cindex Updating a LilyPond file
-@cindex @code{convert-ly}
+@funindex convert-ly
The LilyPond input syntax is routinely changed to simplify it or improve
it in different ways. As a side effect of this, the LilyPond interpreter
@cindex texinfo
@cindex latex
@cindex texinfo
-@cindex @code{texi}
+@funindex texi
@cindex html
@cindex documents, adding music to
use the @code{line-width} music fragment option.
@cindex titling and lilypond-book
-@cindex @code{\header} in La@TeX{} documents
+@funindex \header in La@TeX{} documents
Each snippet will call the following macros if they have been defined by
the user:
@subsection Displaying music expressions
@cindex internal storage
-@cindex @code{\displayMusic}
-@cindex @code{\displayLilyMusic}
+@funindex \displayMusic
+@funindex \displayLilyMusic
When writing a music function it is often instructive to inspect how
a music expression is stored internally. This can be done with the
@subsection Context evaluation
@cindex calling code during interpreting
-@cindex @code{\applyContext}
+@funindex \applyContext
Contexts can be modified during interpretation with Scheme code. The
syntax for this is
@cindex calling code on layout objects
-@cindex @code{\applyOutput}
+@funindex \applyOutput
The most versatile way of tuning an object is @code{\applyOutput}. Its
@node Scheme tutorial
@appendix Scheme tutorial
-@cindex @code{#}
+@funindex #
@cindex Scheme
@cindex GUILE
@cindex Scheme, in-line code
@item Booleans
Boolean values are True or False. The Scheme for True is @code{#t}
and False is @code{#f}.
-@cindex @code{##t}
-@cindex @code{##f}
+@funindex ##t
+@funindex ##f
@item Numbers
Numbers are entered in the standard fashion,
#'twentyFour
@end example
-@cindex @code{#'symbol}
+@funindex #'symbol
@cindex quoting in Scheme
The quote mark @code{'} prevents the Scheme interpreter from substituting
@itemize @bullet
-@cindex @code{padding}
+@funindex padding
@item The @code{padding} property can be set to increase
(or decrease) the distance between symbols that are printed
above or below notes. This applies to all objects with
@code{Voice} context will not be noticed. For more details, see
@ref{Constructing a tweak}.
-@cindex @code{extra-offset}
+@funindex extra-offset
@item The @code{extra-offset} property moves objects around
in the output; it requires a pair of numbers. The first number
controls horizontal movement; a positive number will