gnus-faq.texi 72.6 KB
Newer Older
Glenn Morris's avatar
Glenn Morris committed
1 2 3
@c \input texinfo @c -*-texinfo-*-
@c Uncomment 1st line before texing this file alone.
@c %**start of header
4
@c Copyright (C) 1995, 2001-2012 Free Software Foundation, Inc.
Glenn Morris's avatar
Glenn Morris committed
5 6 7 8 9 10 11 12 13 14
@c
@setfilename gnus-faq.info
@settitle Frequently Asked Questions
@c %**end of header
@c

@node Frequently Asked Questions
@section Frequently Asked Questions

@menu
Paul Eggert's avatar
Paul Eggert committed
15
* FAQ - Changes::
Glenn Morris's avatar
Glenn Morris committed
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
* FAQ - Introduction::                       About Gnus and this FAQ.
* FAQ 1 - Installation FAQ::                 Installation of Gnus.
* FAQ 2 - Startup / Group buffer::           Start up questions and the
                                             first buffer Gnus shows you.
* FAQ 3 - Getting Messages::                 Making Gnus read your mail
                                             and news.
* FAQ 4 - Reading messages::                 How to efficiently read
                                             messages.
* FAQ 5 - Composing messages::               Composing mails or Usenet
                                             postings.
* FAQ 6 - Old messages::                     Importing, archiving,
                                             searching and deleting messages.
* FAQ 7 - Gnus in a dial-up environment::    Reading mail and news while
                                             offline.
* FAQ 8 - Getting help::                     When this FAQ isn't enough.
* FAQ 9 - Tuning Gnus::                      How to make Gnus faster.
* FAQ - Glossary::                           Terms used in the FAQ
                                             explained.
@end menu

@subheading Abstract

This is the new Gnus Frequently Asked Questions list.

Paul Eggert's avatar
Paul Eggert committed
40
Please submit features and suggestions to the
41
@email{ding@@gnus.org, ding list}.
Glenn Morris's avatar
Glenn Morris committed
42 43 44 45 46 47 48 49 50

@node FAQ - Changes
@subheading Changes



@itemize @bullet

@item
Miles Bader's avatar
Miles Bader committed
51 52 53 54 55 56
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.
Glenn Morris's avatar
Glenn Morris committed
57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
@end itemize

@node FAQ - Introduction
@subheading Introduction

This is the Gnus Frequently Asked Questions list.

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

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

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

This version is much nicer than the unofficial hypertext
versions that are archived at Utrecht, Oxford, Smart Pages, Ohio
State, and other FAQ archives. See the resources question below
if you want information on obtaining it in another format.

The information contained here was compiled with the assistance
of the Gnus development mailing list, and any errors or
93
misprints are the Gnus team's fault, sorry.
Glenn Morris's avatar
Glenn Morris committed
94 95 96 97 98

@node FAQ 1 - Installation FAQ
@subsection Installation FAQ

@menu
Miles Bader's avatar
Miles Bader committed
99 100 101 102 103 104 105 106
* 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?
Glenn Morris's avatar
Glenn Morris committed
107 108
@end menu

Miles Bader's avatar
Miles Bader committed
109
@node FAQ 1-1
Glenn Morris's avatar
Glenn Morris committed
110 111 112 113 114 115 116 117 118
@subsubheading Question 1.1

What is the latest version of Gnus?

@subsubheading Answer

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

Miles Bader's avatar
Miles Bader committed
122
@node FAQ 1-2
Glenn Morris's avatar
Glenn Morris committed
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155
@subsubheading Question 1.2

What's new in 5.10?

@subsubheading Answer

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

@itemize @bullet

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

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

@item
Anti Spam features.

@item
Message-utils now included in Gnus.

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

Miles Bader's avatar
Miles Bader committed
156
@node FAQ 1-3
Glenn Morris's avatar
Glenn Morris committed
157 158 159 160 161 162 163
@subsubheading Question 1.3

Where and how to get Gnus?

@subsubheading Answer

