([4.1]): Typo.
[gnus] / texi / gnus-faq.texi
index 7b1ab40..42266aa 100644 (file)
@@ -1,6 +1,6 @@
 @c Insert  "\input texinfo" at 1st line before texing this file alone.
 @c -*-texinfo-*-
-@c Copyright (C) 1995, 2001, 2003 Free Software Foundation, Inc.
+@c Copyright (C) 1995, 2001, 2003, 2004, 2005 Free Software Foundation, Inc.
 @setfilename gnus-faq.info
 
 @c Frequently Asked Questions, FAQ - Introduction, Emacs for Heathens, Top
@@ -10,6 +10,8 @@
 
 @c @chapter Frequently Asked Questions
 @section Frequently Asked Questions
+@cindex FAQ
+@cindex Frequently Asked Questions
 
 @c - Uncomment @chapter, comment @section
 @c - run (texinfo-every-node-update)
 @menu
 * FAQ - Introduction::                    About Gnus and this FAQ.
 * FAQ 1 - Installation::                  Installation of Gnus.
-* FAQ 2 - Startup / Group buffer::        Start up questions and the first buffer Gnus shows you.
+* 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 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.
@@ -97,12 +101,12 @@ Gnus is a Usenet Newsreader and Electronic Mail User Agent implemented
 @subsection Installation
 
 @menu
-* [1.1]::                       What is the latest version of Gnus?
-* [1.2]::                       What's new in 5.10.0?
-* [1.3]::                       Where and how to get Gnus?
-* [1.4]::                       What to do with the tarball now? 
-* [1.5]::                       Which version of Emacs do I need?
-* [1.6]::                       How do I run Gnus on both Emacs and XEmacs?
+* [1.1]::   What is the latest version of Gnus?
+* [1.2]::   What's new in 5.10?
+* [1.3]::   Where and how to get Gnus?
+* [1.4]::   What to do with the tarball now? 
+* [1.5]::   Which version of Emacs do I need?
+* [1.6]::   How do I run Gnus on both Emacs and XEmacs?
 @end menu
 
 
@@ -115,7 +119,7 @@ What is the latest version of Gnus?
 
 Answer: 
 
- Jingle please: Gnus 5.10.0 is released, get it while it's
+ Jingle please: Gnus 5.10 is released, get it while it's
  hot! As well as the step in version number is rather
  small, Gnus 5.10 has tons of new features which you
  shouldn't miss, however if you are cautious, you might
@@ -127,7 +131,7 @@ Answer:
 @end ifnottex
 @subsubheading Question 1.2: 
 
-What's new in 5.10.0?
+What's new in 5.10?
 
 Answer: 
 
@@ -210,7 +214,7 @@ Answer:
 @end example
 
 @noindent
- Make sure that you don't have any gnus related stuff
+ 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, "/").
  
@@ -223,8 +227,8 @@ Which version of Emacs do I need?
 
 Answer: 
 
- Gnus 5.10.0 requires an Emacs version that is greater
- than or equal to Emacs 20.3 or XEmacs 20.1.
+ Gnus 5.10 requires an Emacs version that is greater
+ than or equal to Emacs 20.7 or XEmacs 21.1.
  
 @ifnottex
 @node [1.6],  , [1.5], FAQ 1 - Installation
@@ -246,11 +250,15 @@ Answer:
 @subsection Startup / Group buffer
 
 @menu
-* [2.1]::                       Every time I start Gnus I get a message "Gnus auto-save file exists. Do you want to read it?", what does this mean and how to prevent it? 
-* [2.2]::                       Gnus doesn't remember which groups I'm subscribed to, what's this? 
-* [2.3]::                       How to change the format of the lines in Group buffer? 
-* [2.4]::                       My group buffer becomes a bit crowded, is there a way to sort my groups into categories so I can easier browse through them? 
-* [2.5]::                       How to manually sort the groups in Group buffer? How to sort the groups in a topic? 
+* [2.1]::   Every time I start Gnus I get a message
+            "Gnus auto-save file exists. Do you want to read it?", 
+            what does this mean and how to prevent it? 
+* [2.2]::   Gnus doesn't remember which groups I'm subscribed to, what's this? 
+* [2.3]::   How to change the format of the lines in Group buffer? 
+* [2.4]::   My group buffer becomes a bit crowded, is there a way to sort my
+            groups into categories so I can easier browse through them?
+* [2.5]::   How to manually sort the groups in Group buffer? How to sort the
+            groups in a topic? 
 @end menu
 
 @ifnottex
