* This is a free software-programm for the PSION Series 3 *

               +----------------------------------+
               |   USERMANUAL for UUCODE.APP      |
               +----------------------------------+


                  Adapted to the PSION Series 3

                                by

                  Volker Hoppe and Steffen Penne

                         Yellow Computing
                           Postbox 1136
                    D-7107 Bad Friedrichshall
                             Germany

                        Tel: +49 7136 4097
                        Fax: +49 7136 7136
                        BBS: +49 7136 4221

             using TOPSPEED C Compiler and PSION SDK

                           12-Juli-1992


INTRODUCTION:
=============
UU-encoding is a way to code a file which may contain any
characters into a standard character set that can be reliably sent
over mail networks like USENET or FIDO.
The UU-encoding and decoding is adapted from the UU402.C
sourcecode we found on an ATARI Unix machine.


HOW TO USE:
===========
The UUCODE.APP for the series 3 contains the functions for
uuencode and uudecode, which means it can encode a binary file or
decode its ASCII representation.

Please install the application in your system screen.

After starting the application the source-code file selection will
appear. Here you can select the required file for processing.
The application detects automatically, if it is an UUcoded file.
In this case it is encoded into its original file.
If it is no UUcoded file it is automatically coded into an ASCII
file. The UUcoded file will get the extension *.ASC and will be
saved using the same pathname as the soucre file had.


HINT:
=====
The first line of the UUcodeded file contains the target filename
with filesystem, drive and path.
The result of the decoding process is stored at this path.
If there is a drive which is not present on your Series 3, then
you should edit this, before starting the UUcode for decoding.


ABOUT THE CHARACTER ENCODING:
=============================
The basic scheme is to break groups of 3 eight bit characters (24
bits) into 4 six bit characters and then add 32 (a space) to each
six bit character which maps it into the readily transmittable
character.  Another way of phrasing this is to say that the
encoded 6 bit characters are mapped into the set:

        `!"#$%&'()*+,-./012356789:;<=>?@ABC...XYZ[\]^_

for transmission over communications lines.

As some transmission mechanisms compress or remove spaces, spaces
are changed into back-quote characters (a 96).

The encoded file's size is expanded by 35% (3 bytes become 4, plus
control information), causing it to take longer to transmit than
the equivalent binary.

For more details about UU-coding see
USER COMMANDS MANUAL
UUENCODE(1C)
UUDECODE(1C)
Sun Release 4.0
Last change: 23 November 1987


- EOF -