Subject: Re: bug#50303: Add interlinks to docstrings of inverse abbrev

From: Eli Zaretskii <[email-masked]>
Date: Tue, 31 Aug 2021 20:40:27 +0300

> From: Juri Linkov <[email-masked]>
> 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.