Fix/enhance `define-alternatives' docstring again

diff --git a/lisp/simple.el b/lisp/simple.el
index 8ff6b9c55f490d018a9cd94cc06f7eea06c26fc4..ceddfc6421a34b1df76caef866aeeadf3021074e 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -7659,14 +7659,15 @@ warning using STRING as the message.")
 The argument `COMMAND' should be a symbol.
 
 Running `M-x COMMAND RET' for the first time prompts for which
-alternative to use and record the selected command as a custom
+alternative to use and records the selected command as a custom
 variable.
 
-Running `C-u M-x COMMAND RET' prompts again and overwrite the
-previous choice.
+Running `C-u M-x COMMAND RET' prompts again for an alternative
+and overwrites the previous choice.
 
 The variable `COMMAND-alternatives' contains an alist with
-alternative implementations of COMMAND.
+alternative implementations of COMMAND.  `define-alternatives'
+does not have any effect until this variable is set.
 
 CUSTOMIZATIONS, if non-nil, should be composed of alternating
 `defcustom' keywords and values to add to the declaration of