@@ -362,17 +370,24 @@ Answer:
 @subsection Getting messages
 
 @menu
-* [3.1]::                       I just installed Gnus, started it via M-x gnus but it only says "nntp (news) open error", what to do? 
-* [3.2]::                       I'm working under Windows and have no idea what ~/.gnus means. 
-* [3.3]::                       My news server requires authentication, how to store user name and password on disk? 
-* [3.4]::                       Gnus seems to start up OK, but I can't find out how to subscribe to a group. 
-* [3.5]::                       Gnus doesn't show all groups / Gnus says I'm not allowed to post on this server as well as I am, what's that?
-* [3.6]::                       I want Gnus to fetch news from several servers, is this possible? 
-* [3.7]::                       And how about local spool files? 
-* [3.8]::                       OK, reading news works now, but I want to be able to read my mail with Gnus, too. How to do it? 
-* [3.9]::                       And what about IMAP? 
-* [3.10]::                      At the office we use one of those MS Exchange servers, can I use Gnus to read my mail from it? 
-* [3.11]::                      Can I tell Gnus not to delete the mails on the server it retrieves via POP3? 
+* [3.1]::   I just installed Gnus, started it via M-x gnus but it only says
+            "nntp (news) open error", what to do? 
+* [3.2]::   I'm working under Windows and have no idea what ~/.gnus means. 
+* [3.3]::   My news server requires authentication, how to store user name
+            and password on disk? 
+* [3.4]::   Gnus seems to start up OK, but I can't find out how to
+            subscribe to a group. 
+* [3.5]::   Gnus doesn't show all groups / Gnus says I'm not allowed to
+            post on this server as well as I am, what's that?
+* [3.6]::   I want Gnus to fetch news from several servers, is this possible? 
+* [3.7]::   And how about local spool files? 
+* [3.8]::   OK, reading news works now, but I want to be able to read my mail
+            with Gnus, too. How to do it? 
+* [3.9]::   And what about IMAP? 
+* [3.10]::  At the office we use one of those MS Exchange servers,
+            can I use Gnus to read my mail from it? 
+* [3.11]::  Can I tell Gnus not to delete the mails on the server
+            it retrieves via POP3? 
 @end menu
 
 @ifnottex
@@ -425,7 +440,7 @@ the line
 @example
 
 SET HOME=C:\myhome
-           
+            
 @end example
 
 @noindent
@@ -533,9 +548,9 @@ Answer:
 
 @example
 (add-to-list 'gnus-secondary-select-methods 
-            '(nntp "news.yourSecondProvider.net"))
+             '(nntp "news.yourSecondProvider.net"))
 (add-to-list 'gnus-secondary-select-methods 
-            '(nntp "news.yourThirdProvider.net"))          
+             '(nntp "news.yourThirdProvider.net"))          
 @end example
  
 @ifnottex
@@ -632,7 +647,7 @@ Answer:
 (eval-after-load "mail-source"
   '(add-to-list 'mail-sources '(pop :server "pop.YourProvider.net"
                                     :user "yourUserName"
-                                    :password "yourPassword"))
+                                    :password "yourPassword")))
 @end example
 
 @noindent
@@ -730,9 +745,9 @@ Answer:
 (add-to-list 
  'gnus-secondary-select-methods
  '(nnimap "Give the baby a name"
-         (nnimap-address "imap.yourProvider.net")
-         (nnimap-port 143)
-         (nnimap-list-pattern "archive.*")))
+          (nnimap-address "imap.yourProvider.net")
+          (nnimap-port 143)
+          (nnimap-list-pattern "archive.*")))
 @end example
 
 @noindent
@@ -802,21 +817,32 @@ Answer:
 @subsection Reading messages
 
 @menu
