* display.texi (Face Attributes): Document negative line widths (Bug#6113).

2 files changed, 9 insertions, 1 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 0178e91ba4f..2a17a57f90f 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-07-03  Chong Yidong  <cyd@stupidchicken.com>
+
+        * display.texi (Face Attributes): Document negative line widths
+        (Bug#6113).
+
 2011-06-14  Chong Yidong  <cyd@stupidchicken.com>
 
         * keymaps.texi (Searching Keymaps):
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index e8e9e38939d..42f68583839 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2094,7 +2094,10 @@ Draw a box with lines of width 1, in color @var{color}.
 
 @item @code{(:line-width @var{width} :color @var{color} :style @var{style})}
 This way you can explicitly specify all aspects of the box.  The value
-@var{width} specifies the width of the lines to draw; it defaults to 1.
+@var{width} specifies the width of the lines to draw; it defaults to
+1.  A negative width @var{-n} means to draw a line of width @var{n}
+that occupies the space of the underlying text, thus avoiding any
+increase in the character height or width.
 
 The value @var{color} specifies the color to draw with.  The default is
 the foreground color of the face for simple boxes, and the background