From d962c83aa37ea0d50cd4780c23663c901cd9c947 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 6 May 2026 14:19:50 +0300 Subject: [PATCH] ; Improve doc strings of several Help-related user options * lisp/help-fns.el (help-enable-completion-autoload) (help-enable-symbol-autoload): * lisp/help.el (help-enable-autoload): Doc fixes. --- lisp/help-fns.el | 7 +++++-- lisp/help.el | 2 +- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/lisp/help-fns.el b/lisp/help-fns.el index 8910f42e758..b7292eafb8a 100644 --- a/lisp/help-fns.el +++ b/lisp/help-fns.el @@ -127,7 +127,7 @@ current help buffer.") (defcustom help-enable-completion-autoload t "Whether completion for Help commands can perform autoloading. If non-nil, whenever invoking completion for `describe-function' -or `describe-variable' load files that might contain definitions +or `describe-variable', load files that might contain definitions with the current prefix. The files are chosen according to `definition-prefixes'." :type 'boolean @@ -148,7 +148,10 @@ edited even if this option is enabled." :version "29.1") (defcustom help-enable-symbol-autoload nil - "Perform autoload if docs are missing from autoload objects." + "Perform autoload if doc string is missing from an autoloaded object. +If non-nil, if an autoloaded object lacks a doc string, Help commands +will load the file where the object is defined, in order to be able +to show its documentation." :type 'boolean :group 'help :version "28.1") diff --git a/lisp/help.el b/lisp/help.el index 1576fb61dc8..f5fe34435bb 100644 --- a/lisp/help.el +++ b/lisp/help.el @@ -2110,7 +2110,7 @@ Also see `help-window-select'." 'help-enable-autoload "27.1") (defcustom help-enable-autoload t - "Whether Help commands can perform autoloading. + "Whether Help commands can perform autoloading in order to show key bindings. If non-nil, whenever \\[describe-function] is called for an autoloaded function whose docstring contains any key substitution construct (see `substitute-command-keys'), the library is loaded,