FSEPGPScripts V1.3 by Christian Sandberg
                ----------------------------------------


Included in this package:
=========================

     QuoteMsg          © Copyright Marius Mortensen
     AddSig            © Ultima Thule Software
     ESR               © Copyright Scott Ellis
     ESR.doc             Docs for ESR.
     grep
     FSEScriptIn
     FSEScriptOut
     FSEScripts.doc      (This textfile.)


What are FSEPGPScripts ?
========================

  With these scripts you can crypt/decrypt PGP messages when using the
Full Screen Editor (hereafter FSE) in Offline 1.53-> or the FSE in THOR.
It's possible to crypt a not crypted message when you leave the FSE, and
it's possible to leave the FSE without or with crypting the reply to a
crypted message.  And you may chose whether you want a message to be
crypted before it is given to the mailreader/BBS.


Needed to use the FSEScripts:
=============================

 - Pretty Good Privacy V2.3a (PGP) for the Amiga installed correctly.
   (The $PGPPATH and $TZ variables must be set!)

 - Offline V1.53 -> or THOR with the FSE.

 - Amigados V2.04 or higher.
 
 - The grep command in the path.

 - The ESR command in the path.


Installing:
===========

  Put the FSEScripts in Offline's root dir, or if you use THOR, put them
in BBSDATA:  Put grep, ESR and QuoteMsg in the mail readers root dir or
some place else in the path.  If you have THOR installed put AddSig in
the THOR:bin directory, if you don't and you only use Offline, just
delete it.

How do these scripts work?
==========================

  If you reply a message crypted with PGP, a requester will pop up
asking you for your PGP password.  (The password is saved in the
$PGPPASS variabel until a reset.) When the message in decrypted, which
may take some time, it'll apper inn the FSE.  When you exit the FSE,
a requester will pop up, asking you who you want to crypt the reply for.
Here you type the PGP-userid of the user you want to crypt the reply
for.  (This information will not be saved.)

  If you don't want to crypt the reply to a PGP message when you exit
the FSE just insert a line with exactly:

-=-=-=-=-=-DO NOT PGPCRYPT!-=-=-=-=-=-

in the reply.  This line will be removed and the reply will not be
crypted.

  If you want to crypt a reply to a not crypted message when you leave
the FSE, or you want to enter a crypted message to someone, just insert
a line with exactly:

-=-=-=-=-=-    PGPCRYPT!   -=-=-=-=-=-

in the reply/message.  This line will also be removed and the
reply/message will be crypted.  It may be a good idea to make two macros
in the FSE which insert these lines.


Warning!
========

  If you crypt a reply or a message to someone, it is _not_ possible to
decrypt it without the receiver's PGP key and password.  Therefore, if
you want to edit something in the reply or message before you send it,
use the macrokey function to prevent crypting.  When the reply is
finnished just use the crypt macrokey before exiting the FSE.  If you
try to edit a reply you have crypted for someone, you will get the
crypted reply in the FSE.


Last Warning!
=============

  If you type an invalid password or a nonexsisting PGPuserid will the FSE
probably hang, or it may cause a software failure (guru).  Therefore -
dobbelcheck what you type!!  If you're lucky, you'll only get a
warningmessage.


Known Problems:
===============

None.


Version changes:
================

1.0 -> 1.1 :  - Small bugfix since THOR sends the whole path of the
                messagefile, not just the name.

1.1 -> 1.2 :  - Fixed problem with spaces in PGPuserid and PGPpassword.

              - Improved error handling. If PGP retruns an error
                message, then the message will be displayed in a window
                on the THOR screen, or the Workbench screen if you use
                Offline.

              - I don't use the {msgfile}.pgpcrypt to check if the PGP
                message was crypted by you anymore. Now you'll get a
                error message window telling you that you don't have
                the key to decrypt the message. The problem with not
                decrypted PGP messages that really is for you, is
                therefore removed.

1.2 -> 1.3 :  - Now I use the AddSig executable to add the default
                signature used in THOR. Since the signature is added
                to the message before the decryption, it'll dissapeare.
                Therefore AddSig is used to add it again after
                decryption. If you use both Offline and THOR, will the
                scripts add the default THOR signature even if you use
                them with Offline.
                


Thanks!
=======

Marius Mortensen       -  For making the support in the FSE that I
                          wanted and the QuoteMsg executeable.

Petter Nilsen          -  For making the AddSig(nature) executable.

Scott Ellis            -  For ESR.

Tor Willy Austerslått  -  For all the "bug" reports.. :-)

Jan Roger Wilkens      -  For putting me on the idea.




Christian Sandberg.             EMail: chrsa@aid.no