home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 2 / CDPD_II_2352.bin / scope / 126-150 / scopedisk137 / powerpanel / upp.doc < prev    next >
Text File  |  1992-10-27  |  11KB  |  240 lines
  1.  
  2.            UPP - A CanDo-generated Productivity Tool - V1.0
  3.                     by M. Joel Guerra, 5-May-1990
  4.  
  5. Introduction
  6. ------------
  7.  
  8.      UPP is a Power Panel List utility for the Amiga.  The "U" stands
  9. for (take your pick) Ultimate, Ubiquitous, Unnamed, Utilitarian, or
  10. Ugly.  I first called it MCP for Master Control Panel, but that's too
  11. sexist.  PCP was too druggie.  Heck, if you don't like the name, you
  12. can change it (and anything else you wish to change) with CanDo.
  13.  
  14.      If you have CanDo, you know what a power panel is.  If you don't
  15. have CanDo, a power panel is a little program with buttons/menu items/
  16. list object items which can be selected with the mouse to launch other
  17. programs.  Power panels can save you the time of opening up multiple
  18. windows just to get to the application you wish to run; a click or
  19. double-click on a button or item is all you need.  Power panels are
  20. great for use on hard disk systems.
  21.      Power panels are easy to build with CanDo.  However, adding a
  22. program to a power panel usually requires editing the power panel with
  23. CanDo, which takes a little time.  In exchange for those beautiful
  24. buttons (which can even use graphic brush images), I present the
  25. convenience of this Power Panel List, which looks somewhat like a file
  26. requester.  It is very easy to use, it can be updated on-the-fly, and
  27. it doesn't require CanDo.
  28.  
  29.  
  30. Running the Program
  31. -------------------
  32.  
  33.      To use it, double-click on the UPP icon or go to a CLI or Shell
  34. and type:
  35.                Run C:DeckRunner {pathname}/UPP   (if you have CanDo)
  36.                Run C:DeckBrowser {pathname}/UPP  (if you don't)
  37.  
  38.      DeckBrowser is a freely-distributable residentable application
  39. which will run CanDo decks without CanDo.  It is available on many
  40. bulletin boards.
  41.      {pathname} is the volume:subdirectory pathname where you have put
  42. the UPP application.
  43.  
  44.  
  45. The Power Panel List Window
  46. ---------------------------
  47.  
  48.      When UPP is up and running for the first time, you will see only
  49. one entry, Calculator.  If the Amiga Calculator is in your
  50. Sys:Utilities directory, double-clicking on the Calculator entry will
  51. load and execute the Calculator program.  If it is not, nothing will
  52. happen.
  53.      As you will see below, you can easily add new entries to execute.
  54. To launch (start) a program, just double-click on the corresponding
  55. name in this list.
  56.      There are two menu items for this window of UPP.  Selecting
  57. "Quit" or pressing Right-Amiga-Q when the UPP window is active will
  58. close the UPP application.  Selecting "Entry Editor..." or pressing
  59. Right-Amiga-E will open a new window, the Control Panel Editor.
  60.  
  61.  
  62. The Small Window
  63. ----------------
  64.  
  65. The Small Window is reached by clicking on the Close gadget at the
  66. upper left of the Power Panel List Window.  This merely reduces the
  67. displayed window to a few pixels high to get it out of the way.  To
  68. return to the Power Panel List Window, click again on the Close gadget
  69. at the left of the Small Window.  (If you wish to quit, see the menu
  70. discussion under the Power Panel List Window.)
  71.  
  72.  
  73. The Control Panel Editor Window
  74. -------------------------------
  75.  
  76.      Here's where you can add new entries, or edit/delete existing
  77. ones.  On the left, you see the same list object of entries ("entry
  78. list").  Detailed information of the highlighted entry is shown on the
  79. right ("displayed entry").  Single-click on an entry on the left to
  80. select it for editing, or click on the "New" button to clear out the
  81. entry buffer.
  82.  
  83. The List Name Field -- This is the name that will appear in the Power
  84. Panel List.  It can be up to 10 characters long.
  85.  
  86. Stack Size Field -- This field indicates the stack that will be used
  87. by your application.  The default stack size is 4000 bytes.  This size
  88. is assumed by DOS if the STACK command is not executed.  Only if you
  89. change this size from 4000 will the STACK command be part of the DOS
  90. command issued by UPP when you double-click the entry to launch it.
  91. See the Warning below.
  92.  
  93. Directory Button -- This button (to the left of the Directory field),
  94. when selected will pop up a file requester asking you which directory.
  95. You can select either just a directory or both a directory and an
  96. application.  If you specify a program or CanDo deck, the complete
  97. path and program/deck name will be put into the Command field, and the
  98. path will be put into the Directory field.  If it is a CanDo deck, the
  99. prefix "c:DeckRunner" will be inserted.  (In which case, if you do not
  100. have CanDo, you will want to change "DeckRunner" to "DeckBrowser".)
  101.  
  102.           Helpful Hint:  Use this button twice, first to find
  103.           your program (say, c:ED), then to specify a different
  104.           directory which contains your data files (say, your
  105.           correspondence directory).  The second time, do not
  106.           select a file, just a directory.  This changes just
  107.           the Directory field.
  108.  
  109. Directory Field -- UPP will change to the directory specified by this
  110. field before executing the Program indicated by the Command field.
  111. Click in the field to enter or edit the directory path, or use the
  112. Directory button to find it for you.  Use Right-Amiga-X to clear the
  113. field once you've clicked in it.  If you leave the field cleared, no
  114. directory change will take place when you launch the application via
  115. UPP.
  116.  
  117. Command Field -- Click in this field to enter or edit the application
  118. name.  You can use this field to add a command line argument to the
  119. application you found via the Directory Button.  To do so, position
  120. the cursor *AFTER* the last double-quote, type a space, then type your
  121. parameter(s).  For example, you have selected the ED program and you
  122. want to specify a file to edit:
  123.  
  124.         Run <Nil: >Nil: "c:ED" yourfile
  125.  
  126. If "yourfile" is a name with spaces (e.g., "1990 Report"), then put it
  127. in quotes:
  128.  
  129.         Run <Nil: >Nil: "c:ED" "1990 Report"
  130.  
  131. (The quotes around c:ED are not necessary, but some programs have
  132. spaces in their path/filenames, so quotes are automatically generated
  133. by UPP.)
  134.  
  135. NOTE:  If you specify an invalid path or filename (by manual entry),
  136. you will not be told of the error when you attempt to execute the
  137. application.  Be sure that your application exists and is in the
  138. directory you specified.
  139.  
  140. Move Up, Move Down Buttons -- Use these buttons to move the
  141. highlighted entry in the entry list either up or down in the list.
  142.  
  143. Add Button -- Select this button to add the displayed entry to the
  144. entry list.  You will be asked to confirm.  If the list name is blank,
  145. a non-executable blank entry will be added to the list.
  146.  
  147. Replace Button -- Choose this button to replace the highlighted entry
  148. in the entry list with the displayed entry.  The names must match; you
  149. are performing a "replace".  (Otherwise, use the Add and Delete
  150. buttons.)  You will be asked to confirm.  If the list name is blank, a
  151. non-executable blank entry will be added to the list.
  152.  
  153. Delete Button -- Select this button to delete the highlighted entry
  154. from the entry list.  You will be asked to confirm.
  155.  
  156. Save Button -- If you select the Save Button without previously
  157. changing the list via the Add, Replace, or Delete buttons, nothing
  158. will happen.  Otherwise, you will be asked if you wish to save this
  159. list.  If you select "OK", the list will be saved to "s:PowerPanel".
  160. (If you wish to change the target path/filename, use CanDo to change
  161. the name in the AfterStartup script of the PowerPanelCard.)
  162.  
  163.                          ******************
  164.        Please NOTE:  NO changes are made to the list when you
  165.        make changes to the fields.  The list is only changed
  166.        when you use the buttons to add, replace, or delete an
  167.        entry, or move an entry up or down.  So if you change
  168.        the stack size, you must also select the Replace button
  169.        to update the list entry.  If you create a new entry,
  170.        you must use the Add button to add it to the list.
  171.                          ******************
  172.  
  173. Close gadget -- Select the Close gadget at the upper left of the
  174. Control Panel Editor Window to return to the The Power Panel List
  175. Window.  If you have added, replaced, or deleted an item without
  176. saving, you will be asked if you wish to save your changes.  An "OK"
  177. reply saves the new list; otherwise the old list will be reloaded.
  178.  
  179.  
  180. WARNINGS and Suggestions
  181. ------------------------
  182.  
  183.      WARNING:  If you do not use the <Nil: and >Nil: redirections on
  184. the command line, you run the risk of a Task Held requester (=> GURU).
  185. Some programs require an output CLI window.  If they attempt to output
  186. text or error messages and you do not redirect output to the Nil:  (or
  187. the NULL: device if you have RunBack), you will get a GURU.
  188.  
  189.      WARNING:  Some programs require a stack size greater than the
  190. default of 4000 bytes.  You might check the stack requirement via the
  191. Info menuitem on the Workbench menu after single-clicking on the
  192. program's normal icon.  Enter this number into the Stack Size field on
  193. the upper right of the Control Panel Editor Window, then select the
  194. Replace button to update the current entry.  Don't forget to Save.
  195. TOO SMALL A STACK for the program WILL CRASH YOUR MACHINE.
  196.  
  197.      WARNING:  No Warranty is provided with this program.  Conse-
  198. quences of misuse of this program are your responsibility.
  199.  
  200. ------------
  201.      The Command line for a NewShell (if you have AmigaDOS 1.3) would
  202. be something like:
  203.  
  204.      Run <Nil: >Nil: NewShell NewCon:0/11/640/189/AtYourCanDoCommand
  205.  
  206. Set your stack to something like 20000.  If you run UPP from your
  207. startup-sequence, you will have your complete path available to you.
  208. If you launch UPP from its Workbench icon, only the Current Directory
  209. and the C: directory will be in the path.
  210.  
  211. ------------
  212.      Use the Resident command in your startup-sequence file to make
  213. Run and DeckRunner (or DeckBrowser, if you don't have CanDo) resident.
  214. You may have to use the PROTECT command to set the Pure bit on
  215. DeckRunner/DeckBrowser if it is not set already.  Be sure you are
  216. using DeckRunner/DeckBrowser 1.02 or later for this.  If you make
  217. these commands resident, you don't need the c: directory reference
  218. before the command name.
  219.  
  220. ------------
  221.      Put this program into your startup-sequence file.  If you have
  222. RunBack, the syntax would be:
  223.  
  224.           RunBack c:DeckRunner {pathname}/UPP     (if you have CanDo)
  225.           RunBack c:DeckBrowser {pathname}/UPP    (if you don't)
  226.  
  227. You could use "Run >Nil: <Nil: c:DeckRunner {pathname}/UPP" but this
  228. will leave your startup window open.
  229.  
  230. ------------
  231.      If you have CanDo, you can modify the deck to play sounds or show
  232. pictures in the same manner.
  233.  
  234. ************
  235.  
  236.      The iconify-with-the-close-gadget idea and much of the UPP
  237. Control Panel Editor's visual appearance was stolen from Cash Foley.
  238. Thanks, Cash!
  239.      Enjoy!  Or don't use it! ;)  -- Joel
  240.