Gnus is released independent from releases of Emacs and XEmacs.
164
Therefore, the version bundled with Emacs or the version in XEmacs's
Glenn Morris's avatar
Glenn Morris committed
165
package system might not be up to date (e.g. Gnus 5.9 bundled with Emacs
Miles Bader's avatar
Miles Bader committed
166
21 is outdated).
Glenn Morris's avatar
Glenn Morris committed
167
You can get the latest released version of Gnus from
Miles Bader's avatar
Miles Bader committed
168
@uref{http://www.gnus.org/dist/gnus.tar.gz}
Paul Eggert's avatar
Paul Eggert committed
169
or via anonymous FTP from
Glenn Morris's avatar
Glenn Morris committed
170 171
@uref{ftp://ftp.gnus.org/pub/gnus/gnus.tar.gz}.

Miles Bader's avatar
Miles Bader committed
172
@node FAQ 1-4
Glenn Morris's avatar
Glenn Morris committed
173 174 175 176 177 178
@subsubheading Question 1.4

What to do with the tarball now?

@subsubheading Answer

Paul Eggert's avatar
Paul Eggert committed
179
Untar it via @samp{tar xvzf gnus.tar.gz} and do the common
Glenn Morris's avatar
Glenn Morris committed
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202
@samp{./configure; make; make install} circle.
(under MS-Windows either get the Cygwin environment from
@uref{http://www.cygwin.com}
which allows you to do what's described above or unpack the
tarball with some packer (e.g. Winace from
@uref{http://www.winace.com})
and use the batch-file make.bat included in the tarball to install
Gnus.) If you don't want to (or aren't allowed to) install Gnus
system-wide, you can install it in your home directory and add the
following lines to your ~/.xemacs/init.el or ~/.emacs:

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

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

Miles Bader's avatar
Miles Bader committed
203
@node FAQ 1-5
Glenn Morris's avatar
Glenn Morris committed
204 205 206 207 208 209 210 211 212 213 214 215 216 217
@subsubheading Question 1.5

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

@subsubheading Answer

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

Miles Bader's avatar
Miles Bader committed
218
@node FAQ 1-6
Glenn Morris's avatar
Glenn Morris committed
219 220 221 222 223 224 225 226 227 228 229
@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.

Miles Bader's avatar
Miles Bader committed
230
@node FAQ 1-7
Glenn Morris's avatar
Glenn Morris committed
231 232 233 234 235 236 237 238 239 240 241 242 243 244 245
@subsubheading Question 1.7

How do I run Gnus on both Emacs and XEmacs?

@subsubheading Answer

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

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

@menu
Miles Bader's avatar
Miles Bader committed
246 247 248 249 250 251 252 253 254 255 256
* 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?
Glenn Morris's avatar
Glenn Morris committed
257 258
@end menu

Miles Bader's avatar
Miles Bader committed
259
@node FAQ 2-1
Glenn Morris's avatar
Glenn Morris committed
260 261 262 263 264 265 266 267 268
@subsubheading Question 2.1

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

@subsubheading Answer

This message means that the last time you used Gnus, it
Juanma Barranquero's avatar
Juanma Barranquero committed
269 270 271
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
Glenn Morris's avatar
Glenn Morris committed
272 273 274 275 276 277
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.

Miles Bader's avatar
Miles Bader committed
278
@node FAQ 2-2
Glenn Morris's avatar
Glenn Morris committed
279 280 281 282 283 284 285 286 287 288 289
@subsubheading Question 2.2

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

@subsubheading Answer

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

Miles Bader's avatar
Miles Bader committed
290
@node FAQ 2-3
Glenn Morris's avatar
Glenn Morris committed
291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306
@subsubheading Question 2.3

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

@subsubheading Answer

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

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

Miles Bader's avatar
Miles Bader committed
307
@node FAQ 2-4
Glenn Morris's avatar
Glenn Morris committed
308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
@subsubheading Question 2.4

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

@subsubheading Answer

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

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

Miles Bader's avatar
Miles Bader committed
330
@node FAQ 2-5
Glenn Morris's avatar
Glenn Morris committed
331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346
@subsubheading Question 2.5

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

@subsubheading Answer

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

@node FAQ 3 - Getting Messages
@subsection Getting Messages

@menu
Paul Eggert's avatar
Paul Eggert committed
347
* FAQ 3-1::     I just installed Gnus, started it via  @samp{M-x gnus}
Miles Bader's avatar
Miles Bader committed
348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366
                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?
Glenn Morris's avatar
Glenn Morris committed
367 368
@end menu

Miles Bader's avatar
Miles Bader committed
369
@node FAQ 3-1
Glenn Morris's avatar
Glenn Morris committed
370 371
@subsubheading Question 3.1

Paul Eggert's avatar
Paul Eggert committed
372 373
I just installed Gnus, started it via
@samp{M-x gnus}
Glenn Morris's avatar
Glenn Morris committed
374 375 376 377 378 379 380 381 382 383 384 385 386 387 388
but it only says "nntp (news) open error", what to do?

@subsubheading Answer

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

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

Miles Bader's avatar
Miles Bader committed
389
@node FAQ 3-2
Glenn Morris's avatar
Glenn Morris committed
390 391 392 393 394 395 396 397 398
@subsubheading Question 3.2

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

@subsubheading Answer

The ~/ means the home directory where Gnus and Emacs look
for the configuration files.  However, you don't really
need to know what this means, it suffices that Emacs knows
Paul Eggert's avatar
Paul Eggert committed
399 400
what it means :-) You can type
@samp{C-x C-f ~/.gnus.el RET }
Glenn Morris's avatar
Glenn Morris committed
401 402 403 404 405
(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
Paul Eggert's avatar
Paul Eggert committed
406
you want, so let's do it the correct way.
Glenn Morris's avatar
Glenn Morris committed
407 408 409 410 411 412 413 414 415 416 417 418
The first thing you've got to do is to
create a suitable directory (no blanks in directory name
please) e.g. c:\myhome. Then you must set the environment
variable HOME to this directory.  To do this under Win9x
or Me include the line

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

in your autoexec.bat and reboot.  Under NT, 2000 and XP, hit
Miles Bader's avatar
Miles Bader committed
419 420 421 422
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.
Glenn Morris's avatar
Glenn Morris committed
423 424 425 426 427

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

Miles Bader's avatar
Miles Bader committed
428
@node FAQ 3-3
Glenn Morris's avatar
Glenn Morris committed
429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444
@subsubheading Question 3.3

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

@subsubheading Answer

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

@example
machine news.yourprovider.net login YourUserName password YourPassword
@end example
@noindent
.
Make sure that the file isn't readable to others if you
work on a OS which is capable of doing so.  (Under Unix
Paul Eggert's avatar
Paul Eggert committed
445
say
Glenn Morris's avatar
Glenn Morris committed
446 447 448 449 450 451 452
@example
chmod 600 ~/.authinfo
@end example
@noindent

in a shell.)

Miles Bader's avatar
Miles Bader committed
453
@node FAQ 3-4
Glenn Morris's avatar
Glenn Morris committed
454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469
@subsubheading Question 3.4

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

@subsubheading Answer

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

Miles Bader's avatar
Miles Bader committed
470
@node FAQ 3-5
Glenn Morris's avatar
Glenn Morris committed
471 472 473 474 475 476 477 478 479
@subsubheading Question 3.5

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

@subsubheading Answer

Some providers allow restricted anonymous access and full
access only after authorization. To make Gnus send authinfo
Paul Eggert's avatar
Paul Eggert committed
480
to those servers append
Glenn Morris's avatar
Glenn Morris committed
481 482 483 484 485

@example
force yes
@end example
@noindent
Paul Eggert's avatar
Paul Eggert committed
486

Glenn Morris's avatar
Glenn Morris committed
487 488
to the line for those servers in ~/.authinfo.

Miles Bader's avatar
Miles Bader committed
489
@node FAQ 3-6
Glenn Morris's avatar
Glenn Morris committed
490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507
@subsubheading Question 3.6

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

@subsubheading Answer

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

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

Miles Bader's avatar
Miles Bader committed
508
@node FAQ 3-7
Glenn Morris's avatar
Glenn Morris committed
509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535
@subsubheading Question 3.7

And how about local spool files?

@subsubheading Answer

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

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

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

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

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

@example
(add-to-list 'gnus-secondary-select-methods
             '(nnspool ""
Glenn Morris's avatar
Glenn Morris committed
536
                       (nnspool-directory "/usr/local/myspoolddir")))
Glenn Morris's avatar
Glenn Morris committed
537 538 539 540 541 542 543
@end example
@noindent

This sets the spool directory for this server only.
You might have to specify more stuff like the program used
to post articles, see the Gnus manual on how to do this.

Miles Bader's avatar
Miles Bader committed
544
@node FAQ 3-8
Glenn Morris's avatar
Glenn Morris committed
545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565
@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?

@subsubheading Answer

That's a bit harder since there are many possible sources
for mail, many possible ways for storing mail and many
different ways for sending mail. The most common cases are
these: 1: You want to read your mail from a pop3 server and
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
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
Juanma Barranquero's avatar
Juanma Barranquero committed
566
and is therefore quite fast. However you might prefer a one
Glenn Morris's avatar
Glenn Morris committed
567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582
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:

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

As you might have guessed, if you want nnfolder, it's

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

Juanma Barranquero's avatar
Juanma Barranquero committed
583
Now we need to tell Gnus, where to get its mail from. If
Glenn Morris's avatar
Glenn Morris committed
584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620
it's a POP3 server, then you need something like this:

@example
(eval-after-load "mail-source"
  '(add-to-list 'mail-sources '(pop :server "pop.YourProvider.net"
                                    :user "yourUserName"
                                    :password "yourPassword")))
@end example
@noindent

Make sure ~/.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 '(file :path "/path/to/spool/file"))
@end example
@noindent

If it's a Maildir, with one file per message as used by
postfix, Qmail and (optionally) fetchmail it's

@example
(eval-after-load "mail-source"
  '(add-to-list 'mail-sources '(maildir :path "/path/to/Maildir/"
                                        :subdirs ("cur" "new")))
