From: Paul Nelson Date: Thu, 27 Feb 2025 09:30:13 +0000 (+0100) Subject: Document :continue-only in use-package Info manual X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=27f1c80d9fc36be1ee551d23b856103f294b5ffb;p=emacs.git Document :continue-only in use-package Info manual * doc/misc/use-package.texi (Binding to repeat-maps): Document :continue-only (bug#74140). (cherry picked from commit 3e1d7e0334d884a17887bd1b9ee6a9b9e3026a30) --- diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi index 0ad74603cbc..b31a09bbc2c 100644 --- a/doc/misc/use-package.texi +++ b/doc/misc/use-package.texi @@ -1162,6 +1162,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