1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-22 07:09:54 +00:00

Allow showing prefix commands in Help buffers

* lisp/help.el (describe-bindings-show-prefix-commands): New user
option.
(describe-map): Use it to decide whether to output prefix
commands.  Patch by Bob Rogers <rogers@rgrjr.com>.  (Bug#62279)

* etc/NEWS: Document 'describe-bindings-show-prefix-commands'.
This commit is contained in:
Eli Zaretskii 2023-03-23 10:31:56 +02:00
parent f0a2f37dee
commit 19c95b1416
2 changed files with 12 additions and 3 deletions

View File

@ -3565,11 +3565,13 @@ font spec. In these cases, replacing ":weight 'normal" with ":weight
'medium" should fix the issue.
---
** Keymap descriptions have changed.
** Keymap descriptions by Help commands have changed.
'help--describe-command', 'C-h b' and associated functions that output
keymap descriptions have changed. In particular, prefix commands are
not output at all, and instead of "??" for closures/functions,
"[closure]"/"[lambda]" is output.
not output at all, and instead of "??" for closures/functions, these
functions output "[closure]"/"[lambda]". You can get back the old
behavior of including prefix commands by customizing the new option
'describe-bindings-show-prefix-commands' to a non-nil value.
---
** 'downcase' details have changed slightly.

View File

@ -717,6 +717,12 @@ Return nil if KEYS is nil."
:group 'help
:version "29.1")
(defcustom describe-bindings-show-prefix-commands nil
"Non-nil means show prefix commands in the output of `describe-bindings'."
:type 'boolean
:group 'help
:version "29.1")
(declare-function outline-hide-subtree "outline")
(defun describe-bindings (&optional prefix buffer)
@ -1699,6 +1705,7 @@ in `describe-map-tree'."
(setq vect (cdr vect))
(setq end (caar vect))))
(when (or (not (eq start end))
describe-bindings-show-prefix-commands
;; Don't output keymap prefixes.
(not (keymapp definition)))
(when first