home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / bbs / util / mayflower.lha / MayFlower / FindIn / FindIn.doc < prev    next >
Encoding:
Text File  |  1994-05-04  |  4.0 KB  |  96 lines
  1.  
  2.                           FindIn 3.0 (19940308)        --- ---
  3.                                                        (o) (o)
  4.                           by Stephen D Childers           ^
  5.                                                        \_____/
  6.  
  7. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  8. Program Description:
  9.  
  10.    1) Program is used for finding a specific pattern within a file and
  11.       then prints the location offset within that file. Location will
  12.       be printed in hex format.
  13.  
  14.       Using option -d will display characters that surround pattern.
  15.  
  16.    2) Runs only from CLI.
  17.  
  18.    3) Can be made resident.
  19.  
  20.    4) Program (when run from CLI) will interact with the 'c:Why' command
  21.       after program failures; this command may provide a more detailed
  22.       explanation of why the program failed.
  23.  
  24.       The 'Why' command should be used immediately after a program
  25.       failure to extract the last program's result code, because
  26.       that result code is changed upon the execution of the next CLI
  27.       command.
  28.  
  29.    5) Certain error reports will contain the name of the argument, file,
  30.       device, (etc) that is associated with failure when it occurs.
  31.  
  32. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  33. CLI usage:
  34.  
  35.    1> FindIn [!|?] [[-options] file pattern]
  36.  
  37.        ! = show author info
  38.  
  39.     options c = case insensitive search
  40.             d = display characters surrounding pattern
  41.             h = pattern is hex format. (string format is default)
  42.  
  43.     file    = The input file.
  44.  
  45.     pattern = Pattern to find.
  46.    _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  47.  
  48.    1) Maximum length of pattern is restricted by the maximum limits
  49.       observed by the CLI.
  50.  
  51. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  52. CLI Examples:
  53.  
  54.    1> FindIn -cd anyfile "DF1:"
  55.  
  56.       This example will take the file 'anyfile' and find all occurances
  57.       (any case condition) of the string pattern "DF1:"
  58.  
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60. Version History:
  61.  
  62.    The following information briefly describes changes or improvements
  63.    made to each version, and they will be described in descending order;
  64.    meaning latest version information begins first:
  65.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  66.    Version 3.0 (19940308) -
  67.    1) Changed version numbering format. Program can now be used with the
  68.       "Version" command. Date within parenthesis is shown in a somewhat
  69.       international format as (yyyymmdd).
  70.    2) Added option -d.
  71.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  72.    Version 19930728 -
  73.    1) Optimized and refined source code thereby making program smaller.
  74.    2) Ctrl-C key will now break program properly.
  75.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  76.    Version 19920116 - The first version.
  77.  
  78. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  79.       /M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\
  80.     /M\W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/M\
  81.   /M\W/                                                         \W/M\
  82.   \W/       8   Thine hand shall find out all thine enemies:      \W/
  83.   /M\    thy right hand shall find out those that hate thee.      /M\
  84.   \W/       9   Thou shalt make them as a fiery oven in the time  \W/
  85.   /M\    of thine anger: the Lord shall swallow them up in his    /M\
  86.   \W/    wrath, and the fire shall devour them.                   \W/
  87.   /M\                                                             /M\
  88.   \W/         The Holy Bible of God Almighty - Psalms 21:8-9      \W/
  89.   /M\                     (King James by the way)                 /M\
  90.   \W/M\                                                         /M\W/
  91.     \W/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\_/M\W/
  92.       \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/ \W/
  93.  
  94. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95.                             End Of Document
  96.