From 4cbf8616d0a975ac551a3d08a5fe1b2d29cc4d10 Mon Sep 17 00:00:00 2001 From: yamaoka Date: Thu, 4 Feb 1999 12:37:33 +0000 Subject: [PATCH] * lisp/gnus.el (gnus-revision-number): Increment to 02. * README-offline.en: New description. * README-offline.ja: Ditto. --- ChangeLog | 13 +++- README-offline.en | 174 ++++++++++++++++++++++++++++++++++++++++++++++++++++- README-offline.ja | 82 +++++++++++++++++++------ 3 files changed, 248 insertions(+), 21 deletions(-) diff --git a/ChangeLog b/ChangeLog index 46dec21..2baaafe 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,9 +1,18 @@ +1999-02-04 Katsumi Yamaoka + + * lisp/gnus.el (gnus-revision-number): Increment to 02. + +1999-02-04 YOSHIZAWA Masahiro + + * README-offline.en: New description. + * README-offline.ja: Ditto. + 1999-02-03 Tatsuya Ichikawa - + * lisp/gnus.el (gnus-revision-number): Change to 01 * lisp/gnus-ofsetup.el (gnus-setup-for-offline): Add default value. - + 1999-02-03 Tatsuya Ichikawa * lisp/gnus.el (gnus-revision-number): New constant. diff --git a/README-offline.en b/README-offline.en index 8854b25..5bf0399 100644 --- a/README-offline.en +++ b/README-offline.en @@ -1,4 +1,101 @@ -User definable variables in gnus-offline +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. + +It designed mainly for "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). + +;; 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. + +**Features** + +o Simple configuration -- An "INTERACTIVE" way to set variables for + configuration. + +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.) + +So, this document is written for using "gnus-agent",mainly for bundled +with T-gnus 6.10.56 or later. + +2)Installation + +If you use "gnus-offline" with "T-gnus", installation is very +simple. It would automatically install with "T-gnus". + +If not, you may byte-compile "gnus-offline.el" and "gnus-ofsetup.el", +and set load-path. + +3) How to use + +o First, you must set up general configuration for Semi-gnus.(See info) + +o Add following code to your ~/.emacs + + (load "gnus-ofsetup") + (gnus-setup-for-offline) + (load gnus-offline-setting-file) + +o Add following code to your ~/.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*** + +In T-gnus 6.10.56 or later,"pop3-fma.el" doesn't need for multiple +mail-accounts. + +<<<<>>>> +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.) + +[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) + +[6.10.56 or later] + +o gnus-offline-mail-source + '( + (pop :user "manbou" :server "pop.ceres.dti.ne.jp") + (pop :user "imp9397" :server "mvb.biglobe.ne.jp") + : + : + ) + + + +3)User definable variables in gnus-offline o gnus-offline-dialup-program Program name to dialup. @@ -78,7 +175,7 @@ o gnus-offline-pop-password-file o gnus-offline-pop-password-decoding-function Function to decode password. -Commands in gnus-offline. +4)Commands in gnus-offline. o M-x gnus-offline-toggle-plugged Toggle offline/online state. @@ -101,3 +198,76 @@ o M-x gnus-offline-set-interval-time 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] + + (setq mail-source-password-cache + '(("SERVER1:ACCOUNT1:pop3" . "PASSWORD1") + ("SERVER2:ACCOUNT2:pop3" . "PASSWORD2") + ............................ + )) + +To prevent accidents, encoding this file with Base64 is recommended. +For this purpose, + M-: (base64-encode-region (point-min) (point-max)) +can be used. + +If you don't need encoding, add following code to ~/.gnus-offline.el. + + (setq gnus-offline-pop-password-decoding-function nil) + +But it is so dangerous!! +^^^^^^^^^^^^^^^^^^^^^^^^ + +;;; 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.) diff --git a/README-offline.ja b/README-offline.ja index 36a1b46..57ac677 100644 --- a/README-offline.ja +++ b/README-offline.ja @@ -20,8 +20,9 @@ ネットニュースの送受信->ダイアルアップの切断 という動作を一気に行うこと が可能になります。(ただし接続・および切断は別途専用のツールが必要です) -なお、このドキュメントでは送受信ともに gnus-agent を使うことを前提に解説 -します。 +なお、このドキュメントでは主に T-gnus 6.10.56 以降のバージョンに附属する +gnus-offline.elについて、送受信ともに gnus-agent を使うことを前提に解説 +します。(古いバージョンとは異なる部分がありますのでご注意ください) 2) インストール @@ -61,14 +62,17 @@ T-gnus をお使いの場合、gnus-offline.el は特に何も考えなくても T-gnus 前記の動作をするはずです。 -◆また、同梱の pop3-fma.el を用いると複数のメイルアカウントを管理するこ -とが出来ます。 +また、T-gnus 6.10.56 以降のものでは Gnus 自体が複数のメイルアカウントを +扱えます。(6.10.55 以前の T-gnus でも同梱の pop3-fma.el を用いても複数の +メイルアカウントを管理することが出来ます。) -<<<<<< 注意 >>>>>>>>>>> -ただし、T-gnus 6.10.56 以降のバージョンを使用する方は pop3-fma.el は含ま -れていません。Gnus が複数の POP3 アカウントを扱えるようになりましたので、 -pop3-fma.el の設定は外してください。 +<<<<<< 注意 >>>>>>>>>>> + +T-gnus 6.10.56 以降のバージョンには pop3-fma.el は含まれていません。バー +ジョンアップされた方は既存の pop3-fma.el の設定は外してください。 +(既存の .gnus-offline.el を消すのがもっとも簡単です) +【〜6.10.55】 ・pop3-fma-spool-file-alist 　　　　'( ("po:アカウント1@popサーバ1" pass) @@ -79,6 +83,14 @@ pop3-fma.el の設定は外してください。 ・pop3-fma-movemail-type メイル受信に movemail.exe を使う('exe)か pop3.el('lisp) を使うか。 +【6.10.56〜】 +代わりに以下のような設定がされます。 + +・gnus-offline-mail-source '( + (pop :user "manbou" :server "pop.ceres.dti.ne.jp") + (pop :user "imp9397" :server "mvb.biglobe.ne.jp") +　　　　…………………… + ) 3) gnus-offline で設定可能な変数一覧 @@ -162,6 +174,9 @@ pop3-fma.el の設定は外してください。 ・gnus-offline-hangup-function 切断に使用する関数名 +・gnus-offline-mail-source + メールサーバー、ユーザー名のリスト + ・gnus-offline-pop-password-file ユーザー名、メールサーバー、パスワードを保存するためのファイル名 @@ -197,13 +212,18 @@ pop3-fma.el の設定は外してください。 5)【!!!重要!!!】 pop パスワードの管理方法について + +;;;バージョンにより異なる部分が多いのでご注意ください。またこの部分は今 +;;;後も改訂されることが予想されます。 + <<<<<< 注意 >>>>>>>>>>> -ただし、T-gnus 6.10.56 以降のバージョンを使用する方は pop3-fma.el は含ま -れていません。Gnus が複数の POP3 アカウントを扱えるようになりましたので、 -pop3-fma.el の設定は外してください。 +T-gnus 6.10.56 以降のバージョンを使用する方は pop3-fma.el は含まれていま +せん。Gnus が複数の POP3 アカウントを扱えるようになりましたので、 +バージョンアップされる際は既存の pop3-fma.el の設定は外してください。 -デフォルトでは pop サーバのパスワードは pop サーバーにアクセスする度に入 -力する必要があります。(基本的にこのままにしておくことを推奨します) +T-gnus 6.10.55 以前のデフォルトでは pop サーバのパスワードは pop サーバー +にアクセスする度に入力する必要があります。(基本的にこのままにしておくこ +とを推奨します) しかし、「これだと面倒だしどうせ自分一人しか使わないコンピュータだからそ れほどパスワードの管理には注意を払う必要がない」という場合にはいくつかの @@ -211,7 +231,6 @@ pop3-fma.el の設定は外してください。 すので以下の方法のいずれかを実行する際には 100% 自己の責任のもとで行って ください。 - まず、パスワードをファイルに残しては置きたくないがメモリ上に変数として残っ ていても構わない、という場合は、~/.gnus-offline.el に以下のようなコード を加えてください。 @@ -219,22 +238,44 @@ pop3-fma.el の設定は外してください。 (setq pop3-fma-save-password-information t) こうすることにより、パスワードは Gnus 起動時に入力するだけになります。 +(T-gnus 6.10.56 以降のバージョンを使用する方は特に設定しなくてもこれと同 +じ状態がデフォルトになっています。) + また、ファイルに残しても構わないがメモリ上の変数として残したくない場合、 -または全くパスワードの入力を省きたい場合は、.gnus-offline.el に以下のよ -うなコードを加え、パスワードファイルを指定します。 +または全くパスワードの入力を省きたい場合は、.gnus-offline.el の +以下のようなコードを加え、パスワードファイルを +指定します。 (setq gnus-offline-pop-password-file "~/.pop.passwd") +また、T-gnus 6.10.56 以降の場合は以下をコメントアウトします。 +(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) + + 指定したパスワードファイル(この例では~/.pop.passwd)を作成し、パスワード の情報を以下のような形式で書きます。 +【T-gnus 6.10.55 以前】 + (setq pop3-fma-password '(("SERVER1" "ACCOUNT1" "PASSWORD1") ("SERVER2" "ACCOUNT2" "PASSWORD2") ............................ )) +【T-gnus 6.10.56 以降】 + +(setq mail-source-password-cache + '( + ("SERVER1:ACCOUNT1:pop3" . "PASSWORD1") + ("SERVER2:ACCOUNT2:pop3" . "PASSWORD2") + ............................ + )) + + このファイルをうっかり開いてしまってもパスワードが見えないように、 base64 でエンコードすることをお勧めします。その為には @@ -246,4 +287,11 @@ base64 でエンコードすることをお勧めします。その為には (setq gnus-offline-pop-password-decoding-function nil) と書きます。(ただしこれは非常に危険です。) - ~~~~~~~~~~~~~~~~~~~~~~~~~~ + ~~~~~~~~~~~~~~~~~~~~~~~~~~ + +;;; なお、T-gnus 6.10.57 以降では 初回起動時の gnus-ofsetup.el による変 +;;; 数設定の際、(=~/.gnus-offline.el がないとき)パスワードを +;;; ~/.newsrc.eld に保存するかどうか質問され、“y”と答えると保存される +;;; ようになります。ただしこの場合は保存されるパスワードは平文のままなの +;;; でかなり危険であることをご承知のうえお使いください。(上記の方法も使 +;;; えます) -- 1.7.10.4