summaryrefslogtreecommitdiff
path: root/lisp/help.el
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2022-05-02 11:30:43 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2022-05-02 11:30:52 +0200
commit97badaab7969ed5a306d6bcd320eb3d592a7f4ae (patch)
tree4017e53cfb5415ff53eb056e98d381a3c212cb5b /lisp/help.el
parent38945225596708a60d332d1f95dc9618e3d974b1 (diff)
downloademacs-97badaab7969ed5a306d6bcd320eb3d592a7f4ae.tar.gz
Allow reusing the *Help* window with `i'/`s/ commands
* doc/emacs/help.texi (Help): Document it. * lisp/help-mode.el (help-function-def--button-function): Use it. * lisp/help-mode.el (help-goto-info): Use it. * lisp/help.el (help-window-select): Mention it. (help-window-keep-selected): New user option (bug#9054). * lisp/info-look.el (info-lookup-symbol): (info-lookup): Allow keeping the same window.
Diffstat (limited to 'lisp/help.el')
-rw-r--r--lisp/help.el14
1 files changed, 13 insertions, 1 deletions
diff --git a/lisp/help.el b/lisp/help.el
index 2d08ceb86c7..fe999de6382 100644
--- a/lisp/help.el
+++ b/lisp/help.el
@@ -1802,13 +1802,25 @@ the help window appears on another frame, it may get selected and
its frame get input focus even if this option is nil.
This option has effect if and only if the help window was created
-by `with-help-window'."
+by `with-help-window'.
+
+Also see `help-window-keep-selected'."
:type '(choice (const :tag "never (nil)" nil)
(const :tag "other" other)
(const :tag "always (t)" t))
:group 'help
:version "23.1")
+(defcustom help-window-keep-selected nil
+ "If non-nil, navigation commands in the *Help* buffer will reuse the window.
+If nil, many commands in the *Help* buffer, like \\<help-mode-map>\\[help-view-source] and \\[help-goto-info], will
+pop to a different window to display the results.
+
+Also see `help-window-select'."
+ :type 'boolean
+ :group 'help
+ :version "29.1")
+
(define-obsolete-variable-alias 'help-enable-auto-load
'help-enable-autoload "27.1")