From db7d70d3cadd9f7825b8d279c512c03706ca580e Mon Sep 17 00:00:00 2001
From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 3 Aug 2023 11:26:32 +0300
Subject: [PATCH] ; 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 "")
-- 
2.39.2