[Emacs-diffs] Changes to emacs/man/gnus.texi,v

[Miles Bader]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Miles Bader <miles>     06/12/30 15:34:42

Index: man/gnus.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/gnus.texi,v
retrieving revision 1.101
retrieving revision 1.102
diff -u -b -r1.101 -r1.102
--- man/gnus.texi       15 Dec 2006 01:14:50 -0000      1.101
+++ man/gnus.texi       30 Dec 2006 15:34:42 -0000      1.102
@@ -2810,6 +2810,7 @@
 
 @item auto-expire
 @cindex auto-expire
address@hidden expiring mail
 If the group parameter has an element that looks like @code{(auto-expire
 . t)}, all articles read will be marked as expirable.  For an
 alternative approach, @pxref{Expiring Mail}.
@@ -2818,6 +2819,7 @@
 
 @item total-expire
 @cindex total-expire
address@hidden expiring mail
 If the group parameter has an element that looks like
 @code{(total-expire . t)}, all read articles will be put through the
 expiry process, even if they are not marked as expirable.  Use with
@@ -3407,6 +3409,7 @@
 @item C-c C-x
 @kindex C-c C-x (Group)
 @findex gnus-group-expire-articles
address@hidden expiring mail
 Run all expirable articles in the current group through the expiry
 process (if any) (@code{gnus-group-expire-articles}).  That is, delete
 all expirable articles in the group that have been around for a while.
@@ -3415,6 +3418,7 @@
 @item C-c C-M-x
 @kindex C-c C-M-x (Group)
 @findex gnus-group-expire-all-groups
address@hidden expiring mail
 Run all expirable articles in all groups through the expiry process
 (@code{gnus-group-expire-all-groups}).
 
@@ -3775,6 +3779,7 @@
 @item C-c C-x
 @kindex C-c C-x (Topic)
 @findex gnus-topic-expire-articles
address@hidden expiring mail
 Run all expirable articles in the current group or topic through the
 expiry process (if any)
 (@code{gnus-topic-expire-articles}).  (@pxref{Expiring Mail}).
@@ -10060,6 +10065,7 @@
 @item B e
 @kindex B e (Summary)
 @findex gnus-summary-expire-articles
address@hidden expiring mail
 Run all expirable articles in the current group through the expiry
 process (@code{gnus-summary-expire-articles}).  That is, delete all
 expirable articles in the group that have been around for a while.
@@ -10068,6 +10074,7 @@
 @item B C-M-e
 @kindex B C-M-e (Summary)
 @findex gnus-summary-expire-articles-now
address@hidden expiring mail
 Delete all the expirable articles in the group
 (@code{gnus-summary-expire-articles-now}).  This means that @strong{all}
 articles eligible for expiry in the current group will
@@ -11216,42 +11223,66 @@
 possible but those listed are probably sufficient for most people.
 
 @table @code
address@hidden gnus-treat-buttonize
 @item gnus-treat-buttonize (t, integer)
address@hidden gnus-treat-buttonize-head
 @item gnus-treat-buttonize-head (head)
 
 @xref{Article Buttons}.
 
address@hidden gnus-treat-capitalize-sentences
 @item gnus-treat-capitalize-sentences (t, integer)
address@hidden gnus-treat-overstrike
 @item gnus-treat-overstrike (t, integer)
address@hidden gnus-treat-strip-cr
 @item gnus-treat-strip-cr (t, integer)
address@hidden gnus-treat-strip-headers-in-body
 @item gnus-treat-strip-headers-in-body (t, integer)
address@hidden gnus-treat-strip-leading-blank-lines
 @item gnus-treat-strip-leading-blank-lines (t, integer)
address@hidden gnus-treat-strip-multiple-blank-lines
 @item gnus-treat-strip-multiple-blank-lines (t, integer)
address@hidden gnus-treat-strip-pem
 @item gnus-treat-strip-pem (t, last, integer)
address@hidden gnus-treat-strip-trailing-blank-lines
 @item gnus-treat-strip-trailing-blank-lines (t, last, integer)
address@hidden gnus-treat-unsplit-urls
 @item gnus-treat-unsplit-urls (t, integer)
address@hidden gnus-treat-wash-html
 @item gnus-treat-wash-html (t, integer)
 
 @xref{Article Washing}.
 
