[gnus] / texi / gnus-faq.texi

@c \input texinfo @c -*-texinfo-*-
@c Uncomment 1st line before texing this file alone.
@c %**start of header
@c Copyright (C) 1995, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
@c
@c Do not modify this file, it was generated from gnus-faq.xml, available from
@c <URL:http://my.gnus.org/FAQ/>.
@c
@setfilename gnus-faq.info
@settitle Frequently Asked Questions
@c %**end of header
@c

@node Frequently Asked Questions
@section Frequently Asked Questions

@menu
* FAQ - Changes::                           
* FAQ - Introduction::                       About Gnus and this FAQ.
* FAQ 1 - Installation FAQ::                 Installation of Gnus.
* FAQ 2 - Startup / Group buffer::           Start up questions and the
                                             first buffer Gnus shows you.
* FAQ 3 - Getting Messages::                 Making Gnus read your mail
                                             and news.
* FAQ 4 - Reading messages::                 How to efficiently read
                                             messages.
* FAQ 5 - Composing messages::               Composing mails or Usenet
                                             postings.
* FAQ 6 - Old messages::                     Importing, archiving,
                                             searching and deleting messages.
* FAQ 7 - Gnus in a dial-up environment::    Reading mail and news while
                                             offline.
* FAQ 8 - Getting help::                     When this FAQ isn't enough.
* FAQ 9 - Tuning Gnus::                      How to make Gnus faster.
* FAQ - Glossary::                           Terms used in the FAQ
                                             explained.
@end menu

@subheading Abstract

