Re: Key prefix reserved for users in Gnus

[Reiner Steib <reinersteib+from-uce@imap.cc>]

On Wed, Jan 25 2006, Reiner Steib wrote:

> in Emacs, `C-c [letter]' is reserved for users (the user may also use
> it as a prefix: `C-c a a', `C-c a b', ...).
>
> In the most important Gnus modes like group, summary and article
> buffers, there are only very few unbound single lowercase letter keys
> (only `v' and `y', AFAICS).  IMHO, it would be nice to declare one of
> these keys as "reserved for users" to avoid that users override
> standard Gnus bindings.  I'd vote for `v'.  Opinions?

I'll install the following change to trunk and v5-10 (please suggest
better wording or other improvements):

--8<---------------cut here---------------start------------->8---
--- gnus.texi	07 Apr 2006 14:43:53 +0200	6.603.2.80
+++ gnus.texi	09 Apr 2006 14:31:05 +0200	
@@ -4043,6 +4043,22 @@
 
 @table @kbd
 
+@item v
+@kindex v (Group)
+@cindex keys, reserved for users (Group)
+The key @kbd{v} is reserved for users.  You can bind it key to some
+function or better use it as a prefix key.  For example:
+
+@lisp
+(define-key gnus-group-mode-map (kbd "v j d")
+  (lambda ()
+    (interactive)
+    (gnus-group-jump-to-group "nndraft:drafts")))
+@end lisp
+
+On keys reserved for users in Emacs and on keybindings in general
+@xref{Keymaps, Keymaps, , emacs, The Emacs Editor}.
+
 @item ^
 @kindex ^ (Group)
 @findex gnus-group-enter-server-mode
@@ -4438,6 +4454,14 @@
 
 You can have as many summary buffers open as you wish.
 
+@kindex v (Summary)
+@cindex keys, reserved for users (Summary)
+The key @kbd{v} is reserved for users.  You can bind it key to some
+function or better use it as a prefix key.  For example:
+@lisp
+(define-key gnus-summary-mode-map (kbd "v -") "LrS") ;; lower subthread
+@end lisp
+
 @menu
 * Summary Buffer Format::       Deciding how the summary buffer is to look.
 * Summary Maneuvering::         Moving around the summary buffer.
@@ -11242,6 +11266,11 @@
 buffer displayed while reading.  You can do it all from the article
 buffer.
 
+@kindex v (Article)
+@cindex keys, reserved for users (Article)
+The key @kbd{v} is reserved for users.  You can bind it key to some
+function or better use it as a prefix key.
+
 A few additional keystrokes are available:
 
 @table @kbd
@@ -12272,6 +12301,12 @@
 
 @table @kbd
 
+@item v
+@kindex v (Server)
+@cindex keys, reserved for users (Server)
+The key @kbd{v} is reserved for users.  You can bind it key to some
+function or better use it as a prefix key.
+
 @item a
 @kindex a (Server)
 @findex gnus-server-add-server
--8<---------------cut here---------------end--------------->8---

Bye, Reiner.
-- 
       ,,,
      (o o)
---ooO-(_)-Ooo---  |  PGP key available  |  http://rsteib.home.pages.de/