This file documents the ZapEmail v0.01
======================================

The ZapEmail module adds a new mode to Zap which makes Zap easier to use
composing e-mail and news in conjuction with !TTFN and !QEdit. At the moment
it is very primitive, but it is useful. I'm open to suggestions for additions
or improvements.


What does it do?
================

When !TTFN or !QEdit start up Zap for you to compose or re-edit mail or news,
Zap/ZapEmail will change into the new e-mail mode with the cursor placed a couple
of lines *after* the message header. This lets you start typing your message
straight away without first having to move the cursor. This isn't a huge benefit,
but it can save a little frustration ... how many times have you accidentally
messed up your message header and had to hit F8 or start all over again?

A second, less obvious, bonus is that, since this is a seperate mode, you can
set up things like screen width independently of the settings you have for
editing ordinary text files. Eighty characters is about right for mail and news,
but if you're using a wide screen mode, you may well want to edit other files at
larger settings. Having a special set of options for mail means that you don't
have to fiddle around with Zap's configuration menus. It would be nice if this
worked for word-wrap, but unfortunately Zap doesn't set that up mode dependently
at the moment.

Note: Setting up the options for e-mail is done in exactly the same way as any
      other Zap mode. See Zap's help file for details.


Installation
============

You will need Zap version 1.20 or later to use ZapEmail. The installation
procedure depends on which version of Zap you are using.

Zap 1.25 or later:
------------------

   ZapEmail shouldn't need any installation, since it is now a part of the
   standard Zap distribution. If for some reason you do need to install it you
   must:

   1. In file '!Zap.External' add the lines,

        <Zap$3rdParty>.Sabin.ZapEmail
                Email

   2. In file '!Zap.Keys' find the group of lines that begin with &500 and add,

        &5xx       &FFF       \#\*.TTFN_Work  +Email
        &5xx       &FFF       \#\*.Re-edit    +Email

      at the end of that block, where 5xx's are different from the other &500's
      already in use.

   3. Quit and restart Zap.


Zap 1.20
--------

   ZapEmail doesn't come with the standard Zap 1.20 distibution. If this is the
   version you are using, you must:

   1. Copy the ZapEmail module into the !Zap directory

   2. In file '!Zap.!Run' add the line,

        RMLoad <Zap$Dir>.ZapEmail

      Somewhere after the line:

        RMLoad <Zap$Dir>.ZapBasic

   3. In file '!Zap.Keys' find the group of lines that begin with &500 and add,

        &5xx       &FFF       \#\*.TTFN_Work  +Email
        &5xx       &FFF       \#\*.Re-edit    +Email

      at the end of that block, where 5xx's are different from the other &500's
      already in use.

   4. Quit and restart Zap.


Contacting the author
=====================

Bug reports, comments and suggestions always welcome. Please make your own
improvements and mail me the results.

e-mail: ms10010@cus.cam.ac.uk


Legal stuff
===========

The ZapEmail module and its source are public domain ... feel free to modify it,
improve it and pass it on to anyone who wants it.

No warranty, express or implied, of the merchantability of this software or its
fitness for any particular purpose is given. In no circumstances shall the
author, or any provider or distributor of this software, be liable for any
damage, loss of profits, or any indirect or consequential loss arising out of
the use of, or inability to use, this software.

Miles Sabin, May 1995
