home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 2 / amigaformatcd02.iso / pd / utilities / leftymouse / leftymouse.doc < prev    next >
Encoding:
Text File  |  1996-05-20  |  5.5 KB  |  132 lines
  1.  
  2.                               LeftyMouse
  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. LeftyMouse  is  a  commodity  which swaps the function of the left and
  20. right  mouse  buttons.   The  left button becomes the right button and
  21. vice  versa.  This commodity is intended to lefties, who use the mouse
  22. with their left hand.
  23.  
  24. Requirements:
  25. -------------
  26. This commodity requires at least Kickstart 37.#?  and Workbench 37.#?.
  27. Please  check  this  out  using Version in the Shell or About from the
  28. Workbench's   Workbench   menu.    You   also   need   to   have   the
  29. commodities.library in your libs:  directory.
  30.  
  31.  
  32. How to start a commodity:
  33. -------------------------
  34. First  there  are  two  basically different ways to start a commodity:
  35. via Workbench or via Shell.
  36.  
  37.     Starting  it  via Workbench is extrem simple:  just doubleclick on
  38. its  icon  and  the  commodity gets started.  Perhaps you might change
  39. some  parameters of the commodity.  You do this with tool types.  Tool
  40. types can be changed by clicking at the commodities icon and selecting
  41. Information from the Workbench's Icon menu.  In the window which opens
  42. you  see a listview gadget in which all tool types are listed.  Please
  43. refer  to  your  Workbench  documentation  on  how to change this tool
  44. types.  Which parameters you can change for this specific commodity is
  45. described below.
  46.     Please  note  that  another  double  click on the commodity's icon
  47. forces  the  commodity  to quit, if it's already running.  Running two
  48. copies  of  LeftyMouse  at  the  same  time isn't useful and therefore
  49. possible.
  50.     To  start  a commodity via shell you type in its name.  If you get
  51. an  "Unknown  command  ???"  error  message,  you  have misspelled the
  52. commodity's  name  or the commodity isn't in your current directory or
  53. in the current search path.  The easiest way is to change your current
  54. directory  to the location of the commodity using the CD command.  You
  55. can  change  parameters  of  a commodity by command line options.  The
  56. available options are listed with ?  as the first parameter:
  57.  
  58.                              LeftyMouse ?
  59.  
  60. gives you a list of the command line options.  The explanation of each
  61. option is below.  Starting the commodity once more while it is already
  62. running forces the commodity to quit.
  63.  
  64.     If  you  want  the  commodity to be started at every boot-up, it's
  65. best to add this line to your User-Startup file:
  66.  
  67.                      <path>LeftyMouse <options>
  68.  
  69. Don't  forget  to  replace  <path>  by  the  path to the commodities's
  70. location  and <options> by the options you want to change. For example
  71. add this line if your commodity is located in the Tools drawer of your
  72. boot disk:
  73.  
  74.                            Tools/LeftyMouse
  75.  
  76.     Another way to start the commodity at every boot-up is to drag its
  77. icon  in  the  WBStartup drawer of your boot disk.  Then the commodity
  78. gets  started  as if you had double clicked on its icon.  But you have
  79. to  add the tool type DONOTWAIT to the icon.
  80.  
  81.  
  82. Using Exchange:
  83. ---------------
  84. Exchange is the commodities controller program. With Exchange you can
  85. control all commodities: you can kill, disable, enable, show and hide
  86. commodities.
  87.     Start  the  Exchange  program,  which  usually is in the Utilities
  88. drawer  of your boot disk, by double clicking its icon.  Now you see a
  89. list  of  the available commodities.  Select the commodity you want to
  90. control.   The  commodities title, description and status is shown now
  91. below the listview gadget.
  92.     You  can  kill  the  commodity  using  the  Kill gadget...  If the
  93. commodity  has  a  window  to  open,  in which you usually change some
  94. parameters,  you  can  open  this window using Show.  Hide closes this
  95. window. LeftyMouse has no window, which can be opened.
  96.  
  97.                         Changeable parameters:
  98.                         ----------------------
  99.  
  100. CX_Priority:
  101. ------------
  102. You  can  specify the priority of the Commodity within the commodities
  103. queue  using the tool type or commandline option CX_PRIORITY=<number>,
  104. where  <unmber>  is  the  decimal  value  for  the  priority.  Default
  105. priority is 1.  The priority of this commodity may be important if you
  106. use  other  commodities  which  trap mousebuttons, as ClickToFront and
  107. toBack&Front  do.   LeftyMouse  must have a higher priority than these
  108. commodities  if  they also should notice the swap of the mousebuttons.
  109. You easily can proof this by starting Exchange and looking at the list
  110. of  commodities, which Exchange shows.  If LeftyMouse comes before the
  111. other  commodity,  which  traps  the  mousebuttons,  it  has  a higher
  112. priority  than  the  other  one.   If  not,  you  have to increase the
  113. priority  of  LeftyMouse over the priority of the other commodity.  If
  114. LeftyMouse is the first commodity in the list, everything's fine.
  115.  
  116.  
  117.    Send bug-reports, enhancement-requests, questions, gifts(!) to:
  118.    ---------------------------------------------------------------
  119.                             Stefan Sticht
  120.                           Bibereckerweg 40a
  121.                            D-8390 Passau 18
  122.                                  FRG
  123.  
  124. or (better) EMail to:
  125. sticht@edith.deg.sub.org
  126. Fido-Net: Stefan Sticht (2:246/200.4)
  127.  
  128. Please include the version number of the commodity in every bug report.
  129. You  get  the  version  number  using  the  Version  command:
  130.                      Version [<path>]<commodity>
  131.  
  132.