GNU bug report logs - #55527
28.1; Clearer abbrev docstrings

Previous Next

Full log

View this message in rfc822 format

From: Howard Melman <hmelman <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 55527 <at> debbugs.gnu.org
Subject: bug#55527: 28.1; Clearer abbrev docstrings
Date: Sat, 21 May 2022 14:26:29 -0400

> On May 21, 2022, at 2:06 PM, Eli Zaretskii <eliz <at> gnu.org> wrote:
> 
>> From: Howard Melman <hmelman <at> gmail.com>
>> Date: Sat, 21 May 2022 13:49:48 -0400
>> Cc: 55527 <at> debbugs.gnu.org
>> 
>> The existing docstrings for these commands had "word(s)" in them
>> and I don't think that's what made them unclear.  I also think it's a
>> common case to define an abbrev for a multi-word expansion.
> 
> I disagree, and let's leave it at that.
> 
>> Also, I see now that the inverse- versions of these command treat a 
>> negative argument as reversing the direction to find the word to use
>> as the abbreviation but the (old and new) docstrings fails to mention 
>> this.  I'm not sure if that's intentional or not (IMO it's an odd use case).
> 
> This is unrelated.  The effect of negative argument was implied; I've
> now made it explicit.
> 
> Our disagreement aside, are there any other issues left?

Nope.  Thanks.

Howard

Previous Next

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