home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / cli_util / spluu.lha / SplUU / spluu.doc < prev    next >
Text File  |  1993-08-28  |  4KB  |  138 lines
  1. ******************************************************
  2. *                                                    *
  3. *     //////   //////   //    //     //  //     //   *
  4. *   ///   ///  //  ///  //    //     //  //     //   *
  5. *   ////       //  ///  //    //     //  //     //   *
  6. *     ////     /////    //    //     //  //     //   *
  7. *       ////   //       //    ///    //  ///    //   *
  8. *  ///   ///   //       //     ///   //   ///   //   *
  9. *   //////     //       /////    ////       ////     *
  10. *                                                    *
  11. ******************************************************
  12.  
  13.                    VERSION V01.07
  14.  
  15.     `SplUU', a UUEncoding file splitter, for email.
  16.  
  17.            (c)1993 Psilocybe Systems Inc.
  18.  
  19.           email: wyrd@ministry.demon.co.uk
  20.  
  21.  
  22.  
  23.  Whassit do then?
  24.  ~~~~~~~~~~~~~~~~
  25.  
  26.  OK folks, here's the worlds greatest utility ever. No, really.
  27.  
  28.  It takes a file and UUEncodes it, and then it cuts it up in 2000
  29. line blocks. It also gives each block a header and a tail, which
  30. proclaim:
  31.  
  32. ----------- Start of block, numbered 1 of 5 files. -----------
  33.  
  34.  And also:
  35.  
  36. ------------ End of block, numbered 1 of 5 files. ------------
  37.  
  38.  Good, eh? Well, I thought so.
  39.  
  40. Syntax for use:
  41. ~~~~~~~~~~~~~~~
  42.  
  43. spluu [-?] | <[UUEncoded]file> <output_file> [-a] [-d] [-e]
  44.  
  45.  The -a flag will, if set, make SplUU overwrite any existing files
  46. which share the same filename as <output_file>.
  47.  
  48.  The -d flag will, if set, make SplUU delete the <[UUEncoded]file>
  49. after the output files have been written.
  50.  
  51.  The -e flag will, if  set, make SplUU assume that the <[UUEncoded]file>
  52. has been previously UUEncoded, and will try to split it without attempting
  53. to UUEncode.
  54.  
  55. Example use:
  56. ~~~~~~~~~~~~
  57.  
  58.  Given a pre-UUEncoded file called `testfile.uue', we could:
  59.  
  60. spluu testfile.uue outfile -a -d -e
  61.  
  62.  This would create NN number of files, depending on the length of the
  63. input file, in the format:
  64.  
  65. outfile.NN
  66.  
  67.  Note that `testfile.uue' will have been deleted, due to the `-d' flag
  68. being set. Also, if there were any existing files with filenames such
  69. as `outfile.01' they will have been overwritten without any warning
  70. messages given, due to the `-a' flag being set. The `-e' flag is set
  71. to prevent SplUU from trying to UUEncode the input file, which had
  72. already been UUEncoded.
  73.  
  74.  
  75.  Known Bugs
  76.  ~~~~~~~~~~
  77.  
  78.  Hasn't crashed yet. :)
  79.  
  80.  Version Information
  81.  ~~~~~~~~~~~~~~~~~~~
  82.  
  83.  01.04
  84.  -----
  85.  
  86.   Bwahahaha! Forget it.
  87.  
  88.  01.05
  89.  -----
  90.  
  91.   Complete re-write. Almost works. :)
  92.  
  93.  01.06
  94.  -----
  95.  
  96.   Faster, better, works fine. Added a UUEncode function as default.
  97.   Beta release.
  98.  
  99.  01.07
  100.  -----
  101.  
  102.   Cosmetic changes only. Included `SplUUi' in the package - it's a
  103. GUI version of SplUU. 
  104.  
  105.  Future plans
  106.  ~~~~~~~~~~~~
  107.  
  108.  Well, I'd like to make it a bit faster. And get it to interact
  109. with email somehow. And give it an ARexx port. And lots of
  110. other things.
  111.  
  112.  Send bug reports/ideas/cannabis to:
  113.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  114.  wyrd@ministry.demon.co.uk
  115.  
  116.  
  117.  Thanks to:
  118.  ~~~~~~~~~~
  119.  
  120.  Cool people at Demon Internet Systems who pointed me in the right
  121. direction. Nico Francois and Jaba Development, without whom I would
  122. never had bothered to learn anything about Intuition. Ozric Tentacles
  123. for the trippy head sounds, Henry Rollins for the angst and Nymphs
  124. for the tragedy. #wiccans for putting up with me, and most of all,
  125. an owl. :)
  126.  
  127.  
  128. ***************************************************************
  129.  
  130.               (c)1993 Psilocybe Systems Inc.
  131.  
  132.         wyrd@ministry.demon.co.uk -- IRC:Midnight
  133.  
  134.  This software is #wiccaware - if you like it, /msg me! :)
  135.  
  136. ***************************************************************
  137.  
  138.