* Multiple movements::
* MIDI output::
* Displaying LilyPond notation::
+* Other::
@end menu
@node Including LilyPond files
@subsection Including LilyPond files
-@cindex @code{\include}
+@findex \include
@cindex including files
A large project may be split up into separate files. To refer to another
}
@end lilypond
-@cindex @code{printallheaders}
+@findex 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}
+@findex 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}
+@findex 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}
+@findex oddHeaderMarkup
@item oddHeaderMarkup
This is the page header for odd-numbered pages.
-@cindex @code{evenHeaderMarkup}
+@findex 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}
+@findex oddFooterMarkup
@item oddFooterMarkup
This is the page footer for odd-numbered pages.
-@cindex @code{evenFotterMarkup}
+@findex 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}
+@findex 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}
+@findex 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}
+@findex \paper
@quotation
@table @code
-@cindex @code{first-page-number}
+@findex 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}
+@findex 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}
+@findex print-page-number
@item print-page-number
If set to false, page numbers will not be printed.
-@cindex @code{paper-width}
+@findex paper-width
@item paper-width
The width of the page.
-@cindex @code{paper-height}
+@findex paper-height
@item paper-height
The height of the page.
-@cindex @code{top-margin}
+@findex top-margin
@item top-margin
Margin between header and top of the page.
-@cindex @code{bottom-margin}
+@findex bottom-margin
@item bottom-margin
Margin between footer and bottom of the page.
-@cindex @code{left-margin}
+@findex left-margin
@item left-margin
Margin between the left side of the page and the beginning of the music.
-@cindex @code{line-width}
+@findex line-width
@item line-width
The length of the systems.
-@cindex @code{head-separation}
+@findex head-separation
@item head-separation
Distance between the top-most music system and the page header.
-@cindex @code{foot-separation}
+@findex foot-separation
@item foot-separation
Distance between the bottom-most music system and the page footer.
-@cindex @code{page-top-space}
+@findex 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}
+@findex 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}
+@findex 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}
+@findex system-count
@item system-count
This variable, if set, specifies into how many lines a score should be
broken.
-@cindex @code{between-system-space}
+@findex 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}
+@findex 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}
+@findex 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}
+@findex after-title-space
@item after-title-space
Amount of space between the title and the first system.
-@cindex @code{after-title-space}
+@findex 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}
+@findex 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}
+@findex 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}
+@findex 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
+@findex 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}
+@findex \tiny
@code{\tiny},
-@cindex @code{\small}
+@findex \small
@code{\small},
-@cindex @code{\normalsize}
+@findex \normalsize
@code{\normalsize}.
@node Score layout
@subsection Score layout
-@cindex @code{\layout}
+@findex \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}
+@findex common-shortest-duration
+@findex base-shortest-duration
+@findex stem-spacing-correction
+@findex 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}
+@findex indent
+@findex line-width
+@findex ragged-right
+@findex 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}
+@findex \break
+@findex \noBreak
@seealso
@refcommands
-@cindex @code{\pageBreak}
+@findex \pageBreak
@code{\pageBreak}
-@cindex @code{\noPageBreak}
+@findex \noPageBreak
@code{\noPageBreak}
@}
@end example
-@cindex @code{\book}
+@findex \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}
+@findex 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}
+@findex \displayLilyMusc
Displaying a music expression in LilyPond notation can be
done using the music function @code{\displayLilyMusic}. For example,
@end example
+@node Other
+@section Other
+
+@c FIXME: yeah, it really needs to be moved soon. -gp
+@menu
+* Skipping corrected music::
+* Writing music in parallel::
+@end menu
+
+@node Skipping corrected music
+@subsection Skipping corrected music
+
+
+@findex skipTypesetting
+@findex showLastLength
+
+When entering or copying music, usually only the music near the end (where
+you
+are adding notes) is interesting to view and correct. To speed up
+this correction process, it is possible to skip typesetting of all but
+the last few measures. This is achieved by putting
+
+@verbatim
+showLastLength = R1*5
+\score { ... }
+@end verbatim
+
+@noindent
+in your source file. This will render only the last 5 measures
+(assuming 4/4 time signature) of every @code{\score} in the input
+file. For longer pieces, rendering only a small part is often an order
+of magnitude quicker than rendering it completely
+
+Skipping parts of a score can be controlled in a more fine-grained
+fashion with the property @code{Score.skipTypesetting}. When it is
+set, no typesetting is performed at all.
+
+This property is also used to control output to the MIDI file. Note that
+it skips all events, including tempo and instrument changes. You have
+been warned.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+ c8 d
+ \set Score.skipTypesetting = ##t
+ e e e e e e e e
+ \set Score.skipTypesetting = ##f
+ c d b bes a g c2 }
+@end lilypond
+
+In polyphonic music, @code{Score.skipTypesetting} will affect all
+voices and staves, saving even more time.
+
+
+@node Writing music in parallel
+@subsection Writing music in parallel
+@cindex Writing music in parallel
+@cindex Interleaved music
+
+Music for multiple parts can be interleaved
+
+@lilypond[quote,fragment,verbatim]
+\parallelMusic #'(voiceA voiceB) {
+ r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c'' e''] |
+ c'2 c'2 |
+ r8 a'16[ d''] f''[ a' d'' f''] r8 a'16[ d''] f''[ a' d'' f''] |
+ c'2 c'2 |
+}
+\new StaffGroup <<
+ \new Staff \new Voice \voiceA
+ \new Staff \new Voice \voiceB
+>>
+@end lilypond
+