1) What's "gnus-offline (Gnus Offline Backend Utility)" ?
+=========================================================
-This program is a utility to handle messages(mail & news) in "offline"
-status with Semi-gnus in more simple way.
+This program is a utility for T-gnus that handles messages
+(i.e. mail and news) in the "offline" state in a more simple way.
-It designed mainly for "gnus-agent".
+It is basically designed for "gnus-agent". (See info about gnus-agent.)
-So, you can use it with function "nnspool" (which needs external
-programs (such as "gnspool")). And also with "Miee.el" (for only
-posting/sending).
+You can also use it with a function "nnspool"(*1) (which needs an
+external program such as "gnspool"(*2) ), or with "miee.el"(*3) for
+posting and/or sending messages.
-;; Of course, you can handle messages in offline status without
-;; "gnus-offline", but using "gnus-offline" provides you a simple way
-;; to setup and operation.
+ (*1) See info about nnspool.
+ (*2) gnspool comes with a newsreader "gn".
+ (*3) The latest version of miee.el (or MIEE) is available at
+ http://www.shiojiri.ne.jp/%7Et-ichi/meadow.html
+
+You can handle messages in the offline state without "gnus-offline",
+but "gnus-offline" provides a simple way for setup and operation.
**Features**
-o Simple configuration -- An "INTERACTIVE" way to set variables for
- configuration.
+o Simple configuration -- An "INTERACTIVE" configuration to set
+ the variables.
-o Simple operation -- Only typing "g" on *Groups* buffer, then "dialing ->
- sending mails & posting news articles, and fetch new mails &
- articles -> hang-up line".(For automatic dialing and hang-up, some
- external software needed.)
+o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline
+ will:
+ o Dial (*)
+ o Send mails & post news articles
+ o Fetch new mails & articles
+ o Hang up (*)
-So, this document is written for using "gnus-agent",mainly for bundled
-with T-gnus 6.10.56 or later.
+ (*) For dialing and hanging up, external softwares are needed.
+ But you can do without ones if you connect and disconnect
+ manually.
-2)Installation
+This document is written mainly for the case using "gnus-agent" with
+gnus-offline.el bundled in T-gnus 6.12.0 or later.
-If you use "gnus-offline" with "T-gnus", installation is very
-simple. It would automatically install with "T-gnus".
+2) Installation
+===============
-If not, you may byte-compile "gnus-offline.el" and "gnus-ofsetup.el",
-and set load-path.
+As you are reading this document, this version of T-gnus includes
+gnus-offline. Installation is simple. "make install" will
+automatically install "gnus-offline".
3) How to use
+=============
+
+o First, you must do a general setup for T-gnus (See info about the
+ setup).
-o First, you must set up general configuration for Semi-gnus.(See info)
+o Add the following code to ~/.emacs
-o Add following code to your ~/.emacs
+ (autoload 'gnus-plugged "gnus-agent" nil t)
+ (autoload 'gnus-unplugged "gnus-agent" nil t)
+
+o Add the following code to ~/.emacs
(load "gnus-ofsetup")
(gnus-setup-for-offline)
- (load gnus-offline-setting-file)
-o Add following code to your ~/.gnus
+o Add the following code to ~/.gnus
(gnus-agentize)
-o Please restart emacs. Then, gnus-ofsetup.el ask you some questions
- (when you don't know how to answer,see next section of this document
- or type "TAB" key for completion) and then gnus-ofsetup.el will creates
- ~/.gnus-offline.el.
-
-o At first time, you must connect "online" status for subscribe
- group.(See info)
-
-o Add following code to ~/.gnus
-
- (gnus-agent-toggle-plugged nil)
-
-Then restart Gnus and try to type "g" on *Groups" buffer.
-
-***Note***
+o Restart Emacs. gnus-ofsetup.el will ask you some questions and
+ create ~/.gnus-offline.el. (*)
-In T-gnus 6.10.56 or later,"pop3-fma.el" doesn't need for multiple
-mail-accounts.
+ (*) If you don't know how to answer some questions, typing "TAB"
+ key may show you the possible answers. See the next section
+ which explains the user options.
+ You will also be asked whether to save the POP password in
+ ~/.newsrc.eld or not. Answer it carefully. See section 6)
+ for details.
-<<<<<ATTENTION!!>>>>>
-T-gnus 6.10.56 or later doesn't contain "pop3-fma.el". So if you had
-use T-gnus 6.10.55(or older) and update to 6.10.56(or later), change
-your settings.(most simple way is deleting old ~/.gnus-offline.el.)
+o At the first time, you must start Gnus in the online state
+ (by M-x gnus-plugged) and decide which groups to subscribe (See info
+ about subscribing).
-[6.10.55 or older]
-o pop3-fma-spool-file-alist
-\e$B!!!!!!!!\e(B'(
- ("po:account1@pop-server1" pass)
- ("po:account2@pop-server2" pass)
- :
- :
- ))
-o pop3-fma-movemail-type
- use movemail.exe ('exe) or pop3.el('lisp)
+ From now on you can start Gnus as an offline reader by M-x gnus-unplugged.
+ Try typing "g" in the *Group* buffer.
-[6.10.56 or later]
+o You may want M-x gnus to start Gnus as an offline reader as
+ M-x gnus-unplugged. Then write the following code to ~/.emacs
-o gnus-offline-mail-source
- '(
- (pop :user "manbou" :server "pop.ceres.dti.ne.jp")
- (pop :user "imp9397" :server "mvb.biglobe.ne.jp")
- :
- :
- )
-
+ (setq gnus-plugged nil)
+ you can put it into ~/.gnus if there's no need to start Gnus as an online
+ reader (by M-x gnus-plugged).
-3)User definable variables in gnus-offline
+4) User customizable variables in gnus-offline
+==============================================
-o gnus-offline-dialup-program
+o gnus-offline-dialup-program
Program name to dialup.
o gnus-offline-dialup-program-arguments
o gnus-offline-mail-treat-environ
If t , gnus-offline sends mail to spool first.
- If nil , gnus-offline sends mail immediatry.
+ If nil , gnus-offline sends mail immediately.
o gnus-offline-articles-to-fetch
Article type you want to fetch.
Default value is both.
-o gnus-offline-popup-menu
- Whether use menu.
-
o gnus-offline-load-hook
Hook before gnus-offline load.
o gnus-offline-drafts-queue-type
Message queue type when spooling message.
-
+
'miee ... Use miee.el.
'agent ... Use gnus-agent.el.
o gnus-offline-hangup-function
Function to hangup.
-o gnus-offline-pop-password-file
- File name to save username , mailserver and password.
-
-o gnus-offline-pop-password-decoding-function
- Function to decode password.
-
-4)Commands in gnus-offline.
+5) Commands in gnus-offline
+===========================
o M-x gnus-offline-toggle-plugged
Toggle offline/online state.
o M-x gnus-offline-toggle-articles-to-fetch
Toggle articles you want to fetch.
-o M-x gnus-offline-toggle-movemail-program
- Toggle movemail program.
-
o M-x gnus-offline-set-interval-time
Set interval time(minute) to fetch article.
o M-x gnus-offline-agent-expire
Expire articles.
-5)[!!!IMPORTANT!!!] About pop password
-
-<<<<< ATTENTION >>>>>
-T-gnus 6.10.56 or later doesn't contain "pop3-fma.el". So if you had
-use T-gnus 6.10.55 or older, and update to 6.10.56 or later, change
-your configuration.(most simple way is deleting old
-~/.gnus-offline.el.)
-
-In T-gnus 6.10.55 or older, you must enter password for pop server per
-accesses.(This way is recommended.)
-
-If your machine is stand alone, and nobody but you use it, you can
-save password in some way.(Of course, it is in your responsibility!)
-
-The first way to save password(it is not save in file but in memory as
-variable), add following code in your ~/.gnus-offline.el.
-
- (setq pop3-fma-save-password-information t)
-
-In this way, you must enter password only at startup of Gnus.
-(In T-gnus 6.10.56 or later, this status is default.)
-
----
-
-The other way (save password in file but not save in memory) is
-following.
-
-o Add following code to ~/.gnus-offline.el
-
- (setq gnus-offline-pop-password-file "~/.pop.passwd")
-
-o In T-gnus 6.10.56 or later, comment out following code in
- ~/.gnus-offline.el.
-
- (require 'read-passwd)
- (setq mail-source-read-passwd 'read-pw-read-passwd)
- (add-hook 'gnus-before-startup-hook 'read-pw-set-mail-source-passwd-cache)
-
-o Create password-file (e.g.~/.pop.passwd)
-
- [T-gnus 6.10.55 or older]
-
- (setq pop3-fma-password
- '(("SERVER1" "ACCOUNT1" "PASSWORD1")
- ("SERVER2" "ACCOUNT2" "PASSWORD2")
- ............................
- ))
-
- [T-gnus 6.10.56 or later]
+6) [!!!IMPORTANT!!!] About the pop password
+===========================================
- (setq mail-source-password-cache
- '(("SERVER1:ACCOUNT1:pop3" . "PASSWORD1")
- ("SERVER2:ACCOUNT2:pop3" . "PASSWORD2")
- ............................
- ))
+If your machine is stand alone, and nobody else uses it, you can save
+the password. (But, on your own responsibility!)
-To prevent accidents, encoding this file with Base64 is recommended.
-For this purpose,
- M-: (base64-encode-region (point-min) (point-max))
-can be used.
+At the first interactive configuration, it will ask you whether to
+save the password in ~/.newsrc.eld or not. When you answer "y" to this
+question, the password will be saved in ~/.newsrc.eld. (*)
-If you don't need encoding, add following code to ~/.gnus-offline.el.
+ (*) Actually the following will be added to ~/.gnus-offline.el.
- (setq gnus-offline-pop-password-decoding-function nil)
-
-But it is so dangerous!!
-^^^^^^^^^^^^^^^^^^^^^^^^
+ (add-hook
+ 'gnus-setup-news-hook
+ (lambda ()
+ (add-to-list 'gnus-variable-list 'mail-source-password-cache)))
-;;; In T-gnus 6.10.57 (or later), gnus-ofsetup.el will ask you whether
-;;; save password to ~/.newsrc.eld or not. When you answer "y" to this
-;;; question, your password might be saved to ~/.newsrc.eld. But in
-;;; this way, be careful to answer "y", because your saved password is
-;;; NOT encoded!(of course, you can use above way to save password.)
+Answer this question carefully, because the password will NOT be
+encoded!
projects / elisp / gnus.git- / blobdiff