X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fspacing.itely;h=7aa0dd62645c3822d48e8f967d812f5b06ded703;hb=37ca1f80bf5401accd17056938f4f7b2c147ddb2;hp=439ce43d4f4b615fe4e6383e8bc2af9ad90c620b;hpb=a31f7cf42ab5ac512242970e11538b179df01065;p=lilypond.git diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely index 439ce43d4f..7aa0dd6264 100644 --- a/Documentation/user/spacing.itely +++ b/Documentation/user/spacing.itely @@ -9,9 +9,48 @@ @c \version "2.11.38" -@c A menu is needed before every deeper *section nesting of @node's; run -@c M-x texinfo-all-menus-update -@c to automatically fill in these menus before saving changes +@ignore +GDP TODO list + +Negative numbers are allowed: +> Are you sure? The following works well +> \paper{ +> first-page-number = -2 +> } +> and prints page number -1 on the second page, for example. + + +- default paper size is A4. + + +In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it +states: + +"@code{layout-set-staff-size} does not change the distance between +the +staff lines." + +Could we add a sentence: +"Use instead the pair fontSize = #@var{N} + \override StaffSymbol #'staff-space = #(magstep +@var{N}) +inside the Staff context to change the size of the font and the +distance between +staff lines accordingly." + +Actually I found, that the @internalsref{StaffSymbol} at line 481 +sends to an uncomplete +documentation. The property staff-space is not explained here. I +thought Y-extent might be of +help, but it is in turn explained by x-space which again is +missing from the list. Who has the +knowledge to fix this? + + +Clarify +http://code.google.com/p/lilypond/issues/detail?id=68 + +@end ignore @node Spacing issues @chapter Spacing issues @@ -1597,7 +1636,7 @@ music. Note that @code{ly:make-moment} constructs a duration, so @code{1 4} is a longer duration than @code{1 16}. -@lilypond[relative,verbatim,line-width=12\cm] +@lilypond[verbatim,line-width=12\cm] \score { \relative c'' { g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 | @@ -1608,7 +1647,7 @@ than @code{1 16}. } @end lilypond -@lilypond[relative,verbatim,line-width=12\cm] +@lilypond[verbatim,line-width=12\cm] \score { \relative c'' { g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 | @@ -2087,7 +2126,7 @@ effect. In general the commands shown in this section can be placed in either. Much more detail on the options for tweaking the laying out -of music are contained in @ruser{Spacing issues}. +of music are contained in @ref{Spacing issues}. @node Global sizes @subsection Global sizes @@ -2191,7 +2230,7 @@ a page-break at the point where they are inserted. Of course, the @code{\pageBreak} command also forces a line break. Like @code{\break}, the @code{\pageBreak} command is effective only at the end of a @q{complete} bar as defined above. For more -details see @ruser{Page breaking} and following sections. +details see @ref{Page breaking} and following sections. There are also analogous settings to @code{ragged-right} and @code{ragged-last} which have the same effect on vertical spacing: @@ -2199,7 +2238,7 @@ There are also analogous settings to @code{ragged-right} and @code{##t} the systems on all pages or just the last page respectively will not be justified vertically. -For more details see @ruser{Vertical spacing}. +For more details see @ref{Vertical spacing}. @node Fitting music onto fewer pages @subsection Fitting music onto fewer pages @@ -2211,7 +2250,7 @@ of room left on those. When investigating layout issues, @code{annotate-spacing} is an invaluable tool. This command prints the values of various -layout spacing commands; see @ruser{Displaying spacing}, for more +layout spacing commands; see @ref{Displaying spacing}, for more details. From the output of @code{annotate-spacing}, we can see which margins we may wish to alter. @@ -2262,7 +2301,7 @@ e4 c g\f c @item Alter the horizontal spacing via @code{SpacingSpanner}. See -@ruser{Changing horizontal spacing}, for more details. Here's +@ref{Changing horizontal spacing}, for more details. Here's an example first showing the default behavior: @lilypond[verbatim,quote,ragged-right]