From ea1bb263153d406479e782872820af4f9926ac7d Mon Sep 17 00:00:00 2001 From: Juri Linkov Date: Wed, 1 Feb 2023 20:05:52 +0200 Subject: [PATCH] * doc/emacs/basic.texi (Repeating): Mention describe-repeat-maps (bug#61183). * lisp/repeat.el (describe-repeat-maps): Add more explanation to the docstring. Suggested by Robert Pluim . --- doc/emacs/basic.texi | 17 +++++++++-------- lisp/repeat.el | 3 ++- 2 files changed, 11 insertions(+), 9 deletions(-) diff --git a/doc/emacs/basic.texi b/doc/emacs/basic.texi index 2cc45a8805e..d8a354ff42d 100644 --- a/doc/emacs/basic.texi +++ b/doc/emacs/basic.texi @@ -887,6 +887,7 @@ z z z}. The first @kbd{C-x z} repeats the command once, and each subsequent @kbd{z} repeats it once again. @findex repeat-mode +@findex describe-repeat-maps @vindex repeat-exit-key @vindex repeat-exit-timeout Also you can activate @code{repeat-mode} that temporarily enables a @@ -895,11 +896,11 @@ Currently supported shorter key sequences are @kbd{C-x u u} instead of @kbd{C-x u C-x u} to undo many changes, @kbd{C-x o o} instead of @kbd{C-x o C-x o} to switch several windows, @kbd{C-x @{ @{ @} @} ^ ^ v v} to resize the selected window interactively, @kbd{M-g n n p p} to -navigate @code{next-error} matches, and @kbd{C-x ] ] [ [} to navigate -through pages. Any other key exits transient mode and then is -executed normally. The user option @code{repeat-exit-key} defines an -additional key to exit this transient mode. Also it's possible to -break the repetition chain automatically after some idle time by -customizing the user option @code{repeat-exit-timeout} to specify the -idle time in seconds after which this transient mode will be turned -off. +navigate @code{next-error} matches, @kbd{C-x ] ] [ [} to navigate +through pages, and other keys listed by @code{describe-repeat-maps}. +Any other key exits transient mode and then is executed normally. The +user option @code{repeat-exit-key} defines an additional key to exit +this transient mode. Also it's possible to break the repetition chain +automatically after some idle time by customizing the user option +@code{repeat-exit-timeout} to specify the idle time in seconds after +which this transient mode will be turned off. diff --git a/lisp/repeat.el b/lisp/repeat.el index 0124ff4bc0c..ce59b310792 100644 --- a/lisp/repeat.el +++ b/lisp/repeat.el @@ -597,7 +597,8 @@ This function can be used to force exit of repetition while it's active." (defun describe-repeat-maps () "Describe mappings of commands repeatable by symbol property `repeat-map'. -Used in `repeat-mode'." +If `repeat-mode' is enabled, these keymaps determine which single key +can be used to repeat a command invoked via a full key sequence." (interactive) (require 'help-fns) (let ((help-buffer-under-preparation t)) -- 2.39.2