home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MTQ_V401.ZIP / MTQDOCEN.DOC < prev   
Encoding:
Text File  |  1989-06-24  |  8.4 KB  |  197 lines
  1. ╔══════════════════════════════            ┌─────────────────┐
  2. ║ MTS       Make Them QuickSort            │     Member      │────┐
  3. ║                                          │     of the      │░░░░│
  4. ╟──────────────────────────────            │                 │░░░░│
  5. ║ (c) 1989  Robert W.van Hoeven            │ Badhoevedorp    │░░░░│
  6. ╟──────────────────────────────            │   Pascal        │░░░░│
  7. ║ Release : 4.01                           │     Programmers │░░░░│
  8. ║ Rel.Date: 23th June 1989                 │       Collective│░░░░│
  9. ╠══════════════════════════════            └─────────────────┘░░░░│
  10. ║                                               │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTQ.EXE                                     └─────────────────┘
  12. ║ │                                                ┌─────┐
  13. ║ │                                                │░░░░░│
  14. ║ │                                                └──┬──┘
  15. ║ │ Lines starting with '|' are                  ┌────┴────┐
  16. ║ │ changes to TSO 3.02 !!        ┌ ─ ─ ─ ─ ─ ─ ─││││││ ═══│─ ─ ─ ─ ─ ─ ─ ┐
  17. ║                                                └─────────┘
  18. ╠═══════════════════════════════  │     ┌─────┐   │   B   │   ┌─────┐     │
  19. ║ Address: Robert W. van Hoeven         │░░░░░│   │ P + P │   │░░░░░│
  20. ║          PO. Box 131            │     └──┬──┘   │   C   │   └──┬──┘     │
  21. ║          1170 AC  Badhoevedorp      ┌────┴────┐ └───────┘ ┌────┴────┐
  22. ║          Nederland / Holland    └ ─ ││││││ ═══│─ ─ ─ ─ ─ ─││││││ ═══│ ─ ┘
  23. ╚═══════════════════════════════      └─────────┘           └─────────┘
  24.  
  25.  
  26.  Preface
  27.  ───────────────────────────────────────────────────────────────
  28.  Please notice the following:
  29.  
  30.  - MTQ is a ShareWare product in every right way;
  31.  - This means the software confirms to 'WYSIWYG' (What You See Is What
  32.    You Get);
  33.  - You are asked to register the program by sending me a postcard or
  34.    letter to the address above. Most people who have (or use) a PC, have
  35.    the money for 1 stamp and some paper or postcard. I am very pleased
  36.    with it, and if you have some questions concerning the program, I will
  37.    try to answer them;
  38.  - The author can not be made responsible for damage of any kind, as a
  39.    direct or indirect result of using the supplied software !
  40.  
  41.  
  42.  History
  43.  ───────────────────────────────────────────────────────────────
  44.  
  45.  Everyone knows that DOS's SORT is very, very slow. There are several
  46.  packages (public-domain/shareware) on the marked. This program adds
  47.  another one to the list, but this one is free.
  48.  
  49.  MTQ is the former TSO. TSO had to be registered (no one did) to do
  50.  the work. The new version (named MTQ for Make Them QuickSorted) adds
  51.  another program in the 'Make Them' series and like its brothers and
  52.  sisters, the usage is free, altough you have to send me a postcard
  53.  when you use the program on a frequent base.
  54.  
  55.  MTQ is an intelligent (?) shell around Turbo Power's <tm> MSort
  56.  routine, as found in the B-Tree Filer <tm> package.
  57.  MTQ add's a number of features to the power of this sort routine:
  58.  
  59.  - You can sort on keys;
  60.  - You can replace SORT with MTQ
  61.  
  62.  In its most simple version, MTQ can replace the normal SORT on your
  63.  machine, but the major benefit of this program is to sort files
  64.  bigger than 64K. The only restriction to the length of the sorted
  65.  file is the number of bytes free on the current drive.
  66.  
  67.  MTQ is a text-sort. I am working on a newer release with some options
  68.  for sorting non-text files but for now I keep them in store.
  69.  
  70.  
  71.  Installation
  72.  ───────────────────────────────────────────────────────────────
  73.  You can place MTQ.EXE (optional renamed to SORT.EXE) in one of
  74.  the directories in your path. When yu rename MTQ to SORT, please
  75.  keep in mind to remove or rename the old SORT.
  76.  
  77.  
  78.  Usage
  79.  ───────────────────────────────────────────────────────────────
  80.  MTQ is simple to use. The syntax for running MTQ is:
  81.  
  82.  MTQ {{<}{infile}} {{>}{outfile}} {switches} {sortkey ...  sortkey}
  83.  
  84.  infile      : Infile is the input text-file that has to be
  85.                sorted. If you do not specify an input-file,
  86.                the console is used for input;
  87.  
  88.  outfile     : Outfile is the output file that is sorted.
  89.                If you do not specify an output-file, the screen
  90.                is used for output;
  91.  
  92.  You can use redirection, piping or filenames mixed or all the same.
  93.  The following combinations are allowed:
  94.  
  95.  
  96.  MTQ test1 test2     file       to file
  97.  MTQ <test1 test2    redirected to file
  98.  MTQ test1 >test2    file       to redirected
  99.  MTQ <test1 >test2   ridirected to redirected
  100.  MTQ test1 test1     file internal sort
  101.  MTQ <test1 >test1   redirected internal sort
  102.  MTQ test1           file       to screen
  103.  MTQ >test2          console    to redirected
  104.  MTQ                 console    to screen
  105.  
  106.  The combination MTQ test2, where test2 has to be the output-file, is
  107.  NOT allowed. You can specify MTQ CON test2 or better MTQ >test2.
  108.  
  109.  The first NOT-switch/NOT-sortkey is seen as the input-file, the
  110.  second as the output file.
  111.  
  112.  switches    : /?     : MTQ gives you help on the syntax;
  113.  
  114.                /C     : Sort without looking at the case. 'Input'
  115.                         is the same as 'INPUT' or 'InPuT';
  116.  
  117.                /Txxxx : MTQ creates some temporary files. You can
  118.                         instruct MTQ to change the first 5 letters
  119.                         of this file to something of your own.
  120.  
  121.                /I     : /I will give you info on the sort. This comes
  122.                         in handy with large text files. You will get
  123.                         information about the number of bytes on disk
  124.                         that are needed, the number of EMS pages and
  125.                         so on. /I does NOT result in the actual sort.
  126.                         It is needed to read the entire input-file,
  127.                         so this option is not so handy when you have
  128.                         to key in the input from the console;
  129.  
  130.                /R     : /R is compatible with SORT's /R switch. When
  131.                         you supply /R the file is sorted in descending
  132.                         order;
  133.  
  134.                /E     : When you specify /E, you instruct MTQ NOT to use
  135.                         any EMS available. If you don't have EMS, forget
  136.                         about /E;
  137.  
  138.  
  139. sortkey      : You can specify up to 25 sort-keys. The have the following
  140.                syntax:
  141.  
  142.                [direction][colomn]:[length]
  143.  
  144.                [direction] can by + (ascending) or - (descending) and
  145.                [column] and [length] have to be num. values. The max.
  146.                length of a record can be up to 255 bytes (a normal
  147.                text-file value). You can not overlap keys, neither
  148.                specify a key:length combination that goes beyond the
  149.                255th position of the record. You CAN specify a key
  150.                that lies beyond the length of some records.
  151.  
  152.  
  153.  Limits
  154.  ───────────────────────────────────────────────────────────────
  155.  MTQ knows only one limit and that is the maximum length of each
  156.  record. A record must terminate with a LF+CR and can be up to 255
  157.  bytes in length.
  158.  
  159.  
  160.  Errorlevels
  161.  ───────────────────────────────────────────────────────────────
  162.  MTQ will report a non-zero errorlevel when something is wrong.
  163.  Only the /I will always report 0.
  164.  
  165.  0 : Everything ok or info requested on a valid file
  166.  8 : You asked for help
  167.  16: Something very wrong
  168.  
  169.  
  170.  Version history
  171.  ───────────────────────────────────────────────────────────────
  172.  
  173.  3.02     : Last TSO version
  174.  4.01     : Added MSort routines
  175.  
  176.  Copyright, Trademarks
  177.  ───────────────────────────────────────────────────────────────
  178.  
  179. |MTS is written in Turbo Pascal 5.0, with help of the Turbo Debugger 1.0
  180. |and makes extensive use of Turbo Professional 5.01 and B-Tree Filer 1.0.
  181.  
  182.  Turbo Pascal       is a trademark of Borland International
  183.  Turbo Debugger     is a trademark of Borland International
  184.  Turbo Professional is a trademark of TurboPower Inc.
  185.  B-Tree Filer       is a trademark of TurboPower Inc.
  186.  MSort              is a trademark of TurboPower Inc.
  187.  
  188.  Sorry for my usage of the English language, it's not my native language
  189.  so this can happen.
  190.  
  191.  If you have suggestions, additions or other comments, you can leave a
  192.  message, addressed to me (Rob Van.hoeven) at QuickBBS Support Europe
  193.  (SysOp Reinier de Groot) 2:2/100 (2:500/3)
  194.  
  195.  NOTE: Remember to put a point between Van and Hoeven when sending
  196.        Net-Mail messages !!!!!!
  197.