@subsection Notes
-A note is printed by specifying its pitch and then its duration.
+A note is printed by specifying its pitch and then its duration:
@footnote{Notes constitute the most basic elements of LilyPond input,
but they do not form valid input on their own without a @code{\score}
block. However, for the sake of brevity and simplicity we will
by names. The notes are specified by the letters @code{a} through
@code{g}, while the octave is formed with notes ranging from @code{c}
to @code{b}. The pitch @code{c} is an octave below middle C and the
-letters span the octave above that C.
+letters span the octave above that C:
@lilypond[fragment,verbatim]
\clef bass
The optional octave specification takes the form of a series of
single quote (`@code{'}') characters or a series of comma
(`@code{,}') characters. Each @code{'} raises the pitch by one
-octave; each @code{,} lowers the pitch by an octave.
+octave; each @code{,} lowers the pitch by an octave:
@lilypond[fragment,verbatim,center]
c' c'' es' g' as' gisis' ais'
@end lilypond
-There is also a verbose syntax for pitch specification.
+There is also a verbose syntax for pitch specification:
@c TODO: junk this?
@cindex @code{\pitch}
@refcommands
-Notes can be hidden and unhidden with the following commands.
+Notes can be hidden and unhidden with the following commands:
@cindex @code{\hideNotes }
@code{\hideNotes},
@cindex cautionary accidental
@cindex parenthesized accidental
(an accidental within parentheses) can be obtained by adding the
-question mark `@code{?}' after the pitch.
+question mark `@code{?}' after the pitch:
@lilypond[fragment,verbatim]
cis' cis' cis'! cis'?
-Rests are entered like notes, with the note name @code{r}.
+Rests are entered like notes, with the note name @code{r}:
@lilypond[singleline,verbatim]
r1 r2 r4 r8
A rest's vertical position may be explicitly specified by entering a
note with the @code{\rest} keyword appended. This makes manual
formatting in polyphonic music easier. Rest collision testing will
-leave these rests alone.
+leave these rests alone:
@lilypond[singleline,verbatim]
a'4\rest d'4\rest
@end lilypond
The @code{s} syntax is only available in Note mode and Chord mode. In
-other situations, you should use the @code{\skip} command.
+other situations, you should use the @code{\skip} command:
@lilypond[singleline,verbatim]
\score {
and dots: durations are entered as their reciprocal values. For example,
a quarter note is entered using a @code{4} (since it is a 1/4 note), while
a half note is entered using a @code{2} (since it is a 1/2 note). For notes
-longer than a whole you must use variables.
+longer than a whole you must use variables:
@c FIXME: what is an identifier? I do not think it's been introduced yet.
@c and if it has, I obviously skipped that part. - Graham
appending `@code{*}@var{N/M}' (or `@code{*}@var{N}' if @var{M=1}). This
will not affect the appearance of the notes or rests produced.
In the following example, the first three notes take up exactly two
-beats.
+beats:
@lilypond[fragment,relative 2,verbatim]
\time 2/4
a4*2/3 gis4*2/3 a4*2/3
@end lilypond
Durations can also be produced using the verbose syntax
-@code{\duration @var{Scheme object}}.
+@code{\duration @var{Scheme object}}:
@lilypond[verbatim,fragment]
c'\duration #(ly:make-duration 4 1)
@end lilypond
Dots are normally moved up to avoid staff lines, except in polyphonic
situations. The following commands may be used to force a particular
-direction manually.
+direction manually:
@cindex @code{\dotsUp }
@code{\dotsUp},
@cindex @code{\stemDown}
@code{\stemDown},
@cindex @code{\stemBoth}
-@code{\stemBoth},
+@code{\stemBoth}.
@node Ties
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
slurs, which indicate articulation, or phrasing slurs, which indicate
-musical phrasing. A tie is entered using the tilde symbol `@code{~}'.
+musical phrasing. A tie is entered using the tilde symbol `@code{~}':
@lilypond[fragment,verbatim,center]
e' ~ e' <<c' e' g'>> ~ <<c' e' g'>>
are connected. When no note heads match, no ties will be created.
In its meaning a tie is just a way of extending a note duration, similar
-to the augmentation dot: the following example are two ways of notating
-exactly the same concept.
+to the augmentation dot; in the following example there are two ways of
+notating exactly the same concept:
@c
@lilypond[fragment, singleline,quote]
\time 3/4 c'2. c'2 ~ c'4
@cindex @code{\tieDotted }
@code{\tieDotted},
@cindex @code{\tieSolid}
-@code{\tieSolid},
+@code{\tieSolid}.
@seealso
@cindex @code{\times}
Tuplets are made out of a music expression by multiplying all durations
-with a fraction.
+with a fraction:
@cindex @code{\times}
@example
bracket should last. With this, you can make lots of tuplets while
typing @code{\times} only once, saving lots of typing. In the next
example, there are two triplets shown, while @code{\times} was only
-used once.
+used once:
@lilypond[fragment, relative, singleline, verbatim]
\property Voice.tupletSpannerDuration = #(ly:make-moment 1 4)
@cindex @code{\tupletDown }
@code{\tupletDown},
@cindex @code{\tupletBoth}
-@code{\tupletBoth},
+@code{\tupletBoth}.
@seealso
}
@end lilypond
-The @code{EasyNotation} variable overrides a @internalsref{Score}
-context. You probably will want to print it with magnification or a
+The @code{EasyNotation} variable overrides a @internalsref{Score} context.
+You probably will want to print it with magnification or a
large font size to make it more readable. To print with
magnification, you must create a DVI file (with @file{ly2dvi}) and
then enlarge it with something like @file{dvips -x 2000 file.dvi}.
When you copy existing music, it is easy to accidentally put a pitch
in the wrong octave and hard to find such an error. The relative
octave mode prevents these errors: a single error puts the rest of the
-piece off by one octave.
+piece off by one octave:
@cindex @code{\relative}
@example
The octave of notes that appear in @var{musicexpr} are calculated as
follows: If no octave changing marks are used, the basic interval
between this and the last note is always taken to be a fourth or less
-(This distance is determined without regarding alterations; a
+(; this distance is determined without regarding alterations: a
@code{fisis} following a @code{ceses} will be put above the
-@code{ceses})
+@code{ceses}).
The octave changing marks @code{'} and @code{,} can be added to raise
or lower the pitch by an extra octave. Upon entering relative mode,
}
@end lilypond
-Octave changing marks are used for intervals greater than a fourth.
+Octave changing marks are used for intervals greater than a fourth:
@lilypond[fragment,verbatim,center]
\relative c'' {
c g c f, c' a, e'' }
@end lilypond
If the preceding item is a chord, the first note of the chord is used
-to determine the first note of the next chord.
+to determine the first note of the next chord:
@lilypond[fragment,verbatim,center]
\relative c' {
@code{barCheckSynchronize}, the beginning of the measure will be
relocated.
-In the next example, the second bar check will signal an error.
+In the next example, the second bar check will signal an error:
@example
\time 3/4 c2 e4 | g2 |
@end example
off typesetting completely during the interpretation phase. When
typesetting is switched off, the music is processed much more quickly.
This can be used to skip over the parts of a score that have already
-been checked for errors.
+been checked for errors:
@lilypond[fragment,singleline,verbatim]
\relative c'' { c8 d
Long notes can be converted automatically to tied notes. This is done
by replacing the @internalsref{Note_heads_engraver} by the
-@internalsref{Completion_heads_engraver}.
+@internalsref{Completion_heads_engraver}:
@example
\paper @{ \translator @{
@} @}
@end example
-For example,
+which will make long notes tied in the following example:
@example
\time 2/4
c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
@syntax
Setting or changing the key signature is done with the @code{\key}
-command.
+command:
@example
@code{\key} @var{pitch} @var{type}
@end example
\key f\major c''2 \clef alto g'2
@end lilypond
-Supported clef-names include
+Supported clef-names include:
@c Moved standard clefs to the top /MB
@table @code
@item treble, violin, G, G2
@end table
By adding @code{_8} or @code{^8} to the clef name, the clef is
-transposed one octave down or up, respectively. @var{clefname} must
-be enclosed in quotes when it contains underscores or digits. For
+transposed one octave down or up, respectively. Argument @var{clefname}
+must be enclosed in quotes when it contains underscores or digits. For
example,
@example
\clef "G_8"
``Ottava'' brackets introduce an extra transposition of an octave for
the staff. They are created by invoking the function
-@code{set-octavation}
+@code{set-octavation}:
@cindex ottava
@cindex 15ma
@syntax
The time signature is set or changed by the @code{\time}
-command.
+command:
@lilypond[fragment,verbatim]
\time 2/4 c'2 \time 3/4 c'2.
@end lilypond
@internalsref{MeasureGrouping} signs. Such signs ease reading
rhythmically complex modern music. In the following example, the 9/8
measure is subdivided in 2, 2, 2 and 3. This is passed to
-@code{set-time-signature} as the third argument @code{(2 2 2 3)}.
+@code{set-time-signature} as the third argument @code{(2 2 2 3)}:
@lilypond[verbatim]
\score { \notes \relative c'' {
@cindex @code{\cadenzaOn }
@code{\cadenzaOn},
@cindex @code{\cadenzaOff }
-@code{\cadenzaOff},
+@code{\cadenzaOff}.
@node Bar lines
@subsection Bar lines
Bar lines delimit measures, but are also used to indicate repeats.
-Normally, tehy are inserted automatically. Line breaks may only
+Normally, they are inserted automatically. Line breaks may only
happen on barlines.
@syntax
c4 \bar "|:" c4
@end lilypond
-The following bar types are available
+The following bar types are available:
@lilypond[fragment, relative, singleline, verbatim]
c4
\bar "|" c
@code{defaultBarType}. The contents of @code{repeatCommands} are used
to override default measure bars.
-@code{whichBar} can also be set directly, using @code{\property} or
-@code{\bar}. These settings take precedence over the automatic
+Property @code{whichBar} can also be set directly, using @code{\property}
+or @code{\bar}. These settings take precedence over the automatic
@code{whichBar} settings.
@cindex whichBar
This can also be done by instantiating @internalsref{Voice} contexts
by hand, and using @code{\voiceOne}, up to @code{\voiceFour} to assign
-a stem directions and horizontal shift for each part.
+a stem directions and horizontal shift for each part:
@c
@lilypond[singleline, verbatim]
Normally, note heads with a different number of dots are not merged, but
when the object property @code{merge-differently-dotted} is set in
-the @internalsref{NoteCollision} object, they are:
+the @internalsref{NoteCollision} object, they are merged:
@lilypond[verbatim,fragment,singleline]
\relative c'' \context Voice < {
g8 g8
c8 c4. } \\ { c2 c2 } >
@end lilypond
-LilyPond also vertically shifts rests that are opposite of a stem.
+LilyPond also vertically shifts rests that are opposite of a stem:
@lilypond[singleline,fragment,verbatim]
@cindex @code{\voiceThree }
@code{\voiceThree},
@cindex @code{\voiceFour }
-@code{\voiceFour},
+@code{\voiceFour}.
The following commands specify in what chords of the current voice
should be shifted: the outer voice has @code{\shiftOff}, and the inner
@cindex @code{\shiftOnnn}
@code{\shiftOnnn},
@cindex @code{\shiftOff}
-@code{\shiftOff},
+@code{\shiftOff}.
property of the @internalsref{NoteColumn} object and pitched rests can
be used to override typesetting decisions.
-When using @code{merge-differently-headed} with upstem 8th or shorter
+When using @code{merge-differently-headed} with an upstem 8th or a shorter
note, and a downstem half note, the 8th note gets the wrong offset.
@node Beaming
@section Beaming
Beams are used to group short notes into chunks that are aligned with
-the metrum. They are inserted automatically in most cases.
+the metrum. They are inserted automatically in most cases:
@lilypond[fragment,verbatim, relative=2]
\time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
In some cases it may be necessary to override the automatic beaming
algorithm. For example, the auto beamer will not put beams over rests
or bar lines. Such beams are specified by manually: the begin and end
-point are marked with @code{[} and @code{]}.
+point are marked with @code{[} and @code{]}:
@lilypond[fragment,relative,verbatim]
\context Staff {
all 16th or shorter beams at beat positions, as defined by the
@code{beatLength} property . This accomplishes the same effect as
twiddling with @code{stemLeftBeamCount} and @code{stemRightBeamCount},
-but it take less typing.
+but it take less typing:
@lilypond[relative=1,verbatim,noindent]
entered as @code{(ly:make-moment 1 4)}.
The same syntax can be used to specify beam starting points. In this
-example, automatic beams can only end on a dotted quarter note.
+example, automatic beams can only end on a dotted quarter note:
@example
\property Voice.autoBeamSettings \override
#'(end * * * *) = #(ly:make-moment 3 8)
@cindex @code{\autoBeamOff }
@code{\autoBeamOff},
@cindex @code{\autoBeamOn }
-@code{\autoBeamOn},
+@code{\autoBeamOn}.
@refbugs
It is not possible to specify beaming parameters for beams with mixed
durations, that differ from the beaming parameters of all separate
-durations, i.e., you will have to specify manual beams to get:
+durations, i.e. you will have to specify manual beams to get:
@lilypond[singleline,fragment,relative,noverbatim,quote]
\property Voice.autoBeamSettings
@end lilypond
Hence you should only use @code{\voiceAccidentals} if the voices
are to be read solely by individual musicians. If the staff is to be
-used by one musician (e.g., a conductor) then you use
+used by one musician (e.g. a conductor) then you use
@code{\modernVoiceAccidentals} or @code{\modernVoiceCautionaries}
instead.
century.
The rule is more complex than @code{\defaultAccidentals}.
You get all the same accidentals, but temporary
- accidentals also get cancelled in other octaves. Further more,
+ accidentals also get cancelled in other octaves. Furthermore,
in the same octave, they also get cancelled in the following measure:
@lilypond[singleline,fragment,verbatim]
\modernAccidentals
This rule is similar to @code{\modernAccidentals}, but the
``extra'' accidentals (the ones not typeset by
@code{\defaultAccidentals}) are typeset as cautionary accidentals.
- They are printed in reduced size or with parentheses.
+ They are printed in reduced size or with parentheses:
@lilypond[singleline,fragment,verbatim]
\modernCautionaries
cis' c'' cis'2 | c'' c'
@cindex @code{\noResetKey }
@code{\noResetKey},
@cindex @code{\forgetAccidentals }
-@code{\forgetAccidentals},
+@code{\forgetAccidentals}.
@seealso
Currently the simultaneous notes are considered to be entered in
sequential mode. This means that in a chord the accidentals are
-typeset as if the notes in the chord happened one at a time - in the
+typeset as if the notes in the chord happened once at a time - in the
order in which they appear in the input file.
This is only a problem when there are simultaneous notes whose
ends. If you want to override this layout you can do this through the
object property @code{attachment} of @internalsref{Slur} in
@internalsref{Voice} context. Its value is a pair of symbols, specifying
-the attachment type of the left and right end points.
+the attachment type of the left and right end points:
@lilypond[fragment,relative,verbatim]
\slurUp
@cindex @code{\slurDotted }
@code{\slurDotted},
@cindex @code{\slurSolid }
-@code{\slurSolid},
+@code{\slurSolid}.
@seealso
A phrasing slur (or phrasing mark) connects chords and is used to
indicate a musical sentence. It is started using @code{\(} and @code{\)}
-respectively.
+respectively:
@lilypond[fragment,verbatim,center,relative]
\time 6/4 c'-\( d-( e-) f-( e-) d-\)
@node Breath marks
@subsection Breath marks
-Breath marks are entered using @code{\breathe}.
+Breath marks are entered using @code{\breathe}:
@lilypond[fragment,relative,verbatim]
@end example
In the MIDI output, they are interpreted as a tempo change, and in the
-paper output, a metronome marking is printed
+paper output, a metronome marking is printed:
@cindex @code{\tempo}
@lilypond[fragment,verbatim]
\tempo 8.=120 c''1
start and ending note of the spanner.
The string to be printed, as well as the style, is set through object
-properties.
+properties:
@lilypond[fragment,relative,verbatim]
\relative c' { c1
pieces. LilyPond supports a simple form of nested horizontal brackets.
To use this, add the @internalsref{Horizontal_bracket_engraver} to
@internalsref{Staff} context. A bracket is started with
-@code{\startGroup} and closed with @code{\stopGroup}.
+@code{\startGroup} and closed with @code{\stopGroup}:
@lilypond[singleline,verbatim]
\score { \notes \relative c'' {
A variety of symbols can appear above and below notes to indicate
different characteristics of the performance. They are added to a note
by adding a dash and the character signifying the
-articulation. They are demonstrated here.
+articulation. They are demonstrated here:
@lilypondfile[notexidoc]{script-abbreviations.ly}
Other symbols can be added using the syntax
@var{note}@code{-\}@var{name}, e.g. @code{c4-\fermata}. Again, they
-can be forced up or down using @code{^} and @code{_}.
+can be forced up or down using @code{^} and @code{_}:
@cindex accent
@cindex marcato
@cindex @code{\scriptDown }
@code{\scriptDown},
@cindex @code{\scriptBoth}
-@code{\scriptBoth},
+@code{\scriptBoth}.
@seealso
@end lilypond
Fingerings for chords can also be added to individual notes
-of the chord by adding them after the pitches
+of the chord by adding them after the pitches:
@lilypond[verbatim,singleline,fragment,relative=1]
<< c-1 e-2 g-3 b-5 >> 4
@end lilypond
Setting @code{fingerHorizontalDirection} will put the fingerings next
-to the note head.
+to the note head:
@lilypond[verbatim,singleline,fragment,relative=1]
\property Voice.fingerHorizontalDirection = #LEFT
@ref{Text markup}) above or below notes by using a string:
@code{c^"text"}. By default, these indications do not influence the
note spacing, but by using the command @code{\fatText}, the widths
-will be taken into account.
+will be taken into account:
@c
@lilypond[fragment,singleline,verbatim] \relative c' {
c4^"longtext" \fatText c4_"longlongtext" c4 }
@cindex ornaments
@cindex grace notes
-Grace notes are ornaments that are written out
+Grace notes are ornaments that are written out:
@lilypond[relative=2,verbatim,fragment] c4 \grace c16 c4 \grace {
[c16 d16] } c4
Every point in musical time consists of two rational numbers: one
denotes the logical time, one denotes the grace timing. The above
-example is shown here with timing tuples.
+example is shown here with timing tuples:
@lilypond[]
\score { \notes \relative c''{
The placement of grace notes is synchronized between different staves.
In the following example, there are two sixteenth graces notes for
-every eighth grace note.
+every eighth grace note:
@lilypond[relative=2,verbatim,fragment]
< \context Staff = SA { e4 \grace { c16-[ d e f-] } e4 }
@internalsref{Stem}. For proper matching of override and reverts of
such properties, it is necessary to use a Scheme function.
-The following fragment overrides the default formatting Grace style stems.
+The following fragment overrides the default formatting Grace style stems:
@example
#(add-to-grace-init "Voice" 'Stem 'stroke-style '())
@end example
-The @code{\override} is carefully matched with a @code{\revert}.
+The @code{\override} is carefully matched with a @code{\revert}:
@cindex slash
@cindex grace slash
@seealso
-@internalsref{GraceMusic},
+@internalsref{GraceMusic}
@refbugs
Grace note synchronization can also lead to surprises. Staff notation,
such as key signatures, barlines, etc. are also synchronized. Take
-care when you mix staves with grace notes and staves without, for example:
+care when you mix staves with grace notes and staves without, for example,
@lilypond[relative=2,verbatim,fragment]
< \context Staff = SA { e4 \bar "|:" \grace c16 d4 }
Absolute dynamic marks are specified using an variable after a
-note: @code{c4-\ff}. The available dynamic marks are: @code{\ppp},
+note: @code{c4-\ff}. The available dynamic marks are @code{\ppp},
@code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
@code{\fff}, @code{\fff}, @code{\fp}, @code{\sf}, @code{\sff},
-@code{\sp}, @code{\spp}, @code{\sfz}, and @code{\rfz}.
+@code{\sp}, @code{\spp}, @code{\sfz}, and @code{\rfz}:
@lilypond[verbatim,singleline,fragment,relative]
c'-\ppp c-\pp c -\p c-\mp c-\mf c-\f c-\ff c-\fff
A crescendo mark is started with @code{\<} and terminated with
@code{\!}. A decrescendo is started with @code{\>} and also terminated
with @code{\!}. Because these marks are bound to notes, if you must
-use spacer notes if multiple marks during one note are needed.
+use spacer notes if multiple marks during one note are needed:
@lilypond[fragment,verbatim,center,quote]
c''-\< c''-\! d''-\decr e''-\rced
@cindex @code{\dynamicDown }
@code{\dynamicDown},
@cindex @code{\dynamicBoth }
-@code{\dynamicBoth},
+@code{\dynamicBoth}.
@cindex direction, of dynamics
@internalsref{Hairpin}. Vertical positioning of these symbols is
handled by the @internalsref{DynamicLineSpanner} object.
-If you want to adjust padding or vertical direction of the dynamics,
-you must set properties for the @internalsref{DynamicLineSpanner}
-object.
+If you want to adjust padding or vertical direction of the dynamics, you
+must set properties for the @internalsref{DynamicLineSpanner} object.
@node Repeats
@table @asis
@item the symbol @code{start-repeat},
- which prints a @code{|:} bar line.
-@item The symbol @code{end-repeat},
- which prints a @code{:|} bar line
-@item The list @code{(volta @var{text})}
- which prints a volta bracket saying @var{text}. The text can be specified as
+ which prints a @code{|:} bar line,
+@item the symbol @code{end-repeat},
+ which prints a @code{:|} bar line,
+@item the list @code{(volta @var{text})},
+ which prints a volta bracket saying @var{text}: The text can be specified as
a text string or as a markup text, see @ref{Text markup}. Do not
forget to change the font, as the default number font does not contain
-alphabetic characters.
-@item The list @code{(volta #f)}, which
- stops a running volta bracket
+alphabetic characters. Or,
+@item the list @code{(volta #f)}, which
+ stops a running volta bracket:
@end table
@lilypond[verbatim, fragment]
@internalsref{VoltaBracket}, @internalsref{RepeatedMusic},
@internalsref{VoltaRepeatedMusic},
-@internalsref{UnfoldedRepeatedMusic}
+@internalsref{UnfoldedRepeatedMusic},
@internalsref{FoldedRepeatedMusic}.
@node Tremolo repeats
@cindex tremolo beams
To place tremolo marks between notes, use @code{\repeat} with tremolo
-style.
+style:
@lilypond[verbatim,center,singleline]
\score {
\context Voice \notes\relative c' {
@seealso
Tremolo beams are @internalsref{Beam} objects. Single stem tremolos
-are @internalsref{StemTremolo}. The music expression is
+are @internalsref{StemTremolo}s. The music expression is
@internalsref{TremoloEvent}.
`@code{:}[@var{length}]' after the note. The length must be at least 8.
A @var{length} value of 8 gives one line across the note stem. If the
length is omitted, then then the last value (stored in
-@code{Voice.tremoloFlags}) is used.
+@code{Voice.tremoloFlags}) is used:
@lilypond[verbatim,fragment,center]
c'2:8 c':32 | c': c': |
In the @code{percent} style, a note pattern can be repeated. It is
printed once, and then the pattern is replaced with a special sign.
Patterns of a one and two measures are replaced by percent-like signs,
-patterns that divide the measure length are replaced by slashes.
+patterns that divide the measure length are replaced by slashes:
@lilypond[verbatim,singleline]
\context Voice { \repeat "percent" 4 { c'4 }
piece of percussion has a full name and an abbreviated name, and both
the full name or the abbreviation may be used in input files.
-To typeset the music on a staff apply the function @code{drums->paper}
+to typeset the music on a staff apply the function @code{drums->paper}
to the percussion music. This function takes a list of percussion
instrument names, notehead scripts and staff positions (that is:
pitches relative to the C-clef) and transforms the input
Currently the following lists are defined in @file{scm/drums.scm}:
@table @code
@item 'drums
-To typeset a typical drum kit on a five-line staff.
+to typeset a typical drum kit on a five-line staff:
@lilypond[noindent]
\include "drumpitch-init.ly"
@end lilypond
The drum scheme supports six different toms. When there fewer toms, simply
-select the toms that produce the desired result, i.e., to get toms on
+select the toms that produce the desired result, i.e. to get toms on
the three middle lines you use @code{tommh}, @code{tomml} and
@code{tomfh}.
Because general MIDI does not contain rimshots the sidestick is used
for this purpose instead.
@item 'timbales
-To typeset timbales on a two line staff.
+to typeset timbales on a two line staff:
@lilypond[singleline]
\include "drumpitch-init.ly"
}
@end lilypond
@item 'congas
-To typeset congas on a two line staff.
+to typeset congas on a two line staff:
@lilypond[singleline]
\include "drumpitch-init.ly"
}
@end lilypond
@item 'bongos
-To typeset bongos on a two line staff.
+to typeset bongos on a two line staff:
@lilypond[singleline]
\include "drumpitch-init.ly"
}
@end lilypond
@item 'percussion
-To typeset all kinds of simple percussion on one line staves.
+to typeset all kinds of simple percussion on one line staves:
@lilypond[singleline]
\include "drumpitch-init.ly"
nam = \lyrics { tri trio trim gui guis guil cb cl tamb cab mar hc }
The file @file{drumpitch-init.ly} replaces the normal pitch names, so
you have to reinclude @file{nederlands.ly} after the
-drum-pattern-definitions to enter normal notes.
+drum-pattern-definitions to enter normal notes:
@c
@lilypond[singleline,verbatim]
\include "drumpitch-init.ly"
terminating too soon.
+@seealso
+
+@internalsref{AutoChangeMusic}
+
@refbugs
The staff switches often do not end up in optimal places. For high
Piano pedal instruction can be expressed by attaching
@code{\sustainDown}, @code{\sustainUp}, @code{\unaCorda},
@code{\treCorde}, @code{\sostenutoDown} and @code{\sostenutoUp} to a
-note or chord.
+note or chord:
@lilypond[fragment,verbatim]
c'4-\sustainDown c'4-\sustainUp
For fine-tuning of the appearance of a pedal bracket, the properties
@code{edge-width}, @code{edge-height}, and @code{shorten-pair} of
-@code{PianoPedalBracket} objects (see the detailed documentation of
-@internalsref{PianoPedalBracket}) can be modified. For example, the bracket
-may be extended to the end of the note head.
+@code{PianoPedalBracket} objects (, see the detailed documentation of
+@internalsref{PianoPedalBracket},) can be modified. For example, the bracket
+may be extended to the end of the note head:
@lilypond[fragment,verbatim]
\property Staff.PianoPedalBracket \override
@cindex @code{\arpeggio}
You can specify an arpeggio sign on a chord by attaching an
-@code{\arpeggio} to a chord.
+@code{\arpeggio} to a chord:
@lilypond[fragment,relative,verbatim]
When an arpeggio crosses staves, you attach an arpeggio to the chords
in both staves, and set
-@internalsref{PianoStaff}.@code{connectArpeggios}.
+@internalsref{PianoStaff}.@code{connectArpeggios}:
@lilypond[fragment,relative,verbatim]
\context PianoStaff <
The direction of the arpeggio is sometimes denoted by adding an
arrowhead to the wiggly line. This can be typeset by setting
-@code{arpeggio-direction}.
+@code{arpeggio-direction}:
@lilypond[fragment,relative,verbatim]
\context Voice {
arpeggiate the chord. To draw these brackets, set the
@code{molecule-callback} property of @code{Arpeggio} or
@code{PianoStaff.Arpeggio} objects to @code{\arpeggioBracket}, and use
-@code{\arpeggio} statements within the chords as before.
+@code{\arpeggio} statements within the chords as before:
@lilypond[fragment,relative,verbatim]
\property PianoStaff.Arpeggio \override
@cindex @code{\arpeggioBracket }
@code{\arpeggioBracket},
@cindex @code{\arpeggio}
-@code{\arpeggio},
+@code{\arpeggio}.
@seealso
@cindex @code{\showStaffSwitch }
@code{\showStaffSwitch},
@cindex @code{\hideStaffSwitch }
-@code{\hideStaffSwitch},
+@code{\hideStaffSwitch}.
@node Vocal music
Subsequent characters of a word can be any character that is not a digit
and not white space. One important consequence of this is that a word
can end with @code{@}}. The following example is usually a bug. The
-syllable includes a @code{@}}, and hence the opening brace is not balanced.
+syllable includes a @code{@}}, and hence the opening brace is not balanced:
@example
\lyrics @{ twinkle@}
@end example
@node The Lyrics context
@subsection The Lyrics context
-Lyrics are printed by interpreting them in @internalsref{Lyrics}
-context:
+Lyrics are printed by interpreting them in @internalsref{Lyrics} context:
@example
\context Lyrics \lyrics @dots{}
@end example
entered. The lyrics can also be aligned under a given melody
automatically. In this case, it is no longer necessary to enter the
correct duration for each syllable. This is achieved by combining the
-melody and the lyrics with the @code{\addlyrics} expression
+melody and the lyrics with the @code{\addlyrics} expression:
@example
\addlyrics
\notes @dots{}
done automatically when corresponding lyric lines and melodies are
marked.
-To this end, give the @internalsref{Voice} context an identity,
+To this end, give the @internalsref{Voice} context an identity:
@example
\context Voice = duet @{
\time 3/4
Then set the @internalsref{LyricsVoice} contexts to names starting with
that identity followed by a dash. In the preceding example, the
@internalsref{Voice} identity is @code{duet}, so the identities of the
-@internalsref{LyricsVoices} are marked @code{duet-1} and @code{duet-2}.
+@internalsref{LyricsVoices} are marked @code{duet-1} and @code{duet-2}:
@example
\context LyricsVoice = "duet-1" @{
Hi, my name is bert. @}
@internalsref{Voice} must also be used to get melismata correct in
conjunction with rests.
-The complete example is shown here.
+The complete example is shown here:
@lilypond[singleline,verbatim]
\score {
\addlyrics
Stanza numbers, or the names of the singers can be added by setting
@code{LyricsVoice.Stanza} (for the first system) and
@code{LyricsVoice.stz} for the following systems. Notice how dots are
-surrounded with spaces in @code{\lyrics} mode.
+surrounded with spaces in @code{\lyrics} mode:
@example
\property LyricsVoice . stanza = "Bert"
string. By default, string 1 is the highest one, and the tuning
defaults to the standard guitar tuning (with 6 strings). The notes
are printed as tablature, by using @internalsref{TabStaff} and
-@internalsref{TabVoice} contexts.
+@internalsref{TabVoice} contexts:
@lilypond[fragment,verbatim]
\notes \context TabStaff {
When no string is specified, the first string that does not give a
fret number less than @code{minimumFret} is selected. The default
-value for @code{minimumFret} is 0.
+value for @code{minimumFret} is 0:
@example
being the pitch (measured in semitones relative to central C) of an
open string. The numbers specified for @code{stringTuning} are the
numbers of semitones to subtract or add, starting the specified pitch
-by default middle C, in string order: thus the notes are e, a, d, and
-g.
+by default middle C, in string order. Thus, the notes are e, a, d, and
+g:
@lilypond[fragment,verbatim]
\context TabStaff <
note text. The default is @code{fret-number-tablature-format}, which
uses the fret number. For instruments that do not use this notation,
you can create a special tablature formatting function. This function
-takes three argument: the string number, the string tuning and the
-note pitch.
+takes three argument: string number, string tuning and note pitch.
@refbugs
LilyPond has support for both printing chord names. Chords may be
entered in musical chord notation, i.e. @code{<< .. >>}, but they can
also be entered by name. Internally, the chords are represented as a
-set of pitches, so they can be transposed.
+set of pitches, so they can be transposed:
@lilypond[verbatim,singleline]
Chord mode is a mode where you can input sets of pitches using common
names. It is introduced by the keyword @code{\chords}.
In chords mode, a chord is entered by the root, which is entered
-like a common pitch, for example,
+like a common pitch:
@lilypond[fragment,verbatim,quote, relative=1]
\chords { es4. d8 c2 }
@end lilypond
@cindex chord mode
Other chords may be entered by suffixing a colon, and introducing a
-modifier, and optionally, a number, for example
+modifier, and optionally, a number:
@c
@lilypond[fragment,verbatim,quote]
\chords { e1:m e1:7 e1:m7 }
@end lilypond
The first number following the root is taken to be the `type' of the
chord, thirds are added to the root until it reaches the specified
-number, for example.
+number:
@lilypond[fragment,verbatim]
\chords { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 }
@end lilypond
More complex chords may also be constructed adding separate steps
to a chord. Additions are added after the number following
-the colon, and are separated by dots. For example
+the colon, and are separated by dots:
@c
@lilypond[verbatim,fragment,quote]
\chords { c:5.6 c:3.7.8 c:3.6.13 }
@end lilypond
Chord steps can be altered by suffixing a @code{-} or @code{+} sign
-to the number, for example:
+to the number:
@lilypond[verbatim,fragment,quote]
\chords { c:7+ c:5+.3- c:3-.5-.7- }
@end lilypond
Removals are specified similarly, and are introduced by a caret. They
-must come after the additions.
+must come after the additions:
@lilypond[verbatim,fragment]
\chords { c^3 c:7^5 c:9^3.5 }
@end lilypond
Modifiers can be used to change pitches. The following modifiers are
-supported
+supported:
@table @code
@item m
is the minor chord. This modifier lowers the 3rd and (if present) the 7th step.
@item dim
is the diminished chord. This modifier lowers the 3rd, 5th and (if present)
- the 7th step
+ the 7th step.
@item aug
is the augmented chord. This modifier raises the 5th step.
@item maj
step. Append either @code{2} or @code{4} to add the 2nd or 4th step to
the chord.
@end table
-Modifiers can be mixed with additions.
+Modifiers can be mixed with additions:
@lilypond[verbatim,fragment]
\chords { c:sus4 c:7sus4 c:dim7 c:m6 }
@end lilypond
@cindex @code{sus}
@cindex @code{m}
-Since the unaltered 11 does sound well when combined with the
-unaltered 3, the 11 is removed in this case, unless it is added
-explicitly). For example,
+Since an unaltered 11 does not sound good when combined with an
+unaltered 13, the 11 is removed in this case (, unless it is added
+explicitly):
@lilypond[fragment,verbatim]
\chords { c:13 c:13.11 c:m13 }
@end lilypond
An inversion (putting one pitch of the chord on the bottom), as well
as bass notes, can be specified by appending
-@code{/}@var{pitch} to the chord.
+@code{/}@var{pitch} to the chord:
@lilypond[fragment,verbatim,center]
\chords { c1 c/g c/f }
@end lilypond
Each step can only be present in a chord once. The following
simply produces the augmented chord, since @code{5+} is interpreted
-last.
+last:
@cindex clusters
@lilypond[verbatim,fragment]
\chords { c:5.5-.5+ }
@cindex chord names
@cindex chords
-For displaying printed chord names, use the @internalsref{ChordNames}
-context. The chords may be entered either using the notation
-described above, or directly using @code{<<} and @code{>>}.
+For displaying printed chord names, use the @internalsref{ChordNames} context.
+The chords may be entered either using the notation
+described above, or directly using @code{<<} and @code{>>}:
@lilypond[verbatim,singleline]
scheme = \notes {
You can make the chord changes stand out by setting
@internalsref{ChordNames}.@code{chordChanges} to true. This will only
display chord names when there is a change in the chords scheme and at
-the start of a new line.
+the start of a new line:
@lilypond[verbatim, linewidth=9cm]
scheme = \chords {
@end lilypond
The default chord name layout is a system for Jazz music, proposed by
-Klaus Ignatzek (See @ref{Literature}). It can be tuned through the
+Klaus Ignatzek (see @ref{Literature}). It can be tuned through the
following properties:
@table @code
@cindex @code{\germanChords }
@code{\germanChords},
@cindex @code{\semiGermanChords }
-@code{\semiGermanChords},
+@code{\semiGermanChords}.
Bar numbers can be typeset at regular intervals instead of at the
beginning of each line. This is illustrated in the following example,
whose source is available as
-@inputfileref{input/test,bar-number-every-fifth.ly}
+@inputfileref{input/test,bar-number-regular-interval.ly}
-@lilypondfile[notexidoc]{bar-number-every-fifth.ly}
-
-The start of that numbering can also be reset, as demonstrated in
-@inputfileref{input/test,bar-number-every-five-reset.ly}.
-
-@lilypondfile[notexidoc]{bar-number-every-five-reset.ly}
+@lilypondfile[notexidoc]{bar-number-regular-interval.ly}
@seealso
@internalsref{BarNumber}.
@inputfileref{input/test,bar-number-every-five-reset.ly}.
-@inputfileref{input/test,bar-number-every-fifth.ly}
+@inputfileref{input/test,bar-number-regular-interval.ly}
@refbugs
Bar numbers can collide with the @internalsref{StaffGroup} bracket, if
-there is one at the top. To solve this, You have to twiddle with the
-@internalsref{padding} property of @internalsref{BarNumber} if your
-score starts with a @internalsref{StaffGroup}.
+there is one at the top. To solve this, In that case, the
+@internalsref{padding} property of @internalsref{BarNumber} can be
+used to position the number correctly.
@node Instrument names
@subsection Instrument names
R1*13/8*12
@end lilypond
-A @code{R} spanning a single measure is printed as a whole rest
-centered in the measure (or a breve when the measure lasts longer than
-two whole notes), regardless of the time signature.
-
-
+A @code{R} spanning a single measure is printed as either a whole rest
+or a breve, centered in the measure regardless of the time signature.
@cindex text on multi-measure rest
@cindex script on multi-measure rest
R1*4 cis cis
@end example
will enter two notes lasting four measures each. When @code{skipBars}
-is set, then the result will look OK6, but the bar numbering will be
+is set, then the result will look OK, but the bar numbering will be
off.
@node Automatic part combining
@node Frenched scores
@subsection Frenched scores
-In orchestral scores, staff lines that only have rests are usually removed.
-This saves some space. This style is called `French Score'.
+In orchestral scores, staff lines that only have rests are usually
+removed. This saves some space. This style is called `French Score'.
+For @internalsref{Lyrics}, @internalsref{LyricsVoice},
+@internalsref{ChordNames} and @internalsref{FiguredBass}, this is
+switched on by default. When these line of these contexts turn out
+empty after the line-breaking process, they are removed.
-@syntax
-This is supported through the @code{RemoveEmptyStaff}. This staff is
-removed when it turns out empty (or containing multimeasure rests)
-after the line-breaking process.
+For normal staffs, a specialized @internalsref{Staff} context is
+available, which does the same: staffs containing nothing (or only
+multi measure rests) are removed. The context definition is stored in
+@code{\RemoveEmptyStaffContext} variable. Observe how the second staff
+in this example disappears in the second line.
-For @internalsref{Lyrics}, @internalsref{LyricsVoice},
-@internalsref{ChordNames} and @internalsref{FiguredBass}, this is
-switched on by default. For normal staffs, it is available as a
-specialized @internalsref{Staff} context, with the name variable
-@code{\RemoveEmptyStaffContext}. Observe how the second staff in this
-example disappears in the second line.
@lilypond[verbatim]
\score {
forerunner of the Editio Vaticana). As soon as Hufnagel ligature
engraver and Medicaea ligature engraver will have been implemented, it
will be as simple as replacing the ligature engraver in the
-VoiceContext to get the desired notation style from the same input.
+@internalsref{Voice} context to get the desired notation style from
+the same input.
The following table shows the code fragments that produce the
ligatures in the above neumes table. The letter in the first column
introduced with @code{[} and @code{]}.
@example
- < [4 6] 8 [_ 12]>
+ < [4 6] 8 [_! 12]>
@end example
@lilypond[fragment]
\context FiguredBass
-\figures { < [4 6] 8 [_ 12]> }
+\figures { < [4 6] 8 [_! 12]> }
@end lilypond
Although the support for figured bass may superficially resemble chord
cluster-notes. Cluster notes are created by applying the function
@code{notes-to-clusters} to a sequence of chords, eg.
@c
-@lilypond[relative 2]
- \apply #notes-to-clusters { << c e >> <<b f'>> }
+@lilypond[relative 1,verbatim]
+ \apply #notes-to-clusters { <<c e >> <<b f'>> }
@end lilypond
The following example (from
@lilypond[singleline]
\score {
- < \notes {
- \fatText
+ < \addlyrics \notes {
b'
^\shortfermata
_\shortfermata
sufficient. In this section we discuss ways to override these
defaults.
-Formatting is internally done by manipulating so called objects (graphic
-objects). Each object carries with it a set of properties (object
-properties) specific to that object. For example, a stem object has
-properties that specify its direction, length and thickness.
+Formatting is internally done by manipulating so called objects
+(graphic objects). Each object carries with it a set of properties
+(object or layout properties) specific to that object. For example, a
+stem object has properties that specify its direction, length and
+thickness.
The most direct way of tuning the output is by altering the values of
these properties. There are two ways of doing that: first, you can
temporarily change the definition of one type of object, thus
affecting a whole set of objects. Second, you can select one specific
-object, and set a object property in that object.
+object, and set a layout property in that object.
+
+Do not confuse layout properties with translation
+properties. Translation properties always use a mixed caps style
+naming, and are manipulated using @code{\property}
+@example
+ \property Context.propertyName = @var{value}
+@end example
+Layout properties are use Scheme style variable naming, i.e. lower
+case words separated with dashes. They are symbols, and should always
+be quoted using @code{#'}. For example, this could be an imaginary
+layout property name:
+@example
+ #'layout-property-name
+@end example
@menu
* Tuning objects ::
@cindex object description
-The definition of an object is actually a list of default object
+The definition of an object is a list of default object
properties. For example, the definition of the Stem object (available
-in @file{scm/define-grobs.scm}), includes the following definitions for
-@internalsref{Stem}
+in @file{scm/define-grobs.scm}), includes the following definitions
+for @internalsref{Stem}
@example
(thickness . 1.3)
@end example
-By adding variables on top of these existing definitions, the system
-default is overridden, and the appearance of a layout objects is
-altered.
+Adding variables on top of this existing definition overrides the
+system default, and alters the resulting appearance of the layout
+object.
@syntax
-Changing a variable for only one object is commonly achieved with
+Changing a variable for only one object is commonly achieved with
@code{\once}:
@example
@end example
@c
All @code{\override} and @code{\revert} commands should be balanced.
-The @code{\set} shorthand, performs a revert followed by an override,
+The @code{\set} shorthand performs a revert followed by an override,
and is often more convenient to use
@example
effect. However, if the setting was set as a system default, this may
remove the default value, and this may give surprising results,
including crashes. In other words, @code{\override} and
-@code{\revert} must be carefully balanced.
-
-These are examples of correct nesting of @code{\override}, @code{\set},
-@code{\revert}.
+@code{\revert} must be carefully balanced. The following are examples
+of correct nesting of @code{\override}, @code{\set}, @code{\revert}.
+@itemize @bullet
+@item
A clumsy but correct form:
@example
\override \revert \override \revert \override \revert
@end example
+@item
Shorter version of the same:
@example
\override \set \set \revert
@end example
+@item
A short form, using only @code{\set}. This requires you to know the
default value:
@example
\set \set \set \set @var{to default value}
@end example
+@item
If there is no default (i.e. by default, the object property is unset),
then you can use
@example
\set \set \set \revert
@end example
+@end itemize
For the digirati, the object description is an Scheme association
list. Since a Scheme list is a singly linked list, we can treat it as
-Using @code{\override} and @code{\set}, requires three pieces of
-information: the name of the layout object, the context and the name
+Three pieces of information are required to use @code{\override} and
+@code{\set}: the name of the layout object, the context and the name
of the property. We demonstrate how to glean this information from
the notation manual and the generated documentation.
The generated documentation is a set of HTML pages which should be
included if you installed a binary distribution, typically in
@file{/usr/share/doc/lilypond}. They are also available on the web:
-go to the @uref{LilyPond website,http://lilypond.org}, click
-``Documentation: Index'' on the side bar, look in the ``Information
-for users'' section, and click on ``Documentation of internals.'' It
-is advisable to bookmark either the local HTML files if possilbe. They
+go to the @uref{http://lilypond.org,LilyPond website}, click
+``Documentation'', and then ``Program reference'' on the side bar. It
+is advisable to bookmark either the local HTML files if possible. They
will load faster than the ones on the web. If you use the version
from the web, you must check whether the documentation matches the
program version: the documentation is generated from the definitions
Suppose we want to move the fingering indication in the fragment below
-@lilypond[relative=2]
+@lilypond[relative=2,verbatim]
c-2
\stemUp
f
@internalsref{FingerEvent} and @internalsref{Fingering}.
@end quotation
-This implies that the fingerings, once entered, are internally stored
-as @code{FingerEvent} music objects. When printed, a @code{Fingering}
+@noindent
+In other words, the fingerings once entered, are internally stored as
+@code{FingerEvent} music objects. When printed, a @code{Fingering}
layout object is created for every @code{FingerEvent}.
-@ifhtml
-When we follow the link of @internalsref{Fingering},
-@end ifhtml
-@ifnothtml
-When we look up @internalsref{Fingering} in the generated
-documentation,
-@end ifnothtml
-we see a list of interfaces. The Fingering object has a number of
-different functions, and each of those is captured in an interface.
+The Fingering object has a number of different functions, and each of
+those is captured in an interface. when we look up
+@internalsref{Fingering} in the generated documentation.
+
+
The @code{Fingering} object has a fixed size
(@internalsref{item-interface}), the symbol is a piece of text
For the vertical placement, we have to look under
@code{side-position-interface}.
@quotation
- side-position-interface
+@code{side-position-interface}
Position a victim object (this one) next to other objects (the
support). In this case, the direction signifies where to put the
\once \property Voice.Fingering \set #'padding = #3
@end example
-Before the object is created, we get
-@lilypond[relative=2,fragment]
+Inserting this command before the Fingering object is created,
+i.e. before @code{c2}, yields the following result.
+
+@lilypond[relative=2,fragment,verbatim]
\once \property Voice.Fingering
\set #'padding = #3
c-2
an @emph{engraver}. The documentation of the @code{Fingering_engraver}
says
@example
-Fingering_engraver is part of contexts: Voice and TabVoice
+Fingering_engraver is part of contexts: Voice
@end example
-so tuning the settings for Fingering should be done using either
+so tuning the settings for Fingering should be done with
@example
\property Voice.Fingering \set @dots{}
@end example
-or
-@example
- \property TabVoice.Fingering \set @dots{}
-@end example
-
-Since the @code{TabVoice} is only used for tab notation, we see that
-the first guess @code{Voice} was indeed correct.
Of course, the tweak may also done in a larger context than
@code{Voice}, for example, @internalsref{Staff} or
@node Applyoutput
@subsection Applyoutput
-The most versatile way of tuning object is @code{\applyoutput}. Its
+The most versatile way of tuning an object is @code{\applyoutput}. Its
syntax is
@example
\applyoutput @var{proc}
@end example
+
+@noindent
where @var{proc} is a Scheme function, taking four arguments.
When interpreted, the function @var{proc} is called for every layout object found
@refbugs
-If possible, avoid this feature: the semantics are not very clean, and
-the syntax and semantics are up for rewrite.
+This command is slated for removal. Please use the
+@code{\applyoutput} command, see @ref{Applyoutput}.
@node Font selection
@subsection Font selection
-The most common thing to change about the appearance of fonts is
-their size. The font size of any context can be easily
-changed by setting the @code{fontSize} property for that context:
+The most common thing to change about the appearance of fonts is their
+size. The font size of any context can be easily changed by setting
+the @code{fontSize} property for that context. Its value is an
+integer: negative numbers make the font smaller, positive numbers
+larger. An example is given below.
@c
@lilypond[fragment,relative=1,verbatim,quote]
c4 c4 \property Voice.fontSize = #-1
f4 g4
@end lilypond
- This command will set @code{font-relative-size} (see below),
- and does not change the size of variable symbols, such as
-beams or slurs. You can use this command to get smaller symbol for
-cue notes, but that involves some more subtleties. An elaborate
-example of those is in @inputfileref{input/test,cue-notes.ly}.
+This command will set @code{font-relative-size} (see below), and does
+not change the size of variable symbols, such as beams or slurs.
+
+
+One of the uses of @code{fontSize} is to get smaller symbol for cue
+notes. An elaborate example of those is in
+@inputfileref{input/test,cue-notes.ly}.
@cindex magnification
\property Staff.TimeSignature
\set #'font-name = #"cmr17"
@end example
-You may use any font which is available to @TeX{}, such as foreign
-fonts or fonts that do not belong to the Computer Modern font family.
+
+@noindent
+Any font can be used, as long as it is available to @TeX{}. Possible
+fonts include foreign fonts or fonts that do not belong to the
+Computer Modern font family.
Font selection for the standard fonts, @TeX{}'s Computer Modern fonts,
can also be adjusted with a more fine-grained mechanism. By setting
@code{*}, entered as @code{#'*}), acts as a wildcard. This can be used
to override default setting, which are always present. For example:
@example
- \property Lyrics.LyricText \override #'font-series = #'bold
- \property Lyrics.LyricText \override #'font-family = #'typewriter
- \property Lyrics.LyricText \override #'font-shape = #'*
+ \property Lyrics . LyricText \override #'font-series = #'bold
+ \property Lyrics . LyricText \override #'font-family = #'typewriter
+ \property Lyrics . LyricText \override #'font-shape = #'*
@end example
@cindex @code{font-style}
@cindex font switching
-The line of the example demonstrates font switching commands. The
-command only apply to the first following word; enclose a set of texts
-with braces to apply a command to more words.
+The markup in the example demonstrates font switching commands. The
+command @code{\bold} and @code{\italic} only apply to the first
+following word; enclose a set of texts with braces to apply a command
+to more words.
@example
\markup @{ \bold @{ hi there @} @}
@end example
+
+@noindent
For clarity, you can also do this for single arguments, e.g.
@example
\markup @{ is \italic @{ anyone @} home @}
This produces a single character, e.g. @code{\char #65} produces the
letter 'A'.
-@item \note
-@cindex @code{\note @var{log} @var{dots} @var{dir}}
+@item \note @var{log} @var{dots} @var{dir}
+@cindex @code{\note}
This produces a note with a stem pointing in @var{dir} direction, with
-duration log @var{log} and @var{dots} augmentation dots.
+duration log @var{log} and @var{dots} augmentation dots. The duration
+log is the negative 2-logarithm of the duration denominator. For
+example, a quarter note has log 2, an eighth note 3 and a breve has
+log -1.
@item \hspace #@var{amount}
@cindex @code{\hspace}
\score @{ ... @}
@end example
-The font definitions are generated using a Scheme function. For more
-details, see the file @file{scm/font.scm}.
-
+The default font size settings for each staff heights are generated
+from the 20pt style sheet. For more details, see the file
+@file{scm/font.scm}.
+l
@node Line breaking
@cindex regular line breaks
@cindex four bar music.
-If you want linebreaks at regular intervals, you can use the following:
+For linebreaks at regular intervals use @code{\break} separated by
+skips and repeated with @code{\repeat}:
@example
< \repeat unfold 7 @{ s1 * 4 \break @}
@emph{the real music}
>
@end example
+
+@noindent
This makes the following 28 measures (assuming 4/4 time) be broken every
4 measures.
@refbugs
-There is no concept of page breaking, which makes it difficult to
-choose sensible page breaks in multi-page pieces.
+LilyPond has no concept of page layout, which makes it difficult to
+reliably choose page breaks in longer pieces.
their two extremities. The fractions be adjusted by
@code{dynamicAbsoluteVolumeFunction} in @internalsref{Voice} context.
For each type of MIDI instrument, a volume range can be defined. This
-gives you basic equalizer control, which can enhance the quality of
+gives a basic equalizer control, which can enhance the quality of
the MIDI output remarkably. The equalizer can be controlled by
setting @code{instrumentEqualizer}.