home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / amigalibdisks / disk946 / priman / priman.doc < prev    next >
Text File  |  1993-12-21  |  13KB  |  285 lines
  1.                                    PriMan
  2.  
  3.                            A task priority manager
  4.                     Requires Amiga Release 2 (or greater)
  5.  
  6.                        Copyright 1993 Barry McConnell
  7.  
  8.  
  9. Distribution:
  10. ~~~~~~~~~~~~~
  11.  
  12. This program is Freeware.  You may freely distribute it, and charge only a
  13. small fee to cover expenses.  It must remain unmodified, and accompanied by
  14. this doc file (and optionally the source code).
  15.  
  16. Fred Fish is explicitly given permission to place this program on his fine
  17. disk collection.  Walnut Creek are also allowed to use it on their Aminet
  18. CD-ROM.
  19.  
  20. If you like PriMan, or have any bug reports or suggestions, please send me a
  21. message via e-mail (or a postcard, if you don't have access to Internet or
  22. FidoNet).
  23.  
  24. As with any free software, you use PriMan entirely at your own risk.  If you
  25. manage to start off World War 3 by discovering a bug, then I can not be held
  26. responsible...
  27.  
  28.  
  29. Overview:
  30. ~~~~~~~~~
  31.  
  32. PriMan is a fully Style Guide-compliant program for viewing a list of all
  33. running tasks, and performing some actions on them.  The window in which the
  34. list appears can be resized, the fonts used can be chosen from a settings
  35. window, and customised settings can be stored in the ToolTypes.  PriMan takes
  36. advantage of a few extra features available under Release 3, although you
  37. probably won't notice these unless you examine the source code carefully. :-)
  38.  
  39. PriMan allows the user to change the priority of any task with the greatest
  40. of ease.  Unlike most other utilities, you need only drag a slider to change
  41. the priority -- there is no messy clicking in string gadgets, deleting the
  42. old priority, and typing in a new one.  Also, there are buttons to signal a
  43. task with Ctrl-C, and remove it from memory.  Optionally, an "Are you
  44. sure?"-style requester can prevent you from doing this accidentally.  And if
  45. you like to have it handy all the time, there is an Iconify option, as well
  46. as the ability to leave it running in the background all the time as a
  47. Commodity.
  48.  
  49.  
  50. Using PriMan:
  51. ~~~~~~~~~~~~~
  52.  
  53. Main Window:
  54.  
  55. - ListView gadget.  This is where all the tasks are displayed, with their
  56. priority in the second column.
  57.  
  58. - Slider gadget.  Drag this and let go to change the currently-selected
  59. task's priority.  Alternatively, click to the left or right of the bar to
  60. change the priority in steps of one.
  61.  
  62. - Break button.  This will signal the task with "Ctrl-C".  Many programs
  63. abort if they receive this signal.  It is a nice way of letting something
  64. know you want it to finish, as it gives it a chance to clean up after itself.
  65. PriMan will wait for half a second after sending the signal, to give the task
  66. a chance to exit, before updating the ListView.
  67.  
  68. - Kill button.  This is nastier than the Break gadget, as it doesn't give the
  69. task a say in the matter.  It just removes it from memory, meaning any memory
  70. regions may not be freed up, resources will not be available to other tasks,
  71. etc.  This button should really only be used as a last resort for tasks that
  72. have gone out of control.
  73.  
  74. Note that removing a task that has exited since PriMan's display was last
  75. updated is NOT a good idea!  PriMan does some simple checking to ensure you
  76. don't do this, but it is not 100% foolproof. (98.8%, actually. :-)  If your
  77. Amiga crashes because you told PriMan to remove a non-existent task, you have
  78. nobody to blame but yourself...
  79.  
  80. If the task has any windows open, PriMan will ask you if you want to close
  81. them as well.  Likewise, it is not a good idea to answer "yes" to this
  82. question if, since putting up the requester, the windows have already been
  83. closed.  Your Amiga will certainly crash if you do this.
  84.  
  85. - Settings button.  This will open up the settings window, described below.
  86.  
  87. - Size gadget (lower right border of window).  You can make the window small
  88. enough to accommodate only two tasks in the ListView, or large enough to fill
  89. the screen.  All the gadgets in the window will be redrawn to fit in with the
  90. new window size.
  91.  
  92. There are also a few keys you can press:
  93.  
  94. The Help key brings up some information about me, and the version number.
  95.  
  96. The Space and Return keys both update the ListView.  Note that this operation
  97. is very expensive, as it must disable task switching and interrupts, before
  98. walking through both of Exec's task lists, making a copy of each entry, and
  99. sorting them into alphabetical order.  Thus you may get a serial error if you
  100. are doing a modem transfer, or the pointer may "flash" if you are using
  101. LacePointer on a slow Amiga.
  102.  
  103. The Tab key alternates between "narrow" and "wide" scales for the slider
  104. gadget, if it is not disabled.  Normally, the slider displays task priorities
  105. between -25 and +25, as it is unusual to find a task with an extremely low or
  106. extremely high priority.  By pressing Tab, a "wide" scale can be used,
  107. allowing you to move the slider outside the -25 to +25 range.  This operation
  108. is done automatically if you select a task that happens to have a priority
  109. outside this range.
  110.  
  111. The Escape key is similar to clicking the close gadget.  However, if you
  112. have enabled the Iconify option (see below) or are running PriMan as a
  113. Commodity, this will force it to quit, instead of closing down its windows
  114. and running in the background.
  115.  
  116.  
  117. Settings Window:
  118.  
  119. - "Gadget Font..."  This will bring up the standard ASL Font requester, where
  120. you can select the font used for all the buttons.
  121.  
  122. - "List Font..."  A different (non-proportional) font needs to be used for
  123. the ListView, as otherwise the second column would not line up properly. 
  124. This is where you select it.
  125.  
  126. - "Confirm actions"  If you are afraid of accidentally signalling or
  127. removing a task, select this checkbox.  PriMan will then ask you for
  128. confirmation before performing either of these actions.
  129.  
  130. - "Iconify when closed"  If this is selected, whenever you click the close
  131. gadget on the main window, an AppIcon will be placed on the Workbench.
  132. Double-clicking on this will open the main PriMan window again.
  133.  
  134. - "Install as a Commodity"  Should you not want PriMan to be a Commodity,
  135. you can deselect this checkbox.  Note that when you click the "Save" or "Use"
  136. buttons (see below), PriMan will install or remove itself as a Commodity,
  137. depending on this setting.  If it tries to install itself, and finds another
  138. copy of PriMan already installed, it will quietly exit, and the first copy
  139. will bring itself to the front.
  140.  
  141. - "Popup when launched"  If you are putting PriMan into your WBStartup
  142. drawer, you may like to have this option deselected, so it will be silently
  143. started each time you boot your Amiga.  Note that this option is ignored if
  144. you don't have one (or both) of "Iconify when closed" and "Install as a
  145. Commodity" selected, as otherwise there would be no way of letting PriMan
  146. know when you want it to open its window!
  147.  
  148. - "Hotkey"  If you have PriMan running as a Commodity, this is the keypress
  149. you use to open its window.  Check out your Workbench manual to find out
  150. the acceptable combinations of keypresses.
  151.  
  152. - "Priority"  This is the Commodity priority PriMan runs at.  It is best
  153. left at zero, and only really comes into play when two commodities try to
  154. allocate the same hotkey for themselves.  Note that this setting is only read
  155. once: when you first launch PriMan.  Any change you make to it will not get
  156. recognised until you quit PriMan and launch it again.  (This is not really a
  157. problem, since in practice you will always leave it at zero.)
  158.  
  159. - Save button.  This will write out your font choices, confirmation setting,
  160. and window size and position to PriMan's ToolTypes, held in the PriMan.info
  161. file (choose "Get Info" from Workbench if you need to change these manually).
  162. Any ToolTypes already present that PriMan does not recognise will be
  163. preserved. Valid ToolTypes include:
  164.  
  165.   LEFT      = left edge of window
  166.   TOP       = top edge of window
  167.   WIDTH     = window width
  168.   HEIGHT    = window height
  169.   GADFONT   = name of font used for gadgets
  170.   GADSIZE   = height of GADFONT
  171.   LISTFONT  = name of (non-proportional) font used in the ListView
  172.   LISTSIZE  = height of LISTFONT
  173.   ICONLEFT  = left position of AppIcon
  174.   ICONTOP   = top position of AppIcon
  175.   CONFIRM   = YES|NO - the "Confirm actions" setting
  176.