address@hidden gnus-treat-date-english
 @item gnus-treat-date-english (head)
address@hidden gnus-treat-date-iso8601
 @item gnus-treat-date-iso8601 (head)
address@hidden gnus-treat-date-lapsed
 @item gnus-treat-date-lapsed (head)
address@hidden gnus-treat-date-local
 @item gnus-treat-date-local (head)
address@hidden gnus-treat-date-original
 @item gnus-treat-date-original (head)
address@hidden gnus-treat-date-user-defined
 @item gnus-treat-date-user-defined (head)
address@hidden gnus-treat-date-ut
 @item gnus-treat-date-ut (head)
 
 @xref{Article Date}.
 
address@hidden gnus-treat-from-picon
 @item gnus-treat-from-picon (head)
address@hidden gnus-treat-mail-picon
 @item gnus-treat-mail-picon (head)
address@hidden gnus-treat-newsgroups-picon
 @item gnus-treat-newsgroups-picon (head)
 
 @xref{Picons}.
 
address@hidden gnus-treat-display-smileys
 @item gnus-treat-display-smileys (t, integer)
 
address@hidden gnus-treat-body-boundary
 @item gnus-treat-body-boundary (head)
 
 @vindex gnus-body-boundary-delimiter
@@ -11260,40 +11291,62 @@
 
 @xref{Smileys}.
 
address@hidden gnus-treat-display-x-face
 @item gnus-treat-display-x-face (head)
 
 @xref{X-Face}.
 
address@hidden gnus-treat-display-face
 @item gnus-treat-display-face (head)
 
 @xref{Face}.
 
address@hidden gnus-treat-emphasize
 @item gnus-treat-emphasize (t, head, integer)
address@hidden gnus-treat-fill-article
 @item gnus-treat-fill-article (t, integer)
address@hidden gnus-treat-fill-long-lines
 @item gnus-treat-fill-long-lines (t, integer)
address@hidden gnus-treat-hide-boring-headers
 @item gnus-treat-hide-boring-headers (head)
address@hidden gnus-treat-hide-citation
 @item gnus-treat-hide-citation (t, integer)
address@hidden gnus-treat-hide-citation-maybe
 @item gnus-treat-hide-citation-maybe (t, integer)
address@hidden gnus-treat-hide-headers
 @item gnus-treat-hide-headers (head)
address@hidden gnus-treat-hide-signature
 @item gnus-treat-hide-signature (t, last)
address@hidden gnus-treat-strip-banner
 @item gnus-treat-strip-banner (t, last)
address@hidden gnus-treat-strip-list-identifiers
 @item gnus-treat-strip-list-identifiers (head)
 
 @xref{Article Hiding}.
 
address@hidden gnus-treat-highlight-citation
 @item gnus-treat-highlight-citation (t, integer)
address@hidden gnus-treat-highlight-headers
 @item gnus-treat-highlight-headers (head)
address@hidden gnus-treat-highlight-signature
 @item gnus-treat-highlight-signature (t, last, integer)
 
 @xref{Article Highlighting}.
 
address@hidden gnus-treat-play-sounds
 @item gnus-treat-play-sounds
address@hidden gnus-treat-translate
 @item gnus-treat-translate
address@hidden gnus-treat-x-pgp-sig
 @item gnus-treat-x-pgp-sig (head)
 
address@hidden gnus-treat-unfold-headers
 @item gnus-treat-unfold-headers (head)
address@hidden gnus-treat-fold-headers
 @item gnus-treat-fold-headers (head)
address@hidden gnus-treat-fold-newsgroups
 @item gnus-treat-fold-newsgroups (head)
address@hidden gnus-treat-leading-whitespace
 @item gnus-treat-leading-whitespace (head)
 
 @xref{Article Header}.
@@ -14511,6 +14564,7 @@
 @node Expiring Mail
 @subsection Expiring Mail
 @cindex article expiry
address@hidden expiring mail
 
 Traditional mail readers have a tendency to remove mail articles when
 you mark them as read, in some way.  Gnus takes a fundamentally
@@ -16454,6 +16508,7 @@
 @item nnimap-expunge-search-string
 @cindex expunging
 @vindex nnimap-expunge-search-string
address@hidden expiring @acronym{IMAP} mail
 
 This variable contain the @acronym{IMAP} search command sent to server when
 searching for articles eligible for expiring.  The default is
