From 5181f687d80851e743b7327c845aa3e7ddb585f6 Mon Sep 17 00:00:00 2001 From: czkmt Date: Thu, 18 Feb 1999 20:30:25 +0000 Subject: [PATCH] * README-offline.en: Update. * README-offline.ja: Fix typo. * lisp/gnus-ofsetup.el (gnus-setup-for-offline): Set `gnus-offline-hangup-program' and `gnus-offline-dialup-program' to nil when null string is given. --- ChangeLog | 12 +- README-offline.en | 567 +++++++++++++++++++++++++------------------------- README-offline.ja | 562 ++++++++++++++++++++++++------------------------- lisp/gnus-ofsetup.el | 7 +- 4 files changed, 580 insertions(+), 568 deletions(-) diff --git a/ChangeLog b/ChangeLog index b5551b2..9a54b07 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,8 +1,18 @@ +1999-02-18 Tsukamoto Tetsuo + + * README-offline.en: Update. + + * README-offline.ja: Fix typo. + + * lisp/gnus-ofsetup.el (gnus-setup-for-offline): Set + `gnus-offline-hangup-program' and `gnus-offline-dialup-program' to + nil when null string is given. + 1999-02-18 Tatsuya Ichikawa * texi/Makefile.in: Change to work on Windows environment and other platforms. - + 1999-02-17 Katsumi Yamaoka * lisp/dgnushack.el (dgnushack-make-package): Fix typo. diff --git a/README-offline.en b/README-offline.en index cd36cff..c523d57 100644 --- a/README-offline.en +++ b/README-offline.en @@ -1,283 +1,284 @@ -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. +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 T-gnus 6.10.056 or later, and Semi-gnus +6.10.1 or later. (*) + + (*) 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 100a03e..cf34462 100644 --- a/README-offline.ja +++ b/README-offline.ja @@ -1,281 +1,281 @@ -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 -という変数に保持されます。 +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 以降および Semi-gnus +6.10.1 以降に附属する 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-ofsetup.el b/lisp/gnus-ofsetup.el index 5f5cf25..4786d4e 100644 --- a/lisp/gnus-ofsetup.el +++ b/lisp/gnus-ofsetup.el @@ -1,6 +1,6 @@ ;;; gnus-ofsetup.el --- Setup advisor for Offline reading for Mail/News. ;;; -;;; $Id: gnus-ofsetup.el,v 1.1.4.5 1999-02-15 06:31:58 ichikawa Exp $ +;;; $Id: gnus-ofsetup.el,v 1.1.4.6 1999-02-18 20:30:25 czkmt Exp $ ;;; ;;; Copyright (C) 1998 Tatsuya Ichikawa ;;; Author: Tatsuya Ichikawa @@ -88,7 +88,7 @@ nil t nil)) (mail-method 'nnmail) (program - (read-file-name "Dialup/Hangup program(type nil you do not use): ")) + (read-file-name "Dialup/Hangup program(type nil or null string you do not use): ")) (mta-type (completing-read "Select MTA type for sending mail (TAB to completion): " @@ -110,7 +110,8 @@ (setq gnus-offline-use-miee use-miee) ;; Set programs. - (if (string-equal program "nil") + (if (or (string-equal program "nil") + (string-equal program "")) (progn (setq gnus-offline-hangup-program nil) (setq gnus-offline-dialup-program nil)) -- 1.7.10.4