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.)
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
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
~/.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).
-<<<<<ATTENTION!!>>>>>
-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
-\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)
+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
o gnus-offline-drafts-queue-type
Message queue type when spooling message.
-
+
'miee ... Use miee.el.
'agent ... Use gnus-agent.el.
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-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.
6) [!!!IMPORTANT!!!] About the pop password
===========================================
-<<<<<ATTENTION!!>>>>>
-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 ()
- (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.