@end example
@noindent

And finally if you want to read your mail from several files
in one directory, for example because procmail already split your
mail, it's

@example
(eval-after-load "mail-source"
  '(add-to-list 'mail-sources
Glenn Morris's avatar
Glenn Morris committed
621 622
                '(directory :path "/path/to/procmail-dir/"
                            :suffix ".prcml")))
Glenn Morris's avatar
Glenn Morris committed
623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641
@end example
@noindent

Where :suffix ".prcml" tells Gnus only to use files with the
suffix .prcml.

OK, now you only need to tell Gnus how to send mail. If you
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

@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
@noindent

Miles Bader's avatar
Miles Bader committed
642
@node FAQ 3-9
Glenn Morris's avatar
Glenn Morris committed
643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676
@subsubheading Question 3.9

And what about IMAP?

@subsubheading Answer

There are two ways of using IMAP with Gnus. The first one is
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

@example
(add-to-list 'mail-sources '(imap :server "mail.mycorp.com"
                                  :user "username"
                                  :pass "password"
                                  :stream network
                                  :authentication login
                                  :mailbox "INBOX"
                                  :fetchflag "\\Seen"))
@end example
@noindent

You might have to tweak the values for stream and/or
authentication, see the Gnus manual node "Mail Source
Specifiers" for possible values.

If you want to use IMAP the way it's intended, you've got to
follow a different approach.  You've got to add the nnimap
back end to your select method and give the information
about the server there.

@example
(add-to-list 'gnus-secondary-select-methods
Glenn Morris's avatar
Glenn Morris committed
677 678 679 680
             '(nnimap "Give the baby a name"
                      (nnimap-address "imap.yourProvider.net")
                      (nnimap-port 143)
                      (nnimap-list-pattern "archive.*")))
Glenn Morris's avatar
Glenn Morris committed
681 682 683 684 685 686 687
@end example
@noindent

Again, you might have to specify how to authenticate to the
server if Gnus can't guess the correct way, see the Manual
Node "IMAP" for detailed information.

Miles Bader's avatar
Miles Bader committed
688
@node FAQ 3-10
Glenn Morris's avatar
Glenn Morris committed
689 690 691 692 693 694 695 696 697 698 699
@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?

@subsubheading Answer

Offer your administrator a pair of new running shoes for
activating IMAP on the server and follow the instructions
above.

Miles Bader's avatar
Miles Bader committed
700
@node FAQ 3-11
Glenn Morris's avatar
Glenn Morris committed
701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738
@subsubheading Question 3.11

Can I tell Gnus not to delete the mails on the server it
retrieves via POP3?

@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.

@node FAQ 4 - Reading messages
@subsection Reading messages

@menu
Miles Bader's avatar
Miles Bader committed
739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767
* 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 w3 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?
Glenn Morris's avatar
Glenn Morris committed
768 769
@end menu

Miles Bader's avatar
Miles Bader committed
770
@node FAQ 4-1
Glenn Morris's avatar
Glenn Morris committed
771 772 773 774 775 776
@subsubheading Question 4.1

When I enter a group, all read messages are gone. How to view them again?

@subsubheading Answer

Paul Eggert's avatar
Paul Eggert committed
777
If you enter the group by saying
Glenn Morris's avatar
Glenn Morris committed
778 779 780 781 782 783 784 785 786 787 788 789
@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
@samp{C-u 300 RET}

Loading only unread messages can be annoying if you have threaded view enabled, say

