@seealso
-Internals: @rinternals{OverrideProperty}, @rinternals{RevertProperty},
-@rinternals{PropertySet}, @rinternals{Backend}, and
+Internals:
+@rinternals{OverrideProperty},
+@rinternals{RevertProperty},
+@rinternals{PropertySet},
+@rinternals{Backend},
@rinternals{All layout objects}.
Learning Manual:
@rlearning{An extra staff appears}.
+
@node Distances and measurements
@subsection Distances and measurements
@seealso
-Internals Reference: @rinternals{TextSpanner},
-@rinternals{Glissando}, @rinternals{VoiceFollower},
+Internals Reference:
+@rinternals{TextSpanner},
+@rinternals{Glissando},
+@rinternals{VoiceFollower},
@rinternals{TrillSpanner},
@rinternals{line-spanner-interface}.
where there is no line break, or after a line break.
Alternatively, these eight combinations may be specified
-by pre-defined functions, defined in @file{scm/output-lib.scm},
+by pre-defined functions, defined in @file{scm/@/output@/-lib@/.scm},
where the last three columns indicate whether the layout objects
will be visible in the positions shown at the head of the columns:
@ref{Input modes}.
Snippets:
-@rlsr{Chords}
+@rlsr{Chords}.
@knownissues
Snippets:
@rlsr{Chords}.
+
@knownissues
Only one quality modifier should be used per chord, typically on the
highest step present in the chord. Chords with more than quality
@ref{Common chord modifiers}.
Snippets:
-@rlsr{Chords}
+@rlsr{Chords}.
@knownissues
@rglos{figured bass}.
Snippets:
-@rlsr{Chords}
+@rlsr{Chords}.
@node Entering figured bass
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{making-slurs-with-complex-dash-structure.ly}
+
@seealso
Music Glossary:
@rglos{slur}.
@seealso
Installed Files:
-@file{scm/output-lib.scm}.
+@file{scm/@/output@/-lib@/.scm}.
Snippets:
@rlsr{Fretted strings}.
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{chordchanges-for-fretboards.ly}
+
@seealso
Notation Reference:
@ref{Custom tablatures},
@ref{Predefined fretboard diagrams}.
Installed Files:
-@file{ly/predefined-guitar-fretboards.ly},
-@file{ly/predefined-guitar-ninth-fretboards.ly}.
+@file{ly/@/predefined@/-guitar@/-fretboards@/.ly},
+@file{ly/@/predefined@/-guitar@/-ninth@/-fretboards@/.ly}.
Snippets:
@rlsr{Fretted strings}.
Sometimes the fretboard calculator will be unable to find
-an accceptable diagram. This can often be remedied by
+an acceptable diagram. This can often be remedied by
manually assigning a note to a string. In many cases, only one
note need be manually placed on a string; the rest of
the notes will then be placed appropriately by the @code{FretBoards}
Snippets:
@rlsr{Fretted strings}.
-The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
+Installed Files:
+@file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
toplevel scores, and combined as a single @code{\book}.
This behavior can be changed by setting the variable
@code{toplevel-score-handler} at toplevel. The default handler is
-defined in the init file @file{../scm/@/lily@/.scm}.
+defined in the init file @file{../@/scm/@/lily@/.scm}.
@item
A @code{\book} block logically combines multiple movements
or @code{\markup} in the same example. This behavior can be
changed by setting the variable @code{toplevel-book-handler} at
toplevel. The default handler is defined in the init file
-@file{../scm/@/lily@/.scm}.
+@file{../@/scm/@/lily@/.scm}.
@item
A @code{\bookpart} block. A book may be divided into several parts,
This behavior can be changed by setting the variable
@code{toplevel-music-handler} at toplevel. The default handler is
-defined in the init file @file{../scm/@/lily@/.scm}.
+defined in the init file @file{../@/scm/@/lily@/.scm}.
@item
A markup text, a verse for example
@end itemize
+
@seealso
Learning Manual:
@rlearning{How LilyPond input files work}.
A more advanced option is to change the definitions of the following
variables in the @code{\paper} block. The init file
-@file{../ly/titling-init.ly} lists the default layout.
+@file{../@/ly/@/titling@/-init@/.ly} lists the default layout.
@table @code
@funindex bookTitleMarkup
@seealso
-Init files: @file{../ly/@/toc@/-init@/.ly}.
+Init files: @file{../@/ly/@/toc@/-init@/.ly}.
@predefined
Context definitions follow precisely the same syntax as those
within a @code{\layout} block. Translation modules for sound are
called performers. The contexts for MIDI output are defined in
-@file{../ly/@/performer@/-init@/.ly},
+@file{../@/ly/@/performer@/-init@/.ly},
see @rlearning{Other sources of information}.
For example, to remove the effect of dynamics
from the MIDI output, insert the following lines in the
MIDI volume range. The default fractions range from 0.25 for
@notation{ppppp} to 0.95 for @notation{fffff}. The set of dynamic
marks and the associated fractions can be seen in
-@file{../scm/midi.scm}, see @rlearning{Other sources of information}.
+@file{../@/scm/@/midi.scm}, see @rlearning{Other sources of information}.
This set of fractions may be changed or extended by providing a
function which takes a dynamic mark as its argument and returns the
required fraction, and setting
Alternatively, if the whole table of fractions needs to be
redefined, it would be better to use the
@notation{default-dynamic-absolute-volume} procedure in
-@file{../scm/midi.scm} and the associated table as a model.
+@file{../@/scm/@/midi.scm} and the associated table as a model.
The final example in this section shows how this might be done.
@unnumberedsubsubsec Overall MIDI volume
LilyPond will, by default, apply a small degree of equalization
to a few instruments. The instruments and the equalization
applied are shown in the table @notation{instrument-equalizer-alist}
-in @file{../scm/midi.scm}.
+in @file{../@/scm/@/midi.scm}.
This basic default equalizer can be replaced by setting
@code{instrumentEqualizer} in the @code{Score} context to a new
is done in the same way as shown for resetting the
@code{dynamicAbsoluteVolumeFunction} at the start of this section.
The default equalizer, @notation{default-instrument-equalizer}, in
-@file{../scm/midi.scm} shows how such a procedure might be written.
+@file{../@/scm/@/midi.scm} shows how such a procedure might be written.
The following example sets the relative flute and clarinet volumes
to the same values as the previous example.
@ref{Glissando}.
@item A @notation{bisbigliando} is written as a tremelo @ref{Tremolo
-repeats}
+repeats}.
@item Natural harmonics are covered under @ref{Harmonics}.
@seealso
Notation Reference:
-@ref{Tremolo repeats}
-@ref{Glissando}
-@ref{Arpeggio}
-@ref{Harmonics}
+@ref{Tremolo repeats},
+@ref{Glissando},
+@ref{Arpeggio},
+@ref{Harmonics}.
@node Harp pedals
@unnumberedsubsubsec Harp pedals
@lilypond[quote,verbatim,relative=2]
\textLengthOn
-cis1_\markup \concat \vcenter { [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
-c!1_\markup \concat \vcenter {[ C \natural ]}
+cis1_\markup \concat \vcenter {
+ [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
+c!1_\markup \concat \vcenter {
+ [ C \natural ] }
@end lilypond
or pedal diagrams:
@seealso
Notation Reference:
-@ref{Text scripts}
-@ref{Instrument Specific Markup}
+@ref{Text scripts},
+@ref{Instrument Specific Markup}.
A set of glyphs with a single style and shape comprise a font, and
a set of fonts covering several styles and sizes comprise a typeface.
+
@seealso
Notation Reference:
@ref{Fonts},
@ref{Text encoding}.
+
@node grob
@unnumberedsubsec grob
etc are called @q{Layout objects}, often known as @q{GRaphical
OBjects}, or @strong{grobs} for short.
+
@seealso
Learning Manual:
@rlearning{Objects and interfaces},
Internals Reference:
@rinternals{All layout objects}.
+
@node interface
@unnumberedsubsec interface
grouped together in an object called a @code{grob-interface}, or
just @q{interface} for short.
+
@seealso
Learning Manual:
@rlearning{Objects and interfaces},
Internals Reference:
@rinternals{Graphical Object Interfaces}.
+
@node lexer
@unnumberedsubsec lexer
@ref{Instantiating new staves}.
@ref{Percussion in MIDI}.
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
@node Basic percussion notation
@seealso
-Notation Reference: @ref{Percussion in MIDI}, @ref{Percussion notes}.
+Notation Reference:
+@ref{Percussion in MIDI},
+@ref{Percussion notes}.
-File: @file{ly/@/drumpitch@/-init@/.ly}
+File:
+@file{ly/@/drumpitch@/-init@/.ly}
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
@node Drum rolls
@seealso
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
@node Pitched percussion
@c TODO: possibly link to an alternate section of NR 3.5, if
@c "percussion in MIDI" gets a separate subsubsection for
@c pitched percussion sounds. -gp
-Notation Reference: @ref{Percussion in MIDI}.
+Notation Reference:
+@ref{Percussion in MIDI}.
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
@node Percussion staves
}
@end lilypond
-Here an short example by maestro Stravinsky (from @q{L'histoire du Soldat})
+Here a short example taken from Stravinsky's @q{L'histoire du Soldat}.
@lilypond[quote,verbatim]
#(define mydrums '((bassdrum default #t 4)
@seealso
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
-Internals Reference: @rinternals{DrumStaff}, @rinternals{DrumVoice}.
+Internals Reference:
+@rinternals{DrumStaff},
+@rinternals{DrumVoice}.
@c TODO: check name -gp
@seealso
-Snippets: @rlsr{Percussion}.
+Snippets:
+@rlsr{Percussion}.
@seealso
Notation Reference:
-@ref{Mensural clefs}, @ref{Gregorian clefs}.
+@ref{Mensural clefs},
+@ref{Gregorian clefs}.
Snippets:
@rlsr{Pitches}.
@rglos{transposing instrument}.
Notation Reference:
-@ref{Quoting other voices}, @ref{Transpose}.
+@ref{Quoting other voices},
+@ref{Transpose}.
Snippets:
@rlsr{Pitches}.
Internals Reference:
@rinternals{Accidental},
@rinternals{Accidental_engraver},
-@rinternals{GrandStaff} and
+@rinternals{GrandStaff},
@rinternals{PianoStaff},
@rinternals{Staff},
@rinternals{AccidentalSuggestion},
@seealso
-Music Glossary: @rglos{repeat}, @rglos{volta}.
+Music Glossary:
+@rglos{repeat},
+@rglos{volta}.
-Notation Reference: @ref{Bar lines}, @ref{Modifying context plug-ins}.
+Notation Reference:
+@ref{Bar lines},
+@ref{Modifying context plug-ins}.
-Snippets: @rlsr{Repeats}.
+Snippets:
+@rlsr{Repeats}.
-Internals Reference: @rinternals{VoltaBracket},
-@rinternals{RepeatedMusic}, @rinternals{VoltaRepeatedMusic},
+Internals Reference:
+@rinternals{VoltaBracket},
+@rinternals{RepeatedMusic},
+@rinternals{VoltaRepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.
@seealso
-Snippets: @rlsr{Repeats}.
+Snippets:
+@rlsr{Repeats}.
-Internals Reference: @rinternals{RepeatedMusic},
+Internals Reference:
+@rinternals{RepeatedMusic},
@rinternals{UnfoldedRepeatedMusic}.
@seealso
-Music Glossary: @rglos{percent repeat}, @rglos{simile}.
+Music Glossary:
+@rglos{percent repeat},
+@rglos{simile}.
-Snippets: @rlsr{Repeats}.
+Snippets:
+@rlsr{Repeats}.
-Internals Reference: @rinternals{RepeatSlash},
-@rinternals{PercentRepeat}, @rinternals{DoublePercentRepeat},
+Internals Reference:
+@rinternals{RepeatSlash},
+@rinternals{PercentRepeat},
+@rinternals{DoublePercentRepeat},
@rinternals{DoublePercentRepeatCounter},
-@rinternals{PercentRepeatCounter}, @rinternals{PercentRepeatedMusic}.
+@rinternals{PercentRepeatCounter},
+@rinternals{PercentRepeatedMusic}.
@knownissues
@seealso
-Snippets: @rlsr{Repeats}.
+Snippets:
+@rlsr{Repeats}.
@cindex tremolo, cross-staff
@cindex cross-staff tremolo
@rglos{tuplet},
@rglos{polymetric}.
-Learning Manual: @rlearning{Tweaking methods}.
+Learning Manual:
+@rlearning{Tweaking methods}.
Notation Reference:
@ref{Time administration},
@rinternals{TupletNumber},
@rinternals{TimeScaledMusic}.
+
@cindex grace notes within tuplet brackets
@knownissues
@seealso
-Music Glossary: @rglos{tie}
+Music Glossary:
+@rglos{tie}
Learning Manual:
@rlearning{Engravers explained},
Snippets:
@rlsr{Rhythms}.
-Internals Reference: @rinternals{Beam}.
+Internals Reference:
+@rinternals{Beam}.
@knownissues
Autobeam and beam subdivide settings are stored in the
@code{beamSettings} property. Default values of @code{beamSettings}
-are determined in @file{scm/beam-settings.scm}. Entries in
+are determined in @file{scm/@/beam@/-settings@/.scm}. Entries in
@code{beamSettings} are indexed by time signature and
rule type.
Snippets:
@rlsr{Rhythms}.
-Internals Reference: @rinternals{BarLine} (created at
-@rinternals{Staff} level), @rinternals{SpanBar} (across
-staves), @rinternals{Timing_translator} (for Timing
-properties).
+Internals Reference:
+@rinternals{BarLine} (created at @code{Staff} level),
+@rinternals{SpanBar} (across staves),
+@rinternals{Timing_translator} (for Timing properties).
@node Bar numbers
Snippets:
@rlsr{Rhythms}.
-Internals Reference: @rinternals{BarNumber}.
+Internals Reference:
+@rinternals{BarNumber}.
@cindex bar number collision
Snippets:
@rlsr{Rhythms}.
-Internals Reference: @rinternals{RehearsalMark}.
+Internals Reference:
+@rinternals{RehearsalMark}.
@node Special rhythmic concerns
@rglos{acciaccatura},
@rglos{appoggiatura}.
-Installed Files: @file{ly/@/grace@/-init@/.ly}.
+Installed Files:
+@file{ly/@/grace@/-init@/.ly}.
-Snippets: @rlsr{Rhythms}.
+Snippets:
+@rlsr{Rhythms}.
-Internals Reference: @rinternals{GraceMusic}.
+Internals Reference:
+@rinternals{GraceMusic}.
@knownissues
@seealso
-This manual: @ref{Bar numbers}, @ref{Unmetered music}
+Notation Reference:
+@ref{Bar numbers},
+@ref{Unmetered music}.
Snippets:
@rlsr{Rhythms}.
-Internals Reference: @rinternals{Timing_translator},
-@rinternals{Score}
+Internals Reference:
+@rinternals{Timing_translator},
+@rinternals{Score}.
You can also define these values in Scheme. In that case @code{mm},
@code{in}, @code{pt}, and @code{cm} are variables defined in
-@file{paper-defaults.ly} with values in millimeters. That is why the
+@file{paper@/-defaults@/.ly} with values in millimeters. That is why the
value must be multiplied in the example
@example
@seealso
-@ref{Setting the staff size}
+Notation Reference:
+@ref{Setting the staff size}.
+
Snippets:
@rlsr{Spacing}.
d2. d2.
@end lilypond
+
@seealso
Notation Reference:
@ref{Instrument transpositions},
Internals Reference:
@rinternals{TextScript}.
+
@cindex text outside margin
@cindex margin, text running over
@cindex text, keeping inside margin
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{stand-alone-two-column-markup.ly}
+
@seealso
-Notation Reference: @ref{Formatting text},
+Notation Reference:
+@ref{Formatting text},
@ref{File structure},
@ref{Multiple scores in a book},
@ref{Multi-page markup}.
Snippets:
@rlsr{Text}.
-Internals Reference: @rinternals{TextScript}.
+Internals Reference:
+@rinternals{TextScript}.
@node Formatting text
Snippets:
@rlsr{Text}.
-Internals Reference: @rinternals{TextScript}.
+Internals Reference:
+@rinternals{TextScript}.
Installed files:
@file{scm/@/define@/-markup@/-commands@/.scm}.
Snippets:
@rlsr{Text}.
-Internals Reference: @rinternals{TextScript}.
+Internals Reference:
+@rinternals{TextScript}.
Installed files:
@file{scm/@/define@/-markup@/-commands@/.scm},
Snippets:
@rlsr{Text}.
-Internals Reference: @rinternals{TextScript}.
+Internals Reference:
+@rinternals{TextScript}.
Installed files:
@file{scm/@/define@/-markup@/-commands@/.scm},
Snippets:
@rlsr{Text}.
-Internals Reference: @rinternals{TextScript}.
+Internals Reference:
+@rinternals{TextScript}.
Installed files:
@file{scm/@/define@/-markup@/-commands@/.scm}.
+
@funindex \markuplines
@funindex markuplines
Internals Reference:
@rinternals{LyricCombineMusic}.
+
@c Here come the section which used to be "Melismata"
@c the new title might be more self-explanatory
@ref{Special note heads},
Snippets:
-@rlsr{Winds}
+@rlsr{Winds}.
@node Fingerings
@seealso
-@rlsr{Winds}
+@rlsr{Winds}.
@node Bagpipe example
@seealso
-@rlsr{Winds}
+@rlsr{Winds}.
@seealso
Snippets:
-@rlsr{World music}
+@rlsr{World music}.
@node Further reading