From 9963043a6f56dd5f1e30d6edf91462e1d82f97d4 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 16 Apr 2025 11:13:41 +0300 Subject: [PATCH] ; Improve documentation of 'help-fns-edit-variable' * lisp/help-fns.el (help-fns-edit-variable) (help-enable-variable-value-editing): Doc fixes. (cherry picked from commit bf737dc42a70fd8665b7c5ad506249a6119ec4c4) --- lisp/help-fns.el | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/lisp/help-fns.el b/lisp/help-fns.el index 2ea4735dccd..20992596c28 100644 --- a/lisp/help-fns.el +++ b/lisp/help-fns.el @@ -77,11 +77,11 @@ current help buffer.") (make-obsolete-variable 'help-enable-completion-autoload nil "31.1") (defcustom help-enable-variable-value-editing nil - "If non-nil, allow editing values in *Help* buffers. + "If non-nil, allow editing variable values in *Help* buffers. To edit the value of a variable, use \\[describe-variable] to display a \"*Help*\" buffer, move point after the text -\"Its value is\" and type \\`e'. +\"Its value is\" and type \\`e' to invoke `help-fns-edit-variable'. Values that aren't readable by the Emacs Lisp reader can't be edited even if this option is enabled." @@ -1575,7 +1575,16 @@ it is displayed along with the global value." (defvar help-fns--edit-variable) (defun help-fns-edit-variable () - "Edit the variable under point." + "Edit the variable value at point in \"*Help*\" buffer. +This command only works if `help-enable-variable-value-editing' is non-nil. + +To edit the value of a variable, use \\[describe-variable] followed by the name +of a variable, to display a \"*Help*\" buffer, move point to +the variable's value, usually after the text \"Its value is\", and +type \\`e' to invoke this command. + +Values that aren't readable by the Emacs Lisp reader can't be edited +by this command." (declare (completion ignore)) (interactive) (let ((var (get-text-property (point) 'help-fns--edit-variable))) -- 2.39.5