home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 4 / CD_Magazyn_EXEC_nr_4.iso / Recent / disk / misc / dblocate.readme < prev    next >
Encoding:
Text File  |  2000-11-21  |  2.9 KB  |  69 lines
  1. Short:    A quick find util like locate on Linux
  2. Author:   TimHanson(msinister@connectfree.co.uk)
  3. Uploader: TimHanson(msinister@connectfree.co.uk)
  4. Type:     disk/misc
  5.  
  6. Version 1.2
  7.  
  8. In this archive are 3 utils: updatedb, locate and locategui. Their purpose 
  9. is to allow quick searches for lost files with pattern matching.
  10.  
  11. To install, copy all the files somewhere like C: or don`t.
  12.  
  13. Usage:
  14.  
  15. updatedb [database] [quiet]
  16. locate filenamepattern
  17. locategui filenamepattern [viewer]
  18.  
  19. Explaination:
  20.  
  21. To begin with you should run updatedb. This will create a database file. 
  22. This file may be pretty large depending on the size of your harddrive. On
  23. my system it`s about 3Meg and updatedb takes about 10Mins to create it. By 
  24. default the file is stored as s:locatedb. You can name it whatever you want
  25. however with the option on the command line.
  26. eg: updatedb SYS:prefs/sillynameforafile
  27. updatedb creates an env variable called LOCATEDBNAME to point to this file.
  28. The only other option is QUIET which stops output to stdout.
  29.  
  30. Now you can use locate. This takes one argument; an AmigaDos pattern to 
  31. identify the file you are looking for. This should be a simple file name
  32. with no path but may include AmigaDOS wildcards. Locate then scans the 
  33. database pointed to by LOCATEDBNAME for matches and prints the full path of
  34. any matches to stdout. (ie. The shell it was run from or an indirection 
  35. file if one is supplied.) Locate responds to CTRL-C.
  36.  
  37. Locategui functions in exactly the same way as locate but opens a window on
  38. the default public screen with a listview to display the results. Items in
  39. the listview can be clicked to show them with an external viewer. It takes 
  40. an additional cli argument to determine what viewer should be used to show 
  41. the file. The default is multiview. To stop any further searching click the
  42. window`s close icon.
  43.  
  44. This of course is not a new idea and there are several progs available for 
  45. the amiga that do the same thing. The only advantages this one has is that 
  46. it`s easy to install and use it can be run from anywhere and will work 
  47. under fairly low memory.
  48.  
  49. Bug reports to the address above.
  50. This archive is jokeware. If you use the product regularly you are morally 
  51. obliged to send me an email containing at least one joke.
  52. Distribution via CD is ok as long as you send me a copy.
  53.  
  54. History:
  55. 1.0.1
  56. A bug came to my attention directly after sending the first archive. The
  57. file patterns were case sensitive. Plainly useless on the Amiga. This is 
  58. now fixed.
  59. Added the ability to view files selected in listview.
  60. 1.1
  61. Changed to ExAll() to get file list in updatedb. Should fix the problem with
  62. hard/soft links.
  63. Changed TagItem data to GT_SetGadgetAttrs() from 0L to ~0L. This stops the 
  64. listview from flickering when a new item is added.
  65. 1.2
  66. Sorted out the soft link problem, hopefully once and for all.
  67. The last version may have had a bug which caused intermitent lock ups when 
  68. used with a viewer arguement. This is now fixed.
  69.