home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 6 / RISCWORLD_VOL6.iso / !HTMLsrch / !HELP < prev    next >
Encoding:
Text File  |  2001-02-04  |  3.8 KB  |  92 lines
  1.  
  2.      ===========================================================
  3.       !HTMLsrch - Fast searching of HTML files on RISC World CD
  4.                         © David Holden 2001
  5.      ===========================================================
  6.  
  7. This program will search the HTML files of the RISC World Volume 1
  8. Magazine CD. It will create an HTML file which can be Saved and then
  9. loaded into a browser. This will then give links to each file where the
  10. search string was found. 
  11.  
  12. As well as the link a single line of text where the search string was
  13. found can also be included to illustrate the context.
  14.  
  15.         The control window
  16.         ------------------        
  17.  To use the program run it in the usual way and then click SELECT on the
  18. icon. The main control window will then open.
  19.  
  20. At the left-hand side are four option buttons, 'Reverse', 'Whole words',
  21. 'Case sensitive' and 'Show line'.
  22.  
  23. If 'Reverse' is OFF then the search will start at Issue 1. If 'Reverse'
  24. is ON then, as you might guess, the search starts with Issue 7 and goes
  25. backwards. This is often useful because the most recent entries will be
  26. found first.
  27.  
  28. If 'Case sensitive' is ON only text which matches the case of the search
  29. string will be found, if it is OFF case is ignored. If the search string
  30. is 'Test' then with this option ON only exact matches will be found, if
  31. OFF 'test', TEST, etc. will also be matched.
  32.  
  33. If 'Whole words' is ON then the matched text will need to be complete
  34. words. For example, with this off, if you were searching for 'test'
  35. words like 'latest', 'tests', 'testing' would also be found. With it ON
  36. only the word 'test' would be found. (Please see the notes under
  37. 'Problems' before using this option).
  38.  
  39. If 'Show line' is ON then a line of text where the search string was
  40. found will be shown after the link. If it was found more than once in a
  41. file then each line where it was found will be included. If 'Show line'
  42. is OFF then just the link will be shown.
  43.  
  44.         Using HTMLsrch
  45.         --------------
  46.  Using the program should be self evident. When you have entered the
  47. search string (which must have at least three characters) and set the
  48. various buttons as you want them just click on 'Begin' or press RETURN.
  49.  
  50. The '#' (hash) character is used as a 'wildcard' which means it will
  51. match any single character. For example, 'de#d would match 'dead' or
  52. deed'.
  53.  
  54. All you will see until the search is complete is the file being searched
  55. and the matches in being counted.
  56.  
  57. When the search is complete a 'Save' window will open. You can drag the
  58. file icon in this window to any filer window, changing the filename
  59. first if you wish. If you close the Save window before you save the file
  60. then it can be opened again from the icon bar menu. Alternatively you
  61. can drag it directly to your Browser.
  62.  
  63. 'Stop', as the name suggests, will abort the search at any stage. If
  64. some matches have been found when you click on 'Stop'  you can save the
  65. results of the partial search from the iconbar menu. Closing the main
  66. window while a search is underway has the same effect as clicking on
  67. 'Stop'.
  68.  
  69.  
  70.  
  71. The 'Whole words' system is not completely foolproof. A 'terminating
  72. character' is regarded as anything other than the letters a-z, A-Z or
  73. the figures 0-9. A word must also begin with one of these characters, a
  74. pound sign (£) or an exclamation mark (!) so words which start with
  75. 'foreign' characters or any other symbols will NOT be found when this
  76. option is on. In practice, provided you are aware of this limitation, it
  77. is not likely to cause problems. If in doubt switch off 'Whole words'
  78. since if the word or phrase you are looking for does contain this type
  79. of character you are not likely to have many false matches anyway.
  80.  
  81.  
  82.         Any problems or suggestions please contact -
  83.  
  84.                 David Holden
  85.                 39 Knighton Park Road
  86.                 Sydenham
  87.                 London  SE26 5RN
  88.  
  89.                 email - dave@apdl.co.uk
  90.  
  91.  
  92.