comparison man/gnus-faq.texi @ 57224:d61099b391d7

Revision: [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-571 Merge from gnus--rel--5.10 Patches applied: * [e-mail]--gnu-2004/gnus--rel--5.10--patch-31 - [e-mail]--gnu-2004/gnus--rel--5.10--patch-33 Update from CVS

57223:82faaf96bf77

@end ifnottex
@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?
@end menu

What is the latest version of Gnus?

Answer: 

 Jingle please: Gnus 5.10.0 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
 prefer to stay with 5.8.8 respectively 5.9 (they are
 basically the same) until some bugfix releases are out.

@ifnottex
@node [1.2], [1.3], [1.1], FAQ 1 - Installation
@end ifnottex
@subsubheading Question 1.2: 

What's new in 5.10.0?

Answer: 

 First of all, you should have a look into the file
 GNUS-NEWS in the toplevel directory of the Gnus tarball,

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.7 or XEmacs 21.1.
 
@ifnottex
@node [1.6],  , [1.5], FAQ 1 - Installation
@end ifnottex

 

@example

SET HOME=C:\myhome
	    
@end example

@noindent
 in your autoexec.bat and reboot. Under NT, 2000 and XP,
 hit Winkey+Pause/Break to enter system options (if it

 this in ~/.gnus:
 

@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
 
@ifnottex
@node [3.7], [3.8], [3.6], FAQ 3 - Getting messages
@end ifnottex

@example
(add-to-list 
 'gnus-secondary-select-methods
 '(nnimap "Give the baby a name"
	  (nnimap-address "imap.yourProvider.net")
	  (nnimap-port 143)
	  (nnimap-list-pattern "archive.*")))
@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

 in ~/.gnus to load enough old articles to prevent teared threads, replace 'some with t to load
 all articles (Warning: Both settings enlarge the amount of data which is 
 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 
 @samp{/o N} 
 In summary buffer to load the last N messages, this feature is not available in 5.8.8
 

 If you don't want all old messages, but the parent of the message you're just reading,

 Can I use some other browser than w3 to render my HTML-mails?
 

Answer: 

 Only if you use Gnus 5.10.0 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
 

 ) 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.0.
 
@ifnottex
@node [4.9], [4.10], [4.8], FAQ 4 - Reading messages
@end ifnottex
@subsubheading Question 4.9: 

 

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

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

 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.0, 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-confirm-mail-reply-to-news t)
@end example

@noindent
 if you already use Gnus 5.10.0, if you still use 5.8.8 or
 5.9 try this instead:
 

