Importing gnus-5.6.44.

[elisp/gnus.git-] / texi / gnus.texi

diff --git a/texi/gnus.texi b/texi/gnus.texi
index ffcd6f6..12f6261 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -1,12 +1,12 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename gnus

-@settitle Gnus 5.6.33 Manual
+@settitle Gnus 5.6.44 Manual

 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @c @direntry
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @c @direntry

-@c * Gnus: (gnus).         The news reader Gnus.
+@c * Gnus: (gnus).         The newsreader Gnus.

 @c @end direntry
 @iftex
 @finalout
 @c @end direntry
 @iftex
 @finalout

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

-@title Gnus 5.6.33 Manual
+@title Gnus 5.6.44 Manual

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

@@ -354,7 +354,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 Gnus 5.6.33.
+This manual corresponds to Gnus 5.6.44.

 
 @end ifinfo
 
 
 @end ifinfo
 

@@ -1901,6 +1901,13 @@ Currently supported types are @code{babyl}, @code{mbox}, @code{digest},
 this command without a prefix, Gnus will guess at the file type.
 @xref{Document Groups}.
 
 this command without a prefix, Gnus will guess at the file type.
 @xref{Document Groups}.
 

+@item G u
+@kindex G u (Group)
+@vindex gnus-useful-groups
+@findex gnus-group-make-useful-group
+Create one of the groups mentioned in @code{gnus-useful-groups}
+(@code{gnus-group-make-useful-group}).
+

 @item G w
 @kindex G w (Group)
 @findex gnus-group-make-web-group
 @item G w
 @kindex G w (Group)
 @findex gnus-group-make-web-group

@@ -5238,9 +5245,9 @@ Remove articles when exiting the group.
 
 The default value is @code{(read exit)}.
 
 
 The default value is @code{(read exit)}.
 

-@vindex gnus-use-header-prefetch
-If @code{gnus-use-header-prefetch} is non-@code{nil}, prefetch articles
-from the next group.
+@c @vindex gnus-use-header-prefetch
+@c If @code{gnus-use-header-prefetch} is non-@code{nil}, prefetch articles
+@c from the next group.

 
 
 @node Article Caching
 
 
 @node Article Caching

@@ -6309,11 +6316,13 @@ specs are valid:
 
 @table @samp
 @item b
 
 @table @samp
 @item b

-Start point of the hidden text.
+Starting point of the hidden text.

 @item e
 @item e

-End point of the hidden text.
+Ending point of the hidden text.

 @item l
 @item l

-Length of the hidden text.
+Number of characters in the hidden region.
+@item n
+Number of lines of hidden text.

 @end table
 
 @item gnus-cited-lines-visible
 @end table
 
 @item gnus-cited-lines-visible

@@ -8397,6 +8406,14 @@ The attribute value can be a string (used verbatim), a function (the
 return value will be used), a variable (its value will be used) or a
 list (it will be @code{eval}ed and the return value will be used).
 
 return value will be used), a variable (its value will be used) or a
 list (it will be @code{eval}ed and the return value will be used).
 

+If you wish to check whether the message you are about to compose is
+meant to be a news article or a mail message, you can check the values
+of the two dynamically bound variables @code{message-this-is-news} and
+@code{message-this-is-mail}.
+
+@vindex message-this-is-mail
+@vindex message-this-is-news
+

 So here's a new example:
 
 @lisp
 So here's a new example:
 
 @lisp

@@ -8410,6 +8427,8 @@ So here's a new example:
          (signature my-funny-signature-randomizer))
         ((equal (system-name) "gnarly")
          (signature my-quote-randomizer))
          (signature my-funny-signature-randomizer))
         ((equal (system-name) "gnarly")
          (signature my-quote-randomizer))

