home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 500.lha / Quick / Quick!.doc < prev    next >
Text File  |  1991-04-08  |  7KB  |  149 lines
  1.                            Quick! documentation
  2.  
  3.      Quick! is a utility program specifically targeted at hard drive users
  4. to eliminate the frustration of launching programs on the Amiga. It
  5. eliminates the need to:
  6.  
  7.      1) Open Workbench windows.
  8.      2) Remember and type in long pathnames to executables.
  9.  
  10.      This program is placed in the Public Domain by Adspec Programming as
  11. partial repayment to all the other Amiga Freeware/Shareware writers.
  12. Permission has been granted to Fred Fish to distribute this program and doc
  13. file in his famous "Amiga Library Disk" collection. Adspec programming makes
  14. no claims as to the fitness of this program. In other words, we aren't
  15. responsible to you if it crashes your hard drive, burns your RAM chips
  16. (including CHIP rams), etc.....
  17.  
  18.      Quick! MUST be started from a CLI-type environment. No provision has
  19. been made to start it as a "process". This includes IconX! Also, when
  20. started from a CLI (or Shell), the original CLI must remain open. What did
  21. you expect for a "freebie"?
  22.  
  23.      When started, Quick! looks for a file in the SYS:S directory named
  24. "quickmenu.def". If found, the program then proceeds to open a tiny window
  25. with a gadget that looks like an exclamation point (!). It is placed in the
  26. upper right-hand corner of the screen. It does not block the standard
  27. Intuition gadgets for Screen front/back manipulation. It has also been
  28. offset a little more to the left to allow other gadgets to be used in
  29. 640x200-sized windows (such as "zoom" gadgets) without interference. This
  30. window/gadget combination allows Quick! to appear in front of other windows
  31. on the Workbench screen if so desired. Since there are no depth arrangement
  32. gadgets for Quick!, you must arrange your other windows accordingly. Usually
  33. this is a simple case of sending windows behind Quick!. When made active
  34. (with a LMB click), it will then provide 6 columns of menus.
  35.  
  36.      The first menu is "Quick! Menu" and has only one item attached - "Quit
  37. Quick!" and serves as the only means to exit the program. The last five
  38. menus are user-configured and are labelled "Utilities1" through
  39. "Utilities5". Each menu contains 12 items for a total of 60 user-
  40. configurable items. The manner in which the user configures the menus is
  41. directly related to the "quickmenu.def" file. This file is an ASCII file
  42. with no imbedded control codes, tabs, etc. It is suggested that you only use
  43. ASCII codes 32 through 126. These are the "printable" codes and you
  44. shouldn't need any others.
  45.  
  46.                                 SETTING UP
  47.  
  48.      First, copy Quick! to you favorite cubby-hole. The SYS:C directory is
  49. recommended for convenience since AmigaDOS always looks there without any
  50. additional PATH assignments anyway. Next, copy the file "quickmenu.def" to
  51. your SYS:S directory.
  52.      Once both files are in place, all that is required is to edit the
  53. "quickmenu.def" file to reflect what is actually on YOUR hard drive rather
  54. than mine.
  55.  
  56.                           Editing "quickmenu.def"
  57.  
  58.      Once everything is in place, editing the file is a snap. Quick! reads
  59. the file based on pairs of lines. This is the most crucial point to editing
  60. the file. If not followed correctly, you will see strange things in the menu
  61. strips. Each line must be terminated with a linefeed (by pressing the
  62. "return" key on the keyboard). The odd-numbered lines may not exceed 11
  63. characters due to the way in which Quick! will interpret the file. This
  64. first line is what will show up in the menu as an "item" that subsequently
  65. will be selected by the mouse. By the way, line numbers start with line
  66. number 1.
  67.  
  68.      The second line (and subsequent even-numbered lines) is the one that
  69. Quick! uses to execute commands. Any program that may be run from the CLI
  70. environment will also run from Quick!. For those of you "seasoned" CLI
  71. people, you are probably already aware that there are 3 ways to run an
  72. executable from AmigaDOS:
  73.  
  74. 1> "filename"
  75.  
  76. This method is the most frequently used if you want to single-task a program
  77. or the program automatically detaches itself from the CLI.
  78.  
  79. 1> run "filename"
  80.  
  81. This method will run the program as a separate task, inheriting the original
  82. CLI window for output.
  83.  
  84. 1> execute "batch_filename"
  85.  
  86. This final method is one of my favorites because Quick! only knows how to
  87. run ONE TEXT LINE from the "quickmenu.def" file. This allows batch file
  88. processing when you need more than one line. One good example of this is
  89. when you need to be "CD'd" to a certain directory before starting a program.
  90. This would then require 2 CLI commands instead of one and would require the
  91. use of batch file processing. One natural question comes to mind - "where do
  92. I put the batch file?" Since my S: directory has enough junk in it, I
  93. created a special directory inside the S: directory named "quick". Now when
  94. I want to execute a batch file to be started from Quick!, I just use the
  95. following line:
  96.  
  97. execute s:quick/batch_filename.script
  98.  
  99.      Let's get a little more specific. Suppose my hard drive partition dh0:
  100. contains a path to WorkPerfect as follows: dh0:Text/WorkPerfect/WorkPerfect.
  101. Let's also suppose that I keep my text files in a different place:
  102. dh1:Text_Files/WP. And let's get really outrageous and suppose that
  103. WorkPerfect will show me the files in its file requester from the directory
  104. that I'm "CD'd" to. Here's how we would proceed with the "quickmenu.def"
  105. file. This will be our first entry, so line #1 will be the name that we want
  106. to appear as our menu item. The word "WorkPerfect" is 11 characters long, so
  107. we can use it for a menu item. Line #2 will contain the directions to Quick!
  108. on how to launch the program. We want to execute a batch file, so here's
  109. the first 2 lines of the file:
  110.  
  111. WorkPerfect
  112. execute S:quick/WorkPerfect.script
  113.  
  114.      We would then save this 2 line file as "s:quickmenu.def" and create the
  115. batch file named "WorkPerfect.script" like this:
  116.  
  117. cd dh1:Text_Files/WP
  118. run > nil:  dh0:Text/WorkPerfect/WorkPerfect -s
  119.  
  120.      Then save this file in the S:quick directory. Notice the "-s" option in
  121. the batch file. Since Quick! uses a linefeed character to determine what
  122. should be used to start a new task, anything before the linefeed is fair
  123. game to be used as command line flags. Once these 2 files are created, go to
  124. a CLI and type:
  125.  
  126. 1> run Quick!
  127.  
  128.      You'll see your menu item "WorkPerfect" and it's ready to execute.
  129. Highlight the item, let go of the mousebutton and you're off! You should get
  130. a pretty good idea of what the program will do by looking at the files that
  131. I have included.
  132.  
  133.                                   Support
  134.  
  135.      C'mon now. This is P.D. Well, okay. My name is Shane Earl and I wrote
  136. the docs for this little beauty. I will answer questions about this program
  137. through written correspondence ONLY! Got that? Good. Do NOT bother Adspec
  138. Programming with problems, questions or money (Sorry Greg. I put more time
  139. in on the docs than you did for the whole program, so I get to keep the
  140. money. Yeah, right! :). Anyway, I won't guarantee that I'll be at the
  141. following address forever, but as of January 1991, this is it:
  142.  
  143. Salem Amiga Users Group
  144. Attention: Shane Earl
  145. P.O. Box 7023
  146. Boardman, OH 44512-7023
  147.  
  148. All rights reserved, blah, blah, blah.......
  149.