home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / f / filefind / !FileFind / !Help < prev    next >
Text File  |  1992-12-12  |  14KB  |  254 lines
  1. »»»» !Help file for !FileFind 2.11
  2.  
  3. Written by Andrew J. Cawte - public domain version
  4.  
  5. This version of !FileFind is public domain - you can copy and distribute it
  6. freely, via any media, as long as:
  7.  
  8.  i) You do not sell this program for a profit, or include it on a disc for
  9.     which you are charging (a small charge to cover media and postage is OK).
  10.     I retain the exclusive copyright on this application.
  11.  
  12. ii) The application is supplied complete and unaltered, including this file.
  13.     
  14. =============================================================================
  15.  
  16. What is !FileFind?
  17. ------------------
  18.  
  19. !FileFind is a utility to search for files buried down many directory levels.
  20. Given some information about the file and somewhere to start looking, it will
  21. recurse throughout the directory tree, searching for files which fit the
  22. description. Such files can be listed, have directory viewers opened for them,
  23. or can be acted on by a '*' command.
  24.  
  25. Using !FileFind - setting up
  26. ---------------
  27.  
  28. Start !FileFind by double clicking - it will install an icon on the icon bar. 
  29. Clicking on this icon brings up a large dialogue box.
  30.  
  31. The top writeable icon is where the filename is entered - click on it, then
  32. type in the name to search for. Below this are two radio buttons labelled
  33. 'Exact' and 'Containing'. Click on 'Exact' if you want to match that name only
  34. (although searching is not case-sensitive), or 'Containing' if you want to find
  35. all files whose names contain the name given. For example, if you entered
  36. '!Run' as the name to search for, then 'Exact' would match the name !Run only,
  37. whereas 'Containing' would match !Run, !RunImage, Old!Run etc. If the filename
  38. is not important, don't type in a name, and select 'Containing'. All filenames
  39. will be matched.
  40.  
  41. To the right of the filename are two option buttons, 'Files' and 'Dirs/Apps'.
  42. These select what type of item is searched for - if 'Files' is on then files
  43. will be searched for, and if 'Dirs/Apps' is on then directories will be
  44. searched for also. If neither button is on (ie. neither directories nor
  45. files are being searched for) then nothing will be found (obviously!),
  46. although you may still start the search.
  47.  
  48. Below these options are two more radio buttons, 'Fast' and 'Background'.
  49. These allow you to choose the method of searching - if 'Fast' is selected,
  50. then nothing else can be done while !FileFind is searching for a file.
  51. Choosing 'Background' makes the search fully multi-tasking (ie. you may
  52. continue to use the machine while !FileFind is busy), but is not as fast.
  53. Background mode searching is highly recommended unless you need to quickly
  54. find something buried deep on a hard disc.
  55.  
  56. If 'Files' is on, then a further option is ungreyed. This is the 'specific
  57. filetype' option, and it allows the search to be restricted to files of a
  58. certain type only. If you know the file type number, then type it into the left
  59. hand icon and press <RETURN>. If you only know the textual filetype, then type
  60. it into the right hand icon and press <RETURN>. Clicking on the small right
  61. pointing arrow next to these icons brings up a menu of some of the available
  62. filetypes - these can be selected by clicking on them.
  63.  
  64. Below these is another group of icons, which allow files of a certain length
  65. to be searched for. If you want to search for files which are longer than a
  66. certain length, select 'Longer'. Similarly, to search for files which are
  67. shorter than a certain length, select 'Shorter'. To search for files which
  68. are approximately, or exactly, a certain length, select 'To within'.
  69.  
  70. Selecting any of these will ungrey the 'length' icons - type the length in
  71. here. Clicking on the small grey box cycles the units between bytes, kbytes
  72. and Mbytes.
  73.  
  74. If you selected 'To within', then another pair of icons becomes accessable.
  75. The writable icon on the left allows you to specify an allowable difference
  76. between the length you entered and those that will be matched. Clicking on
  77. the other icon cycles the units for the error in a similar way to the units
  78. for the general length to search for, but with the added unit 'percent'. If
  79. this unit is selected then the error is taken to be a percentage of the
  80. length.
  81.  
  82. For example, if the length is specified as 1000 bytes, and you entered the
  83. allowable error as being 25 percent, then any file with a length between 750
  84. and 1250 bytes would be matched (subject to name and filetype being correct,
  85. of course). Similarly, if you entered the error as being 250 bytes, the same
  86. limits would apply.
  87.  
  88. Below these are three more option buttons, 'Open viewer', 'List' and
  89. 'Command'. These determine what action will be taken when a file is found.
  90. If 'Open viewer' is on, then a Filer window will be opened for the directory
  91. containing the file. If 'List' is on, then the full pathname of the file
  92. will displayed on screen in a window when it is found (background mode) or
  93. stored and displayed in a window when the search is over (fast mode). If
  94. 'Command' is on, then the OS '*' command in the writeable icon below will be
  95. executed whenever a file is found. The system variable 'Item' is set to the
  96. full pathname of the file before the command is executed. This allows
  97. !FileFind to be used for more than just locating files. For example, you
  98. could lock all !RunImage files on the disc by typing '!RunImage' as the
  99. filename, turning 'Command' on and typing the command 'ACCESS <ITEM> LR'
  100. into the writeable icon in the middle of the window.
  101.  
  102. If 'List' is on, then a further facility becomes available when the search
  103. is finished. Clicking <MENU> over the list-of-files window brings up a menu
  104. option leading to a standard 'save' dialogue box, allowing you to save the
  105. list of files found as a text file. This file can be saved to disc or
  106. dragged straight into a !Edit window.
  107.  
  108. Under the 'Command' writeable icon are three more option buttons. 'Search in
  109. application directories' allows you to choose whether or not to look for
  110. files inside such directories - not searching them can save a lot of time!
  111. If 'Beep when item found' is on, then the computer will beep (VDU7)
  112. whenever a file is found. 'Search many floppies' allows you to do just that
  113. - each disc will be searched in turn, then you will be prompted to insert
  114. another. If using this method of searching, then the path window (see
  115. below) is not used - instead, use one of the radio buttons marked 'Drive'
  116. to choose which floppy disc drive to search. Icons for drives not fitted
  117. will be greyed out.
  118.  
  119. The path window is used to tell !FileFind where to start searching for a
  120. file. To specify a path to search, drag an object (a file or directory)
  121. from a Filer window into the path window. The pathname of that object will
  122. appear in the window. When the search is started, that path will be
  123. searched in recursively. Up to 20 paths may be searched in one go by
  124. dragging each to the path window in turn.
  125.  
  126. For example, suppose you want to look for a file, and you know that it's a
  127. text file of some kind. You might drag items from directories
  128. 'adfs::HardDisc4.$.TextFiles' and 'adfs::HardDisc4.$.1WP.Documents' to the
  129. path window, then start the search. You would, if you tend to keep files in
  130. their proper directories, have a good chance of finding the file by
  131. searching just these two paths, and it would be quicker than searching
  132. through the whole disc.
  133.  
  134. Clicking MENU over the path window brings up a menu with three options on it
  135. - 'Remove', 'Clear All' and 'Save >'. Choosing 'Remove' forgets the path
  136. that you clicked MENU over, 'Clear All' forgets all the paths, and 'Save'
  137. leads to a standard save dialogue box, which allows you to save a list of
  138. paths to disc for future reference - this may save you the bother of
  139. dragging items from each of 15 or 20 directories every time you want to
  140. search a specific part of your hard disc. For example, you may well save
  141. time by setting up !FileFind to search your whole hard disc except for your
  142. !Fonts directory, and then save the list of paths. To re-load a path list,
  143. just drag it into !FileFind's main window. The paths in the file will be
  144. added to those already there withot erasing them first. This does, of
  145. course, mean that if you drag a path file from a directory, that dire