home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / o / ordig30.zip / ORDIGU.DOC < prev    next >
Text File  |  1992-06-05  |  5KB  |  109 lines
  1.  
  2.  
  3.  
  4.  
  5.                             ORDIGU 
  6.                            ======== 
  7.                                                ORDIGU.COM v. 3.0
  8.                                           (c) Pierre Jelenc 1991 
  9.  
  10.        ORDIGU.COM is a sorting program that alphabetizes text in English
  11.        or Esperanto (in the EZo system that uses ASCII 166, 224, 236-235
  12.        for the accented letters).
  13.  
  14.        ORDIGU is designed to work under DOS 3.0 or higher, including the
  15.        4DOS command processor from JP Softaware (free plug for a highly
  16.        recommanded shareware replacement for Command.com). ORDIGU will
  17.        not work under DOS 2.0, since temporary file creation and some
  18.        error handling require functions available only starting in 3.0.
  19.        This version now exits gracefully if it detects an earlier
  20.        version of DOS.
  21.  
  22.        ORDIGU is able to sort files of any length containing up to
  23.        32,766 records. The records may be terminated either by <CR><LF>,
  24.        i.e. ASCII 13 ASCII 10 (That is the combination you get when you
  25.        press the "Enter" or "Return" key), or now by a user-defined
  26.        delimiter. The user-defined delimiter may be any of the following
  27.        characters:
  28.  
  29.        - Control codes at ASCII 17 to 31
  30.        - The characters ], }, _, ^, ~
  31.        - The graphics characters at ASCII 174 to 223
  32.  
  33.        Important: if you use one of the alternate delimiters, you must
  34.        include a blank line at the begining of your input file,
  35.        otherwise the first line would end up appended to the one it
  36.        should follow in the alphabetized list. ORDIGU will refuse to
  37.        sort a file that does not begin with <CR><LF> if an alternate
  38.        delimiter is used. The reason is that under these conditions a
  39.        record will go from the preceeding <CR><LF> to the delimiting
  40.        character.
  41.  
  42.  
  43.        Alphabetization ignores case ("A" and "a" are treated as
  44.        equivalent), and accepts non alphabetic characters such as
  45.        digits, punctuation, and graphics characters, except for ASCII
  46.        254 (■), which is used internally.
  47.  
  48.        ORDIGU requires a fair amount of memory, and will tell you if it
  49.        is unable to load its internal tables. In such a case, try to
  50.        remove the large TSRs that are eating up your memory and try
  51.        again. ORDIGU should run in about 395,000 bytes, or 384 K of
  52.        available memory.
  53.  
  54.        The sorting routines involve almost continuous disk access;
  55.        therefore it is preferable to run ORDIGU from a RAM disk for any
  56.        but the smallest files (say over 100 records). Disk access is the
  57.        slowest step, and the use of a RAM disk speeds up the processing
  58.        considerably; so does the use of a cache. ORDIGU.COM itself may
  59.        be anywhere as long as its exact path is given, or it is
  60.        accessible through your PATH.
  61.  
  62.        ORDIGU creates an output file with the ORD extension added to the
  63.        name of the input file. It will not accept an input file with the
  64.        ORD extension. If the output name is already present (from a
  65.        previous session for instance), ORDIGU will not delete it;
  66.        instead it will give a machine-generated random name to the NEW
  67.        output. It is up to you to then rename your files.
  68.  
  69.        To start ORDIGU, first move to a RAM disk if possible. Neither
  70.        ORDIGU.COM nor the input file have to be on the RAM disk itself,
  71.        although it will speed up the run. Type:
  72.  
  73.        [Optional path to \]ORDIGU [/#] [optional path to \]Input.doc
  74.  
  75.        where # is the character used as a delimiter. For instance
  76.  
  77.        D:>c:\iloj\ORDIGU /] c:\tekstoj\listo
  78.  
  79.        will run from drive D: the program present on drive C: in the
  80.        Iloj subdirectory, with the character "]" as the delimiter on the
  81.        file listo in the \tekstoj subdirectory. The temporary file will
  82.        be on drive D:, and the output will be listo.ord in \tekstoj.
  83.  
  84.        ORDIGU creates a temporary file on the default drive (hence the
  85.        move to a RAM disk) and does the ordering from it. When the
  86.        alphabetization is done, it creates an output file with the ORD
  87.        extension in the same directory as the input file. Because
  88.        sorting can take a long time, the screen is updated at each step
  89.        to let you follow the process. If your output goes to the RAM
  90.        disk, remember to save it before turning off you computer.
  91.  
  92.        What can go wrong? The only serious errors should be disk
  93.        input/output errors which will interrupt the process. Your input
  94.        file will always be safe however, because it is never written to.
  95.  
  96.        ORDIGU.COM was written in assembly language, and assembled by A86
  97.        and debugged by D86 (shareware (c) Eric Isaacson). The sorting
  98.        algorithm is the 'Combsort' of S. Lacey and R. Box (BYTE, April
  99.        1991, pp 315-320).
  100.  
  101.        ORDIGU can be used with non-EZo transcription systems with the
  102.        help of the conversion programs in TRANS20.ZIP
  103.  
  104.  
  105.        This program is copyrighted freeware, 1992.
  106.        Pierre Jelenc
  107.        Internet:     pcj1@cunixf.cc.columbia.edu
  108.        Compuserve:   71022,1726
  109.