*** empty log message ***

[gnus] / texi / gnus.texi

diff --git a/texi/gnus.texi b/texi/gnus.texi
index 95048ac..c8b762e 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus

-@settitle Red Gnus 0.79 Manual
+@settitle Gnus 5.4 Manual

 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp


@@ -287,7 +287,7 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
 @tex
 
 @titlepage

-@title Red Gnus 0.79 Manual
+@title Gnus 5.4 Manual

 
 @author by Lars Magne Ingebrigtsen
 @page
 
 @author by Lars Magne Ingebrigtsen
 @page


@@ -314,7 +314,7 @@ into another language, under the above conditions for modified versions.
 
 
 @node Top
 
 
 @node Top

-@top The Red Gnus Newsreader
+@top The Gnus Newsreader

 
 @ifinfo
 
 
 @ifinfo
 


@@ -323,7 +323,7 @@ can be gotten by any nefarious means you can think of---@sc{nntp}, local
 spool or your mbox file.  All at the same time, if you want to push your
 luck.
 
 spool or your mbox file.  All at the same time, if you want to push your
 luck.
 

-This manual corresponds to Red Gnus 0.79
+This manual corresponds to Gnus 5.4.

 
 @end ifinfo
 
 
 @end ifinfo
 


@@ -940,6 +940,9 @@ performance, but if the server does not support the aforementioned
 In any case, if you use @code{some} or @code{nil}, you should definitely
 kill all groups that you aren't interested in to speed things up.
 
 In any case, if you use @code{some} or @code{nil}, you should definitely
 kill all groups that you aren't interested in to speed things up.
 

+Note that this variable also affects active file retrieval from
+secondary select methods.
+

 
 @node Startup Variables
 @section Startup Variables
 
 @node Startup Variables
 @section Startup Variables


@@ -3117,7 +3120,7 @@ Total thread score.
 @item D
 @code{Date}.
 @item d
 @item D
 @code{Date}.
 @item d

-The @code{Date} in @code{YY-MMM} format.
+The @code{Date} in @code{DD-MMM} format.

 @item o
 The @code{Date} in @code{YYYYMMDDTHHMMSS} format.
 @item M
 @item o
 The @code{Date} in @code{YYYYMMDDTHHMMSS} format.
 @item M


@@ -3556,6 +3559,19 @@ Mail a reply to the author of the current article and include the
 original message (@code{gnus-summary-reply-with-original}).  This
 command uses the process/prefix convention.
 
 original message (@code{gnus-summary-reply-with-original}).  This
 command uses the process/prefix convention.
 

+@item S w
+@kindex S w (Summary)
+@findex gnus-summary-wide-reply
+Mail a wide reply to the author of the current article
+(@code{gnus-summary-wide-reply}). 
+
+@item S W
+@kindex S W (Summary)
+@findex gnus-summary-wide-reply-with-original
+Mail a wide reply to the current article and include the original
+message (@code{gnus-summary-reply-with-original}).  This command uses
+the process/prefix convention.
+

 @item S o m
 @kindex S o m (Summary)
 @findex gnus-summary-mail-forward
 @item S o m
 @kindex S o m (Summary)
 @findex gnus-summary-mail-forward


