From ca54911be8b8aa8cee792b8a4d38a7680d2e5ef3 Mon Sep 17 00:00:00 2001 From: Mark Polesky Date: Fri, 22 Oct 2010 16:50:41 -0700 Subject: [PATCH] Doc: NR 4.1.2: Fix formatting. --- Documentation/notation/spacing.itely | 85 ++++++++++++++-------------- 1 file changed, 41 insertions(+), 44 deletions(-) diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely index 814f8babcf..229ff8c419 100644 --- a/Documentation/notation/spacing.itely +++ b/Documentation/notation/spacing.itely @@ -217,7 +217,6 @@ printable area. Default: @code{5\mm}. The margin between the bottom of the printable area and the bottom of the page. Default: @code{6\mm}. - @end table @@ -235,42 +234,43 @@ Each of these variables is an associative list containing four @itemize @item @code{padding} -- the minimum required amount of -unobstructed vertical whitespace between two items, measured in staff-spaces. This can be -thought of as the minimum height of an unobstructed (invisible) -rectangle that extends from the leftmost to the rightmost point of -the combined items. - -@item @code{space} -- the default 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 middle line of the nearest -staff. 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}. +unobstructed vertical whitespace between two items, measured in +staff-spaces. This can be thought of as the minimum height of an +unobstructed (invisible) rectangle that extends from the leftmost +to the rightmost point of the combined items. + +@item @code{space} -- the default 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 middle line of the nearest staff. 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}. @item @code{minimum-distance} -- the minimum required vertical -distance, measured in staff-spaces, between the reference points of the two items, when -compressing is in effect. Values for @code{minimum-distance} that -are less than @code{padding} are not meaningful, since the -resulting distance will never be less than @code{padding.} - -@item @code{stretchability} -- a unitless measure of the dimension's relative propensity -to stretch. If zero, the distance will not stretch (unless -collisions would result). When positive, the significance of a -particular dimension's @code{stretchability} value lies only in -its relation to the @code{stretchability} values of the other -dimensions. For example, if one dimension has 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 +distance, measured in staff-spaces, between the reference points +of the two items, when compressing is in effect. Values for +@code{minimum-distance} that are less than @code{padding} are not +meaningful, since the resulting distance will never be less than +@code{padding.} + +@item @code{stretchability} -- a unitless measure of the +dimension's relative propensity to stretch. If zero, the distance +will not stretch (unless collisions would result). When positive, +the significance of a particular dimension's @code{stretchability} +value lies only in its relation to the @code{stretchability} +values of the other dimensions. For example, if one dimension has +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 +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}). - @end itemize If a page has a ragged bottom, the resulting distance is the @@ -329,22 +329,20 @@ size) will always reset all its default key-values. Default settings for the flexible vertical @code{\paper} dimensions are defined in @file{ly/paper-defaults-init.ly}. -The names of these variables follow the -format @code{@var{upper}-@var{lower}-spacing}, where -@code{@var{upper}} and @code{@var{lower}} are the items to be -spaced. Each distance is measured between the reference points of -the two items: the reference point of a (title or top-level) markup is its -highest point, and the reference point of a system is the middle -line of the nearest staff. Note that in these variable names, the -term @q{@code{markup}} refers to both @emph{title markups} +The names of these variables follow the format +@code{@var{upper}-@var{lower}-spacing}, where @code{@var{upper}} +and @code{@var{lower}} are the items to be spaced. Each distance +is measured between the reference points of the two items: the +reference point of a (title or top-level) markup is its highest +point, and the reference point of a system is the middle line of +the nearest staff. Note that in these variable names, the term +@q{@code{markup}} refers to both @emph{title markups} (@code{bookTitleMarkup} or @code{scoreTitleMarkup}) and @emph{top-level markups} (see @ref{File structure}). The flexible vertical dimension @code{\paper} variables are: - @table @code - @item markup-system-spacing @funindex markup-system-spacing @@ -394,7 +392,6 @@ of the top margin) to the first system on a page, when there is no the distance from the top of the printable area (i.e. the bottom of the top margin) to the first (title or top-level) markup on a page, when there is no system between the two. - @end table -- 2.39.2