*** empty log message ***
[emacs.git] / man / gnus-faq.texi
blob482805178378d85bd00c0dffd8ecce8b72b0a2bd
1 @c Insert  "\input texinfo" at 1st line before texing this file alone.
2 @c -*-texinfo-*-
3 @c Copyright (C) 1995, 98, 99, 2000 Free Software Foundation, Inc.
4 @setfilename ../info/gnus-faq.info
6 @node Frequently Asked Questions
7 @section Frequently Asked Questions
9 This is the Gnus Frequently Asked Questions list.
10 If you have a Web browser, the official hypertext version is at
11 @file{http://www.ccs.neu.edu/software/gnus/}, and has
12 probably been updated since you got this manual.
14 @menu
15 * Installation FAQ::      Installation of Gnus.
16 * Customization FAQ::     Customizing Gnus.
17 * Reading News FAQ::      News Reading Questions.
18 * Reading Mail FAQ::      Mail Reading Questions.
19 @end menu
22 @node Installation FAQ
23 @subsection Installation
25 @itemize @bullet
26 @item
27 Q1.1  What is the latest version of Gnus?
29 The latest (and greatest) version is 5.0.10.  You might also run
30 across something called @emph{September Gnus}.  September Gnus
31 is the alpha version of the next major release of Gnus.  It is currently
32 not stable enough to run unless you are prepared to debug lisp.
34 @item
35 Q1.2  Where do I get Gnus?
37 Any of the following locations:
39 @itemize @minus
40 @item
41 @file{ftp://ftp.ifi.uio.no/pub/emacs/gnus/gnus.tar.gz}
43 @item
44 @file{ftp://ftp.pilgrim.umass.edu/pub/misc/ding/}
46 @item
47 @file{gopher://gopher.pilgrim.umass.edu/11/pub/misc/ding/}
49 @item
50 @file{ftp://aphrodite.nectar.cs.cmu.edu/pub/ding-gnus/}
52 @item
53 @file{ftp://ftp.solace.mh.se:/pub/gnu/elisp/}
55 @end itemize
57 @item
58 Q1.3  Which version of Emacs do I need?
60 At least GNU Emacs 19.28, or XEmacs 19.12 is recommended.  GNU Emacs
61 19.25 has been reported to work under certain circumstances, but it
62 doesn't @emph{officially} work on it.  19.27 has also been reported to
63 work.  Gnus has been reported to work under OS/2 as well as Unix.
66 @item
67 Q1.4  Where is timezone.el?
69 Upgrade to XEmacs 19.13.  In earlier versions of XEmacs this file was
70 placed with Gnus 4.1.3, but that has been corrected.
73 @item
74 Q1.5  When I run Gnus on XEmacs 19.13 I get weird error messages.
76 You're running an old version of Gnus.  Upgrade to at least version
77 5.0.4.
80 @item
81 Q1.6  How do I unsubscribe from the Mailing List?
83 Send an e-mail message to @file{ding-request@@ifi.uio.no} with the magic word
84 @emph{unsubscribe} somewhere in it, and you will be removed.
86 If you are reading the digest version of the list, send an e-mail message
87 to @*
88 @file{ding-rn-digests-d-request@@moe.shore.net}
89 with @emph{unsubscribe} as the subject and you will be removed.
92 @item
93 Q1.7  How do I run Gnus on both Emacs and XEmacs?
95 The basic answer is to byte-compile under XEmacs, and then you can
96 run under either Emacsen.  There is, however, a potential version
97 problem with easymenu.el with Gnu Emacs prior to 19.29.
99 Per Abrahamsen <abraham@@dina.kvl.dk> writes :@*
100 The internal easymenu.el interface changed between 19.28 and 19.29 in
101 order to make it possible to create byte compiled files that can be
102 shared between Gnu Emacs and XEmacs.  The change is upward
103 compatible, but not downward compatible. 
104 This gives the following compatibility table:
106 @example
107 Compiled with:  | Can be used with:
108 ----------------+--------------------------------------
109 19.28           | 19.28         19.29
110 19.29           |               19.29           XEmacs
111 XEmacs          |               19.29           XEmacs
112 @end example
114 If you have Gnu Emacs 19.28 or earlier, or XEmacs 19.12 or earlier, get
115 a recent version of auc-menu.el from
116 @file{ftp://ftp.iesd.auc.dk/pub/emacs-lisp/auc-menu.el}, and install it
117 under the name easymenu.el somewhere early in your load path.
120 @item
121 Q1.8 What resources are available?
123 There is the newsgroup Gnu.emacs.gnus. Discussion of Gnus 5.x is now
124 taking place there. There is also a mailing list, send mail to
125 @file{ding-request@@ifi.uio.no} with the magic word @emph{subscribe}
126 somewhere in it.
128 @emph{NOTE:} the traffic on this list is heavy so you may not want to be
129 on it (unless you use Gnus as your mailer reader, that is). The mailing
130 list is mainly for developers and testers.
132 Gnus has a home World Wide Web page at@*
133 @file{http://www.ifi.uio.no/~larsi/ding.html}.
134    
135 Gnus has a write up in the X Applications FAQ at@*
136 @file{http://www.ee.ryerson.ca:8080/~elf/xapps/Q-III.html}.
137    
138 The Gnus manual is also available on the World Wide Web. The canonical
139 source is in Norway at@*
140 @file{http://www.ifi.uio.no/~larsi/ding-manual/gnus_toc.html}.
142 There are three mirrors in the United States:
143 @enumerate
144 @item
145 @file{http://www.miranova.com/gnus-man/}
147 @item
148 @file{http://www.pilgrim.umass.edu/pub/misc/ding/manual/gnus_toc.html}
150 @item
151 @file{http://www.rtd.com/~woo/gnus/}
153 @end enumerate
155 PostScript copies of the Gnus Reference card are available from@*
156 @file{ftp://ftp.cs.ualberta.ca/pub/oolog/gnus/}.  They are mirrored at@*
157 @file{ftp://ftp.pilgrim.umass.edu/pub/misc/ding/refcard/} in the
158 United States. And@*
159 @file{ftp://marvin.fkphy.uni-duesseldorf.de/pub/gnus/}
160 in Germany.
161    
162 An online version of the Gnus FAQ is available at@*
163 @file{http://www.miranova.com/~steve/gnus-faq.html}. Off-line formats
164 are also available:@*
165 ASCII: @file{ftp://ftp.miranova.com/pub/gnus/gnus-faq}@*
166 PostScript: @file{ftp://ftp.miranova.com/pub/gnus/gnus-faq.ps}.
169 @item
170 Q1.9  Gnus hangs on connecting to NNTP server
172 I am running XEmacs on SunOS and Gnus prints a message about Connecting
173 to NNTP server and then just hangs.
175 Ben Wing <wing@@netcom.com> writes :@*
176 I wonder if you're hitting the infamous @emph{libresolv} problem.
177 The basic problem is that under SunOS you can compile either
178 with DNS or NIS name lookup libraries but not both.  Try
179 substituting the IP address and see if that works; if so, you
180 need to download the sources and recompile.
183 @item
184 Q1.10  Mailcrypt 3.4 doesn't work
186 This problem is verified to still exist in Gnus 5.0.9 and Mailcrypt 3.4.
187 The answer comes from Peter Arius
188 <arius@@immd2.informatik.uni-erlangen.de>.
190 I found out that mailcrypt uses
191 @code{gnus-eval-in-buffer-window}, which is a macro.
192 It seems as if you have
193 compiled mailcrypt with plain old GNUS in load path, and the XEmacs byte
194 compiler has inserted that macro definition into
195 @file{mc-toplev.elc}.
196 The solution is to recompile @file{mc-toplev.el} with Gnus 5 in
197 load-path, and it works fine.
199 Steve Baur <steve@@miranova.com> adds :@*
200 The problem also manifests itself if neither GNUS 4 nor Gnus 5 is in the
201 load-path.
204 @item
205 Q1.11  What other packages work with Gnus?
207 @itemize @minus
208 @item
209 Mailcrypt.
211 Mailcrypt is an Emacs interface to PGP.  It works, it installs
212 without hassle, and integrates very easily.  Mailcrypt can be
213 obtained from@*
214 @file{ftp://cag.lcs.mit.edu/pub/patl/mailcrypt-3.4.tar.gz}.
216 @item
217 Tools for Mime.
219 Tools for Mime is an Emacs MUA interface to MIME.  Installation is
220 a two-step process unlike most other packages, so you should
221 be prepared to move the byte-compiled code somewhere.  There
222 are currently two versions of this package available.  It can
223 be obtained from@*
224 @file{ftp://ftp.jaist.ac.jp/pub/GNU/elisp/}.
225 Be sure to apply the supplied patch.  It works with Gnus through
226 version 5.0.9.  In order for all dependencies to work correctly
227 the load sequence is as follows:
228 @lisp
229   (load "tm-setup")
230   (load "gnus")
231   (load "mime-compose")
232 @end lisp
234 @emph{NOTE:} Loading the package disables citation highlighting by
235 default.  To get the old behavior back, use the @kbd{M-t} command.
237 @end itemize
239 @end itemize
242 @node Customization FAQ
243 @subsection Customization
245 @itemize @bullet
246 @item
247 Q2.1  Custom Edit does not work under XEmacs
249 The custom package has not been ported to XEmacs.
252 @item
253 Q2.2  How do I quote messages?
255 I see lots of messages with quoted material in them.  I am wondering
256 how to have Gnus do it for me.
258 This is Gnus, so there are a number of ways of doing this.  You can use
259 the built-in commands to do this.  There are the @kbd{F} and @kbd{R}
260 keys from the summary buffer which automatically include the article
261 being responded to.  These commands are also selectable as @i{Followup
262 and Yank} and @i{Reply and Yank} in the Post menu.
264 @kbd{C-c C-y} grabs the previous message and prefixes each line with
265 @code{ail-indentation-spaces} spaces or @code{mail-yank-prefix} if that is
266 non-nil, unless you have set your own @code{mail-citation-hook}, which will
267 be called to do the job.
269 You might also consider the Supercite package, which allows for pretty
270 arbitrarily complex quoting styles.  Some people love it, some people
271 hate it.
274 @item
275 Q2.3 How can I keep my nnvirtual:* groups sorted?
277 How can I most efficiently arrange matters so as to keep my nnvirtual:*
278 (etc) groups at the top of my group selection buffer, whilst keeping
279 everything sorted in alphabetical order.
280    
281 If you don't subscribe often to new groups then the easiest way is to
282 first sort the groups and then manually kill and yank the virtuals
283 wherever you want them.
286 @item
287 Q2.4  Any good suggestions on stuff for an all.SCORE file?
289 Here is a collection of suggestions from the Gnus mailing list.
291 @enumerate
292 @item
293 From ``Dave Disser'' <disser@@sdd.hp.com>@*
294 I like blasting anything without lowercase letters.  Weeds out most of
295 the make $$ fast, as well as the lame titles like ``IBM'' and ``HP-UX''
296 with no further description.
297 @lisp
298  (("Subject"
299   ("^\\(Re: \\)?[^a-z]*$" -200 nil R)))
300 @end lisp
302 @item
303 From ``Peter Arius'' <arius@@immd2.informatik.uni-erlangen.de>@*
304 The most vital entries in my (still young) all.SCORE:
305 @lisp
306 (("xref"
307   ("alt.fan.oj-simpson" -1000 nil s))
308  ("subject"
309   ("\\<\\(make\\|fast\\|big\\)\\s-*\\(money\\|cash\\|bucks?\\)\\>" -1000 nil r)
310   ("$$$$" -1000 nil s)))
311 @end lisp
313 @item
314 From ``Per Abrahamsen'' <abraham@@dina.kvl.dk>@*
315 @lisp
316 (("subject"
317   ;; CAPS OF THE WORLD, UNITE
318   ("^..[^a-z]+$" -1 nil R)
319   ;; $$$ Make Money $$$ (Try work)
320   ("$" -1 nil s)
321   ;; I'm important! And I have exclamation marks to prove it!
322   ("!" -1 nil s)))
323 @end lisp
325 @item
326 From ``heddy boubaker'' <boubaker@@cenatls.cena.dgac.fr>@*
327 I  would like to contribute with mine.
328 @lisp
330  (read-only t)
331  ("subject"
332   ;; ALL CAPS SUBJECTS
333   ("^\\([Rr][Ee]: +\\)?[^a-z]+$" -1 nil R)
334   ;; $$$ Make Money $$$
335   ("$$" -10 nil s)
336   ;; Empty subjects are worthless!
337   ("^ *\\([(<]none[>)]\\|(no subject\\( given\\)?)\\)? *$" -10 nil r)
338   ;; Sometimes interesting announces occur!
339   ("ANN?OU?NC\\(E\\|ING\\)" +10 nil r)
340   ;; Some people think they're on mailing lists
341   ("\\(un\\)?sub?scribe" -100 nil r)
342   ;; Stop Micro$oft NOW!!
343   ("\\(m\\(icro\\)?[s$]\\(oft\\|lot\\)?-?\\)?wind?\\(ows\\|aube\\|oze\\)?[- ]*\\('?95\\|NT\\|3[.]1\\|32\\)" -1001 nil r)
344   ;; I've nothing to buy
345   ("\\(for\\|4\\)[- ]*sale" -100 nil r)
346   ;; SELF-DISCIPLINED people
347   ("\\[[^a-z0-9 \t\n][^a-z0-9 \t\n]\\]" +100 nil r)
348   )
349  ("from"
350   ;; To keep track of posters from my site
351   (".dgac.fr" +1000 nil s))
352  ("followup"
353   ;; Keep track of answers to my posts
354   ("boubaker" +1000 nil s))
355  ("lines"
356   ;; Some people have really nothing to say!!
357   (1 -10 nil <=))
358  (mark -100)
359  (expunge -1000)
361 @end lisp
363 @item
364 From ``Christopher Jones'' <cjones@@au.oracle.com>@*
365 The sample @file{all.SCORE} files from Per and boubaker could be
366 augmented with:
367 @lisp
368         (("subject"
369           ;; No junk mail please!
370           ("please ignore" -500 nil s)
371           ("test" -500 nil e))
372         )
373 @end lisp
375 @item
376 From ``Brian Edmonds'' <edmonds@@cs.ubc.ca>@*
377 Augment any of the above with a fast method of scoring down
378 excessively cross posted articles.
379 @lisp
380  ("xref"
381   ;; the more cross posting, the exponentially worse the article
382   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+" -1 nil r)
383   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -2 nil r)
384   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -4 nil r)
385   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -8 nil r)
386   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -16 nil r)
387   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -32 nil r)
388   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -64 nil r)
389   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -128 nil r)
390   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -256 nil r)
391   ("^xref: \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+ \\S-+" -512 nil r))
392 @end lisp
394 @end enumerate
397 @item
398 Q2.5  What do I use to yank-through when replying?
400 You should probably reply and followup with @kbd{R} and @kbd{F}, instead
401 of @kbd{r} and @kbd{f}, which solves your problem.  But you could try
402 something like:
404 @example
405 (defconst mail-yank-ignored-headers
406   "^.*:"
407   "Delete these headers from old message when it's inserted in a reply.")
408 @end example
411 @item
412 Q2.6  I don't like the default WWW browser
414 Now when choosing an URL Gnus starts up a W3 buffer, I would like it
415 to always use Netscape (I don't browse in text-mode ;-).
417 @enumerate
418 @item
419 Activate `Customize...' from the `Help' menu.
421 @item
422 Scroll down to the `WWW Browser' field.
424 @item
425 Click `mouse-2' on `WWW Browser'.
427 @item
428 Select `Netscape' from the pop up menu.
430 @item
431 Press `C-c C-c'
433 @end enumerate
435 If you are using XEmacs then to specify Netscape do
436 @lisp
437   (setq gnus-button-url 'gnus-netscape-open-url)
438 @end lisp
441 @item
442 Q2.7 What, if any, relation is between ``ask-server'' and ``(setq
443 gnus-read-active-file 'some)''?
445 In order for Gnus to show you the complete list of newsgroups, it will
446 either have to either store the list locally, or ask the server to
447 transmit the list. You enable the first with
449 @lisp
450         (setq gnus-save-killed-list t)
451 @end lisp
453 and the second with
455 @lisp
456         (setq gnus-read-active-file t)
457 @end lisp
459 If both are disabled, Gnus will not know what newsgroups exists. There
460 is no option to get the list by casting a spell.
463 @item
464 Q2.8  Moving between groups is slow.
466 Per Abrahamsen <abraham@@dina.kvl.dk> writes:@*
468 Do you call @code{define-key} or something like that in one of the
469 summary mode hooks?  This would force Emacs to recalculate the keyboard
470 shortcuts.  Removing the call should speed up @kbd{M-x gnus-summary-mode
471 RET} by a couple of orders of magnitude.  You can use
473 @lisp
474 (define-key gnus-summary-mode-map KEY COMMAND)
475 @end lisp
477 in your @file{.gnus} instead.
479 @end itemize
482 @node Reading News FAQ
483 @subsection Reading News
485 @itemize @bullet
486 @item
487 Q3.1  How do I convert my kill files to score files?
489 A kill-to-score translator was written by Ethan Bradford
490 <ethanb@@ptolemy.astro.washington.edu>.  It is available from@*
491 @file{http://baugi.ifi.uio.no/~larsi/ding-various/gnus-kill-to-score.el}.
494 @item
495 Q3.2 My news server has a lot of groups, and killing groups is painfully
496 slow.
498 Don't do that then.  The best way to get rid of groups that should be
499 dead is to edit your newsrc directly.  This problem will be addressed
500 in the near future.
503 @item
504 Q3.3  How do I use an NNTP server with authentication?
506 Put the following into your .gnus:
507 @lisp
508  (add-hook 'nntp-server-opened-hook 'nntp-send-authinfo)
509 @end lisp
512 @item
513 Q3.4  Not reading the first article.
515 How do I avoid reading the first article when a group is selected?
517 @enumerate
518 @item
519 Use @kbd{RET} to select the group instead of @kbd{SPC}.
521 @item
522 @code{(setq gnus-auto-select first nil)}
524 @item
525 Luis Fernandes <elf@@mailhost.ee.ryerson.ca>writes:@*
526 This is what I use...customize as necessary...
528 @lisp
529 ;;; Don't auto-select first article if reading sources, or archives or
530 ;;; jobs postings, etc. and just display the summary buffer
531 (add-hook 'gnus-select-group-hook
532           (function
533            (lambda ()
534              (cond ((string-match "sources" gnus-newsgroup-name)
535                     (setq gnus-auto-select-first nil))
536                            ((string-match "jobs" gnus-newsgroup-name)
537                                 (setq gnus-auto-select-first nil))
538                    ((string-match "comp\\.archives" gnus-newsgroup-name)
539                     (setq gnus-auto-select-first nil))
540                    ((string-match "reviews" gnus-newsgroup-name)
541                     (setq gnus-auto-select-first nil))
542                    ((string-match "announce" gnus-newsgroup-name)
543                     (setq gnus-auto-select-first nil))
544                    ((string-match "binaries" gnus-newsgroup-name)
545                     (setq gnus-auto-select-first nil))
546                    (t
547                     (setq gnus-auto-select-first t))))))
548 @end lisp
550 @item
551 Per Abrahamsen <abraham@@dina.kvl.dk> writes:@*
552 Another possibility is to create an @file{all.binaries.all.SCORE} file
553 like this:
555 @lisp
556 ((local
557   (gnus-auto-select-first nil)))
558 @end lisp
560 and insert 
561 @lisp
562         (setq gnus-auto-select-first t)
563 @end lisp
565 in your @file{.gnus}.
567 @end enumerate
569 @item
570 Q3.5  Why aren't BBDB known posters marked in the summary buffer?
572 Brian Edmonds <edmonds@@cs.ubc.ca> writes:@*
573 Due to changes in Gnus 5.0, @file{bbdb-gnus.el} no longer marks known
574 posters in the summary buffer.  An updated version, @file{gnus-bbdb.el}
575 is available at the locations listed below.  This package also supports
576 autofiling of incoming mail to folders specified in the BBDB.  Extensive
577 instructions are included as comments in the file.
579 Send mail to @file{majordomo@@edmonds.home.cs.ubc.ca} with the following
580 line in the body of the message: @emph{get misc gnus-bbdb.el}.
582 Or get it from the World Wide Web:@*
583 @file{http://www.cs.ubc.ca/spider/edmonds/gnus-bbdb.el}.
585 @end itemize
588 @node Reading Mail FAQ
589 @subsection Reading Mail
591 @itemize @bullet
592 @item
593 Q4.1 What does the message ``Buffer has changed on disk'' mean in a mail
594 group?
596 Your filter program should not deliver mail directly to your folders,
597 instead it should put the mail into spool files.  Gnus will then move
598 the mail safely from the spool files into the folders.  This will
599 eliminate the problem.  Look it up in the manual, in the section
600 entitled ``Mail & Procmail''.
603 @item
604 Q4.2  How do you make articles un-expirable?
606 I am using nnml to read news and have used
607 @code{gnus-auto-expirable-newsgroups} to automagically expire articles
608 in some groups (Gnus being one of them).  Sometimes there are
609 interesting articles in these groups that I want to keep.  Is there any
610 way of explicitly marking an article as un-expirable - that is mark it
611 as read but not expirable?
613 Use @kbd{u}, @kbd{!}, @kbd{d} or @kbd{M-u} in the summary buffer. You
614 just remove the @kbd{E} mark by setting some other mark. It's not
615 necessary to tick the articles.
618 @item
619 Q4.3  How do I delete bogus nnml: groups?
621 My problem is that I have various mail (nnml) groups generated while
622 experimenting with Gnus. How do I remove them now? Setting the level to
623 9 does not help. Also @code{gnus-group-check-bogus-groups} does not
624 recognize them.
626 Removing mail groups is tricky at the moment. (It's on the to-do list,
627 though.) You basically have to kill the groups in Gnus, shut down Gnus,
628 edit the active file to exclude these groups, and probably remove the
629 nnml directories that contained these groups as well. Then start Gnus
630 back up again.
633 @item
634 Q4.4  What happened to my new mail groups?
636 I got new mail, but I have
637 never seen the groups they should have been placed in.
639 They are probably there, but as zombies. Press @kbd{A z} to list
640 zombie groups, and then subscribe to the groups you want with @kbd{u}.
641 This is all documented quite nicely in the user's manual.
644 @item
645 Q4.5  Not scoring mail groups
647 How do you @emph{totally} turn off scoring in mail groups?
649 Use an nnbabyl:all.SCORE (or nnmh, or nnml, or whatever) file containing:
651 @example
652 ((adapt ignore)
653  (local (gnus-use-scoring nil))
654  (exclude-files "all.SCORE"))
655 @end example
657 @end itemize