Doc: NR 4.1.4: Clarify 'padding in spacing alists.

diff --git a/Documentation/notation/spacing.itely b/Documentation/notation/spacing.itely
index 8a9f1d61d6633748227ec654c26ed8519c6b2074..89810f6dad17b130f1566f91d5aa28a88b2169f1 100644 (file)
--- a/Documentation/notation/spacing.itely
+++ b/Documentation/notation/spacing.itely
@@ -423,12 +423,12 @@ of the two items, when compressing is in effect.  Values for
 meaningful, since the resulting distance will never be less than
 @code{padding.}
 
+@c TODO: explain skylines somewhere and xref to it from here.
+
 @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.
+vertical whitespace between the bounding boxes (or skylines) of
+the two items, measured in staff-spaces.
 
 @item
 @code{stretchability} -- a unitless measure of the dimension's

diff --git a/scm/define-grob-properties.scm b/scm/define-grob-properties.scm
index 7f47363531bb19dc761f68dbf3e203f690e2a2a8..36c8954123672804858bb2a4166c2a43ab035d01 100644 (file)
--- a/scm/define-grob-properties.scm
+++ b/scm/define-grob-properties.scm
@@ -797,8 +797,8 @@ of the two items, when compressing is in effect.
 
 @item
 @code{padding} -- the minimum required amount of unobstructed
-vertical whitespace between the two items, measured in
-staff-spaces.
+vertical whitespace between the bounding boxes (or skylines) of
+the two items, measured in staff-spaces.
 
 @item
 @code{stretchability} -- a unitless measure of the dimension's