@@ -16465,6 +16520,10 @@
 messages instead of the internal article date.  See section 6.4.4 of
 RFC 2060 for more information on valid strings.
 
+However, if @code{nnimap-search-uids-not-since-is-evil} 
+is true, this variable has no effect since the search logic
+is reversed, as described below.
+
 @item nnimap-authinfo-file
 @vindex nnimap-authinfo-file
 
@@ -16490,6 +16549,47 @@
 seem to need this under some circumstances; it was reported that
 Courier 1.7.1 did.
 
address@hidden nnimap-nov-is-evil
address@hidden nnimap-nov-is-evil
address@hidden Courier @acronym{IMAP} server
address@hidden @acronym{NOV}
+
+Never generate or use a local @acronym{NOV} database. Defaults to the
+value of @code{gnus-agent}.
+
+Using a @acronym{NOV} database usually makes header fetching much
+faster, but it uses the @code{UID SEARCH UID} command, which is very
+slow on some servers (notably some versions of Courier). Since the Gnus
+Agent caches the information in the @acronym{NOV} database without using
+the slow command, this variable defaults to true if the Agent is in use,
+and false otherwise.
+
address@hidden nnimap-search-uids-not-since-is-evil
address@hidden nnimap-search-uids-not-since-is-evil
address@hidden Courier @acronym{IMAP} server
address@hidden expiring @acronym{IMAP} mail
+
+Avoid the @code{UID SEARCH UID @var{message numbers} NOT SINCE
address@hidden command, which is slow on some @acronym{IMAP} servers
+(notably, some versions of Courier). Instead, use @code{UID SEARCH SINCE
address@hidden and prune the list of expirable articles within Gnus.
+
+When Gnus expires your mail (@pxref{Expiring Mail}), it starts with a
+list of expirable articles and asks the IMAP server questions like ``Of
+these articles, which ones are older than a week?'' While this seems
+like a perfectly reasonable question, some IMAP servers take a long time
+to answer it, since they seemingly go looking into every old article to
+see if it is one of the expirable ones. Curiously, the question ``Of
address@hidden articles, which ones are newer than a week?'' seems to be
+much faster to answer, so setting this variable causes Gnus to ask this
+question and figure out the answer to the real question itself.
+
+This problem can really sneak up on you: when you first configure Gnus,
+everything works fine, but once you accumulate a couple thousand
+messages, you start cursing Gnus for being so slow. On the other hand,
+if you get a lot of email within a week, setting this variable will
+cause a lot of network traffic between Gnus and the IMAP server.
+
 @end table
 
 @menu
@@ -16677,7 +16777,7 @@
 
 @node Expiring in IMAP
 @subsection Expiring in IMAP
address@hidden expiring imap mail
address@hidden expiring @acronym{IMAP} mail
 
 Even though @code{nnimap} is not a proper @code{nnmail} derived back
 end, it supports most features in regular expiring (@pxref{Expiring
@@ -16696,6 +16796,9 @@
 your server must support permanent storage of client specific flags on
 messages.  Most do, fortunately.
 
+If expiring @acronym{IMAP} mail seems very slow, try setting the server
+variable @code{nnimap-search-uids-not-since-is-evil}.
+
 @table @code
 
 @item nnmail-expiry-wait
@@ -18605,7 +18708,7 @@
 @findex gnus-agent-expire-group
 @cindex agent expiry
 @cindex Gnus agent expiry
address@hidden expiry
address@hidden expiry, in Gnus agent
 
 The Agent back end, @code{nnagent}, doesn't handle expiry.  Well, at
 least it doesn't handle it like other back ends.  Instead, there are
@@ -23324,9 +23427,6 @@
 (gnus-registry-initialize)
 (spam-initialize)
 
-;; @r{I like @kbd{C-s} for marking spam}
-(define-key gnus-summary-mode-map "\C-s" 'gnus-summary-mark-as-spam)
-
 (setq
  spam-log-to-registry t     ; @r{for spam autodetection}
  spam-use-BBDB t
@@ -23898,7 +23998,7 @@
 the default value of @samp{spam}.
 @end defvar
 
address@hidden spam-ifile-database-path
address@hidden spam-ifile-database
 
 This is the filename for the ifile database.  It is not specified by
 default, so ifile will use its own default database name.