mouse 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. .TH MOUSE 8
  2. .SH NAME
  3. aux/mouse, aux/accupoint \- configure a mouse to a port
  4. .SH SYNOPSIS
  5. .B aux/mouse
  6. [
  7. .B -b
  8. .I baud
  9. ] [
  10. .B -d
  11. .I type
  12. ] [
  13. .B -n
  14. ]
  15. .I port
  16. .PP
  17. .B aux/accupoint
  18. .SH DESCRIPTION
  19. .B Mouse
  20. queries a mouse on a serial or PS2 port for
  21. its type and then configures the port and the
  22. mouse to be used to control the cursor.
  23. .PP
  24. .I Port
  25. can be either a port number (e.g.
  26. .B 0
  27. or
  28. .BR 1 )
  29. or the string
  30. .B ps2
  31. or
  32. .BR ps2intellimouse .
  33. The initialization can be automated by setting
  34. .BR mouseport
  35. in
  36. .IR plan9.ini (8),
  37. which will enable a call to
  38. .I mouse
  39. in
  40. .B termrc
  41. (see
  42. .IR cpurc (8)).
  43. .PP
  44. The option
  45. .B -d
  46. provides a default mouse type should
  47. .B mouse
  48. fail to determine it. The
  49. types are:
  50. .IP C
  51. Logitech type C mouse
  52. .IP W
  53. Logitech type W mouse
  54. .IP M
  55. Microsoft compatible mouse
  56. .PP
  57. The
  58. .B -n
  59. flag queries the mouse and reports its type but does not set the device type.
  60. .PP
  61. The
  62. .B -b
  63. flag sets the baud rate for communication; it is effectual only for serial mice.
  64. .SH
  65. .I Accupoint
  66. is a process, to be used with
  67. .IR pipefile (1),
  68. that processes events from an AccuPoint II pointing device
  69. with four buttons, such as on Toshiba Portégé 3440CT and 3480CT
  70. laptops, converting events on the two extra buttons
  71. (which appear as buttons 4 and 5 in the
  72. .IR mouse (3)
  73. interface) into a simulation of button 2.
  74. These extra buttons on laptops are in turn simulations of Intellimouse
  75. scrolling buttons and have peculiar properties: they generate
  76. only `down' events that repeat automatically, like a keypad, in
  77. an approximation of the Intellimouse scroll wheel.
  78. .I Accupoint
  79. overcomes this behavior to produce a reasonable approximation of
  80. a normal mouse button 2:
  81. it makes left button act like a regular button 2, but is slow to release (the
  82. program must wait for a repeat time before it knows the button has been released),
  83. while the right button generates a fast button 2 `click'.
  84. To use
  85. .IR accupoint ,
  86. add a line like this to
  87. .B /usr/$user/lib/profile
  88. or to a system-dependent configuration script in
  89. .B termrc
  90. (see
  91. .IR cpurc (8)):
  92. .EX
  93. .IP
  94. pipefile -dr /bin/aux/accupoint /dev/mouse
  95. .EE
  96. .PP
  97. Before running
  98. .IR accupoint ,
  99. the mouse should be configured as an
  100. .B intellimouse
  101. or
  102. .BR ps2intellimouse .
  103. .SH SOURCE
  104. .B /sys/src/cmd/aux/mouse.c
  105. .br
  106. .B /sys/src/cmd/aux/accupoint.c
  107. .SH SEE ALSO
  108. .IR cons (3),
  109. .IR cpurc (8),
  110. .IR pipefile (1).
  111. .SH BUGS
  112. Due to the limitations of
  113. .IR pipefile (1),
  114. when running
  115. .I accupoint
  116. it is difficult restart
  117. .IR rio (1)
  118. if it has exited.