@example
(defadvice gnus-summary-reply (around reply-in-news activate)

 How to tell Gnus not to generate a sender header?
 

Answer: 

 Since 5.10.0 Gnus doesn't generate a sender header by
 default. For older Gnus' try this in ~/.gnus:
 

@example
(eval-after-load "message"

@example
(setq message-user-fqdn "yourmachine.yourdomain.tld")
@end example
@noindent
 in ~/.gnus.  If you use Gnus 5.9 or ealier, you can use this
instead:
@example
(eval-after-load "message"
  '(let (myfqdn "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."

 @uref{http://groups.google.com,groups.google.com},
 if you found the posting there, tell Google to display
 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
 groups.google.com which you can call with
 @samp{G W}) in group buffer.
 

 Another idea which works for both mail and news groups

 to search engines like swish-e or swish++ and
 others. You index your mail with one of those search
 engines and with the help of nnir you can search trough
 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/}.
 Instructions on how to use it are at the top of the file.
 
@ifnottex
@node [6.4], [6.5], [6.3], FAQ 6 - Old messages
@end ifnottex

 The Gnus agent is part of Gnus, it allows you to fetch
 mail and news and store them on disk for reading them
 later when you're offline. It kind of mimics offline
 newsreaders like e.g. Forte Agent. If you want to use
 the Agent place the following in ~/.gnus if you are
 still using 5.8.8 or 5.9 (it's the default since 5.10.0):
 

@example
(setq gnus-agent t)
@end example

(setq gc-cons-threshold 3500000)
@end example

@noindent
 in ~/.emacs. If you don't care about width of CJK
 characters or use Gnus 5.10.0 or younger together with a
 recent GNU Emacs, you should say
 

@example
(setq gnus-use-correct-string-widths nil) 

@noindent
 in ~/.gnus (thanks to Jesper harder for the last
 two suggestions). Finally if you are still using 5.8.8
 or 5.9 and experience speed problems with summary
 buffer generation, you definitely should update to
 5.10.0 since there quite some work on improving it has
 been done.
 
@ifnottex
@node [9.3],  , [9.2], FAQ 9 - Tuning Gnus
@end ifnottex

57224:d61099b391d7

@end ifnottex
@subsection Installation

@menu
* [1.1]::   What is the latest version of Gnus?
* [1.2]::   What's new in 5.10?
* [1.3]::   Where and how to get Gnus?
* [1.4]::   What to do with the tarball now? 
* [1.5]::   Which version of Emacs do I need?
* [1.6]::   How do I run Gnus on both Emacs and XEmacs?
@end menu

What is the latest version of Gnus?

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
 shouldn't miss, however if you are cautious, you might
 prefer to stay with 5.8.8 respectively 5.9 (they are
 basically the same) until some bugfix releases are out.

@ifnottex
@node [1.2], [1.3], [1.1], FAQ 1 - Installation
@end ifnottex
@subsubheading Question 1.2: 

What's new in 5.10?

Answer: 

 First of all, you should have a look into the file
 GNUS-NEWS in the toplevel directory of the Gnus tarball,

Which version of Emacs do I need?

Answer: 

 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
@end ifnottex

 

@example

SET HOME=C:\myhome
            
@end example

@noindent
 in your autoexec.bat and reboot. Under NT, 2000 and XP,
 hit Winkey+Pause/Break to enter system options (if it

 this in ~/.gnus:
 

@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
 
@ifnottex
@node [3.7], [3.8], [3.6], FAQ 3 - Getting messages
@end ifnottex

@example
(add-to-list 
 'gnus-secondary-select-methods
 '(nnimap "Give the baby a name"
          (nnimap-address "imap.yourProvider.net")
          (nnimap-port 143)
          (nnimap-list-pattern "archive.*")))
@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

 in ~/.gnus to load enough old articles to prevent teared threads, replace 'some with t to load
 all articles (Warning: Both settings enlarge the amount of data which is 
 fetched when you enter a group and slow down the process of entering a group).
 

 If you already use Gnus 5.10, you can say 
 @samp{/o N} 
 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,

 Can I use some other browser than w3 to render my HTML-mails?
 

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
 

 ) 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.
 
@ifnottex
@node [4.9], [4.10], [4.8], FAQ 4 - Reading messages
@end ifnottex
@subsubheading Question 4.9: 

 

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

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

 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-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
(defadvice gnus-summary-reply (around reply-in-news activate)

 How to tell Gnus not to generate a sender header?
 

Answer: 

 Since 5.10 Gnus doesn't generate a sender header by
 default. For older Gnus' try this in ~/.gnus:
 

@example
(eval-after-load "message"

@example
(setq message-user-fqdn "yourmachine.yourdomain.tld")
@end example
@noindent
 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."

 @uref{http://groups.google.com,groups.google.com},
 if you found the posting there, tell Google to display
 the raw message, look for the message-id, and say
 @samp{M-^ the@@message.id RET} in a
 summary buffer.
 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.
 

 Another idea which works for both mail and news groups

 to search engines like swish-e or swish++ and
 others. You index your mail with one of those search
 engines and with the help of nnir you can search trough
 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 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
@node [6.4], [6.5], [6.3], FAQ 6 - Old messages
@end ifnottex

 The Gnus agent is part of Gnus, it allows you to fetch
 mail and news and store them on disk for reading them
 later when you're offline. It kind of mimics offline
 newsreaders like e.g. Forte Agent. If you want to use
 the Agent place the following in ~/.gnus if you are
 still using 5.8.8 or 5.9 (it's the default since 5.10):
 

@example
(setq gnus-agent t)
@end example

(setq gc-cons-threshold 3500000)
@end example

@noindent
 in ~/.emacs. If you don't care about width of CJK
 characters or use Gnus 5.10 or younger together with a
 recent GNU Emacs, you should say
 

@example
(setq gnus-use-correct-string-widths nil) 

@noindent
 in ~/.gnus (thanks to Jesper harder for the last
 two suggestions). Finally if you are still using 5.8.8
 or 5.9 and experience speed problems with summary
 buffer generation, you definitely should update to
 5.10 since there quite some work on improving it has
 been done.
 
@ifnottex
@node [9.3],  , [9.2], FAQ 9 - Tuning Gnus
@end ifnottex