@@ -3602,6 +3618,9 @@ ship a mail to a different account of yours.  (If you're both
 to the @code{root} account, you may want to resend it to
 @code{postmaster}.  Ordnung muß sein!
 
 to the @code{root} account, you may want to resend it to
 @code{postmaster}.  Ordnung muß sein!
 

+This command understands the process/prefix convention
+(@pxref{Process/Prefix}). 
+

 @item S O m
 @kindex S O m (Summary)
 @findex gnus-uu-digest-mail-forward
 @item S O m
 @kindex S O m (Summary)
 @findex gnus-uu-digest-mail-forward


@@ -5916,6 +5935,9 @@ Do word wrap (@code{gnus-article-fill-cited-article}).  If you use this
 function in @code{gnus-article-display-hook}, it should be run fairly
 late and certainly after any highlighting.
 
 function in @code{gnus-article-display-hook}, it should be run fairly
 late and certainly after any highlighting.
 

+You can give the command a numerical prefix to specify the width to use
+when filling.
+

 @item W c
 @kindex W c (Summary)
 @findex gnus-article-remove-cr
 @item W c
 @kindex W c (Summary)
 @findex gnus-article-remove-cr


@@ -6091,6 +6113,17 @@ Display the date in UT (aka. GMT, aka ZULU)
 @findex gnus-article-date-local
 Display the date in the local timezone (@code{gnus-article-date-local}).
 
 @findex gnus-article-date-local
 Display the date in the local timezone (@code{gnus-article-date-local}).
 

+@item W T s
+@kindex W T s (Summary)
+@vindex gnus-article-time-format
+@findex gnus-article-date-user
+@findex format-time-string
+Display the date using a user-defined format
+(@code{gnus-article-date-user}).  The format is specified by the
+@code{gnus-article-time-format} variable, and is a string that's passed
+to @code{format-time-string}.  See the documentation of that variable
+for a list possible format specs.
+

 @item W T e
 @kindex W T e (Summary)
 @findex gnus-article-date-lapsed
 @item W T e
 @kindex W T e (Summary)
 @findex gnus-article-date-lapsed


@@ -6616,8 +6649,8 @@ name, a @code{From} header and a @code{Subject} header.
 @findex gnus-summary-respool-article
 Respool the mail article (@code{gnus-summary-move-article}).
 @code{gnus-summary-respool-default-method} will be used as the default
 @findex gnus-summary-respool-article
 Respool the mail article (@code{gnus-summary-move-article}).
 @code{gnus-summary-respool-default-method} will be used as the default

-method when respooling.  This variable is @code{nil} by default, which
-means that the current group method will be used instead.
+select method when respooling.  This variable is @code{nil} by default,
+which means that the current group select method will be used instead.

 
 @item B w
 @itemx e
 
 @item B w
 @itemx e


@@ -6917,9 +6950,9 @@ Exit the group and go to the previous group
 @kindex Z s (Summary)
 @findex gnus-summary-save-newsrc
 Save the current number of read/marked articles in the dribble buffer
 @kindex Z s (Summary)
 @findex gnus-summary-save-newsrc
 Save the current number of read/marked articles in the dribble buffer

-(@code{gnus-summary-save-newsrc}).  If given a prefix, also save the
-@file{.newsrc} file(s).  Using this command will make exit without
-updating (the @kbd{Q} command) worthless.
+and then save the dribble buffer (@code{gnus-summary-save-newsrc}).  If
+given a prefix, also save the @file{.newsrc} file(s).  Using this
+command will make exit without updating (the @kbd{Q} command) worthless.

 @end table
 
 @vindex gnus-exit-group-hook
 @end table
 
 @vindex gnus-exit-group-hook


@@ -8573,8 +8606,11 @@ argument.  It should return a non-@code{nil} value if it thinks that the
 mail belongs in that group.
 
 The last of these groups should always be a general one, and the regular
 mail belongs in that group.
 
 The last of these groups should always be a general one, and the regular

-expression should @emph{always} be @samp{} so that it matches any
-mails that haven't been matched by any of the other regexps.
+expression should @emph{always} be @samp{} so that it matches any mails
+that haven't been matched by any of the other regexps.  (These rules are
+processed from the beginning of the alist toward the end.  The first
+rule to make a match will "win", unless you have crossposting enabled.
+In that case, all matching rules will "win".)

 
 If you like to tinker with this yourself, you can set this variable to a
 function of your choice.  This function will be called without any
 
 If you like to tinker with this yourself, you can set this variable to a
 function of your choice.  This function will be called without any


@@ -8737,11 +8773,12 @@ If non-@code{nil}, the mail backends will delete the temporary incoming
 file after splitting mail into the proper groups.  This is @code{nil} by
 default for reasons of security.
 
 file after splitting mail into the proper groups.  This is @code{nil} by
 default for reasons of security.
 

-Since Red Gnus is an alpha release, it is to be expected to lose mail.
+@c Since Red Gnus is an alpha release, it is to be expected to lose mail.

 (No Gnus release since (ding) Gnus 0.10 (or something like that) have
 (No Gnus release since (ding) Gnus 0.10 (or something like that) have

-lost mail, I think, but that's not the point.)  By not deleting the
-Incoming* files, one can be sure to not lose mail -- if Gnus totally
-whacks out, one can always recover what was lost.
+lost mail, I think, but that's not the point.  (Except certain versions
+of Red Gnus.))  By not deleting the Incoming* files, one can be sure to
+not lose mail -- if Gnus totally whacks out, one can always recover what
+was lost.

 
 Delete the @file{Incoming*} files at will.
 
 
 Delete the @file{Incoming*} files at will.
 


@@ -11359,8 +11396,8 @@ exploited---the following rule will raise the score on all followups to
 myself: 
 
 @lisp
 myself: 
 
 @lisp

