comparison man/gnus.texi @ 78098:1d4e3c3b371a

Merge from gnus--rel--5.10 Patches applied: * emacs--devo--0 (patch 797, 800, 802) - Merge from emacs--rel--22 * gnus--rel--5.10 (patch 233-234) - Merge from emacs--devo--0 - Update from CVS 2007-07-04 Katsumi Yamaoka <[e-mail]> * lisp/gnus/gnus-sum.el (gnus-summary-catchup): Don't recognize cached articles as unfetched articles. 2007-07-02 Reiner Steib <[e-mail]> * lisp/gnus/gnus-start.el (gnus-level-unsubscribed): Improve doc string. 2007-06-26 Katsumi Yamaoka <[e-mail]> * lisp/gnus/gnus-art.el (gnus-article-summary-command-nosave) (gnus-article-read-summary-keys): Don't set the 3rd arg of pop-to-buffer for XEmacs. 2007-07-02 Reiner Steib <[e-mail]> * man/gnus-faq.texi ([3.2]): Fix locating of environment variables in the Control Panel. * man/gnus.texi (Misc Article): Add index entry for gnus-single-article-buffer. 2007-06-27 Andreas Seltenreich <[e-mail]> * man/gnus.texi (Starting Up): Fix typo. 2007-06-25 Katsumi Yamaoka <[e-mail]> * man/gnus.texi (Asynchronous Fetching): Fix typo. Revision: [e-mail]/emacs--rel--22--patch-54

78097:fe022dbdc0e4

@node Starting Up
@chapter Starting Gnus
@cindex starting up

If you are haven't used Emacs much before using Gnus, read @ref{Emacs
for Heathens} first.

@kindex M-x gnus
@findex gnus
If your system administrator has set things up properly, starting Gnus
and reading news is extremely easy---you just type @kbd{M-x gnus} in

the next 30 articles.  If this variable is @code{t}, the back end will
pre-fetch all the articles it can without bound.  If it is
@code{nil}, no pre-fetching will be done.

@vindex gnus-async-prefetch-article-p
@findex gnus-async-read-p
There are probably some articles that you don't want to pre-fetch---read
articles, for instance.  The @code{gnus-async-prefetch-article-p}
variable controls whether an article is to be pre-fetched.  This
function should return non-@code{nil} when the article in question is
to be pre-fetched.  The default is @code{gnus-async-read-p}, which
returns @code{nil} on read articles.  The function is called with an
article data structure as the only parameter.

If, for instance, you wish to pre-fetch only unread articles shorter
than 100 lines, you could say something like:

@table @code

@item gnus-single-article-buffer
@vindex gnus-single-article-buffer
If non-@code{nil}, use the same article buffer for all the groups.
(This is the default.)  If @code{nil}, each group will have its own
article buffer.

@vindex gnus-article-decode-hook

@vindex nnmail-split-header-length-limit
Header lines longer than the value of
@code{nnmail-split-header-length-limit} are excluded from the split
function.

@vindex nnmail-mail-splitting-charset
@vindex nnmail-mail-splitting-decodes
By default, splitting @acronym{MIME}-decodes headers so you
can match on non-@acronym{ASCII} strings.  The
@code{nnmail-mail-splitting-charset} variable specifies the default
charset for decoding.  The behavior can be turned off completely by
binding @code{nnmail-mail-splitting-decodes} to @code{nil}, which is
useful if you want to match articles based on the raw header data.

@vindex nnmail-resplit-incoming
By default, splitting is performed on all incoming messages.  If you
specify a @code{directory} entry for the variable @code{mail-sources}
(@pxref{Mail Source Specifiers}), however, then splitting does

78098:1d4e3c3b371a

@node Starting Up
@chapter Starting Gnus
@cindex starting up

If you haven't used Emacs much before using Gnus, read @ref{Emacs for
Heathens} first.

@kindex M-x gnus
@findex gnus
If your system administrator has set things up properly, starting Gnus
and reading news is extremely easy---you just type @kbd{M-x gnus} in

the next 30 articles.  If this variable is @code{t}, the back end will
pre-fetch all the articles it can without bound.  If it is
@code{nil}, no pre-fetching will be done.

@vindex gnus-async-prefetch-article-p
@findex gnus-async-unread-p
There are probably some articles that you don't want to pre-fetch---read
articles, for instance.  The @code{gnus-async-prefetch-article-p}
variable controls whether an article is to be pre-fetched.  This
function should return non-@code{nil} when the article in question is
to be pre-fetched.  The default is @code{gnus-async-unread-p}, which
returns @code{nil} on read articles.  The function is called with an
article data structure as the only parameter.

If, for instance, you wish to pre-fetch only unread articles shorter
than 100 lines, you could say something like:

@table @code

@item gnus-single-article-buffer
@vindex gnus-single-article-buffer
@cindex article buffers, several
If non-@code{nil}, use the same article buffer for all the groups.
(This is the default.)  If @code{nil}, each group will have its own
article buffer.

@vindex gnus-article-decode-hook

@vindex nnmail-split-header-length-limit
Header lines longer than the value of
@code{nnmail-split-header-length-limit} are excluded from the split
function.

@vindex nnmail-mail-splitting-decodes
@vindex nnmail-mail-splitting-charset
By default, splitting does not decode headers, so you can not match on
non-@acronym{ASCII} strings.  But it is useful if you want to match
articles based on the raw header data.  To enable it, set the
@code{nnmail-mail-splitting-decodes} variable to a non-@code{nil} value.
In addition, the value of the @code{nnmail-mail-splitting-charset}
variable is used for decoding non-@acronym{MIME} encoded string when
@code{nnmail-mail-splitting-decodes} is non-@code{nil}.  The default
value is @code{nil} which means not to decode non-@acronym{MIME} encoded
string.  A suitable value for you will be @code{undecided} or be the
charset used normally in mails you are interested in.

@vindex nnmail-resplit-incoming
By default, splitting is performed on all incoming messages.  If you
specify a @code{directory} entry for the variable @code{mail-sources}
(@pxref{Mail Source Specifiers}), however, then splitting does