From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 30 Apr 2021 10:48:13 +0000 (+0300)
Subject: Improve doc string of 'tab-width'.
X-Git-Tag: emacs-28.0.90~2618^2
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=101a049f551b4013e54fdef0d87a74ec5dfd05e0;p=emacs.git

Improve doc string of 'tab-width'.

* src/buffer.c (syms_of_buffer) <tab-width>: Clarify doc string.
(Bug#48058)
---

diff --git a/src/buffer.c b/src/buffer.c
index a60327bb6ca..60a45731d11 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5639,9 +5639,12 @@ Linefeed indents to this column in Fundamental mode.  */);
   DEFVAR_PER_BUFFER ("tab-width", &BVAR (current_buffer, tab_width),
 		     Qintegerp,
 		     doc: /* Distance between tab stops (for display of tab characters), in columns.
-NOTE: This controls the display width of a TAB character, and not
-the size of an indentation step.
-This should be an integer greater than zero.  */);
+This controls the width of a TAB character on display.
+The value should be a positive integer.
+Note that this variable doesn't necessarily affect the size of the
+indentation step.  However, if the major mode's indentation facility
+inserts one or more TAB characters, this variable will affect the
+indentation step as well, even if `indent-tabs-mode' is non-nil.  */);
 
   DEFVAR_PER_BUFFER ("ctl-arrow", &BVAR (current_buffer, ctl_arrow), Qnil,
 		     doc: /* Non-nil means display control chars with uparrow.