From: Mark Polesky Date: Wed, 8 Dec 2010 05:52:05 +0000 (-0800) Subject: Doc: NR 4: Update instances of 'space in the text. X-Git-Tag: release/2.13.42-1~6 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=e52037e7cd50bc52affef6f1c8f68ccc6edaf492;p=lilypond.git Doc: NR 4: Update instances of 'space in the text. --- diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely index b9aecb3dac..46b466e841 100644 --- a/Documentation/notation/spacing.itely +++ b/Documentation/notation/spacing.itely @@ -410,17 +410,17 @@ This can be thought of as the minimum height of an unobstructed rightmost point of the combined items. @item -@code{space} -- the vertical distance, measured in staff-spaces, -between the @emph{reference points} of the two items, when no -collisions would result, and no stretching or compressing is in -effect. The reference point of a (title or top-level) markup is -its highest point, and the reference point of a system is the -vertical center of the nearest @code{StaffSymbol} -- even if a -non-staff line (such as a @code{Lyrics} context) is in the way. -Values for @code{space} that are less than either @code{padding} -or @code{minimum-distance} are not meaningful, since the resulting -distance will never be less than either @code{padding} or -@code{minimum-distance}. +@code{basic-distance} -- the vertical distance, measured in +staff-spaces, between the @emph{reference points} of the two +items, when no collisions would result, and no stretching or +compressing is in effect. The reference point of a (title or +top-level) markup is its highest point, and the reference point of +a system is the vertical center of the nearest @code{StaffSymbol} +-- even if a non-staff line (such as a @code{Lyrics} context) is +in the way. Values for @code{basic-distance} that are less than +either @code{padding} or @code{minimum-distance} are not +meaningful, since the resulting distance will never be less than +either @code{padding} or @code{minimum-distance}. @item @code{minimum-distance} -- the smallest allowable vertical @@ -441,10 +441,10 @@ twice the @code{stretchability} of another, it will stretch twice as easily. Values should be non-negative and finite. The value @code{+inf.0} triggers a @code{programming_error} and is ignored, but @code{1.0e7} can be used for an almost infinitely stretchable -spring. If unset, the default value is set to @code{space}. Note -that the dimension's propensity to @emph{compress} cannot be -directly set by the user and is equal to -(@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}). +spring. If unset, the default value is set to +@code{basic-distance}. Note that the dimension's propensity to +@emph{compress} cannot be directly set by the user and is equal to +(@code{basic-distance}@tie{}@minus{}@tie{}@code{minimum-distance}). @end itemize @@ -454,7 +454,7 @@ largest of: @itemize @item -@code{space}, +@code{basic-distance}, @item @code{minimum-distance}, and @@ -1048,7 +1048,7 @@ Here is an example @code{\layout} block: indent = 2\cm \context @{ \StaffGroup - \override StaffGrouper #'staff-staff-spacing #space = #8 + \override StaffGrouper #'staff-staff-spacing #'basic-distance = #8 @} \context @{ \Voice @@ -2042,19 +2042,19 @@ property can affect the spacing of ungrouped staves: } \new StaffGroup << - % The very low note here needs more room than 'space can - % provide, so the distance between this staff and the next is - % determined by 'padding. + % The very low note here needs more room than 'basic-distance + % can provide, so the distance between this staff and the next + % is determined by 'padding. \new Staff { b,2 r | } - % Here, 'space provides enough room, and there is no need to - % compress the space (towards 'minimum-distance) to make room - % for anything else on the page, so the distance between this - % staff and the next is determined by 'space. + % Here, 'basic-distance provides enough room, and there is no + % need to compress the space (towards 'minimum-distance) to make + % room for anything else on the page, so the distance between + % this staff and the next is determined by 'basic-distance. \new Staff { \clef bass g2 r | } % By setting 'padding to a negative value, staves can be made to - % collide. The lowest acceptable value for 'space is 0. + % collide. The lowest acceptable value for 'basic-distance is 0. \new Staff \with { \override VerticalAxisGroup #'staff-staff-spacing = #'((padding . -10)