home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0928.lha / PriMan / PriMan.doc < prev    next >
Text File  |  1993-10-07  |  7KB  |  185 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.
  45.  
  46.  
  47. Using PriMan:
  48. ~~~~~~~~~~~~~
  49.  
  50. Main Window:
  51.  
  52. - ListView gadget.  This is where all the tasks are displayed, with their
  53. priority in the second column.
  54.  
  55. - Slider gadget.  Drag this and let go to change the currently-selected
  56. task's priority.  Alternatively, click to the left or right of the bar to
  57. change the priority in steps of one.
  58.  
  59. - Break button.  This will signal the task with "Ctrl-C".  Many programs
  60. abort if they receive this signal.  It is a nice way of letting something
  61. know you want it to finish, as it gives it a chance to clean up after itself.
  62. PriMan will wait for half a second after sending the signal, to give the task
  63. a chance to exit, before updating the ListView.
  64.  
  65. - Kill button.  This is nastier than the Break gadget, as it doesn't give the
  66. task a say in the matter.  It just removes it from memory, meaning any open
  67. windows will not be closed, memory regions may not be freed up, resources
  68. will not be available to other tasks, etc.  This button should really only be
  69. used as a last resort for tasks that have gone out of control.
  70.  
  71. Note that removing a task that has exited since PriMan's display was last
  72. updated is NOT a good idea!  PriMan does some simple checking to ensure you
  73. don't do this, but it is not 100% foolproof. (99.2%, actually. :-)  If your
  74. Amiga crashes because you told PriMan to remove a non-existent task, you have
  75. nobody to blame but yourself...
  76.  
  77. - Settings button.  This will open up the settings window, described below.
  78.  
  79. - Size gadget (lower right border of window).  You can make the window small
  80. enough to accommodate only two tasks in the ListView, or large enough to fill
  81. the screen.  All the gadgets in the window will be redrawn to fit in with the
  82. new window size.
  83.  
  84. There are also a few keys you can press:
  85.  
  86. The Help key brings up some information about me, and the version number.
  87.  
  88. The Space and Return keys both update the ListView.  Note that this operation
  89. is very expensive, as it must disable task switching and interrupts, before
  90. walking through both of Exec's task lists, making a copy of each entry, and
  91. sorting them into alphabetical order.  Thus you may get a serial error if you
  92. are doing a modem transfer, or the pointer may "flash" if you are using
  93. LacePointer.
  94.  
  95. The Tab key alternates between "narrow" and "wide" scales for the slider
  96. gadget, if it is not disabled.  Normally, the slider displays task priorities
  97. between -25 and +25, as it is unusual to find a task with an extremely low or
  98. extremely high priority.  By pressing Tab, a "wide" scale can be used,
  99. allowing you to move the slider outside the -25 to +25 range.  This operation
  100. is done automatically if you select a task that happens to have a priority
  101. outside this range.
  102.  
  103.  
  104. Settings Window:
  105.  
  106. - "Gadget Font..."  This will bring up the standard ASL Font requester, where
  107. you can select the font used for all the buttons.
  108.  
  109. - "List Font..."  A different (non-proportional) font needs to be used for
  110. the ListView, as otherwise the second column would not line up properly. 
  111. This is where you select it.
  112.  
  113. - "Confirm actions?"  If you are afraid of accidentally signalling or
  114. removing a task, select this checkbox.  PriMan will then ask you for
  115. confirmation before performing either of these actions.
  116.  
  117. - Save button.  This will write out your font choices, confirmation setting,
  118. and window size and position to PriMan's ToolTypes, held in the PriMan.info
  119. file (choose "Get Info" from Workbench if you need to change these manually).
  120. Any ToolTypes already present that PriMan does not recognise will be
  121. preserved. Valid ToolTypes include:
  122.  
  123.   LEFT     = left edge of window
  124.   TOP      = top edge of window
  125.   WIDTH    = window width
  126.   HEIGHT   = window height
  127.   GADFONT  = name of font used for gadgets
  128.   GADSIZE  = height of GADFONT
  129.   LISTFONT = name of (non-proportional) font used in the ListView
  130.   LISTSIZE = height of LISTFONT
  131.   CONFIRM  = YES|NO - the "Confirm actions?" setting
  132.  
  133. PriMan's internal defaults will be used for any ToolTypes that are missing. 
  134. If you don't specify both a name and a height for either of the fonts, then
  135. PriMan will use your Workbench Preferences settings for that font.
  136.  
  137. CLI/Shell users currently don't get the facility to change the default
  138. settings, as the PriMan.info file can not be easily accessed from the CLI.
  139. Hence the "Save" gadget will be ghosted.
  140.  
  141. - Use button.  PriMan will use these settings, but not write them out to
  142. disk.  Like the Save button, the main window will be redrawn if you chose a
  143. new font.
  144.  
  145. - Cancel button.  Go back to the main window without making any changes.  The
  146. close gadget on the window also performs this function.
  147.  
  148.  
  149. Future additions:
  150. ~~~~~~~~~~~~~~~~~
  151.  
  152. - Commodity interface, so you can have it running all the time in the
  153. background, and pop it up with a hotkey.
  154.  
  155. - AmigaGuide documentation (and online help...).
  156.  
  157. - Keyboard shortcuts for all the gadgets.
  158.  
  159. - Error messages instead of just bombing out. For example, if PriMan cannot
  160. find the fonts you asked for, it will simply exit without even saying goodbye.
  161.  
  162. Oh, and sorry about the icon -- I'm a programmer, not an artist! :^)  My
  163. colour scheme is also probably completely different to yours.  Prettier icons
  164. will be gratefully accepted...
  165.  
  166.  
  167. Thanks:
  168. ~~~~~~~
  169.  
  170. ...go to Eddy Carroll, for testing, suggestions, and being kind enough to run
  171. Enforcer for me until I got my A3000. :-)
  172.  
  173.  
  174. Contacting me:
  175. ~~~~~~~~~~~~~~
  176.  
  177. Snail mail:  Barry McConnell,
  178.              "Piper's Hollow",
  179.              Hillcrest Road,
  180.              Dublin 18,
  181.              Ireland.
  182.  
  183. Internet:    bmccnnll@unix1.tcd.ie
  184. FidoNet:     2:263/150.2
  185.