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

Previous Next

Package: emacs;

Reported by: Howard Melman <hmelman <at> gmail.com>

Date: Thu, 19 May 2022 18:33:01 UTC

Severity: normal

Found in version 28.1

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


Message #50 received at 55527 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Howard Melman <hmelman <at> gmail.com>
Cc: 55527 <at> debbugs.gnu.org
Subject: Re: bug#55527: 28.1; Clearer abbrev docstrings
Date: Sat, 21 May 2022 21:06:01 +0300
> 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?




This bug report was last modified 3 years and 3 days ago.

Previous Next


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