From 2cf9ca6b3409d8485e63aa24079f9b723e085b69 Mon Sep 17 00:00:00 2001 From: ichikawa Date: Mon, 8 Feb 1999 02:10:03 +0000 Subject: [PATCH] 1999-02-08 Tatsuya Ichikawa * lisp/gnus.el (gnus-revision-number): Increment to 04. * lisp/nntp.el: Change nnmail-read-passwd -> mail-source-read-passwd. 1999-02-08 Tsukamoto Tetsuo * README-offline.ja: Change for current version. * README-offline.en: Ditto. --- ChangeLog | 11 + README-offline.en | 556 ++++++++++++++++++++++++++------------------------- README-offline.ja | 578 ++++++++++++++++++++++++++--------------------------- lisp/gnus.el | 2 +- lisp/nntp.el | 8 +- 5 files changed, 580 insertions(+), 575 deletions(-) diff --git a/ChangeLog b/ChangeLog index 77bdf81..320404d 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +1999-02-08 Tatsuya Ichikawa + + * lisp/gnus.el (gnus-revision-number): Increment to 04. + + * lisp/nntp.el: Change nnmail-read-passwd -> mail-source-read-passwd. + +1999-02-08 Tsukamoto Tetsuo + + * README-offline.ja: Change for current version. + * README-offline.en: Ditto. + 1999-02-07 Tatsuya Ichikawa * lisp/gnus.el (gnus-revision-number): Increment to 03. diff --git a/README-offline.en b/README-offline.en index 5bf0399..cd36cff 100644 --- a/README-offline.en +++ b/README-offline.en @@ -1,273 +1,283 @@ -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. - -o gnus-offline-dialup-program-arguments - List of dialup program arguments. - -o gnus-offline-hangup-program - Program name to hangup. - -o gnus-offline-hangup-program-arguments - List of hangup program arguments. - -o gnus-offline-mail-spool-directory - Spool directory for sending mail. - This variable is available only using MIEE. - -o gnus-offline-news-spool-directory - Spool directory for sending news. - This variable is available only using MIEE. - -o gnus-offline-mail-treat-environ - If t , gnus-offline sends mail to spool first. - If nil , gnus-offline sends mail immediatry. - -o gnus-offline-articles-to-fetch - Article type you want to fetch. - - 'both ... Fetch both Mail/News. - 'Mail ... Fetch only Mail. - 'News ... Fetch only News. - - 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-before-online-hook - Hook before all online jobs. - -o gnus-offline-after-online-hook - Hook after all online jobs. - -o gnus-offline-interval-time - Interval time to do all online jobs.(minutes) - -o gnus-offline-MTA-type - MTA type to sending mail. - - 'smtp ... Use smtp.el. - 'sendmail ... Use sendmail.el. - -o gnus-offline-drafts-queue-type - Message queue type when spooling message. - - 'miee ... Use miee.el. - 'agent ... Use gnus-agent.el. - -o gnus-offline-after-empting-spool-hook - Hook before empting spool. - -o gnus-offline-before-empting-spool-hook - Hook after emoting spool. - -o gnus-offline-dialup-function - Function to dialup. - -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. - -o M-x gnus-offline-toggle-plugged - Toggle offline/online state. - -o M-x gnus-offline-toggle-auto-hangup - Change current state to offline. - -o M-x gnus-offline-toggle-on/off-send-mail - Toggle method to sending 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] - - (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.) +1) What's "gnus-offline (Gnus Offline Backend Utility)" ? +========================================================= + +This program is a utility for Semi-gnus that handles messages +(i.e. mail and news) in the "offline" state in a more simple way. + +It is basically designed for "gnus-agent". (See info about gnus-agent.) + +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. + + (*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" configuration to set + the variables. + +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 (*) + + (*) For dialing and hanging up, external softwares are needed. + But you can do without ones if you connect and disconnect + manually. + +This document is written mainly for the case using "gnus-agent" with +gnus-offline.el bundled in Semi-gnus. (*) + + (*) T-gnus is based on the latest test version of Gnus. It is + called Pterodactyl Gnus or pGnus. + Most versions of Semi-gnus other than T-gnus are based on + Gnus version 5.6.xx. + There are a lot of changes between Gnus 5.6.xx and pGnus. + This document will refer to the differences caused by the + changes when it is important. + +2) Installation +=============== + +As you are reading this document, this version of Semi-gnus includes +gnus-offline. Installation is simple. "make install" will +automatically install "gnus-offline". + +If the Semi-gnus comes without gnus-offline, or you want to install +the latest version of gnus-offline, you may manually byte-compile +"gnus-offline.el" and "gnus-ofsetup.el". Make sure they are in one of +the `load-path' directories. + +3) How to use +============= + +o First, you must do a general setup for Semi-gnus (See info about the + setup). + +o Add the following code to ~/.emacs + + (load "gnus-ofsetup") + (gnus-setup-for-offline) + (load gnus-offline-setting-file) + +o Add the following code to ~/.gnus + + (gnus-agentize) + +o Restart Emacs. gnus-ofsetup.el will ask you some questions and + create ~/.gnus-offline.el. (*) + + (*) 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. + +o At the first time, you must start Gnus in the "online" state and + decide which groups to subscribe (See info about subscribing). + +o Add the following code to ~/.gnus + + (gnus-agent-toggle-plugged nil) + +That's all. Restart Gnus and try typing "g" in the *Group* buffer. + +***Note*** + +Most versions of Semi-gnus have pop3-fma.el to operate multiple POP +accounts. T-gnus 6.10.56 or later does not because it can handle +multiple POP accounts itself. + +<<<<>>>> +T-gnus 6.10.56 or later doesn't contain "pop3-fma.el". If you are +updating to T-gnus 6.10.56 or later, remove the setting for +pop3-fma.el (or simply, delete the old ~/.gnus-offline.el). + +[Semi-gnus with pop3-fma.el] +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) + +[T-gnus 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") + : + : + ) + + +4) User customizable variables in gnus-offline +============================================== + +o gnus-offline-dialup-program + Program name to dialup. + +o gnus-offline-dialup-program-arguments + List of dialup program arguments. + +o gnus-offline-hangup-program + Program name to hangup. + +o gnus-offline-hangup-program-arguments + List of hangup program arguments. + +o gnus-offline-mail-spool-directory + Spool directory for sending mail. + This variable is available only using MIEE. + +o gnus-offline-news-spool-directory + Spool directory for sending news. + This variable is available only using MIEE. + +o gnus-offline-mail-treat-environ + If t , gnus-offline sends mail to spool first. + If nil , gnus-offline sends mail immediately. + +o gnus-offline-articles-to-fetch + Article type you want to fetch. + + 'both ... Fetch both Mail/News. + 'Mail ... Fetch only Mail. + 'News ... Fetch only News. + + Default value is both. + +o gnus-offline-load-hook + Hook before gnus-offline load. + +o gnus-offline-before-online-hook + Hook before all online jobs. + +o gnus-offline-after-online-hook + Hook after all online jobs. + +o gnus-offline-interval-time + Interval time to do all online jobs.(minutes) + +o gnus-offline-MTA-type + MTA type to sending mail. + + 'smtp ... Use smtp.el. + 'sendmail ... Use sendmail.el. + +o gnus-offline-drafts-queue-type + Message queue type when spooling message. + + 'miee ... Use miee.el. + 'agent ... Use gnus-agent.el. + +o gnus-offline-after-empting-spool-hook + Hook before empting spool. + +o gnus-offline-before-empting-spool-hook + Hook after emoting spool. + +o gnus-offline-dialup-function + Function to dialup. + +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. + +5) Commands in gnus-offline +=========================== + +o M-x gnus-offline-toggle-plugged + Toggle offline/online state. + +o M-x gnus-offline-toggle-auto-hangup + Change current state to offline. + +o M-x gnus-offline-toggle-on/off-send-mail + Toggle method to sending 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. + +6) [!!!IMPORTANT!!!] About the pop password +=========================================== + +<<<<>>>> +T-gnus 6.10.56 or later doesn't contain "pop3-fma.el". If you are +updating to T-gnus 6.10.56 or later, remove the setting for +pop3-fma.el (or simply, delete the old ~/.gnus-offline.el). + +Under Semi-gnus with pop3-fma.el, you must enter the password for the +pop server every time you accesses the server. (We recommend you do +it.) + +If your machine is stand alone, and nobody else uses it, you can save +the password in some ways. (But, on your own responsibility!) + +--- + +One way is provided by gnus-ofsetup.el. 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. (*) + + (*) Actually the following will be added to ~/.gnus-offline.el. + + [Semi-gnus with pop3-fma.el] + + (add-hook 'gnus-setup-news-hook + (lambda () + (add-to-list 'gnus-variable-list 'pop3-fma-password))) + + [T-gnus 6.10.56 or later] + + (add-hook 'gnus-setup-news-hook + (lambda () + (add-to-list 'gnus-variable-list 'mail-source-password-cache))) + +Answer this question carefully, because the password will NOT be +encoded! + +--- + +There is another way. It will not save the password in a file but keep +it in the memory as a variable. + +For Semi-gnus with pop3-fma.el, add the following code in +~/.gnus-offline.el. + + (setq pop3-fma-save-password-information t) + +In this way, Once you enter the password at the startup of Gnus, it +will be kept as a variable `pop3-fma-password' until you quit Gnus. + +Under T-gnus 6.10.56 or later, the password will be kept as a variable +`mail-source-password-cache' by default. diff --git a/README-offline.ja b/README-offline.ja index 57ac677..100a03e 100644 --- a/README-offline.ja +++ b/README-offline.ja @@ -1,297 +1,281 @@ -1) gnus-offline (Gnus Offline Backend Utility)って何? - -これは Semi-gnus でメッセージをより容易にオフライン環境で扱うためのユー -ティリティです。 - -主として Semi-gnus の `Agent' と呼ばれる機能のために書か -れています。 - -また、gnspool などの外部プログラムを用いた nnspool でも使うことができま -す。また、別途配布の Miee.el を送信に使用することも可能です。 - -;; gnus-offline を使わなくてもオフラインでの読み書きは出来ますが、 -;; gnus-offline を使えばより設定・操作が簡単に出来ます。 - -具体的には - -・動作に必要な変数の対話的設定が可能 - -・グループバッファで“g”とタイプするだけで ダイアルアップ->メイルおよび -ネットニュースの送受信->ダイアルアップの切断 という動作を一気に行うこと -が可能になります。(ただし接続・および切断は別途専用のツールが必要です) - -なお、このドキュメントでは主に T-gnus 6.10.56 以降のバージョンに附属する -gnus-offline.elについて、送受信ともに gnus-agent を使うことを前提に解説 -します。(古いバージョンとは異なる部分がありますのでご注意ください) - -2) インストール - -T-gnus をお使いの場合、gnus-offline.el は特に何も考えなくても T-gnus と -同時にインストールされます。そうでない場合は load-path の通ったディレク -トリに gnus-offline.el と gnus-ofsetup.el を(バイトコンパイルして)置きま -す。 - -3) 使い方 - -・Semi-gnus の一般的な使用方法について info などで調べて設定してください。 - -・以下のコードを .emacs に加えます。 - - (load "gnus-ofsetup") - (gnus-setup-for-offline) - (load gnus-offline-setting-file) - -・以下のコードを .gnus に加えます。 - - (gnus-agentize) - -・Emacs を再起動します。すると、gnus-ofsetup.el が起動しますので、対話的 -に必要な変数の設定を行います。(何を入力したらいいかわからない場合は 4) -を参照するか、TAB で入力可能な候補を一覧表示させるかしてください)すべて -設定するとホームディレクトリに .gnus-offline.el というファイルが出来上が -ります。 - -・このあと一旦オンラインでサーバーに接続して、購読するグループを決めてく -ださい。(詳しい方法は Gnus の info を見てください) - -・.gnus に以下のコードを加えます。 - -(gnus-agent-toggle-plugged nil) - -これで Gnus を再起動すればグループバッファで“g”とタイプすることにより -前記の動作をするはずです。 - - -また、T-gnus 6.10.56 以降のものでは Gnus 自体が複数のメイルアカウントを -扱えます。(6.10.55 以前の T-gnus でも同梱の 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) - ("po:アカウント2@popサーバ2" pass) - : - : - )) -・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 で設定可能な変数一覧 - -・gnus-offline-dialup-program - ダイアルアップするプログラム名 - -・gnus-offline-dialup-program-arguments - ダイアルアッププログラムの引数のリスト - 例えば、gnus-offline-dialup-program に "-s AAA" を渡す場合は - (setq gnus-offline-dialup-program-arguments '("-s" "AAA")) - と記述してください。 - -・gnus-offline-hangup-program - 回線を切断するプログラム名 - -・gnus-offline-hangup-program-arguments - 切断するプログラムの引数のリスト - 例えば、gnus-offline-hangup-program に "-s AAA" を渡す場合は - (setq gnus-offline-hangup-program-arguments '("-s" "AAA")) - と記述してください。 - -・gnus-offline-mail-spool-directory - 送信メールのスプールディレクトリ - Offline 状態で Mail を送信すると一旦ここで指定したディレクトリに保存され - ます。 - MIEE を使用する場合以外無効です。 - -・gnus-offline-news-spool-directory - 送信ニュースのスプールディレクトリ - Offline 状態で News を送信すると一旦ここで指定したディレクトリに保存され - ます。 - MIEE を使用する場合以外無効です。 - -・gnus-offline-mail-treat-environ - Mail の送信を Online/Offline で行う事を切り替える - -・gnus-offline-articles-to-fetch - fetch する記事を切り替える both->mail->news->both... - 'both ... Mail/News を両方受信 - 'Mail ... Mail だけ受信 - 'News ... News だけ受信 - デフォルト値は 'both です。 - -・gnus-offline-popup-menu - メニューを使うかどうかを指定します。デフォルトは "t" です。 - -・gnus-offline-load-hook - gnus-offline が load されるときに評価される hook - -・gnus-offline-before-online-hook - Online job 直前に評価される hook - -・gnus-offline-after-online-hook - Online job 終了直前に評価される hook - -・gnus-offline-interval-time - Online job を行う間隔(分) - Emacs が idle 状態になってからここで指定した時間毎に Online 状態にし - Mail/News を取得します。 - -・gnus-offline-MTA-type - Message を Online 時に送信するプログラムのタイプで、デフォルトは 'smtp - です。 - 'smtp ... smtp.el を使用 - 'sendmail ... sendmail.el を使用 - -・gnus-offline-drafts-queue-type - 送信メッセージをキューに溜めるもののタイプで、デフォルトは 'miee です。 - 'miee は miee.el を使用. - 'agent は gnus-agent.el を使用. - -・gnus-offline-after-empting-spool-hook - 送信メッセージのキューを空にする前に評価される hook - -・gnus-offline-before-empting-spool-hook - 送信メッセージを送信後に、空になった後評価される hook - -・gnus-offline-dialup-function - 接続に使用する関数名 - -・gnus-offline-hangup-function - 切断に使用する関数名 - -・gnus-offline-mail-source - メールサーバー、ユーザー名のリスト - -・gnus-offline-pop-password-file - ユーザー名、メールサーバー、パスワードを保存するためのファイル名 - -・gnus-offline-pop-password-decoding-function - パスワードを保存する際の暗号化を行うための関数。 - -4) gnus-offline M-x で実行可能なコマンド一覧 - -・M-x gnus-offline-toggle-plugged - offline 状態/Online 状態を切替えます。 - -・M-x gnus-offline-toggle-auto-hangup - offline 状態にします。 - -・M-x gnus-offline-toggle-on/off-send-mail - Online 状態/Offline 状態での Mail 送信状態を切替えます。 - Online 状態では直接送信しますが、Offline 状態では一旦 spool に書き込み、 - "g" を押した時に全部送信されます。 - -・M-x gnus-offline-toggle-articles-to-fetch - 取得する記事を選択します。both -> mail -> news -> both ... のように - 切り替わります。 - -・M-x gnus-offline-toggle-movemail-program - movemail プログラムを切替えます。 - -・M-x gnus-offline-set-interval-time - 記事/Mail の取得、送信を自動的に行う間隔(分)を設定します。 - この間隔は Emacs が Idle になってからの時間です。 - -・M-x gnus-offline-agent-expire - 既読の記事を expire します。 - - -5)【!!!重要!!!】 pop パスワードの管理方法について - -;;;バージョンにより異なる部分が多いのでご注意ください。またこの部分は今 -;;;後も改訂されることが予想されます。 - -<<<<<< 注意 >>>>>>>>>>> -T-gnus 6.10.56 以降のバージョンを使用する方は pop3-fma.el は含まれていま -せん。Gnus が複数の POP3 アカウントを扱えるようになりましたので、 -バージョンアップされる際は既存の pop3-fma.el の設定は外してください。 - -T-gnus 6.10.55 以前のデフォルトでは pop サーバのパスワードは pop サーバー -にアクセスする度に入力する必要があります。(基本的にこのままにしておくこ -とを推奨します) - -しかし、「これだと面倒だしどうせ自分一人しか使わないコンピュータだからそ -れほどパスワードの管理には注意を払う必要がない」という場合にはいくつかの -(手間を省く)方法があります。ただし、当然パスワードを盗まれる危険は増しま -すので以下の方法のいずれかを実行する際には 100% 自己の責任のもとで行って -ください。 - -まず、パスワードをファイルに残しては置きたくないがメモリ上に変数として残っ -ていても構わない、という場合は、~/.gnus-offline.el に以下のようなコード -を加えてください。 - -(setq pop3-fma-save-password-information t) - -こうすることにより、パスワードは Gnus 起動時に入力するだけになります。 -(T-gnus 6.10.56 以降のバージョンを使用する方は特に設定しなくてもこれと同 -じ状態がデフォルトになっています。) - - -また、ファイルに残しても構わないがメモリ上の変数として残したくない場合、 -または全くパスワードの入力を省きたい場合は、.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 でエンコードすることをお勧めします。その為には - - M-: (base64-encode-region (point-min) (point-max)) - -のようにします(M-: は通常 eval-expression に割りあてられています)。 -もしここでエンコードしなかったならば、~/.gnus-offline.el に - - (setq gnus-offline-pop-password-decoding-function nil) - -と書きます。(ただしこれは非常に危険です。) - ~~~~~~~~~~~~~~~~~~~~~~~~~~ - -;;; なお、T-gnus 6.10.57 以降では 初回起動時の gnus-ofsetup.el による変 -;;; 数設定の際、(=~/.gnus-offline.el がないとき)パスワードを -;;; ~/.newsrc.eld に保存するかどうか質問され、“y”と答えると保存される -;;; ようになります。ただしこの場合は保存されるパスワードは平文のままなの -;;; でかなり危険であることをご承知のうえお使いください。(上記の方法も使 -;;; えます) +1) gnus-offline (Gnus Offline Backend Utility)って何? + +これは Semi-gnus でメッセージをより容易にオフライン環境で扱うためのユー +ティリティです。 + +主として Semi-gnus の `Agent' と呼ばれる機能のために書か +れています。 + +また、gnspool などの外部プログラムを用いた nnspool でも使うことができま +す。また、別途配布の miee.el を送信に使用することも可能です。 + + (*) nspool については info を参照してください。 + (*) gnspool は gn というニュースリーダーと共に配布されています。 + (*) miee.el の最新版は以下の場所から取得できます。 + http://www.shiojiri.ne.jp/%7Et-ichi/meadow.html + +;; gnus-offline を使わなくてもオフラインでの読み書きは出来ますが、 +;; gnus-offline を使えばより設定・操作が簡単に出来ます。 + +具体的には + +・動作に必要な変数の対話的設定が可能 + +・グループバッファで“g”とタイプするだけで ダイアルアップ->メイルおよび +ネットニュースの送受信->ダイアルアップの切断 という動作を一気に行うこと +が可能になります。(ただし接続・および切断は別途専用のツールが必要です) + +なお、このドキュメントでは主に T-gnus 6.10.56 以降のバージョンに附属する +gnus-offline.elについて、送受信ともに gnus-agent を使うことを前提に解説 +します。 (*) + + (*) T-gnus は Gnus のテストバージョンをベースにしています。これは + Pterodactyl Gnus または pGnus と呼ばれています。 + 一方 Semi-gnus の多くのバージョンは Gnus 5.6 系列をベースにし + ています。 + 両者では gnus-offline の設定において異なる部分があります。 + この文書では必要に応じ、これらの違いについて説明しています。 + +2) インストール + +T-gnus をお使いの場合、gnus-offline.el は特に何も考えなくても T-gnus と +同時にインストールされます。そうでない場合は load-path の通ったディレク +トリに gnus-offline.el と gnus-ofsetup.el を(バイトコンパイルして)置きま +す。 + +3) 使い方 + +・Semi-gnus の一般的な使用方法について info などで調べて設定してください。 + +・以下のコードを .emacs に加えます。 + + (load "gnus-ofsetup") + (gnus-setup-for-offline) + (load gnus-offline-setting-file) + +・以下のコードを .gnus に加えます。 + + (gnus-agentize) + +・Emacs を再起動します。すると、gnus-ofsetup.el が起動しますので、対話的 +に必要な変数の設定を行います。(何を入力したらいいかわからない場合は 4) +を参照するか、TAB で入力可能な候補を一覧表示させるかしてください)すべて +設定するとホームディレクトリに .gnus-offline.el というファイルが出来上が +ります。(*) + + (*) 「POP パスワードを ~/.newsrc.eld に保存するかどうか」質問され + ます。れにはよく考慮した上で答えてください。詳しくは 6) を参照 + して下さい。 + +・このあと一旦オンラインでサーバーに接続して、購読するグループを決めてく +ださい。(詳しい方法は Gnus の info を見てください) + +・.gnus に以下のコードを加えます。 + +(gnus-agent-toggle-plugged nil) + +これで Gnus を再起動すればグループバッファで“g”とタイプすることにより +前記の動作をするはずです。 + + +また、T-gnus 6.10.56 以降のものでは Gnus 自体が複数のメイルアカウントを +扱えます。(6.10.55 以前の T-gnus でも同梱の pop3-fma.el を用いても複数の +メイルアカウントを管理することが出来ます。) + +<<<<<< 注意 >>>>>>>>>>> + +T-gnus 6.10.56 以降のバージョンには pop3-fma.el は含まれていません。バー +ジョンアップされた方は既存の pop3-fma.el の設定は外してください。 +(既存の .gnus-offline.el を消すのがもっとも簡単です) + +【Semi-gnus + pop3-fma.el】 +・pop3-fma-spool-file-alist +　　　　'( + ("po:アカウント1@popサーバ1" pass) + ("po:アカウント2@popサーバ2" pass) + : + : + )) +・pop3-fma-movemail-type + メイル受信に movemail.exe を使う('exe)か pop3.el('lisp) を使うか。 + +【T-gnus 6.10.56〜】 +代わりに以下のような設定がされます。 + +・gnus-offline-mail-source '( + (pop :user "manbou" :server "pop.ceres.dti.ne.jp") + (pop :user "imp9397" :server "mvb.biglobe.ne.jp") +　　　　…………………… + ) + +4) gnus-offline で設定可能な変数一覧 + +・gnus-offline-dialup-program + ダイアルアップするプログラム名 + +・gnus-offline-dialup-program-arguments + ダイアルアッププログラムの引数のリスト + 例えば、gnus-offline-dialup-program に "-s AAA" を渡す場合は + (setq gnus-offline-dialup-program-arguments '("-s" "AAA")) + と記述してください。 + +・gnus-offline-hangup-program + 回線を切断するプログラム名 + +・gnus-offline-hangup-program-arguments + 切断するプログラムの引数のリスト + 例えば、gnus-offline-hangup-program に "-s AAA" を渡す場合は + (setq gnus-offline-hangup-program-arguments '("-s" "AAA")) + と記述してください。 + +・gnus-offline-mail-spool-directory + 送信メールのスプールディレクトリ + Offline 状態で Mail を送信すると一旦ここで指定したディレクトリに保存され + ます。 + MIEE を使用する場合以外無効です。 + +・gnus-offline-news-spool-directory + 送信ニュースのスプールディレクトリ + Offline 状態で News を送信すると一旦ここで指定したディレクトリに保存され + ます。 + MIEE を使用する場合以外無効です。 + +・gnus-offline-mail-treat-environ + Mail の送信を Online/Offline で行う事を切り替える + +・gnus-offline-articles-to-fetch + fetch する記事を切り替える both->mail->news->both... + 'both ... Mail/News を両方受信 + 'Mail ... Mail だけ受信 + 'News ... News だけ受信 + デフォルト値は 'both です。 + +・gnus-offline-load-hook + gnus-offline が load されるときに評価される hook + +・gnus-offline-before-online-hook + Online job 直前に評価される hook + +・gnus-offline-after-online-hook + Online job 終了直前に評価される hook + +・gnus-offline-interval-time + Online job を行う間隔(分) + Emacs が idle 状態になってからここで指定した時間毎に Online 状態にし + Mail/News を取得します。 + +・gnus-offline-MTA-type + Message を Online 時に送信するプログラムのタイプで、デフォルトは 'smtp + です。 + 'smtp ... smtp.el を使用 + 'sendmail ... sendmail.el を使用 + +・gnus-offline-drafts-queue-type + 送信メッセージをキューに溜めるもののタイプで、デフォルトは 'miee です。 + 'miee は miee.el を使用. + 'agent は gnus-agent.el を使用. + +・gnus-offline-after-empting-spool-hook + 送信メッセージのキューを空にする前に評価される hook + +・gnus-offline-before-empting-spool-hook + 送信メッセージを送信後に、空になった後評価される hook + +・gnus-offline-dialup-function + 接続に使用する関数名 + +・gnus-offline-hangup-function + 切断に使用する関数名 + +・gnus-offline-mail-source + メールサーバー、ユーザー名のリスト + +・gnus-offline-pop-password-file + ユーザー名、メールサーバー、パスワードを保存するためのファイル名 + +・gnus-offline-pop-password-decoding-function + パスワードを保存する際の暗号化を行うための関数。 + +5) gnus-offline M-x で実行可能なコマンド一覧 + +・M-x gnus-offline-toggle-plugged + offline 状態/Online 状態を切替えます。 + +・M-x gnus-offline-toggle-auto-hangup + offline 状態にします。 + +・M-x gnus-offline-toggle-on/off-send-mail + Online 状態/Offline 状態での Mail 送信状態を切替えます。 + Online 状態では直接送信しますが、Offline 状態では一旦 spool に書き込み、 + "g" を押した時に全部送信されます。 + +・M-x gnus-offline-toggle-articles-to-fetch + 取得する記事を選択します。both -> mail -> news -> both ... のように + 切り替わります。 + +・M-x gnus-offline-toggle-movemail-program + movemail プログラムを切替えます。 + +・M-x gnus-offline-set-interval-time + 記事/Mail の取得、送信を自動的に行う間隔(分)を設定します。 + この間隔は Emacs が Idle になってからの時間です。 + +・M-x gnus-offline-agent-expire + 既読の記事を expire します。 + + +6)【!!!重要!!!】 pop パスワードの管理方法について + +;;;バージョンにより異なる部分が多いのでご注意ください。またこの部分は今 +;;;後も改訂されることが予想されます。 + +<<<<<< 注意 >>>>>>>>>>> +T-gnus 6.10.56 以降のバージョンを使用する方は pop3-fma.el は含まれていま +せん。Gnus が複数の POP3 アカウントを扱えるようになりましたので、 +バージョンアップされる際は既存の pop3-fma.el の設定は外してください。 + +Semi-gnus + pop3-fma.el では、デフォルトでは pop サーバのパスワードは +pop サーバーにアクセスする度に入力する必要があります。(基本的にこのまま +にしておくことを推奨します) + +しかし、「これだと面倒だしどうせ自分一人しか使わないコンピュータだからそ +れほどパスワードの管理には注意を払う必要がない」という場合にはいくつかの +(手間を省く)方法があります。ただし、当然パスワードを盗まれる危険は増しま +すので以下の方法のいずれかを実行する際には 100% 自己の責任のもとで行って +ください。 + +<方法1> +初回起動時の gnus-ofsetup.el による変数設定の際、(=~/.gnus-offline.el が +ないとき)パスワードを ~/.newsrc.eld に保存するかどうか質問され、“y”と +答えると保存されるようになります。 (*) + + (*) 実際には ~/.gnus-offline.el に以下のコードが追加されます。 + + 【Semi-gnus + pop3-fma.el】 + + (add-hook 'gnus-setup-news-hook + (lambda () + (add-to-list 'gnus-variable-list 'pop3-fma-password))) + + 【T-gnus 6.10.56 以降】 + + (add-hook 'gnus-setup-news-hook + (lambda () + (add-to-list 'gnus-variable-list 'mail-source-password-cache))) + +ただしこの場合は保存されるパスワードは平文のままなのでかなり危険であるこ +とをご承知のうえお使いください。 + +<方法2> +パスワードをファイルに残しては置きたくないがメモリ上に変数として残っ +ていても構わない、という場合は、~/.gnus-offline.el に以下のようなコード +を加えてください。 + +(setq pop3-fma-save-password-information t) + +こうすることにより、パスワードは Gnus 起動時に入力するだけになります。 +パスワードは pop3-fma-password という変数として保持されます。 + +T-gnus 6.10.56 以降のバージョンを使用する方は特に設定しなくてもこれと同 +じ状態がデフォルトになっています。パスワードは mail-source-password-cache +という変数に保持されます。 diff --git a/lisp/gnus.el b/lisp/gnus.el index b73066e..8bf92cb 100644 --- a/lisp/gnus.el +++ b/lisp/gnus.el @@ -267,7 +267,7 @@ is restarted, and sometimes reloaded." (defconst gnus-version-number "6.10.057" "Version number for this version of gnus.") -(defconst gnus-revision-number "03" +(defconst gnus-revision-number "04" "Revision number for this version of gnus.") (defconst gnus-original-version-number "0.75" diff --git a/lisp/nntp.el b/lisp/nntp.el index ee68191..e60dd86 100644 --- a/lisp/nntp.el +++ b/lisp/nntp.el @@ -220,7 +220,7 @@ noticing asynchronous data.") (defvar nntp-async-process-list nil) (eval-and-compile - (autoload 'nnmail-read-passwd "nnmail") + (autoload 'mail-source-read-passwd "mail-source") (autoload 'open-ssl-stream "ssl")) @@ -800,7 +800,7 @@ If SEND-IF-FORCE, only send authinfo to the server if the (or passwd nntp-authinfo-password (setq nntp-authinfo-password - (nnmail-read-passwd (format "NNTP (%s@%s) password: " + (mail-source-read-passwd (format "NNTP (%s@%s) password: " user nntp-address)))))))))) (defun nntp-send-nosy-authinfo () @@ -810,7 +810,7 @@ If SEND-IF-FORCE, only send authinfo to the server if the (nntp-send-command "^3.*\r?\n" "AUTHINFO USER" user) (when t ;???Should check if AUTHINFO succeeded (nntp-send-command "^2.*\r?\n" "AUTHINFO PASS" - (nnmail-read-passwd "NNTP (%s@%s) password: " + (mail-source-read-passwd "NNTP (%s@%s) password: " user nntp-address)))))) (defun nntp-send-authinfo-from-file () @@ -1278,7 +1278,7 @@ password contained in '~/.nntp-authinfo'." proc (concat (or nntp-telnet-passwd (setq nntp-telnet-passwd - (nnmail-read-passwd "Password: "))) + (mail-source-read-passwd "Password: "))) "\n")) (erase-buffer) (nntp-wait-for-string nntp-telnet-shell-prompt) -- 1.7.10.4