-* [4.1]::                       When I enter a group, all read messages are gone. How to view them again? 
-* [4.2]::                       How to tell Gnus to show an important message every time I enter a group, even when it's read? 
-* [4.3]::                       How to view the headers of a message? 
-* [4.4]::                       How to view the raw unformatted message? 
-* [4.5]::                       How can I change the headers Gnus displays by default at the top of the article buffer? 
-* [4.6]::                       I'd like Gnus NOT to render HTML-mails but show me the text part if it's available. How to do it? 
-* [4.7]::                       Can I use some other browser than w3 to render my HTML-mails? 
-* [4.8]::                       Is there anything I can do to make poorly formatted mails more readable? 
-* [4.9]::                       Is there a way to automatically ignore posts by specific authors or with specific words in the subject? And can I highlight more interesting ones in some way? 
-* [4.10]::                      How can I disable threading in some (e.g. mail-) groups, or set other variables specific for some groups? 
-* [4.11]::                      Can I highlight messages written by me and follow-ups to those? 
-* [4.12]::                      The number of total messages in a group which Gnus displays in group buffer is by far to high, especially in mail groups. Is this a bug? 
-* [4.13]::                      I don't like the layout of summary and article buffer, how to change it? Perhaps even a three pane display? 
-* [4.14]::                      I don't like the way the Summary buffer looks, how to tweak it? 
-* [4.15]::                      How to split incoming mails in several groups? 
+* [4.1]::   When I enter a group, all read messages are gone.
+            How to view them again? 
+* [4.2]::   How to tell Gnus to show an important message every time
+            I enter a group, even when it's read? 
+* [4.3]::   How to view the headers of a message? 
+* [4.4]::   How to view the raw unformatted message? 
+* [4.5]::   How can I change the headers Gnus displays by default at the
+            top of the article buffer? 
+* [4.6]::   I'd like Gnus NOT to render HTML-mails but show me the
+            text part if it's available. How to do it? 
+* [4.7]::   Can I use some other browser than w3 to render my HTML-mails? 
+* [4.8]::   Is there anything I can do to make poorly formatted mails
+            more readable? 
+* [4.9]::   Is there a way to automatically ignore posts by specific authors
+            or with specific words in the subject? And can I highlight more
+            interesting ones in some way? 
+* [4.10]::  How can I disable threading in some (e.g. mail-) groups, or set
+            other variables specific for some groups? 
+* [4.11]::  Can I highlight messages written by me and follow-ups to those? 
+* [4.12]::  The number of total messages in a group which Gnus displays in
+            group buffer is by far to high, especially in mail groups.
+            Is this a bug? 
+* [4.13]::  I don't like the layout of summary and article buffer,
+            how to change it?  Perhaps even a three pane display? 
+* [4.14]::  I don't like the way the Summary buffer looks, how to tweak it? 
+* [4.15]::  How to split incoming mails in several groups? 
 @end menu
 
 @ifnottex
@@ -831,7 +857,7 @@ Answer:
 
  If you enter the group by saying 
  @samp{RET}
- in summary buffer with point over the group, only unread and ticked messages are loaded. Say
+ 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}
@@ -851,7 +877,7 @@ Answer:
  fetched when you enter a group and slow down the process of entering a group).
  
 
- If you already use Gnus 5.10.0, you can say 
+ If you already use Gnus 5.10, you can say 
  @samp{/o N} 
  In summary buffer to load the last N messages, this feature is not available in 5.8.8
  
@@ -974,7 +1000,7 @@ Answer:
 
 Answer: 
 
- Only if you use Gnus 5.10.0 or younger. In this case you've got the
+ 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
@@ -1007,7 +1033,7 @@ Answer:
  @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.0.
+ Outlook deuglify is only available since Gnus 5.10.
  
 @ifnottex
 @node [4.9], [4.10], [4.8], FAQ 4 - Reading messages
@@ -1178,8 +1204,8 @@ Answer:
 @example
 (gnus-add-configuration 
  '(article (vertical 1.0
-                    (summary .35 point)
-                    (article 1.0))))
+                     (summary .35 point)
+                     (article 1.0))))
 @end example
  
 
@@ -1226,7 +1252,7 @@ Answer:
  sadly hard tabulators are broken in 5.8.8.
  
 
- Since 5.10.0, Gnus offers you some very nice new specifiers,
+ 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:
@@ -1344,18 +1370,25 @@ Answer:
 @subsection Composing messages
 
 @menu
