Please submit features and suggestions to the
- @uref{mailto:faq-discuss@@my.gnus.org,FAQ discussion list}.
+ @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
+ @uref{http://smarden.org/qconfirm/index.html,qconfirm, 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}
- and @uref{http://mail1.kens.com/cgi-bin/ezmlm-browse?command=monthbythread%26list=faq-discuss,browse the archive}.
+ and
+ @uref{http://mail1.kens.com/cgi-bin/ezmlm-browse?command=monthbythread%26list=faq-discuss,browse
+ the archive, browse the archive}.
@node FAQ - Introduction, FAQ 1 - Installation, Frequently Asked Questions, Frequently Asked Questions
@comment node-name, next, previous, up
Justin!
- If you have a Web browser, the official hypertext version is at:
+ 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
@ifnottex
@node FAQ 1 - Installation, FAQ 2 - Startup / Group buffer, FAQ - Introduction, Frequently Asked Questions
@end ifnottex
-@section Installation
+@subsection Installation
@menu
* [1.1]:: What is the latest version of Gnus?
@ifnottex
@node [1.1], [1.2], FAQ 1 - Installation, FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.1:
+@subsubheading Question 1.1:
What is the latest version of Gnus?
@ifnottex
@node [1.2], [1.3], [1.1], FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.2:
+@subsubheading Question 1.2:
What's new in 5.10.0?
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.
@ifnottex
@node [1.3], [1.4], [1.2], FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.3:
+@subsubheading Question 1.3:
Where and how to get Gnus?
@ifnottex
@node [1.4], [1.5], [1.3], FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.4:
+@subsubheading Question 1.4:
What to do with the tarball now?
@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
@ifnottex
@node [1.5], [1.6], [1.4], FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.5:
+@subsubheading Question 1.5:
Which version of Emacs do I need?
@ifnottex
@node [1.6], , [1.5], FAQ 1 - Installation
@end ifnottex
-@subheading Question 1.6:
+@subsubheading Question 1.6:
How do I run Gnus on both Emacs and XEmacs?
@ifnottex
@node FAQ 2 - Startup / Group buffer, FAQ 3 - Getting messages, FAQ 1 - Installation, Frequently Asked Questions
@end ifnottex
-@section 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?
@ifnottex
@node [2.1], [2.2], FAQ 2 - Startup / Group buffer, FAQ 2 - Startup / Group buffer
@end ifnottex
-@subheading Question 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
@ifnottex
@node [2.2], [2.3], [2.1], FAQ 2 - Startup / Group buffer
@end ifnottex
-@subheading Question: 2.2
+@subsubheading Question: 2.2
Gnus doesn't remember which groups I'm subscribed to,
what's this?
@ifnottex
@node [2.3], [2.4], [2.2], FAQ 2 - Startup / Group buffer
@end ifnottex
-@subheading Question 2.3:
+@subsubheading Question 2.3:
How to change the format of the lines in Group buffer?
@ifnottex
@node [2.4], [2.5], [2.3], FAQ 2 - Startup / Group buffer
@end ifnottex
-@subheading Question 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
@ifnottex
@node [2.5], , [2.4], FAQ 2 - Startup / Group buffer
@end ifnottex
-@subheading Question 2.5:
+@subsubheading Question 2.5:
How to manually sort the groups in Group buffer? How to
sort the groups in a topic?
@ifnottex
@node FAQ 3 - Getting messages, FAQ 4 - Reading messages, FAQ 2 - Startup / Group buffer, Frequently Asked Questions
@end ifnottex
-@section Getting messages
+@subsection Getting messages
@menu
* [3.1]:: I just installed Gnus, started it via M-x gnus but it only says "nntp (news) open error", what to do?
@ifnottex
@node [3.1], [3.2], FAQ 3 - Getting messages, FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.1:
+@subsubheading Question 3.1:
I just installed Gnus, started it via
@samp{M-x gnus}
@example
-
(setq gnus-select-method '(nntp "news.yourprovider.net"))
(setq user-mail-address "you@@yourprovider.net")
(setq user-full-name "Your Name")
-
@end example
@ifnottex
@node [3.2], [3.3], [3.1], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.2:
+@subsubheading Question 3.2:
I'm working under Windows and have no idea what ~/.gnus means.
@ifnottex
@node [3.3], [3.4], [3.2], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.3:
+@subsubheading Question 3.3:
My news server requires authentication, how to store
user name and password on disk?
@ifnottex
@node [3.4], [3.5], [3.3], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.4:
+@subsubheading Question 3.4:
Gnus seems to start up OK, but I can't find out how to
subscribe to a group.
@ifnottex
@node [3.5], [3.6], [3.4], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 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?
@ifnottex
@node [3.6], [3.7], [3.5], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.6:
+@subsubheading Question 3.6:
I want Gnus to fetch news from several servers, is this possible?
@example
-
-(add-to-list 'gnus-secondary-select-methods '(nntp "news.yourSecondProvider.net"))
-(add-to-list 'gnus-secondary-select-methods '(nntp "news.yourThirdProvider.net"))
-
+(add-to-list 'gnus-secondary-select-methods
+ '(nntp "news.yourSecondProvider.net"))
+(add-to-list 'gnus-secondary-select-methods
+ '(nntp "news.yourThirdProvider.net"))
@end example
@ifnottex
@node [3.7], [3.8], [3.6], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.7:
+@subsubheading Question 3.7:
And how about local spool files?
@example
-
(add-to-list 'gnus-secondary-select-methods '(nnspool ""))
-
@end example
@noindent
@example
-
(setq gnus-select-method '(nnspool ""))
-
@end example
@noindent
@example
-
(add-to-list 'gnus-secondary-select-methods
'(nnspool "" (nnspool-directory "/usr/local/myspoolddir")))
-
@end example
@noindent
@ifnottex
@node [3.8], [3.9], [3.7], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.8:
+@subsubheading Question 3.8:
OK, reading news works now, but I want to be able to read my mail
with Gnus, too. How to do it?
@example
-
(add-to-list 'gnus-secondary-select-methods '(nnml ""))
-
@end example
@noindent
@example
-
(add-to-list 'gnus-secondary-select-methods '(nnfolder ""))
-
@end example
@example
-
(eval-after-load "mail-source"
'(add-to-list 'mail-sources '(pop :server "pop.YourProvider.net"
:user "yourUserName"
:password "yourPassword"))
-
@end example
@noindent
@example
-
(eval-after-load "mail-source"
- '(add-to-list 'mail-sources '(file :path "/path/to/spool/file"))
-
+ '(add-to-list 'mail-sources '(file :path "/path/to/spool/file")))
@end example
@noindent
@example
-
(eval-after-load "mail-source"
'(add-to-list 'mail-sources '(maildir :path "/path/to/Maildir/"
:subdirs ("cur" "new")))
-
@end example
@noindent
@example
-
(eval-after-load "mail-source"
'(add-to-list 'mail-sources '(directory :path "/path/to/procmail-dir/"
:suffix ".prcml"))
-
@end example
@noindent
@example
-
(setq send-mail-function 'smtpmail-send-it)
(setq message-send-mail-function 'smtpmail-send-it)
(setq smtpmail-default-smtp-server "smtp.yourProvider.net")
-
@end example
@ifnottex
@node [3.9], [3.10], [3.8], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.9:
+@subsubheading Question 3.9:
And what about IMAP?
@example
-
(add-to-list 'mail-sources '(imap :server "mail.mycorp.com"
:user "username"
:pass "password"
:authentication login
:mailbox "INBOX"
:fetchflag "\\Seen"))
-
@end example
@noindent
@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.*")))
-
+(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.*")))
@end example
@noindent
@ifnottex
@node [3.10], [3.11], [3.9], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.10:
+@subsubheading Question 3.10:
At the office we use one of those MS Exchange servers, can I use
Gnus to read my mail from it?
@ifnottex
@node [3.11], , [3.10], FAQ 3 - Getting messages
@end ifnottex
-@subheading Question 3.11:
+@subsubheading Question 3.11:
Can I tell Gnus not to delete the mails on the server it
retrieves via POP3?
@ifnottex
@node FAQ 4 - Reading messages, FAQ 5 - Composing messages, FAQ 3 - Getting messages, Frequently Asked Questions
@end ifnottex
-@section Reading messages
+@subsection Reading messages
@menu
* [4.1]:: When I enter a group, all read messages are gone. How to view them again?
@ifnottex
@node [4.1], [4.2], FAQ 4 - Reading messages, FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.1:
+@subsubheading Question 4.1:
When I enter a group, all read messages are gone. How to view them again?
@example
-
(setq gnus-fetch-old-headers 'some)
-
@end example
@ifnottex
@node [4.2], [4.3], [4.1], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.2:
+@subsubheading Question 4.2:
How to tell Gnus to show an important message every time I
enter a group, even when it's read?
@ifnottex
@node [4.3], [4.4], [4.2], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.3:
+@subsubheading Question 4.3:
How to view the headers of a message?
@ifnottex
@node [4.4], [4.5], [4.3], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.4:
+@subsubheading Question 4.4:
How to view the raw unformatted message?
@ifnottex
@node [4.5], [4.6], [4.4], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.5:
+@subsubheading Question 4.5:
How can I change the headers Gnus displays by default at
the top of the article buffer?
date, and if the header exists, Followup-To and MUA / NUA
say this in ~/.gnus:
-
@example
-
(setq gnus-visible-headers
-"^\\(From:\\|Subject:\\|Date:\\|Followup-To:\\|X-Newsreader:\\|User-Agent:\\|X-Mailer:\\)")
-
+ "^\\(From:\\|Subject:\\|Date:\\|Followup-To:\
+\\|X-Newsreader:\\|User-Agent:\\|X-Mailer:\\)")
@end example
@ifnottex
@node [4.6], [4.7], [4.5], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.6:
+@subsubheading Question 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?
@example
-
(eval-after-load "mm-decode"
'(progn
(add-to-list 'mm-discouraged-alternatives "text/html")
(add-to-list 'mm-discouraged-alternatives "text/richtext")))
-
@end example
@noindent
@example
-
(setq mm-automatic-display (remove "text/html" mm-automatic-display))
-
@end example
@noindent
@ifnottex
@node [4.7], [4.8], [4.6], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.7:
+@subsubheading Question 4.7:
Can I use some other browser than w3 to render my HTML-mails?
@example
-
(setq mm-text-html-renderer 'links)
-
@end example
@ifnottex
@node [4.8], [4.9], [4.7], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.8:
+@subsubheading Question 4.8:
Is there anything I can do to make poorly formatted mails
more readable?
@ifnottex
@node [4.9], [4.10], [4.8], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.9:
+@subsubheading Question 4.9:
Is there a way to automatically ignore posts by specific
authors or with specific words in the subject? And can I
@example
-
(("references" ("hschmi22.userfqdn.rz-online.de" 500 nil s))
("message-id" ("hschmi22.userfqdn.rz-online.de" 999 nil s)))
-
@end example
@noindent
@example
-
(setq gnus-use-adaptive-scoring t)
-
@end example
@noindent
@ifnottex
@node [4.10], [4.11], [4.9], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.10:
+@subsubheading Question 4.10:
How can I disable threading in some (e.g. mail-) groups, or
set other variables specific for some groups?
@ifnottex
@node [4.11], [4.12], [4.10], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.11:
+@subsubheading Question 4.11:
Can I highlight messages written by me and follow-ups to
those?
@ifnottex
@node [4.12], [4.13], [4.11], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.12:
+@subsubheading Question 4.12:
The number of total messages in a group which Gnus
displays in group buffer is by far to high, especially in
@ifnottex
@node [4.13], [4.14], [4.12], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.13:
+@subsubheading Question 4.13:
I don't like the layout of summary and article buffer, how
to change it? Perhaps even a three pane display?
@example
-
-(gnus-add-configuration '(article (vertical 1.0 (summary .35 point) (article 1.0))))
-
+(gnus-add-configuration
+ '(article (vertical 1.0
+ (summary .35 point)
+ (article 1.0))))
@end example
@example
-
(gnus-add-configuration
'(article
(horizontal 1.0
(group 1.0))
(vertical 1.0
(summary 1.0 point)))))
-
@end example
@ifnottex
@node [4.14], [4.15], [4.13], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.14:
+@subsubheading Question 4.14:
I don't like the way the Summary buffer looks, how to tweak it?
@example
-
-(setq gnus-summary-line-format ":%U%R %B %s %-60=|%4L |%-20,20f |%&user-date; \n")
-
+(setq gnus-summary-line-format
+ ":%U%R %B %s %-60=|%4L |%-20,20f |%&user-date; \n")
@end example
@noindent
resulting in:
-@example
-
+@smallexample
:O Re: [Richard Stallman] rfc2047.el | 13 |Lars Magne Ingebrigt |Sat 23:06
:O Re: Revival of the ding-patches list | 13 |Lars Magne Ingebrigt |Sat 23:12
:R > Re: Find correct list of articles for a gro| 25 |Lars Magne Ingebrigt |Sat 23:16
: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
+@end smallexample
@ifnottex
@node [4.15], , [4.14], FAQ 4 - Reading messages
@end ifnottex
-@subheading Question 4.15:
+@subsubheading Question 4.15:
How to split incoming mails in several groups?
@example
-
(setq nnmail-crosspost nil)
-
@end example
@noindent
@example
-
(setq nnmail-split-methods
'(("duplicates" "^Gnus-Warning:.*duplicate")
("XEmacs-NT" "^\\(To:\\|CC:\\).*localpart@@xemacs.bla.*")
("Gnus-Tut" "^\\(To:\\|CC:\\).*localpart@@socha.bla.*")
("tcsh" "^\\(To:\\|CC:\\).*localpart@@mx.gw.bla.*")
("BAfH" "^\\(To:\\|CC:\\).*localpart@@.*uni-muenchen.bla.*")
- ("Hamster-src" "^\\(CC:\\|To:\\).*hamster-sourcen@@yahoogroups.\\(de\\|com\\).*")
+ ("Hamster-src"
+ "^\\(CC:\\|To:\\).*hamster-sourcen@@yahoogroups.\\(de\\|com\\).*")
("Tagesschau" "^From: tagesschau <localpart@@www.tagesschau.bla>$")
("Replies" "^\\(CC:\\|To:\\).*localpart@@Frank-Schmitt.bla.*")
- ("EK" "^From:.*\\(localpart@@privateprovider.bla\\|localpart@@workplace.bla\\).*")
- ("Spam" "^Content-Type:.*\\(ks_c_5601-1987\\|EUC-KR\\|big5\\|iso-2022-jp\\).*")
- ("Spam" "^Subject:.*\\(This really work\\|XINGA\\|ADV:\\|XXX\\|adult\\|sex\\).*")
- ("Spam" "^Subject:.*\\(\=\?ks_c_5601-1987\?\\|\=\?euc-kr\?\\|\=\?big5\?\\).*")
+ ("EK"
+ "^From:.*\\(localpart@@privateprovider.bla\\|localpart@@workplace.bla\\).*")
+ ("Spam"
+ "^Content-Type:.*\\(ks_c_5601-1987\\|EUC-KR\\|big5\\|iso-2022-jp\\).*")
+ ("Spam"
+ "^Subject:.*\\(This really work\\|XINGA\\|ADV:\\|XXX\\|adult\\|sex\\).*")
+ ("Spam"
+ "^Subject:.*\\(\=\?ks_c_5601-1987\?\\|\=\?euc-kr\?\\|\=\?big5\?\\).*")
("Spam" "^X-Mailer:\\(.*BulkMailer.*\\|.*MIME::Lite.*\\|\\)")
- ("Spam" "^X-Mailer:\\(.*CyberCreek Avalanche\\|.*http\:\/\/GetResponse\.com\\)")
- ("Spam" "^From:.*\\(verizon\.net\\|prontomail\.com\\|money\\|ConsumerDirect\\).*")
+ ("Spam"
+ "^X-Mailer:\\(.*CyberCreek Avalanche\\|.*http\:\/\/GetResponse\.com\\)")
+ ("Spam"
+ "^From:.*\\(verizon\.net\\|prontomail\.com\\|money\\|ConsumerDirect\\).*")
("Spam" "^Delivered-To: GMX delivery to spamtrap@@gmx.bla$")
("Spam" "^Received: from link2buy.com")
("Spam" "^CC: .*azzrael@@t-online.bla")
("Spam" "^X-Mailer-Version: 1.50 BETA")
("Uni" "^\\(CC:\\|To:\\).*localpart@@uni-koblenz.bla.*")
- ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.bla\\|adress@@two.bla\\)")
+ ("Inbox"
+ "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.bla\\|adress@@two.bla\\)")
("Spam" "")))
-
@end example
@ifnottex
@node FAQ 5 - Composing messages, FAQ 6 - Old messages, FAQ 4 - Reading messages, Frequently Asked Questions
@end ifnottex
-@section Composing messages
+@subsection Composing messages
@menu
* [5.1]:: What are the basic commands I need to know for sending mail and postings?
@ifnottex
@node [5.1], [5.2], FAQ 5 - Composing messages, FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.1:
+@subsubheading Question 5.1:
What are the basic commands I need to know for sending mail and postings?
@ifnottex
@node [5.2], [5.3], [5.1], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.2:
+@subsubheading Question 5.2:
How to enable automatic word-wrap when composing messages?
@example
-
(add-hook 'message-mode-hook
(lambda ()
(setq fill-column 72)
(turn-on-auto-fill)))
-
@end example
@noindent
@ifnottex
@node [5.3], [5.4], [5.2], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.3:
+@subsubheading Question 5.3:
How to set stuff like From, Organization, Reply-To, signature...?
@example
-
(setq gnus-posting-styles
'((".*"
(name "Frank Schmitt")
(signature-file "~/.signature")
("X-SampleHeader" "foobar")
(eval (setq some-variable "Foo bar")))))
-
@end example
@noindent
@ifnottex
@node [5.4], [5.5], [5.3], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.4:
+@subsubheading Question 5.4:
Can I set things like From, Signature etc group based on the group I post too?
@example
-
(setq gnus-posting-styles
'((".*" ;;default
(name "Frank Schmitt")
(organization "Hamme net, kren mer och nimmi")
- (signature-file "~/.signature") )
+ (signature-file "~/.signature"))
((message-news-p) ;;Usenet news?
(address "mySpamTrap@@Frank-Schmitt.bla")
- ("Reply-To" "hereRealRepliesOnlyPlease@@Frank-Schmitt.bla") )
+ ("Reply-To" "hereRealRepliesOnlyPlease@@Frank-Schmitt.bla"))
((message-mail-p) ;;mail?
- (address "usedForMails@@Frank-Schmitt.bla") )
+ (address "usedForMails@@Frank-Schmitt.bla"))
("^gmane" ;;this is mail, too in fact
(address "usedForMails@@Frank-Schmitt.net")
- ("Reply-To" nil) )
+ ("Reply-To" nil))
("^gmane.mail.spam.spamassassin.general$"
(eval (setq mail-envelope-from "Azzrael@@rz-online.de"))
- (address "Azzrael@@rz-online.de")) ))
-
+ (address "Azzrael@@rz-online.de"))))
@end example
@ifnottex
@node [5.5], [5.6], [5.4], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.5:
+@subsubheading Question 5.5:
Is there a spell-checker? Perhaps even on-the-fly spell-checking?
Answer:
- You can use ispell.el to spell-check stuff in Emacs. So the
- 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
- @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 Gnus Emacs and available through the Emacs 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.
+You can use ispell.el to spell-check stuff in Emacs. So the first
+thing to do is to make sure that you've got either
+@itemize @bullet
+@item
+@uref{http://fmg-www.cs.ucla.edu/fmg-members/geoff/ispell.html,ispell}
+or
+@item
+@uref{http://aspell.sourceforge.net/,aspell}
+@end itemize
+@noindent
+installed and in your Path.
+
+Then you need
+@uref{http://www.kdstevens.com/~stevens/ispell-page.html,ispell.el,ispell.el}
+and for on-the-fly spell-checking
+@uref{http://www-sop.inria.fr/mimosa/personnel/Manuel.Serrano/flyspell/flyspell.html,flyspell.el,flyspell.el}.
+Ispell.el is shipped with Gnus Emacs and available through the Emacs
+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
@ifnottex
@node [5.6], [5.7], [5.5], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.6:
+@subsubheading Question 5.6:
Can I set the dictionary based on the group I'm posting to?
@example
-
(add-hook 'gnus-select-group-hook
(lambda ()
(cond
(ispell-change-dictionary "deutsch8"))
(t
(ispell-change-dictionary "english")))))
-
@end example
@ifnottex
@node [5.7], [5.8], [5.6], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.7:
+@subsubheading Question 5.7:
Is there some kind of address-book, so I needn't remember
all those email addresses?
@example
-
alias al "Al <al@@english-heritage.bla>"
-
@end example
@noindent
@example
-
(require 'bbdb)
(bbdb-initialize 'gnus 'message)
-
@end example
@noindent
@example
-
(require 'bbdb)
;;If you don't live in Northern America, you should disable the
;;syntax check for telephone numbers by saying
(setq bbdb-complete-name-allow-cycling t)
;;No popup-buffers
(setq bbdb-use-pop-up nil)
-
@end example
@noindent
@ifnottex
@node [5.8], [5.9], [5.7], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.8:
+@subsubheading Question 5.8:
Sometimes I see little images at the top of article
buffer. What's that and how can I send one with my
@example
-
cat file.xbm | xbm2ikon |compface > file.face
cat ./file.face | sed 's/\\/\\\\/g' | sed 's/\"/\\\"/g' > ./file.face.quoted
-
@end example
@noindent
- 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/}.
- Now you only have to tell Gnus to include the X-face in your postings by saying
-
+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/}.
-@example
+Now you only have to tell Gnus to include the X-face in your postings
+by saying
+@example
(setq message-default-headers
(with-temp-buffer
(insert "X-Face: ")
(insert-file-contents "~/.xemacs/xface")
(buffer-string)))
-
@end example
@noindent
@ifnottex
@node [5.9], [5.10], [5.8], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.9:
+@subsubheading Question 5.9:
Sometimes I accidentally hit r instead of f in
newsgroups. Can Gnus warn me, when I'm replying by mail in
@example
-
(setq gnus-confirm-mail-reply-to-news t)
-
@end example
@noindent
@example
-
(defadvice gnus-summary-reply (around reply-in-news activate)
(interactive)
(when (or (not (gnus-news-group-p gnus-newsgroup-name))
(y-or-n-p "Really reply? "))
ad-do-it))
-
@end example
@ifnottex
@node [5.10], [5.11], [5.9], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.10:
+@subsubheading Question 5.10:
How to tell Gnus not to generate a sender header?
@example
-
(eval-after-load "message"
'(add-to-list 'message-syntax-checks '(sender . disabled)))
-
@end example
@ifnottex
@node [5.11], [5.12], [5.10], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.11:
+@subsubheading Question 5.11:
I want gnus to locally store copies of my send mail and
news, how to do it?
@example
-
(setq gnus-message-archive-group
'((if (message-news-p)
"nnml:Send-News"
"nnml:Send-Mail")))
-
@end example
@ifnottex
@node [5.12], , [5.11], FAQ 5 - Composing messages
@end ifnottex
-@subheading Question 5.12:
+@subsubheading Question 5.12:
People tell me my Message-IDs are not correct, why
aren't they and how to fix it?
@example
-
(defun message-make-message-id()
(concat "<"(message-unique-id)"@@yourmachine.yourdomain.tld>"))
-
@end example
@example
-
(setq message-required-news-headers
(remove' Message-ID message-required-news-headers))
-
@end example
@noindent
@example
-
(setq message-required-mail-headers
(remove' Message-ID message-required-mail-headers))
-
@end example
@noindent
@ifnottex
@node FAQ 6 - Old messages, FAQ 7 - Gnus in a dial-up environment, FAQ 5 - Composing messages, Frequently Asked Questions
@end ifnottex
-@section Old messages
+@subsection Old messages
@menu
* [6.1]:: How to import my old mail into Gnus?
@ifnottex
@node [6.1], [6.2], FAQ 6 - Old messages, FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.1:
+@subsubheading Question 6.1:
How to import my old mail into Gnus?
@ifnottex
@node [6.2], [6.3], [6.1], FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.2:
+@subsubheading Question 6.2:
How to archive interesting messages?
@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
(replace-in-string gnus-newsgroup-name "^.*:" "")
(replace-regexp-in-string "^.*:" "" gnus-newsgroup-name)))))
(gnus-summary-copy-article n archive-name)))
-
@end example
@noindent
@example
-
(setq gnus-use-cache t)
-
@end example
@noindent
@ifnottex
@node [6.3], [6.4], [6.2], FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.3:
+@subsubheading Question 6.3:
How to search for a specific message?
@ifnottex
@node [6.4], [6.5], [6.3], FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.4:
+@subsubheading Question 6.4:
How to get rid of old unwanted mail?
@ifnottex
@node [6.5], [6.6], [6.4], FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.5:
+@subsubheading Question 6.5:
I want that all read messages are expired (at least in
some groups). How to do it?
@ifnottex
@node [6.6], , [6.5], FAQ 6 - Old messages
@end ifnottex
-@subheading Question 6.6:
+@subsubheading Question 6.6:
I don't want expiration to delete my mails but to move them
to another group.
@example
-
(setq nnmail-expiry-target "nnml:expired")
-
@end example
@noindent
@ifnottex
@node FAQ 7 - Gnus in a dial-up environment, FAQ 8 - Getting help, FAQ 6 - Old messages, Frequently Asked Questions
@end ifnottex
-@section 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?
@ifnottex
@node [7.1], [7.2], FAQ 7 - Gnus in a dial-up environment, FAQ 7 - Gnus in a dial-up environment
@end ifnottex
-@subheading Question 7.1:
+@subsubheading Question 7.1:
I don't have a permanent connection to the net, how can
I minimize the time I've got to be connected?
when you're online.
- Let's talk about Unix systems first: For the news part,
- 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}.
- 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}.
- 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.sendmail.org/,sendmail},
- @uref{http://www.qmail.org/,postfix},
- @uref{http://www.exim.org/,exim} or
- @uref{http://www.qmail.org/,qmail}.
+Let's talk about Unix systems first: For the news part, 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}.
+
+Then you want to fetch your Mail, popular choices are
+@itemize @bullet
+@item
+@uref{http://www.catb.org/~esr/fetchmail/,fetchmail} and
+@item
+@uref{http://www.qcc.ca/~charlesc/software/getmail-3.0/,getmail}.
+@end itemize
+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.sendmail.org/,sendmail},
+@uref{http://www.qmail.org/,postfix}, @uref{http://www.exim.org/,exim}
+or @uref{http://www.qmail.org/,qmail}.
On windows boxes I'd vote for
@ifnottex
@node [7.2], [7.3], [7.1], FAQ 7 - Gnus in a dial-up environment
@end ifnottex
-@subheading Question 7.2:
+@subsubheading Question 7.2:
So what was this thing about the Agent?
@example
-
(setq gnus-agent t)
-
@end example
@ifnottex
@node [7.3], [7.4], [7.2], FAQ 7 - Gnus in a dial-up environment
@end ifnottex
-@subheading Question 7.3:
+@subsubheading Question 7.3:
I want to store article bodies on disk, too. How to do it?
@ifnottex
@node [7.4], , [7.3], FAQ 7 - Gnus in a dial-up environment
@end ifnottex
-@subheading Question 7.4:
+@subsubheading Question 7.4:
How to tell Gnus not to try to send mails / postings
while I'm offline?
@ifnottex
@node FAQ 8 - Getting help, FAQ 9 - Tuning Gnus, FAQ 7 - Gnus in a dial-up environment, Frequently Asked Questions
@end ifnottex
-@section Getting help
+@subsection Getting help
@menu
* [8.1]:: How to find information and help inside Emacs?
@ifnottex
@node [8.1], [8.2], FAQ 8 - Getting help, FAQ 8 - Getting help
@end ifnottex
-@subheading Question 8.1:
+@subsubheading Question 8.1:
How to find information and help inside Emacs?
@ifnottex
@node [8.2], [8.3], [8.1], FAQ 8 - Getting help
@end ifnottex
-@subheading Question 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?
@ifnottex
@node [8.3], [8.4], [8.2], FAQ 8 - Getting help
@end ifnottex
-@subheading Question 8.3:
+@subsubheading Question 8.3:
Which websites should I know?
@ifnottex
@node [8.4], [8.5], [8.3], FAQ 8 - Getting help
@end ifnottex
-@subheading Question 8.4:
+@subsubheading Question 8.4:
Which mailing lists and newsgroups are there?
@ifnottex
@node [8.5], [8.6], [8.4], FAQ 8 - Getting help
@end ifnottex
-@subheading Question 8.5:
+@subsubheading Question 8.5:
Where to report bugs?
Answer:
- Say @samp{M-x gnus-bug}, this will start
- a message to the
- @uref{mailto:bugs@@gnus.org,gnus bug mailing list}
- including information about your environment which make
- it easier to help you.
+Say @samp{M-x gnus-bug}, this will start a message to the
+@email{bugs@@gnus.org,gnus bug mailing list} including information
+about your environment which make it easier to help you.
@ifnottex
@node [8.6], , [8.5], FAQ 8 - Getting help
@end ifnottex
-@subheading Question 8.6:
+@subsubheading Question 8.6:
I need real-time help, where to find it?
@ifnottex
@node FAQ 9 - Tuning Gnus, FAQ - Glossary, FAQ 8 - Getting help, Frequently Asked Questions
@end ifnottex
-@section Tuning Gnus
+@subsection Tuning Gnus
@menu
* [9.1]:: Starting Gnus is really slow, how to speed it up?
@ifnottex
@node [9.1], [9.2], FAQ 9 - Tuning Gnus, FAQ 9 - Tuning Gnus
@end ifnottex
-@subheading Question 9.1:
+@subsubheading Question 9.1:
Starting Gnus is really slow, how to speed it up?
@example
-
(require 'message)
(add-to-list 'message-syntax-checks '(sender . disabled))
-
@end example
@noindent
@example
-
(eval-after-load "message"
'(add-to-list 'message-syntax-checks '(sender . disabled)))
-
@end example
@noindent
@ifnottex
@node [9.2], [9.3], [9.1], FAQ 9 - Tuning Gnus
@end ifnottex
-@subheading Question 9.2:
+@subsubheading Question 9.2:
How to speed up the process of entering a group?
@example
-
(gnus-compile)
-
@end example
@noindent
@example
-
(setq gc-cons-threshold 3500000)
-
@end example
@noindent
@example
-
(setq gnus-use-correct-string-widths nil)
-
@end example
@ifnottex
@node [9.3], , [9.2], FAQ 9 - Tuning Gnus
@end ifnottex
-@subheading Question 9.3:
+@subsubheading Question 9.3:
Sending mail becomes slower and slower, what's up?
@ifnottex
@node FAQ - Glossary, , FAQ 9 - Tuning Gnus, Frequently Asked Questions
@end ifnottex
-@section Glossary
+@subsection Glossary
@table @dfn
(defface my-group-face-1
'((t (:foreground "Red" :bold t))) "First group face")
(defface my-group-face-2
- '((t (:foreground "DarkSeaGreen4" :bold t))) "Second group face")
+ '((t (:foreground "DarkSeaGreen4" :bold t)))
+ "Second group face")
(defface my-group-face-3
'((t (:foreground "Green4" :bold t))) "Third group face")
(defface my-group-face-4
@}
@end example
-The Sieve language is described in RFC 3028. @xref{Top, , Top, sieve,
-Emacs Sieve}.
+The Sieve language is described in RFC 3028. @xref{Top, , Top, sieve,
+Emacs Sieve.}
@item (@var{variable} @var{form})
You can use the group parameters to set variables local to the group you
@vindex gnus-list-identifiers
A use for this feature is to remove a mailing list identifier tag in
the subject fields of articles. E.g. if the news group
-@samp{nntp+news.gnus.org:gmane.text.docbook.apps} has the tag
-@samp{DOC-BOOK-APPS:} in the subject of all articles, this tag can be
-removed from the article subjects in the summary buffer for the group by
-putting @code{(gnus-list-identifiers "DOCBOOK-APPS:")} into the group
-parameters for the group.
+@example
+nntp+news.gnus.org:gmane.text.docbook.apps
+@end example
+has the tag @samp{DOC-BOOK-APPS:} in the subject of all articles, this
+tag can be removed from the article subjects in the summary buffer for
+the group by putting @code{(gnus-list-identifiers "DOCBOOK-APPS:")}
+into the group parameters for the group.
This can also be used as a group-specific hook function, if you'd like.
If you want to hear a beep when you enter a group, you could put
@item G S m
@kindex G S m (Group)
@findex gnus-group-sort-groups-by-method
-Sort the group buffer alphabetically by back end name
+Sort the group buffer alphabetically by back end name@*
(@code{gnus-group-sort-groups-by-method}).
@item G S n
@item G P m
@kindex G P m (Group)
@findex gnus-group-sort-selected-groups-by-method
-Sort the groups alphabetically by back end name
+Sort the groups alphabetically by back end name@*
(@code{gnus-group-sort-selected-groups-by-method}).
@item G P n
So, let's have a look at an example group buffer:
@example
+@group
Gnus
Emacs -- I wuw it!
3: comp.emacs
Misc
8: comp.binaries.fractals
13: comp.sources.unix
+@end group
@end example
So, here we have one top-level topic (@samp{Gnus}), two topics under
article, you could say something like:
@lisp
+@group
(add-hook 'gnus-summary-mode-hook 'my-alter-summary-map)
(defun my-alter-summary-map ()
(local-set-key "!" 'gnus-summary-put-mark-as-ticked-next))
+@end group
@end lisp
or
@item / c
@kindex / c (Summary)
@findex gnus-summary-limit-exclude-childless-dormant
-Exclude all dormant articles that have no children from the limit
+Exclude all dormant articles that have no children from the limit@*
(@code{gnus-summary-limit-exclude-childless-dormant}).
@item / C
This can also be a predicate specifier (@pxref{Predicate Specifiers}).
Available predicates are @code{gnus-article-unread-p} and
-@code{gnus-article-unseen-p}).
+@code{gnus-article-unseen-p}.
Here's an example:
@item T s
@kindex T s (Summary)
@findex gnus-summary-show-thread
-Expose the (sub-)thread hidden under the current article, if any
+Expose the (sub-)thread hidden under the current article, if any@*
(@code{gnus-summary-show-thread}).
@item T h
sends, you can use the following element to remove them:
@lisp
-("@@yoo-hoo\\.co\\.jp\\'" . "\n_+\nDo You Yoo-hoo!\\?\n.*\n.*\n")
+("@@yoo-hoo\\.co\\.jp\\'" .
+ "\n_+\nDo You Yoo-hoo!\\?\n.*\n.*\n")
@end lisp
@end table
@item W Y a
@kindex W Y a (Summary)
@findex gnus-article-outlook-repair-attribution
-Repair a broken attribution line.
+Repair a broken attribution line.@*
(@code{gnus-article-outlook-repair-attribution}).
@item W Y c
@end lisp
@var{header} is a regular expression.
+@end table
@subsubsection Related variables and functions
+@table @code
@item gnus-button-@var{*}-level
@xref{Article Button Levels}.
@item gnus-tree-brackets
@vindex gnus-tree-brackets
This is used for differentiating between ``real'' articles and
-``sparse'' articles. The format is @code{((@var{real-open} . @var{real-close})
-(@var{sparse-open} . @var{sparse-close}) (@var{dummy-open} . @var{dummy-close}))}, and the
-default is @code{((?[ . ?]) (?( . ?)) (?@{ . ?@}) (?< . ?>))}.
+``sparse'' articles. The format is
+@example
+((@var{real-open} . @var{real-close})
+ (@var{sparse-open} . @var{sparse-close})
+ (@var{dummy-open} . @var{dummy-close}))
+@end example
+and the default is @code{((?[ . ?]) (?( . ?)) (?@{ . ?@}) (?< . ?>))}.
@item gnus-tree-parent-child-edges
@vindex gnus-tree-parent-child-edges
Here's the same thread displayed in a vertical tree buffer:
@example
+@group
@{***@}
|--------------------------\-----\-----\
(***) [Bjo] [Gun] [Gun]
[Gun] [Eri] [Eri] [odd]
|
[Paa]
+@end group
@end example
If you're using horizontal trees, it might be nice to display the trees
@lisp
(setq gnus-newsgroup-variables
- '(message-use-followup-to
- (gnus-visible-headers .
- "^From:\\|^Newsgroups:\\|^Subject:\\|^Date:\\|^To:")))
+ '(message-use-followup-to
+ (gnus-visible-headers .
+ "^From:\\|^Newsgroups:\\|^Subject:\\|^Date:\\|^To:")))
@end lisp
@end table
@example
application/pgp-keys; gpg --import --interactive --verbose; needsterminal
@end example
-
+@noindent
This happens to also be the default action defined in
@code{mailcap-mime-data}.
@item nnspool-nov-directory
@vindex nnspool-nov-directory
-Where @code{nnspool} will look for @acronym{NOV} files. This is normally
+Where @code{nnspool} will look for @acronym{NOV} files. This is normally@*
@file{/usr/spool/news/over.view/}.
@item nnspool-lib-dir
@table @code
@item mail-source-crash-box
@vindex mail-source-crash-box
-File where mail will be stored while processing it. The default is
+File where mail will be stored while processing it. The default is@*
@file{~/.emacs-mail-crash-box}.
@item mail-source-delete-incoming
@lisp
(setq nnmail-split-fancy
'(| ;; @r{Messages duplicates go to a separate group.}
- ("gnus-warning" "duplicat\\(e\\|ion\\) of message" "duplicate")
- ;; @r{Message from daemons, postmaster, and the like to another.}
- (any mail "mail.misc")
- ;; @r{Other rules.}
- [ ... ] ))
+ ("gnus-warning" "duplicat\\(e\\|ion\\) of message" "duplicate")
+ ;; @r{Message from daemons, postmaster, and the like to another.}
+ (any mail "mail.misc")
+ ;; @r{Other rules.}
+ [...] ))
@end lisp
-
+@noindent
Or something like:
@lisp
(setq nnmail-split-methods
article (other than via expiry) may also make an article younger.
@item expire-group
-If this is set to a string (a full Gnus group name, like
-@code{"backend+server.address.string:group.name"}), and if it is not
-the name of the same group that the parameter belongs to, then
-articles will be moved to the specified group during expiry before
-being deleted. @emph{If this is set to an nnmaildir group, the
+If this is set to a string such as a full Gnus group name, like
+@example
+"backend+server.address.string:group.name"
+@end example
+and if it is not the name of the same group that the parameter belongs
+to, then articles will be moved to the specified group during expiry
+before being deleted. @emph{If this is set to an nnmaildir group, the
article will be just as old in the destination group as it was in the
source group.} So be careful with @code{expire-age} in the
destination group. If this is set to the name of the same group that
@item nnslashdot-active-url
@vindex nnslashdot-active-url
The @sc{url} format string that will be used to fetch the information on
-news articles and comments. The default is
+news articles and comments. The default is@*
@samp{http://slashdot.org/search.pl?section=&min=%d}.
@item nnslashdot-comments-url
@table @code
@item nnultimate-directory
@vindex nnultimate-directory
-The directory where @code{nnultimate} stores its files. The default is
+The directory where @code{nnultimate} stores its files. The default is@*
@file{~/News/ultimate/}.
@end table
@table @code
@item nnwarchive-directory
@vindex nnwarchive-directory
-The directory where @code{nnwarchive} stores its files. The default is
+The directory where @code{nnwarchive} stores its files. The default is@*
@file{~/News/warchive/}.
@item nnwarchive-login
@lisp
(setq nnimap-split-rule
- '(("my1server" (".*" (("ding" "ding@@gnus.org")
- ("junk" "From:.*Simon")))
+ '(("my1server" (".*" (("ding" "ding@@gnus.org")
+ ("junk" "From:.*Simon")))
("my2server" ("INBOX" nnimap-split-fancy))
- ("my[34]server" (".*" (("private" "To:.*Simon")
- ("junk" my-junk-func)))))
+ ("my[34]server" (".*" (("private" "To:.*Simon")
+ ("junk" my-junk-func)))))
@end lisp
The virtual server name is in fact a regexp, so that the same rules
The @acronym{IMAP} protocol has a concept called namespaces, described
by the following text in the RFC:
-@example
+@display
5.1.2. Mailbox Namespace Naming Convention
By convention, the first hierarchical element of any mailbox name
comp.mail.misc newsgroup would have an mailbox name of
"#news.comp.mail.misc", and the name "comp.mail.misc" could refer
to a different object (e.g. a user's private mailbox).
-@end example
+@end display
While there is nothing in this text that warrants concern for the
@acronym{IMAP} implementation in Gnus, some servers use namespace
@item nngateway-mail2news-header-transformation
Creates a @code{To} header that looks like
@code{nngateway-address}.
+@end table
+
+@end table
Here's an example:
nngateway-mail2news-header-transformation)))
@end lisp
-@end table
-
-
-@end table
-
So, to use this, simply say something like:
@lisp
@code{gnus-secondary-select-methods} are agentized.
@item
-
Decide on download policy. It's fairly simple once you decide whether
you are going to use agent categories, topic parameters, and/or group
parameters to implement your policy. If you're new to gnus, it
may look like:
@example
+@group
split = frame | horizontal | vertical | buffer | form
frame = "(frame " size *split ")"
horizontal = "(horizontal " size *split ")"
buffer = "(" buf-name " " size *[ "point" ] *[ "frame-focus"] ")"
size = number | frame-params
buf-name = group | article | summary ...
+@end group
@end example
The limitations are that the @code{frame} split can only appear as the
@item gnus-nocem-groups
@vindex gnus-nocem-groups
Gnus will look for NoCeM messages in the groups in this list. The
-default is @code{("news.lists.filters" "news.admin.net-abuse.bulletins"
-"alt.nocem.misc" "news.admin.net-abuse.announce")}.
+default is
+@lisp
+("news.lists.filters" "news.admin.net-abuse.bulletins"
+ "alt.nocem.misc" "news.admin.net-abuse.announce")
+@end lisp
@item gnus-nocem-issuers
@vindex gnus-nocem-issuers
There are many people issuing NoCeM messages. This list says what
-people you want to listen to. The default is @code{("Automoose-1"
-"clewis@@ferret.ocunix.on.ca" "cosmo.roadkill" "SpamHippo"
-"hweede@@snafu.de")}; fine, upstanding citizens all of them.
+people you want to listen to. The default is
+@lisp
+("Automoose-1" "clewis@@ferret.ocunix.on.ca"
+ "cosmo.roadkill" "SpamHippo" "hweede@@snafu.de")
+@end lisp
+fine, upstanding citizens all of them.
-Known despammers that you can put in this list are listed at
+Known despammers that you can put in this list are listed at@*
@uref{http://www.xs4all.nl/~rosalind/nocemreg/nocemreg.html}.
You do not have to heed NoCeM messages from all these people---just the
@item gnus-nocem-directory
@vindex gnus-nocem-directory
-This is where Gnus will store its NoCeM cache files. The default is
+This is where Gnus will store its NoCeM cache files. The default is@*
@file{~/News/NoCeM/}.
@item gnus-nocem-expiry-wait
(add-hook 'message-send-hook 'mail-add-payment)
@end lisp
-The @code{hashcash.el} library can be found at
-@uref{http://users.actrix.gen.nz/mycroft/hashcash.el}, or in the Gnus
-development contrib directory.
+The @code{hashcash.el} library can be found in the Gnus development
+contrib directory. or at
+@uref{http://users.actrix.gen.nz/mycroft/hashcash.el}.
You will need to set up some additional variables as well:
Typical test will involve calls to the following functions:
-@example
+@smallexample
Reset: (setq spam-stat (make-hash-table :test 'equal))
Learn spam: (spam-stat-process-spam-directory "~/Mail/mail/spam")
Learn non-spam: (spam-stat-process-non-spam-directory "~/Mail/mail/misc")
Number of words: (hash-table-count spam-stat)
Test spam: (spam-stat-test-directory "~/Mail/mail/spam")
Test non-spam: (spam-stat-test-directory "~/Mail/mail/misc")
-@end example
+@end smallexample
Here is how you would create your dictionary:
-@example
+@smallexample
Reset: (setq spam-stat (make-hash-table :test 'equal))
Learn spam: (spam-stat-process-spam-directory "~/Mail/mail/spam")
Learn non-spam: (spam-stat-process-non-spam-directory "~/Mail/mail/misc")
Repeat for any other non-spam group you need...
Reduce table size: (spam-stat-reduce-size)
Save table: (spam-stat-save)
-@end example
+@end smallexample
@node Various Various
@section Various Various
manifests itself by causing Gnus to be very slow. In these cases, you
can use @kbd{M-x toggle-debug-on-quit} and press @kbd{C-g} when things are
slow, and then try to analyze the backtrace (repeating the procedure
-helps isolating the real problem areas). A fancier approach is to use
-the elisp profiler, ELP. The profiler is (or should be) fully
-documented elsewhere, but to get you started there are a few steps
-that need to be followed. First, instrument the part of Gnus you are
-interested in for profiling, e.g. @kbd{M-x elp-instrument-package RET
-gnus} or @kbd{M-x elp-instrument-package RET message}. Then perform
-the operation that is slow and press @kbd{M-x elp-results}. You will
-then see which operations that takes time, and can debug them further.
-If the entire operation takes much longer than the time spent in the
-slowest function in the profiler output, you probably profiled the
-wrong part of Gnus. To reset profiling statistics, use @kbd{M-x
-elp-reset-all}. @kbd{M-x elp-restore-all} is supposed to remove
-profiling, but given the complexities and dynamic code generation in
-Gnus, it might not always work perfectly.
-
-If you just need help, you are better off asking on
-@samp{gnu.emacs.gnus}. I'm not very helpful.
+helps isolating the real problem areas).
+
+A fancier approach is to use the elisp profiler, ELP. The profiler is
+(or should be) fully documented elsewhere, but to get you started
+there are a few steps that need to be followed. First, instrument the
+part of Gnus you are interested in for profiling, e.g. @kbd{M-x
+elp-instrument-package RET gnus} or @kbd{M-x elp-instrument-package
+RET message}. Then perform the operation that is slow and press
+@kbd{M-x elp-results}. You will then see which operations that takes
+time, and can debug them further. If the entire operation takes much
+longer than the time spent in the slowest function in the profiler
+output, you probably profiled the wrong part of Gnus. To reset
+profiling statistics, use @kbd{M-x elp-reset-all}. @kbd{M-x
+elp-restore-all} is supposed to remove profiling, but given the
+complexities and dynamic code generation in Gnus, it might not always
+work perfectly.
@cindex gnu.emacs.gnus
@cindex ding mailing list
-You can also ask on the ding mailing list---@email{ding@@gnus.org}.
-Write to @email{ding-request@@gnus.org} to subscribe.
+If you just need help, you are better off asking on
+@samp{gnu.emacs.gnus}. I'm not very helpful. You can also ask on
+@email{ding@@gnus.org, the ding mailing list}. Write to
+@email{ding-request@@gnus.org} to subscribe.
@page
projects / gnus / commitdiff