emacs-29 db7d70d3cad: ; Add commentary to 'describe-function's completion

[Eli Zaretskii]

branch: emacs-29
commit db7d70d3cadd9f7825b8d279c512c03706ca580e
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Add commentary to 'describe-function's completion
    
    * lisp/help-fns.el
    (help-fns--describe-function-or-command-prompt): Add a comment
    (bug#64902).
---
 lisp/help-fns.el | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lisp/help-fns.el b/lisp/help-fns.el
index 044bcf8b51f..068c3a5b559 100644
--- 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 "")