/[emacs]/emacs/man/gnus.texi
ViewVC logotype

Diff of /emacs/man/gnus.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.30 by eliz, Sat Mar 16 19:32:15 2002 UTC revision 1.30.2.1 by miles, Fri Apr 4 06:20:47 2003 UTC
# Line 568  Article Treatment Line 568  Article Treatment
568  * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.  * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.
569  * Article Date::            Grumble, UT!  * Article Date::            Grumble, UT!
570  * Article Signature::       What is a signature?  * Article Signature::       What is a signature?
571  * Article Miscellania::     Various other stuff.  * Article Miscellanea::     Various other stuff.
572    
573  Alternative Approaches  Alternative Approaches
574    
# Line 627  Getting News Line 627  Getting News
627    
628  Getting Mail  Getting Mail
629    
630  * Mail in a Newsreader::         Important introductory notes.    * Mail in a Newsreader::         Important introductory notes.
631  * Getting Started Reading Mail:: A simple cookbook example.  * Getting Started Reading Mail:: A simple cookbook example.
632  * Splitting Mail::               How to create mail groups.  * Splitting Mail::               How to create mail groups.
633  * Mail Sources::                 How to tell Gnus where to get mail from.  * Mail Sources::                 How to tell Gnus where to get mail from.
# Line 1188  Kill all new groups. Line 1188  Kill all new groups.
1188    
1189  @item gnus-subscribe-topics  @item gnus-subscribe-topics
1190  @vindex gnus-subscribe-topics  @vindex gnus-subscribe-topics
1191  Put the groups into the topic that has a matching @code{subscribe} topic  Put the groups into the topic that has a matching @code{subscribe} topic
1192  parameter (@pxref{Topic Parameters}).  For instance, a @code{subscribe}  parameter (@pxref{Topic Parameters}).  For instance, a @code{subscribe}
1193  topic parameter that looks like  topic parameter that looks like
1194    
# Line 1196  topic parameter that looks like Line 1196  topic parameter that looks like
1196  "nnslashdot"  "nnslashdot"
1197  @end example  @end example
1198    
1199  will mean that all groups that match that regex will be subscribed under  will mean that all groups that match that regex will be subscribed under
1200  that topic.  that topic.
1201    
1202  If no topics match the groups, the groups will be subscribed in the  If no topics match the groups, the groups will be subscribed in the
# Line 1486  performance, but if the server does not Line 1486  performance, but if the server does not
1486  @code{LIST ACTIVE group} command, this isn't very nice to the server.  @code{LIST ACTIVE group} command, this isn't very nice to the server.
1487    
1488  If you think that starting up Gnus takes too long, try all the three  If you think that starting up Gnus takes too long, try all the three
1489  different values for this variable and see what works best for you.  different values for this variable and see what works best for you.
1490    
1491  In any case, if you use @code{some} or @code{nil}, you should definitely  In any case, if you use @code{some} or @code{nil}, you should definitely
1492  kill all groups that you aren't interested in to speed things up.  kill all groups that you aren't interested in to speed things up.
# Line 2698  will make @code{iso-8859-1} and @code{x- Line 2698  will make @code{iso-8859-1} and @code{x-
2698  default charset will be used for decoding articles.  default charset will be used for decoding articles.
2699    
2700  See also @code{gnus-group-ignored-charsets-alist}.  See also @code{gnus-group-ignored-charsets-alist}.
2701    
2702  @item posting-style  @item posting-style
2703  You can store additional posting style information for this group only  You can store additional posting style information for this group only
2704  here (@pxref{Posting Styles}).  The format is that of an entry in the  here (@pxref{Posting Styles}).  The format is that of an entry in the
# Line 3278  convention (@pxref{Process/Prefix}). Line 3278  convention (@pxref{Process/Prefix}).
3278  @item T j  @item T j
3279  @kindex T j (Topic)  @kindex T j (Topic)
3280  @findex gnus-topic-jump-to-topic  @findex gnus-topic-jump-to-topic
3281  Go to a topic (@code{gnus-topic-jump-to-topic}).    Go to a topic (@code{gnus-topic-jump-to-topic}).
3282    
3283  @item T c  @item T c
3284  @kindex T c (Topic)  @kindex T c (Topic)
# Line 3523  parameters: Line 3523  parameters:
3523    
3524  @table @code  @table @code
3525  @item subscribe  @item subscribe
3526  When subscribing new groups by topic (@pxref{Subscription Methods}), the  When subscribing new groups by topic (@pxref{Subscription Methods}), the
3527  @code{subscribe} topic parameter says what groups go in what topic.  Its  @code{subscribe} topic parameter says what groups go in what topic.  Its
3528  value should be a regexp to match the groups that should go in that  value should be a regexp to match the groups that should go in that
3529  topic.  topic.
3530    
3531  @end table  @end table
3532    
# Line 3642  For example: Line 3642  For example:
3642    
3643  @item gnus-group-name-charset-group-alist  @item gnus-group-name-charset-group-alist
3644  @vindex gnus-group-name-charset-group-alist  @vindex gnus-group-name-charset-group-alist
3645  An alist of regexp of group name and the charset for group names.  An alist of regexp of group name and the charset for group names.
3646  It is used to show non-ASCII group names.  It is used to show non-ASCII group names.
3647    
3648  For example:  For example:
# Line 4498  If given a numerical prefix, you can do Line 4498  If given a numerical prefix, you can do
4498  encoded in the @code{cn-gb-2312} charset.  If you have  encoded in the @code{cn-gb-2312} charset.  If you have
4499    
4500  @lisp  @lisp
4501  (setq gnus-summary-show-article-charset-alist  (setq gnus-summary-show-article-charset-alist
4502        '((1 . cn-gb-2312)        '((1 . cn-gb-2312)
4503          (2 . big5)))          (2 . big5)))
4504  @end lisp  @end lisp
4505    
# Line 4731  the process/prefix convention. Line 4731  the process/prefix convention.
4731  @kindex S o p @r{(Summary)}  @kindex S o p @r{(Summary)}
4732  @findex gnus-summary-post-forward  @findex gnus-summary-post-forward
4733  Forward the current article to a newsgroup  Forward the current article to a newsgroup
4734  (@code{gnus-summary-post-forward}).    (@code{gnus-summary-post-forward}).
4735   If no prefix is given, the message is forwarded according to the value   If no prefix is given, the message is forwarded according to the value
4736  of (@code{message-forward-as-mime}) and  of (@code{message-forward-as-mime}) and
4737  (@code{message-forward-show-mml}); if the prefix is 1, decode the  (@code{message-forward-show-mml}); if the prefix is 1, decode the
# Line 6554  a spool, you could Line 6554  a spool, you could
6554    
6555  @lisp  @lisp
6556  (setq gnus-use-long-file-name '(not-save)) ; to get a hierarchy  (setq gnus-use-long-file-name '(not-save)) ; to get a hierarchy
6557  (setq gnus-default-article-saver  (setq gnus-default-article-saver
6558        'gnus-summary-save-in-file) ; no encoding        'gnus-summary-save-in-file) ; no encoding
6559  @end lisp  @end lisp
6560    
# Line 6988  these articles easier. Line 6988  these articles easier.
6988  * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.  * Article Buttons::         Click on URLs, Message-IDs, addresses and the like.
6989  * Article Date::            Grumble, UT!  * Article Date::            Grumble, UT!
6990  * Article Signature::       What is a signature?  * Article Signature::       What is a signature?
6991  * Article Miscellania::     Various other stuff.  * Article Miscellanea::     Various other stuff.
6992  @end menu  @end menu
6993    
6994    
# Line 7432  when filling. Line 7432  when filling.
7432    
7433  @item W Q  @item W Q
7434  @kindex W Q @r{(Summary)}  @kindex W Q @r{(Summary)}
7435  @findex gnus-article-fill-long-lines  @findex gnus-article-fill-long-lines
7436  Fill long lines (@code{gnus-article-fill-long-lines}).  Fill long lines (@code{gnus-article-fill-long-lines}).
7437    
7438  @item W C  @item W C
# Line 7480  makes strings look like @samp{~@{<:Ky2;S Line 7480  makes strings look like @samp{~@{<:Ky2;S
7480  @item W h  @item W h
7481  @kindex W h @r{(Summary)}  @kindex W h @r{(Summary)}
7482  @findex gnus-article-wash-html  @findex gnus-article-wash-html
7483  Treat HTML (@code{gnus-article-wash-html}).    Treat HTML (@code{gnus-article-wash-html}).
7484  Note that the this is usually done automatically by Gnus if the message  Note that the this is usually done automatically by Gnus if the message
7485  in question has a @code{Content-Type} header that says that this type  in question has a @code{Content-Type} header that says that this type
7486  has been done.  has been done.
# Line 7816  the regular expression @samp{^---*Forwar Line 7816  the regular expression @samp{^---*Forwar
7816  signature after all.  signature after all.
7817    
7818    
7819  @node Article Miscellania  @node Article Miscellanea
7820  @subsection Article Miscellania  @subsection Article Miscellanea
7821    
7822  @table @kbd  @table @kbd
7823  @item A t  @item A t
7824  @kindex A t @r{(Summary)}  @kindex A t @r{(Summary)}
7825  @findex gnus-article-babel  @findex gnus-article-babel
7826  Translate the article from one language to another  Translate the article from one language to another
7827  (@code{gnus-article-babel}).  (@code{gnus-article-babel}).
7828    
7829  @end table  @end table
7830    
# Line 8529  disk forever and ever, never to return a Line 8529  disk forever and ever, never to return a
8529  @vindex gnus-preserve-marks  @vindex gnus-preserve-marks
8530  Move the article from one mail group to another  Move the article from one mail group to another
8531  (@code{gnus-summary-move-article}).  Marks will be preserved if  (@code{gnus-summary-move-article}).  Marks will be preserved if
8532  @var{gnus-preserve-marks} is non-@code{nil} (which is the default).  @var{gnus-preserve-marks} is non-@code{nil} (which is the default).
8533    
8534  @item B c  @item B c
8535  @kindex B c @r{(Summary)}  @kindex B c @r{(Summary)}
# Line 9277  Copy the @sc{mime} object to a fresh buf Line 9277  Copy the @sc{mime} object to a fresh buf
9277  @findex gnus-mime-view-part-as-type  @findex gnus-mime-view-part-as-type
9278  @item t @r{(Article)}  @item t @r{(Article)}
9279  View the @sc{mime} object as if it were a different @sc{mime} media type  View the @sc{mime} object as if it were a different @sc{mime} media type
9280  (@code{gnus-mime-view-part-as-type}).  (@code{gnus-mime-view-part-as-type}).
9281    
9282  @findex gnus-mime-pipe-part  @findex gnus-mime-pipe-part
9283  @item | @r{(Article)}  @item | @r{(Article)}
# Line 9427  You can, of course, write your own funct Line 9427  You can, of course, write your own funct
9427  @code{gnus-part-display-hook}.  The functions are called narrowed to the  @code{gnus-part-display-hook}.  The functions are called narrowed to the
9428  part, and you can do anything you like, pretty much.  There is no  part, and you can do anything you like, pretty much.  There is no
9429  information that you have to keep in the buffer---you can change  information that you have to keep in the buffer---you can change
9430  everything.    everything.
9431    
9432    
9433  @node Article Keymap  @node Article Keymap
# Line 10486  server: Line 10486  server:
10486  @vindex nntp-server-opened-hook  @vindex nntp-server-opened-hook
10487  @cindex @sc{mode reader}  @cindex @sc{mode reader}
10488  @cindex authinfo  @cindex authinfo
10489  @cindex authentification  @cindex authentication
10490  @cindex nntp authentification  @cindex nntp authentication
10491  @findex nntp-send-authinfo  @findex nntp-send-authinfo
10492  @findex nntp-send-mode-reader  @findex nntp-send-mode-reader
10493  is run after a connection has been made.  It can be used to send  is run after a connection has been made.  It can be used to send
# Line 10514  manual page, but here are the salient fa Line 10514  manual page, but here are the salient fa
10514  The file contains one or more line, each of which define one server.  The file contains one or more line, each of which define one server.
10515    
10516  @item  @item
10517  Each line may contain an arbitrary number of token/value pairs.    Each line may contain an arbitrary number of token/value pairs.
10518    
10519  The valid tokens include @samp{machine}, @samp{login}, @samp{password},  The valid tokens include @samp{machine}, @samp{login}, @samp{password},
10520  @samp{default}.  In addition Gnus introduces two new tokens, not present  @samp{default}.  In addition Gnus introduces two new tokens, not present
# Line 10573  The default value is Line 10573  The default value is
10573    
10574  @lisp  @lisp
10575  '(("nntpd 1\\.5\\.11t"  '(("nntpd 1\\.5\\.11t"
10576     (remove-hook 'nntp-server-opened-hook     (remove-hook 'nntp-server-opened-hook
10577                  'nntp-send-mode-reader)))                  'nntp-send-mode-reader)))
10578  @end lisp  @end lisp
10579    
# Line 10706  This works for Solaris @code{telnet}, fo Line 10706  This works for Solaris @code{telnet}, fo
10706  @findex nntp-open-ssl-stream  @findex nntp-open-ssl-stream
10707  @item nntp-open-ssl-stream  @item nntp-open-ssl-stream
10708  Opens a connection to a server over a @dfn{secure} channel.  To use this  Opens a connection to a server over a @dfn{secure} channel.  To use this
10709  you must have SSLay installed  you must have SSLeay installed
10710  (@uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL}, and you also need  (@uref{ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL}, and you also need
10711  @file{ssl.el} (from the W3 distribution, for instance).  You then  @file{ssl.el} (from the W3 distribution, for instance).  You then
10712  define a server as follows:  define a server as follows:
# Line 10714  define a server as follows: Line 10714  define a server as follows:
10714  @lisp  @lisp
10715  ;; Type `C-c C-c' after you've finished editing.  ;; Type `C-c C-c' after you've finished editing.
10716  ;;  ;;
10717  ;; "snews" is port 563 and is predefined  ;; "snews" is port 563 and is predefined
10718  ;; in our /etc/services  ;; in our /etc/services
10719  ;;  ;;
10720  (nntp "snews.bar.com"  (nntp "snews.bar.com"
10721        (nntp-open-connection-function        (nntp-open-connection-function
10722          nntp-open-ssl-stream)          nntp-open-ssl-stream)
10723        (nntp-port-number "snews")        (nntp-port-number "snews")
10724        (nntp-address "snews.bar.com"))        (nntp-address "snews.bar.com"))
# Line 10840  Where the news lib dir is (@file{/usr/li Line 10840  Where the news lib dir is (@file{/usr/li
10840    
10841  @item nnspool-active-file  @item nnspool-active-file
10842  @vindex nnspool-active-file  @vindex nnspool-active-file
10843  The path to the active file.  The name of the active file.
10844    
10845  @item nnspool-newsgroups-file  @item nnspool-newsgroups-file
10846  @vindex nnspool-newsgroups-file  @vindex nnspool-newsgroups-file
10847  The path to the group descriptions file.  The name of the group descriptions file.
10848    
10849  @item nnspool-history-file  @item nnspool-history-file
10850  @vindex nnspool-history-file  @vindex nnspool-history-file
10851  The path to the news history file.  The name of the news history file.
10852    
10853  @item nnspool-active-times-file  @item nnspool-active-times-file
10854  @vindex nnspool-active-times-file  @vindex nnspool-active-times-file
10855  The path to the active date file.  The name of the active date file.
10856    
10857  @item nnspool-nov-is-evil  @item nnspool-nov-is-evil
10858  @vindex nnspool-nov-is-evil  @vindex nnspool-nov-is-evil
# Line 10878  Reading mail with a newsreader---isn't t Line 10878  Reading mail with a newsreader---isn't t
10878  course.  course.
10879    
10880  @menu  @menu
10881  * Mail in a Newsreader::         Important introductory notes.    * Mail in a Newsreader::         Important introductory notes.
10882  * Getting Started Reading Mail:: A simple cookbook example.  * Getting Started Reading Mail:: A simple cookbook example.
10883  * Splitting Mail::               How to create mail groups.  * Splitting Mail::               How to create mail groups.
10884  * Mail Sources::                 How to tell Gnus where to get mail from.  * Mail Sources::                 How to tell Gnus where to get mail from.
# Line 10897  course. Line 10897  course.
10897  @node Mail in a Newsreader  @node Mail in a Newsreader
10898  @subsection Mail in a Newsreader  @subsection Mail in a Newsreader
10899    
10900  If you are used to traditional mail readers, but have decided to switch  If you are used to traditional mail readers, but have decided to switch
10901  to reading mail with Gnus, you may find yourself experiencing something  to reading mail with Gnus, you may find yourself experiencing something
10902  of a culture shock.  of a culture shock.
10903    
10904  Gnus does not behave like traditional mail readers.  If you want to make  Gnus does not behave like traditional mail readers.  If you want to make
10905  it behave that way, you can, but it's an uphill battle.  it behave that way, you can, but it's an uphill battle.
10906    
10907  Gnus, by default, handles all its groups using the same approach.  This  Gnus, by default, handles all its groups using the same approach.  This
# Line 10915  Does this mean that all the messages tha Line 10915  Does this mean that all the messages tha
10915  deleted?  How awful!  deleted?  How awful!
10916    
10917  But, no, it means that old messages are @dfn{expired} according to some  But, no, it means that old messages are @dfn{expired} according to some
10918  scheme or other.  For news messages, the expire process is controlled by  scheme or other.  For news messages, the expire process is controlled by
10919  the news administrator; for mail, the expire process is controlled by  the news administrator; for mail, the expire process is controlled by
10920  you.  The expire process for mail is covered in depth in @pxref{Expiring  you.  The expire process for mail is covered in depth in @pxref{Expiring
10921  Mail}.  Mail}.
# Line 11071  If you wish to see where the previous ma Line 11071  If you wish to see where the previous ma
11071  can use the @kbd{M-x nnmail-split-history} command.  If you wish to see  can use the @kbd{M-x nnmail-split-history} command.  If you wish to see
11072  where re-spooling messages would put the messages, you can use  where re-spooling messages would put the messages, you can use
11073  @code{gnus-summary-respool-trace} and related commands (@pxref{Mail  @code{gnus-summary-respool-trace} and related commands (@pxref{Mail
11074  Group Commands}).  Group Commands}).
11075    
11076  Gnus gives you all the opportunity you could possibly want for shooting  Gnus gives you all the opportunity you could possibly want for shooting
11077  yourself in the foot.  Let's say you create a group that will contain  yourself in the foot.  Let's say you create a group that will contain
# Line 11130  Keywords: Line 11130  Keywords:
11130    
11131  @table @code  @table @code
11132  @item :path  @item :path
11133  The path of the file.  Defaults to the value of the @code{MAIL}  The file name.  Defaults to the value of the @code{MAIL}
11134  environment variable or @file{/usr/mail/spool/user-name}.  environment variable or @file{/usr/mail/spool/user-name}.
11135  @end table  @end table
11136    
# Line 11140  An example file mail source: Line 11140  An example file mail source:
11140  (file :path "/usr/spool/mail/user-name")  (file :path "/usr/spool/mail/user-name")
11141  @end lisp  @end lisp
11142    
11143  Or using the default path:  Or using the default file name:
11144    
11145  @lisp  @lisp
11146  (file)  (file)
11147  @end lisp  @end lisp
11148    
11149  If the mail spool file is not located on the local machine, it's best to  If the mail spool file is not located on the local machine, it's best to
11150  use POP or @sc{imap} or the like to fetch the mail.  You can not use ange-ftp  use POP or @sc{imap} or the like to fetch the mail.  You can not use ange-ftp
11151  file names here---it has no way to lock the mail spool while moving the  file names here---it has no way to lock the mail spool while moving the
11152  mail.  mail.
11153    
# Line 11183  Keywords: Line 11183  Keywords:
11183    
11184  @table @code  @table @code
11185  @item :path  @item :path
11186  The path of the directory where the files are.  There is no default  The name of the directory where the files are.  There is no default
11187  value.  value.
11188    
11189  @item :suffix  @item :suffix
# Line 11317  Keywords: Line 11317  Keywords:
11317    
11318  @table @code  @table @code
11319  @item :path  @item :path
11320  The path of the directory where the mails are stored.  The default is  The name of the directory where the mails are stored.  The default is
11321  taken from the @code{MAILDIR} environment variable or  taken from the @code{MAILDIR} environment variable or
11322  @samp{~/Maildir/}.  @samp{~/Maildir/}.
11323  @item :subdirs  @item :subdirs
# Line 11337  from locking problems). Line 11337  from locking problems).
11337  Two example maildir mail sources:  Two example maildir mail sources:
11338    
11339  @lisp  @lisp
11340  (maildir :path "/home/user-name/Maildir/"  (maildir :path "/home/user-name/Maildir/"
11341           :subdirs ("cur" "new"))           :subdirs ("cur" "new"))
11342  @end lisp  @end lisp
11343    
11344  @lisp  @lisp
11345  (maildir :path "/user@@remotehost.org:~/Maildir/"  (maildir :path "/user@@remotehost.org:~/Maildir/"
11346           :subdirs ("new"))           :subdirs ("new"))
11347  @end lisp  @end lisp
11348    
# Line 11435  after finishing the fetch. Line 11435  after finishing the fetch.
11435  An example @sc{imap} mail source:  An example @sc{imap} mail source:
11436    
11437  @lisp  @lisp
11438  (imap :server "mail.mycorp.com"  (imap :server "mail.mycorp.com"
11439        :stream kerberos4        :stream kerberos4
11440        :fetchflag "\\Seen")        :fetchflag "\\Seen")
11441  @end lisp  @end lisp
11442    
# Line 11476  folder after finishing the fetch. Line 11476  folder after finishing the fetch.
11476  An example webmail source:  An example webmail source:
11477    
11478  @lisp  @lisp
11479  (webmail :subtype 'hotmail  (webmail :subtype 'hotmail
11480           :user "user-name"           :user "user-name"
11481           :password "secret")           :password "secret")
11482  @end lisp  @end lisp
11483  @end table  @end table
# Line 11495  directory source to get mail, you can sp Line 11495  directory source to get mail, you can sp
11495    
11496  @lisp  @lisp
11497  (setq mail-sources  (setq mail-sources
11498        '((directory :path "/home/pavel/.Spool/"        '((directory :path "/home/pavel/.Spool/"
11499                     :suffix ""                     :suffix ""
11500                     :plugged t)))                     :plugged t)))
11501  @end lisp  @end lisp
# Line 11704  Let's look at an example value of this v Line 11704  Let's look at an example value of this v
11704        (any "procmail@@informatik\\.rwth-aachen\\.de" "procmail.list")        (any "procmail@@informatik\\.rwth-aachen\\.de" "procmail.list")
11705        (any "SmartList@@informatik\\.rwth-aachen\\.de" "SmartList.list")        (any "SmartList@@informatik\\.rwth-aachen\\.de" "SmartList.list")
11706        ;; Both lists below have the same suffix, so prevent        ;; Both lists below have the same suffix, so prevent
11707        ;; cross-posting to mkpkg.list of messages posted only to        ;; cross-posting to mkpkg.list of messages posted only to
11708        ;; the bugs- list, but allow cross-posting when the        ;; the bugs- list, but allow cross-posting when the
11709        ;; message was really cross-posted.        ;; message was really cross-posted.
11710        (any "bugs-mypackage@@somewhere" "mypkg.bugs")        (any "bugs-mypackage@@somewhere" "mypkg.bugs")
# Line 12003  Here's how: Line 12003  Here's how:
12003  Go to the group buffer.  Go to the group buffer.
12004    
12005  @item  @item
12006  Type @kbd{G f} and give the path to the mbox file when prompted to create an  Type @kbd{G f} and give the name of the mbox file when prompted to create an
12007  @code{nndoc} group from the mbox file (@pxref{Foreign Groups}).  @code{nndoc} group from the mbox file (@pxref{Foreign Groups}).
12008    
12009  @item  @item
# Line 12719  itself puts *all* one's mail in one file Line 12719  itself puts *all* one's mail in one file
12719  little bit of optimization to this so that each of one's mail groups has  little bit of optimization to this so that each of one's mail groups has
12720  a Unix mail box file.  It's faster than @code{nnmbox} because each group  a Unix mail box file.  It's faster than @code{nnmbox} because each group
12721  can be parsed separately, and still provides the simple Unix mail box  can be parsed separately, and still provides the simple Unix mail box
12722  format requiring minimal effort in moving the mail around.  In addition,  format requiring minimal effort in moving the mail around.  In addition,
12723  it maintains an ``active'' file making it much faster for Gnus to figure  it maintains an ``active'' file making it much faster for Gnus to figure
12724  out how many messages there are in each separate group.  out how many messages there are in each separate group.
12725    
12726  If you have groups that are expected to have a massive amount of  If you have groups that are expected to have a massive amount of
# Line 12746  and click, and there's the discussion. Line 12746  and click, and there's the discussion.
12746  go through a cumbersome subscription procedure, and most people don't  go through a cumbersome subscription procedure, and most people don't
12747  even know what a news group is.  even know what a news group is.
12748    
12749  The problem with this scenario is that web browsers are not very good at  The problem with this scenario is that web browsers are not very good at
12750  being newsreaders.  They do not keep track of what articles you've read;  being newsreaders.  They do not keep track of what articles you've read;
12751  they do not allow you to score on subjects you're interested in; they do  they do not allow you to score on subjects you're interested in; they do
12752  not allow off-line browsing; they require you to click around and drive  not allow off-line browsing; they require you to click around and drive
12753  you mad in the end.  you mad in the end.
12754    
12755  So---if web browsers suck at reading discussion forums, why not use Gnus  So---if web browsers suck at reading discussion forums, why not use Gnus
12756  to do it instead?  to do it instead?
12757    
12758  Gnus has been getting a bit of a collection of back ends for providing  Gnus has been getting a bit of a collection of back ends for providing
# Line 12769  interfaces to these sources. Line 12769  interfaces to these sources.
12769  All the web sources require Emacs/w3 and the url library to work.  All the web sources require Emacs/w3 and the url library to work.
12770    
12771  The main caveat with all these web sources is that they probably won't  The main caveat with all these web sources is that they probably won't
12772  work for a very long time.  Gleaning information from the @sc{html} data  work for a very long time.  Gleaning information from the @sc{html} data
12773  is guesswork at best, and when the layout is altered, the Gnus back end  is guesswork at best, and when the layout is altered, the Gnus back end
12774  will fail.  If you have reasonably new versions of these back ends,  will fail.  If you have reasonably new versions of these back ends,
12775  though, you should be ok.  though, you should be ok.
# Line 12971  quite regular and nice interface, and it Line 12971  quite regular and nice interface, and it
12971  information Gnus needs to keep groups updated.  information Gnus needs to keep groups updated.
12972    
12973  The easiest way to get started with @code{nnultimate} is to say  The easiest way to get started with @code{nnultimate} is to say
12974  something like the following in the group buffer:  @kbd{B nnultimate @key{RET}  something like the following in the group buffer:  @kbd{B nnultimate @key{RET}
12975  http://www.tcj.com/messboard/ubbcgi/ @key{RET}}.  (Substitute the @sc{url}  http://www.tcj.com/messboard/ubbcgi/ @key{RET}}.  (Substitute the @sc{url}
12976  (not including @samp{Ultimate.cgi} or the like at the end) for a forum  (not including @samp{Ultimate.cgi} or the like at the end) for a forum
12977  you're interested in; there's quite a list of them on the Ultimate web  you're interested in; there's quite a list of them on the Ultimate web
# Line 13032  The password for your account on the web Line 13032  The password for your account on the web
13032  @cindex url  @cindex url
13033  @cindex Netscape  @cindex Netscape
13034    
13035  Gnus uses the url library to fetch web pages and Emacs/w3 to display web  Gnus uses the url library to fetch web pages and Emacs/w3 to display web
13036  pages.  Emacs/w3 is documented in its own manual, but there are some  pages.  Emacs/w3 is documented in its own manual, but there are some
13037  things that may be more relevant for Gnus users.  things that may be more relevant for Gnus users.
13038    
13039  For instance, a common question is how to make Emacs/w3 follow links  For instance, a common question is how to make Emacs/w3 follow links
13040  using the @code{browse-url} functions (which will call some external web  using the @code{browse-url} functions (which will call some external web
13041  browser like Netscape).  Here's one way:  browser like Netscape).  Here's one way:
13042    
13043  @lisp  @lisp
# Line 13722  Here's an example: Line 13722  Here's an example:
13722    
13723  @lisp  @lisp
13724  (setq gnus-post-method  (setq gnus-post-method
13725        '(nngateway        '(nngateway
13726          "mail2news@@replay.com"          "mail2news@@replay.com"
13727          (nngateway-header-transformation          (nngateway-header-transformation
13728           nngateway-mail2news-header-transformation)))           nngateway-mail2news-header-transformation)))
# Line 13771  A server configuration in @code{~/.gnus} Line 13771  A server configuration in @code{~/.gnus}
13771  might look something like this:  might look something like this:
13772    
13773  @lisp  @lisp
13774  (setq gnus-secondary-select-methods  (setq gnus-secondary-select-methods
13775        '((nnimap "simpleserver") ; no special configuration        '((nnimap "simpleserver") ; no special configuration
13776          ; perhaps a ssh port forwarded server:          ; perhaps a ssh port forwarded server:
13777          (nnimap "dolk"          (nnimap "dolk"
# Line 13833  Example server specification: Line 13833  Example server specification:
13833    
13834  @lisp  @lisp
13835  (nnimap "mail.server.com"  (nnimap "mail.server.com"
13836          (nnimap-list-pattern ("INBOX" "Mail/*" "alt.sex.*"          (nnimap-list-pattern ("INBOX" "Mail/*" "alt.sex.*"
13837                                 ("~friend/Mail/" . "list/*"))))                                 ("~friend/Mail/" . "list/*"))))
13838  @end lisp  @end lisp
13839    
# Line 14041  Neither did I, we need examples. Line 14041  Neither did I, we need examples.
14041    
14042  @lisp  @lisp
14043  (setq nnimap-split-rule  (setq nnimap-split-rule
14044        '(("INBOX.nnimap"          '(("INBOX.nnimap"
14045           "^Sender: owner-nnimap@@vic20.globalcom.se")           "^Sender: owner-nnimap@@vic20.globalcom.se")
14046          ("INBOX.junk"    "^Subject:.*MAKE MONEY")          ("INBOX.junk"    "^Subject:.*MAKE MONEY")
14047          ("INBOX.private" "")))          ("INBOX.private" "")))
# Line 15618  returned is the local score file.  Phu. Line 15618  returned is the local score file.  Phu.
15618  For example, to do hierarchical scoring but use a non-server-specific  For example, to do hierarchical scoring but use a non-server-specific
15619  overall score file, you could use the value  overall score file, you could use the value
15620  @example  @example
15621  (list (lambda (group) ("all.SCORE"))  (list (lambda (group) ("all.SCORE"))
15622        'gnus-score-find-hierarchical)        'gnus-score-find-hierarchical)
15623  @end example  @end example
15624    
# Line 16088  each instance of a word should add given Line 16088  each instance of a word should add given
16088          (,gnus-del-mark . -15)))          (,gnus-del-mark . -15)))
16089  @end lisp  @end lisp
16090    
16091  This is the default value.  If you have adaption on words enabled, every  This is the default value.  If you adapt on words, every
16092  word that appears in subjects of articles marked with  word that appears in subjects of articles marked with
16093  @code{gnus-read-mark} will result in a score rule that increase the  @code{gnus-read-mark} will result in a score rule that increase the
16094  score with 30 points.  score with 30 points.
# Line 16297  the @code{Xref} header. Line 16297  the @code{Xref} header.
16297  If you want to lower the score of articles that have been crossposted to  If you want to lower the score of articles that have been crossposted to
16298  more than, say, 3 groups:  more than, say, 3 groups:
16299  @lisp  @lisp
16300  ("xref"  ("xref"
16301    ("[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+"    ("[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+ +[^:\n]+:[0-9]+"
16302     -1000 nil r))     -1000 nil r))
16303  @end lisp  @end lisp
# Line 16974  four days, Gnus will decay the scores fo Line 16974  four days, Gnus will decay the scores fo
16974  * Compilation::                How to speed Gnus up.  * Compilation::                How to speed Gnus up.
16975  * Mode Lines::                 Displaying information in the mode lines.  * Mode Lines::                 Displaying information in the mode lines.
16976  * Highlighting and Menus::     Making buffers look all nice and cozy.  * Highlighting and Menus::     Making buffers look all nice and cozy.
16977  * Buttons::                    Get tendonitis in ten easy steps!  * Buttons::                    Get tendinitis in ten easy steps!
16978  * Daemons::                    Gnus can do things behind your back.  * Daemons::                    Gnus can do things behind your back.
16979  * NoCeM::                      How to avoid spam and other fatty foods.  * NoCeM::                      How to avoid spam and other fatty foods.
16980  * Undo::                       Some actions can be undone.  * Undo::                       Some actions can be undone.
# Line 17533  for composing mail and news while leavin Line 17533  for composing mail and news while leavin
17533  accomplish that, something like the following can be done:  accomplish that, something like the following can be done:
17534    
17535  @lisp  @lisp
17536  (message  (message
17537    (frame 1.0    (frame 1.0
17538           (if (not (buffer-live-p gnus-summary-buffer))           (if (not (buffer-live-p gnus-summary-buffer))
17539               (car (cdr (assoc 'group gnus-buffer-configuration)))               (car (cdr (assoc 'group gnus-buffer-configuration)))
# Line 17575  windows resized. Line 17575  windows resized.
17575  @subsection Example Window Configurations  @subsection Example Window Configurations
17576    
17577  @itemize @bullet  @itemize @bullet
17578  @item  @item
17579  Narrow left hand side occupied by group buffer.  Right hand side split  Narrow left hand side occupied by group buffer.  Right hand side split
17580  between summary buffer (top one-sixth) and article buffer (bottom).  between summary buffer (top one-sixth) and article buffer (bottom).
17581    
# Line 18090  never be totally undoable. Line 18090  never be totally undoable.
18090  @findex gnus-undo  @findex gnus-undo
18091  The undoability is provided by the @code{gnus-undo-mode} minor mode.  It  The undoability is provided by the @code{gnus-undo-mode} minor mode.  It
18092  is used if @code{gnus-use-undo} is non-@code{nil}, which is the  is used if @code{gnus-use-undo} is non-@code{nil}, which is the
18093  default.  The @kbd{C-M-_} key performs the @code{gnus-undo}  default.  The @kbd{C-M-_} key performs the @code{gnus-undo}
18094  command, which should feel kinda like the normal Emacs @code{undo}  command, which should feel kinda like the normal Emacs @code{undo}
18095  command.  command.
18096    
# Line 18710  to non-existent domains is yucky, in my Line 18710  to non-existent domains is yucky, in my
18710  @table @code  @table @code
18711    
18712  @item gnus-home-directory  @item gnus-home-directory
18713  All Gnus path variables will be initialized from this variable, which  All Gnus file and directory variables will be initialized from this
18714  defaults to @file{~/}.  variable, which defaults to @file{~/}.
18715    
18716  @item gnus-directory  @item gnus-directory
18717  @vindex gnus-directory  @vindex gnus-directory
18718  Most Gnus storage path variables will be initialized from this variable,  Most Gnus storage file and directory variables will be initialized from
18719  which defaults to the @samp{SAVEDIR} environment variable, or  this variable, which defaults to the @samp{SAVEDIR} environment
18720  @file{~/News/} if that variable isn't set.  variable, or @file{~/News/} if that variable isn't set.
18721    
18722  Note that Gnus is mostly loaded when the @file{.gnus.el} file is read.  Note that Gnus is mostly loaded when the @file{.gnus.el} file is read.
18723  This means that other directory variables that are initialized from this  This means that other directory variables that are initialized from this
# Line 18915  If was released as ``Gnus 5.6'' on March Line 18915  If was released as ``Gnus 5.6'' on March
18915    
18916  Gnus 5.6 begat Pterodactyl Gnus on August 29th 1998 and was released as  Gnus 5.6 begat Pterodactyl Gnus on August 29th 1998 and was released as
18917  ``Gnus 5.8'' (after 99 releases and a CVS repository) on December 3rd  ``Gnus 5.8'' (after 99 releases and a CVS repository) on December 3rd
18918  1999.  1999.
18919    
18920  If you happen upon a version of Gnus that has a prefixed name --  If you happen upon a version of Gnus that has a prefixed name --
18921  ``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'' --  ``(ding) Gnus'', ``September Gnus'', ``Red Gnus'', ``Quassia Gnus'' --
# Line 19890  considered home score and adapt files (@ Line 19890  considered home score and adapt files (@
19890  been added.  been added.
19891    
19892  @item  @item
19893  @code{nndoc} was rewritten to be easily extendable (@pxref{Document  @code{nndoc} was rewritten to be easily extensible (@pxref{Document
19894  Server Internals}).  Server Internals}).
19895    
19896  @item  @item
# Line 19997  More hooks and functions have been added Line 19997  More hooks and functions have been added
19997  mail before saving the mail (@pxref{Washing Mail}).  mail before saving the mail (@pxref{Washing Mail}).
19998    
19999  @item  @item
20000  Emphasized text can be properly fontisized:  Emphasized text can be properly fontified:
20001    
20002  @end itemize  @end itemize
20003    
# Line 20150  If you used procmail like in Line 20150  If you used procmail like in
20150  (setq nnmail-procmail-suffix "\\.in")  (setq nnmail-procmail-suffix "\\.in")
20151  @end lisp  @end lisp
20152    
20153  this now has changed to  this now has changed to
20154    
20155  @lisp  @lisp
20156  (setq mail-sources  (setq mail-sources
# Line 20179  of variables starting with @code{gnus-tr Line 20179  of variables starting with @code{gnus-tr
20179  @item The Gnus posting styles have been redone again and now works in a  @item The Gnus posting styles have been redone again and now works in a
20180  subtly different manner.  subtly different manner.
20181    
20182  @item New web-based back ends have been added: @code{nnslashdot},  @item New web-based back ends have been added: @code{nnslashdot},
20183  @code{nnwarchive} and @code{nnultimate}.  nnweb has been revamped,  @code{nnwarchive} and @code{nnultimate}.  nnweb has been revamped,
20184  again, to keep up with ever-changing layouts.  again, to keep up with ever-changing layouts.
20185    
# Line 20258  I guess most manuals are written after-t Line 20258  I guess most manuals are written after-t
20258  that's already there.  This is not how this manual is written.  When  that's already there.  This is not how this manual is written.  When
20259  implementing something, I write the manual entry for that something  implementing something, I write the manual entry for that something
20260  straight away.  I then see that it's difficult to explain the  straight away.  I then see that it's difficult to explain the
20261  functionality, so I write how it's supposed to be, and then I change the  functionality, so I write how it's supposed to be, and then I change the
20262  implementation.  Writing the documentation and writing the code goes  implementation.  Writing the documentation and writing the code goes
20263  hand in hand.  hand in hand.
20264    
20265  This, of course, means that this manual has no, or little, flow.  It  This, of course, means that this manual has no, or little, flow.  It
20266  documents absolutely everything in Gnus, but often not where you're  documents absolutely everything in Gnus, but often not where you're
20267  looking for it.  It is a reference manual, and not a guide to how to get  looking for it.  It is a reference manual, and not a guide to how to get
20268  started with Gnus.  started with Gnus.
20269    
20270  That would be a totally different book, that should be written using the  That would be a totally different book, that should be written using the
20271  reference manual as source material.  It would look quite differently.  reference manual as source material.  It would look quite differently.
20272    
20273    
# Line 20423  original. Line 20423  original.
20423  @cindex ephemeral groups  @cindex ephemeral groups
20424  Most groups store data on what articles you have read.  @dfn{Ephemeral}  Most groups store data on what articles you have read.  @dfn{Ephemeral}
20425  groups are groups that will have no data stored---when you exit the  groups are groups that will have no data stored---when you exit the
20426  group, it'll disappear into the aether.  group, it'll disappear into the ether.
20427    
20428  @item solid groups  @item solid groups
20429  @cindex solid groups  @cindex solid groups
# Line 21488  Below is a slightly shortened version of Line 21488  Below is a slightly shortened version of
21488    "*Non-nil means that nndir will never retrieve NOV headers."    "*Non-nil means that nndir will never retrieve NOV headers."
21489    nnml-nov-is-evil)    nnml-nov-is-evil)
21490    
21491  (defvoo nndir-current-group ""  (defvoo nndir-current-group ""
21492    nil    nil
21493    nnml-current-group nnmh-current-group)    nnml-current-group nnmh-current-group)
21494  (defvoo nndir-top-directory nil nil nnml-directory nnmh-directory)  (defvoo nndir-top-directory nil nil nnml-directory nnmh-directory)
21495  (defvoo nndir-get-new-mail nil nil nnml-get-new-mail nnmh-get-new-mail)  (defvoo nndir-get-new-mail nil nil nnml-get-new-mail nnmh-get-new-mail)
# Line 21508  Below is a slightly shortened version of Line 21508  Below is a slightly shortened version of
21508    (unless (assq 'nndir-directory defs)    (unless (assq 'nndir-directory defs)
21509      (push `(nndir-directory ,server) defs))      (push `(nndir-directory ,server) defs))
21510    (push `(nndir-current-group    (push `(nndir-current-group
21511            ,(file-name-nondirectory            ,(file-name-nondirectory
21512              (directory-file-name nndir-directory)))              (directory-file-name nndir-directory)))
21513          defs)          defs)
21514    (push `(nndir-top-directory    (push `(nndir-top-directory

Legend:
Removed from v.1.30  
changed lines
  Added in v.1.30.2.1

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26