comparison man/gnus.texi @ 33292:a588a9158965

Emacs 21 stuff. URL fixes.

33291:90d32ce915cc

* Mail Backend Variables::       Variables for customizing mail handling.
* Fancy Mail Splitting::         Gnus can do hairy splitting of incoming mail.
* Group Mail Splitting::         Use group customize to drive mail splitting.
* Incorporating Old Mail::       What about the old mail you have?
* Expiring Mail::                Getting rid of unwanted mail.
* Washing Mail::                 Removing gruft from the mail you get.
* Duplicates::                   Dealing with duplicated mail.
* Not Reading Mail::             Using mail backends for reading other files.
* Choosing a Mail Backend::      Gnus can read a variety of mail formats.

Mail Sources

@iftex
@iflatex
\include{xface}
@end iflatex
@end iftex
Look for and display any X-Face headers
(@code{gnus-article-display-x-face}).  The command executed by this
function is given by the @code{gnus-article-x-face-command} variable.
If this variable is a string, this string will be executed in a
sub-shell.  If it is a function, this function will be called with the

@findex nntp-open-ssl-stream
@item nntp-open-ssl-stream
Opens a connection to a server over a @dfn{secure} channel.  To use this
you must have SSLay installed
(@file{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL}, and you also need
@file{ssl.el} (from the W3 distributeion, for instance).  You then
define a server as follows:

@lisp
;; Type `C-c C-c' after you've finished editing.

@node Slashdot
@subsection Slashdot
@cindex Slashdot
@cindex nnslashdot

Slashdot (@file{http://slashdot.org/}) is a popular news site, with
lively discussion following the news articles.  @code{nnslashdot} will
let you read this forum in a convenient manner.

The easiest way to read this source is to put something like the
following in your @file{.gnus.el} file:

@node Ultimate
@subsection Ultimate
@cindex nnultimate
@cindex Ultimate Bulletin Board

The Ultimate Bulletin Board (@file{http://www.ultimatebb.com/}) is
probably the most popular Web bulletin board system used.  It has a
quite regular and nice interface, and it's possible to get the
information Gnus needs to keep groups updated.

The easiest way to get started with @code{nnultimate} is to say

@subsection Web Archive
@cindex nnwarchive
@cindex Web Archive

Some mailing lists only have archives on Web servers, such as
@file{http://www.egroups.com/} and
@file{http://www.mail-archive.com/}.  It has a quite regular and nice
interface, and it's possible to get the information Gnus needs to keep
groups updated.

The easiest way to get started with @code{nnwarchive} is to say
something like the following in the group buffer: @kbd{M-x

@code{imap-kerberos4-program} contain parameters to pass to the imtest
program.

@vindex imap-ssl-program
For SSL connections, the OpenSSL program is available from
@file{http://www.openssl.org/}. OpenSSL was formerly known as SSLeay,
and nnimap support it too - altough the most recent versions of
SSLeay, 0.9.x, are known to have serious bugs making it
useless. Earlier versions, especially 0.8.x, of SSLeay are known to
work. The variable @code{imap-ssl-program} contain parameters to pass
to OpenSSL/SSLeay.

article or nothing respectively.  In the case of these two special
predicates an additional score rule is superfluous.

Predicates of @code{high} or @code{low} download articles in respect of
their scores in relationship to @code{gnus-agent-high-score} and
@code{gnus-agent-low-score} as descibed below.

To gain even finer control of what is to be regarded eligible for
download a predicate can consist of a number of predicates with logical
operators sprinkled in between.

the @file{gnus-kill-to-score.el} package; if not, you'll have to do it
by hand.

The kill to score conversion package isn't included in Gnus by default.
You can fetch it from
@file{http://www.stud.ifi.uio.no/~larsi/ding-various/gnus-kill-to-score.el}.

If your old kill files are very complex---if they contain more
non-@code{gnus-kill} forms than not, you'll have to convert them by
hand.  Or just let them be as they are.  Gnus will still use them as
before.

@node Using GroupLens
@subsection Using GroupLens

To use GroupLens you must register a pseudonym with your local Better
Bit Bureau (BBB).
@samp{http://www.cs.umn.edu/Research/GroupLens/bbb.html} is the only
better bit in town at the moment.

Once you have registered you'll need to set a couple of variables.

@table @code

* Buttons::                    Get tendonitis in ten easy steps!
* Daemons::                    Gnus can do things behind your back.
* NoCeM::                      How to avoid spam and other fatty foods.
* Undo::                       Some actions can be undone.
* Moderation::                 What to do if you're a moderator.
* XEmacs Enhancements::        There are more pictures and stuff under XEmacs.
* Fuzzy Matching::             What's the big fuzz?
* Thwarting Email Spam::       A how-to on avoiding unsolicited commercial email.
* Various Various::            Things that are really various.
@end menu

@lisp
(setq gnus-moderated-list
      "^nnml:rec.zoofle$\\|^rec.zoofle$")
@end lisp


@node XEmacs Enhancements
@section XEmacs Enhancements
@cindex XEmacs

@iflatex
\include{picons}
@end iflatex
@end iftex

So...  You want to slow down your news reader even more!  This is a
good way to do so.  Its also a great way to impress people staring
over your shoulder as you read news.

@menu
* Picon Basics::           What are picons and How do I get them.

@vindex gnus-picons-piconsearch-url
If you have a permanent connection to the Internet you can use Steve
Kinzler's Picons Search engine by setting
@code{gnus-picons-piconsearch-url} to the string @*
@file{http://www.cs.indiana.edu/picons/search.html}.

@vindex gnus-picons-database
Otherwise you need a local copy of his database.  For instructions on
obtaining and installing the picons databases, point your Web browser at @*
@file{http://www.cs.indiana.edu/picons/ftp/index.html}.  Gnus expects
picons to be installed into a location pointed to by
@code{gnus-picons-database}.


@node Picon Requirements

@file{/usr/local/faces/}.

@item gnus-picons-piconsearch-url
@vindex gnus-picons-piconsearch-url
The URL for the web picons search engine.  The only currently known
engine is @file{http://www.cs.indiana.edu:800/piconsearch}.  To
workaround network delays, icons will be fetched in the background.  If
this is @code{nil} 'the default), then picons are fetched from local
database indicated by @code{gnus-picons-database}.

@item gnus-picons-display-where

citizen, you can even send off complaints to the proper authorities on
each unsolicited commercial email---at your leisure.

If you are also a lazy net citizen, you will probably prefer complaining
automatically with the @file{gnus-junk.el} package, available FOR FREE
at @* @file{<URL:http://stud2.tuwien.ac.at/~e9426626/gnus-junk.html>}.
Since most e-mail spam is sent automatically, this may reconcile the
cosmic balance somewhat.

This works for me.  It allows people an easy way to contact me (they can
just press @kbd{r} in the usual way), and I'm not bothered at all with

@sc{gnus} was written by Masanobu @sc{Umeda}.  When autumn crept up in
'94, Lars Magne Ingebrigtsen grew bored and decided to rewrite Gnus.

If you want to investigate the person responsible for this outrage,
you can point your (feh!) web browser to
@file{http://quimby.gnus.org/~larsi/}.  This is also the primary
distribution point for the new and spiffy versions of Gnus, and is
known as The Site That Destroys Newsrcs And Drives People Mad.

During the first extended alpha period of development, the new Gnus was
called ``(ding) Gnus''.  @dfn{(ding)} is, of course, short for

@item
 A way to continue editing the latest Message composition.

@item
 http://www.sonicnet.com/feature/ari3/

@item
 facep is not declared.

@item

Message-ID, delete the "original".
@item
 when replying to several messages at once, put the "other" message-ids
into a See-Also header.
@item
 support setext: URL:http://www.bsdi.com/setext/
@item
 support ProleText: <URL:http://proletext.clari.net/prole/proletext.html>
@item
 when browsing a foreign server, the groups that are already subscribed
should be listed as such and not as "K".
@item
 generate font names dynamically.

you could also try to read the archive for that group.  Part of the
problem is that archives are spread all over the net, unlike FAQs.
What would be best I suppose is to find the one closest to your site.

In any case, there is a list of general news group archives at @*
ftp://ftp.neosoft.com/pub/users/claird/news.lists/newsgroup_archives.html




@item

@item
 a new nncvs backend.  Each group would show an article, using
version branches as threading, checkin date as the date, etc.

@item
 http://www.dejanews.com/forms/dnsetfilter_exp.html ?
This filter allows one to construct advance queries on the Dejanews
database such as specifying start and end dates, subject, author,
and/or newsgroup name.

@item

33292:a588a9158965

* Mail Backend Variables::       Variables for customizing mail handling.
* Fancy Mail Splitting::         Gnus can do hairy splitting of incoming mail.
* Group Mail Splitting::         Use group customize to drive mail splitting.
* Incorporating Old Mail::       What about the old mail you have?
* Expiring Mail::                Getting rid of unwanted mail.
* Washing Mail::                 Removing cruft from the mail you get.
* Duplicates::                   Dealing with duplicated mail.
* Not Reading Mail::             Using mail backends for reading other files.
* Choosing a Mail Backend::      Gnus can read a variety of mail formats.

Mail Sources

@iftex
@iflatex
\include{xface}
@end iflatex
@end iftex
@anchor{X-Face}
Look for and display any X-Face headers
(@code{gnus-article-display-x-face}).  The command executed by this
function is given by the @code{gnus-article-x-face-command} variable.
If this variable is a string, this string will be executed in a
sub-shell.  If it is a function, this function will be called with the

@findex nntp-open-ssl-stream
@item nntp-open-ssl-stream
Opens a connection to a server over a @dfn{secure} channel.  To use this
you must have SSLay installed
(@uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL}, and you also need
@file{ssl.el} (from the W3 distributeion, for instance).  You then
define a server as follows:

@lisp
;; Type `C-c C-c' after you've finished editing.

@node Slashdot
@subsection Slashdot
@cindex Slashdot
@cindex nnslashdot

Slashdot (@uref{http://slashdot.org/}) is a popular news site, with
lively discussion following the news articles.  @code{nnslashdot} will
let you read this forum in a convenient manner.

The easiest way to read this source is to put something like the
following in your @file{.gnus.el} file:

@node Ultimate
@subsection Ultimate
@cindex nnultimate
@cindex Ultimate Bulletin Board

The Ultimate Bulletin Board (@uref{http://www.ultimatebb.com/}) is
probably the most popular Web bulletin board system used.  It has a
quite regular and nice interface, and it's possible to get the
information Gnus needs to keep groups updated.

The easiest way to get started with @code{nnultimate} is to say

@subsection Web Archive
@cindex nnwarchive
@cindex Web Archive

Some mailing lists only have archives on Web servers, such as
@uref{http://www.egroups.com/} and
@uref{http://www.mail-archive.com/}.  It has a quite regular and nice
interface, and it's possible to get the information Gnus needs to keep
groups updated.

The easiest way to get started with @code{nnwarchive} is to say
something like the following in the group buffer: @kbd{M-x

@code{imap-kerberos4-program} contain parameters to pass to the imtest
program.

@vindex imap-ssl-program
For SSL connections, the OpenSSL program is available from
@uref{http://www.openssl.org/}. OpenSSL was formerly known as SSLeay,
and nnimap support it too - altough the most recent versions of
SSLeay, 0.9.x, are known to have serious bugs making it
useless. Earlier versions, especially 0.8.x, of SSLeay are known to
work. The variable @code{imap-ssl-program} contain parameters to pass
to OpenSSL/SSLeay.

article or nothing respectively.  In the case of these two special
predicates an additional score rule is superfluous.

Predicates of @code{high} or @code{low} download articles in respect of
their scores in relationship to @code{gnus-agent-high-score} and
@code{gnus-agent-low-score} as described below.

To gain even finer control of what is to be regarded eligible for
download a predicate can consist of a number of predicates with logical
operators sprinkled in between.

the @file{gnus-kill-to-score.el} package; if not, you'll have to do it
by hand.

The kill to score conversion package isn't included in Gnus by default.
You can fetch it from
@uref{http://www.stud.ifi.uio.no/~larsi/ding-various/gnus-kill-to-score.el}.

If your old kill files are very complex---if they contain more
non-@code{gnus-kill} forms than not, you'll have to convert them by
hand.  Or just let them be as they are.  Gnus will still use them as
before.

@node Using GroupLens
@subsection Using GroupLens

To use GroupLens you must register a pseudonym with your local Better
Bit Bureau (BBB).
@uref{http://www.cs.umn.edu/Research/GroupLens/bbb.html} is the only
better bit in town at the moment.

Once you have registered you'll need to set a couple of variables.

@table @code

* Buttons::                    Get tendonitis in ten easy steps!
* Daemons::                    Gnus can do things behind your back.
* NoCeM::                      How to avoid spam and other fatty foods.
* Undo::                       Some actions can be undone.
* Moderation::                 What to do if you're a moderator.
* Emacs Enhancements::         There can be more pictures and stuff under
                               Emacs 21.
* XEmacs Enhancements::        There are more pictures and stuff under XEmacs.
* Fuzzy Matching::             What's the big fuzz?
* Thwarting Email Spam::       A how-to on avoiding unsolicited commercial email.
* Various Various::            Things that are really various.
@end menu

@lisp
(setq gnus-moderated-list
      "^nnml:rec.zoofle$\\|^rec.zoofle$")
@end lisp

@node Emacs Enhancements
@section Emacs Enhancements
@cindex Emacs 21

Starting with version 21, Emacs is able to display pictures and stuff,
so Gnus has taken advantage of that.

Gnus-specific tool bars will be used if Tool Bar mode is on.  Currently
the group, summary and message buffers have tool bars defined.

MIME image types may be displayed internally if Emacs was built with
appropriate support (see variable @code{image-types}).  `X-Face' headers
may be rendered as images internally if you have appropriate support
programs (@pxref{X-Face}).  You can play sounds internally if Emacs was
built with suitable audio support; otherwise Gnus will attempt to play
sounds externally.

@vindex gnus-treat-display-smileys
A simplified version of the XEmacs Smiley support for @dfn{emoticons}
(@pxref{Smileys}) is available on graphical displays under the control
of @code{gnus-treat-display-smileys}.  Text `smiley' faces---@samp{:-)},
@samp{:-/}, @samp{:-(} and the like---are mapped to pictures which are
displayed instead.  The mapping is controlled by a list of regexps
@vindex smiley-regexp-alist
@code{smiley-regexp-alist} mapping matched text to image file names.  It
contains matches for `smiley', `wry' and `frowny' by default.

There is currently no Emacs support for `Picons' (@pxref{Picons}), but
there is no reason why it couldn't be added.

@node XEmacs Enhancements
@section XEmacs Enhancements
@cindex XEmacs

@iflatex
\include{picons}
@end iflatex
@end iftex

So@dots{}  You want to slow down your news reader even more!  This is a
good way to do so.  Its also a great way to impress people staring
over your shoulder as you read news.

@menu
* Picon Basics::           What are picons and How do I get them.

@vindex gnus-picons-piconsearch-url
If you have a permanent connection to the Internet you can use Steve
Kinzler's Picons Search engine by setting
@code{gnus-picons-piconsearch-url} to the string @*
@uref{http://www.cs.indiana.edu/picons/search.html}.

@vindex gnus-picons-database
Otherwise you need a local copy of his database.  For instructions on
obtaining and installing the picons databases, point your Web browser at @*
@uref{http://www.cs.indiana.edu/picons/ftp/index.html}.  Gnus expects
picons to be installed into a location pointed to by
@code{gnus-picons-database}.


@node Picon Requirements

@file{/usr/local/faces/}.

@item gnus-picons-piconsearch-url
@vindex gnus-picons-piconsearch-url
The URL for the web picons search engine.  The only currently known
engine is @uref{http://www.cs.indiana.edu:800/piconsearch}.  To
workaround network delays, icons will be fetched in the background.  If
this is @code{nil} 'the default), then picons are fetched from local
database indicated by @code{gnus-picons-database}.

@item gnus-picons-display-where

citizen, you can even send off complaints to the proper authorities on
each unsolicited commercial email---at your leisure.

If you are also a lazy net citizen, you will probably prefer complaining
automatically with the @file{gnus-junk.el} package, available FOR FREE
at @* @uref{http://stud2.tuwien.ac.at/~e9426626/gnus-junk.html}.
Since most e-mail spam is sent automatically, this may reconcile the
cosmic balance somewhat.

This works for me.  It allows people an easy way to contact me (they can
just press @kbd{r} in the usual way), and I'm not bothered at all with

@sc{gnus} was written by Masanobu @sc{Umeda}.  When autumn crept up in
'94, Lars Magne Ingebrigtsen grew bored and decided to rewrite Gnus.

If you want to investigate the person responsible for this outrage,
you can point your (feh!) web browser to
@uref{http://quimby.gnus.org/}.  This is also the primary
distribution point for the new and spiffy versions of Gnus, and is
known as The Site That Destroys Newsrcs And Drives People Mad.

During the first extended alpha period of development, the new Gnus was
called ``(ding) Gnus''.  @dfn{(ding)} is, of course, short for

@item
 A way to continue editing the latest Message composition.

@item
@uref{http://www.sonicnet.com/feature/ari3/}

@item
 facep is not declared.

@item

Message-ID, delete the "original".
@item
 when replying to several messages at once, put the "other" message-ids
into a See-Also header.
@item
 support setext: @url{http://www.bsdi.com/setext/}
@item
 support ProleText: @url{http://proletext.clari.net/prole/proletext.html}
@item
 when browsing a foreign server, the groups that are already subscribed
should be listed as such and not as "K".
@item
 generate font names dynamically.

you could also try to read the archive for that group.  Part of the
problem is that archives are spread all over the net, unlike FAQs.
What would be best I suppose is to find the one closest to your site.

In any case, there is a list of general news group archives at @*
@uref{ftp://ftp.neosoft.com/pub/users/claird/news.lists/newsgroup_archives.html}




@item

@item
 a new nncvs backend.  Each group would show an article, using
version branches as threading, checkin date as the date, etc.

@item
@url{http://www.dejanews.com/forms/dnsetfilter_exp.html}?
This filter allows one to construct advance queries on the Dejanews
database such as specifying start and end dates, subject, author,
and/or newsgroup name.

@item