; Add commentary to 'describe-function's completion

* lisp/help-fns.el
(help-fns--describe-function-or-command-prompt): Add a comment
(bug#64902).

diff --git a/lisp/help-fns.el b/lisp/help-fns.el
index 044bcf8b51fc2c33e218898a899eac8f68e602e0..068c3a5b5594bffd7396c6c4e33094deb902f742 100644 (file)
--- a/lisp/help-fns.el
+++ b/lisp/help-fns.el
@@ -229,6 +229,10 @@ interactive command."
                (lambda (f) (if want-command
                           (commandp f)
                         (or (fboundp f) (get f 'function-documentation))))
+               ;; We use 'confirm' here, unlike in other describe-*
+               ;; commands, for cases like a function that is advised
+               ;; but not yet defined (e.g., if 'advice-add' is called
+               ;; before defining the function).
                'confirm nil nil
                (and fn (symbol-name fn)))))
     (unless (equal val "")