From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#48058: tab-width's docstring Date: Thu, 29 Apr 2021 20:35:13 +0300 Message-ID: <83pmydc7u6.fsf@gnu.org> References: <87a6pj50u6.fsf@gmail.com> <83eeevj0kt.fsf@gnu.org> <87wnsnkcz1.fsf@gmail.com> <8335vbixea.fsf@gnu.org> <87tunrkbdi.fsf@gmail.com> <83y2d3hhfe.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34151"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 48058@debbugs.gnu.org, gusbrs.2016@gmail.com To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 29 19:43:06 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lcAgs-0008lj-2k for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Apr 2021 19:43:06 +0200 Original-Received: from localhost ([::1]:34160 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lcAgr-0005Yr-20 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Apr 2021 13:43:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37596) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lcAa4-00028g-4p for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:36:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:45213) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lcAa3-0004CR-SH for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:36:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lcAa3-0008Fu-Nm for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:36:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Apr 2021 17:36:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 48058 X-GNU-PR-Package: emacs Original-Received: via spool by 48058-submit@debbugs.gnu.org id=B48058.161971773631370 (code B ref 48058); Thu, 29 Apr 2021 17:36:03 +0000 Original-Received: (at 48058) by debbugs.gnu.org; 29 Apr 2021 17:35:36 +0000 Original-Received: from localhost ([127.0.0.1]:56759 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lcAZb-00089o-7f for submit@debbugs.gnu.org; Thu, 29 Apr 2021 13:35:35 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:57328) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lcAZW-00087K-OK for 48058@debbugs.gnu.org; Thu, 29 Apr 2021 13:35:34 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:46798) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lcAZR-0003iv-Bn; Thu, 29 Apr 2021 13:35:25 -0400 Original-Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:4125 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lcAZQ-0005Jo-1P; Thu, 29 Apr 2021 13:35:24 -0400 In-Reply-To: (message from Stefan Kangas on Thu, 29 Apr 2021 12:05:39 -0500) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:205197 Archived-At: > From: Stefan Kangas > Date: Thu, 29 Apr 2021 12:05:39 -0500 > Cc: Gustavo Barros , 48058@debbugs.gnu.org > > I agree that the docstring is somewhat confusing, as it seems to rule > out that this variable is ever used to control indentation. But some > major modes do precisely that. > > Perhaps we could change the docstring note along the lines of: > > NOTE: Some major modes use this variable to determine an indentation > step, but Emacs itself only uses this to display the width of a TAB > character. > > Would something like that make sense? Something like that, yes. Perhaps just making the original text less definitive will do as well. > Also the last line of the docstring is odd to me: > > This should be an integer greater than zero. > > Should the "should" be changed to "must"? Those two are equivalent in this context.