@example
(setq gnus-fetch-old-headers 'some)
@end example
@noindent
Paul Eggert's avatar
Paul Eggert committed
790

Glenn Morris's avatar
Glenn Morris committed
791
in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load
Paul Eggert's avatar
Paul Eggert committed
792
all articles (Warning: Both settings enlarge the amount of data which is
Glenn Morris's avatar
Glenn Morris committed
793 794
fetched when you enter a group and slow down the process of entering a group).

Paul Eggert's avatar
Paul Eggert committed
795 796
If you already use Gnus 5.10, you can say
@samp{/o N}
Glenn Morris's avatar
Glenn Morris committed
797 798 799 800 801 802
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.

Miles Bader's avatar
Miles Bader committed
803
@node FAQ 4-2
Glenn Morris's avatar
Glenn Morris committed
804 805 806 807 808 809 810 811 812 813 814 815 816 817
@subsubheading Question 4.2

How to tell Gnus to show an important message every time I
enter a group, even when it's read?

@subsubheading Answer

You can tick important messages. To do this hit
@samp{u} while point is in summary buffer
over the message. When you want to remove the mark, hit
either @samp{d} (this deletes the tick
mark and set's unread mark) or @samp{M c}
(which deletes all marks for the message).

Miles Bader's avatar
Miles Bader committed
818
@node FAQ 4-3
Glenn Morris's avatar
Glenn Morris committed
819 820 821 822 823 824
@subsubheading Question 4.3

How to view the headers of a message?

@subsubheading Answer

Paul Eggert's avatar
Paul Eggert committed
825
Say @samp{t}
Glenn Morris's avatar
Glenn Morris committed
826
to show all headers, one more
Paul Eggert's avatar
Paul Eggert committed
827
@samp{t}
Glenn Morris's avatar
Glenn Morris committed
828 829
hides them again.

Miles Bader's avatar
Miles Bader committed
830
@node FAQ 4-4
Glenn Morris's avatar
Glenn Morris committed
831 832 833 834 835 836
@subsubheading Question 4.4

How to view the raw unformatted message?

@subsubheading Answer

Paul Eggert's avatar
Paul Eggert committed
837 838
Say
@samp{C-u g}
Glenn Morris's avatar
Glenn Morris committed
839
to show the raw message
Paul Eggert's avatar
Paul Eggert committed
840
@samp{g}
Glenn Morris's avatar
Glenn Morris committed
841 842
returns to normal view.

Miles Bader's avatar
Miles Bader committed
843
@node FAQ 4-5
Glenn Morris's avatar
Glenn Morris committed
844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859
@subsubheading Question 4.5

How can I change the headers Gnus displays by default at
the top of the article buffer?

@subsubheading Answer

The variable gnus-visible-headers controls which headers
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:

@example
(setq gnus-visible-headers
      '("^From" "^Subject" "^Date" "^Newsgroups" "^Followup-To"
Glenn Morris's avatar
Glenn Morris committed
860
        "^User-Agent" "^X-Newsreader" "^X-Mailer"))
Glenn Morris's avatar
Glenn Morris committed
861 862 863
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
864
@node FAQ 4-6
Glenn Morris's avatar
Glenn Morris committed
865 866 867 868 869 870 871 872 873 874 875
@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?

@subsubheading Answer

Say

@example
(eval-after-load "mm-decode"
Paul Eggert's avatar
Paul Eggert committed
876
 '(progn
Glenn Morris's avatar
Glenn Morris committed
877 878 879 880 881 882 883 884 885 886 887 888 889 890
      (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

@example
(setq mm-automatic-display (remove "text/html" mm-automatic-display))
@end example
@noindent

too.

Miles Bader's avatar
Miles Bader committed
891
@node FAQ 4-7
Glenn Morris's avatar
Glenn Morris committed
892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908
@subsubheading Question 4.7

Can I use some other browser than w3 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
one is used can be specified in the variable
mm-text-html-renderer, so if you want links to render your
mail say

@example
(setq mm-text-html-renderer 'links)
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
909
@node FAQ 4-8
Glenn Morris's avatar
Glenn Morris committed
910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927
@subsubheading Question 4.8

Is there anything I can do to make poorly formatted mails
more readable?

@subsubheading Answer

Gnus offers you several functions to "wash" incoming mail, you can
find them if you browse through the menu, item
Article->Washing. The most interesting ones are probably "Wrap
long lines" (@samp{W w}), "Decode ROT13"
(@samp{W r}) and "Outlook Deuglify" which repairs
the dumb quoting used by many users of Microsoft products
(@samp{W Y f} gives you full deuglify.
See @samp{W Y C-h} or have a look at the menus for
other deuglifications).  Outlook deuglify is only available since
Gnus 5.10.

Miles Bader's avatar
Miles Bader committed
928
@node FAQ 4-9
Glenn Morris's avatar
Glenn Morris committed
929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997
@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
highlight more interesting ones in some way?

@subsubheading Answer

You want Scoring. Scoring means, that you define rules
which assign each message an integer value. Depending on
the value the message is highlighted in summary buffer (if
it's high, say +2000) or automatically marked read (if the
value is low, say -800) or some other action happens.

There are basically three ways of setting up rules which assign
the scoring-value to messages. The first and easiest way is to set
up rules based on the article you are just reading. Say you're
reading a message by a guy who always writes nonsense and you want
to ignore his messages in the future. Hit
@samp{L}, to set up a rule which lowers the score.
Now Gnus asks you which the criteria for lowering the Score shall
be. Hit @samp{?} twice to see all possibilities,
we want @samp{a} which means the author (the from
header). Now Gnus wants to know which kind of matching we want.
Hit either @samp{e} for an exact match or
@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.
@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}.

You can also set up rules by hand. To do this say @samp{V
f} in summary buffer. Then you are asked for the name
of the score file, it's name.of.group.SCORE for rules valid in
only one group or all.Score for rules valid in all groups. See the
Gnus manual for the exact syntax, basically it's one big list
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
following to your all.Score:

@example
(("references" ("hschmi22.userfqdn.rz-online.de" 500 nil s))
 ("message-id" ("hschmi22.userfqdn.rz-online.de" 999 nil s)))
@end example
@noindent

This would add 999 to the score of messages written by me
and 500 to the score of messages which are a (possibly
indirect) answer to a message written by me. Of course
nobody with a sane mind would do this :-)

The third alternative is adaptive scoring. This means Gnus
watches you and tries to find out what you find
interesting and what annoying and sets up rules
which reflect this. Adaptive scoring can be a huge help
when reading high traffic groups. If you want to activate
adaptive scoring say

@example
(setq gnus-use-adaptive-scoring t)
@end example
@noindent

in ~/.gnus.el.

Miles Bader's avatar
Miles Bader committed
998
@node FAQ 4-10
Glenn Morris's avatar
Glenn Morris committed
999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014
@subsubheading Question 4.10

How can I disable threading in some (e.g. mail-) groups, or
set other variables specific for some groups?

@subsubheading Answer

While in group buffer move point over the group and hit
@samp{G c}, this opens a buffer where you
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
value. Hit button done at the top of the buffer when
you're ready.

Miles Bader's avatar
Miles Bader committed
1015
@node FAQ 4-11
Glenn Morris's avatar
Glenn Morris committed
1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027
@subsubheading Question 4.11

Can I highlight messages written by me and follow-ups to
those?

@subsubheading Answer

Stop those "Can I ..." questions, the answer is always yes
in Gnus Country :-). It's a three step process: First we
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
1028
faces.
Glenn Morris's avatar
Glenn Morris committed
1029

Miles Bader's avatar
Miles Bader committed
1030
@node FAQ 4-12
Glenn Morris's avatar
Glenn Morris committed
1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044
@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
mail groups. Is this a bug?

@subsubheading Answer

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 -
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
Paul Eggert's avatar
Paul Eggert committed
1045
symptom, enter the group via @samp{C-u RET}
Glenn Morris's avatar
Glenn Morris committed
1046 1047 1048 1049 1050 1051 1052 1053
(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
all messages to the group they have been in before, they
get new message numbers in this process and the count is
right again (until you delete and move your mail to other
groups again).

Miles Bader's avatar
Miles Bader committed
1054
@node FAQ 4-13
Glenn Morris's avatar
Glenn Morris committed
1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083
@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?

@subsubheading Answer

You can control the windows configuration by calling the
function gnus-add-configuration. The syntax is a bit
complicated but explained very well in the manual node
"Window Layout". Some popular examples:

Instead 25% summary 75% article buffer 35% summary and 65%
article (the 1.0 for article means "take the remaining
space"):

@example
(gnus-add-configuration
 '(article (vertical 1.0 (summary .35 point) (article 1.0))))
@end example
@noindent

A three pane layout, Group buffer on the left, summary
buffer top-right, article buffer bottom-right:

@example
(gnus-add-configuration
 '(article
   (horizontal 1.0
Glenn Morris's avatar
Glenn Morris committed
1084 1085 1086 1087 1088
               (vertical 25
                         (group 1.0))
               (vertical 1.0
                         (summary 0.25 point)
                         (article 1.0)))))
Glenn Morris's avatar
Glenn Morris committed
1089 1090 1091
(gnus-add-configuration
 '(summary
   (horizontal 1.0
Glenn Morris's avatar
Glenn Morris committed
1092 1093 1094 1095
               (vertical 25
                         (group 1.0))
               (vertical 1.0
                         (summary 1.0 point)))))
Glenn Morris's avatar
Glenn Morris committed
1096 1097 1098
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1099
@node FAQ 4-14
Glenn Morris's avatar
Glenn Morris committed
1100 1101 1102 1103 1104 1105 1106
@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
Juanma Barranquero's avatar
Juanma Barranquero committed
1107
gnus-summary-line-format. Its value is a string of
Glenn Morris's avatar
Glenn Morris committed
1108 1109 1110
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
Juanma Barranquero's avatar
Juanma Barranquero committed
1111
node "Formatting Variables" and its sub-nodes. There
Glenn Morris's avatar
Glenn Morris committed
1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143
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
gives you a date where the details are dependent of the
articles age. Here's an example which uses both:

@example
(setq gnus-summary-line-format ":%U%R %B %s %-60=|%4L |%-20,20f |%&user-date; \n")
@end example
@noindent

resulting in:

@example
: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
:O  \->  ...                                      |  21 |Kai Grossjohann      | 0:01
:R  >  Re: Cry for help: deuglify.el - moving stuf|  28 |Lars Magne Ingebrigt |Sat 23:34
: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
: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

Miles Bader's avatar
Miles Bader committed
1144
@node FAQ 4-15
Glenn Morris's avatar
Glenn Morris committed
1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164
@subsubheading Question 4.15

How to split incoming mails in several groups?

@subsubheading Answer

Gnus offers two possibilities for splitting mail, the easy
nnmail-split-methods and the more powerful Fancy Mail
Splitting. I'll only talk about the first one, refer to
the manual, node "Fancy Mail Splitting" for the latter.

The value of nnmail-split-methods is a list, each element
is a list which stands for a splitting rule. Each rule has
the form "group where matching articles should go to",
"regular expression which has to be matched", the first
rule which matches wins. The last rule must always be a
general rule (regular expression .*) which denotes where
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
Paul Eggert's avatar
Paul Eggert committed
1165
send to all groups whose rules match. If you
Glenn Morris's avatar
Glenn Morris committed
1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205
don't want that (you probably don't want), say

@example
(setq nnmail-crosspost nil)
@end example
@noindent

in ~/.gnus.el.

An example might be better than thousand words, so here's
my nnmail-split-methods. Note that I send duplicates in a
special group and that the default group is spam, since I
filter all mails out which are from some list I'm
subscribed to or which are addressed directly to me
before. Those rules kill about 80% of the Spam which
reaches me (Email addresses are changed to prevent spammers
from using them):

@example
(setq nnmail-split-methods
  '(("duplicates" "^Gnus-Warning:.*duplicate")
    ("XEmacs-NT" "^\\(To:\\|CC:\\).*localpart@@xemacs.invalid.*")
    ("Gnus-Tut" "^\\(To:\\|CC:\\).*localpart@@socha.invalid.*")
    ("tcsh" "^\\(To:\\|CC:\\).*localpart@@mx.gw.invalid.*")
    ("BAfH" "^\\(To:\\|CC:\\).*localpart@@.*uni-muenchen.invalid.*")
    ("Hamster-src" "^\\(CC:\\|To:\\).*hamster-sourcen@@yahoogroups.\\(de\\|com\\).*")
    ("Tagesschau" "^From: tagesschau <localpart@@www.tagesschau.invalid>$")
    ("Replies" "^\\(CC:\\|To:\\).*localpart@@Frank-Schmitt.invalid.*")
    ("EK" "^From:.*\\(localpart@@privateprovider.invalid\\|localpart@@workplace.invalid\\).*")
    ("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" "^Delivered-To: GMX delivery to spamtrap@@gmx.invalid$")
    ("Spam" "^Received: from link2buy.com")
    ("Spam" "^CC: .*azzrael@@t-online.invalid")
    ("Spam" "^X-Mailer-Version: 1.50 BETA")
    ("Uni" "^\\(CC:\\|To:\\).*localpart@@uni-koblenz.invalid.*")
Paul Eggert's avatar
Paul Eggert committed
1206
    ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.invalid\\|address@@two.invalid\\)")
Glenn Morris's avatar
Glenn Morris committed
1207 1208 1209 1210 1211 1212 1213 1214
    ("Spam" "")))
