* README-offline.en: New description.
* README-offline.ja: Ditto.
+1999-02-04 Katsumi Yamaoka <yamaoka@jpl.org>
+
+ * lisp/gnus.el (gnus-revision-number): Increment to 02.
+
+1999-02-04 YOSHIZAWA Masahiro <manbou@ceres.dti.ne.jp>
+
+ * README-offline.en: New description.
+ * README-offline.ja: Ditto.
+
1999-02-03 Tatsuya Ichikawa <t-ichi@po.shiojiri.ne.jp>
-
+
* 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 <t-ichi@po.shiojiri.ne.jp>
* lisp/gnus.el (gnus-revision-number): New constant.
-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.
+
+<<<<<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 settings.(most simple way is deleting old ~/.gnus-offline.el.)
+
+[6.10.55 or older]
+o pop3-fma-spool-file-alist
+\e$B!!!!!!!!\e(B'(
+ ("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-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.
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.)
\e$B%M%C%H%K%e!<%9$NAw<u?.\e(B->\e$B%@%$%"%k%"%C%W$N@ZCG\e(B \e$B$H$$$&F0:n$r0l5$$K9T$&$3$H\e(B
\e$B$,2DG=$K$J$j$^$9!#\e(B(\e$B$?$@$7@\B3!&$*$h$S@ZCG$OJLES@lMQ$N%D!<%k$,I,MW$G$9\e(B)
-\e$B$J$*!"$3$N%I%-%e%a%s%H$G$OAw<u?.$H$b$K\e(B gnus-agent \e$B$r;H$&$3$H$rA0Ds$K2r@b\e(B
-\e$B$7$^$9!#\e(B
+\e$B$J$*!"$3$N%I%-%e%a%s%H$G$O<g$K\e(B T-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$KImB0$9$k\e(B
+gnus-offline.el\e$B$K$D$$$F!"Aw<u?.$H$b$K\e(B gnus-agent \e$B$r;H$&$3$H$rA0Ds$K2r@b\e(B
+\e$B$7$^$9!#\e(B(\e$B8E$$%P!<%8%g%s$H$O0[$J$kItJ,$,$"$j$^$9$N$G$4Cm0U$/$@$5$$\e(B)
2) \e$B%$%s%9%H!<%k\e(B
\e$BA05-$NF0:n$r$9$k$O$:$G$9!#\e(B
-\e$B"!$^$?!"F1:-$N\e(B pop3-fma.el \e$B$rMQ$$$k$HJ#?t$N%a%$%k%"%+%&%s%H$r4IM}$9$k$3\e(B
-\e$B$H$,=PMh$^$9!#\e(B
+\e$B$^$?!"\e(BT-gnus 6.10.56 \e$B0J9_$N$b$N$G$O\e(B Gnus \e$B<+BN$,J#?t$N%a%$%k%"%+%&%s%H$r\e(B
+\e$B07$($^$9!#\e(B(6.10.55 \e$B0JA0$N\e(B T-gnus \e$B$G$bF1:-$N\e(B pop3-fma.el \e$B$rMQ$$$F$bJ#?t$N\e(B
+\e$B%a%$%k%"%+%&%s%H$r4IM}$9$k$3$H$,=PMh$^$9!#\e(B)
-<<<<<< \e$BCm0U\e(B >>>>>>>>>>>
-\e$B$?$@$7!"\e(BT-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$r;HMQ$9$kJ}$O\e(B pop3-fma.el \e$B$O4^$^\e(B
-\e$B$l$F$$$^$;$s!#\e(BGnus \e$B$,J#?t$N\e(B POP3 \e$B%"%+%&%s%H$r07$($k$h$&$K$J$j$^$7$?$N$G!"\e(B
-pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\e(B
+<<<<<< \e$BCm0U\e(B >>>>>>>>>>>
+
+T-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$K$O\e(B pop3-fma.el \e$B$O4^$^$l$F$$$^$;$s!#%P!<\e(B
+\e$B%8%g%s%"%C%W$5$l$?J}$O4{B8$N\e(B pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\e(B
+(\e$B4{B8$N\e(B .gnus-offline.el \e$B$r>C$9$N$,$b$C$H$b4JC1$G$9\e(B)
+\e$B!Z!A\e(B6.10.55\e$B![\e(B
\e$B!&\e(Bpop3-fma-spool-file-alist
\e$B!!!!!!!!\e(B'(
("po:\e$B%"%+%&%s%H\e(B1@pop\e$B%5!<%P\e(B1" pass)
\e$B!&\e(Bpop3-fma-movemail-type
\e$B%a%$%k<u?.$K\e(B movemail.exe \e$B$r;H$&\e(B('exe)\e$B$+\e(B pop3.el('lisp) \e$B$r;H$&$+!#\e(B
+\e$B!Z\e(B6.10.56\e$B!A![\e(B
+\e$BBe$o$j$K0J2<$N$h$&$J@_Dj$,$5$l$^$9!#\e(B
+
+\e$B!&\e(Bgnus-offline-mail-source '(
+ (pop :user "manbou" :server "pop.ceres.dti.ne.jp")
+ (pop :user "imp9397" :server "mvb.biglobe.ne.jp")
+\e$B!!!!!!!!!D!D!D!D!D!D!D!D\e(B
+ )
3) gnus-offline \e$B$G@_Dj2DG=$JJQ?t0lMw\e(B
\e$B!&\e(Bgnus-offline-hangup-function
\e$B@ZCG$K;HMQ$9$k4X?tL>\e(B
+\e$B!&\e(Bgnus-offline-mail-source
+ \e$B%a!<%k%5!<%P!<!"%f!<%6!<L>$N%j%9%H\e(B
+
\e$B!&\e(Bgnus-offline-pop-password-file
\e$B%f!<%6!<L>!"%a!<%k%5!<%P!<!"%Q%9%o!<%I$rJ]B8$9$k$?$a$N%U%!%$%kL>\e(B
5)\e$B!Z\e(B!!!\e$B=EMW\e(B!!!\e$B![\e(B pop \e$B%Q%9%o!<%I$N4IM}J}K!$K$D$$$F\e(B
+
+;;;\e$B%P!<%8%g%s$K$h$j0[$J$kItJ,$,B?$$$N$G$4Cm0U$/$@$5$$!#$^$?$3$NItJ,$O:#\e(B
+;;;\e$B8e$b2~D{$5$l$k$3$H$,M=A[$5$l$^$9!#\e(B
+
<<<<<< \e$BCm0U\e(B >>>>>>>>>>>
-\e$B$?$@$7!"\e(BT-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$r;HMQ$9$kJ}$O\e(B pop3-fma.el \e$B$O4^$^\e(B
-\e$B$l$F$$$^$;$s!#\e(BGnus \e$B$,J#?t$N\e(B POP3 \e$B%"%+%&%s%H$r07$($k$h$&$K$J$j$^$7$?$N$G!"\e(B
-pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\e(B
+T-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$r;HMQ$9$kJ}$O\e(B pop3-fma.el \e$B$O4^$^$l$F$$$^\e(B
+\e$B$;$s!#\e(BGnus \e$B$,J#?t$N\e(B POP3 \e$B%"%+%&%s%H$r07$($k$h$&$K$J$j$^$7$?$N$G!"\e(B
+\e$B%P!<%8%g%s%"%C%W$5$l$k:]$O4{B8$N\e(B pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\e(B
-\e$B%G%U%)%k%H$G$O\e(B pop \e$B%5!<%P$N%Q%9%o!<%I$O\e(B pop \e$B%5!<%P!<$K%"%/%;%9$9$kEY$KF~\e(B
-\e$BNO$9$kI,MW$,$"$j$^$9!#\e(B(\e$B4pK\E*$K$3$N$^$^$K$7$F$*$/$3$H$r?d>)$7$^$9\e(B)
+T-gnus 6.10.55 \e$B0JA0$N%G%U%)%k%H$G$O\e(B pop \e$B%5!<%P$N%Q%9%o!<%I$O\e(B pop \e$B%5!<%P!<\e(B
+\e$B$K%"%/%;%9$9$kEY$KF~NO$9$kI,MW$,$"$j$^$9!#\e(B(\e$B4pK\E*$K$3$N$^$^$K$7$F$*$/$3\e(B
+\e$B$H$r?d>)$7$^$9\e(B)
\e$B$7$+$7!"!V$3$l$@$HLLE]$@$7$I$&$;<+J,0l?M$7$+;H$o$J$$%3%s%T%e!<%?$@$+$i$=\e(B
\e$B$l$[$I%Q%9%o!<%I$N4IM}$K$OCm0U$rJ'$&I,MW$,$J$$!W$H$$$&>l9g$K$O$$$/$D$+$N\e(B
\e$B$9$N$G0J2<$NJ}K!$N$$$:$l$+$r<B9T$9$k:]$K$O\e(B 100% \e$B<+8J$N@UG$$N$b$H$G9T$C$F\e(B
\e$B$/$@$5$$!#\e(B
-
\e$B$^$:!"%Q%9%o!<%I$r%U%!%$%k$K;D$7$F$OCV$-$?$/$J$$$,%a%b%j>e$KJQ?t$H$7$F;D$C\e(B
\e$B$F$$$F$b9=$o$J$$!"$H$$$&>l9g$O!"\e(B~/.gnus-offline.el \e$B$K0J2<$N$h$&$J%3!<%I\e(B
\e$B$r2C$($F$/$@$5$$!#\e(B
(setq pop3-fma-save-password-information t)
\e$B$3$&$9$k$3$H$K$h$j!"%Q%9%o!<%I$O\e(B Gnus \e$B5/F0;~$KF~NO$9$k$@$1$K$J$j$^$9!#\e(B
+(T-gnus 6.10.56 \e$B0J9_$N%P!<%8%g%s$r;HMQ$9$kJ}$OFC$K@_Dj$7$J$/$F$b$3$l$HF1\e(B
+\e$B$8>uBV$,%G%U%)%k%H$K$J$C$F$$$^$9!#\e(B)
+
\e$B$^$?!"%U%!%$%k$K;D$7$F$b9=$o$J$$$,%a%b%j>e$NJQ?t$H$7$F;D$7$?$/$J$$>l9g!"\e(B
-\e$B$^$?$OA4$/%Q%9%o!<%I$NF~NO$r>J$-$?$$>l9g$O!"\e(B.gnus-offline.el \e$B$K0J2<$N$h\e(B
-\e$B$&$J%3!<%I$r2C$(!"%Q%9%o!<%I%U%!%$%k$r;XDj$7$^$9!#\e(B
+\e$B$^$?$OA4$/%Q%9%o!<%I$NF~NO$r>J$-$?$$>l9g$O!"\e(B.gnus-offline.el \e$B$N\e(B
+\e$B0J2<$N$h$&$J%3!<%I$r2C$(!"%Q%9%o!<%I%U%!%$%k$r\e(B
+\e$B;XDj$7$^$9!#\e(B
(setq gnus-offline-pop-password-file "~/.pop.passwd")
+\e$B$^$?!"\e(BT-gnus 6.10.56 \e$B0J9_$N>l9g$O0J2<$r%3%a%s%H%"%&%H$7$^$9!#\e(B
+(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)
+
+
\e$B;XDj$7$?%Q%9%o!<%I%U%!%$%k\e(B(\e$B$3$NNc$G$O\e(B~/.pop.passwd)\e$B$r:n@.$7!"%Q%9%o!<%I\e(B
\e$B$N>pJs$r0J2<$N$h$&$J7A<0$G=q$-$^$9!#\e(B
+\e$B!Z\e(BT-gnus 6.10.55 \e$B0JA0![\e(B
+
(setq pop3-fma-password
'(("SERVER1" "ACCOUNT1" "PASSWORD1")
("SERVER2" "ACCOUNT2" "PASSWORD2")
............................
))
+\e$B!Z\e(BT-gnus 6.10.56 \e$B0J9_![\e(B
+
+(setq mail-source-password-cache
+ '(
+ ("SERVER1:ACCOUNT1:pop3" . "PASSWORD1")
+ ("SERVER2:ACCOUNT2:pop3" . "PASSWORD2")
+ ............................
+ ))
+
+
\e$B$3$N%U%!%$%k$r$&$C$+$j3+$$$F$7$^$C$F$b%Q%9%o!<%I$,8+$($J$$$h$&$K!"\e(B
base64 \e$B$G%(%s%3!<%I$9$k$3$H$r$*4+$a$7$^$9!#$=$N0Y$K$O\e(B
(setq gnus-offline-pop-password-decoding-function nil)
\e$B$H=q$-$^$9!#\e(B(\e$B$?$@$7$3$l$OHs>o$K4m81$G$9!#\e(B)
- ~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+;;; \e$B$J$*!"\e(BT-gnus 6.10.57 \e$B0J9_$G$O\e(B \e$B=i2s5/F0;~$N\e(B gnus-ofsetup.el \e$B$K$h$kJQ\e(B
+;;; \e$B?t@_Dj$N:]!"\e(B(=~/.gnus-offline.el \e$B$,$J$$$H$-\e(B)\e$B%Q%9%o!<%I$r\e(B
+;;; ~/.newsrc.eld \e$B$KJ]B8$9$k$+$I$&$+<ALd$5$l!"!H\e(By\e$B!I$HEz$($k$HJ]B8$5$l$k\e(B
+;;; \e$B$h$&$K$J$j$^$9!#$?$@$7$3$N>l9g$OJ]B8$5$l$k%Q%9%o!<%I$OJ?J8$N$^$^$J$N\e(B
+;;; \e$B$G$+$J$j4m81$G$"$k$3$H$r$4>5CN$N$&$($*;H$$$/$@$5$$!#\e(B(\e$B>e5-$NJ}K!$b;H\e(B
+;;; \e$B$($^$9\e(B)