GNU bug report logs - #50303
Add interlinks to docstrings of inverse abbrev

Previous Next

Full log

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Juri Linkov <juri <at> linkov.net>
Cc: 50303 <at> debbugs.gnu.org
Subject: Re: bug#50303: Add interlinks to docstrings of inverse abbrev
Date: Tue, 31 Aug 2021 20:40:27 +0300

> From: Juri Linkov <juri <at> linkov.net>
> Date: Tue, 31 Aug 2021 19:45:32 +0300
> 
> diff --git a/lisp/abbrev.el b/lisp/abbrev.el
> index 54783db2c3..0d754cc9cf 100644
> --- a/lisp/abbrev.el
> +++ b/lisp/abbrev.el
> @@ -287,6 +287,7 @@ add-mode-abbrev
>  or zero means the region is the expansion.
>  A negative argument means to undefine the specified abbrev.
>  Reads the abbreviation in the minibuffer.
> +You can also use the opposite command `inverse-add-mode-abbrev'.

Thanks, but I think "you can also use" is not the best text here.  It
could be interpreted to mean that the other command does something
similar, which is not true, and contradicts the "opposite" part.
This makes the text confusing.

How about saying explicitly what that command does.  For example:

  To define expansion for the word at point, use `inverse-add-mode-abbrev'.

And similarly for the other doc strings.

Previous Next

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