-* [5.1]::                       What are the basic commands I need to know for sending mail and postings? 
-* [5.2]::                       How to enable automatic word-wrap when composing messages? 
-* [5.3]::                       How to set stuff like From, Organization, Reply-To, signature...? 
-* [5.4]::                       Can I set things like From, Signature etc group based on the group I post too? 
-* [5.5]::                       Is there a spell-checker? Perhaps even on-the-fly spell-checking? 
-* [5.6]::                       Can I set the dictionary based on the group I'm posting to? 
-* [5.7]::                       Is there some kind of address-book, so I needn't remember all those email addresses? 
-* [5.8]::                       Sometimes I see little images at the top of article buffer. What's that and how can I send one with my postings, too? 
-* [5.9]::                       Sometimes I accidentally hit r instead of f in newsgroups. Can Gnus warn me, when I'm replying by mail in newsgroups? 
-* [5.10]::                      How to tell Gnus not to generate a sender header? 
-* [5.11]::                      I want gnus to locally store copies of my send mail and news, how to do it? 
-* [5.12]::                      People tell me my Message-IDs are not correct, why aren't they and how to fix it? 
+* [5.1]::   What are the basic commands I need to know for sending mail and
+            postings? 
+* [5.2]::   How to enable automatic word-wrap when composing messages? 
+* [5.3]::   How to set stuff like From, Organization, Reply-To, signature...? 
+* [5.4]::   Can I set things like From, Signature etc group based on the
+            group I post too? 
+* [5.5]::   Is there a spell-checker? Perhaps even on-the-fly spell-checking? 
+* [5.6]::   Can I set the dictionary based on the group I'm posting to? 
+* [5.7]::   Is there some kind of address-book, so I needn't remember all
+            those email addresses? 
+* [5.8]::   Sometimes I see little images at the top of article buffer.
+            What's that and how can I send one with my postings, too? 
+* [5.9]::   Sometimes I accidentally hit r instead of f in newsgroups.
+            Can Gnus warn me, when I'm replying by mail in newsgroups? 
+* [5.10]::  How to tell Gnus not to generate a sender header? 
+* [5.11]::  I want Gnus to locally store copies of my send mail and news,
+            how to do it? 
+* [5.12]::  People tell me my Message-IDs are not correct,
+            why aren't they and how to fix it? 
 @end menu
 
 @ifnottex
@@ -1381,7 +1414,7 @@ Answer:
  message. For a follow up to a newsgroup, it's
  @samp{f} and @samp{F}
  (analog to @samp{r} and
- @samp{R}.
+ @samp{R}).
  
 
  Enter new headers above the line saying "--text follows
@@ -1621,7 +1654,7 @@ alias al  "Al <al@@english-heritage.bla>"
 @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
+ cause Gnus to insert the full address for you. See the
  node "Mail Aliases" in Message (not Gnus) manual for
  details.
  
@@ -1738,16 +1771,19 @@ Answer:
 @end example
 
 @noindent
- if you already use Gnus 5.10.0, if you still use 5.8.8 or
+ if you already use Gnus 5.10, if you still use 5.8.8 or
  5.9 try this instead:
  
 
 @example
-(defadvice gnus-summary-reply (around reply-in-news activate)
+(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? "))
-         ad-do-it))
+       (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
  
 @ifnottex
@@ -1760,7 +1796,7 @@ Answer:
 
 Answer: 
 
- Since 5.10.0 Gnus doesn't generate a sender header by
+ Since 5.10 Gnus doesn't generate a sender header by
  default. For older Gnus' try this in ~/.gnus:
  
 
@@ -1812,17 +1848,25 @@ Answer:
  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:
-
+ by saying
 @example
-(defun message-make-message-id()
-   (concat "<"(message-unique-id)"@@yourmachine.yourdomain.tld>"))
+(setq message-user-fqdn "yourmachine.yourdomain.tld")
 @end example
-
 @noindent
- in ~/.gnus. If you have no idea what to insert for
+ in ~/.gnus.  If you use Gnus 5.9 or ealier, you can use this
+instead (works for newer versions a well):
+@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
+
+ 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
@@ -1865,12 +1909,14 @@ Answer:
 @subsection Old messages
 
 @menu
-* [6.1]::                       How to import my old mail into Gnus? 
-* [6.2]::                       How to archive interesting messages? 
-* [6.3]::                       How to search for a specific message? 
-* [6.4]::                       How to get rid of old unwanted mail? 
-* [6.5]::                       I want that all read messages are expired (at least in some groups). How to do it? 
-* [6.6]::                       I don't want expiration to delete my mails but to move them to another group. 
+* [6.1]::   How to import my old mail into Gnus? 
+* [6.2]::   How to archive interesting messages? 
+* [6.3]::   How to search for a specific message? 
+* [6.4]::   How to get rid of old unwanted mail? 
+* [6.5]::   I want that all read messages are expired (at least in some
+            groups). How to do it? 
+* [6.6]::   I don't want expiration to delete my mails but to move them
+            to another group. 
 @end menu
 
 @ifnottex
@@ -1978,7 +2024,7 @@ Answer:
  the raw message, look for the message-id, and say
  @samp{M-^ the@@message.id RET} in a
  summary buffer.
- Since Gnus 5.10.0 there's also a Gnus interface for
+ Since Gnus 5.10 there's also a Gnus interface for
  groups.google.com which you can call with
  @samp{G W}) in group buffer.
  
