home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 579b.lha / Seeker_v1.2 / Seeker.doc.pp / Seeker.doc
Encoding:
Text File  |  1991-12-09  |  10.8 KB  |  325 lines
  1. Seeker v1.2
  2. By Don Lloyd
  3.  
  4.  
  5.  
  6.  
  7.  
  8. What is Seeker?
  9.  
  10.  
  11.     Seeker owes its existence mainly to a friend of mine who, after 
  12. installing the Release 2 operating system on his 2500, whined 
  13. continuously that it should have come with a file finder similar to 
  14. the one that comes as a part of the OS on a certain other well-known 
  15. platform...
  16.     Seeker is basically a means of tracking down a file that you know 
  17. you have somewhere on that jumbled, disorganized hard drive (or 
  18. floppy, or whatever) of yours.  You can specify a where to search and 
  19. what to search for, and can perform several operations on the results.
  20.     Seeker is currently written using CanDo v1.5.  It's a nice 
  21. system, but it's got a few limitations that currently make Seeker not 
  22. quite as polished as I'd like it to be.  Hopefully upcoming versions 
  23. of CanDo will address these.
  24.  
  25.  
  26.  
  27.  
  28.  
  29. Seeker is Shareware!
  30.  
  31.  
  32.     In an effort to help fund future computer purchases (not to 
  33. mention college, car insurance, food, etc.), I'm asking a $10 
  34. shareware fee.  Feel free to try it out for 30 days or so.  If at the 
  35. end of that time you feel it's a worthwhile piece of software, send me 
  36. $10 (See the address below).  If not, well... stop using it.
  37.  
  38.  
  39.  
  40.  
  41. Legal Garbage
  42.  
  43.  
  44.  
  45.     No warranty of any kind is expressed/implied.  Although I've gone 
  46. to great efforts to make it harmless and bug-free, and by it's very 
  47. nature it doesn't do anything "dangerous" like low-level disk 
  48. accesses, I disclaim all responsibility for any loss of data, 
  49. hardware, possessions, property, or life as a direct, indirect, or 
  50. apparent result of the use of Seeker.  It's somebody else's fault.
  51.     This program may not be distributed as part of a commercial 
  52. product or included in any PD collection that is sold by a commercial 
  53. organization for profit.  Other than that, it can be freely 
  54. distributed via BBSs, networks, users' group disks, Fish Disks (Fred 
  55. is my hero :-), etc.  The files Seeker, Seeker.cd, Seeker.doc, and
  56. their associated icons must remain in the archive.  Please remember
  57. that Seeker is shareware, not PD.
  58.  
  59.  
  60.  
  61.  
  62.  
  63. What's needed to run Seeker?
  64.  
  65.  
  66.     Seeker should be small enough to run on just about any Amiga ever 
  67. made, although I've never really tried it in less than a couple of 
  68. megs :-).  It uses the Release 2 "Search" command, which should be 
  69. located in a directory that's listed in your search path.  (C: is a 
  70. good place).
  71.     Two versions of seeker are included.  The standard Seeker is for 
  72. anyone with a system fitting the above specifications.  Seeker.cd is a 
  73. version that's compiled to make use of CanDo.library, for those who 
  74. have it (unfortunately, it's not freely distributable, so if you don't 
  75. have CanDo, you probably don't have the library).  This version is a 
  76. much smaller file and takes advantage of a shared library.
  77.  
  78.  
  79.  
  80.  
  81.  
  82. Using Seeker
  83.  
  84.  
  85.     Starting the Program
  86.  
  87.     Seeker can be started from the CLI or workbench.  There are 
  88. several optional Tooltypes that can be set by WB users, as well as 
  89. some command line options from the CLI.
  90.     From WorkBench, just double-click the Seeker icon to get started.  
  91. There are three optional tooltypes that can be added to the icon (note 
  92. that in order for these to work, the program file _must_ be named 
  93. Seeker; one of those CanDo quirks I mentioned above).  The tooltypes 
  94. are as follows:
  95.  
  96.  
  97. STARTDIR=[directoryname] --  The directory where you'd like 
  98.                              Seeker to start by default.
  99.  
  100. SEARCHSUBS=[flag]  --  Toggle whether or not 
  101.                        subdirectories of the current                                                                  
  102.                        directory will be searched.  If [flag] = "NO", 
  103.                        "0", or "FALSE", subdirs won't be searched.                                                                   
  104.                        Default is to turn on subdir searching.
  105.  
  106. SORT=[flag]  --  Toggle whether or not to sort the list of found files.
  107.                  Otherwise, functions the same as the SEARCHSUBS tooltype.
  108.  
  109.  
  110.     So, for example, "STARTDIR = sys:" would make Seeker always 
  111. display the root of sys: when it starts up.  "SEARCHSUBS=no" would 
  112. keep it from looking through all the subdirectories in sys: when a 
  113. search is started.
  114.     From the CLI, Seeker can be started with several optional command 
  115. line items:
  116.  
  117. seeker [start directory]/[pattern]  [SUBS | NOSUBS] [SORT | NOSORT]
  118.  
  119.     [Start directory] is analogous the STARTDIR tooltype above.  
  120. [Pattern] tells Seeker what pattern to search for (see Pattern 
  121. Matching info below).  SUBS/NOSUBS toggle sorting on and off, 
  122. respectively.  SORT and NOSORT toggle sorting.  SUBS and SORT are 
  123. really unnecessary, since they're the default settings, but I kept 
  124. them in anyway just to make the CLI options look more impressive :-).
  125.  
  126.  
  127.  
  128. Searching for Files
  129.  
  130.  
  131.     Seeker has to know several things before it can start a search.  
  132. The first of these is the path where it will begin looking.  Unless 
  133. specified via tooltypes or command line options, the directory from 
  134. which the program was started will be the search directory at first.  
  135. To change directories once the program has started, use the mouse to 
  136. maneuver around the directory list by double-clicking the directory 
  137. you'd like to change to.  Double-clicking "<<Parent>>" will move up 
  138. one level.  Clicking on the rollo gadget in upper left of the window 
  139. (the one labeled "Show:") will toggle between listing the 
  140. subdirectories of the current directory and listing the available 
  141. volumes.  Double-clicking on an item in the volumes list will take you 
  142. to the directory listing for the root of the volume you've chosen.
  143.     Your path selections will be reflected in the Path text gadget to 
  144. the right of the directory list.  You may also make changes directly 
  145. in the text box.  Pressing return while after making changes to it 
  146. will have the same effect as if you'd manually used the list box to 
  147. change to that directory (provided the directory actually exists).
  148.     Next, you'll have to tell Seeker whether or not to search 
  149. subdirectories.  You can change this via the "Subdirs" button.  Most 
  150. of the time, this will probably remain on, unless you've got a _lot_ 
  151. of files in a specific directory (a fonts: directory, for example, or 
  152. that directory called "temp" that just keeps getting bigger but never 
  153. goes away) that you'd like to search through.
  154.     You'll also need to decide whether or not to sort the file list 
  155. that results from your search.
  156.     Lastly, Seeker needs to know the name of the file you're 
  157. searching for, or a specific pattern to match while looking for files.  
  158. Seeker accepts the AmigaDOS "?" and "#" wildcards, as well as the more 
  159. industry-standard "*".  Eventually I'll probably add some more 
  160. wildcard capabilities similar to those available via the Unix C Shell.
  161.     Without going into much detail about using wildcards (it's 
  162. already been done many times elsewhere), here are some examples:
  163.  
  164.     am??a   -- find all files starting with "am", followed by any two 
  165. letters, and ending in "a".
  166.  
  167.     picture.i#f - find all files beginning with "pictures.i" followed 
  168. by any number of occurrences of the letter "f"
  169.  
  170.     #?.txt  -- find all files beginning with and number and 
  171. combination of characters but ending in ".txt"
  172.  
  173.     *.txt -- same as above - the "*" wildcard is just a different way 
  174. of representing "#?".
  175.  
  176.     Once you've supplied all this information, click the "Search" button
  177. (or just hit <Enter> while the cursor is in the pattern box) and the search
  178. for files will begin.  All files that match the pattern will be displayed
  179. in the long list box at the bottom of the Seeker window.  You may also
  180. start it by choosing "Seek" from the "File" menu.
  181.  
  182.  
  183.  
  184. Operations on Filenames:
  185.  
  186.     
  187.     Use the scroll bar and arrows to move around in the list of found
  188. files.  Clicking on an item in the list makes it the currently selected
  189. file, so any operation selected will be performed on that file.  The
  190. operations are accessible via the column of buttons under the "Ops:"
  191. heading.
  192.  
  193.  Copy
  194.     Asks for a new name and location via file requester, then copies the
  195. selected file under that new name/location.
  196.  
  197.  Move
  198.     As Copy, but deletes original file.
  199.  
  200.  Delete
  201.     Deletes selected file.  This button must be double-clicked to work (a
  202. safety feature).
  203.  
  204.  CLI
  205.     Opens a new CLI and CD's to the directory where the selected file is
  206. located.  The only way I've discovered yet to get these new CLIs to
  207. remember the global path is to put a "Path ..." line in s:shell-startup
  208. that contains the path you want your shells to have.
  209.  
  210.  Run
  211.     If the file is executable, run it.   
  212.  
  213.  Info
  214.     Display a short list of information about the selected file.
  215.  
  216.  
  217.  
  218. Filing Results:
  219.  
  220.  
  221.     By choosing the "Results --> File..." menu item from the "File" menu,
  222. you can save the names listed from your last search into a text file.  A
  223. requester will ask you for the name and location of this file.
  224.  
  225.  
  226.  
  227. Drag & Drop NewCLI
  228.  
  229.     
  230.     Seeker provides a quick means of opening a new CLI in any directory.
  231. Just drag any icon from the WorkBench onto the Seeker window and drop it.
  232. A new CLI will open and CD to the directory where that file is located.
  233. (Programmers: somebody please write a CLI command that will open the current
  234. directory's Workbench window!)  As with the CLI button above, the path will
  235. not be remembered unless you put a path statement in s:shell-startup.
  236.  
  237.  
  238.  
  239.  
  240.  
  241. History:
  242.  
  243.  
  244.  
  245. v1.2
  246.  
  247. - CLI switches added.
  248. - Now cleans up temp files on exit.
  249.  
  250.  
  251. v1.1
  252.  
  253. - "Delete" button now needs to be double-clicked.  Previously it was 
  254. too easy to click delete by accident and lose a file you didn't mean 
  255. to get rid of.
  256.  
  257. - Support for tooltypes in icon added.
  258.  
  259.  
  260.  
  261.  
  262. v1.0
  263.  
  264. - Initial, limited, sorta beta release.
  265.  
  266.  
  267.  
  268.  
  269.  
  270. Plans for the future:
  271.  
  272. (Many of which will happen only provided:  a.) New features are added 
  273. to CanDO, or b.) I get really ambitious and find the free time to 
  274. rewrite the whole thing in C).
  275.  
  276.  
  277.  
  278. - ASL file requester.  CanDo's is, well, not very likable.
  279.  
  280. - Ability to choose between opening Seeker on WB, public, or custom
  281. screen.
  282.  
  283. - Better info window.  Right now, due to some of CanDo's limitations, 
  284. it's a bit of a kludge.  Microsoft would be proud :-).
  285.  
  286. - On-line manual via CBM's new hypertext help system.  Haven't yet 
  287. seen it, but it sounds promising.
  288.  
  289. - Ability to define viewers/players for different file types.  For 
  290. instance, when the file selected is an IFF pic, the user could click a 
  291. "Show" button to look at it.
  292.  
  293. - ARexx port.
  294.  
  295. - Clipboard support (copy a list or an individual item from the "Files 
  296. found:" box into the clipboard).
  297.  
  298. - Support for some more Unix-like wildcards.
  299.  
  300. - Ability to choose several paths at one time to search.
  301.  
  302.  
  303.  
  304. - Any other ideas?  Send 'em to me!
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311. Please send me questions, comments, bug reports (Bugs?  What bugs?),
  312. shareware fees, and gifts :-).  My US Snail address:
  313.  
  314.    Don Lloyd
  315.    775 Fox Chase Circle
  316.    Bear, DE 19701
  317.  
  318. I can be reached electronically through several means:
  319.  
  320. Internet: don@chopin.udel.edu
  321.    (At least until my account disappears again)
  322. GEnie: D.LLOYD7
  323. AmigaNetwork BBS: (302) 323-1604  Username =  Don Lloyd.
  324.  
  325.