git.chise.org Git - elisp/gnus.git-/blob - README-offline.en

   1 1) What's "gnus-offline (Gnus Offline Backend Utility)" ?
   2 =========================================================
   3
   4 This program is a utility for T-gnus that handles messages
   5 (i.e. mail and news) in the "offline" state in a more simple way.
   6
   7 It is basically designed for "gnus-agent". (See info about gnus-agent.)
   8
   9 You can also use it with a function "nnspool"(*1) (which needs an
  10 external program such as "gnspool"(*2) ), or with "miee.el"(*3) for
  11 posting and/or sending messages.
  12
  13      (*1) See info about nnspool.
  14      (*2) gnspool comes with a newsreader "gn".
  15      (*3) The latest version of miee.el (or MIEE) is available at
  16           http://www.shiojiri.ne.jp/%7Et-ichi/meadow.html
  17
  18 You can handle messages in the offline state without "gnus-offline",
  19 but "gnus-offline" provides a simple way for setup and operation.
  20
  21 **Features**
  22
  23 o Simple configuration -- An "INTERACTIVE" configuration to set
  24          the variables.
  25
  26 o Simple operation -- Type "g" in the *Group* buffer, and gnus-offline
  27          will:
  28            o Dial (*)
  29            o Send mails & post news articles
  30            o Fetch new mails & articles
  31            o Hang up (*)
  32
  33       (*) For dialing and hanging up, external softwares are needed.
  34           But you can do without ones if you connect and disconnect
  35           manually.
  36
  37 This document is written mainly for the case using "gnus-agent" with
  38 gnus-offline.el bundled in T-gnus 6.12.0 or later.
  39
  40 2) Installation
  41 ===============
  42
  43 As you are reading this document, this version of T-gnus includes
  44 gnus-offline. Installation is simple. "make install" will
  45 automatically install "gnus-offline".
  46
  47 3) How to use
  48 =============
  49
  50 o First, you must do a general setup for T-gnus (See info about the
  51   setup).
  52
  53 o Add the following code to ~/.emacs
  54
  55         (autoload 'gnus-plugged "gnus-agent" nil t)
  56         (autoload 'gnus-unplugged "gnus-agent" nil t)
  57
  58 o Add the following code to ~/.emacs
  59
  60         (load "gnus-ofsetup")
  61         (gnus-setup-for-offline)
  62
  63 o Add the following code to ~/.gnus
  64
  65         (gnus-agentize)
  66
  67 o Restart Emacs. gnus-ofsetup.el will ask you some questions and
  68  create ~/.gnus-offline.el. (*)
  69
  70       (*) If you don't know how to answer some questions, typing "TAB"
  71           key may show you the possible answers. See the next section
  72           which explains the user options.
  73           You will also be asked whether to save the POP password in
  74           ~/.newsrc.eld or not. Answer it carefully. See section 6)
  75           for details.
  76
  77 o At the first time, you must start Gnus in the online state
  78  (by M-x gnus-plugged) and decide which groups to subscribe (See info
  79  about subscribing).
  80
  81  From now on you can start Gnus as an offline reader by M-x gnus-unplugged.
  82  Try typing "g" in the *Group* buffer.
  83
  84 o You may want M-x gnus to start Gnus as an offline reader as
  85  M-x gnus-unplugged. Then write the following code to ~/.emacs
  86
  87         (setq gnus-plugged nil)
  88
  89  you can put it into ~/.gnus if there's no need to start Gnus as an online
  90  reader (by M-x gnus-plugged).
  91
  92 4) User customizable variables in gnus-offline
  93 ==============================================
  94
  95 o gnus-offline-dialup-program
  96     Program name to dialup.
  97
  98 o gnus-offline-dialup-program-arguments
  99     List of dialup program arguments.
 100
 101 o gnus-offline-hangup-program
 102     Program name to hangup.
 103
 104 o gnus-offline-hangup-program-arguments
 105     List of hangup program arguments.
 106
 107 o gnus-offline-mail-spool-directory
 108     Spool directory for sending mail.
 109     This variable is available only using MIEE.
 110
 111 o gnus-offline-news-spool-directory
 112     Spool directory for sending news.
 113     This variable is available only using MIEE.
 114
 115 o gnus-offline-mail-treat-environ
 116     If t , gnus-offline sends mail to spool first.
 117     If nil , gnus-offline sends mail immediately.
 118
 119 o gnus-offline-articles-to-fetch
 120     Article type you want to fetch.
 121
 122        'both ... Fetch both Mail/News.
 123        'Mail ... Fetch only Mail.
 124        'News ... Fetch only News.
 125
 126     Default value is both.
 127
 128 o gnus-offline-load-hook
 129     Hook before gnus-offline load.
 130
 131 o gnus-offline-before-online-hook
 132     Hook before all online jobs.
 133
 134 o gnus-offline-after-online-hook
 135     Hook after all online jobs.
 136
 137 o gnus-offline-interval-time
 138     Interval time to do all online jobs.(minutes)
 139
 140 o gnus-offline-MTA-type
 141     MTA type to sending mail.
 142
 143    'smtp     ... Use smtp.el.
 144    'sendmail ... Use sendmail.el.
 145
 146 o gnus-offline-drafts-queue-type
 147    Message queue type when spooling message.
 148
 149    'miee  ... Use miee.el.
 150    'agent ... Use gnus-agent.el.
 151
 152 o gnus-offline-after-empting-spool-hook
 153    Hook before empting spool.
 154
 155 o gnus-offline-before-empting-spool-hook
 156    Hook after emoting spool.
 157
 158 o gnus-offline-dialup-function
 159    Function to dialup.
 160
 161 o gnus-offline-hangup-function
 162    Function to hangup.
 163
 164 5) Commands in gnus-offline
 165 ===========================
 166
 167 o M-x gnus-offline-toggle-plugged
 168    Toggle offline/online state.
 169
 170 o M-x gnus-offline-toggle-auto-hangup
 171    Change current state to offline.
 172
 173 o M-x gnus-offline-toggle-on/off-send-mail
 174    Toggle method to sending mail.
 175
 176 o M-x gnus-offline-toggle-articles-to-fetch
 177    Toggle articles you want to fetch.
 178
 179 o M-x gnus-offline-set-interval-time
 180    Set interval time(minute) to fetch article.
 181
 182 o M-x gnus-offline-agent-expire
 183    Expire articles.
 184
 185 6) [!!!IMPORTANT!!!] About the pop password
 186 ===========================================
 187
 188 If your machine is stand alone, and nobody else uses it, you can save
 189 the password. (But, on your own responsibility!)
 190
 191 At the first interactive configuration, it will ask you whether to
 192 save the password in ~/.newsrc.eld or not. When you answer "y" to this
 193 question, the password will be saved in ~/.newsrc.eld. (*)
 194
 195        (*) Actually the following will be added to ~/.gnus-offline.el.
 196
 197             (add-hook
 198              'gnus-setup-news-hook
 199              (lambda ()
 200                (add-to-list 'gnus-variable-list 'mail-source-password-cache)))
 201
 202 Answer this question carefully, because the password will NOT be
 203 encoded!