home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 1: Amiga
/
FrozenFish-Apr94.iso
/
bbs
/
alib
/
d9xx
/
d912
/
uuxt.lha
/
UUxT
/
UUxT.doc
< prev
next >
Wrap
Text File
|
1993-10-03
|
9KB
|
230 lines
UUxT 2.1 -- The Ultimate "UU" Utility for The Amiga
---------------------------------------------------
Written by Asher Feldman
------------------------
Updates from UUxT 2.0
---------------------
o Added UUxT-GUI, a point and click workbench front end for
UUxT, making UU tasks even easier. (See UUxT-GUI.DOC for
more information.)
o Added Wildcard support.
o Only known enforcer hit removed.
o Fixed decoding of split files bug.
o Fixed encode bug when not connected to a console.
Updates from UUx 1.0
--------------------
o Now allows you to encode multiple programs into a single
uuencoded file.
o Decodes all files in a "multi-file" uuencoded package.
o Ability to decode "multi-part" (split) uuencoded files, without
having to first join them together. The separate parts can even
be on separate volumes, allowing floppy users to decode larger
files.
o Bath decoding. UUxT can now decode multiple uuencoded files at
once.
o Greatly improved status messages, and improved command line error
checking.
o No longer asks if you want to overwrite an existing file. I liked
this feature at first, but it got annoying, so I removed it. I plan
on putting it back in the next version, along with a "QUIET"
parameter.
o The 68030 version has been removed. The new decode routines are
optimized, and a 68030 version gives to considerable speed increases.
Great, but what is it?
----------------------
UUxT is an "amigalized" uuencode/decode utility.
Simply, it converts binary files to ASCII (and back, of course) so that
they can be transmitted on mail-only networks, such as the UseNet or Portal.
It is fully compatible with uuencode/decode utilities on other platforms,
such as Unix, or Ibm. There are already many versions of uuencode and
uudecode floating around for the Amiga, but they're all kind of archaic.
I mean, having separate utils for coding and decoding, and having to use
redirection to encode a single file isn't exactly something a beginner can
learn all that easy. The syntax was also archaic and non-standard. But
more than that, UUxT has features that can be found in no other single "UU"
util, and does the work of several programs.
To encode the file myfile.lha with an old uuencode util entailed doing this:
uuencode >myfile.uu myfile.lha myfile.lha
Not a very pretty sight, especially if you're just starting out on a
network. The weird format was left over from Unix systems, but I have no
idea why. Anyway, I decided to change things, so I wrote UUxT, which has a
modern, Amiga style interface, just like any Amiga archiver you're probably
already accustomed to, such as LhA.
But wait, there's more!
-----------------------
UUxT doesn't just do "uudecoding", but also "uuconcatenating" too. That
means it can take a uuencoded file that was created by joining several
uuencoded files, with the headers left in, and still give you your binary
file. That's right, no more endless hours of editing mail headers, UUxT
takes care of that for you! Also, if you have a multi part archive, that
has not yet been joined, UUxT can read the separate parts (even if they're
on different volumes, a plus for floppy users trying to decode large files)
and decode them as if they were joined as a single file. Also, UUxT will
decode a single file which contains more than one uuencoded file, as well
as being able to decode multiple files at once.
Using UUxT
---------
When you run UUxT at the command line, you should get something like this:
UUxT Version 2.1 Copyright (c)1993 Asher Feldman
USAGE: UUxT [option] [archive name] <LhA archive name> <file(s)>
options: a - encode l - LhAencode
x - decode u - LhAdecode
UUxT has four options to choose from. You can encode or decode a file with
the "a" and "x" options respectively. Both of these options can operate on
multiple files.
Using the "l" option, you can do one step LhAing and uuencoding. The "u"
option will decode, and then automatically decompress a .lzh or .lha archive
using LhA. LhA is copyrighted 1992 by Stefan Boberg. It is the best
archiver available for the Amiga as of this writing, and I highly recommend
you register it.
UUxT now supports wildcards in all operations. All standard wildcards
are supported. However, the '*' wildcard is not supported, even under
2.0.
If I wanted to encode the file 'MyFile.lha' I would enter the following:
UUxT a myfile.lha.uue myfile.lha
^^^^^^^^^^^^^^
Substitute whatever you want to call the encoded file here.
You can encode multiple files into a single uuencoded text file. For
example:
UUxT a myfiles.uue myprog game
This would uuencode the files 'myprog' and 'game' and put them into a
single uuencoded file, 'myfiles.uue'.
If I wanted to encode all files in the drawer 'Games' to the file
'myfiles.uue' I could use wildcards, instead of typing out all the
program names. For example:
UUxT a myfiles.uue Games/#?
Now to decode myfiles.uue, you would enter:
UUxT x myfiles.uue
If I wanted to decode the uuencoded files "prog.uue" and "game.uue", I
could use:
UUxT x prog.uue game.uue
This saves the time of having to separately decode the two files.
I could also use wildcards. If I wanted to decode all files with the
postfix ".uue", plus the file "prog.uu", I could use:
UUxT x #?.uue prog.uu
If I had a uuencoded file that had been split into multiple parts, that
have not yet been joined, and are on multiple volumes, I could use:
UUxT x df0:part1.uue df1:part2.uue ram:part3.uue
This saves the time of joining files, and allows you to decode files
that normally wouldn't fit on a single disk. NOTE: Some "split" programs
split files in the middle of a line, instead of at the end of a line. If
you have an archive that was been split on one such program, you must first
join the files. Try to use a spliter that splits at a line number to be
compatible with this option. Also, make sure you put the parts in the
correct order, or the output file will be scrambled.
If I had the files m1, m2, and m3 in the current directory, and wanted
to LhA and uuencode them I could use:
UUxT l myfile.lha.uue myfile.lha m1 m2 m3
"myfile.uu" will then be created, and will contain the LhA'd file
"myfile.lha" which contains the files m1, m2 and m3. NOTE: When
using the "l" option, you MUST specify an LhA archive name, complete
with the ".lha"!
To automatically decode/de-lha the file "myfile.uu" I would use:
UUxT u myfile.lha.uue
If by any chance you get an "unexpected end of input" when you try to
decode a .uue file, your file transferring procedure may be adding CR's or
something to the file. Use a CR-stripper, like TC or Filter, to remove
them first, then decode the file. When you get back on the board, see if
there's some CR setting you can adjust to eliminate them. If you still
receive an error message, then part of the uuencoded file has been cut off,
or has been corrupted.
Info
----
The decoding routines were ported in part from various Un*x programs, and
the original authors are unknown.
UUxT will decode all uuencoded files (even if they still have mail headers,
etc. in them), from any source (hopefully :) (unless they're corrupt. :-)
Please mail me if you have any trouble.
Disclaimer
----------
The author is not responsible for any damage caused to your system by
UUxT.
UUxT is Copyrighted (C)1993 by Asher Feldman. It is not public domain.
You my freely distribute UUxT, and use it for any non-commercial purpose
you wish, as long as you leave the original files intact. Commercial usage
is prohibited, without written consent by the author.
If you find UUxT useful, and would like to see further development of
the UUxT package, please send a donation to the address below.
Thanks!
You can contact me at the following addresses:
E-Mail
------
PORTAL: Wizard0
Internet: Wizard0@cup.portal.com
asher@shell.portal.com
US Snail: (send checks here :-)
Asher Feldman
4791 Calle de Tosca
San Jose, CA 95118
And remember :
ONLY _ C_o m m o d o_r_e _
/\\ l\\ /l ll // \ /\\
/ \\ l \\ /ll ll(< __ / \\ MAKES IT POSSIBLE!!!!
/--- \\l \X ll ll \\_ll/--- \\
/______________________________\\
A. F.