GNU bug report logs - #48058
tab-width's docstring

Previous Next

Full log

View this message in rfc822 format

From: Gustavo Barros <gusbrs.2016 <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 48058 <at> debbugs.gnu.org, Stefan Kangas <stefan <at> marxist.se>
Subject: bug#48058: tab-width's docstring
Date: Thu, 29 Apr 2021 17:14:59 -0300

On Thu, 29 Apr 2021 at 14:35, Eli Zaretskii <eliz <at> gnu.org> wrote:

>> From: Stefan Kangas <stefan <at> marxist.se>
>> Date: Thu, 29 Apr 2021 12:05:39 -0500
>> Cc: Gustavo Barros <gusbrs.2016 <at> gmail.com>, 48058 <at> 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.
>

Just chiming in to say I'm following the discussion attentively, but 
have nothing to add.  Both Stefan's and Eli's suggestions look like 
improvements to me.  And I'll be happy with what you come up with.

Best regards,
Gustavo.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.