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 |
|
|
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. |
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 |
|
|
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 |
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. |
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 |
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) |
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 |
|
|
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: |
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 |
|
|
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 |
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 |
|
|
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 |
|
|
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 |
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. |
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 |
|
|
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)} |
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)} |
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 |
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 |
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 |
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 |
|
|
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: |
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")) |
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 |
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. |
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 |
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}. |
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 |
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 |
|
|
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 |
|
|
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 |
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 |
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 |
|
|
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 |
|
|
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 |
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 |
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") |
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 |
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 |
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 |
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. |
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 |
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 |
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))) |
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" |
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 |
|
|
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" ""))) |
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 |
|
|
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. |
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 |
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. |
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))) |
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 |
|
|
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 |
|
|
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 |
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'' -- |
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 |
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 |
|
|
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 |
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 |
|
|
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 |
|
|
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 |
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) |
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 |