home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / rffsrt12.arj / RFFSORT.DOC < prev    next >
Encoding:
Text File  |  1991-07-27  |  4.6 KB  |  126 lines
  1. *******************************************************************************
  2. *                                   RFFSORT                                   *
  3. * Ron's Flexible File Sort program, RFFSORT V1.2, Jul 1991.                   *
  4. * Last Update : July 27, 1991.                                                *
  5. *******************************************************************************
  6.  
  7. What's New
  8. ----------
  9.   
  10.   Version 1.2 fixed a bug with several ram drives that gave an invalid 
  11.  media error, added count of number of records processed.
  12.  
  13.   With version 1.1 text files can be sorted using the -t switch, text files
  14.  are sorted with a maximum sort line size of the /Lxxxxx parameter.
  15.  
  16. Introduction
  17. ------------
  18.  
  19.   RFFSORT is a sort utility for files with fixed sized records, and text files,
  20.  RFFSORT can sort HUGE files, provided it has enough disk space to hold the 
  21.  temporary files. RFFSORT allows the user to sort the files using up to 10 sort
  22.  fields, that can be in acsending, and descending order.
  23.  
  24. Usage
  25. -----
  26.  
  27.   At the command line type RFFSORT and press Enter to receive a help screen,
  28.  this screen lists the programs command line format, and options.
  29.  
  30.          RFFSORT [e-options] input-file [e-options] [output-file] [e-options]
  31.    E-Options ..
  32.          @optfile - file of options
  33.          options  - options displayed below
  34.    Options ..
  35.          /Lxxxxx        - xxxxx characters per record
  36.          /Sf,sssss      - Start of f''th field at sssss
  37.          /Ef,eeeee      - End of f''th field at eeeee
  38.          /Of,d          - Order of f''th field is d, where d is A or D
  39.          /Dpath         - Path of working directory
  40.          /T             - File is a text file, with at most /Lxxxxx characters
  41.  
  42.    Notice - in option files, each option is at 1 line.
  43.           - f Values are 0 .. 9
  44.           - sssss, eeeee in 0..65535
  45.           - d is A = Acsending, D = descending
  46.  
  47.  (*) Points to notice :
  48.         
  49.         A. If you sort a file written with fixed length text strings,
  50.            terminated with the standard dos CR/LF remember to add 2
  51.            to the record length you specify to RFFSORT. 
  52.            (e.i. - the file looks like ..
  53.                 RECORD1...SOMEDATA...ENDOFRECORD1
  54.                 RECORD2...SOMEDATA...ENDOFRECORD2
  55.                 RECORD3...SOMEDATA...ENDOFRECORD3
  56.                 ...
  57.             The record length should be 33 + 2 = 35 )
  58.  
  59.         B. RFFSORT uses a merge sort algorithm that works on the storage 
  60.            device, remeber that if your file occupies X bytes on the
  61.            storage device, RFFSORT will need 2X free bytes on the work
  62.            directory to sort your file !
  63.  
  64. Warranty
  65. --------
  66.  
  67.   There is no warranty what so ever, The program is supplied as is,
  68.  The author (Loewy Ron), is not, and will not be responsible for any damages,
  69.  lost profits, or inconveniences caused by the use, or inability to
  70.  use this program. The use of the program is at your own risk. 
  71.  By using the program you agree to this.
  72.  
  73. General
  74. -------
  75.  
  76.   RFFSORT is copyrighted by myself, (c) Loewy Ron, 1991. 
  77.  
  78.   RFFSORT is free for personal non-commercial use, for commercial or corporate
  79.  use, please register your copy. (ORDER.TXT file is supplied).
  80.  
  81. Contact
  82. -------
  83.  
  84.   You can contact me on what-ever you want to at my address at :
  85.  
  86.         Loewy Ron,
  87.         9 Haneveem st.
  88.         Herzeliya, 46465
  89.         ISRAEL.
  90.  
  91.    OR 
  92.  
  93.         Loewy Ron, 
  94.         Apt. 1,
  95.         20 Smolanskin st.
  96.         Haifa, ISRAEL.
  97.  
  98.   Other programming units available from me include :
  99.  
  100.   mouseLib5 - an event driven mouse unit library.
  101.   tpDESQ11  - a DESQview interface library. (just some portions of the API).
  102.   kbdHdr30  - a keyboard interface unit.
  103.   parse10   - a recursive decent math. expression parser.
  104.  
  105.   Other public-domain, freeware and shareware programs by the same author
  106.  include :
  107.  
  108.   JM10          : Jumpin' math - a popup scientific calculator.
  109.   TXS20         : TeXt Search program.
  110.   3D110         : WWToolKit 3D demo applocation. (with Ishai Ben-Aroya).
  111.   WWToolKit     : OOPS GUI Turbo-Pascal library. (with Ishai Ben-Aroya).
  112.   MONITOR       : Popup memory monitor.
  113.   APP20         : Application Programable Pilot - menu system.
  114.   RPTP13        : Ron's Print To Printer program, formats, page breaks etc..
  115.   WRPTP13       : RPTP for Windows 3.0
  116.   RSS10         : Ron's Smart Search. TXS for multi record files.
  117.  
  118.  
  119. Credits
  120. -------
  121.  
  122.   RFFSORT was written using Turbo-Pascal V6.0, 
  123.    a copyright of Borland International.
  124.  
  125.   Windows 3.0 is a copyright of Microsoft Corp. Inc.
  126.