Partial fix bug 370.

diff --git a/scm/define-grob-properties.scm b/scm/define-grob-properties.scm
index 45a2c77e84b34c4211f8ac92b39e0d0afe007d97..c4dc73d095125861e600f140a470681898f5c0da 100644 (file)
--- a/scm/define-grob-properties.scm
+++ b/scm/define-grob-properties.scm
@@ -405,7 +405,9 @@ whether to put a page turn at this column.  Can be @code{force} or
      (parenthesized ,boolean? "Parenthesize this grob.")
      (positions ,pair? "Pair of staff coordinates @code{(@var{left}
 . @var{right})}, where both @var{left} and @var{right} are in
-@code{staff-space} units of the current staff.")
+@code{staff-space} units of the current staff.  LilyPond uses these
+values to select which slur candidate positions to use; if extreme
+positions are requested, LilyPond selects the closest positions.")
 
      (ratio ,number? "Parameter for slur shape.  The higher this
 number, the quicker the slur attains its @code{height-limit}.")