Document :continue-only in use-package Info manual

* doc/misc/use-package.texi (Binding to repeat-maps): Document
:continue-only (bug#74140).
This commit is contained in:
Paul Nelson 2025-02-27 10:30:13 +01:00 committed by Juri Linkov
parent dc1637fef7
commit 3e1d7e0334

View file

@ -1172,6 +1172,35 @@ Specifying @code{:continue} @emph{forces} setting the
@end group
@end lisp
@findex :continue-only@r{, inside} :repeat-map@r{ and} :bind
@cindex binding commands that only continue repeat series
Specifying @code{:continue-only} inside the scope of @code{:repeat-map}
will make commands continue an active repeating sequence, but never
initiate it. This is done by setting the @code{repeat-continue}
property of each command with the keymap, but not the @code{repeat-map}
property. This is useful for commands that should be available while
repeating a sequence, but not initiate the repeat map themselves.
Example:
@lisp
@group
(use-package emacs
:bind
(:repeat-map
paragraph-repeat-map
("@}" . forward-paragraph)
("@{" . backward-paragraph)
("]" . forward-paragraph)
("[" . backward-paragraph)
:continue-only
("h" . mark-paragraph)
("w" . kill-region)
("M-w" . kill-ring-save)
("k" . kill-paragraph)
("y" . yank)))
@end group
@end lisp
@node Displaying keybindings
@subsection Displaying personal keybindings
@cindex display your keybindings