@end example
@noindent

@node FAQ 5 - Composing messages
@subsection Composing messages

@menu
Miles Bader's avatar
Miles Bader committed
1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241
* 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?
Glenn Morris's avatar
Glenn Morris committed
1242 1243
@end menu

Miles Bader's avatar
Miles Bader committed
1244
@node FAQ 5-1
Glenn Morris's avatar
Glenn Morris committed
1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273
@subsubheading Question 5.1

What are the basic commands I need to know for sending mail and postings?

@subsubheading Answer

To start composing a new mail hit @samp{m}
either in Group or Summary buffer, for a posting, it's
either @samp{a} in Group buffer and
filling the Newsgroups header manually
or @samp{a} in the Summary buffer of the
group where the posting shall be send to. Replying by mail
is
@samp{r} if you don't want to cite the
author, or import the cited text manually and
@samp{R} to cite the text of the original
message. For a follow up to a newsgroup, it's
@samp{f} and @samp{F}
(analogously to @samp{r} and
@samp{R}).

Enter new headers above the line saying "--text follows
this line--", enter the text below the line. When ready
hit @samp{C-c C-c}, to send the message,
if you want to finish it later hit @samp{C-c
C-d} to save it in the drafts group, where you
can start editing it again by saying @samp{D
e}.

Miles Bader's avatar
Miles Bader committed
1274
@node FAQ 5-2
Glenn Morris's avatar
Glenn Morris committed
1275 1276 1277 1278 1279 1280
@subsubheading Question 5.2

