home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / commodities / autoactivate / autoactivate.doc < prev    next >
Text File  |  1991-11-18  |  5KB  |  128 lines
  1.  
  2.                              AutoActivate
  3.  
  4.                              (Commodity)
  5.  
  6.                                   by
  7.  
  8.                             Stefan Sticht
  9.  
  10.          This program (binary), sourcecode, documentation is 
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.                      You may do anything with it!
  15.  
  16.  
  17. Purpose of this commodity:
  18. --------------------------
  19. AutoActivate  always activates the window under the mouse pointer when
  20. any  key  on  the  keyboard is pressed.  Please note that Autopoint, a
  21. commodity which comes along with the 2.0 Extras-disk, already has this
  22. feature,  so  it's obsolete using this commodity when you normally run
  23. Autopoint.
  24.  
  25. Requirements:
  26. -------------
  27. This commodity requires at least Kickstart 37.#?  and Workbench 37.#?.
  28. Please  check  this  out  using Version in the Shell or About from the
  29. Workbench's   Workbench   menu.    You   also   need   to   have   the
  30. commodities.library  in your libs:  directory.  Please check this out:
  31. type "dir libs:" in the shell.
  32.  
  33.  
  34. How to start a commodity:
  35. -------------------------
  36. First  there  are  two  basically different ways to start a commodity:
  37. via Workbench or via Shell.
  38.  
  39.     Starting  it  via Workbench is extrem simple:  just doubleclick on
  40. its  icon  and  the  commodity gets started.  Perhaps you might change
  41. some  parameters of the commodity.  You do this with tool types.  Tool
  42. types can be changed by clicking at the commodities icon and selecting
  43. Information from the Workbench's Icon menu.  In the window which opens
  44. you  see a listview gadget in which all tool types are listed.  Please
  45. refer  to  your  Workbench  documentation  on  how to change this tool
  46. types.  Which parameters you can change for this specific commodity is
  47. described below.
  48.     Please  note  that  another  double  click on the commodity's icon
  49. forces  the  commodity  to quit, if it's already running.  Running two
  50. copies  of  this commodity at the same time isn't useful and therefore
  51. possible.
  52.     To  start  a commodity via shell you type in its name.  If you get
  53. an  "Unknown  command  ???"  error  message,  you  have misspelled the
  54. commodity's  name  or the commodity isn't in your current directory or
  55. in the current search path.  The easiest way is to change your current
  56. directory  to the location of the commodity using the CD command.  You
  57. can  change  parameters  of  a commodity by command line options.  The
  58. available options are listed with ?  as the first parameter:
  59.  
  60.                             AutoActivate ?
  61.  
  62. gives you a list of the command line options.  The explanation of each
  63. option is below.  Starting the commodity once more while it is already
  64. running forces the commodity to quit.
  65.  
  66.     If  you  want  the  commodity to be started at every boot-up, it's
  67. best to add this line to your User-Startup file:
  68.  
  69.                      <path>AutoActivate <options>
  70.  
  71. Don't  forget  to  replace  <path>  by  the  path to the commodities's
  72. location  and <options> by the options you want to change. For example
  73. add this line if your commodity is located in the Tools drawer of your
  74. boot disk:
  75.  
  76.                           Tools/AutoActivate
  77.  
  78.     Another way to start the commodity at every boot-up is to drag its
  79. icon  in  the  WBStartup drawer of your boot disk.  Then the commodity
  80. gets  started  as if you had double clicked on its icon.  But you have
  81. to  add the tool type DONOTWAIT to the icon.
  82.  
  83.  
  84. Using Exchange:
  85. ---------------
  86. Exchange is the commodities controller program. With Exchange you can
  87. control all commodities: you can kill, disable, enable, show and hide
  88. commodities.
  89.     Start  the  Exchange  program,  which  usually is in the Utilities
  90. drawer  of your boot disk, by double clicking its icon.  Now you see a
  91. list  of  the available commodities.  Select the commodity you want to
  92. control.   The  commodities title, description and status is shown now
  93. below the listview gadget.
  94.     You  can  kill  the  commodity  using  the  Kill gadget...  If the
  95. commodity  has  a  window  to  open,  in which you usually change some
  96. parameters,  you  can  open  this window using Show.  Hide closes this
  97. window. AutoActivate has no window, which can be opened.
  98.  
  99.                         Changeable parameters:
  100.                         ----------------------
  101.  
  102. CX_Priority:
  103. ------------
  104. You  can  specify  the priority of the Commodity within the commodities
  105. queue  using  the tool type or commandline option CX_PRIORITY=<number>,
  106. where <number> is the decimal value for the priority.  Default priority
  107. is 0.
  108.  
  109.  
  110.    Send bug-reports, enhancement-requests, questions, gifts(!) to:
  111.    ---------------------------------------------------------------
  112.                             Stefan Sticht
  113.                           Bibereckerweg 40a
  114.                            D-8390 Passau 18
  115.                                  FRG
  116.  
  117. or (better) EMail to:
  118. cbmvax.commodore.com!cbmehq!cbmger!danube!edith!sticht [prefered!]
  119. or sticht%edith@danube.deg.sub.og
  120. or sticht@eva.uni-passau.de
  121. or IWSTICHT@ibm.rz.uni-passau.de
  122. Fido-Net: Stefan Sticht (2:242/77:4)
  123.  
  124. Please include the version number of the commodity in every bug report.
  125. You  get  the  version  number  using  the  Version  command:
  126.                      Version [<path>]<commodity>
  127.  
  128.