@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, 2006, 2007 Free Software Foundation, Inc.
+@c Copyright (C) 1995, 2001-2015 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 @setfilename gnus-faq.info
+@c @settitle Frequently Asked Questions
+@c @include docstyle.texi
@c %**end of header
@c
@section Frequently Asked Questions
@menu
-* FAQ - Changes::
+* 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
@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)}.
+
+Please submit features and suggestions to the
+@email{ding@@gnus.org, ding list}.
@node FAQ - Changes
-@subheading Changes
+@subsection Changes
@itemize @bullet
@item
-Updated FAQ to reflect release of Gnus 5.10 and start of
-No Gnus development.
+2008-06-15: Adjust for message-fill-column. Add x-face-file.
+Clarify difference between ding and gnu.emacs.gnus. Remove
+reference to discontinued service.
+
+@item
+2006-04-15: Added tip on how to delete sent buffer on exit.
@end itemize
@node FAQ - Introduction
-@subheading Introduction
+@subsection Introduction
This is the Gnus Frequently Asked Questions list.
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.
+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.
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,
+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
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.
+misprints are the Gnus 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?
+* FAQ 1-1:: What is the latest version of Gnus?
+* FAQ 1-2:: What's new in 5.10?
+* FAQ 1-3:: Where and how to get Gnus?
+* FAQ 1-4:: What to do with the tarball now?
+* FAQ 1-5:: I sometimes read references to No Gnus and Oort Gnus,
+ what are those?
+* FAQ 1-6:: Which version of Emacs do I need?
+* FAQ 1-7:: How do I run Gnus on both Emacs and XEmacs?
@end menu
-@node [1.1]
+@node FAQ 1-1
@subsubheading Question 1.1
What is the latest version of Gnus?
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.8) should be at
+shouldn't miss. The current release (5.13) should be at
least as stable as the latest release of the 5.8 series.
-@node [1.2]
+@node FAQ 1-2
@subsubheading Question 1.2
What's new in 5.10?
Message-utils now included in Gnus.
@item
-New format specifiers for summary lines, e.g. %B for
+New format specifiers for summary lines, e.g., %B for
a complex trn-style thread tree.
@end itemize
-@node [1.3]
+@node FAQ 1-3
@subsubheading Question 1.3
Where and how to get Gnus?
@subsubheading Answer
Gnus is released independent from releases of Emacs and XEmacs.
-Therefore, the version bundled with Emacs or the version in XEmacs'
-package system might not be up to date (e.g. Gnus 5.9 bundled with Emacs
-20 is outdated).
-@c
+Therefore, the version bundled with Emacs or the version in XEmacs's
+package system might not be up to date (e.g., Gnus 5.9 bundled with Emacs
+21 is outdated).
You can get the latest released version of Gnus from
-@uref{http://www.gnus.org/dist/gnus.tar.gz} or via anonymous FTP 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}.
-@node [1.4]
+@node FAQ 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
+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
+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
before this line, on MS Windows use something like
"C:/path/to/lisp" (yes, "/").
-@node [1.5]
+@node FAQ 1-5
@subsubheading Question 1.5
I sometimes read references to No Gnus and Oort Gnus,
not 5.11, the odd version numbers are normally used for
the Gnus versions bundled with Emacs)
-@node [1.6]
+@node FAQ 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.
+Gnus 5.13 requires an Emacs version that is greater than or equal
+to Emacs 23.1 or XEmacs 21.1, although there are some features that
+only work on Emacs 24.
-@node [1.7]
+@node FAQ 1-7
@subsubheading Question 1.7
How do I run Gnus on both Emacs and XEmacs?
@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?
+* FAQ 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?
+* FAQ 2-2:: Gnus doesn't remember which groups I'm subscribed to,
+ what's this?
+* FAQ 2-3:: How to change the format of the lines in Group buffer?
+* FAQ 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?
+* FAQ 2-5:: How to manually sort the groups in Group buffer? How to
+ sort the groups in a topic?
@end menu
-@node [2.1]
+@node FAQ 2-1
@subsubheading Question 2.1
Every time I start Gnus I get a message "Gnus auto-save
@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
+wasn't properly exited and therefore couldn't write its
+information to disk (e.g., which messages you read), you
+are now asked if you want to restore that information
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]
+@node FAQ 2-2
@subsubheading Question 2.2
Gnus doesn't remember which groups I'm subscribed to,
starting Gnus, right? It's an other symptom for the same
problem, so read the answer above.
-@node [2.3]
+@node FAQ 2-3
@subsubheading Question 2.3
How to change the format of the lines in Group buffer?
@end example
@noindent
-@node [2.4]
+@node FAQ 2-4
@subsubheading Question 2.4
My group buffer becomes a bit crowded, is there a way to
@subsubheading Answer
Gnus offers the topic mode, it allows you to sort your
-groups in, well, topics, e.g. all groups dealing with
+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.
beginning of your gnus-group-line-format variable to have
the groups nicely indented.
-@node [2.5]
+@node FAQ 2-5
@subsubheading Question 2.5
How to manually sort the groups in Group buffer? How to
@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?
+* FAQ 3-1:: I just installed Gnus, started it via @samp{M-x gnus}
+ but it only says "nntp (news) open error", what to do?
+* FAQ 3-2:: I'm working under Windows and have no idea what
+ ~/.gnus.el means.
+* FAQ 3-3:: My news server requires authentication, how to store
+ user name and password on disk?
+* FAQ 3-4:: Gnus seems to start up OK, but I can't find out how to
+ subscribe to a group.
+* FAQ 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?
+* FAQ 3-6:: I want Gnus to fetch news from several servers, is this
+ possible?
+* FAQ 3-7:: And how about local spool files?
+* FAQ 3-8:: OK, reading news works now, but I want to be able to
+ read my mail with Gnus, too. How to do it?
+* FAQ 3-9:: And what about IMAP?
+* FAQ 3-10:: At the office we use one of those MS Exchange servers,
+ can I use Gnus to read my mail from it?
+* FAQ 3-11:: Can I tell Gnus not to delete the mails on the server it
+ retrieves via POP3?
@end menu
-@node [3.1]
+@node FAQ 3-1
@subsubheading Question 3.1
-I just installed Gnus, started it via
-@samp{M-x gnus}
+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:
+first start, put those lines in @file{~/.gnus.el}:
@example
(setq gnus-select-method '(nntp "news.yourprovider.net"))
@end example
@noindent
-@node [3.2]
+@node FAQ 3-2
@subsubheading Question 3.2
-I'm working under Windows and have no idea what ~/.gnus.el means.
+I'm working under Windows and have no idea what @file{~/.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 }
+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.
+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
+please), e.g., c:\myhome. Then you must set the environment
+variable HOME to this directory. To do this under Windows 9x
or Me include the line
@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 -> Advanced). There you'll find the possibility
-to set environment variables. Create a new one with name HOME and value
-C:\myhome. Rebooting is not necessary.
+Winkey+Pause/Break to enter system options (if it doesn't work, go
+to Control Panel -> System -> Advanced). There you'll find the
+possibility to set environment variables. Create a new one with
+name HOME and value C:\myhome. Rebooting is not necessary.
-Now to create ~/.gnus.el, say
+Now to create @file{~/.gnus.el}, say
@samp{C-x C-f ~/.gnus.el RET C-x C-s}.
in Emacs.
-@node [3.3]
+@node FAQ 3-3
@subsubheading Question 3.3
My news server requires authentication, how to store
.
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
+say
@example
chmod 600 ~/.authinfo
@end example
in a shell.)
-@node [3.4]
+@node FAQ 3-4
@subsubheading Question 3.4
Gnus seems to start up OK, but I can't find out how to
you want to subscribe to and say @samp{u}
to subscribe to it.
-@node [3.5]
+@node FAQ 3-5
@subsubheading Question 3.5
Gnus doesn't show all groups / Gnus says I'm not allowed to
Some providers allow restricted anonymous access and full
access only after authorization. To make Gnus send authinfo
-to those servers append
+to those servers append
@example
force yes
@end example
@noindent
-
+
to the line for those servers in ~/.authinfo.
-@node [3.6]
+@node FAQ 3-6
@subsubheading Question 3.6
I want Gnus to fetch news from several servers, is this possible?
Of course. You can specify more sources for articles in the
variable gnus-secondary-select-methods. Add something like
-this in ~/.gnus.el:
+this in @file{~/.gnus.el}:
@example
(add-to-list 'gnus-secondary-select-methods
@end example
@noindent
-@node [3.7]
+@node FAQ 3-7
@subsubheading Question 3.7
And how about local spool files?
@example
(add-to-list 'gnus-secondary-select-methods
'(nnspool ""
- (nnspool-directory "/usr/local/myspoolddir")))
+ (nnspool-directory "/usr/local/myspoolddir")))
@end example
@noindent
You might have to specify more stuff like the program used
to post articles, see the Gnus manual on how to do this.
-@node [3.8]
+@node FAQ 3-8
@subsubheading Question 3.8
OK, reading news works now, but I want to be able to read my mail
send them directly to a SMTP Server 2: Some program like
fetchmail retrieves your mail and stores it on disk from
where Gnus shall read it. Outgoing mail is sent by
-Sendmail, Postfix or some other MTA. Sometimes, you even
+Sendmail, Postfix or some other MTA@. Sometimes, you even
need a combination of the above cases.
However, the first thing to do is to tell Gnus in which way
it should store the mail, in Gnus terminology which back end
to use. Gnus supports many different back ends, the most
commonly used one is nnml. It stores every mail in one file
-and is therefor quite fast. However you might prefer a one
+and is therefore quite fast. However you might prefer a one
file per group approach if your file system has problems with
many small files, the nnfolder back end is then probably the
-choice for you. To use nnml add the following to ~/.gnus.el:
+choice for you. To use nnml add the following to @file{~/.gnus.el}:
@example
(add-to-list 'gnus-secondary-select-methods '(nnml ""))
@end example
@noindent
-Now we need to tell Gnus, where to get it's mail from. If
+Now we need to tell Gnus, where to get its mail from. If
it's a POP3 server, then you need something like this:
@example
@end example
@noindent
-Make sure ~/.gnus.el isn't readable to others if you store
+Make sure @file{~/.gnus.el} isn't readable to others if you store
your password there. If you want to read your mail from a
traditional spool file on your local machine, it's
@example
(eval-after-load "mail-source"
'(add-to-list 'mail-sources
- '(directory :path "/path/to/procmail-dir/"
- :suffix ".prcml")))
+ '(directory :path "/path/to/procmail-dir/"
+ :suffix ".prcml")))
@end example
@noindent
want to send mail via sendmail (or whichever MTA is playing
the role of sendmail on your system), you don't need to do
anything. However, if you want to send your mail to an
-SMTP Server you need the following in your ~/.gnus.el
+SMTP Server you need the following in your @file{~/.gnus.el}
@example
(setq send-mail-function 'smtpmail-send-it)
@end example
@noindent
-@node [3.9]
+@node FAQ 3-9
@subsubheading Question 3.9
And what about IMAP?
to use IMAP like POP3, that means Gnus fetches the mail from
the IMAP server and stores it on disk. If you want to do
this (you don't really want to do this) add the following to
-~/.gnus.el
+@file{~/.gnus.el}
@example
(add-to-list 'mail-sources '(imap :server "mail.mycorp.com"
@example
(add-to-list 'gnus-secondary-select-methods
- '(nnimap "Give the baby a name"
- (nnimap-address "imap.yourProvider.net")
- (nnimap-port 143)
- (nnimap-list-pattern "archive.*")))
+ '(nnimap "Give the baby a name"
+ (nnimap-address "imap.yourProvider.net")
+ (nnimap-port 143)
+ (nnimap-list-pattern "archive.*")))
@end example
@noindent
server if Gnus can't guess the correct way, see the Manual
Node "IMAP" for detailed information.
-@node [3.10]
+@node FAQ 3-10
@subsubheading Question 3.10
At the office we use one of those MS Exchange servers, can I use
activating IMAP on the server and follow the instructions
above.
-@node [3.11]
+@node FAQ 3-11
@subsubheading Question 3.11
Can I tell Gnus not to delete the mails on the server it
@subsubheading Answer
-First of all, that's not the way POP3 is intended to work,
-if you have the possibility, you should use the IMAP
-Protocol if you want your messages to stay on the
-server. Nevertheless there might be situations where you
-need the feature, but sadly Gnus itself has no predefined
-functionality to do so.
-
-However this is Gnus county so there are possibilities to
-achieve what you want. The easiest way is to get an external
-program which retrieves copies of the mail and stores them
-on disk, so Gnus can read it from there. On Unix systems you
-could use e.g. fetchmail for this, on MS Windows you can use
-Hamster, an excellent local news and mail server.
-
-The other solution would be, to replace the method Gnus
-uses to get mail from POP3 servers by one which is capable
-of leaving the mail on the server. If you use XEmacs, get
-the package mail-lib, it includes an enhanced pop3.el,
-look in the file, there's documentation on how to tell
-Gnus to use it and not to delete the retrieved mail. For
-GNU Emacs look for the file epop3.el which can do the same
-(If you know the home of this file, please send me an
-e-mail). You can also tell Gnus to use an external program
-(e.g. fetchmail) to fetch your mail, see the info node
-"Mail Source Specifiers" in the Gnus manual on how to do
-it.
+Yes, if the POP3 server supports the UIDL control (maybe almost servers
+do it nowadays). To do that, add a @code{:leave VALUE} pair to each
+POP3 mail source. See @pxref{Mail Source Specifiers} for VALUE.
@node FAQ 4 - Reading messages
@subsection Reading messages
@menu
-* [4.1]:: When I enter a group, all read messages are gone. How to
- view them again?
-* [4.2]:: How to tell Gnus to show an important message every time I
- enter a group, even when it's read?
-* [4.3]:: How to view the headers of a message?
-* [4.4]:: How to view the raw unformatted message?
-* [4.5]:: How can I change the headers Gnus displays by default at
- the top of the article buffer?
-* [4.6]:: I'd like Gnus NOT to render HTML-mails but show me the
- text part if it's available. How to do it?
-* [4.7]:: Can I use some other browser than w3 to render my
- HTML-mails?
-* [4.8]:: Is there anything I can do to make poorly formatted mails
- more readable?
-* [4.9]:: Is there a way to automatically ignore posts by specific
- authors or with specific words in the subject? And can I highlight
- more interesting ones in some way?
-* [4.10]:: How can I disable threading in some (e.g. mail-) groups,
- or set other variables specific for some groups?
-* [4.11]:: Can I highlight messages written by me and follow-ups to
- those?
-* [4.12]:: The number of total messages in a group which Gnus
- displays in group buffer is by far to high, especially in mail
- groups. Is this a bug?
-* [4.13]:: I don't like the layout of summary and article buffer, how
- to change it? Perhaps even a three pane display?
-* [4.14]:: I don't like the way the Summary buffer looks, how to
- tweak it?
-* [4.15]:: How to split incoming mails in several groups?
+* FAQ 4-1:: When I enter a group, all read messages are gone. How to
+ view them again?
+* FAQ 4-2:: How to tell Gnus to show an important message every time
+ I enter a group, even when it's read?
+* FAQ 4-3:: How to view the headers of a message?
+* FAQ 4-4:: How to view the raw unformatted message?
+* FAQ 4-5:: How can I change the headers Gnus displays by default at
+ the top of the article buffer?
+* FAQ 4-6:: I'd like Gnus NOT to render HTML-mails but show me the
+ text part if it's available. How to do it?
+* FAQ 4-7:: Can I use some other browser than shr to render my
+ HTML-mails?
+* FAQ 4-8:: Is there anything I can do to make poorly formatted
+ mails more readable?
+* FAQ 4-9:: Is there a way to automatically ignore posts by specific
+ authors or with specific words in the subject? And can I
+ highlight more interesting ones in some way?
+* FAQ 4-10:: How can I disable threading in some (e.g., mail-) groups,
+ or set other variables specific for some groups?
+* FAQ 4-11:: Can I highlight messages written by me and follow-ups to
+ those?
+* FAQ 4-12:: The number of total messages in a group which Gnus
+ displays in group buffer is by far to high, especially in mail
+ groups. Is this a bug?
+* FAQ 4-13:: I don't like the layout of summary and article buffer,
+ how to change it? Perhaps even a three pane display?
+* FAQ 4-14:: I don't like the way the Summary buffer looks, how to
+ tweak it?
+* FAQ 4-15:: How to split incoming mails in several groups?
+* FAQ 4-16:: How can I ensure more contrast when viewing HTML mail?
@end menu
-@node [4.1]
+@node FAQ 4-1
@subsubheading Question 4.1
When I enter a group, all read messages are gone. How to view them again?
@subsubheading Answer
-If you enter the group by saying
+If you enter the group by saying
@samp{RET}
in group buffer with point over the group, only unread and ticked messages are loaded. Say
@samp{C-u RET}
-instead to load all available messages. If you want only the e.g. 300 newest say
+instead to load all available messages. If you want only the 300 newest say
@samp{C-u 300 RET}
Loading only unread messages can be annoying if you have threaded view enabled, say
(setq gnus-fetch-old-headers 'some)
@end example
@noindent
-
-in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load
-all articles (Warning: Both settings enlarge the amount of data which is
+
+in @file{~/.gnus.el} to load enough old articles to prevent teared threads, replace 'some with @code{t} to load
+all articles (Warning: Both settings enlarge the amount of data which is
fetched when you enter a group and slow down the process of entering a group).
-If you already use Gnus 5.10, you can say
-@samp{/o N}
+If you already use Gnus 5.10, you can say
+@samp{/o N}
In summary buffer to load the last N messages, this feature is not available in 5.8.8
If you don't want all old messages, but the parent of the message you're just reading,
you can say @samp{^}, if you want to retrieve the whole thread
the message you're just reading belongs to, @samp{A T} is your friend.
-@node [4.2]
+@node FAQ 4-2
@subsubheading Question 4.2
How to tell Gnus to show an important message every time I
mark and set's unread mark) or @samp{M c}
(which deletes all marks for the message).
-@node [4.3]
+@node FAQ 4-3
@subsubheading Question 4.3
How to view the headers of a message?
@subsubheading Answer
-Say @samp{t}
+Say @samp{t}
to show all headers, one more
-@samp{t}
+@samp{t}
hides them again.
-@node [4.4]
+@node FAQ 4-4
@subsubheading Question 4.4
How to view the raw unformatted message?
@subsubheading Answer
-Say
-@samp{C-u g}
+Say
+@samp{C-u g}
to show the raw message
-@samp{g}
+@samp{g}
returns to normal view.
-@node [4.5]
+@node FAQ 4-5
@subsubheading Question 4.5
How can I change the headers Gnus displays by default at
are shown, its value is a regular expression, header lines
which match it are shown. So if you want author, subject,
date, and if the header exists, Followup-To and MUA / NUA
-say this in ~/.gnus.el:
+say this in @file{~/.gnus.el}:
@example
(setq gnus-visible-headers
'("^From" "^Subject" "^Date" "^Newsgroups" "^Followup-To"
- "^User-Agent" "^X-Newsreader" "^X-Mailer"))
+ "^User-Agent" "^X-Newsreader" "^X-Mailer"))
@end example
@noindent
-@node [4.6]
+@node FAQ 4-6
@subsubheading Question 4.6
I'd like Gnus NOT to render HTML-mails but show me the
@example
(eval-after-load "mm-decode"
- '(progn
+ '(progn
(add-to-list 'mm-discouraged-alternatives "text/html")
(add-to-list 'mm-discouraged-alternatives "text/richtext")))
@end example
@noindent
-in ~/.gnus.el. If you don't want HTML rendered, even if there's no text alternative add
+in @file{~/.gnus.el}. If you don't want HTML rendered, even if there's no text alternative add
@example
(setq mm-automatic-display (remove "text/html" mm-automatic-display))
too.
-@node [4.7]
+@node FAQ 4-7
@subsubheading Question 4.7
-Can I use some other browser than w3 to render my HTML-mails?
+Can I use some other browser than w3m to render my HTML-mails?
@subsubheading Answer
Only if you use Gnus 5.10 or younger. In this case you've got the
-choice between w3, w3m, links, lynx and html2text, which
+choice between shr, w3m, links, lynx and html2text, which
one is used can be specified in the variable
mm-text-html-renderer, so if you want links to render your
mail say
@end example
@noindent
-@node [4.8]
+@node FAQ 4-8
@subsubheading Question 4.8
Is there anything I can do to make poorly formatted mails
other deuglifications). Outlook deuglify is only available since
Gnus 5.10.
-@node [4.9]
+@node FAQ 4-9
@subsubheading Question 4.9
Is there a way to automatically ignore posts by specific
@samp{s} for substring-match and delete afterwards
everything but the name to score down all authors with the given
name no matter which email address is used. Now you need to tell
-Gnus when to apply the rule and how long it should last, hit e.g.
+Gnus when to apply the rule and how long it should last, hit
@samp{p} to apply the rule now and let it last
forever. If you want to raise the score instead of lowering it say
@samp{I} instead of @samp{L}.
whose elements are lists again. the first element of those lists
is the header to score on, then one more list with what to match,
which score to assign, when to expire the rule and how to do the
-matching. If you find me very interesting, you could e.g. add the
+matching. If you find me very interesting, you could add the
following to your all.Score:
@example
@end example
@noindent
-in ~/.gnus.el.
+in @file{~/.gnus.el}.
-@node [4.10]
+@node FAQ 4-10
@subsubheading Question 4.10
-How can I disable threading in some (e.g. mail-) groups, or
+How can I disable threading in some (e.g., mail-) groups, or
set other variables specific for some groups?
@subsubheading Answer
can set options for the group. At the bottom of the buffer
you'll find an item that allows you to set variables
locally for the group. To disable threading enter
-gnus-show-threads as name of variable and nil as
+gnus-show-threads as name of variable and @code{nil} as
value. Hit button done at the top of the buffer when
you're ready.
-@node [4.11]
+@node FAQ 4-11
@subsubheading Question 4.11
Can I highlight messages written by me and follow-ups to
make faces (specifications of how summary-line shall look
like) for those postings, then we'll give them some
special score and finally we'll tell Gnus to use the new
-faces. You can find detailed instructions on how to do it on
-@uref{http://my.gnus.org/node/view/224, my.gnus.org}
+faces.
-@node [4.12]
+@node FAQ 4-12
@subsubheading Question 4.12
The number of total messages in a group which Gnus
No, that's a matter of design of Gnus, fixing this would
mean reimplementation of major parts of Gnus'
-back ends. Gnus thinks "highest-article-number -
+back ends. Gnus thinks "highest-article-number @minus{}
lowest-article-number = total-number-of-articles". This
works OK for Usenet groups, but if you delete and move
many messages in mail groups, this fails. To cure the
-symptom, enter the group via @samp{C-u RET}
+symptom, enter the group via @samp{C-u RET}
(this makes Gnus get all messages), then
hit @samp{M P b} to mark all messages and
then say @samp{B m name.of.group} to move
right again (until you delete and move your mail to other
groups again).
-@node [4.13]
+@node FAQ 4-13
@subsubheading Question 4.13
I don't like the layout of summary and article buffer, how
(gnus-add-configuration
'(article
(horizontal 1.0
- (vertical 25
- (group 1.0))
- (vertical 1.0
- (summary 0.25 point)
- (article 1.0)))))
+ (vertical 25
+ (group 1.0))
+ (vertical 1.0
+ (summary 0.25 point)
+ (article 1.0)))))
(gnus-add-configuration
'(summary
(horizontal 1.0
- (vertical 25
- (group 1.0))
- (vertical 1.0
- (summary 1.0 point)))))
+ (vertical 25
+ (group 1.0))
+ (vertical 1.0
+ (summary 1.0 point)))))
@end example
@noindent
-@node [4.14]
+@node FAQ 4-14
@subsubheading Question 4.14
I don't like the way the Summary buffer looks, how to tweak it?
@subsubheading Answer
You've got to play around with the variable
-gnus-summary-line-format. It's value is a string of
+gnus-summary-line-format. Its value is a string of
symbols which stand for things like author, date, subject
etc. A list of the available specifiers can be found in the
manual node "Summary Buffer Lines" and the often forgotten
-node "Formatting Variables" and it's sub-nodes. There
+node "Formatting Variables" and its sub-nodes. There
you'll find useful things like positioning the cursor and
tabulators which allow you a summary in table form, but
sadly hard tabulators are broken in 5.8.8.
Since 5.10, Gnus offers you some very nice new specifiers,
-e.g. %B which draws a thread-tree and %&user-date which
+e.g., %B which draws a thread-tree and %&user-date which
gives you a date where the details are dependent of the
articles age. Here's an example which uses both:
:O \-> ... | 115 |Raymond Scholz | 1:24
:O \-> ... | 19 |Lars Magne Ingebrigt |15:33
:O Slow mailing list | 13 |Lars Magne Ingebrigt |Sat 23:49
-:O Re: `@@' mark not documented | 13 |Lars Magne Ingebrigt |Sat 23:50
+:O Re: '@@' mark not documented | 13 |Lars Magne Ingebrigt |Sat 23:50
:R > Re: Gnus still doesn't count messages prope| 23 |Lars Magne Ingebrigt |Sat 23:57
:O \-> ... | 18 |Kai Grossjohann | 0:35
:O \-> ... | 13 |Lars Magne Ingebrigt | 0:56
@end example
@noindent
-@node [4.15]
+@node FAQ 4-15
@subsubheading Question 4.15
How to split incoming mails in several groups?
articles should go which don't match any other rule. If
the folder doesn't exist yet, it will be created as soon
as an article lands there. By default the mail will be
-send to all groups whose rules match. If you
+send to all groups whose rules match. If you
don't want that (you probably don't want), say
@example
@end example
@noindent
-in ~/.gnus.el.
+in @file{~/.gnus.el}.
An example might be better than thousand words, so here's
my nnmail-split-methods. Note that I send duplicates in a
("Spam" "^CC: .*azzrael@@t-online.invalid")
("Spam" "^X-Mailer-Version: 1.50 BETA")
("Uni" "^\\(CC:\\|To:\\).*localpart@@uni-koblenz.invalid.*")
- ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.invalid\\|adress@@two.invalid\\)")
+ ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.invalid\\|address@@two.invalid\\)")
("Spam" "")))
@end example
@noindent
+@node FAQ 4-16
+@subsubheading Question 4.16
+
+How can I ensure more contrast when viewing HTML mail?
+
+@subsubheading Answer
+
+Gnus' built-in simple HTML renderer (you use it if the value of
+@code{mm-text-html-renderer} is @code{shr}) uses the colors which are
+declared in the HTML mail. However, it adjusts them in order to
+prevent situations like dark gray text on black background. In case
+the results still have a too low contrast for you, increase the values
+of the variables @code{shr-color-visible-distance-min} and
+@code{shr-color-visible-luminance-min}.
+
@node FAQ 5 - Composing messages
@subsection Composing messages
@menu
-* [5.1]:: What are the basic commands I need to know for sending
- mail and postings?
-* [5.2]:: How to enable automatic word-wrap when composing messages?
-* [5.3]:: How to set stuff like From, Organization, Reply-To,
- signature...?
-* [5.4]:: Can I set things like From, Signature etc group based on
- the group I post too?
-* [5.5]:: Is there a spell-checker? Perhaps even on-the-fly
- spell-checking?
-* [5.6]:: Can I set the dictionary based on the group I'm posting
- to?
-* [5.7]:: Is there some kind of address-book, so I needn't remember
- all those email addresses?
-* [5.8]:: Sometimes I see little images at the top of article
- buffer. What's that and how can I send one with my postings, too?
-* [5.9]:: Sometimes I accidentally hit r instead of f in newsgroups.
- Can Gnus warn me, when I'm replying by mail in newsgroups?
-* [5.10]:: How to tell Gnus not to generate a sender header?
-* [5.11]:: I want Gnus to locally store copies of my send mail and
- news, how to do it?
-* [5.12]:: People tell me my Message-IDs are not correct, why aren't
- they and how to fix it?
+* FAQ 5-1:: What are the basic commands I need to know for sending
+ mail and postings?
+* FAQ 5-2:: How to enable automatic word-wrap when composing
+ messages?
+* FAQ 5-3:: How to set stuff like From, Organization, Reply-To,
+ signature...?
+* FAQ 5-4:: Can I set things like From, Signature etc. group based on
+ the group I post too?
+* FAQ 5-5:: Is there a spell-checker? Perhaps even on-the-fly
+ spell-checking?
+* FAQ 5-6:: Can I set the dictionary based on the group I'm posting
+ to?
+* FAQ 5-7:: Is there some kind of address-book, so I needn't
+ remember all those email addresses?
+* FAQ 5-8:: Sometimes I see little images at the top of article
+ buffer. What's that and how can I send one with my postings,
+ too?
+* FAQ 5-9:: Sometimes I accidentally hit r instead of f in
+ newsgroups. Can Gnus warn me, when I'm replying by mail in
+ newsgroups?
+* FAQ 5-10:: How to tell Gnus not to generate a sender header?
+* FAQ 5-11:: I want Gnus to locally store copies of my send mail and
+ news, how to do it?
+* FAQ 5-12:: I want Gnus to kill the buffer after successful sending
+ instead of keeping it alive as "Sent mail to...", how to do it?
+* FAQ 5-13:: People tell me my Message-IDs are not correct, why
+ aren't they and how to fix it?
@end menu
-@node [5.1]
+@node FAQ 5-1
@subsubheading Question 5.1
What are the basic commands I need to know for sending mail and postings?
can start editing it again by saying @samp{D
e}.
-@node [5.2]
+@node FAQ 5-2
@subsubheading Question 5.2
How to enable automatic word-wrap when composing messages?
@end example
@noindent
-in ~/.gnus.el.
+in @file{~/.gnus.el}.
-You can reformat a paragraph by hitting @samp{M-q} (as usual).
+You can reformat a paragraph by hitting @samp{M-q}
+(as usual).
-@node [5.3]
+@node FAQ 5-3
@subsubheading Question 5.3
How to set stuff like From, Organization, Reply-To, signature...?
organization, address, name or body. The attribute name
can also be a string. In that case, this will be used as
a header name, and the value will be inserted in the
-headers of the article; if the value is `nil', the header
+headers of the article; if the value is @code{nil}, the header
name will be removed. You can also say (eval (foo bar)),
then the function foo will be evaluated with argument bar
and the result will be thrown away.
-@node [5.4]
+@node FAQ 5-4
@subsubheading Question 5.4
Can I set things like From, Signature etc group based on the group I post too?
@end example
@noindent
-@node [5.5]
+@node FAQ 5-5
@subsubheading Question 5.5
Is there a spell-checker? Perhaps even on-the-fly spell-checking?
first thing to do is to make sure that you've got either
@uref{http://fmg-www.cs.ucla.edu/fmg-members/geoff/ispell.html, ispell}
or @uref{http://aspell.sourceforge.net/, aspell}
-installed and in your Path. Then you need
+installed and in your Path. Then you need
@uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el}
-and for on-the-fly spell-checking
-@uref{http://www-sop.inria.fr/mimosa/personnel/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}.
-Ispell.el is shipped with Emacs and available through the XEmacs package system,
-flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is
-available through the package system, so there should be no need to install them
+and for on-the-fly spell-checking
+@uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}.
+Ispell.el is shipped with Emacs and available through the XEmacs package system,
+flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is
+available through the package system, so there should be no need to install them
manually.
Ispell.el assumes you use ispell, if you choose aspell say
(setq ispell-program-name "aspell")
@end example
@noindent
-
+
in your Emacs configuration file.
If you want your outgoing messages to be spell-checked, say
@end example
@noindent
-In your ~/.gnus.el, if you prefer on-the-fly spell-checking say
+In your @file{~/.gnus.el}, if you prefer on-the-fly spell-checking say
@example
(add-hook 'message-mode-hook (lambda () (flyspell-mode 1)))
@end example
@noindent
-@node [5.6]
+@node FAQ 5-6
@subsubheading Question 5.6
Can I set the dictionary based on the group I'm posting to?
(ispell-change-dictionary "english")))))
@end example
@noindent
-
-in ~/.gnus.el. Change "^de\\." and "deutsch8" to something
+
+in @file{~/.gnus.el}. Change "^de\\." and "deutsch8" to something
that suits your needs.
-@node [5.7]
+@node FAQ 5-7
@subsubheading Question 5.7
Is there some kind of address-book, so I needn't remember
alias syntax:
@example
-alias al "Al <al@@english-heritage.invalid>"
+alias al
"Al <al@@english-heritage.invalid>"
@end example
@noindent
node "Mail Aliases" in Message (not Gnus) manual for
details.
-However, what you really want is the Insidious Big Brother
+However, what you really want is the Insidious Big Brother
Database bbdb. Get it through the XEmacs package system or from
@uref{http://bbdb.sourceforge.net/, bbdb's homepage}.
-Now place the following in ~/.gnus.el, to activate bbdb for Gnus:
+Now place the following in @file{~/.gnus.el}, to activate bbdb for Gnus:
@example
(require 'bbdb)
@example
(require 'bbdb)
-;;If you don't live in Northern America, you should disable the
+;;If you don't live in Northern America, you should disable the
;;syntax check for telephone numbers by saying
(setq bbdb-north-american-phone-numbers-p nil)
;;Tell bbdb about your email address:
entry, @samp{b} to search your BBDB and
@samp{C-o} to add a new field to an
entry. If you want to add a sender to the BBDB you can
-also just hit `:' on the posting in the summary buffer and
+also just hit @kbd{:} on the posting in the summary buffer and
you are done. When you now compose a new mail,
hit @samp{TAB} to cycle through know
recipients.
-@node [5.8]
+@node FAQ 5-8
@subsubheading Question 5.8
Sometimes I see little images at the top of article
Gimp), open the image you want to include, cut out the
relevant part, reduce color depth to 1 bit, resize to
48*48 and save as bitmap. Now you should get the compface
-package from
+package from
@uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}.
and create the actual X-face by saying
@end example
@noindent
-If you can't use compface, there's an online X-face converter at
+If you can't use compface, there's an online X-face converter at
@uref{http://www.dairiki.org/xface/}.
-If you use MS Windows, you could also use the WinFace program from
-@uref{http://www.xs4all.nl/~walterln/winface/}.
+If you use MS Windows, you could also use the WinFace program,
+which used to be available from
+@indicateurl{http://www.xs4all.nl/~walterln/winface/}.
Now you only have to tell Gnus to include the X-face in your postings by saying
@example
@end example
@noindent
-in ~/.gnus.el. If you use Gnus 5.10, you can simply add an entry
+in @file{~/.gnus.el}. If you use Gnus 5.10, you can simply add an entry
@example
(x-face-file "~/.xface")
to gnus-posting-styles.
-@node [5.9]
+@node FAQ 5-9
@subsubheading Question 5.9
Sometimes I accidentally hit r instead of f in
@subsubheading Answer
-Put this in ~/.gnus.el:
+Put this in @file{~/.gnus.el}:
@example
(setq gnus-confirm-mail-reply-to-news t)
@end example
@noindent
-@node [5.10]
+@node FAQ 5-10
@subsubheading Question 5.10
How to tell Gnus not to generate a sender header?
@subsubheading Answer
Since 5.10 Gnus doesn't generate a sender header by
-default. For older Gnus' try this in ~/.gnus.el:
+default. For older Gnus' try this in @file{~/.gnus.el}:
@example
(eval-after-load "message"
@end example
@noindent
-@node [5.11]
+@node FAQ 5-11
@subsubheading Question 5.11
I want Gnus to locally store copies of my send mail and
@example
(setq gnus-message-archive-group
- '((if (message-news-p)
- "nnml:Send-News"
- "nnml:Send-Mail")))
+ '((if (message-news-p)
+ "nnml:Send-News"
+ "nnml:Send-Mail")))
@end example
@noindent
-@node [5.12]
+@node FAQ 5-12
@subsubheading Question 5.12
+I want Gnus to kill the buffer after successful sending instead of keeping
+it alive as "Sent mail to...", how to do it?
+
+@subsubheading Answer
+
+Add this to your ~/.gnus:
+
+@example
+(setq message-kill-buffer-on-exit t)
+@end example
+@noindent
+
+@node FAQ 5-13
+@subsubheading Question 5.13
+
People tell me my Message-IDs are not correct, why
aren't they and how to fix it?
@subsubheading Answer
-The message-ID is an unique identifier for messages you
+The message-ID is a unique identifier for messages you
send. To make it unique, Gnus need to know which machine
name to put after the "@@". If the name of the machine
where Gnus is running isn't suitable (it probably isn't
@end example
@noindent
-in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this
-instead (works for newer versions a well):
+in @file{~/.gnus.el}. If you use Gnus 5.9 or earlier, you can use this
+instead (works for newer versions as well):
@example
(eval-after-load "message"
(setq message-user-fqdn fqdn)
(gnus-message 1 "Redefining `message-make-fqdn'.")
(defun message-make-fqdn ()
- "Return user's fully qualified domain name."
+ "Return user’s fully qualified domain name."
fqdn))))
@end example
@noindent
@subsection Old messages
@menu
-* [6.1]:: How to import my old mail into Gnus?
-* [6.2]:: How to archive interesting messages?
-* [6.3]:: How to search for a specific message?
-* [6.4]:: How to get rid of old unwanted mail?
-* [6.5]:: I want that all read messages are expired (at least in some
- groups). How to do it?
-* [6.6]:: I don't want expiration to delete my mails but to move them
- to another group.
+* FAQ 6-1:: How to import my old mail into Gnus?
+* FAQ 6-2:: How to archive interesting messages?
+* FAQ 6-3:: How to search for a specific message?
+* FAQ 6-4:: How to get rid of old unwanted mail?
+* FAQ 6-5:: I want that all read messages are expired (at least in
+ some groups). How to do it?
+* FAQ 6-6:: I don't want expiration to delete my mails but to move
+ them to another group.
@end menu
-@node [6.1]
+@node FAQ 6-1
@subsubheading Question 6.1
How to import my old mail into Gnus?
through nnmail-split-methods (respool them) by saying
@samp{B r}.
-@node [6.2]
+@node FAQ 6-2
@subsubheading Question 6.2
How to archive interesting messages?
it be much more convenient to have more direct access to
the archived message from Gnus? If you say yes, put this
snippet by Frank Haun <pille3003@@fhaun.de> in
-~/.gnus.el:
+@file{~/.gnus.el}:
@example
(defun my-archive-article (&optional n)
- "Copies one or more article(s) to a corresponding `nnml:' group, e.g.
-`gnus.ding' goes to `nnml:1.gnus.ding'. And `nnml:List-gnus.ding' goes
-to `nnml:1.List-gnus-ding'.
+ "Copies one or more article(s) to a corresponding ‘nnml:’ group, e.g.,
+‘gnus.ding’ goes to ‘nnml:1.gnus.ding’. And ‘nnml:List-gnus.ding’ goes
+to ‘nnml:1.List-gnus-ding’.
Use process marks or mark a region in the summary buffer to archive
more then one article."
mark for articles you want to keep, setting the read
mark will remove them from cache.
-@node [6.3]
+@node FAQ 6-3
@subsubheading Question 6.3
How to search for a specific message?
Of course you can also use grep to search through your
local mail, but this is both slow for big archives and
inconvenient since you are not displaying the found mail
-in Gnus. Here comes nnir into action. Nnir is a front end
+in Gnus. Here nnir comes into action. Nnir is a front end
to search engines like swish-e or swish++ and
-others. You index your mail with one of those search
-engines and with the help of nnir you can search trough
+others. You index your mail with one of those search
+engines and with the help of nnir you can search through
the indexed mail and generate a temporary group with all
-messages which met your search criteria. If this sound
-cool to you get nnir.el from
+messages which met your search criteria. If this sounds
+cool to you, get nnir.el from
+@c FIXME Isn't this file in Gnus?
+@ignore
+@c Dead link 2013/7.
@uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/}
-or @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
+or
+@end ignore
+@uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
Instructions on how to use it are at the top of the file.
-@node [6.4]
+@node FAQ 6-4
@subsubheading Question 6.4
How to get rid of old unwanted mail?
expirable before and if they are old enough (default is
older than a week) they are deleted.
-@node [6.5]
+@node FAQ 6-5
@subsubheading Question 6.5
I want that all read messages are expired (at least in
@subsubheading Answer
-If you want all read messages to be expired (e.g. in
+If you want all read messages to be expired (e.g., in
mailing lists where there's an online archive), you've
got two choices: auto-expire and
total-expire. Auto-expire means, that every article
can also set the read mark (hit
@samp{d}).
-@node [6.6]
+@node FAQ 6-6
@subsubheading Question 6.6
I don't want expiration to delete my mails but to move them
@subsubheading Answer
-Say something like this in ~/.gnus.el:
+Say something like this in @file{~/.gnus.el}:
@example
(setq nnmail-expiry-target "nnml:expired")
(If you want to change the value of nnmail-expiry-target
on a per group basis see the question "How can I disable
-threading in some (e.g. mail-) groups, or set other
+threading in some (e.g., mail-) groups, or set other
variables specific for some groups?")
@node FAQ 7 - Gnus in a dial-up environment
@subsection Gnus in a dial-up environment
@menu
-* [7.1]:: I don't have a permanent connection to the net, how can I
- minimize the time I've got to be connected?
-* [7.2]:: So what was this thing about the Agent?
-* [7.3]:: I want to store article bodies on disk, too. How to do it?
-* [7.4]:: How to tell Gnus not to try to send mails / postings while
- I'm offline?
+* FAQ 7-1:: I don't have a permanent connection to the net, how can I
+ minimize the time I've got to be connected?
+* FAQ 7-2:: So what was this thing about the Agent?
+* FAQ 7-3:: I want to store article bodies on disk, too. How to do
+ it?
+* FAQ 7-4:: How to tell Gnus not to try to send mails / postings
+ while I'm offline?
@end menu
-@node [7.1]
+@node FAQ 7-1
@subsubheading Question 7.1
I don't have a permanent connection to the net, how can
when you're online.
Let's talk about Unix systems first: For the news part,
-the easiest solution is a small nntp server like
+the easiest solution is a small nntp server like
@uref{http://www.leafnode.org/, Leafnode} or
@uref{http://infa.abo.fi/~patrik/sn/, sn},
of course you can also install a full featured news
-server like
-@uref{http://www.isc.org/products/INN/, inn}.
+server like
+@uref{http://www.isc.org/software/inn/, inn}.
Then you want to fetch your Mail, popular choices
are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail}
-and @uref{http://www.qcc.ca/~charlesc/software/getmail-3.0/, getmail}.
+and @uref{http://pyropus.ca/software/getmail/, getmail}.
You should tell those to write the mail to your disk and
Gnus to read it from there. Last but not least the mail
sending part: This can be done with every MTA like
@uref{http://www.exim.org/, exim} or
@uref{http://www.qmail.org/, qmail}.
-On windows boxes I'd vote for
-@uref{http://www.tglsoft.de/, Hamster},
+On windows boxes I'd vote for
+@uref{http://www.tglsoft.de/, Hamster},
it's a small freeware, open-source program which fetches
your mail and news from remote servers and offers them
to Gnus (or any other mail and/or news reader) via nntp
-respectively POP3 or IMAP. It also includes a smtp
+respectively POP3 or IMAP@. It also includes a smtp
server for receiving mails from Gnus.
-@node [7.2]
+@node FAQ 7-2
@subsubheading Question 7.2
So what was this thing about the Agent?
The Gnus agent is part of Gnus, it allows you to fetch
mail and news and store them on disk for reading them
later when you're offline. It kind of mimics offline
-newsreaders like e.g. Forte Agent. If you want to use
-the Agent place the following in ~/.gnus.el if you are
+newsreaders like Forte Agent. If you want to use
+the Agent place the following in @file{~/.gnus.el} if you are
still using 5.8.8 or 5.9 (it's the default since 5.10):
@example
server, the headers will be stored on disk and read from
there the next time you enter the group.
-@node [7.3]
+@node FAQ 7-3
@subsubheading Question 7.3
I want to store article bodies on disk, too. How to do it?
server. Depending on the volume of headers, the initial
fetch session could take hours.
-@node [7.4]
+@node FAQ 7-4
@subsubheading Question 7.4
How to tell Gnus not to try to send mails / postings
@subsection Getting help
@menu
-* [8.1]:: How to find information and help inside Emacs?
-* [8.2]:: I can't find anything in the Gnus manual about X (e.g.
- attachments, PGP, MIME...), is it not documented?
-* [8.3]:: Which websites should I know?
-* [8.4]:: Which mailing lists and newsgroups are there?
-* [8.5]:: Where to report bugs?
-* [8.6]:: I need real-time help, where to find it?
+* FAQ 8-1:: How to find information and help inside Emacs?
+* FAQ 8-2:: I can't find anything in the Gnus manual about X (e.g.,
+ attachments, PGP, MIME...), is it not documented?
+* FAQ 8-3:: Which websites should I know?
+* FAQ 8-4:: Which mailing lists and newsgroups are there?
+* FAQ 8-5:: Where to report bugs?
+* FAQ 8-6:: I need real-time help, where to find it?
@end menu
-@node [8.1]
+@node FAQ 8-1
@subsubheading Question 8.1
How to find information and help inside Emacs?
search through all available functions and @samp{M-x
apropos} searches the bound variables.
-@node [8.2]
+@node FAQ 8-2
@subsubheading Question 8.2
I can't find anything in the Gnus manual about X
-(e.g. attachments, PGP, MIME...), is it not documented?
+(e.g., attachments, PGP, MIME...), is it not documented?
@subsubheading Answer
-There's not only the Gnus manual but also the manuals
-for message, emacs-mime, sieve and pgg. Those packages
-are distributed with Gnus and used by Gnus but aren't
-really part of core Gnus, so they are documented in
-different info files, you should have a look in those
-manuals, too.
+There's not only the Gnus manual but also the manuals for message,
+emacs-mime, sieve, EasyPG Assistant, and pgg. Those packages are
+distributed with Gnus and used by Gnus but aren't really part of core
+Gnus, so they are documented in different info files, you should have
+a look in those manuals, too.
-@node [8.3]
+@node FAQ 8-3
@subsubheading Question 8.3
Which websites should I know?
@subsubheading Answer
-The two most important ones are the
+The most important one is the
@uref{http://www.gnus.org, official Gnus website}.
-and it's sister site
-@uref{http://my.gnus.org, my.gnus.org (MGO)},
-hosting an archive of lisp snippets, howtos, a (not
-really finished) tutorial and this FAQ.
Tell me about other sites which are interesting.
-@node [8.4]
+@node FAQ 8-4
@subsubheading Question 8.4
Which mailing lists and newsgroups are there?
@subsubheading Answer
-There's the newsgroup gnu.emacs.gnus
-(also available as
-@uref{http://dir.gmane.org/gmane.emacs.gnus.user,
-gmane.emacs.gnus.user})
-which deals with general Gnus questions.
-The ding mailing list (ding@@gnus.org) deals with development of
-Gnus. You can read the ding list via NNTP, too under the name
-@uref{http://dir.gmane.org/gmane.emacs.gnus.general,
-gmane.emacs.gnus.general} from news.gmane.org.
+There's the newsgroup gnu.emacs.gnus (also available as
+@uref{http://dir.gmane.org/gmane.emacs.gnus.user,
+gmane.emacs.gnus.user}) which deals with general Gnus
+questions. If you have questions about development versions of
+Gnus, you should better ask on the ding mailing list, see below.
If you want to stay in the big8,
-news.software.newssreaders is also read by some Gnus
+news.software.readers is also read by some Gnus
users (but chances for qualified help are much better in
-the above groups) and if you speak German, there's
+the above groups). If you speak German, there's
de.comm.software.gnus.
-@node [8.5]
+The ding mailing list (ding@@gnus.org) deals with development of
+Gnus. You can read the ding list via NNTP, too under the name
+@uref{http://dir.gmane.org/gmane.emacs.gnus.general,
+gmane.emacs.gnus.general} from news.gmane.org.
+
+@node FAQ 8-5
@subsubheading Question 8.5
Where to report bugs?
@subsubheading Answer
Say @samp{M-x gnus-bug}, this will start
-a message to the
+a message to the
@email{bugs@@gnus.org, gnus bug mailing list}
including information about your environment which make
it easier to help you.
-@node [8.6]
+@node FAQ 8-6
@subsubheading Question 8.6
I need real-time help, where to find it?
@subsection Tuning Gnus
@menu
-* [9.1]:: Starting Gnus is really slow, how to speed it up?
-* [9.2]:: How to speed up the process of entering a group?
-* [9.3]:: Sending mail becomes slower and slower, what's up?
+* FAQ 9-1:: Starting Gnus is really slow, how to speed it up?
+* FAQ 9-2:: How to speed up the process of entering a group?
+* FAQ 9-3:: Sending mail becomes slower and slower, what's up?
@end menu
-@node [9.1]
+@node FAQ 9-1
@subsubheading Question 9.1
Starting Gnus is really slow, how to speed it up?
@subsubheading Answer
-The reason for this could be the way Gnus reads it's
+The reason for this could be the way Gnus reads its
active file, see the node "The Active File" in the Gnus
manual for things you might try to speed the process up.
-An other idea would be to byte compile your ~/.gnus.el (say
+An other idea would be to byte compile your @file{~/.gnus.el} (say
@samp{M-x byte-compile-file RET ~/.gnus.el
RET} to do it). Finally, if you have require
statements in your .gnus, you could replace them with
eval-after-load, which loads the stuff not at startup
time, but when it's needed. Say you've got this in your
-~/.gnus.el:
+@file{~/.gnus.el}:
@example
(require 'message)
it's loaded when it's needed.
-@node [9.2]
+@node FAQ 9-2
@subsubheading Question 9.2
How to speed up the process of entering a group?
@subsubheading Answer
A speed killer is setting the variable
-gnus-fetch-old-headers to anything different from nil,
+gnus-fetch-old-headers to anything different from @code{nil},
so don't do this if speed is an issue. To speed up
building of summary say
@end example
@noindent
-at the bottom of your ~/.gnus.el, this will make gnus
+at the bottom of your @file{~/.gnus.el}, this will make gnus
byte-compile things like
-gnus-summary-line-format.
+gnus-summary-line-format.
then you could increase the value of gc-cons-threshold
by saying something like
(setq gnus-use-correct-string-widths nil)
@end example
@noindent
-
-in ~/.gnus.el (thanks to Jesper harder for the last
+
+in @file{~/.gnus.el} (thanks to Jesper harder for the last
two suggestions). Finally if you are still using 5.8.8
or 5.9 and experience speed problems with summary
buffer generation, you definitely should update to
5.10 since there quite some work on improving it has
been done.
-@node [9.3]
+@node FAQ 9-3
@subsubheading Question 9.3
Sending mail becomes slower and slower, what's up?
@table @dfn
@item ~/.gnus.el
-When the term ~/.gnus.el is used it just means your Gnus
-configuration file. You might as well call it ~/.gnus or
+When the term @file{~/.gnus.el} is used it just means your Gnus
+configuration file. You might as well call it @file{~/.gnus} or
specify another name.
@item Back End
use to read and write Usenet news.
@end table
-
-@ignore
-arch-tag: 64dc5692-edb4-4848-a965-7aa0181acbb8
-@end ignore
projects / gnus / blobdiff