comparison man/gnus.texi @ 34547:44a6d536cea3

Changes from Gnus CVS and fixes.

34546:51be06b616bf

You can read news (and mail) from within Emacs by using Gnus.  The news
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.

This manual corresponds to Gnus 5.8.7.

@end ifinfo

@iftex

@cindex moving articles
If you move (or copy) articles regularly, you might wish to have Gnus
suggest where to put the articles.  @code{gnus-move-split-methods} is a
variable that uses the same syntax as @code{gnus-split-methods}
(@pxref{Saving Articles}).  You may customize that variable to create
suggestions you find reasonable.

@lisp
(setq gnus-move-split-methods
      '(("^From:.*Lars Magne" "nnml:junk")
        ("^Subject:.*gnus" "nnfolder:important")

@enumerate
@item
The file contains one or more line, each of which define one server.

@item
Each line may contain an arbitrary number of token/value pairs.  The
valid tokens include @samp{machine}, @samp{login}, @samp{password},
@samp{default}, @samp{port} and @samp{force}.  (The latter is not a
valid @file{.netrc}/@code{ftp} token, which is almost the only way the
@file{.authinfo} file format deviates from the @file{.netrc} file
format.)

@end enumerate

Here's an example file:

In-Reply-To) header of each message to split and searches the file
specified by @code{nnmail-message-id-cache-file} for the message ids.
When it has found a parent, it returns the corresponding group name.  It
is recommended that you set @code{nnmail-message-id-cache-length} to a
somewhat higher number than the default so that the message ids are
still in the cache.  (A value of 5000 appears to create a file some
300 kBytes in size.)


@node Group Mail Splitting
@subsection Group Mail Splitting
@cindex mail splitting

@code{gnus-group-split} will do cross-posting on all groups that match,
by defining a single @code{&} fancy split containing one split for each
group.  If a message doesn't match any split, it will be stored in the
group named in @code{gnus-group-split-default-catch-all-group}, unless
some group has @var{split-spec} set to @code{catch-all}, in which case
that group is used as the catch-all group.  Note that, in this case,
there's no cross-posting, as a @code{|} fancy split encloses the
@code{&} split and the catch-all group.

It's time for an example.  Assume the following group parameters have
been defined:

@example

@end lisp

@var{groups} may be a regular expression or a list of group names whose
parameters will be scanned to generate the output split.
@var{no-crosspost} can be used to disable cross-posting; in this case, a
single @code{|} split will be output.  @var{catch-all} may be the name
of a group to be used as the default catch-all group.  If
@var{catch-all} is @code{nil}, or if @var{split-regexp} matches the
empty string in any selected group, no catch-all split will be issued.
Otherwise, if some group has @var{split-spec} set to @code{catch-all},
this group will override the value of the @var{catch-all} argument.

@findex gnus-group-split-setup
Unfortunately, scanning all groups and their parameters can be quite
slow, especially considering that it has to be done for every message.
But don't despair!  The function @code{gnus-group-split-setup} can be
used to select @code{gnus-group-split} in a much more efficient way.  It
sets @code{nnmail-split-methods} to @code{nnmail-split-fancy} and sets
@code{nnmail-split-fancy} to the split produced by
@code{gnus-group-split-fancy}.  Thus, the group parameters are only
scanned once, no matter how many messages are split.

@end lisp

If @var{auto-update} is non-@code{nil}, @code{gnus-group-split-update}
will be added to @code{nnmail-pre-get-new-mail-hook}, so you won't ever
have to worry about updating @code{nnmail-split-fancy} again.  If you
don't omit @var{catch-all} (it's optional),
@code{gnus-group-split-default-catch-all-group} will be set to its
value.

@vindex gnus-group-split-updated-hook
Because you may want to change @code{nnmail-split-fancy} after it is set

34547:44a6d536cea3

You can read news (and mail) from within Emacs by using Gnus.  The news
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.

This manual corresponds to Gnus 5.9.0.

@end ifinfo

@iftex

