From ddd6b68524ba1f957e2f8ddd76eb23e641429b58 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 14 Apr 2013 09:51:15 +0300 Subject: [PATCH] Improve doc strings of left/right-margin/fringe-width. src/buffer.c (syms_of_buffer) : Mention in the doc string that setting these variables takes effect only after a call to set-window-buffer. (Bug#14200) --- src/ChangeLog | 7 +++++++ src/buffer.c | 25 ++++++++++++++++++++----- 2 files changed, 27 insertions(+), 5 deletions(-) diff --git a/src/ChangeLog b/src/ChangeLog index af2d38d2e87..2d6fda4fec7 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,3 +1,10 @@ +2013-04-14 Eli Zaretskii + + * buffer.c (syms_of_buffer) + : + 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 * indent.c (Fvertical_motion): Don't consider display strings on diff --git a/src/buffer.c b/src/buffer.c index 8728b418812..3810d3db079 100644 --- a/src/buffer.c +++ b/src/buffer.c @@ -5883,29 +5883,44 @@ See also the functions `display-table-slot' and `set-display-table-slot'. */); 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, -- 2.39.2