X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README-offline.en;h=65af7ee7a31b3684985e121939320458054825c4;hb=1e40a94293695509bc2f5b9a236f56f0d96a3998;hp=d889e94847eeb4289c3df12a5fd5280277558e4d;hpb=083263b7e6ec175e1f79dfbda820876c5387b5ed;p=elisp%2Fgnus.git- diff --git a/README-offline.en b/README-offline.en index d889e94..65af7ee 100644 --- a/README-offline.en +++ b/README-offline.en @@ -1,7 +1,7 @@ 1) What's "gnus-offline (Gnus Offline Backend Utility)" ? ========================================================= -This program is a utility for Semi-gnus that handles messages +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 is basically designed for "gnus-agent". (See info about gnus-agent.) @@ -23,7 +23,7 @@ but "gnus-offline" provides a simple way for setup and operation. o Simple configuration -- An "INTERACTIVE" configuration to set the variables. -o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline +o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline will: o Dial (*) o Send mails & post news articles @@ -35,40 +35,30 @@ o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline 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. +gnus-offline.el bundled in T-gnus 6.12.0 or later. 2) Installation =============== -As you are reading this document, this version of Semi-gnus includes +As you are reading this document, this version of T-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 First, you must do a general setup for T-gnus (See info about the + setup). + +o Add the following code to ~/.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 the following code to ~/.gnus @@ -84,52 +74,25 @@ o Restart Emacs. gnus-ofsetup.el will ask you some questions and ~/.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. +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). -<<<<>>>> -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). + From now on you can start Gnus as an offline reader by M-x gnus-unplugged. + Try typing "g" in the *Group* buffer. -[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) +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 -[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") - : - : - ) + (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). 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 @@ -182,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. @@ -198,12 +161,6 @@ 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. - 5) Commands in gnus-offline =========================== @@ -219,9 +176,6 @@ 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. @@ -231,55 +185,19 @@ o M-x gnus-offline-agent-expire 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!) +the password. (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. (*) +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 () - (setq pop3-fma-save-password-information t) - (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))) + (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.