Expand docstring of which-key-mode

* lisp/which-key.el (which-key-mode): Expand docstring.

diff --git a/etc/NEWS b/etc/NEWS
index e05431b17fa1269de2f102261b06e141cded946d..c43bd6aaaccddcf17b8c7ab46fa5df1866dc7b82 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2112,8 +2112,11 @@ in all buffers.
 +++
 ** New package Which-Key
 The 'which-key' package from GNU ELPA is now included in Emacs.  It
-implements the 'which-key-mode' that displays a table of key bindings
-upon entering a partial key chord and waiting for a moment.
+implements the global minor mode 'which-key-mode' that displays a table
+of key bindings upon entering a partial key chord and waiting for a
+moment.  For example, after enabling the minor mode, if you enter 'C-x'
+and wait for one second, the minibuffer will expand with all available
+key bindings that follow 'C-x' (or as many as space allows).
 
 \f
 * Incompatible Lisp Changes in Emacs 30.1

diff --git a/lisp/which-key.el b/lisp/which-key.el
index 973616ef1169aa16fbc0dc0d36a0af983d84fcf2..8ad2ba2c365dea4a3f63b5e0b66fc66e8296b5af 100644 (file)
--- a/lisp/which-key.el
+++ b/lisp/which-key.el
@@ -900,7 +900,15 @@ disable support."
 
 ;;;###autoload
 (define-minor-mode which-key-mode
-  "Toggle `which-key-mode'."
+  "Toggle `which-key-mode'.
+
+`which-key' is a minor mode that displays the key bindings following
+your currently entered incomplete command (a prefix) in a popup.
+
+For example, after enabling the minor mode, if you enter \\`C-x' and
+wait for one second (by default), the minibuffer will expand with all
+available key bindings that follow \\`C-x' (or as many as space allows
+given your settings)."
   :global t
   :group 'which-key
   :lighter which-key-lighter