+2006-06-10 Graham Percival <gpermus@gmail.com>
+
+ * Documentation/user/ page.itely, global.itely: editing
+ and reorg.
+
2006-06-10 Erik Sandberg <mandolaerik@gmail.com>
* lily/time-scaled-music-iterator.cc: Use tupletSpannerDuration to
Text can also be placed on its own, away from any @code{\score}
block. This is primarily used in a @code{\book} (see
-@ref{Multiple movements}).
+@ref{Multiple scores in a book}).
@lilypond[quote,ragged-right,verbatim]
\markup{ Here is some text. }
g
@end lilypond
-LilyPond has fonts in different design sizes. The music fonts for
-smaller sizes are chubbier, while the text fonts are relatively wider.
Font size changes are achieved by scaling the design size that is
closest to the desired size. The standard font size (for
@code{font-size} equals 0), depends on the standard staff height. For
@menu
* Input files::
* Titles and headers::
-* Multiple movements::
* MIDI output::
* Displaying LilyPond notation::
* Skipping corrected music::
@menu
* File structure (introduction)::
+* Multiple scores in a book::
* File structure::
* A single music expression::
* Including LilyPond files::
them all.
+@node Multiple scores in a book
+@subsection Multiple scores in a book
+
+@funindex \book
+@cindex movements, multiple
+
+A document may contain multiple pieces of music and texts. Examples
+of these are an etude book, or an orchestral part with multiple
+movements. Each movement is entered with a @code{\score} block,
+
+@example
+\score @{
+ @var{..music..}
+@}
+@end example
+
+and texts are entered with a @code{\markup} block,
+
+@example
+\markup @{
+ @var{..text..}
+@}
+@end example
+
+@findex \book
+
+The movements and texts are combined together in a @code{\book} block,
+like
+
+@example
+\book @{
+ \score @{
+ @var{..}
+ @}
+ \markup @{
+ @var{..}
+ @}
+ \score @{
+ @var{..}
+ @}
+@}
+@end example
+
+
+The header for each piece of music can be put inside the @code{\score}
+block. The @code{piece} name from the header will be printed before
+each movement. The title for the entire book can be put inside the
+@code{\book}, but if it is not present, the @code{\header} which is at
+the top of the file is inserted.
+
+@example
+\book @{
+ \header @{
+ title = "Eight miniatures"
+ composer = "Igor Stravinsky"
+ @}
+ \score @{
+ @dots{}
+ \header @{ piece = "Romanze" @}
+ @}
+ \markup @{
+ ..text of second verse..
+ @}
+ \markup @{
+ ..text of third verse..
+ @}
+ \score @{
+ @dots{}
+ \header @{ piece = "Menuetto" @}
+ @}
+@}
+@end example
+
+
+
@node File structure
@subsection File structure
-@node Multiple movements
-@section Multiple movements
-
-@cindex bibliographic information
-@cindex titles
-@cindex composer
-@cindex Music engraving by LilyPond
-
-A document may contain multiple pieces of music and texts. Examples
-of these are an etude book, or an orchestral part with multiple
-movements. Each movement is entered with a @code{\score} block,
-
-@example
-\score @{
- @var{..music..}
-@}
-@end example
-
-and texts are entered with a @code{\markup} block,
-
-@example
-\markup @{
- @var{..text..}
-@}
-@end example
-
-@findex \book
-
-The movements and texts are combined together in a @code{\book} block,
-like
-
-@example
-\book @{
- \score @{
- @var{..}
- @}
- \markup @{
- @var{..}
- @}
- \score @{
- @var{..}
- @}
-@}
-@end example
-
-
-The header for each piece of music can be put inside the @code{\score}
-block. The @code{piece} name from the header will be printed before
-each movement. The title for the entire book can be put inside the
-@code{\book}, but if it is not present, the @code{\header} which is at
-the top of the file is inserted.
-
-@cindex Engraved by LilyPond
-@cindex signature line
-
-@example
-\book @{
- \header @{
- title = "Eight miniatures"
- composer = "Igor Stravinsky"
- @}
- \score @{
- @dots{}
- \header @{ piece = "Romanze" @}
- @}
- \markup @{
- ..text of second verse..
- @}
- \markup @{
- ..text of third verse..
- @}
- \score @{
- @dots{}
- \header @{ piece = "Menuetto" @}
- @}
-@}
-@end example
-
-
-
@node MIDI output
@section MIDI output
@section Vertical spacing
@cindex vertical spacing
+@cindex spacing, vertical
Vertical spacing is controlled by three things: the amount of
space available (i.e. paper size and margins), the amount of
@node Horizontal spacing
@section Horizontal Spacing
+@cindex horizontal spacing
+@cindex spacing, horizontal
+
@menu
-* Horizontal Intro::
+* Horizontal spacing overview::
+* New spacing area::
+* Changing horizontal spacing::
* Line length::
@end menu
-@node Horizontal Intro
-@subsection Horizontal Intro
+@node Horizontal spacing overview
+@subsection Horizontal spacing overview
The spacing engine translates differences in durations into stretchable
distances (``springs'') of differring lengths. Longer durations get
Proportional notation is supported; see @ref{Proportional notation}.
+
+@seealso
+
+Internals: @internalsref{SpacingSpanner}, @internalsref{NoteSpacing},
+@internalsref{StaffSpacing}, @internalsref{SeparationItem}, and
+@internalsref{SeparatingGroupSpanner}.
+
+
+@refbugs
+
+There is no convenient mechanism to manually override spacing. The
+following work-around may be used to insert extra space into a score.
+@example
+ \once \override Score.SeparationItem #'padding = #1
+@end example
+
+No work-around exists for decreasing the amount of space.
+
+
+@node New spacing area
+@subsection New spacing area
+
+New sections with different spacing parameters can be started with
+@code{newSpacingSection}. This is useful when there are
+sections with a different notions of long and short notes.
+
+In the following example, the time signature change introduces a new
+section, and hence the 16ths notes are spaced wider.
+
+FIXME: wait until we're definitely adding NEWS items. -gp
+
+@lilypond[relative,fragment,verbatim]
+\time 2/4
+c4 c8 c
+c8 c c4 c16[ c c8] c4
+%\newSpacingSection
+\time 4/16
+c16[ c c8]
+@end lilypond
+
+
+@node Changing horizontal spacing
+@subsection Changing horizontal spacing
+
By default, spacing in tuplets depends on various non-duration
factors (such as accidentals, clef changes, etc). To disregard
such symbols and force uniform equal-duration spacing, use
@end lilypond
-@seealso
-
-Internals: @internalsref{SpacingSpanner}, @internalsref{NoteSpacing},
-@internalsref{StaffSpacing}, @internalsref{SeparationItem}, and
-@internalsref{SeparatingGroupSpanner}.
-
-@refbugs
-
-Spacing is determined on a score wide basis. If you have a score that
-changes its character (measured in durations) halfway during the
-score, the part containing the longer durations will be spaced too
-widely.
-
-There is no convenient mechanism to manually override spacing. The
-following work-around may be used to insert extra space into a score.
-@example
- \once \override Score.SeparationItem #'padding = #1
-@end example
-
-No work-around exists for decreasing the amount of space.
-
-
@node Line length
@subsection Line length
projects / lilypond.git / commitdiff