@@ -2003,9 +2049,9 @@ Answer:
  engines and with the help of nnir you can search trough
  the indexed mail and generate a temporary group with all
  messages which met your search criteria. If this sound
- cool to you get nnir.el from
- @uref{ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/}
- or @uref{ftp://ftp.is.informatik.uni-duisburg.de/pub/src/emacs/}.
+ cool to you get nnir.el from the contrib directory of the Gnus
+ distribution or
+ @uref{http://quimby.gnus.org/cgi-bin/cvsweb.cgi/~checkout~/gnus/contrib/nnir.el?rev=HEAD&content-type=text/plain}
  Instructions on how to use it are at the top of the file.
  
 @ifnottex
@@ -2110,10 +2156,12 @@ Answer:
 @subsection Gnus in a dial-up environment
 
 @menu
-* [7.1]::                       I don't have a permanent connection to the net, how can I minimize the time I've got to be connected? 
-* [7.2]::                       So what was this thing about the Agent? 
-* [7.3]::                       I want to store article bodies on disk, too. How to do it? 
-* [7.4]::                       How to tell Gnus not to try to send mails / postings while I'm offline? 
+* [7.1]::   I don't have a permanent connection to the net, how can I
+            minimize the time I've got to be connected? 
+* [7.2]::   So what was this thing about the Agent? 
+* [7.3]::   I want to store article bodies on disk, too. How to do it? 
+* [7.4]::   How to tell Gnus not to try to send mails / postings while
+            I'm offline? 
 @end menu
 
 
@@ -2186,7 +2234,7 @@ Answer:
  later when you're offline. It kind of mimics offline
  newsreaders like e.g. Forte Agent. If you want to use
  the Agent place the following in ~/.gnus if you are
- still using 5.8.8 or 5.9 (it's the default since 5.10.0):
+ still using 5.8.8 or 5.9 (it's the default since 5.10):
  
 
 @example
@@ -2273,12 +2321,13 @@ Answer:
 @subsection Getting help
 
 @menu
-* [8.1]::                       How to find information and help inside Emacs? 
-* [8.2]::                       I can't find anything in the Gnus manual about X (e.g. attachments, PGP, MIME...), is it not documented? 
-* [8.3]::                       Which websites should I know? 
-* [8.4]::                       Which mailing lists and newsgroups are there? 
-* [8.5]::                       Where to report bugs? 
-* [8.6]::                       I need real-time help, where to find it? 
+* [8.1]::   How to find information and help inside Emacs? 
+* [8.2]::   I can't find anything in the Gnus manual about X
+            (e.g. attachments, PGP, MIME...), is it not documented? 
+* [8.3]::   Which websites should I know? 
+* [8.4]::   Which mailing lists and newsgroups are there? 
+* [8.5]::   Where to report bugs? 
+* [8.6]::   I need real-time help, where to find it? 
 @end menu
 
 @ifnottex
@@ -2399,9 +2448,9 @@ Answer:
 @subsection Tuning Gnus
 
 @menu
-* [9.1]::                       Starting Gnus is really slow, how to speed it up? 
-* [9.2]::                       How to speed up the process of entering a group? 
-* [9.3]::                       Sending mail becomes slower and slower, what's up? 
+* [9.1]::   Starting Gnus is really slow, how to speed it up? 
+* [9.2]::   How to speed up the process of entering a group? 
+* [9.3]::   Sending mail becomes slower and slower, what's up? 
 @end menu
 
 @ifnottex
@@ -2478,7 +2527,7 @@ Answer:
 
 @noindent
  in ~/.emacs. If you don't care about width of CJK
- characters or use Gnus 5.10.0 or younger together with a
+ characters or use Gnus 5.10 or younger together with a
  recent GNU Emacs, you should say
  
 
@@ -2492,7 +2541,7 @@ Answer:
  two suggestions). Finally if you are still using 5.8.8
  or 5.9 and experience speed problems with summary
  buffer generation, you definitely should update to
- 5.10.0 since there quite some work on improving it has
+ 5.10 since there quite some work on improving it has
  been done.
  
 @ifnottex
@@ -2555,3 +2604,7 @@ Answer:
 @end table
 
 @c @bye
+
+@ignore
+   arch-tag: 64dc5692-edb4-4848-a965-7aa0181acbb8
+@end ignore