-("references" 
- "<x6[0-9a-z]+\\.fsf@@.*eyesore.no>" 1000 nil r)
+("references"
+ ("<x6[0-9a-z]+\\.fsf@.*eyesore.no>" 1000 nil r))

 @end lisp
 
 Whether it's the first two or first three characters that are ``yours''
 @end lisp
 
 Whether it's the first two or first three characters that are ``yours''


@@ -12615,6 +12652,10 @@ this variable:
 
 If this variable is @code{nil} (which is the default), the mode line
 strings won't be chopped off, and they won't be padded either.
 
 If this variable is @code{nil} (which is the default), the mode line
 strings won't be chopped off, and they won't be padded either.

+Note that the default is unlikely to be desirable, as even the
+percentage complete in the buffer may be crowded off the mode line;
+the user should configure this variable appropriately for their
+configuration.

 
 
 @node Highlighting and Menus
 
 
 @node Highlighting and Menus


@@ -12681,21 +12722,6 @@ Other general variables that influence the look of all buffers include:
 This is the face (i.e., font) used for mouse highlighting in Gnus.  No
 mouse highlights will be done if @code{gnus-visual} is @code{nil}.
 
 This is the face (i.e., font) used for mouse highlighting in Gnus.  No
 mouse highlights will be done if @code{gnus-visual} is @code{nil}.
 

