>> @@ -287,6 +287,7 @@ add-mode-abbrev >> +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. The intention was to indicate that these are opposite commands. A good explanation is in (info "(emacs) Defining Abbrevs"): ‘C-x a i g’ (‘inverse-add-global-abbrev’) and ‘C-x a i l’ (‘inverse-add-mode-abbrev’) perform the opposite task: if the abbrev text is already in the buffer, you use these commands to define an abbrev by specifying the expansion in the minibuffer. These commands will expand the abbrev text used for the definition. Also to reduce confusion, to explicitly mention what another command does: 1. the abbrev is in the buffer, read the expansion from the minibuffer 2. the expansion is in the buffer, read the abbrev from the minibuffer So maybe this patch is better: