home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / archiver / esscod36 / uucoder.doc next >
Text File  |  1993-07-07  |  8KB  |  177 lines
  1.                            ESS UUEncode/UUDecode 3.6
  2.  
  3.                                  PUBLIC DOMAIN
  4.  
  5.                           Copyright 1993, Michel Forget
  6.                     
  7.  
  8. I N T R O D U C T I O N
  9. -=-=-=-=-=-=-=-=-=-=-=-
  10.  
  11.     ESS UUEncode/UUDecode 3.6 will allow you to convert binary files to
  12. ASCII text files, or return ASCII text files to their original binary
  13. state.
  14.  
  15.     Why on earth would you want to do this?
  16.     
  17.     Well, the answer is simple; when computer networks such as the Internet
  18. were created, no provision for transfering binary files was made.
  19.  
  20.     In order to fill this gap, UUEncode & UUDecode were created.  Although
  21. this was done a long time ago, not much has changed.  The networks still
  22. require files to be transmitted in an ASCII format, and people are still
  23. required to use UUEncode & UUDecode if they want to share binary files.
  24.  
  25.     Why should you use this version instead of one of the other ten or
  26. twenty currently available?
  27.  
  28.     Here are three good reasons:
  29.     
  30.         a)  SPEED - ESS UUEncode/UUDecode is much faster than other
  31.             coding programs that I have tested.  In some cases, the
  32.             difference is as much as 350%!
  33.  
  34.         b)  APPEARENCE - ESS UUEncode/UUDecode uses GEM!  This means
  35.             that you are given a nicely formatted progress display (which
  36.             shows the output file, the input file, the currently active
  37.             parameters, the source and destination path, and a growing
  38.             thermometer bar that indicates how much of the current file
  39.             has been processed).  Since it is a GEM program, you can
  40.             access your desk accessories at any time, and set your options
  41.             using pull down menus.
  42.  
  43.         c)  COMPATABILITY - While UUEncode & UUDecode have remained roughly
  44.             the same, the Atari ST has not.  ESS UUEncode/UUDecode has
  45.             support for the ARGV command line standard that Atari has put
  46.             forward.  It also have support for the Mark Williams C xArg
  47.             command line standard, and the default command line standard
  48.             used by older ST systems.
  49.  
  50. I N S T A L L A T I O N
  51. -=-=-=-=-=-=-=-=-=-=-=-        
  52.  
  53.         There are many different ways to use ESS UUEncode/UUDecode!
  54.     
  55.         The most common method of use is to simply run the program.  You can
  56.     use the menu bar to select the options you want, and initiate an
  57.     encoding or decoding operation.
  58.     
  59.         If you have a hard disk, you may want to install ESSCODER.PRG as
  60.     an application.  Make sure that the "current directory" is set to
  61.     _TOP WINDOW_ or the proram will not function correctly.  Also, be
  62.     aware that some versions of TOS do not handle installed applications
  63.     correctly.
  64.     
  65.         If you want to get especially fancy, you can install ESSCODER.PRG
  66.     on the desktop as an icon.  This allows you to process an entire
  67.     GROUP of files at one time.  Simply select the files you want to
  68.     process, and drag them over to the ESSCODER icon.  ESS UUEncode/UUDecode
  69.     will _automatically_ decide whether each file should be encoded or
  70.     decoded.  If you are encoding files, though, you should be aware that
  71.     the default options (full paths, no segmentation) will be used.
  72.  
  73. O P T I O N S
  74. -=-=-=-=-=-=-
  75.  
  76.     There are not many options, but there are more than any other
  77. UUEncode/UUDecode program has:
  78.  
  79.     1)  Full Paths - This allows you to tell ESS UUEncode/UUDecode to
  80.         either place only the filename (filename.ext) inside the
  81.         encoded file(s), or to place the entire pathname.  The default
  82.         with most other programs of this nature seems to be full paths,
  83.         but I prefer having only the filename (since that is the way
  84.         it has to be if you plan to distribute your encoded file for
  85.         others to decode).
  86.         
  87.     2)  Segmentation - An encoded file can be broken into pieces, which
  88.         will be automatically joined together when being decoded.  This
  89.         makes it easier for UUCP mailing software.  You can choose one of
  90.         the preset sizes, or set your own.
  91.  
  92. A C K N O W L E D G E M E N T S
  93. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  94.  
  95.     I would like to thank Steve Wells for supplying me with the source code
  96. to UUCODER 1.0.
  97.  
  98.     I would like to thank Steve Yelvington for writing UUCODER, and placing
  99. the source code in the public domain.
  100.  
  101.     I would also like to thank Ian Lepore, who wrote the HSC "C" compiler
  102. and GemFast, two programs which made the development of ESS UUEncode/UUDecode
  103. possible.
  104.     
  105. D I S C L A I M E R
  106. -=-=-=-=-=-=-=-=-=-
  107.  
  108.     I have made every effort to ensure that these programs are bug free,
  109. but that does not mean that they are.  If you use these programs, you do so
  110. at your own risk.  I will not accept responsability for equipment
  111. damage, data loss, or any other unforseen consequence of the use
  112. or mis-use of these programs.
  113.  
  114. C O N T A C T I N G   T H E   A U T H O R
  115. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  116.  
  117.     If you would like to contact me with bug reports, suggestions, or
  118. comments, you can do so through the following addresses (in order of
  119. personal preference):
  120.  
  121. Internet:  mforget@elfhaven.ersys.edmonton.ab.ca
  122.  
  123. TurboNet:  Lord Chimara @ 100:3/0  (Temple Of Doom)
  124.     NeST:  Lord Chimara @ 90:220/3 (Temple Of Doom)
  125. AtariNet:  Lord Chimara @ 51:710/0 (Temple Of Doom)
  126.     FNET:  Michel Forget @ 236     (The B.E.A.C.H.)
  127.  
  128.     Mail:  Michel Forget
  129.            #45-1503 Millwoods Road East
  130.            Edmonton, Alberta
  131.            CANADA
  132.            T6L 4C2
  133.  
  134. C L O S I N G
  135. -=-=-=-=-=-=-
  136.  
  137.     I sincerely hope that you like and use these programs.  They are free,
  138. so you may distribute them any way you please, so long as the files in this
  139. archive remain unmodified and unseperated.  If there are enough requests,
  140. I will send the source code for these programs to comp.sources.atari.st.
  141.  
  142.     Electric Storm Software has released one other product;
  143.     
  144.     !NEW NEW NEW! - MasterBrowse (described below) can now interface
  145.                     (transparently) with MegaDepack, so it can handle up
  146.                     to seventeen different types of compressed text files!
  147.  
  148.     MasterBrowse 2.5 -- An excellent GEM text file viewer absolutely packed
  149.     with features!  MasterBrowse can have a virtually unlimited number of
  150.     documents open at one time (subject only to the limits of your system).
  151.     It has extensive searching features (case sensitive or case insensitve,
  152.     forward or backward, current position or top of document).  MasterBrowse
  153.     also has powerful printing features (page headers, page numbers, line
  154.     numbers, page descriptions).  Every single window has a set of ten
  155.     bookmarks, a set of block markers (which can be used to save a block to
  156.     disk, print a block, clip a block, or expand a block into a seperate
  157.     window).  More?  MasterBrowse supports batch files!  This is only a
  158.     brief list of the things this program can do.  If you want to get this
  159.     program, you can download it from your local bulletin board system, FTP
  160.     site, or pay service.  If you want the optimized version (smaller, faster)
  161.     then you can send $15 to me at the address listed in the "CONTACTING THE
  162.     AUTHOR" section above.
  163.  
  164.         The "C" source code for MasterBrowse is available as well, for a
  165.     negotiable fee.  Contact the author for more details.  Users who send in
  166.     the donation also receive AutoDate, a program that keeps track of the
  167.     time and date with virtually no effort on the part of the user.  Simply
  168.     hold down the SHIFT key once a day, and the date will never be wrong again.
  169.     A notepad desk accessory and a demo of ShadowTerm II (a terminal program
  170.     written by Electric Storm Software) are also included on the disk.
  171.     
  172.  
  173.                                                  -Michel Forget
  174.                                                   Electric Storm Software
  175.                                                   May 30th, 1993
  176.  
  177.