-@item gnus-display-type
-@vindex gnus-display-type
-This variable is symbol indicating the display type Emacs is running
-under.  The symbol should be one of @code{color}, @code{grayscale} or
-@code{mono}.  If Gnus guesses this display attribute wrongly, either set
-this variable in your @file{~/.emacs} or set the resource
-@code{Emacs.displayType} in your @file{~/.Xdefaults}.
-
-@item gnus-background-mode 
-@vindex gnus-background-mode 
-This is a symbol indicating the Emacs background brightness.  The symbol
-should be one of @code{light} or @code{dark}.  If Gnus guesses this
-frame attribute wrongly, either set this variable in your @file{~/.emacs} or
-set the resource @code{Emacs.backgroundMode} in your @file{~/.Xdefaults}. 
-`gnus-display-type'.

 @end table
 
 There are hooks associated with the creation of all the different menus:
 @end table
 
 There are hooks associated with the creation of all the different menus:


@@ -12907,7 +12933,8 @@ by default.
 @item gnus-nocem-groups
 @vindex gnus-nocem-groups
 Gnus will look for NoCeM messages in the groups in this list.  The
 @item gnus-nocem-groups
 @vindex gnus-nocem-groups
 Gnus will look for NoCeM messages in the groups in this list.  The

-default is @code{("alt.nocem.misc" "news.admin.net-abuse.announce")}. 
+default is @code{("news.lists.filters" "news.admin.net-abuse.bulletins"
+"alt.nocem.misc" "news.admin.net-abuse.announce")}. 

 
 @item gnus-nocem-issuers
 @vindex gnus-nocem-issuers
 
 @item gnus-nocem-issuers
 @vindex gnus-nocem-issuers


@@ -13435,16 +13462,18 @@ renamed it back again to ``Gnus''.  But in mixed case.  ``Gnus'' vs.
 ``@sc{gnus}''.  New vs. old.
 
 The first ``proper'' release of Gnus 5 was done in November 1995 when it
 ``@sc{gnus}''.  New vs. old.
 
 The first ``proper'' release of Gnus 5 was done in November 1995 when it

-was included in the Emacs 19.30 distribution.
+was included in the Emacs 19.30 distribution (132 (ding) Gnus releases
+plus 15 Gnus 5.0 releases).

 
 

-In May 1996 the next Gnus generation (aka.  ``September Gnus'') was
-released under the name ``Gnus 5.2''.  
+In May 1996 the next Gnus generation (aka. ``September Gnus'' (after 99
+releases)) was released under the name ``Gnus 5.2'' (40 releases).

 
 

-On July 28th 1996 work on Red Gnus was begun.
+On July 28th 1996 work on Red Gnus was begun, and it was released on
+January 25th 1997 (after 84 releases) as ``Gnus 5.4''.

 
 If you happen upon a version of Gnus that has a name that is prefixed --
 
 If you happen upon a version of Gnus that has a name that is prefixed --

-``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Mamey Sapote Gnus''
--- don't panic.  Don't let it know that you're frightened.  Back away.
+``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'' --
+don't panic.  Don't let it know that you're frightened.  Back away.

 Slowly.  Whatever you do, don't run.  Walk away, calmly, until you're
 out of its reach.  Find a proper released version of Gnus and snuggle up
 to that instead.
 Slowly.  Whatever you do, don't run.  Walk away, calmly, until you're
 out of its reach.  Find a proper released version of Gnus and snuggle up
 to that instead.


@@ -13591,14 +13620,6 @@ consumer information.  After seeing so many badly formatted articles
 coming from @code{tin} and @code{Netscape} I know not to use either of
 those for posting articles.  I would not have known that if it wasn't
 for the @code{X-Newsreader} header.
 coming from @code{tin} and @code{Netscape} I know not to use either of
 those for posting articles.  I would not have known that if it wasn't
 for the @code{X-Newsreader} header.

-
-@item References
-Gnus does line breaking on this header.  I infer from RFC1036 that being
-conservative in what you output is not creating 5000-character lines, so
-it seems like a good idea to me.  However, this standard-to-be says that
-whitespace in the @code{References} header is to be preserved, so...  It
-doesn't matter one way or the other to Gnus, so if somebody tells me
-what The Way is, I'll change it.  Or not.

 @end table
 
 @end table
 @end table
 
 @end table


@@ -13743,6 +13764,7 @@ Also thanks to the following for patches and stuff:
 
 Peter Arius, 
 Marc Auslander,
 
 Peter Arius, 
 Marc Auslander,

+Chris Bone,

 Mark Borges,
 Lance A. Brown,
 Kees de Bruin,
 Mark Borges,
 Lance A. Brown,
 Kees de Bruin,


@@ -13775,6 +13797,7 @@ Lee Iverson,
 Rajappa Iyer,
 Randell Jesup,
 Fred Johansen, 
 Rajappa Iyer,
 Randell Jesup,
 Fred Johansen, 

+Greg Klanderman,

 Peter Skov Knudsen,
 Shuhei Kobayashi, @c Kobayashi
 Thor Kristoffersen,
 Peter Skov Knudsen,
 Shuhei Kobayashi, @c Kobayashi
 Thor Kristoffersen,


@@ -13801,9 +13824,12 @@ Hideki Ono, @c Ono
 William Perry,
 Stephen Peters,
 Ulrich Pfeifer,
 William Perry,
 Stephen Peters,
 Ulrich Pfeifer,

+John McClary Prevost,

 Colin Rafferty,
 Bart Robinson,
 Colin Rafferty,
 Bart Robinson,

+Jason Rumney,

 Loren Schall,
 Loren Schall,

+Dan Schmidt,

 Ralph Schleicher,
 Randal L. Schwartz,
 Danny Siu, 
 Ralph Schleicher,
 Randal L. Schwartz,
 Danny Siu, 


@@ -13825,6 +13851,9 @@ Joe Wells,
 and
 Katsumi Yamaoka. @c Yamaoka
 
 and
 Katsumi Yamaoka. @c Yamaoka
 

+For a full overview of what each person has done, the ChangeLogs
+included in the Gnus alpha distributions should give ample reading
+(550kB and counting).

 
 Apologies to everybody that I've forgotten, of which there are many, I'm
 sure.  
 
 Apologies to everybody that I've forgotten, of which there are many, I'm
 sure.  


@@ -13840,7 +13869,7 @@ actually are people who are using Gnus.  Who'd'a thunk it!
 @menu
 * ding Gnus::          New things in Gnus 5.0/5.1, the first new Gnus.
 * September Gnus::     The Thing Formally Known As Gnus 5.3/5.3.
 @menu
 * ding Gnus::          New things in Gnus 5.0/5.1, the first new Gnus.
 * September Gnus::     The Thing Formally Known As Gnus 5.3/5.3.

-* Red Gnus::           The future---Gnus 5.4/5.5.
+* Red Gnus::           Third time best---Gnus 5.4/5.5.

 @end menu
 
 These lists are, of course, just @emph{short} overviews of the
 @end menu
 
 These lists are, of course, just @emph{short} overviews of the


@@ -15028,13 +15057,6 @@ group and article numbers are when fetching articles by
 on successful article retrievement.
 
 
 on successful article retrievement.
 
 

-@item (nnchoke-open-group GROUP &optional SERVER)
-
-Make @var{group} the current group.  
-
-There should be no data returned by this function.
-
-

 @item (nnchoke-request-group GROUP &optional SERVER FAST)
 
 Get data on @var{group}.  This function also has the side effect of
 @item (nnchoke-request-group GROUP &optional SERVER FAST)
 
 Get data on @var{group}.  This function also has the side effect of