home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 March / Chip_1999-03_cd.bin / zkuste / delphi / D3 / XSEARCH3.ZIP / XS3READ.TXT < prev    next >
Text File  |  1997-09-23  |  6KB  |  184 lines
  1. Extended Search version 2.0 for Delphi 3.
  2.  
  3. To Install Extended Search, ensure all files are in the same
  4. directory:
  5.  
  6.   XSearch3.dll
  7.   XS3Inst.exe
  8.   XS3Unins.exe
  9.   XS3Read.txt
  10.  
  11. Then run XS3Inst. Extended Search will appear under Delphi's search
  12. menu the next time Delphi 3 is started. To uninstall, run XS3Uninst.exe.
  13.  
  14. WHAT DOES IT DO?
  15.  
  16.   Ever get tired of the DOS-shell -> GREP -> Task switch -> File|Open ->
  17. Search|Find cycle? What a waste of time. Ever forget which unit TIndexDef is
  18. declared in? Well, I always did. 
  19.   Extended Search is an Add-In expert which brings GREP-Like functionality to
  20. Delphi's Search menu, allowing you to search through multiple files for a
  21. specific character pattern, display each occurence in its particular context,
  22. and open the desired file in the Delphi editor with the cursor positioned at
  23. the line of interest, saving a LOT of keystrokes. It supports all the
  24. basic GREP options: Expression searches, Case-sensitivity, whole word, and sub-directory
  25. searches, line numbers and filenames only.
  26.  
  27. HOW DO I USE IT?
  28.  
  29. Extended Search's fundamentals are pretty much like GREP. You specify a search
  30. string, a file or group of files, and some options and it returns a list of the
  31. occurences of the search string in those files. The two distinguishing features
  32. of this version of Extended Search are File Aliases and the Search Results list.
  33.  
  34. File Aliases:
  35. The File Specification edit box takes either an explicit file set specification
  36. (i.e., c:\delphi32\source\vcl\*.pas) or a File Alias. Aliases are defined in the
  37. properties page (reached via the local menu). To enter a new alias, right-click
  38. and choose 'Add Item' or press the INSERT key.
  39.  
  40. Search Results:
  41. The search results are displayed in the Search Results Tree-View. Use the space
  42. bar, mouse double-click, or right arrow to expand each node and view the context
  43. of each occurrence of your search string in a particular file. Press the spacebar
  44. or double-click on an occurrence and the file is opened in the Delphi editor and
  45. the cursor is positioned on that line. Spacebar, double-click or left arrow again
  46. contracts and expanded node.
  47.  
  48. New Features for 2.0:
  49.  
  50. -Searching is done in an interruptible background thread.
  51.  
  52. -Supports GREP-style regular expressions, where the following characters
  53. have special meanings:
  54.  
  55.      ^ (start of line)
  56.  
  57.         Example: ^Delphi
  58.         Matches the line
  59.           "Delphi Component Library"
  60.         but not
  61.           "{ Delphi Component Library }"
  62.  
  63.      $ (end of line)
  64.  
  65.         Example: Integer;$
  66.         Matches the line
  67.           "function Foo: Integer;"
  68.         but not
  69.           "function Foo: Integer; virtual;
  70.  
  71.      ? (any single character)
  72.  
  73.         Example: co?y
  74.         Matches
  75.           "copy" and "cozy"
  76.         but not
  77.           "cop" or "coy"
  78.  
  79.      \ (treat next character as literal)
  80.  
  81.         Example: co?y\?
  82.         Matches
  83.           "copy?" and "cozy?"
  84.  
  85.      * (match zero or more occurences of next character)
  86.  
  87.         Example: jo*ly
  88.         Matches
  89.           "jolly" and "joy"
  90.  
  91.         Combine with "?" for a wildcard:
  92.         Example: jo*?y
  93.         Matches any character between "o" and "y":
  94.           "jolly", "joy", "john murphy", "joe smythe", etc.
  95.  
  96.      + (match one or more occurences of next character)
  97.  
  98.         Example: jo+ly
  99.         Matches
  100.           "jolly"
  101.         but not
  102.           "joy"
  103.  
  104.         Combine with "?" for a wildcard which requires
  105.         one character in between:
  106.  
  107.         Example: jo+?y
  108.         Matches at least one character between "o" and "y":
  109.           "jolly", "john murphy", "joe smythe", etc.
  110.         but not
  111.           "joy"
  112.  
  113.      Sets of characters may also be specified as:
  114.        [aeiou0-9]   match a, e, i, o, u, and 0 thru 9
  115.        [~aeiou0-9]  match anything but a, e, i, o, u, and 0 thru 9
  116.  
  117.        Example: [cr-t]ough
  118.        Matches
  119.          "cough", "rough" and "tough"
  120.        but not
  121.          "dough"
  122.  
  123.        Example: [~rt]ough
  124.        Matches
  125.          "cough" and "dough"
  126.        but not
  127.          "rough" or "tough"
  128.  
  129. -Searches open editor files if they match the current filespec.
  130.  
  131. -Optionally searches all files in the current project ("current project"
  132. is defined by the Delphi IDE API as those modules appearing in the project
  133. manager.
  134.  
  135. -Multiple filespecs are allowed, semi-colon delimited. In addition,
  136. on the properties page you may specify a list of default extensions
  137. (also semi-colon delimited) which will be used when any filespec omits
  138. the filename. For example, the filespec
  139.  
  140.     d:\delphi30\source\vcl; c:\batch\*.bat
  141.  
  142. with default extensions as
  143.  
  144.     pas;inc
  145.  
  146. which will search all files with .inc and .pas extension in d:\delphi30\source\vcl
  147. and only files with .bat extension in c:\batch.
  148.  
  149. -The form is now resizable.
  150.  
  151. -There is a customizable menu hotkey.
  152.  
  153. -Can optionally grab current token from editor window when form is activated.
  154.  
  155. -Drop-down list for file specs.
  156.  
  157. REGISTRATION:
  158.  
  159. Registration is $15 ($30 will include the complete source code, including the
  160. regular expression search engine), and, upon request, includes Extended Search
  161. v 2.0 for Delphi 2.0 and Borland C++Builder 1.0.
  162.  
  163. To register:
  164.  
  165. - On the Internet:
  166.     http://www.got.net/~duncan/delphi.htm
  167.       or
  168.     http://www.shareit.com/programs/100451.htm. Alternatively, you can 
  169.     go to http://www.shareit.com and enter the program number there: 100451. 
  170.  
  171. - On Compuserve: 
  172.     GO SWREG, #15652
  173.  
  174. - Snail Mail: Send a check to
  175.     Mark Duncan
  176.     P.O. Box 671
  177.     Ben Lomond, CA 95005-0671
  178.  
  179. If you find any problems or have any additional suggestions, please contact
  180. me at "duncan@got.net"
  181.  
  182. Thanks,
  183. Mark Duncan
  184.