/**************
 * UUCode.doc *
 **************/

/****** UUEncode/UUDecode ***************************************************
*
*   NAME   
*       UUEncode -- Encode a binary file       (V34.41)
*       UUDecode -- Decode an UUEncode't file  (V34.41)
*
*   SYNTAX
*       UUEncode <inFile> [outFile]
*
*           inFile  - Mandatory input file.
*
*           outFile - Optional output file. If outFile isn't specified,
*                     output will go to stdout/console - handy for use
*                     with pipes.
*             
*           UUEncode will examine the environment variable UUENCODE for
*           a default output path. If not found, and if outFile doesn't
*           contain a full path, the result will go to current directory.
*
*
*       UUDecode [inFile]
*
*           inFile  - Optional input file. If inFile isn't specified,
*                     UUEncode will read from stdin/console until EOF
*                     (^\).
*
*           Output will go to current directory, unless UUEncode finds
*           a valid path specification in the environment variable UU-
*           DECODE.
*
*   FUNCTION
*       These programs are primarily for use with electronic mail systems
*       such as FidoNet and UUCP.
*
*       UUEncode sort of encrypts a program so that the output will only
*       contain printable characters, thus allowing you to post a binary
*       file in a message area.
*
*       UUDecode does the opposite thing: it decrypts an UUEncode'd ASCII
*       file into its binary origin. It is *NOT* necessary to cut out the
*       UUEncode'd part of a message in order to decode it - just pass the
*       whole msg to UUDecode.
*
*       Please note that UUEncode doesn't perform any kind of compression!
*       In fact, any UUEncode'd file will be *at least* one third bigger
*       than the original file, due to the loss of information by convert-
*       ing the file to ASCII.
*
*       Please also note that not all moderators welcome UUEncode't files
*       and remember that a lot of people will be paying money for down-
*       loading your messages - so use it with care, huh? :-)
*
*   EXAMPLE
*       UUEncode Calendar Calendar.uue
*       UUDecode Calendar.uue
*       UUEncode Calendar | UUDecode
*
*   NOTES
*       Runs under AmigaOS 1.3+ -- More than twice as fast as their 2.0-
*       only brothers [currently UU(En|De)code V37.22].
*
*       Fully re-entrant ('PURE').
*
*   BUGS
*       None known.
*
*****************************************************************************
*
*   GREETINGS
*       For heavy beta-testing and suggestions, sincere thanks go to
*
*           Adam Sjoegren (FastJack) FidoNet @2:230/149
*           Lars Feldborg (LaBri)    FidoNet @2:230/130.12
*           Brian Ipsen              FidoNet @2:231/107
*
*       Thanks also go to Matt Dillon for his wonderful DICE compiler!
*
*   COPYRIGHT
*       These programs are Copyright (C) 1991,92 SmallCode SoftWare,
*       but are freely redistributable as POSTCARDWARE - i.e., if you
*       like these programs and use them regularly you are obliged to
*       send me a postcard (you'll find my address below) - provided
*       that the archive is left intact, holding the following files:
*
*               UUEncode      -  executable
*               UUDecode      -  executable
*               Env/UUENCODE  -  sample environment variable
*               Env/UUDECODE  -  sample environment variable
*               UUCode.doc    -  what you are reading now
*
*   AUTHOR
*       Klaus Alexander Seistrup
*       SmallCode SoftWare HQ
*       Ahornsgade 8A, 1.th.
*       DK-2200 Koebenhavn N
*       D E N M A R K
*       FidoNet 2:230/119 (Klaus Seistrup)
*
*/