1 1) What's "gnus-offline (Gnus Offline Backend Utility)" ?
2 =========================================================
4 This program is a utility for T-gnus that handles messages
5 (i.e. mail and news) in the "offline" state in a more simple way.
7 It is basically designed for "gnus-agent". (See info about gnus-agent.)
9 You can also use it with a function "nnspool"(*1) (which needs an
10 external program such as "gnspool"(*2) ), or with "miee.el"(*3) for
11 posting and/or sending messages.
13 (*1) See info about nnspool.
14 (*2) gnspool comes with a newsreader "gn".
15 (*3) The latest version of miee.el (or MIEE) is available at
16 http://www.shiojiri.ne.jp/%7Et-ichi/meadow.html
18 You can handle messages in the offline state without "gnus-offline",
19 but "gnus-offline" provides a simple way for setup and operation.
23 o Simple configuration -- An "INTERACTIVE" configuration to set
26 o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline
29 o Send mails & post news articles
30 o Fetch new mails & articles
33 (*) For dialing and hanging up, external softwares are needed.
34 But you can do without ones if you connect and disconnect
37 This document is written mainly for the case using "gnus-agent" with
38 gnus-offline.el bundled in T-gnus 6.12.0 or later.
43 As you are reading this document, this version of T-gnus includes
44 gnus-offline. Installation is simple. "make install" will
45 automatically install "gnus-offline".
50 o First, you must do a general setup for T-gnus (See info about the
53 o Add the following code to ~/.emacs
56 (gnus-setup-for-offline)
58 o Add the following code to ~/.gnus
62 o Restart Emacs. gnus-ofsetup.el will ask you some questions and
63 create ~/.gnus-offline.el. (*)
65 (*) If you don't know how to answer some questions, typing "TAB"
66 key may show you the possible answers. See the next section
67 which explains the user options.
68 You will also be asked whether to save the POP password in
69 ~/.newsrc.eld or not. Answer it carefully. See section 6)
72 o At the first time, you must start Gnus in the "online" state and
73 decide which groups to subscribe (See info about subscribing).
75 o Add the following code to ~/.gnus
77 (setq gnus-plugged nil)
79 That's all. Restart Gnus and try typing "g" in the *Group* buffer.
81 4) User customizable variables in gnus-offline
82 ==============================================
84 o gnus-offline-dialup-program
85 Program name to dialup.
87 o gnus-offline-dialup-program-arguments
88 List of dialup program arguments.
90 o gnus-offline-hangup-program
91 Program name to hangup.
93 o gnus-offline-hangup-program-arguments
94 List of hangup program arguments.
96 o gnus-offline-mail-spool-directory
97 Spool directory for sending mail.
98 This variable is available only using MIEE.
100 o gnus-offline-news-spool-directory
101 Spool directory for sending news.
102 This variable is available only using MIEE.
104 o gnus-offline-mail-treat-environ
105 If t , gnus-offline sends mail to spool first.
106 If nil , gnus-offline sends mail immediately.
108 o gnus-offline-articles-to-fetch
109 Article type you want to fetch.
111 'both ... Fetch both Mail/News.
112 'Mail ... Fetch only Mail.
113 'News ... Fetch only News.
115 Default value is both.
117 o gnus-offline-load-hook
118 Hook before gnus-offline load.
120 o gnus-offline-before-online-hook
121 Hook before all online jobs.
123 o gnus-offline-after-online-hook
124 Hook after all online jobs.
126 o gnus-offline-interval-time
127 Interval time to do all online jobs.(minutes)
129 o gnus-offline-MTA-type
130 MTA type to sending mail.
132 'smtp ... Use smtp.el.
133 'sendmail ... Use sendmail.el.
135 o gnus-offline-drafts-queue-type
136 Message queue type when spooling message.
138 'miee ... Use miee.el.
139 'agent ... Use gnus-agent.el.
141 o gnus-offline-after-empting-spool-hook
142 Hook before empting spool.
144 o gnus-offline-before-empting-spool-hook
145 Hook after emoting spool.
147 o gnus-offline-dialup-function
150 o gnus-offline-hangup-function
153 5) Commands in gnus-offline
154 ===========================
156 o M-x gnus-offline-toggle-plugged
157 Toggle offline/online state.
159 o M-x gnus-offline-toggle-auto-hangup
160 Change current state to offline.
162 o M-x gnus-offline-toggle-on/off-send-mail
163 Toggle method to sending mail.
165 o M-x gnus-offline-toggle-articles-to-fetch
166 Toggle articles you want to fetch.
168 o M-x gnus-offline-set-interval-time
169 Set interval time(minute) to fetch article.
171 o M-x gnus-offline-agent-expire
174 6) [!!!IMPORTANT!!!] About the pop password
175 ===========================================
177 If your machine is stand alone, and nobody else uses it, you can save
178 the password. (But, on your own responsibility!)
180 At the first interactive configuration, it will ask you whether to
181 save the password in ~/.newsrc.eld or not. When you answer "y" to this
182 question, the password will be saved in ~/.newsrc.eld. (*)
184 (*) Actually the following will be added to ~/.gnus-offline.el.
187 'gnus-setup-news-hook
189 (add-to-list 'gnus-variable-list 'mail-source-password-cache)))
191 Answer this question carefully, because the password will NOT be