This is the new Gnus Frequently Asked Questions list.
If you have a Web browser, the official hypertext version is at
@uref{http://my.gnus.org/FAQ/},
the Docbook source is available from
@uref{http://sourceforge.net/projects/gnus/, http://sourceforge.net}.

Please submit features and suggestions to the 
@email{faq-discuss@@my.gnus.org, FAQ discussion list}.
The list is protected against junk mail with
@uref{http://smarden.org/qconfirm/index.html, qconfirm}. As
a subscriber, your submissions will automatically pass.  You can
also subscribe to the list by sending a blank email to
@email{faq-discuss-subscribe@@my.gnus.org, faq-discuss-subscribe@@my.gnus.org}
and @uref{http://mail1.kens.com/cgi-bin/ezmlm-browse?command=monthbythread%26list=faq-discuss, browse
the archive (BROKEN)}.

@node FAQ - Changes
@subheading Changes



@itemize @bullet

@item
Updated FAQ to reflect release of Gnus 5.10 and start of
No Gnus development.
@end itemize

@node FAQ - Introduction
@subheading Introduction

This is the Gnus Frequently Asked Questions list.

Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented
as a part of Emacs. It's been around in some form for almost a decade
now, and has been distributed as a standard part of Emacs for much of
that time. Gnus 5 is the latest (and greatest) incarnation. The
original version was called GNUS, and was written by Masanobu UMEDA.
When autumn crept up in '94, Lars Magne Ingebrigtsen grew bored and
decided to rewrite Gnus.

Its biggest strength is the fact that it is extremely
customizable. It is somewhat intimidating at first glance, but
most of the complexity can be ignored until you're ready to take
advantage of it. If you receive a reasonable volume of e-mail
(you're on various mailing lists), or you would like to read
high-volume mailing lists but cannot keep up with them, or read
high volume newsgroups or are just bored, then Gnus is what you
want.

This FAQ was maintained by Justin Sheehy until March 2002. He
would like to thank Steve Baur and Per Abrahamsen for doing a wonderful
job with this FAQ before him. We would like to do the same - thanks,
Justin!

If you have a Web browser, the official hypertext version is at:
@uref{http://my.gnus.org/FAQ/}.
This version is much nicer than the unofficial hypertext
versions that are archived at Utrecht, Oxford, Smart Pages, Ohio
State, and other FAQ archives. See the resources question below
if you want information on obtaining it in another format.

The information contained here was compiled with the assistance
of the Gnus development mailing list, and any errors or
misprints are the my.gnus.org team's fault, sorry.

@node FAQ 1 - Installation FAQ
@subsection Installation FAQ

@menu
* [1.1]::    What is the latest version of Gnus?
* [1.2]::    What's new in 5.10?
* [1.3]::    Where and how to get Gnus?
* [1.4]::    What to do with the tarball now?
* [1.5]::    I sometimes read references to No Gnus and Oort Gnus, what
             are those?
* [1.6]::    Which version of Emacs do I need?
* [1.7]::    How do I run Gnus on both Emacs and XEmacs?
@end menu

@node [1.1]
@subsubheading Question 1.1

What is the latest version of Gnus?

@subsubheading Answer

Jingle please: Gnus 5.10 is released, get it while it's
hot! As well as the step in version number is rather
small, Gnus 5.10 has tons of new features which you
shouldn't miss. The current release (5.10.6) should be at
least as stable as the latest release of the 5.8 series.

@node [1.2]
@subsubheading Question 1.2

What's new in 5.10?

@subsubheading Answer

First of all, you should have a look into the file
GNUS-NEWS in the toplevel directory of the Gnus tarball,
there the most important changes are listed. Here's a
short list of the changes I find especially
important/interesting:

@itemize @bullet

@item
Major rewrite of the Gnus agent, Gnus agent is now
active by default.

@item
Many new article washing functions for dealing with
ugly formatted articles.

@item
Anti Spam features.

@item
Message-utils now included in Gnus.

@item
New format specifiers for summary lines, e.g. %B for
a complex trn-style thread tree.
@end itemize

@node [1.3]
@subsubheading Question 1.3

Where and how to get Gnus?

@subsubheading Answer

The latest released version of Gnus isn't included in
Emacs 21, therefor you should get the Gnus tarball from
@uref{http://www.gnus.org/dist/gnus.tar.gz}
or via anonymous FTP from 
@uref{ftp://ftp.gnus.org/pub/gnus/gnus.tar.gz}.
If you use XEmacs instead of Emacs you can use XEmacs'
package system instead.

@node [1.4]
@subsubheading Question 1.4

What to do with the tarball now?

@subsubheading Answer

Untar it via @samp{tar xvzf gnus.tar.gz} and do the common 
@samp{./configure; make; make install} circle.
(under MS-Windows either get the Cygwin environment from
@uref{http://www.cygwin.com}
which allows you to do what's described above or unpack the
tarball with some packer (e.g. Winace from
@uref{http://www.winace.com})
and use the batch-file make.bat included in the tarball to install
Gnus.) If you don't want to (or aren't allowed to) install Gnus
system-wide, you can install it in your home directory and add the
following lines to your ~/.xemacs/init.el or ~/.emacs:

@example
(add-to-list 'load-path "/path/to/gnus/lisp")
(if (featurep 'xemacs)
    (add-to-list 'Info-directory-list "/path/to/gnus/texi/")
  (add-to-list 'Info-default-directory-list "/path/to/gnus/texi/"))
@end example
@noindent

Make sure that you don't have any Gnus related stuff
before this line, on MS Windows use something like
"C:/path/to/lisp" (yes, "/").

@node [1.5]
@subsubheading Question 1.5

I sometimes read references to No Gnus and Oort Gnus,
what are those?

@subsubheading Answer

Oort Gnus was the name of the development version of
Gnus, which became Gnus 5.10 in autumn 2003. No Gnus is
the name of the current development version which will
once become Gnus 5.12 or Gnus 6. (If you're wondering why
not 5.11, the odd version numbers are normally used for
the Gnus versions bundled with Emacs)

@node [1.6]
@subsubheading Question 1.6

Which version of Emacs do I need?

@subsubheading Answer

Gnus 5.10 requires an Emacs version that is greater than or equal
to Emacs 20.7 or XEmacs 21.1.
The development versions of Gnus (aka No Gnus) requires Emacs 21
or XEmacs 21.4.

@node [1.7]
@subsubheading Question 1.7

How do I run Gnus on both Emacs and XEmacs?

@subsubheading Answer

You can't use the same copy of Gnus in both as the Lisp
files are byte-compiled to a format which is different
depending on which Emacs did the compilation. Get one copy
of Gnus for Emacs and one for XEmacs.

@node FAQ 2 - Startup / Group buffer
@subsection Startup / Group buffer

@menu
* [2.1]::    Every time I start Gnus I get a message "Gnus auto-save
             file exists. Do you want to read it?", what does this mean and
             how to prevent it?
* [2.2]::    Gnus doesn't remember which groups I'm subscribed to,
             what's this?
* [2.3]::    How to change the format of the lines in Group buffer?
* [2.4]::    My group buffer becomes a bit crowded, is there a way to
             sort my groups into categories so I can easier browse through
             them?
* [2.5]::    How to manually sort the groups in Group buffer? How to
             sort the groups in a topic?
@end menu

@node [2.1]
@subsubheading Question 2.1

Every time I start Gnus I get a message "Gnus auto-save
file exists. Do you want to read it?", what does this mean
and how to prevent it?

@subsubheading Answer

This message means that the last time you used Gnus, it
wasn't properly exited and therefor couldn't write its
informations to disk (e.g. which messages you read), you
are now asked if you want to restore those informations
from the auto-save file.

To prevent this message make sure you exit Gnus
via @samp{q} in group buffer instead of
just killing Emacs.

@node [2.2]
@subsubheading Question 2.2

Gnus doesn't remember which groups I'm subscribed to,
what's this?

@subsubheading Answer

You get the message described in the q/a pair above while
starting Gnus, right? It's an other symptom for the same
problem, so read the answer above.

@node [2.3]
@subsubheading Question 2.3

How to change the format of the lines in Group buffer?

@subsubheading Answer

You've got to tweak the value of the variable
gnus-group-line-format. See the manual node "Group Line
Specification" for information on how to do this. An
example for this (guess from whose .gnus :-)):

@example
(setq gnus-group-line-format "%P%M%S[%5t]%5y : %(%g%)\n")
@end example
@noindent

@node [2.4]
@subsubheading Question 2.4

My group buffer becomes a bit crowded, is there a way to
sort my groups into categories so I can easier browse
through them?

@subsubheading Answer

Gnus offers the topic mode, it allows you to sort your
groups in, well, topics, e.g. all groups dealing with
Linux under the topic linux, all dealing with music under
the topic music and all dealing with scottish music under
the topic scottish which is a subtopic of music.

To enter topic mode, just hit t while in Group buffer. Now
you can use @samp{T n} to create a topic
at point and @samp{T m} to move a group to
a specific topic. For more commands see the manual or the
menu. You might want to include the %P specifier at the
beginning of your gnus-group-line-format variable to have
the groups nicely indented.

@node [2.5]
@subsubheading Question 2.5

How to manually sort the groups in Group buffer? How to
sort the groups in a topic?

@subsubheading Answer

Move point over the group you want to move and
hit @samp{C-k}, now move point to the
place where you want the group to be and
hit @samp{C-y}.

@node FAQ 3 - Getting Messages
@subsection Getting Messages

@menu
* [3.1]::     I just installed Gnus, started it via  @samp{M-x gnus} 
              but it only says "nntp (news) open error", what to do?
* [3.2]::     I'm working under Windows and have no idea what ~/.gnus.el
              means.
* [3.3]::     My news server requires authentication, how to store user
              name and password on disk?
* [3.4]::     Gnus seems to start up OK, but I can't find out how to
              subscribe to a group.
* [3.5]::     Gnus doesn't show all groups / Gnus says I'm not allowed
              to post on this server as well as I am, what's that?
* [3.6]::     I want Gnus to fetch news from several servers, is this
              possible?
* [3.7]::     And how about local spool files?
* [3.8]::     OK, reading news works now, but I want to be able to read
              my mail with Gnus, too. How to do it?
* [3.9]::     And what about IMAP?
* [3.10]::    At the office we use one of those MS Exchange servers, can
              I use Gnus to read my mail from it?
* [3.11]::    Can I tell Gnus not to delete the mails on the server it
              retrieves via POP3?
@end menu

@node [3.1]
@subsubheading Question 3.1

I just installed Gnus, started it via 
@samp{M-x gnus} 
but it only says "nntp (news) open error", what to do?

@subsubheading Answer

You've got to tell Gnus where to fetch the news from. Read
the documentation for information on how to do this. As a
first start, put those lines in ~/.gnus.el:

@example
(setq gnus-select-method '(nntp "news.yourprovider.net"))
(setq user-mail-address "you@@yourprovider.net")
(setq user-full-name "Your Name")
@end example
@noindent

@node [3.2]
@subsubheading Question 3.2

I'm working under Windows and have no idea what ~/.gnus.el means.

@subsubheading Answer

The ~/ means the home directory where Gnus and Emacs look
for the configuration files.  However, you don't really
need to know what this means, it suffices that Emacs knows
what it means :-) You can type 
@samp{C-x C-f ~/.gnus.el RET } 
(yes, with the forward slash, even on Windows), and
Emacs will open the right file for you.  (It will most
likely be new, and thus empty.)
However, I'd discourage you from doing so, since the
directory Emacs chooses will most certainly not be what
you want, so let's do it the correct way. 
The first thing you've got to do is to
create a suitable directory (no blanks in directory name
please) e.g. c:\myhome. Then you must set the environment
variable HOME to this directory.  To do this under Win9x
or Me include the line

@example
SET HOME=C:\myhome
@end example
@noindent

in your autoexec.bat and reboot.  Under NT, 2000 and XP,
hit Winkey+Pause/Break to enter system options (if it
doesn't work, go to Control Panel -> System). There you'll
find the possibility to set environment variables, create
a new one with name HOME and value C:\myhome, a reboot is
not necessary.

Now to create ~/.gnus.el, say
@samp{C-x C-f ~/.gnus.el RET C-x C-s}.
in Emacs.

@node [3.3]
@subsubheading Question 3.3

My news server requires authentication, how to store
user name and password on disk?

@subsubheading Answer

Create a file ~/.authinfo which includes for each server a line like this

@example
machine news.yourprovider.net login YourUserName password YourPassword
@end example
@noindent
.
Make sure that the file isn't readable to others if you
work on a OS which is capable of doing so.  (Under Unix
say 
@example
chmod 600 ~/.authinfo
@end example
@noindent

in a shell.)

@node [3.4]
@subsubheading Question 3.4

Gnus seems to start up OK, but I can't find out how to
subscribe to a group.

@subsubheading Answer

If you know the name of the group say @samp{U
name.of.group RET} in group buffer (use the
tab-completion Luke). Otherwise hit ^ in group buffer,
this brings you to the server buffer. Now place point (the
cursor) over the server which carries the group you want,
hit @samp{RET}, move point to the group
you want to subscribe to and say @samp{u}
to subscribe to it.

@node [3.5]
@subsubheading Question 3.5

Gnus doesn't show all groups / Gnus says I'm not allowed to
post on this server as well as I am, what's that?

@subsubheading Answer

Some providers allow restricted anonymous access and full
access only after authorization. To make Gnus send authinfo
to those servers append 

@example
force yes
@end example
@noindent
 
to the line for those servers in ~/.authinfo.

@node [3.6]
@subsubheading Question 3.6

I want Gnus to fetch news from several servers, is this possible?

@subsubheading Answer

Of course. You can specify more sources for articles in the
variable gnus-secondary-select-methods. Add something like
this in ~/.gnus.el:

@example
(add-to-list 'gnus-secondary-select-methods
             '(nntp "news.yourSecondProvider.net"))
(add-to-list 'gnus-secondary-select-methods
             '(nntp "news.yourThirdProvider.net"))
@end example
@noindent

@node [3.7]
@subsubheading Question 3.7

And how about local spool files?

@subsubheading Answer

No problem, this is just one more select method called
nnspool, so you want this:

@example
(add-to-list 'gnus-secondary-select-methods '(nnspool ""))
@end example
@noindent

Or this if you don't want an NNTP Server as primary news source:

@example
(setq gnus-select-method '(nnspool ""))
@end example
@noindent

Gnus will look for the spool file in /usr/spool/news, if you
want something different, change the line above t