+        (message-this-is-news
+         (signature my-news-signature))

         (posting-from-work-p
          (signature-file "~/.work-signature")
          (address "user@@bar.foo")
         (posting-from-work-p
          (signature-file "~/.work-signature")
          (address "user@@bar.foo")

@@ -9061,17 +9080,17 @@ waiting for reply, and then reads all the replies.  This is controlled
 by the @code{nntp-maximum-request} variable, and is 400 by default.  If
 your network is buggy, you should set this to 1.
 
 by the @code{nntp-maximum-request} variable, and is 400 by default.  If
 your network is buggy, you should set this to 1.
 

-@c @item nntp-connection-timeout
-@c @vindex nntp-connection-timeout
-@c If you have lots of foreign @code{nntp} groups that you connect to
-@c regularly, you're sure to have problems with @sc{nntp} servers not
-@c responding properly, or being too loaded to reply within reasonable
-@c time.  This is can lead to awkward problems, which can be helped
-@c somewhat by setting @code{nntp-connection-timeout}.  This is an integer
-@c that says how many seconds the @code{nntp} backend should wait for a
-@c connection before giving up.  If it is @code{nil}, which is the default,
-@c no timeouts are done.
-@c 
+@item nntp-connection-timeout
+@vindex nntp-connection-timeout
+If you have lots of foreign @code{nntp} groups that you connect to
+regularly, you're sure to have problems with @sc{nntp} servers not
+responding properly, or being too loaded to reply within reasonable
+time.  This is can lead to awkward problems, which can be helped
+somewhat by setting @code{nntp-connection-timeout}.  This is an integer
+that says how many seconds the @code{nntp} backend should wait for a
+connection before giving up.  If it is @code{nil}, which is the default,
+no timeouts are done.
+

 @c @item nntp-command-timeout
 @c @vindex nntp-command-timeout
 @c @cindex PPP connections
 @c @item nntp-command-timeout
 @c @vindex nntp-command-timeout
 @c @cindex PPP connections

@@ -10384,8 +10403,25 @@ The name of the group descriptions file.  @xref{Newsgroups File Format}.
 @item nnfolder-get-new-mail
 @vindex nnfolder-get-new-mail
 If non-@code{nil}, @code{nnfolder} will read incoming mail.
 @item nnfolder-get-new-mail
 @vindex nnfolder-get-new-mail
 If non-@code{nil}, @code{nnfolder} will read incoming mail.

+
+@item nnfolder-save-buffer-hook
+@vindex nnfolder-save-buffer-hook
+@cindex backup files
+Hook run before saving the folders.  Note that Emacs does the normal
+backup renaming of files even with the @code{nnfolder} buffers.  If you
+wish to switch this off, you could say something like the following in
+your @file{.emacs} file:
+
+@lisp
+(defun turn-off-backup ()
+  (set (make-local-variable 'backup-inhibited) t))
+
+(add-hook 'nnfolder-save-buffer-hook 'turn-off-backup)
+@end lisp
+

 @end table
 
 @end table
 

+

 @findex nnfolder-generate-active-file
 @kindex M-x nnfolder-generate-active-file
 If you have lots of @code{nnfolder}-like files you'd like to read with
 @findex nnfolder-generate-active-file
 @kindex M-x nnfolder-generate-active-file
 If you have lots of @code{nnfolder}-like files you'd like to read with

@@ -11247,6 +11283,18 @@ common.  If that's the case, you should set this variable to @code{t}.
 Or you can just tap @code{M-g} on the virtual group every time before
 you enter it---it'll have much the same effect.
 
 Or you can just tap @code{M-g} on the virtual group every time before
 you enter it---it'll have much the same effect.
 

+@code{nnvirtual} can have both mail and news groups as component groups.
+When responding to articles in @code{nnvirtual} groups, @code{nnvirtual}
+has to ask the backend of the component group the article comes from
+whether it is a news or mail backend.  However, when you do a @kbd{^},
+there is typically no sure way for the component backend to know this,
+and in that case @code{nnvirtual} tells Gnus that the article came from a
+not-news backend.  (Just to be on the safe side.)
+
+@kbd{C-c C-t} in the message buffer will insert the @code{Newsgroups}
+line from the article you respond to in these cases.
+
+

 
 @node Kibozed Groups
 @subsection Kibozed Groups
 
 @node Kibozed Groups
 @subsection Kibozed Groups

@@ -12038,8 +12086,8 @@ Score on the subject line.
 @item x
 Score on the Xref line---i.e., the cross-posting line.
 
 @item x
 Score on the Xref line---i.e., the cross-posting line.
 

-@item t
-Score on thread---the References line.
+@item r
+Score on the References line.

 
 @item d
 Score on the date.
 
 @item d
 Score on the date.

@@ -12058,6 +12106,10 @@ Score on the body.
 
 @item h
 Score on the head.
 
 @item h
 Score on the head.

+
+@item t
+Score on thead.
+

 @end table
 
 @item
 @end table
 
 @item

@@ -15826,13 +15878,16 @@ Rajappa Iyer,
 Andreas Jaeger,
 Randell Jesup,
 Fred Johansen,
 Andreas Jaeger,
 Randell Jesup,
 Fred Johansen,

+Gareth Jones,

 Simon Josefsson,
 Greg Klanderman,
 Karl Kleinpaste,
 Peter Skov Knudsen,
 Shuhei Kobayashi, @c Kobayashi
 Simon Josefsson,
 Greg Klanderman,
 Karl Kleinpaste,
 Peter Skov Knudsen,
 Shuhei Kobayashi, @c Kobayashi

+Koseki Yoshinori, @c Koseki

 Thor Kristoffersen,
 Jens Lautenbacher,
 Thor Kristoffersen,
 Jens Lautenbacher,

+Martin Larose,

 Seokchan Lee, @c Lee
 Carsten Leonhardt,
 James LewisMoss,
 Seokchan Lee, @c Lee
 Carsten Leonhardt,
 James LewisMoss,

@@ -15864,7 +15919,9 @@ William Perry,
 Stephen Peters,
 Jens-Ulrik Holger Petersen,
 Ulrich Pfeifer,
 Stephen Peters,
 Jens-Ulrik Holger Petersen,
 Ulrich Pfeifer,

+Matt Pharr,

 John McClary Prevost,
 John McClary Prevost,

+Bill Pringlemeir,

 Mike Pullen,
 Jim Radford,
 Colin Rafferty,
 Mike Pullen,
 Jim Radford,
 Colin Rafferty,

@@ -15903,6 +15960,7 @@ Teddy,
 Chuck Thompson,
 Philippe Troin,
 James Troup,
 Chuck Thompson,
 Philippe Troin,
 James Troup,

+Trung Tran-Duc,

 Aaron M. Ucko,
 Aki Vehtari,
 Didier Verna,
 Aaron M. Ucko,
 Aki Vehtari,
 Didier Verna,

@@ -15935,7 +15993,7 @@ actually are people who are using Gnus.  Who'd'a thunk it!
 * 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::           Third time best---Gnus 5.4/5.5.
 * 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::           Third time best---Gnus 5.4/5.5.

-* Quassia Gnus::       Two times two is four, or Gnus 5.6.
+* Quassia Gnus::       Two times two is four, or Gnus 5.6/5.7.

 @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

@@ -17794,6 +17852,13 @@ Group parameters and summary commands for un/subscribing to mailing
 lists. 
 
 @item
 lists. 
 
 @item

+Introduce nnmail-home-directory.
+
+@item
+gnus-fetch-group and friends should exit Gnus when the user
+exits the group.
+
+@item

 Solve the halting problem.
 
 @c TODO
 Solve the halting problem.
 
 @c TODO