home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 565a.lha / Looker_v1.5 / Looker15DOC.pp / Looker15DOC
Text File  |  1991-11-07  |  17KB  |  462 lines
  1.                              -< LOOKER >-
  2.                     by John Lullie - Copyright 1991
  3.  
  4.  
  5.  
  6. Comments, suggestions and bug reports may be sent to:
  7.  
  8. CompuServe: UserID 70700,2454
  9.      GEnie: UserID J.LULLIE
  10.  
  11. Or write to:
  12.  
  13.         John Lullie
  14.         10701 SouthWest 10th Court
  15.         Davie, Florida 33324
  16.  
  17.  
  18. Looker uses a very powerful Amiga-Dos command called "Search" to locate
  19. files matching the criteria you enter. Therefore, the file "Search"
  20. should be in your "C" directory for Looker to work. It is supplied by
  21. Commodore with WorkBench and it should already be in your "C" directory.
  22.  
  23. Looker will do a bit more than just find files for you. After
  24. successfully locating a file (or files) on any drive or assigned
  25. directory, there are a few options you can use AFTER the file(s)
  26. are found:
  27.  
  28. * Open a Shell window directly into the path of your found file(s).
  29. * Print a listing of single or all found files with device and path
  30.   names showing where all the files are located. (Handy if you have
  31.   a lot of the same type files in different directories and want to
  32.   reorganize your Hard Drive. (i.e. ".txt",".arc",".doc" files etc.))
  33. * View a Report of Found files showing filenames only, number of
  34.   files found and the search string used. Also, if a path name is too
  35.   long to fit in the main window, you can click on a filename in the
  36.   Report window and the path will be selected back in the main window.
  37.   From there you can click the "Goto" button. (see "Goto" button below).
  38. * Copy, Move or Delete a selected file.
  39. * Display a graphic representation of the selecting files full path.
  40.  
  41.  
  42.  
  43. Looker is ShareWare!
  44. ********************
  45. ======================================================================
  46. It is freely distributable, provided all documentation and authors
  47. notices are left intact. Should you decide you like the program,
  48. please register by sending a check for $10 to me, the author, at
  49. the address listed above...
  50.  
  51.  
  52.  
  53. Your registration includes future updates and bug fixes, Laser Printed
  54. documentation, un-registered* versions of the following programs:
  55. (*SEE OPTIONAL OFFER BELOW!)
  56.  
  57. AliasIcon - Creates an alternate Icon for any program that can be
  58.             placed into any directory or kept right on the WorkBench
  59.             screen (WB2.0). Attach an Icon for any executable program,
  60.             a palette of 80 Icons to choose from, add your own script
  61.             commands, completely mouse driven and a 3D interface.
  62.  
  63. CDStore -   Compact Disk Database/Tracker. 3D interface, many features;
  64.             Sort, Search, Live Printer Preview Screen with three
  65.             different Print Formats and some other stuff I can't think
  66.             of right now.
  67.  
  68. VideoStore- Almost exactly the same as CDStore but dedicated to Video
  69.             cassettes/Movies. Same 3D Interface (different colors).
  70.  
  71.  
  72.  
  73. *OPTIONAL OFFER!
  74.  
  75. ================
  76.  
  77. If you send $15 instead of $10 for Looker!, I'll send you all three
  78. REGISTERED versions of AliasIcon, CDStore and VideoStore with Laser
  79. Printed Documentation for each. Believe me, you'll find this offer
  80. well worth the extra $5.
  81.  
  82. ======================================================================
  83.  
  84.  
  85.  
  86.   *>Un-Registered Version:<*
  87.     ----------------------
  88. You will notice that this un-registered version has some options
  89. disabled. All of the main functions are active and only the
  90. accessories (or Nifties) of the program are turned off.
  91.  
  92. ===============================================================
  93.  
  94.  
  95.  
  96.  
  97. Misc. Changes/Additions To Version 1.5:
  98. **************************************
  99. - The menu options; Copy File, Move File and Delete File have been moved
  100.   to buttons on the Main window of Looker. This was done to simplify the
  101.   process of clicking on a file and performing any one of these those
  102.   functions. All are explained in this manual.
  103. - Added Chime sound to some requesters prior to opening: Print, Delete
  104.   and Quit.
  105. - Report window has been re-vamped with new features. See "Report
  106.   Window" below.
  107. - Overhauled this DOC file. Merged the 1.5 Addendum to THIS file.
  108. - Optimized some of the routines.
  109.  
  110.  
  111. Bug Fixes:
  112. *********
  113. - The Zoom/Iconize window will now re-enable all menu options IF
  114.   there was something in the List window when you Zoomed AND if the
  115.   "Zoom Keeps..." option is ON in the Prefs dialog box.
  116. - Double-Click and Goto options were not working for all versions of
  117.   2.0? AmigaDos. You should now have no problem getting to the correct
  118.   directory in Shell window.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125. Requirements:
  126.         Any Amiga w/512K or more
  127.         WorkBench 2.0
  128.  
  129.  
  130.  
  131.  
  132. Installing Looker:
  133. *****************
  134.  
  135. - Copy Looker (and it's icon) to any directory you wish. It will run
  136.   from anywhere.
  137. - Copy "Deckrunner" to your "C" directory.
  138.  
  139. To launch Looker, double-click its icon.
  140.  
  141.  
  142.  
  143. QUICK TUTORIAL:
  144. **************
  145.  
  146. Running Looker!:
  147. ---------------
  148.   When Looker is first started, you will see a small animated credit
  149.   window come up. Click anywhere in this window to make it go away.
  150.   Selecting the "About..." menu option will bring it back.
  151.  
  152. Selecting Drive/Directory:
  153. -------------------------
  154.   To the left of the window are two buttons labeled "Devices" and
  155.   "Assigns". The device button is the default and will already be
  156.   selected. For this tutorial, click on the "Assigns" button. All
  157.   of your assigned devices and/or directories will be listed in the
  158.   center List window. Now Click on the "C" directory in this center
  159.   List window.
  160.  
  161. Entering Search Strings:
  162. -----------------------
  163.   Next, in the field at the top center of the screen (labeled "Search
  164.   String"), type in the text "ist" after the wild card characters "#?".
  165.   If you press [Return] after entering your text, the Search button
  166.   will be activated and the search will begin. The Status Box and drive
  167.   light will indicate that the search is in progress. Any files that
  168.   match the text you entered with the wildcard will be displayed in the
  169.   large Path window. In this case the command "List" in your "C"
  170.   directory would be displayed along with anything else that ends with
  171.   "ist" in that directory. You could just as well select "DH0" or "SYS"
  172.   and the entire selected disk would be searched.
  173.  
  174. "Goto"/"Goto & Quit" Buttons:
  175. ----------------------------
  176.   After a search is complete, the large List window at the bottom will
  177.   display all found files and their paths.
  178.   Click once on one of the path/files that were found in the large List
  179.   window, then click the "Goto" button. A Shell window will open and
  180.   you will be placed into the same directory that your selected file
  181.   is in.
  182.   If you click on the "Goto & Quit" button, that's exactly what will
  183.   happen - It opens the Shell and quits Looker. I thought adding this
  184.   option would make it more convenient (if you found what you were
  185.   looking for) to put you where you want to be and quit at the same time.
  186.  
  187.     NOTE: Double-clicking on a found path/file in the large
  188.           List window will also open the Shell into the
  189.           selected files path.
  190.  
  191.  
  192.  
  193. MENU OPTIONS:
  194. ************
  195.  
  196. Looker Menu:
  197. ===========
  198.   About Looker:
  199.   ------------
  200.     Animated display of Credits. Click anywhere on this window to
  201.     close it.
  202.  
  203.   Prefs:
  204.   -----
  205.     Opens a dialog box and presents you with the following options:
  206.  
  207.     Open With Animation:
  208.     -------------------
  209.       If ON, the animated credit window will open when Looker is first
  210.       launched.
  211.  
  212.     Insert Wildcard:
  213.     ---------------
  214.       If ON, the AmigaDOS wildcard characters "#?" will be inserted
  215.       in the Search field.
  216.  
  217.     Search Starts on [Return]:
  218.     -------------------------
  219.       If ON, pressing the [Return] after entering your search text
  220.       will start the search.
  221.  
  222.     ZOOM Keeps Found Files:
  223.     ----------------------
  224.       If ON, clicking the Iconize/Zoom button will keep what is
  225.       currently in the Path/File List window before becoming a tiny
  226.       window. When you zoom back to Looker's main window, all files
  227.       and their paths will still be there.
  228.  
  229.     Keep Report Up After Goto:
  230.     -------------------------
  231.       If you select the Goto option from the Report window, normally the
  232.       Shell is opened and the Report window will close and bring you back
  233.       to Lookers main window. With this button toggled ON, the Report
  234.       window will stay open and allow you to open multiple Shell windows
  235.       into several different paths.
  236.  
  237.  
  238.   Sort Listing:
  239.   ------------
  240.     Sorts the path and files in the list window. If a lot of files were
  241.     found, this will help you locate the file(s) in the List or Report
  242.     windows more quickly.
  243.  
  244.   Save Contents To:
  245.   ----------------
  246.     -Clipboard:
  247.       This option will save the contents of the path/file List window to
  248.       the Clipboard. This will allow you to paste this text into a word
  249.       processor, text editor or any other program that supports the
  250.       Amiga's Clipboard.
  251.  
  252.     -File:
  253.       Saves the contents of the path/file List window to an ASCII (text)
  254.       file. A file requester will open and prompt you for a filename.
  255.       Use the different buttons in this requester to navigate to where
  256.       you wish to save this file.
  257.  
  258.  
  259.   Print:
  260.   -----
  261.     This acts as more of a utility than just printing a list of found
  262.     files. If for example you wanted to find all the files ending in
  263.     ".pic" or ".doc", this printed report would tell you what search
  264.     string was used, how many files were found and exactly where they
  265.     are located on your drive (i.e. May help you organize your
  266.     Hard Drive).
  267.      There are two Sub-Menu items for Print:
  268.  
  269.      -Entire List:
  270.        Prints all path and file names found after the search. The
  271.        printout will display which device was searched, the search
  272.        text used etc..
  273.  
  274.      -Selected Only:
  275.        Prints only the highlighted path and filename along with device
  276.        searched, search text used etc....
  277.  
  278.  
  279.  
  280. Looker Window Objects:
  281. *********************
  282.  
  283. Search String Field:
  284. -------------------
  285.   This is where you enter the text to search for. The standard AmigaDos
  286.   wildcard "#?" is already in place and handled the same way as it is
  287.   in the CLI. After entering text, pressing the [Return] key will begin
  288.   the search without having to click the "Search" button.
  289.  
  290. Assignment/Device Buttons:
  291. -------------------------
  292.   Assigns Button - Displays all current assignments in the list window;
  293.                    C,S,SYS etc...
  294.   Devices Button - Displays all drives in the List window. DF0,DF1,DH0,
  295.                    DH1 etc...
  296.  
  297.     NOTE: Inserting or Ejecting a disk while Looker is running will
  298.           update the device List window accordingly.
  299.  
  300.  
  301. Device/Assign List Window:
  302. -------------------------
  303.   The List window displays either drives or assigned devices depending
  304.   on the button selected (Assigns or Devices).
  305.  
  306. Iconize/Zoom Button:
  307. -------------------
  308.   Small button Located in the upper right corner under the Title bar.
  309.   Clicking this button will reduce Looker's window to a small Icon and
  310.   place it near the top center of your WorkBench screen and out of the
  311.   way. If you wish to have Looker position this Zoom somewhere else on
  312.   the screen, move it where you want it and select the "Snapshot Window"
  313.   menu option. The next time you use the Zoom option, it will be placed
  314.   in this new position.
  315.   To return Looker to its normal state, click inside the tiny window.
  316.   You may also quit Looker from this window by making it active and
  317.   pressing LeftAmiga-Q.
  318.  
  319. Copy Button:
  320. -----------
  321.   After selecting a file, clicking this button will call up a file
  322.   requester asking you for the destination for the copy. Use the buttons
  323.   in this requester to navigate through your drives or directories and
  324.   click the "Ok" button. You will then have a new copy of the selected
  325.   file in your chosen drive/directory.
  326.  
  327. Move Button:
  328. -----------
  329.   Performs the same function as "Copy" except the original file will be
  330.   deleted AFTER the copy has been made and verified.
  331.  
  332. Delete Button:
  333. -------------
  334.   Calls up a requester to confirm your choice to delete the selected
  335.   file. This function will remove the selected file from the window AND
  336.   your disk so please use caution.
  337.  
  338. STATUS Bar:
  339. ----------
  340.   Displays Looker activities such as searching, copying, moving and
  341.   other information about what the program is doing at any given time.
  342.  
  343. Search Button:
  344. -------------
  345.   Initiates the search on the drive or assigned device selected in the
  346.   List window. Same as pressing the [Return] key after entering your
  347.   search text.
  348.  
  349. Goto:
  350. ----
  351.   Opens a new Shell into the path the found file(s) is in. (Button is
  352.   only active if something was found)
  353.  
  354. Goto & Quit:
  355. -----------
  356.   Same as "Goto" but will quit Looker after opening a Shell window and
  357.   placing you into the selected files path. (Button is only active if
  358.   something was found)
  359.  
  360.  
  361.  
  362. Report Window:
  363. *************
  364.  
  365.   Opens a dialog box showing Info about files found or selected. The
  366.   List box on the left of this window displays the file names of a
  367.   completed search. This makes it a bit easier to see only filenames
  368.   without the path. For example, after a search is complete, and the
  369.   path/filename(s) are too long to fit into the Main List window,
  370.   the Report List window will show you the filename(s).
  371.  
  372.   The large area on the right will graphically display the physical
  373.   path of a selected file using tiny icons. It also displays detailed
  374.   information about a selected file such as the modified date, modified
  375.   time, file size, etc.... You can access these features using the
  376.   following steps:
  377.  
  378.   IconView Path Display:
  379.   ---------------------
  380.     Click once on a file name in the List box and you will be presented
  381.     with a graphic path display of the file. These tiny icons will
  382.     always be displayed in the order of Drive, Drawer and File.
  383.  
  384.   File Info Button:
  385.   ----------------
  386.     To display detailed information about a selected file, click once
  387.     on the small button located at the bottom left of the window.
  388.     (The button shows a tiny document with a question mark in it.)
  389.  
  390.   Goto Button:
  391.   -----------
  392.     The "Goto" button functions the same as in the main window.
  393.  
  394.     NOTE: Double-clicking the filename will NOT take you to the
  395.           Shell like the Main window does. Therefore, the "Goto"
  396.           button has been added to this Report window for convenience.
  397.           If the User response to add this double-click option is
  398.           strong, I will add it. But, I really don't think the extra
  399.           code is necessary since the Goto button is so close and
  400.           only one more click away.
  401.  
  402.  
  403.  Like the Main window, this Report window may be moved anywhere on
  404.  the screen by clicking on the drag bar and dragging it to another
  405.  position. If you want Looker to remember where you placed this
  406.  Report window - Simply make sure the Report window is selected
  407.  (clicking anywhere on it) and select the "Snapshot Window" menu
  408.  option. Selecting "Default" will put the window in its original
  409.  position (as if you just installed Looker for the first time).
  410.  
  411.  NOTE: The Report window must be closed to access Lookers main
  412.        window again.
  413.  
  414.  
  415. Quit:
  416. ----
  417.   Exits the program.
  418.  
  419.  
  420.  
  421. Keyboard Equivalents:
  422. ********************
  423.  
  424. LeftAmiga - A   Switches to the Assigned devices.
  425. LeftAmiga - D   Switches to Drives; DF0, DF1, DH0 etc...
  426. LeftAmiga - S   Starts Looking for files using the search string.
  427. LeftAmiga - Q   Quits Looker. And if the tiny window is active.
  428. RightAmiga- Q  Quits Looker. And if the tiny window is active.
  429.  
  430. Up/Down Arrows- Moves cursor Up and Down in the Path window.
  431.  
  432. Shifted
  433. Up/Down Arrows- Moves cursor Up and Down the Assign/Device window.
  434.  
  435.  
  436.  
  437.  
  438. General Notes:
  439. *************
  440.  
  441.   You will notice some of the menu options are followed by an
  442.  ellipsis ("..."). This simply means that some kind of requester
  443.  or dialog box will appear before the option is selected. You
  444.  will find that many applications use this symbol for this purpose.
  445.  In CDStore2.0 for example, the main window has a "Print..." button
  446.  that uses this symbol. Clicking this button will not print
  447.  immediately but will take you to another screen entirely
  448.  (Print/Page Setup).
  449.  
  450.   The Preferences dialog box, when closed, will re-initialize Looker
  451.  with the new settings. All settings will take effect after the "Ok"
  452.  button is pressed with the exception of the Animated window (This
  453.  setting will be used the next time Looker is launched.).
  454.  
  455.   Snapshot Window options will take effect the next time that particular
  456.  window is opened. You will notice a slight hesitation before your
  457.  window is moved to your new assigned position. These windows will
  458.  open in their original default position and THEN immediately move
  459.  to your assigned position. Hopefully this will not become an annoyance.
  460.  
  461.  
  462.