How to enable automatic word-wrap when composing messages?

@subsubheading Answer

1281 1282 1283 1284
Starting from No Gnus, automatic word-wrap is already enabled by
default, see the variable message-fill-column.

For other versions of Gnus, say
Glenn Morris's avatar
Glenn Morris committed
1285 1286

@example
1287 1288 1289 1290 1291
(unless (boundp 'message-fill-column)
  (add-hook 'message-mode-hook
            (lambda ()
              (setq fill-column 72)
              (turn-on-auto-fill))))
Glenn Morris's avatar
Glenn Morris committed
1292 1293 1294
@end example
@noindent

1295 1296
in ~/.gnus.el.

Miles Bader's avatar
Miles Bader committed
1297 1298
You can reformat a paragraph by hitting @samp{M-q}
(as usual).
Glenn Morris's avatar
Glenn Morris committed
1299

Miles Bader's avatar
Miles Bader committed
1300
@node FAQ 5-3
Glenn Morris's avatar
Glenn Morris committed
1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333
@subsubheading Question 5.3

How to set stuff like From, Organization, Reply-To, signature...?

@subsubheading Answer

There are other ways, but you should use posting styles
for this. (See below why).
This example should make the syntax clear:

@example
(setq gnus-posting-styles
  '((".*"
     (name "Frank Schmitt")
     (address "me@@there.invalid")
     (organization "Hamme net, kren mer och nimmi")
     (signature-file "~/.signature")
     ("X-SampleHeader" "foobar")
     (eval (setq some-variable "Foo bar")))))
@end example
@noindent

The ".*" means that this settings are the default ones
(see below), valid values for the first element of the
following lists are signature, signature-file,
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
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.

Miles Bader's avatar
Miles Bader committed
1334
@node FAQ 5-4
Glenn Morris's avatar
Glenn Morris committed
1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384
@subsubheading Question 5.4

Can I set things like From, Signature etc group based on the group I post too?

@subsubheading Answer

That's the strength of posting styles. Before, we used ".*"
to set the default for all groups. You can use a regexp
like "^gmane" and the following settings are only applied
to postings you send to the gmane hierarchy, use
".*binaries" instead and they will be applied to postings
send to groups containing the string binaries in their
name etc.

You can instead of specifying a regexp specify a function
which is evaluated, only if it returns true, the
corresponding settings take effect. Two interesting
candidates for this are message-news-p which returns t if
the current Group is a newsgroup and the corresponding
message-mail-p.

Note that all forms that match are applied, that means in
the example below, when I post to
gmane.mail.spam.spamassassin.general, the settings under
".*" are applied and the settings under message-news-p and
those under "^gmane" and those under
"^gmane\\.mail\\.spam\\.spamassassin\\.general$". Because
of this put general settings at the top and specific ones
at the bottom.

