Re: Sticky article buffers

[Tassilo Horn <tassilo@member.fsf.org>]

Hi,

and sorry for the incomplete patch.  I wasn't aware of the fact that cvs
diff commands don't operate on all marked files by default in pcl-cvs.
Here's the complete patch.

--8<---------------cut here---------------start------------->8---
Index: texi/gnus.texi
===================================================================
RCS file: /usr/local/cvsroot/gnus/texi/gnus.texi,v
retrieving revision 7.242
diff -u -r7.242 gnus.texi
--- texi/gnus.texi	10 Aug 2007 02:34:24 -0000	7.242
+++ texi/gnus.texi	13 Aug 2007 14:02:35 -0000
@@ -496,6 +496,7 @@
 * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
 * Article Caching::             You may store articles in a cache.
 * Persistent Articles::         Making articles expiry-resistant.
+* Sticky Articles::             Article buffers that are not reused.
 * Article Backlog::             Having already read articles hang around.
 * Saving Articles::             Ways of customizing article saving.
 * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
@@ -4598,6 +4599,7 @@
 * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
 * Article Caching::             You may store articles in a cache.
 * Persistent Articles::         Making articles expiry-resistant.
+* Sticky Articles::             Article buffers that are not reused.
 * Article Backlog::             Having already read articles hang around.
 * Saving Articles::             Ways of customizing article saving.
 * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
@@ -7484,6 +7486,53 @@
 (setq gnus-use-cache 'passive)
 @end lisp
 
+@node Sticky Articles
+@section Sticky Articles
+@cindex sticky articles
+
+When you select an article the current article buffer will be reused
+according to the value of the variable
+@code{gnus-single-article-buffer}.  If its value is non-nil (the
+default) all articles reuse the same article buffer.  Else each group
+has its own article buffer.
+
+This implies that it's not possible to have more than one article buffer
+in a group at a time.  But sometimes you might want to display all the
+latest emails from your mother, your father, your aunt, your uncle and
+your 17 cousins to coordinate the next christmas party.
+
+That's where sticky articles come in handy.  A sticky article buffer
+basically is a normal article buffer, but it won't be reused when you
+select another article.  You can make an article sticky with:
+
+@table @kbd
+@item A S
+@kindex A S (Summary)
+@findex gnus-sticky-article
+Make the current article sticky.  If a prefix arg is given, ask for a
+name for this sticky article buffer.
+@end table
+
+To close a sticky article buffer you can use these commands:
+
+@table @kbd
+@item q
+@kindex q (Article)
+@findex bury-buffer
+Puts this sticky article buffer at the end of the list of all buffers.
+
+@item k
+@kindex k (Article)
+@findex gnus-kill-sticky-article-buffer
+Kills this sticky article buffer.
+@end table
+
+To kill all sticky article buffers you can use:
+
+@defun gnus-kill-sticky-article-buffers ARG
+Kill all sticky article buffers.
+If a prefix ARG is given, ask for confirmation.
+@end defun
 
 @node Article Backlog
 @section Article Backlog
@@ -26195,6 +26244,7 @@
 P. E. Jareth Hein,
 Hisashige Kenji, @c Hisashige
 Scott Hofmann,
+Tassilo Horn,
 Marc Horowitz,
 Gunnar Horrigmo,
 Richard Hoskins,
Index: texi/gnus-news.texi
===================================================================
RCS file: /usr/local/cvsroot/gnus/texi/gnus-news.texi,v
retrieving revision 7.52
diff -u -r7.52 gnus-news.texi
--- texi/gnus-news.texi	4 Jul 2007 19:39:52 -0000	7.52
+++ texi/gnus-news.texi	13 Aug 2007 14:02:37 -0000
@@ -69,6 +69,11 @@
 @item Changes in summary and article mode
 
 @itemize @bullet
+
+@item Gnus now supports sticky article buffers.  Those are article buffers
+that are not reused when you select another article.  @xref{Sticky
+Articles}.
+
 @item International host names (@acronym{IDNA}) can now be decoded
 inside article bodies using @kbd{W i}
 (@code{gnus-summary-idna-message}).  This requires that GNU Libidn
Index: texi/ChangeLog
===================================================================
RCS file: /usr/local/cvsroot/gnus/texi/ChangeLog,v
retrieving revision 7.343
diff -u -r7.343 ChangeLog
--- texi/ChangeLog	10 Aug 2007 02:34:24 -0000	7.343
+++ texi/ChangeLog	13 Aug 2007 14:02:44 -0000
@@ -1,3 +1,9 @@
+2007-08-13  Tassilo Horn  <tassilo@member.fsf.org>
+
+	* gnus-news.texi: Mention sticky article buffers.
+
+	* gnus.texi (Sticky Articles): Documentation for sticky article buffers.
+
 2007-08-10  Katsumi Yamaoka  <yamaoka@jpl.org>
 
 	* gnus.texi (NNTP): Mention nntp-xref-number-is-evil.
--8<---------------cut here---------------end--------------->8---

Bye,
Tassilo
-- 
GNU Emacs is a text editor for Über-Geeks.