X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README-offline.en;h=65af7ee7a31b3684985e121939320458054825c4;hb=061e798ef76d26c62e20b8ebb2629c00518a2530;hp=5bf03990b9c2a9e99addc5ff4cd8b6c1fa9d7722;hpb=4cbf8616d0a975ac551a3d08a5fe1b2d29cc4d10;p=elisp%2Fgnus.git- diff --git a/README-offline.en b/README-offline.en index 5bf0399..65af7ee 100644 --- a/README-offline.en +++ b/README-offline.en @@ -1,103 +1,98 @@ 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. -<<<<>>>> -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 -　　　　'( - ("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 @@ -119,7 +114,7 @@ o gnus-offline-news-spool-directory 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. @@ -130,9 +125,6 @@ o gnus-offline-articles-to-fetch Default value is both. -o gnus-offline-popup-menu - Whether use menu. - o gnus-offline-load-hook Hook before gnus-offline load. @@ -153,7 +145,7 @@ o gnus-offline-MTA-type o gnus-offline-drafts-queue-type Message queue type when spooling message. - + 'miee ... Use miee.el. 'agent ... Use gnus-agent.el. @@ -169,13 +161,8 @@ o gnus-offline-dialup-function 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. @@ -189,85 +176,28 @@ o M-x gnus-offline-toggle-on/off-send-mail 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!