--- ---
         (o) (o)           Dissect 2.0 (19940307)
            ^
         \_____/           by Stephen D Childers

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Program Description:

   1) Dissect a file and give various reports.

   2) Can be run from CLI.
      This version of Dissect should not be made resident; program will
      work upon first invocation if resident, but will fail upon
      subsequent invocations.

   3) The time required to dissect a 100,000 byte file will be about
      60 seconds with 8MHZ CPU, and about 10 seconds with 25MHZ CPU.

   4) Program (when run from CLI) will interact with the 'c:Why' command
      after program failures; this command may provide more information
      as to why the program failed.

      The 'Why' command should be used immediately after a program
      failure to extract the last program's result code, because
      that result code is changed upon the execution of the next CLI
      command.

   5) Certain error reports will contain the name of the arg, file,
      device, (etc) that is associated with failure when it occurs.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CLI Usage:

   Usage > Dissect [?|!] [-options file [tokenfile]]

      ? = show some help
      ! = show author info
      -options:
         g = general info (use only on text files)
         c = list characters used (use on any file)
         w = list words used (use only on text files)
           n = print number of words used
           i = ignore case
           ln = lower length limit. Program will ignore words below
                this length. Default value for n = 1; n must be a
                decimal value.
           un = upper length limit. Program will ignore words above
                this length. Default value for n = 4,294,967,295; n must
                be a decimal value.

      file = the file to dissect

      tokenfile = a file that defines token (word) indicators

   1) The tokenfile argument will allow the user to inform Dissect
      which character symbols to use in detecting a token (word).

      The text within file "Dissect.tokens" will explain how to prepare
      and use the tokenfile argument; tokenfile should only be
      used when dissecting text files using option -w.

      If the tokenfile argument is not provided by user then the
      internal default is to detect the following letters and symbols as
      part of a token:
                           A-Z :upper case letters
                           a-z :lower case letters

      All other symbols and characters not listed will indicate
      end of token when encountered.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CLI Example:

    > Dissect -wl3u7 anytext tokenlist

    The above example will process all words in which the length is
    within 3 and 7. The formula looks like this:
    length >= 3 and length <= 7.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Version History:

   The following information briefly describes changes or improvements
   made to each version, and they will be described in descending order;
   meaning latest version information begins first:
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   Version 2.0 (19940307) -
   1) Changed version numbering format. Program can now be used with the
      "Version" command. Date within parenthesis is shown in a somewhat
      international format as (yyyymmdd).
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   Version 19930730 - The first version.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
       ____ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ____
     __|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|__
   __|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|__
 __|___|                                                       |___|___|
 |___|__      8   But the fearful, and unbelieving, and the      |___|__
 __|___|   abominable, and murderers, and whoremongers, and      __|___|
 |___|__   sorcerers, and idolaters, and all liars, shall have   |___|__
 __|___|   their part in the lake which burneth with fire        __|___|
 |___|__   and brimstone: which is the second death.           __|___|__
 __|___|__                                                     |___|___|
 |___|___|__     King James Holy Scripture - Revelation 21:8   __|___|__
 __|___|_ _|_ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ _|_ _|___|
 |___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|
   |___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|___|

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                           End Of Document