sys/man/8/mouse

   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.
 119
 120