[Emacs-diffs] /srv/bzr/emacs/trunk r112283: Improve doc strings of left/right-margin/fringe-width.

[Eli Zaretskii]

------------------------------------------------------------
revno: 112283
fixes bug: http://debbugs.gnu.org/14200
committer: Eli Zaretskii <address@hidden>
branch nick: trunk
timestamp: Sun 2013-04-14 09:51:15 +0300
message:
  Improve doc strings of left/right-margin/fringe-width.
  
   src/buffer.c (syms_of_buffer) <left-margin-width, right-margin-width>
   <left-fringe-width, right-fringe-width, fringes-outside-margins>:
   Mention in the doc string that setting these variables takes
   effect only after a call to set-window-buffer.  (Bug#14200)
modified:
  src/ChangeLog
  src/buffer.c

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2013-04-13 08:54:02 +0000
+++ b/src/ChangeLog     2013-04-14 06:51:15 +0000
@@ -1,3 +1,10 @@
+2013-04-14  Eli Zaretskii  <address@hidden>
+
+       * buffer.c (syms_of_buffer) <left-margin-width, right-margin-width>
+       <left-fringe-width, right-fringe-width, fringes-outside-margins>:
+       Mention in the doc string that setting these variables takes
+       effect only after a call to set-window-buffer.  (Bug#14200)
+
 2013-04-13  Eli Zaretskii  <address@hidden>
 
        * indent.c (Fvertical_motion): Don't consider display strings on

=== modified file 'src/buffer.c'
--- a/src/buffer.c      2013-03-28 14:04:49 +0000
+++ b/src/buffer.c      2013-04-14 06:51:15 +0000
@@ -5883,29 +5883,44 @@
   DEFVAR_PER_BUFFER ("left-margin-width", &BVAR (current_buffer, 
left_margin_cols),
                     Qintegerp,
                     doc: /* Width of left marginal area for display of a 
buffer.
-A value of nil means no marginal area.  */);
+A value of nil means no marginal area.
+
+Setting this variable does not take effect until a new buffer is displayed
+in a window.  To make the change take effect, call `set-window-buffer'.  */);
 
   DEFVAR_PER_BUFFER ("right-margin-width", &BVAR (current_buffer, 
right_margin_cols),
                     Qintegerp,
                     doc: /* Width of right marginal area for display of a 
buffer.
-A value of nil means no marginal area.  */);
+A value of nil means no marginal area.
+
+Setting this variable does not take effect until a new buffer is displayed
+in a window.  To make the change take effect, call `set-window-buffer'.  */);
 
   DEFVAR_PER_BUFFER ("left-fringe-width", &BVAR (current_buffer, 
left_fringe_width),
                     Qintegerp,
                     doc: /* Width of this buffer's left fringe (in pixels).
 A value of 0 means no left fringe is shown in this buffer's window.
-A value of nil means to use the left fringe width from the window's frame.  
*/);
+A value of nil means to use the left fringe width from the window's frame.
+
+Setting this variable does not take effect until a new buffer is displayed
+in a window.  To make the change take effect, call `set-window-buffer'.  */);
 
   DEFVAR_PER_BUFFER ("right-fringe-width", &BVAR (current_buffer, 
right_fringe_width),
                     Qintegerp,
                     doc: /* Width of this buffer's right fringe (in pixels).
 A value of 0 means no right fringe is shown in this buffer's window.
-A value of nil means to use the right fringe width from the window's frame.  
*/);
+A value of nil means to use the right fringe width from the window's frame.
+
+Setting this variable does not take effect until a new buffer is displayed
+in a window.  To make the change take effect, call `set-window-buffer'.  */);
 
   DEFVAR_PER_BUFFER ("fringes-outside-margins", &BVAR (current_buffer, 
fringes_outside_margins),
                     Qnil,
                     doc: /* Non-nil means to display fringes outside display 
margins.
-A value of nil means to display fringes between margins and buffer text.  */);
+A value of nil means to display fringes between margins and buffer text.
+
+Setting this variable does not take effect until a new buffer is displayed
+in a window.  To make the change take effect, call `set-window-buffer'.  */);
 
   DEFVAR_PER_BUFFER ("scroll-bar-width", &BVAR (current_buffer, 
scroll_bar_width),
                     Qintegerp,