Index of /geminiatari/FILES/ARCHIVER/UUCODE10

 Name                    Last modified       Size  Description

 Parent Directory        24-Sep-2006 15:43      -  
 UUCODER.PRG             02-Jun-1991 03:25    19k  
 UUCODER.RSC             31-May-1991 05:24     3k  

README file for UUCODER version 1.0

* What is UUCODER?

UUCODER is a GEM-based, mouse-driven program that encodes
and decodes files. It supports the uuencode format commonly used on
Usenet.

* What's the point of encoding files?

Usenet and many electronic-mail systems do not provide for the
transfer of binary files such as programs, resource files, archives
and other non-text material.

Uuencoding is a way of getting around this restriction by translating
8-bit binary data into 7-bit printable text. This process expands the
size of the file by a ratio of 4 to 3. The reverse process,
uudecoding, transforms the text back into binary data.

* Where does this program come from?

The encoding and decoding routines originated as the public-domain
Dumas UUE and UUD programs, which are enhanced but compatible with
standard Un*x uuencode. The Dumas enhancements include a translation
table that can help repair files damaged by brain-dead
EBCDIC<-->ASCII gateways and the ability to ``chain'' a long binary
file into multiple takes that can be automatically recombined.

I reworked the Dumas code somewhat to allow it to handle some of the
more bizarre filenames I've found embedded in uuencoded data.

* How do I use UUCODER?

UUCODER is GEM-based and operation should be self-explanatory. Just
run it and click on the appropriate menu selection.

UUCODER automatically combines binaries that were split into multiple
``takes'' by Dumas UUE. The takes must be in the current directory,
or they may be concatenated. UUCODER will untangle illegal filenames
created by some encoders, such as ``filename.z.uab'' or 
``filename.arc.uab''.

UUCODER allows you to split long files into multiple takes when
encoding, too. There is a menu selection for choosing the maximum
output file length. The default is 32K uuencoded lines of 62 bytes
each.

* Is source code for this available?

Yes. It should be available from the Usenet comp.sources.atari.st
archives (archive-server@twitterpater.Eng.Sun.COM), the University of
Michigan's Atari software files (atari@atari.archive.umich.edu), on
GEnie, or as a last resort by asking me to mail it to you. My address
is below.

* What should you do if you like or dislike this program?

Let me know! This is just a ``first pass'' at the program; future
versions may be enhanced.

Send bug reports and/or suggestions for enhancement, or just a
picture postcard, to:

Steve Yelvington
Box 38
Marine on St. Croix, MN 55047 USA

Internet: steve@thelake.mn.org
UUCP: plains!umn-cs!thelake!steve
Citadel: mast!moundst!thelake!steve
GEnie: S.YELVINGTO2