home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / new / util / cli / sort / sort.doc < prev    next >
Text File  |  1994-04-20  |  3KB  |  84 lines
  1. sort.doc    sort Version 1.23        by Rüdiger Werner
  2.  
  3. The program and files in this distribution are freely distributable,
  4. but are also copyright (c) Rüdiger Werner. They may be freely
  5. distributed as long as no more than a nominal fee is charged to cover
  6. time and copying costs.
  7. No commercial usage is permitted without written permission from the
  8. author. Everything in this distribution must be kept together, in original
  9. unmodified form.
  10. The above is generally known as freeware.
  11.  
  12. ***********************************************************************
  13. * Notice that the author can't be made responsible for the destroying *
  14. * or lost of data through use of this program. You use it on your own *
  15. * risc. Please read the Doc-file before using.                        *
  16. ***********************************************************************
  17.  
  18. Please contact me if you have any comments or suggestions
  19. or if you simply tried the program:
  20.  
  21.  E-Mail:  rw2@irz.inf.tu-dresden.de
  22.  
  23.  Mail:      Rüdiger Werner
  24.       Stresemannplatz 2
  25.       01309 Dresden
  26.       GERMANY
  27.  
  28.  
  29. Description
  30. -----------
  31.  
  32. The program was written for use in Shell only.
  33. It is started either by simply typing it's name (of course it should be
  34. in the current directory or in the path) or by giving additionally switches
  35. and/or the name of the file what should be sorted.
  36.  
  37.  sort [-a|d -g -e|E -n|N -o -t] infile [outfile]
  38.  
  39. By typing 'sort ?' appears a short help.
  40. The specified file is opened and red in the memory. There it will be sorted
  41. and, if the switches were set, manipulated in the required way.
  42.  
  43. Switches:
  44.  
  45. -a    sorting in ascending order (it is optional, because default)
  46.  
  47. -d    sorting in descending order
  48.  
  49. -g    actually the capitals and small letters are distinguished.
  50.     by setting this switch, they won't be distinguished.
  51.  
  52. -e    after sorting all lines which are empty will be erased.
  53.  
  54. -E    after sorting all lines which are empty or more than once in a file
  55.     will be erased (of course ONE line is kept in the file).
  56.  
  57. -n    the file is not sorted, only empty lines are erased.
  58.  
  59. -N    the file is not sorted, only empty lines and lines with the same
  60.     contents which are side by side are erased (of course ONE line is
  61.     kept in the file).
  62.     Note that it might more useful if the file is sorted.
  63.  
  64. -o    the specified file for reading will be overwritten by the sorted
  65.     file. DANGER!!! If once overwritten the original file can't be
  66.     restored!!!
  67.  
  68. -t    the file which was red will be written in reverse order of lines
  69.  
  70. The switches can be set at any place after the program-name.
  71. The maximum length of a line in a file is 1024 byte.
  72. All bytes that a line is longer than this are cutted.
  73.  
  74. The size of the file to be sorted depends only on the size of the available
  75. memory (and on your patience). The used time is shown after sorting, just
  76. for your statistics ...
  77. I have tested the programm with hundreds of different files and no loss
  78. of data appeared.
  79. Well, that's all I can tell about it.
  80.  
  81. Hope that you can use the program.
  82.  
  83. Rüdiger Werner
  84.