Subject: Re: bug#74140: [PATCH] Add :continue-only directive for repeat maps in bind-keys, use-package

From: "Paul D. Nelson" <[email-masked]>
Date: Thu, 27 Feb 2025 10:34:06 +0100

> Should ':continue-only' be documented in the Info manual
> of 'use-package' and 'bind-keys'?

Re. use-package, let me know if this looks good.

In the Info manual, the documentation for bind-keys itself has been
outsourced to its docstring.  I have followed this practice.

>From 3ceedfeaabd276e2566f5a5cc6b0c2f93a91ae64 Mon Sep 17 00:00:00 2001
From: Paul Nelson <[email-masked]>
Date: Thu, 27 Feb 2025 10:30:13 +0100
Subject: [PATCH] Document :continue-only in use-package Info manual

* doc/misc/use-package.texi (Binding to repeat-maps): Document
:continue-only.
---
 doc/misc/use-package.texi | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/doc/misc/use-package.texi b/doc/misc/use-package.texi
index bcb068e6654..e9fdbff5a45 100644
--- a/doc/misc/use-package.texi
+++ b/doc/misc/use-package.texi
@@ -1172,6 +1172,35 @@ Binding to repeat-maps
 @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
-- 
2.39.3 (Apple Git-145)