Doc: NR 4.1.2: Nitpicks.

diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely
index 906f9976a80446bbe8045a02867809c558975827..814f8babcf46263f7b221ca3254e56839fb6410d 100644 (file)
--- a/Documentation/notation/spacing.itely
+++ b/Documentation/notation/spacing.itely
@@ -235,29 +235,29 @@ Each of these variables is an associative list containing four
 
 @itemize
 @item @code{padding} -- the minimum required amount of
 
 @itemize
 @item @code{padding} -- the minimum required amount of

-unobstructed vertical whitespace between two items.  This can be
+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.
 
 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 between the
+@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
 @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 markup is its highest point, and 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,
 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 space will never be less than either
+since the resulting distance will never be less than either

 @code{padding} or @code{minimum-distance}.
 
 @item @code{minimum-distance} -- the minimum required vertical
 @code{padding} or @code{minimum-distance}.
 
 @item @code{minimum-distance} -- the minimum required vertical

-distance between the reference points of the two items, when
+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
 compressing is in effect.  Values for @code{minimum-distance} that
 are less than @code{padding} are not meaningful, since the

-resulting space will never be less than @code{padding.}
+resulting distance will never be less than @code{padding.}

 
 

-@item @code{stretchability} -- the stretchable space's propensity
-to stretch.  If zero, the space will not stretch (unless
+@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
 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


@@ -267,7 +267,7 @@ 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
 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 stretchable space's propensity to @emph{compress} cannot
+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}).
 
 be directly set by the user and is equal to
 (@code{space}@tie{}@minus{}@tie{}@code{minimum-distance}).
 


@@ -329,18 +329,18 @@ 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}.
 
 settings for the flexible vertical @code{\paper} dimensions are
 defined in @file{ly/paper-defaults-init.ly}.
 

-The names of the flexible vertical dimension variables follow the
+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
 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 markup is its
+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
 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 @i{title markups}
+term @q{@code{markup}} refers to both @emph{title markups}

 (@code{bookTitleMarkup} or @code{scoreTitleMarkup}) and
 (@code{bookTitleMarkup} or @code{scoreTitleMarkup}) and

-@i{top-level markups} (see @ref{File structure}).
+@emph{top-level markups} (see @ref{File structure}).

 
 

-The flexible vertical dimension variables are:
+The flexible vertical dimension @code{\paper} variables are:

 
 
 @table @code
 
 
 @table @code