[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100548: Doc fix for left-fringe and right-fringe parameters (Bug#6930)

[Chong Yidong]

------------------------------------------------------------
revno: 100548
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Sun 2011-04-10 16:43:35 -0400
message:
  Doc fix for left-fringe and right-fringe parameters (Bug#6930)
  
  * doc/lispref/frames.texi (Layout Parameters): Note the difference
  between querying and setting parameters for left-fringe and
  right-fringe.
modified:
  doc/lispref/ChangeLog
  doc/lispref/frames.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-03-21 15:30:01 +0000
+++ b/doc/lispref/ChangeLog     2011-04-10 20:43:35 +0000
@@ -1,3 +1,9 @@
+2011-04-10  Chong Yidong  <address@hidden>
+
+       * frames.texi (Layout Parameters): Note the difference between
+       querying and setting parameters for left-fringe and right-fringe
+       (Bug#6930).
+
 2011-03-21  Stefan Monnier  <address@hidden>
 
        * minibuf.texi (Basic Completion): Be a bit more precise about the

=== modified file 'doc/lispref/frames.texi'
--- a/doc/lispref/frames.texi   2011-01-22 20:25:23 +0000
+++ b/doc/lispref/frames.texi   2011-04-10 20:43:35 +0000
@@ -654,17 +654,20 @@
 @itemx right-fringe
 The default width of the left and right fringes of windows in this
 frame (@pxref{Fringes}).  If either of these is zero, that effectively
-removes the corresponding fringe.  A value of @code{nil} stands for
-the standard fringe width, which is the width needed to display the
-fringe bitmaps.
+removes the corresponding fringe.
+
+When you use @code{frame-parameter} to query the value of either of
+these two frame parameters, the return value is always an integer.
+When using @code{set-frame-parameter}, passing a @code{nil} value
+imposes an actual default value of 8 pixels.
 
 The combined fringe widths must add up to an integral number of
-columns, so the actual default fringe widths for the frame may be
-larger than the specified values.  The extra width needed to reach an
-acceptable total is distributed evenly between the left and right
-fringe.  However, you can force one fringe or the other to a precise
-width by specifying that width as a negative integer.  If both widths are
-negative, only the left fringe gets the specified width.
+columns, so the actual default fringe widths for the frame, as
+reported by @code{frame-parameter}, may be larger than what you
+specify.  Any extra width is distributed evenly between the left and
+right fringe.  However, you can force one fringe or the other to a
+precise width by specifying that width as a negative integer.  If both
+widths are negative, only the left fringe gets the specified width.
 
 @item menu-bar-lines
 The number of lines to allocate at the top of the frame for a menu