From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#48058: tab-width's docstring Date: Thu, 29 Apr 2021 12:05:39 -0500 Message-ID: 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> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15198"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 48058@debbugs.gnu.org, Gustavo Barros To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Apr 29 19:06:17 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 1lcA7C-0003k6-T4 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Apr 2021 19:06:14 +0200 Original-Received: from localhost ([::1]:60660 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lcA7B-0004te-Ls for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Apr 2021 13:06:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57432) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lcA70-0004sz-Sx for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:06:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:45177) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lcA70-000685-BP for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:06:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lcA70-0003qo-4x for bug-gnu-emacs@gnu.org; Thu, 29 Apr 2021 13:06:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Apr 2021 17:06:02 +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.161971594814769 (code B ref 48058); Thu, 29 Apr 2021 17:06:02 +0000 Original-Received: (at 48058) by debbugs.gnu.org; 29 Apr 2021 17:05:48 +0000 Original-Received: from localhost ([127.0.0.1]:56719 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lcA6l-0003q8-PG for submit@debbugs.gnu.org; Thu, 29 Apr 2021 13:05:47 -0400 Original-Received: from mail-pj1-f44.google.com ([209.85.216.44]:47038) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lcA6k-0003pv-0k for 48058@debbugs.gnu.org; Thu, 29 Apr 2021 13:05:46 -0400 Original-Received: by mail-pj1-f44.google.com with SMTP id u14-20020a17090a1f0eb029014e38011b09so212579pja.5 for <48058@debbugs.gnu.org>; Thu, 29 Apr 2021 10:05:46 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=q38HVrIIC9y0AUK8wSPQl7WA6ccm2jfv/vJj5H+IB/I=; b=X+gU+pqhmyOIHcZZRapeKB18Um1P7wwwjDtb9HPh9Weu+b3GNmDfxAT7VsnBIlqsrF P3dbJCh7tI0j49tRCIRdpvsp7m9VjUAKCvfFz0DLZyiXQOJ2qj6FzDQLsUF9SezD16b1 hW3hnEyrDDoq3ms+7llGU/va9+fzcrXTS0XRaR2PnJ3B1onLf6dV0Ymb6Qou3ls5A8t1 Ty1XM21O+mZP19H5m5mOjv5/cJdyFbMa5rdqJ3eOnvnrXsz9HB4TQkfL0keB671eZMSE yBaC8nN40BAzAQkqzxALCiqDPfeKBojxbNfpjekdjtGbKWmmJNhNDIp53L/qeTGNIWLm itKg== X-Gm-Message-State: AOAM531hNwDipBslUzztxl5y7dJ3edbrz2wWW2Tgj9t7JMknjvd+lv0L dx8Y1p98rY6c5qncBU8fqOOjpYcdcstOYDaieqU= X-Google-Smtp-Source: ABdhPJzCjHM1+z8GCW3DG965KhRLvysnoTQ/nje9Wwu5ElJx/iRNJKJk6yfwlii3aDGk2poJHbwY++/MRAMaQhjXPpI= X-Received: by 2002:a17:90b:350:: with SMTP id fh16mr888452pjb.104.1619715940253; Thu, 29 Apr 2021 10:05:40 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 29 Apr 2021 12:05:39 -0500 In-Reply-To: <83y2d3hhfe.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 27 Apr 2021 18:32:21 +0300") 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:205194 Archived-At: Eli Zaretskii writes: >> I didn't expect anything different to happen. It is just that >> `tab-width' is determining more than just the "display width of the TAB >> character": if you (or the major-mode for you) are indenting with spaces >> the content of the buffer is different according to `tab-width', it not >> just a matter of "display". >> >> But I see your point, and perhaps the docstring is clearer to someone >> more seasoned than myself, and avoids other pitfalls along the way which >> I do not even see. Hopefully, it will feel just as clear to me someday. >> ;-) > > Fair enough, let's see if there are other opinions about this. 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? --- 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"?