@cindex moving articles
If you move (or copy) articles regularly, you might wish to have Gnus
suggest where to put the articles.  @code{gnus-move-split-methods} is a
variable that uses the same syntax as @code{gnus-split-methods}
(@pxref{Saving Articles}).  You may customize that variable to create
suggestions you find reasonable.  (Note that
@code{gnus-move-split-methods} uses group names where
@code{gnus-split-methods} uses file names.)

@lisp
(setq gnus-move-split-methods
      '(("^From:.*Lars Magne" "nnml:junk")
        ("^Subject:.*gnus" "nnfolder:important")

@enumerate
@item
The file contains one or more line, each of which define one server.

@item
The valid tokens include @samp{machine}, @samp{login}, @samp{password},
@samp{default}.  In addition Gnus introduces two new tokens, not present
in the original @file{.netrc}/@code{ftp} syntax, namely @samp{port} and
@samp{force}.  (This is the only way the @file{.authinfo} file format
deviates from the @file{.netrc} file format.)  @samp{port} is used to
indicate what port on the server the credentials apply to and
@samp{force} is explained below.

@end enumerate

Here's an example file:

In-Reply-To) header of each message to split and searches the file
specified by @code{nnmail-message-id-cache-file} for the message ids.
When it has found a parent, it returns the corresponding group name.  It
is recommended that you set @code{nnmail-message-id-cache-length} to a
somewhat higher number than the default so that the message ids are
still in the cache.  (A value of 5000 appears to create a file some 300
kBytes in size.)
@vindex nnmail-cache-accepted-message-ids
When @code{nnmail-cache-accepted-message-ids} is non-@code{nil}, Gnus
also records the message ids of moved articles, so that the followup
messages goes into the new group.


@node Group Mail Splitting
@subsection Group Mail Splitting
@cindex mail splitting

@code{gnus-group-split} will do cross-posting on all groups that match,
by defining a single @code{&} fancy split containing one split for each
group.  If a message doesn't match any split, it will be stored in the
group named in @code{gnus-group-split-default-catch-all-group}, unless
some group has @var{split-spec} set to @code{catch-all}, in which case
that group is used as the catch-all group.  Even though this variable is
often used just to name a group, it may also be set to an arbitrarily
complex fancy split (after all, a group name is a fancy split), and this
may be useful to split mail that doesn't go to any mailing list to
personal mail folders.  Note that this fancy split is added as the last
element of a @code{|} split list that also contains a @code{&} split
with the rules extracted from group parameters.

It's time for an example.  Assume the following group parameters have
been defined:

@example

@end lisp

@var{groups} may be a regular expression or a list of group names whose
parameters will be scanned to generate the output split.
@var{no-crosspost} can be used to disable cross-posting; in this case, a
single @code{|} split will be output.  @var{catch-all} is the fallback
fancy split, used like @var{gnus-group-split-default-catch-all-group}.
If @var{catch-all} is @code{nil}, or if @var{split-regexp} matches the
empty string in any selected group, no catch-all split will be issued.
Otherwise, if some group has @var{split-spec} set to @code{catch-all},
this group will override the value of the @var{catch-all} argument.

@findex gnus-group-split-setup
Unfortunately, scanning all groups and their parameters can be quite
slow, especially considering that it has to be done for every message.
But don't despair!  The function @code{gnus-group-split-setup} can be
used to enable @code{gnus-group-split} in a much more efficient way.  It
sets @code{nnmail-split-methods} to @code{nnmail-split-fancy} and sets
@code{nnmail-split-fancy} to the split produced by
@code{gnus-group-split-fancy}.  Thus, the group parameters are only
scanned once, no matter how many messages are split.

@end lisp

If @var{auto-update} is non-@code{nil}, @code{gnus-group-split-update}
will be added to @code{nnmail-pre-get-new-mail-hook}, so you won't ever
have to worry about updating @code{nnmail-split-fancy} again.  If you
don't omit @var{catch-all} (it's optional, equivalent to @code{nil}),
@code{gnus-group-split-default-catch-all-group} will be set to its
value.

@vindex gnus-group-split-updated-hook
Because you may want to change @code{nnmail-split-fancy} after it is set