home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / programming / misc_programming / finders.doc < prev    next >
Text File  |  1993-01-24  |  6KB  |  163 lines
  1.                        A PAIR OF FINDERS
  2.  
  3. Maybe these are better described as "locators."  The idea was to 
  4. make utilities that would just find the files for me, and do 
  5. that very quickly and easily.  After all, this is normally all I 
  6. really want to know, and in the course of a working day I want 
  7. to know it often.  For example in a complex programming project 
  8. with zillions of small files, I can quickly find out where a 
  9. certain variable or string is located or used, and so on.  So 
  10. the commands are quickly and easily typed, and the utility makes 
  11. no attempts to show you context or any other details.  By all 
  12. means use more elaborate utilities if you need to know such 
  13. details.
  14.  
  15. These have been used by myself and others for several years now, 
  16. and the users are enthusiastic and have not really wanted more 
  17. of them.
  18.  
  19.                            FFIND.COM
  20.  
  21. FFIND (FastFIND) is an easy-to-use and blindingly fast 
  22. string-search utility.  It is very simple and offers few 
  23. options.  FFIND will search a directory for files containing the 
  24. specified string, and also the subdirectories of that directory.  
  25. It reports only the path and name of each file containing the 
  26. string.
  27.  
  28. The search is case-insensitive (upper/lower case matched) and 
  29. the 8th bit is ignored (search WordStar and like files as well 
  30. as plain ASCII).  All "white space" is matched--a space in the 
  31. search string will match any number of consecutive spaces, tabs, 
  32. or line-endings in a target file (white space compression). 
  33. FFIND will run significantly faster if you don't have any spaces 
  34. in your search string because it does not work as hard.
  35.  
  36. The string argument is not delimited by anything.  Whatever you 
  37. type is matched, including any included, leading, or trailing 
  38. spaces.  The default search directory is the current directory.  
  39. Change to root first and FFIND will search the whole disk, if 
  40. you are really forgetful!  You may enter a different directory 
  41. as an argument preceding the string.
  42.     
  43. The first space following such a directory will NOT be part of 
  44. the following string (It's the delimiter), so if you want the 
  45. string to start with a space, put an extra one in.
  46.  
  47. RESTRICTED SEARCH: You can confine FFIND to a search of only 
  48. the current directory by using "." (current directory) for the 
  49. optional directory argument.  If you follow the dot with a 
  50. filespec, then only the specified files in the current directory 
  51. will be searched.
  52.  
  53. SKIP LIST: By default FFIND will look at all files.  You can 
  54. make a skip list, which tells FFIND certain files to skip.  Just 
  55. put a list of file extensions to skip in a file called SKIP.FF.  
  56. Skipping the search of useless files could be a real timesaver.  
  57. Usually you'll not want to search binary files or archive files, 
  58. for instance.  Here are some extensions that are good candidates 
  59. for a skip list:
  60.  
  61. COM EXE SYS BIN BAK OVR OVL ARC ZIP LZH ZOO DIC LIB LOD LD1 LD2
  62.  
  63. FFIND will look for a possible SKIP.FF in the directory it 
  64. starts its search in.  You can have a different skip list for 
  65. each major directory if you like.  If FFIND doesn't find SKIP.FF 
  66. in the starting directory, it will look for a "generic" SKIP.FF 
  67. in the root.  If you've specified a restricted file search in 
  68. the command line, the skip lists are ignored.
  69.  
  70. Use any plain ascii editor to make your skip list.  Separate the 
  71. extensions with "white space" of some kind.  For example, these 
  72. are both OK:
  73.  
  74.     COM EXE SYS
  75.  
  76.     COM
  77.     EXE
  78.     SYS
  79.  
  80. You can make your skip list with the "copy con" procedure.  The 
  81. following sequence would make the first skip list above:
  82.  
  83.     COPY CON SKIP.FF <return>
  84.     CON EXE SYS^Z <return>
  85.  
  86. ...where "^Z" means the Ctrl-Z key.
  87.  
  88. COMMAND EXAMPLES:
  89.  
  90.     FFIND john dehaven
  91.     
  92.         Finds all files in current and subdirectories containing
  93.         "John DeHaven", 
  94.         "aBcJoHn DeHaVeNxYz",
  95.         "john      DEHAVEN", 
  96.              ^ (tab here instead of space)
  97.         "JOHN   DeHaven",
  98.              ^^^ (3 spaces)
  99.         "John
  100.         DeHaven" (broken by line ending), 
  101.         ...etc.
  102.  
  103.     FFIND . john dehaven
  104.     
  105.         As above, except confined to current directory.
  106.  
  107.     FFIND .*.asm john dehaven
  108.     
  109.     As above, except confined to *.asm files in current 
  110.     directory.
  111.     
  112.     FFIND \doc john dehaven
  113.     
  114.     As above, except searches \doc and subdirectories of \doc.
  115.     
  116.     FFIND  \doc john dehaven
  117.           ^-(note extra space here)
  118.         Searches for string " \doc john dehaven" so there is a way 
  119.         to do that, too.
  120.  
  121.     FFIND  john dehaven 
  122.           ^------------^ (extra leading and trailing spaces)
  123.         Finds " John DeHaven " but NOT "aJohn DeHavenz"
  124.     
  125.     FFIND \ john dehaven
  126.     
  127.         Another desperation search of the whole disk.
  128.     
  129.                              WI.COM
  130.  
  131. WI (WhereIs) searches a disk for files you've misplaced.  A 
  132. utility very much like this one was released by PC magazine, and 
  133. this is a slight improvement.  Most of the improvement is in 
  134. ease of use.  The list of files found may be redirected, but the 
  135. messages will not be.  Stop WI by striking any key.
  136.  
  137. WI [optional drive letter] filespec [filespec filespec ...]
  138.  
  139. Examples:
  140.  
  141.     WI *.bat *.com
  142.     
  143.         Finds all batch files and all COM files in your current
  144.         disk.
  145.     
  146.     WI *
  147.     
  148.         Finds all files with no extension in your current disk.
  149.         (Does NOT report directories or "dot" files.)
  150.     
  151.     WI z??.*
  152.     
  153.         Finds all files with 3-letter names starting with "z" 
  154.         and any (or no) extension in your current disk.
  155.     
  156.     WI a *.bat
  157.     
  158.         Finds all batch files on drive A.
  159.     
  160.     WI a:*.bat
  161.     
  162.         Harder-to-type way to find batch files on drive A.
  163.