* gnus.texi (Choosing Commands): Addition.

(Predicate Specifiers): New.

diff --git a/texi/ChangeLog b/texi/ChangeLog
index 81b2bcf..ec70804 100644 (file)
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -3,6 +3,9 @@
        * gnus.texi (Choosing Commands): Addition.
        (Article Display): Update.
        (Article Display): Addition.
+       (Article Header): New.
+       (Slow Terminal Connection): Addition.
+       (Predicate Specifiers): New.
 
 2001-12-31  Rui Zhu  <sprache@iname.com>
 

diff --git a/texi/gnus.texi b/texi/gnus.texi
index 6541ea8..3b89138 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -7552,6 +7552,7 @@ these articles easier.
 * Article Fontisizing::     Making emphasized text look nice.
 * Article Hiding::          You also want to make certain info go away.
 * Article Washing::         Lots of way-neat functions to make life better.
+* Article Header::          Doing various header transformations.
 * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.
 * Article Date::            Grumble, UT!
 * Article Display::         Display various stuff---X-Face, Picons, Smileys
@@ -8079,17 +8080,6 @@ message.@footnote{PGP keys for many hierarchies are available at
 Verify a signed (PGP, PGP/MIME or S/MIME) message
 (@code{gnus-summary-force-verify-and-decrypt}).
 
-@item W u
-@kindex W u (Summary)
-@findex gnus-article-treat-unfold-headers
-Unfold folded header lines (@code{gnus-article-treat-unfold-headers}).
-
-@item W n
-@kindex W n (Summary)
-@findex gnus-article-treat-fold-newsgroups
-Fold the @code{Newsgroups} and @code{Followup-To} headers
-(@code{gnus-article-treat-fold-newsgroups}).
-
 @item W W H
 @kindex W W H (Summary)
 @findex gnus-article-strip-headers-from-body
@@ -8144,6 +8134,33 @@ body (@code{gnus-article-strip-trailing-space}).
 @xref{Customizing Articles}, for how to wash articles automatically.
 
 
+@node Article Header
+@subsection Article Header
+
+These commands perform various transformations of article header.
+
+@table @kbd
+
+@item W G u
+@kindex W G u (Summary)
+@findex gnus-article-treat-unfold-headers
+Unfold folded header lines (@code{gnus-article-treat-unfold-headers}).
+
+@item W G n
+@kindex W G n (Summary)
+@findex gnus-article-treat-fold-newsgroups
+Fold the @code{Newsgroups} and @code{Followup-To} headers
+(@code{gnus-article-treat-fold-newsgroups}).
+
+@item W G f
+@kindex W G f (Summary)
+@findex gnus-article-treat-fold-header
+Fold all the message headers
+(@code{gnus-article-treat-fold-headers}).
+
+@end table
+
+
 @node Article Buttons
 @subsection Article Buttons
 @cindex buttons
@@ -10259,6 +10276,7 @@ possible but those listed are probably sufficient for most people.
 @item gnus-treat-mail-picon (head)
 @item gnus-treat-newsgroups-picon (head)
 @item gnus-treat-unfold-headers (head)
+@item gnus-treat-fold-headers (head)
 @item gnus-treat-fold-newsgroups (head)
 @item gnus-treat-body-boundary (head)
 @end table
@@ -14264,6 +14282,7 @@ Put that in your @file{.emacs} file, and hitting links in w3-rendered
 @sc{html} in the Gnus article buffers will use @code{browse-url} to
 follow the link.
 
+
 @node IMAP
 @section @sc{imap}
 @cindex nnimap
@@ -18293,6 +18312,7 @@ four days, Gnus will decay the scores four times, for instance.
 * Daemons::                 Gnus can do things behind your back.
 * NoCeM::                   How to avoid spam and other fatty foods.
 * Undo::                    Some actions can be undone.
+* Predicate Specifiers::    Specifying predicates.
 * Moderation::              What to do if you're a moderator.
 * Image Enhancements::      Modern versions of Emacs/XEmacs can display images.
 * Fuzzy Matching::          What's the big fuzz?
@@ -18489,6 +18509,7 @@ less than 4 characters wide.
 Also Gnus supports some extended format specifications, such as
 @samp{%&user-date;}.
 
+
 @node Mode Line Formatting
 @subsection Mode Line Formatting
 
@@ -19472,6 +19493,33 @@ command, which should feel kinda like the normal Emacs @code{undo}
 command.
 
 
+@node Predicate Specifiers
+@section Predicate Specifiers
+@cindex predicate specifiers
+
+Some Gnus variables are @dfn{predicate specifiers}.  This is a special
+form that allows flexible specification of predicates without having
+to type all that much.
+
+These specifiers are lists consisting of functions, symbols and lists.
+
+Here's an example:
+
+@lisp
+(or gnus-article-unseen-p
+    gnus-article-unread-p)
+@end lisp
+
+The available symbols are @code{or}, @code{and} and @code{not}.  The
+functions all take one parameter.
+
+@findex gnus-make-predicate
+Internally, Gnus calls @code{gnus-make-predicate} on these specifiers
+to create a function that can be called.  This input parameter to this
+function will be passed along to all the functions in the predicate
+specifier. 
+
+
 @node Moderation
 @section Moderation
 @cindex moderation
@@ -21967,6 +22015,22 @@ want to read them anyway.
 If this is non-@code{nil}, all threads in the summary buffer will be
 hidden initially.
 
+This can also be a predicate specifier (@pxref{Predicate Specifiers}).
+Avaliable predicates are @code{gnus-article-unread-p} and
+@code{gnus-article-unseen-p}).
+
+Here's an example:
+
+@lisp
+(setq gnus-thread-hide-subtree
+      '(or gnus-article-unread-p
+           gnus-article-unseen-p))
+@end lisp
+
+(It's a pretty nonsensical example, since all unseen articles are also
+unread, but you get my drift.)
+
+
 @item gnus-updated-mode-lines
 If this is @code{nil}, Gnus will not put information in the buffer mode
 lines, which might save some time.