* lisp/gnus.el (gnus-revision-number): Increment to 02. t-gnus-6_10_057-02
authoryamaoka <yamaoka>
Thu, 4 Feb 1999 12:37:33 +0000 (12:37 +0000)
committeryamaoka <yamaoka>
Thu, 4 Feb 1999 12:37:33 +0000 (12:37 +0000)
* README-offline.en: New description.
* README-offline.ja: Ditto.

ChangeLog
README-offline.en
README-offline.ja

index 46dec21..2baaafe 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,9 +1,18 @@
+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.
index 8854b25..5bf0399 100644 (file)
@@ -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.
+
+<<<<<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.
@@ -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.)
index 36a1b46..57ac677 100644 (file)
@@ -20,8 +20,9 @@
 \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
 
@@ -61,14 +62,17 @@ T-gnus \e$B$r$*;H$$$N>l9g!"\e(Bgnus-offline.el \e$B$OFC$K2?$b9M$($J$/$F$b\e(B T-gnus
 \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) 
@@ -79,6 +83,14 @@ pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\e(B
 \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
 
@@ -162,6 +174,9 @@ pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\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
 
@@ -197,13 +212,18 @@ pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\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
@@ -211,7 +231,6 @@ pop3-fma.el \e$B$N@_Dj$O30$7$F$/$@$5$$!#\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
@@ -219,22 +238,44 @@ pop3-fma.el \e$B$N@_Dj$O30$7$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
 
@@ -246,4 +287,11 @@ 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)