@example
(setq gnus-posting-styles
      '((".*" ;;default
         (name "Frank Schmitt")
         (organization "Hamme net, kren mer och nimmi")
         (signature-file "~/.signature"))
        ((message-news-p) ;;Usenet news?
         (address "mySpamTrap@@Frank-Schmitt.invalid")
         (reply-to "hereRealRepliesOnlyPlease@@Frank-Schmitt.invalid"))
        ((message-mail-p) ;;mail?
         (address "usedForMails@@Frank-Schmitt.invalid"))
        ("^gmane" ;;this is mail, too in fact
         (address "usedForMails@@Frank-Schmitt.invalid")
         (reply-to nil))
        ("^gmane\\.mail\\.spam\\.spamassassin\\.general$"
         (eval (set (make-local-variable 'message-sendmail-envelope-from)
                    "Azzrael@@rz-online.de")))))
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1385
@node FAQ 5-5
Glenn Morris's avatar
Glenn Morris committed
1386 1387 1388 1389 1390 1391 1392 1393 1394 1395
@subsubheading Question 5.5

Is there a spell-checker? Perhaps even on-the-fly spell-checking?

@subsubheading 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}
Paul Eggert's avatar
Paul Eggert committed
1396
installed and in your Path. Then you need
Glenn Morris's avatar
Glenn Morris committed
1397
@uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el}
Paul Eggert's avatar
Paul Eggert committed
1398
and for on-the-fly spell-checking
1399
@uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}.
Paul Eggert's avatar
Paul Eggert committed
1400 1401 1402
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
Glenn Morris's avatar
Glenn Morris committed
1403 1404 1405 1406 1407 1408 1409 1410
manually.

Ispell.el assumes you use ispell, if you choose aspell say

@example
(setq ispell-program-name "aspell")
@end example
@noindent
Paul Eggert's avatar
Paul Eggert committed
1411

Glenn Morris's avatar
Glenn Morris committed
1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427
in your Emacs configuration file.

If you want your outgoing messages to be spell-checked, say

@example
(add-hook 'message-send-hook 'ispell-message)
@end example
@noindent

In your ~/.gnus.el, if you prefer on-the-fly spell-checking say

@example
(add-hook 'message-mode-hook (lambda () (flyspell-mode 1)))
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1428
@node FAQ 5-6
Glenn Morris's avatar
Glenn Morris committed
1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447
@subsubheading Question 5.6

Can I set the dictionary based on the group I'm posting to?

@subsubheading Answer

Yes, say something like

@example
(add-hook 'gnus-select-group-hook
          (lambda ()
            (cond
             ((string-match
               "^de\\." (gnus-group-real-name gnus-newsgroup-name))
              (ispell-change-dictionary "deutsch8"))
             (t
              (ispell-change-dictionary "english")))))
@end example
@noindent
Paul Eggert's avatar
Paul Eggert committed
1448

Glenn Morris's avatar
Glenn Morris committed
1449 1450 1451
in ~/.gnus.el. Change "^de\\." and "deutsch8" to something
that suits your needs.

Miles Bader's avatar
Miles Bader committed
1452
@node FAQ 5-7
Glenn Morris's avatar
Glenn Morris committed
1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464
@subsubheading Question 5.7

Is there some kind of address-book, so I needn't remember
all those email addresses?

@subsubheading Answer

There's an very basic solution for this, mail aliases.
You can store your mail addresses in a ~/.mailrc file using a simple
alias syntax:

@example
Glenn Morris's avatar
Glenn Morris committed
1465
alias al        "Al <al@@english-heritage.invalid>"
Glenn Morris's avatar
Glenn Morris committed
1466 1467 1468 1469 1470 1471 1472 1473 1474
@end example
@noindent

Then typing your alias (followed by a space or punctuation
character) on a To: or Cc: line in the message buffer will
cause Gnus to insert the full address for you. See the
node "Mail Aliases" in Message (not Gnus) manual for
details.

Paul Eggert's avatar
Paul Eggert committed
1475
However, what you really want is the Insidious Big Brother
Glenn Morris's avatar
Glenn Morris committed
1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490
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:

@example
(require 'bbdb)
(bbdb-initialize 'gnus 'message)
@end example
@noindent

Now you probably want some general bbdb configuration,
place them in ~/.emacs:

@example
(require 'bbdb)
Paul Eggert's avatar
Paul Eggert committed
1491
;;If you don't live in Northern America, you should disable the
Glenn Morris's avatar
Glenn Morris committed
1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515
;;syntax check for telephone numbers by saying
(setq bbdb-north-american-phone-numbers-p nil)
;;Tell bbdb about your email address:
(setq bbdb-user-mail-names
      (regexp-opt '("Your.Email@@here.invalid"
                    "Your.other@@mail.there.invalid")))
;;cycling while completing email addresses
(setq bbdb-complete-name-allow-cycling t)
;;No popup-buffers
(setq bbdb-use-pop-up nil)
@end example
@noindent

Now you should be ready to go. Say @samp{M-x bbdb RET
RET} to open a bbdb buffer showing all
entries. Say @samp{c} to create a new
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
you are done. When you now compose a new mail,
hit @samp{TAB} to cycle through know
recipients.

Miles Bader's avatar
Miles Bader committed
1516
@node FAQ 5-8
Glenn Morris's avatar
Glenn Morris committed
1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531
@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
postings, too?

@subsubheading Answer

Those images are called X-Faces. They are 48*48 pixel b/w
pictures, encoded in a header line. If you want to include
one in your posts, you've got to convert some image to a
X-Face. So fire up some image manipulation program (say
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
Paul Eggert's avatar
Paul Eggert committed
1532
package from
Glenn Morris's avatar
Glenn Morris committed
1533 1534 1535 1536 1537 1538 1539 1540 1541
@uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}.
and create the actual X-face by saying

@example
cat file.xbm | xbm2ikon | compface > file.face
cat file.face | sed 's/\\/\\\\/g;s/\"/\\\"/g;' > file.face.quoted
@end example
@noindent

Paul Eggert's avatar
Paul Eggert committed
1542
If you can't use compface, there's an online X-face converter at
Glenn Morris's avatar
Glenn Morris committed
1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565
@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

@example
(setq message-default-headers
        (with-temp-buffer
          (insert "X-Face: ")
          (insert-file-contents "~/.xface")
          (buffer-string)))
@end example
@noindent

in ~/.gnus.el.  If you use Gnus 5.10, you can simply add an entry

@example
(x-face-file "~/.xface")
@end example
@noindent

to gnus-posting-styles.

Miles Bader's avatar
Miles Bader committed
1566
@node FAQ 5-9
Glenn Morris's avatar
Glenn Morris committed
1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596
@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
newsgroups?

@subsubheading Answer

Put this in ~/.gnus.el:

@example
(setq gnus-confirm-mail-reply-to-news t)
@end example
@noindent

if you already use Gnus 5.10, if you still use 5.8.8 or
5.9 try this instead:

@example
(eval-after-load "gnus-msg"
  '(unless (boundp 'gnus-confirm-mail-reply-to-news)
     (defadvice gnus-summary-reply (around reply-in-news activate)
       "Request confirmation when replying to news."
       (interactive)
       (when (or (not (gnus-news-group-p gnus-newsgroup-name))
                 (y-or-n-p "Really reply by mail to article author? "))
         ad-do-it))))
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1597
@node FAQ 5-10
Glenn Morris's avatar
Glenn Morris committed
1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612
@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:

