                                                Tilburg, December 15, 1997
Hi gang,
--------

  This file accompanies the UUED02 package, which is meant to make binary file 
transfers over internet via E-mails easier. These two files are a first 
attempt to do so. They use a proprietary format, which uses a kind of Intel 
Hex (TM) format to transfer binary data in ASCII-coded hex. 

  This is also why the encoded files are slightly over twice as big as the 
original files. The actual computation is as follows: 

        new size = (old size x 2) + 16

Suppose the input file is called MSDOS.SYS and contains:

        ABCD01/.o

Then the output file will be:

        MSDOS.SYS+++++++&%
        404142434430312F2E6F

in which:  "&" is an ASCII-13 or a carriage return code,
           "%" is an ASCII-10 or a linefeed code.

  The first 16 bytes are used to store the original filename, followed by a 
CR/LF pair. The rest of the file is used to store the actual data. Each line 
of 64 characters (or 32 encoded bytes) is terminated by a CR/LF pair, in order 
not to confuse the E-mail package. 
  Since a filename, including the dot, can only take up 8+1+3=12 bytes, and 
the available space is 14 bytes, the remaining two bytes are reserved for 
future use. Please do not use these bytes for your own purposes. 


Using the software.
-------------------

  Using it is quite straightforward. First you encode the original file with: 

    UUE02 c:\internet\files\confiden.tia\me\myself\and.I\TeKsT.TxT 

and the software translates it to the already explained format. From this very 
long pathname, only the actual filename is extracted. The actual path on the 
source-diskdrive is rejected. Therefore the first line of the encoded file 
will read:

        TeKsT.TxT+++++&%

  The encoder UUE02 will default to a .ZIP extension, if it cannot find a '.' 
in the specified inputfile path/name. The outputfile will always have a '.DST' 
extension. 

NOTE:   Output files are created destructively! So take care that you do not 
        already have a file with that name in the current directory which is 
        not expendable. 

  The decoder UUD02 will default to a .DST extension for its inputfile. It 
will automatically recreate the correct filename, without the original 
pathname. 


Re-assembling the source.
-------------------------

  Please feel free to improve or adapt the software for your own particular 
system. Take care however, that you may NOT distribute modified packages under 
the old name. If you modify any part of the source, make a note of it and make 
sure that all users are aware of it. 

  If re-assembling, take care that A86 will recognize your own CPU and produce 
the outputfile for that particular CPU, unless overridden by the +P switch. 

  If the new target CPU is the 8088, please assemble with the "+P64" switch.


How to show your gratitude.
---------------------------

If you feel obliged to show your gratitude, please do one of the following:

 - send a postcard from your town to:

        Jan Verhoeven
        5012 GH - 272
        Netherlands

 - send an E-mail to:

        aklasse@tip.nl

The postcard is prefered.

  I have tried the shareware approach in earlier programs, but that just 
doesn't work (anymore?). Therefore I have adopted the GNU GPL approach and 
since then I produce FREE SOFTWARE. Please read the GNU General Public License 
which is also included in this file. 

  Still, all copyrights remain with me, the original author.


Bye for now,

Jan Verhoeven
NL-5012 GH  272
aklasse@tip.nl
