
                       SPB to QWK Converter v1.30
                    Copyright (C)1995 Khor Chin Heong
                             (khor@kch.pl.my)
                              March 3, 1995


This is a program to convert UUPC/extended's SPB mailbox format into
the QWK format often used by BBS mail doors and offline mail readers.
It also includes a mailer to mail QWK replies via UUPC/extended to
Internet addresses.

Packaging
---------

The files included in the original compressed archive are:
SPBQWK.EXE   - SPB to QWK converter
MAILREP.EXE  - QWK reply mailer
GETSPB.BAT   - Sample batch file
SEND.BAT     - Sample batch file
README.TXT   - This file


Installation/Usage
------------------

- You MUST have Kendra Electronic Wonderworks' UUPC/extended
successfully installed first.

- Make sure that the UUPC/extended executables are placed in a directory
in your DOS search PATH. MAILREP will try to execute UUPC/extended's
MAIL.EXE.

- It is recommended that you copy all the files into your offline mail
reader's home directory and modify the GETSPB.BAT and SEND.BAT files.
GETSPB is used to convert and compress the SPB mailbox into a compressed
QWK archive. SEND is used to uncompress and mail the QWK replies via
UUPC/extended. So after receiving your mail through UUPC/extended, you
might want to do:
        cd \bwave
        getspb
        bwave
        send

- Both batch files are configured for Blue Wave v2.12 and PKZIP.
Refer to your offline mail reader's documentation for information on
where the incoming/replies QWK packets are stored and modify the batch
files accordingly.

- Under your offline mail reader, you can use the 'Reply' function to
reply your mail. SPBQWK will append a '*From:' field at the top of the
message to indicate the sender. Do *NOT* delete this field! It is
needed by MAILREP.

- When entering new messages, you can indicate the recipient in the 'To:'
field in your offline mail reader if the address fits. If not, then
place a '*To: [address]*' at the top of your message. E.g. to send
to johndoe@kingdom.come.abc.def.ghi,

        *To: johndoe@kingdom.come.abc.def.ghi*

        Hi John,
        etc.
        etc.

- Any other functions such as carbon copying, mail forwarding, etc. in
the offline mail reader cannot be guaranteed to work with MAILREP unless
the recipient's address fits in the offline mail reader's 'To:' field.

- These versions of SPBQWK and MAILREP have been tested to work with
UUPC/extended 1.12k and Blue Wave v2.12. Hopefully, they will work with
other versions.


Useful features/technical info
------------------------------

- MAILREP determines the recipient's address by looking at the *From: or
*To: field, if they exist, generated in the message body by SPBQWK. This
is to overcome the 25 character limitation imposed by the QWK format.
After getting the address, these fields are deleted before the message is
sent.

- MAILREP determines the recipient with the following precedence:
        *From: or *To:     (whichever comes first in the message body)
        QWK's To: field    (if *From: and *To: are not found)

- MAILREP can't handle *From: and *To: fields which are longer than
one line. (To be fixed in future)

- MAILREP assumes SPB.MSG is the QWK reply file.

- SPBQWK by default will read the UUPCUSRRC and UUPCSYSRC environment
variables and the corresponding .RC files to determine your name and
your mailbox's name. You can specify a different mailbox name in
SPBQWK by using
        spbqwk [mboxname]

- SPBQWK will generate three files, CONTROL.DAT, MESSAGES.DAT, and
001.NDX, which are components of the QWK packet.


Disclaimer
----------

   You are granted the right to use and to make an unlimited number of
   copies of this software. You may not disassemble, decompose, reverse
   engineer, or alter this file or any of the other files in the package.

   This software is provided as FREEWARE and cannot be sold. This restriction
   does not apply to copying charges, connect time charges, or flat rate
   connection/download fees for electronic bulletin board services. This
   software can not be bundled with any commercial package without express
   written permission from the author.

   The author of this program accepts no responsibility for damages resulting
   from the use of this product and makes no warranty or representation,
   either express or implied, including but not limited to, any implied
   warranty of merchantability or fitness for a particular purpose. This
   software is provided "AS IS", and you, its user, assume all risks when
   using it.


Reaching the author
-------------------

Direct all comments/suggestions/bugs to me at khor@kch.pl.my.