@example
(eval-after-load "message"
      '(add-to-list 'message-syntax-checks '(sender . disabled)))
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1613
@node FAQ 5-11
Glenn Morris's avatar
Glenn Morris committed
1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628
@subsubheading Question 5.11

I want Gnus to locally store copies of my send mail and
news, how to do it?

@subsubheading Answer

You must set the variable gnus-message-archive-group to do
this. You can set it to a string giving the name of the
group where the copies shall go or like in the example
below use a function which is evaluated and which returns
the group to use.

@example
(setq gnus-message-archive-group
Glenn Morris's avatar
Glenn Morris committed
1629 1630 1631
        '((if (message-news-p)
              "nnml:Send-News"
            "nnml:Send-Mail")))
Glenn Morris's avatar
Glenn Morris committed
1632 1633 1634
@end example
@noindent

Miles Bader's avatar
Miles Bader committed
1635
@node FAQ 5-12
Glenn Morris's avatar
Glenn Morris committed
1636 1637
@subsubheading Question 5.12

Miles Bader's avatar
Miles Bader committed
1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652
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

Glenn Morris's avatar
Glenn Morris committed
1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670
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
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
at most private machines) you can tell Gnus what to use
by saying:

@example
(setq message-user-fqdn "yourmachine.yourdomain.tld")
@end example
@noindent

in ~/.gnus.el.  If you use Gnus 5.9 or earlier, you can use this
Paul Eggert's avatar
Paul Eggert committed
1671
instead (works for newer versions as well):
Glenn Morris's avatar
Glenn Morris committed
1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691

@example
(eval-after-load "message"
  '(let ((fqdn "yourmachine.yourdomain.tld"));; <-- Edit this!
     (if (boundp 'message-user-fqdn)
         (setq message-user-fqdn fqdn)
       (gnus-message 1 "Redefining `message-make-fqdn'.")
       (defun message-make-fqdn ()
         "Return user's fully qualified domain name."
         fqdn))))
@end example
@noindent

If you have no idea what to insert for
"yourmachine.yourdomain.tld", you've got several
choices. You can either ask your provider if he allows
you to use something like
yourUserName.userfqdn.provider.net, or you can use
somethingUnique.yourdomain.tld if you own the domain
yourdomain.tld, or you can register at a service which
1692
gives private users a FQDN for free.
Glenn Morris's avatar
Glenn Morris committed
1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718

Finally you can tell Gnus not to generate a Message-ID
for News at all (and letting the server do the job) by saying

@example
(setq message-required-news-headers
  (remove' Message-ID message-required-news-headers))
@end example
@noindent

you can also tell Gnus not to generate Message-IDs for mail by saying

@example
(setq message-required-mail-headers
  (remove' Message-ID message-required-mail-headers))
@end example
@noindent

, however some mail servers don't generate proper
Message-IDs, too, so test if your Mail Server behaves
correctly by sending yourself a Mail and looking at the Message-ID.

@node FAQ 6 - Old messages
@subsection Old messages

@menu
Miles Bader's avatar
Miles Bader committed
1719 1720 1721 1722 1723 1724 1725 1726
* 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.
Glenn Morris's avatar
Glenn Morris committed
1727 1728
@end menu

Miles Bader's avatar
Miles Bader committed
1729
@node FAQ 6-1
Glenn Morris's avatar
Glenn Morris committed
1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755
@subsubheading Question 6.1

How to import my old mail into Gnus?

@subsubheading Answer

The easiest way is to tell your old mail program to
export the messages in mbox format. Most Unix mailers
are able to do this, if you come from the MS Windows
world, you may find tools at
@uref{http://mbx2mbox.sourceforge.net/}.

Now you've got to import this mbox file into Gnus. To do
this, create a nndoc group based on the mbox file by
saying @samp{G f /path/file.mbox RET} in
Group buffer. You now have read-only access to your
mail. If you want to import the messages to your normal
Gnus mail groups hierarchy, enter the nndoc group you've
just created by saying @samp{C-u RET}
(thus making sure all messages are retrieved), mark all
messages by saying @samp{M P b} and
either copy them to the desired group by saying
@samp{B c name.of.group RET} or send them
through nnmail-split-methods (respool them) by saying
@samp{B r}.

Miles Bader's avatar
Miles Bader committed
1756
@node FAQ 6-2
Glenn Morris's avatar
Glenn Morris committed
1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777