home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsf / jbfnd24c / JBFIND.TXT < prev    next >
Text File  |  1995-01-21  |  12KB  |  351 lines
  1.                                 JBFind
  2.                           (formerly Search)
  3.                              Version 2.4
  4.                            (c)JBSoft 1992-4
  5.                  with loads of help from Tom Dolbilin
  6.  
  7. JBFind is a program that will search for files or text/hex within
  8. files, optionally down directory trees, across drives and within files
  9. that are open. Please report any bugs or funnies as soon as possible
  10. so that I can sort out any teething problems. Please not that all the
  11. code was written by me - Tom is the ideas man on this project. If you
  12. have any problems please direct them my way.
  13.  
  14. The program is installed in the usual way by copying it to an \APP\
  15. directory using your preferred Link program, from the System screen,
  16. pressing Psion-I and selecting JBFind.OPA. If you do not wish to use
  17. the program as an Application but as an .OPO file, simply place it in
  18. an \OPO\ directory and rename it to JBFind.OPO. It will then run just
  19. like any other OPO file and will appear under the RunOPL icon.
  20.  
  21. The first options given when running the program is whether to search
  22. for a file, to search within files or go straight to the list viewer.
  23. Next, either the filename is prompted for, or the text to search for
  24. within files. If Search Within was selected then an option for case
  25. sensitivity is also available. Filenames permit wildcards (e.g.
  26. AGENDA.*).
  27.  
  28. If you require a Hex search then input the Hex digits preceded by the
  29. '$' character and make sure that each digit comprises of two
  30. characters (e.g. $AB010020 would mean search for the digits AB 01 00
  31. 20). The Hex stream will be converted to ASCII characters and the
  32. search will actually look for that string. You may keep a space
  33. between the hex characters if you wish but you should only use '$' at
  34. the start of the search string and _not_ before each Hex value.
  35.  
  36. The drives to search are also selected at this stage - the choices are
  37. individual (A/B/M/ROM), selected (Choose), all (Every) drives or down
  38. a directory tree (Tree). The program is intelligent and only offers
  39. drives that exist. To select Choose or Tree select the option, keep
  40. the cursor on that line and press Enter.
  41.  
  42. Although ROM:: has been included it is only implemented as a stand-
  43. alone search and cannot be included with other drives at present.
  44.  
  45. If Choose is selected an additional dialog is given - push the buttons
  46. of the drives you wish to include in the search (a tick will appear to
  47. show selection). The buttons act as a toggle so deselection is also
  48. possible. Once the drive selection has been completed, press Escape
  49. and you will return to the previous dialog. Press Enter and the search
  50. will start.
  51.  
  52. If the Tree option is chosen a dialog will be shown which allows a
  53. directory and drive to be chosen. This will be the start point for the
  54. search.
  55.  
  56. Sound can be chosen on the main dialog - the options are No/Yes or
  57. just beep On completion of the search - the default is sound off (No).
  58. If enabled (Yes), the computer will beep when files are found or if
  59. there is a problem.
  60.  
  61. Closing Apps
  62. ------------
  63. If searching within files has been selected then an option is included
  64. to enable the search of all files or only closed files. There are
  65. actually three options - All / Only Closed / Partial. If the All
  66. option is selected then all open Applications are closed before the
  67. search and opened up afterwards (if possible, any unsaved alterations
  68. will be saved when closing). Partial will only close those
  69. applications that have associated datafiles (e.g. Data, Agenda and
  70. Word).
  71. There is a limit as to how files can be opened up so, if you are in a
  72. Memo within the Agenda, after the search has ended you will be in the
  73. Agenda proper rather than the Memo.
  74.  
  75. The program will attempt to open you in the view (e.g. Day or Week)
  76. mode you left the Agenda in but, if your datafile takes more than 5
  77. seconds to load you will end up in the Day mode regardless of which
  78. mode you were in originally.
  79.  
  80. I have tried to keep the various guises of Word correct (e.g. Program
  81. and Word) but there may be occasions when the file is opened in the
  82. wrong mode. If you come across this please let me know and I will
  83. endeavour to rectify the situation. At present, it seems to work in
  84. every mode that I use.
  85.  
  86. If only Closed or Partial files are chosen then any files that could
  87. not be searched will be displayed briefly as the program runs. When
  88. the option to save the results to a file has been taken then these
  89. unchecked files are also written to the file at the end of the list of
  90. found files.
  91.  
  92. Filenames that match or contain the text being searched for are
  93. displayed in a window as the search progresses. It is possible to
  94. terminate the search early by pressing Escape.
  95.  
  96. When the search is completed the list of files found or files that
  97. contained the search string are displayed in a simple viewer. Use the
  98. cursor controls to move around this list. A menu is available for
  99. additional options at this stage.
  100.  
  101. N.B. If Word files are password protected then JBFind will fail to
  102.      find the data - this is not a fault of JBFind but due to Word
  103.      encryption which is activated when Password protection is used.
  104.  
  105. Search Data
  106. -----------
  107. If search within was used then, on pressing Psion-I, some details of
  108. the find are shown. This shows where the string was found within the
  109. file and the part of the file that included the search string. Psion-I
  110. is a toggle - press it again to remove the information.
  111.  
  112. New Search
  113. ----------
  114. A new search can be started by pressing Psion-F. This option will
  115. ignore all currently found data and start again from scratch.
  116.  
  117. Narrow Search
  118. -------------
  119. It is possible to narrow down the search once the initial search has
  120. ended by pressing Psion-N. This will prompt for a new search string
  121. and the options to search For or In a file. If In a file is selected
  122. then, if the files are not already closed, an option will be given to
  123. search within only closed files or all files. This works in the same
  124. way as the main search routine. An additional option is to deselect
  125. files found so the list shown after the Narrow search will show less
  126. the files found on the last search (e.g. If original list was a file
  127. search for *.OP? then an excluding search of *.OPL will leave just OPO
  128. and OPA files).
  129.  
  130. N.B. The list of files previously found is not will not normally kept
  131. - although, if a narrow search does not find any matching files, the
  132. previous list is shown with the comment that no files were found.
  133.  
  134. Launch file
  135. -----------
  136. Psion-L (or Enter) will attempt to launch the highlighted file. When a
  137. file is launched and the Application is a built-in one, then the Find
  138. routine for that application should be accessed (all things being
  139. equal - they very rarely are), leaving you at the find position of the
  140. data within the file.
  141. Delete file
  142. -----------
  143. Psion-D will produce a dialog box which will enable you to delete the
  144. currently highlighted file. Be careful with this command as there is
  145. no way back once 'Y' is pressed as a response to whether you wish to
  146. delete the file or not.
  147.  
  148. Exclude File
  149. ------------
  150. Psion-R will remove the currently highlighted file from the list (but
  151. will not delete the file).
  152.  
  153. Sort List
  154. ---------
  155. An option to sort the list of found files is available -  use Psion-S
  156. to access this option. It is possible to select a sort on the
  157. Filename, the Extension to the file, the Directory and the Drive.
  158.  
  159. Save List
  160. ---------
  161. The list of found files can be saved to a text file using Shift-Psion-
  162. S. The default file is M:\FIND.DAT but can be altered to anything you
  163. wish.
  164.  
  165. Load List
  166. ---------
  167. A previously saved list can be reloaded using the command Shift-Psion-
  168. L. Before loading the file this checks that the list is one created
  169. earlier with JBFind otherwise an error is displayed.
  170.  
  171. Delete List file
  172. ----------------
  173. Shift-Psion-D will delete a previously saved list of found files. This
  174. command works in exactly the same way as Psion-D but starts off by
  175. defaulting to M:\FIND.DAT.
  176.  
  177. Other keys
  178. ----------
  179. Psion-A will produce an A