home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / packers / uuxt / uuxt.doc < prev    next >
Text File  |  1993-06-17  |  8KB  |  193 lines
  1.            UUxT 2.0 -- The Ultimate "UU" Utility for The Amiga
  2.            ---------------------------------------------------
  3. Written by Asher Feldman
  4. ------------------------
  5.  
  6. UUxT 2.0 is an update to UUx 1.0.  The name was changed as it conflicted
  7. with a program which is part of the Amiga UUCP package.
  8.  
  9. Updates from UUx 1.0
  10. --------------------
  11.  
  12.     o Now allows you to encode multiple programs into a single 
  13.        uuencoded file.
  14.  
  15.     o Decodes all files in a "multi-file" uuencoded package.
  16.  
  17.     o Ability to decode "multi-part" (split) uuencoded files, without
  18.       having to first join them together.  The seperate parts can even
  19.       be on seperate volumes, allowing floppy users to decode larger
  20.       files.
  21.  
  22.     o Bath decoding.  UUxT can now decode multiple uuencoded files at
  23.       once.
  24.  
  25.     o Greatly improved status messages, and improved command line error
  26.       checking.
  27.  
  28.     o No longer asks if you want to overwrite an exsisting file.  I liked
  29.       this feature at first, but it got annoying, so I removed it.  I plan
  30.       on putting it back in the next version, along with a "QUIET" parameter.
  31.  
  32.     o The 68030 version has been removed.  The new decode routines are
  33.       optimized, and a 68030 version gives to considerable speed increases.
  34.  
  35. Great, but what is it?
  36. ----------------------
  37. UUxT is an "amigalized" uuencode/decode utility.
  38. Simply, it converts binary files to ASCII (and back, of course) so that
  39. they can be transmitted on mail-only networks, such as the UseNet or Portal.
  40. It is fully compatible with uuencode/decode utilities on other platforms,
  41. such as Unix, or Ibm. There are already many versions of uuencode and
  42. uudecode floating around for the Amiga, but they're all kind of archaic.  
  43. I mean, having separate utils for coding and decoding, and having to use
  44. redirection to encode a single file isn't exactly something a beginner can
  45. learn all that easy.  The syntax was also archaic and non-standard.  But
  46. more than that, UUxT has features that can be found in no other single "UU"
  47. util, and does the work of several programs.  
  48.  
  49.  To encode the file myfile.lha with an old uuencode util entailed doing this:
  50.  
  51.               uuencode >myfile.uu myfile.lha myfile.lha
  52.  
  53.   Not a very pretty sight, especially if you're just starting out on a
  54. network.  The weird format was left over from unix systems, but I have no
  55. idea why.  Anyways, I decided to change things, so I wrote UUxT, which has a
  56. modern, Amiga style interface, just like any Amiga archiver you're probably
  57. already accustomed to, such as LhA.
  58.  
  59. But wait, there's more!
  60. -----------------------
  61.   UUxT doesn't just do "uudecoding", but also "uuconcacting" too.  That means
  62. it can take a uuencoded file that was created by joining several uuencoded
  63. files, with the headers left in, and still give you your binary file.  That's
  64. right, no more endless hours of editing mail headers, UUxT takes care of that
  65. for you!  Also, if you have a multi part archive, that has not yet been 
  66. joined, UUxT can read the seperate parts (even if they're on different
  67. volumes, a plus for floppy users trying to decode large files) and decode
  68. them as if they were joined as a single file.  Also, UUxT will decode a 
  69. single file which contains more than one uuencoded file, as well as being
  70. able to decode multiple files at once.
  71.  
  72. Using UUxT 
  73. ---------
  74. When you run UUxT at the command line, you should get something like this:
  75.  
  76.      UUxT Version 2.0 Copyright (c)1993 Asher Feldman    
  77.      USAGE: UUxT [option] [archive name] <LhA archive name> <file(s)>
  78.      options: a - encode           l - LhAencode                            
  79.               x - decode           u - LhAdecode
  80.  
  81.   UUxT has four options to choose from.  You can encode or decode a file with
  82. the "a" and "x" options respectively.  Both of these options can operate on
  83. multiple files.
  84. Using the "l" option, you can do one step LhAing and uuencoding.  The "u" 
  85. option will decode, and then automati-cally decompress a .lzh or .lha archive 
  86. using LhA.  LhA is copyrighted 1992 by Stefan Boberg.  It is the best archiver 
  87. available for the Amiga as of this writing, and I highly recommend you register 
  88. it.
  89.  
  90.   If I wanted to encode the file 'MyFile.lha' I would enter the following:
  91.  
  92.          UUxT a myfile.lha.uue myfile.lha
  93.                 ^^^^^^^^^^^^^^
  94.               Substitute whatever you want to call the encoded file here.
  95.  
  96.   You can encode multiple files into a single uuencoded text file.  For 
  97. example:
  98.  
  99.          UUxT a myfiles.uue myprog game 
  100.  
  101.   This would uuencode the files 'myprog' and 'game' and put them into a
  102. single uuencoded file, 'myfiles.uue'.
  103.  
  104.   Now to decode myfile.lha.uue, you would enter:
  105.  
  106.          UUxT x myfile.lha.uue
  107.  
  108.   If I wanted to decode the uuencoded files "prog.uue" and "game.uue", I
  109. could use:
  110.  
  111.          UUxT x prog.uue game.uue
  112.   
  113.   This saves the time of having to seperatly decode the two files.
  114.  
  115.   If I had a uuencoded file that had been split into multiple parts, that
  116. have not yet been joined, and are on multiple volumes, I coule use:
  117.  
  118.          UUxT x df0:part1.uue df1:part2.uue ram:part3.uue
  119.  
  120.   This saves the time of joining files, and allows you to decode files
  121. that normally wouldn't fit on a single disk.  NOTE: Some "split" programs
  122. split files in the middle of a line, instead of at the end of a line.  If
  123. you have an archive that was been split on one such program, you must first
  124. join the files.  Try to use a spliter that splits at a line number to be
  125. compatible with this option.  Also, make sure you put the parts in the 
  126. correct order, or the output file will be scrambled. 
  127.  
  128.   If I had the files m1, m2, and m3 in the current directory, and wanted
  129. to LhA and uuencode them I could use:
  130.  
  131.            UUxT l myfile.lha.uue myfile.lha m1 m2 m3
  132.  
  133.   "myfile.uu" will then be created, and will contain the LhA'd file
  134. "myfile.lha" which contains the files m1, m2 and m3. NOTE: When 
  135. using the "l" option, you MUST specify an LhA archive name, complete
  136. with the ".lha"!
  137.  
  138.   To automatically decode/de-lha the file "myfile.uu" I would use:
  139.  
  140.                    UUxT u myfile.lha.uue
  141.  
  142.   If by any chance you get an "unexpected end of input" when you try to
  143. decode a .uue file, your file transferring procedure may be adding CR's or
  144. something to the file.   Use a CR-stripper, like TC or Filter, to remove
  145. them first, then decode the file.  When you get back on the board, see if 
  146. there's some CR setting you can adjust to eliminate them. If you still
  147. recieve an error message, then part of the uuencoded file has been cut off,
  148. or has been corupted. 
  149.  
  150. Info
  151. ----
  152. The decoding routines were ported in part from various Un*x programs, and 
  153. the original authors are unknown.
  154.  
  155. UUxT will decode all uuencoded files (even if they still have mail headers,
  156. etc.  in them), from any source (hopefully :) (unless they're corrupt.  :-) 
  157. Please mail me if you have any trouble.
  158.  
  159. UUxT is Copyrighted (C)1993 by Asher Feldman.  You my freely distribute UUxT,
  160. and use it for any non-commercial purpose you wish, as long as you leave the
  161. original files intact.  Commercial usage is prohibited, without written
  162. consent by the author.  If you like UUxT, please feel free to send money to
  163. the address below.
  164.  
  165. You can contact me at the following addresses:
  166.  
  167. E-Mail
  168. ------
  169. PORTAL:       Wizard0                       
  170. Internet:     Wizard0@cup.portal.com      
  171.               asher@shell.portal.com
  172.  
  173. US Snail:   (send checks here :-)                                                     
  174.                                                               
  175.         Asher Feldman                                         
  176.         4791 Calle de Tosca             
  177.         San Jose, CA  95118
  178.  
  179.  
  180. And remember :
  181.  
  182. ONLY       _   C_o m m o d o_r_e   _                              
  183.           /\\  l\\   /l ll //  \  /\\                          
  184.          /  \\ l \\ /ll ll(< __  /  \\    MAKES IT POSSIBLE!!!!
  185.         /--- \\l  \X ll ll \\_ll/--- \\                        
  186.        /______________________________\\
  187.  
  188.  
  189.  
  190.  
  191.                                                        A. F.
  192.  
  193.