From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/65043 Path: news.gmane.org!not-for-mail From: Tassilo Horn Newsgroups: gmane.emacs.gnus.general Subject: Re: Sticky article buffers Date: Mon, 13 Aug 2007 15:03:56 +0200 Message-ID: <87hcn3oabn.fsf@baldur.tsdh.de> References: <876448eby7.fsf@baldur.tsdh.de> <87ir888cgd.fsf@baldur.tsdh.de> <873ayprmja.fsf@baldur.tsdh.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1187010371 4090 80.91.229.12 (13 Aug 2007 13:06:11 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 13 Aug 2007 13:06:11 +0000 (UTC) To: ding@gnus.org Original-X-From: ding-owner+M13553@lists.math.uh.edu Mon Aug 13 15:06:05 2007 Return-path: Envelope-to: ding-account@gmane.org Original-Received: from util0.math.uh.edu ([129.7.128.18]) by lo.gmane.org with esmtp (Exim 4.50) id 1IKZbZ-00079k-MJ for ding-account@gmane.org; Mon, 13 Aug 2007 15:05:45 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by util0.math.uh.edu with smtp (Exim 4.63) (envelope-from ) id 1IKZat-0003SM-Px; Mon, 13 Aug 2007 08:04:27 -0500 Original-Received: from mx1.math.uh.edu ([129.7.128.32]) by util0.math.uh.edu with esmtps (TLSv1:AES256-SHA:256) (Exim 4.63) (envelope-from ) id 1IKZar-0003Rz-Gz for ding@lists.math.uh.edu; Mon, 13 Aug 2007 08:04:25 -0500 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx1.math.uh.edu with esmtp (Exim 4.67) (envelope-from ) id 1IKZam-0004PE-KK for ding@lists.math.uh.edu; Mon, 13 Aug 2007 08:04:25 -0500 Original-Received: from main.gmane.org ([80.91.229.2] helo=ciao.gmane.org) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1IKZal-000208-00 for ; Mon, 13 Aug 2007 15:04:19 +0200 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1IKZac-0005Ct-7Z for ding@gnus.org; Mon, 13 Aug 2007 15:04:10 +0200 Original-Received: from dslb-084-063-021-197.pools.arcor-ip.net ([84.63.21.197]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 13 Aug 2007 15:04:10 +0200 Original-Received: from tassilo by dslb-084-063-021-197.pools.arcor-ip.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 13 Aug 2007 15:04:10 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 114 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: dslb-084-063-021-197.pools.arcor-ip.net Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAD1BMVEU8PDyjo6P5+fm+v8F/ gIO4imEzAAAACXBIWXMAAArrAAAK6wGCiw1aAAAATnRFWHRSYXcgcHJvZmlsZSB0eXBlIGV4aWYA CmV4aWYKICAgICAgMjAKNDU3ODY5NjYwMDAwNGQ0ZDAwMmEwMDAwMDAwODAwMDAwMDAwMDAwMAqJ uBZbAAAACXZwQWcAAAAwAAAAMADO7oxXAAABnklEQVQ4y6WU0YGDIAyGozIAFAY4iAM0iQNAZf+Z LkBrr1f7cseDIp8JyZ8ApA8D/gaiI/9cQne5A6wAcJCYwcwdIEEbbqyH/tGBZHjZ6apgbuALgF/2 XQfArK826CB5gGGA3gUNr9taMApkGLQIbIYeatRNQVcaiBbgCG6ADRadu77aqJo07w3M3W0bdQIo /a+HBQ4/pT1Y/2pRhZaeNTsRBTvlAlPMD6C+kS2UIEvZN7hnHsckwkT+koyjh1ZxTK5QZPdozEWl W7qIum60CJVMIcnGX7um0DWbVIy6Wc+ca6WeGHTNluTIiBNJa65yO0oLN/Q0sTAjglExj2ZglOvC CZNgzvUHQJE8tSIThzTqcy+qBFN6TTz9bB+kAE5rtBo2ifkJKM+roIK8EOPlAGg1GWFJuAEz3V5a tAHxuDmXf/WuZ4w7Ct1b5gmcYJo1ujcQVahNMxf7+xgUlnXHYOYTwMGY/HZwnIalnuobiF4VoxOL VCQ++vsVRKfBLmfA+O3UIgXv8ilIJcD5OQ92PgcrfLgZvvKnK2P9zyXzDWhiiUxowX0ZAAAAGnpU WHRqcGVnOmNvbG9yc3BhY2UAAHjaMwIAADMAM4k4IzUAAAAmelRYdGpwZWc6c2FtcGxpbmctZmFj dG9yAAB42jOqMNIxrDAEYQARgwLpPZcvTwAAAABJRU5ErkJggg== User-Agent: Gnus/5.110007 (No Gnus v0.7) Emacs/22.1.50 (gnu/linux) Cancel-Lock: sha1:B+bAh2c9LkqnApESCEdqCfNlmGI= X-Spam-Score: -2.6 (--) List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:65043 Archived-At: Reiner Steib writes: Hi Reiner, >> Is there something to create them automatically, so that I only need >> to add comments to the functions I cahnged? > > Sure: When point is inside the modified defun, defcustom, ... (in the > lisp or texi file or in the diff buffer) you can use `C-x 4 a' > (`add-change-log-entry-other-window' or `M-x add-change-log-entry > RET'). Nifty. >>> - Could you provide documentation for texi/gnus.texi and an entry >>> for texi/gnus-news.texi? >> >> I think this applies to the current patch as well as to future >> contributions, right? > > Yes. Ok, here's the patch, created with pcl-cvs which is indeed very nice. --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 13:00:17 -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, --8<---------------cut here---------------end--------------->8--- Bye, Tassilo