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

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 0178e91ba4f698900087ab75be426cae22e98736..2a17a57f90fc517cb0a7eaa68edbd6c9bea02f69 100644 (file)
--- 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 e8e9e38939dea8f851510432cab991887bb3263f..42f685838394b41676003ed700b437d347cb61f9 100644 (file)
--- 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