home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / PMGREP.ZIP / PMGREP.DOC next >
Text File  |  1993-04-20  |  4KB  |  140 lines
  1. =============================================================================
  2.  
  3.                      PMGREP File Text Search Utility
  4.                      -------------------------------
  5.  
  6.                                    by
  7.  
  8.                             David J. Pagliughi
  9.  
  10. =============================================================================
  11.  
  12. While searching various on line services, I noted that I couldn't find a GREP
  13. port to the OS/2 Presentation Manager environment.  While developing an Order
  14. Processing system in OS/2 I found that I was opening a DOS session and 
  15. running a DOS based version of GREP (that came with the Borland Turbo 
  16. Assembler) several times each day.  I decided to devlop a PM based GREP 
  17. program for my own use to avoid having to keep opening that DOS session and 
  18. trying to remember the command parameters.  This PMGREP program is the result 
  19. of that programming effort.  It is written in C and was compiled using the 
  20. IBM CSET/2 -- IBM WorkFrame environment.
  21.  
  22. =============================================================================
  23.  
  24. Program Operation:
  25.  
  26.     1.  Enter the search string.  Quotes are not required.  Wild Cards
  27.         are permitted (see Note 1).
  28.  
  29.     2.  Enter the starting search path and file mask.
  30.  
  31.     3.  Select the desired options.
  32.  
  33.     4.  Select Start.  The status field displays the file names as they
  34.         are searched.  When the search is complete, 
  35.  
  36.             ### Search Complete ###
  37.  
  38.         is displayed in the status field.
  39.  
  40.     5.  Optionally, double click on a file name or any text line
  41.                displayed for a file to edit the file with the OS/2 System
  42.         Editor (must be C:\OS2\E.EXE).
  43.  
  44.  
  45. Options:
  46.  
  47.     Case Sensitive:
  48.  
  49.         If Case Sensitive is selected, the upper/lower case sense of
  50.         the search string must be matched exactly in the search file.
  51.  
  52.  
  53.     Absolute Search String:
  54.  
  55.         If the Search String contains the characters * or ? and you 
  56.         are searching for these characters (not using them as
  57.         wildcards - Note 1), you MUST select this option.
  58.  
  59.  
  60.     Search Subdirectories:
  61.  
  62.         If this option is selected, files is lower subdirectories
  63.         with the same file mask will be seached also.
  64.  
  65.  
  66.     File Names Only:
  67.  
  68.         The default output display is:
  69.  
  70.             ***** File: File Path\Name
  71.             Text line containing search string
  72.             ...etc.
  73.  
  74.         Selecting File Names Only will omit the display of the text
  75.         lines in the output display list box.
  76.  
  77.  
  78.     Display Line Numbers:
  79.  
  80.         If selected, each line of text containing the search string
  81.         is prefixed by the line number within the file.
  82.  
  83.  
  84.  
  85. Other Options:
  86.  
  87.     Clear:
  88.  
  89.         The Clear button clears the Search String, File Specification
  90.         and the Search Results listbox.  It does NOT reset the
  91.         Options.
  92.  
  93.  
  94.     Quit:
  95.  
  96.         Close and Exit the application.
  97.  
  98.  
  99. =============================================================================
  100.  
  101.  
  102. Note 1.  Search String Wild Cards.
  103.  
  104.     The asterisk (*) and question mark can be used as wild card 
  105.     characters.  They retain the meanings normally assigned to DOS and
  106.     OS/2 directory operations.
  107.  
  108.  
  109. Note 2.  Source Code.
  110.  
  111.     Much of the file specification parsing and search string find 
  112.     portions of the program are based on the CSET/2 -- WorkFrame
  113.     GREP example provided by IBM.
  114.  
  115.  
  116. Note 3.  Planned Enhancements.
  117.  
  118.     -  Add On Line Help.
  119.     -  Separate the file parsing and searching portions of the program
  120.        into a separate thread to allow:
  121.  
  122.         -- Stop Search Button
  123.         -- Scrolling through the output listbox before the search is
  124.            complete.
  125.         -- Permit editing a file before the search is complete.
  126.  
  127. =============================================================================
  128.  
  129. PMGREP is freeware and as such you may freely distribute it as long as this
  130. document file is included with the executable and no fee is charged.  As 
  131. freeware, you take full responsibility for using the program and I am in no 
  132. way responsible for any damage or loss you may suffer either directly or 
  133. indirectly from using this program.
  134.  
  135.  
  136.         David J. Pagliughi
  137.         CPC International
  138.         Englewood Cliffs, NJ
  139.  
  140.         April 19, 1993