Improve docs of \filled-box.

diff --git a/ChangeLog b/ChangeLog
index cf68c7a08666da502860b9ffb1494bd2e00d980c..de2fc4a1238fd4a59c4f949a46e30bd8df7ccca7 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -4,6 +4,8 @@
        global.itely, invoking.itely, tutorial,itely:
        minor fixes from mailist.
 
+       * scm/define-markup-commands.scm: improve docs of \filled-box.
+
 2006-02-23  Heikki Junes  <hjunes@cc.hut.fi>
 
        * Documentation/index.html.in: changes concern the previous release.

diff --git a/scm/define-markup-commands.scm b/scm/define-markup-commands.scm
index eee2783965a94cc0b9afdebcfe931b1b9df8f43e..7712177700731ab7a8a319452602c7881f3dac3f 100644 (file)
--- a/scm/define-markup-commands.scm
+++ b/scm/define-markup-commands.scm
@@ -107,7 +107,14 @@ thickness and padding around the markup."
 
 (def-markup-command (filled-box layout props xext yext blot)
   (number-pair? number-pair? number?)
-  "Draw a box with rounded corners of dimensions @var{xext} and @var{yext}."
+  "Draw a box with rounded corners of dimensions @var{xext} and
+@var{yext}.  For example,
+@verbatim
+\\filled-box #'(-.3 . 1.8) #'(-.3 . 1.8) #0
+@end verbatim
+create a box extending horizontally from -0.3 to 1.8 and
+vertically from -0.3 up to 1.8, with corners formed from a
+circle of diameter 0 (ie sharp corners)."
   (ly:round-filled-box
    xext yext blot))