FindIn 3.0 (19940308)        --- ---
                                                       (o) (o)
                          by Stephen D Childers           ^
                                                       \_____/

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

   1) Program is used for finding a specific pattern within a file and
      then prints the location offset within that file. Location will
      be printed in hex format.

      Using option -d will display characters that surround pattern.

   2) Runs only from CLI.

   3) Can be made resident.

   4) Program (when run from CLI) will interact with the 'c:Why' command
      after program failures; this command may provide a more detailed
      explanation of 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 argument, file,
      device, (etc) that is associated with failure when it occurs.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CLI usage:

   1> FindIn [!|?] [[-options] file pattern]

       ! = show author info

    options c = case insensitive search
            d = display characters surrounding pattern
            h = pattern is hex format. (string format is default)

    file    = The input file.

    pattern = Pattern to find.
   _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

   1) Maximum length of pattern is restricted by the maximum limits
      observed by the CLI.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CLI Examples:

   1> FindIn -cd anyfile "DF1:"

      This example will take the file 'anyfile' and find all occurances
      (any case condition) of the string pattern "DF1:"

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
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 3.0 (19940308) -
   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).
   2) Added option -d.
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   Version 19930728 -
   1) Optimized and refined source code thereby making program smaller.
   2) Ctrl-C key will now break program properly.
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
   Version 19920116 - The first version.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      /M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\
    /M\W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/M\
  /M\W/                                                         \W/M\
  \W/       8   Thine hand shall find out all thine enemies:      \W/
  /M\    thy right hand shall find out those that hate thee.      /M\
  \W/       9   Thou shalt make them as a fiery oven in the time  \W/
  /M\    of thine anger: the Lord shall swallow them up in his    /M\
  \W/    wrath, and the fire shall devour them.                   \W/
  /M\                                                             /M\
  \W/         The Holy Bible of God Almighty - Psalms 21:8-9      \W/
  /M\                     (King James by the way)                 /M\
  \W/M\                                                         /M\W/
    \W/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\W/
      \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/

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