(gnus-summary-kill-thread): Allow universal prefix zero
[gnus] / texi / gnus.texi
index 49aa873..ccb78c2 100644 (file)
@@ -7289,7 +7289,6 @@ Matching}).
 
 @findex gnus-thread-sort-by-total-score
 @findex gnus-thread-sort-by-date
-@findex gnus-thread-sort-by-date-reverse
 @findex gnus-thread-sort-by-score
 @findex gnus-thread-sort-by-subject
 @findex gnus-thread-sort-by-author
@@ -7308,7 +7307,7 @@ By default, sorting is done on article numbers.  Ready-made sorting
 predicate functions include @code{gnus-thread-sort-by-number},
 @code{gnus-thread-sort-by-author}, @code{gnus-thread-sort-by-recipient},
 @code{gnus-thread-sort-by-subject},
-@code{gnus-thread-sort-by-date}, @code{gnus-thread-sort-by-date-reverse},
+@code{gnus-thread-sort-by-date},
 @code{gnus-thread-sort-by-score},
 @code{gnus-thread-sort-by-most-recent-number},
 @code{gnus-thread-sort-by-most-recent-date},
@@ -11053,8 +11052,8 @@ your news admin until she includes the @code{Xref} header in the
 overview files.
 
 If you want Gnus to get the @code{Xref}s right all the time, you have to
-set @code{gnus-nov-is-evil} to @code{t}, which slows things down
-considerably.
+set @code{nntp-nov-is-evil} to @code{t}, which slows things down
+considerably.  Also @pxref{Slow/Expensive Connection}.
 
 C'est la vie.
 
@@ -27995,8 +27994,8 @@ that's already there.  This is not how this manual is written.  When
 implementing something, I write the manual entry for that something
 straight away.  I then see that it's difficult to explain the
 functionality, so I write how it's supposed to be, and then I change the
-implementation.  Writing the documentation and writing the code goes
-hand in hand.
+implementation.  Writing the documentation and writing the code go hand
+in hand.
 
 This, of course, means that this manual has no, or little, flow.  It
 documents absolutely everything in Gnus, but often not where you're
@@ -28004,7 +28003,7 @@ looking for it.  It is a reference manual, and not a guide to how to get
 started with Gnus.
 
 That would be a totally different book, that should be written using the
-reference manual as source material.  It would look quite differently.
+reference manual as source material.  It would look quite different.
 
 
 @page
@@ -28116,11 +28115,32 @@ collection of @acronym{NOV} lines.
 
 @item @acronym{NOV}
 @cindex @acronym{NOV}
+@acronym{NOV} stands for News OverView, which is a type of news server
+header which provide datas containing the condensed header information
+of articles.  They are produced by the server itself; in the @code{nntp}
+back end Gnus uses the ones that the @acronym{NNTP} server makes, but
+Gnus makes them by itself for some backends (in particular, @code{nnml}).
+
 When Gnus enters a group, it asks the back end for the headers of all
 unread articles in the group.  Most servers support the News OverView
 format, which is more compact and much faster to read and parse than the
 normal @sc{head} format.
 
+The @acronym{NOV} data consist of one or more text lines (@pxref{Text
+Lines, ,Motion by Text Lines, elisp, The Emacs Lisp Reference Manual})
+where each line has the header information of one article.  The header
+information is a tab-separated series of the header's contents including
+an article number, a subject, an author, a date, a message-id,
+references, etc.
+
+Those data enable Gnus to generate summary lines quickly.  However, if
+the server does not support @acronym{NOV} or you disable it purposely or
+for some reason, Gnus will try to generate the header information by
+parsing each article's headers one by one.  It will take time.
+Therefore, it is not usually a good idea to set nn*-nov-is-evil
+(@pxref{Slow/Expensive Connection}) to a non-@code{nil} value unless you
+know that the server makes wrong @acronym{NOV} data.
+
 @item level
 @cindex levels
 Each group is subscribed at some @dfn{level} or other (1-9).  The ones
@@ -28270,46 +28290,26 @@ doesn't suddenly decide to fetch the active file anyway.
 
 @item gnus-nov-is-evil
 @vindex gnus-nov-is-evil
-This one has to be @emph{always} @code{nil} (which is the default).  If
-you need not to use @acronym{NOV} (see below) with the @code{nntp} back
-end for example (@pxref{Crosspost Handling}), set
-@code{nntp-nov-is-evil} to a non-@code{nil} value instead of setting
-this.  But you normally have no need to set @code{nntp-nov-is-evil}
-since Gnus by itself will detect whether the @acronym{NNTP} server
-supports @acronym{NOV}.  Anyway, grabbing article headers from the
-@acronym{NNTP} server will not be very fast if you tell Gnus not to use
-@acronym{NOV}.
+Usually this one must @emph{always} be @code{nil} (which is the
+default).  If, for example, you wish to not use @acronym{NOV}
+(@pxref{Terminology}) with the @code{nntp} back end (@pxref{Crosspost
+Handling}), set @code{nntp-nov-is-evil} to a non-@code{nil} value
+instead of setting this.  But you normally do not need to set
+@code{nntp-nov-is-evil} since Gnus by itself will detect whether the
+@acronym{NNTP} server supports @acronym{NOV}.  Anyway, grabbing article
+headers from the @acronym{NNTP} server will not be very fast if you tell
+Gnus not to use @acronym{NOV}.
 
 As the variables for the other back ends, there are
 @code{nndiary-nov-is-evil}, @code{nndir-nov-is-evil},
 @code{nnfolder-nov-is-evil}, @code{nnimap-nov-is-evil},
 @code{nnml-nov-is-evil}, @code{nnspool-nov-is-evil}, and
 @code{nnwarchive-nov-is-evil}.  Note that a non-@code{nil} value for
-@code{gnus-nov-is-evil} overrides all those variables.
+@code{gnus-nov-is-evil} overrides all those variables.@footnote{Although
+the back ends @code{nnkiboze}, @code{nnslashdot}, @code{nnultimate}, and
+@code{nnwfm} don't have their own nn*-nov-is-evil.}
 @end table
 
-@noindent
-What's @acronym{NOV}?
-
-@acronym{NOV} stands for News OverView, which provide data containing
-the condensed header information of articles.  They are what the server
-makes; in the @code{nntp} back end Gnus uses the ones that the
-@acronym{NNTP} server makes, but Gnus makes them by itself in the server
-like @code{nnml} which Gnus performs.  The @acronym{NOV} data consist of
-one or more text lines (@pxref{Text Lines, ,Motion by Text Lines, elisp,
-The Emacs Lisp Reference Manual}) where each line has the header
-information of one article.  The header information is a tab-separated
-series of the header's contents including an article number, a subject,
-an author, a date, a message-id, references, etc.
-
-Those data enable Gnus to generate summary lines fast.  However, if the
-server does not support @acronym{NOV} or you disable it purposely or for
-some reason, Gnus will try to generate the header information by parsing
-article's header one by one.  It will take time.  Therefore, it is not
-usually a good idea to set @code{*-nov-is-evil} to a non-@code{nil}
-value unless there is such a reason that the server makes wrong
-@acronym{NOV} data.
-
 
 @node Slow Terminal Connection
 @subsection Slow Terminal Connection
@@ -28398,7 +28398,7 @@ Set @code{gnus-check-new-newsgroups} and
 
 Set @code{gnus-show-threads}, @code{gnus-use-cross-reference} and
 @code{gnus-nov-is-evil} to @code{nil} to make entering and exiting the
-summary buffer faster.
+summary buffer faster.  Also @pxref{Slow/Expensive Connection}.
 
 
 @page