home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / cli / fsort / fsort.doc < prev    next >
Text File  |  1994-12-12  |  2KB  |  78 lines
  1.  
  2.                  File Sorting Utility -- Replacement of C:Sort
  3.  
  4.                  (c) 1994 Martin Mares, MJSoft System Software
  5.  
  6. ================================================================================
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    FSort,  its  documentation and the ss.library are Copyright (c) Martin Mares,
  13. MJSoft System Software, Prague, Czech Republic.
  14.  
  15.    This  archive  can  be  freely redistributed, as long as all of its files are
  16. included   in   their   original   form  without  any  additions,  deletions  or
  17. modifications,  and  no more than a nominal fee is charged for its distribution.
  18. All  copyright notices in the programs and accompanying documentation files must
  19. remain  on  their  places.  Also '.displayme' and other similar files may not be
  20. added.  This is generally known as FREEWARE.
  21.  
  22.    This  software  is  provided  "AS  IS"  without  warranty of any kind, either
  23. expressed  or  implied.   The author is not responsible for any damage caused by
  24. it.
  25.  
  26.    Assembly  source  of this program is included, but if you make any changes, I
  27. will  be  pleased  if  you  send  them  to me and I'll incorporate them into new
  28. version.   Please don't distribute modified versions of this software without my
  29. permission.
  30.  
  31.  
  32. Introduction
  33. ============
  34.  
  35.    File sorting... Hmm... C:Sort does this... But it's very sssslllllooooowwwww.
  36. ARP Sort sorts slightly faster.
  37.  
  38.    - FSort tries to be much more better.
  39.  
  40.    - FSort supports input from stdin and output to stdout (PIPES !!!).
  41.  
  42.    - FSort eats less RAM (but slightly more than ARP Sort).
  43.  
  44.    - FSort requires Kickstart 2.04 or higher.
  45.  
  46.    - FSort is pure and can be made resident.
  47.  
  48.    - FSort takes advantage of the powerful ss.library (also in this archive,
  49. see SSLib<???>.lha on the AmiNet for complete distribution).
  50.  
  51.    Speed comparison: (280K file, on GVP A530 Turbo - 68EC030 40MHz)
  52.  
  53.       original C:Sort 37.3    36 seconds    380K used
  54.       ARP Sort            27 seconds    317K used
  55.       FSort            4.9 seconds    334K used
  56.  
  57.    All the timings are mesaured by Stat 1.0 (available in MJUtils.lha on AmiNet).
  58.  
  59.  
  60. Usage
  61. =====
  62.  
  63.    FSort must be started from the shell.
  64.  
  65. Syntax: FSort [<source> [<dest>]] [CASE]
  66.  
  67.    source - source file (standard input if omitted)
  68.      dest - destination file (standard output if omitted)
  69.      CASE - perform case-dependent sorting
  70.  
  71.    Destination identical to source is allowed.
  72.  
  73.  
  74. Notes
  75. =====
  76.  
  77.    Send suggestions, flames and bug reports to <mjsoft@k332.feld.cvut.cz>.
  78.