1 .\" Copyright (c) 1994 Joerg Wunsch
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
13 .\" 3. All advertising materials mentioning features or use of this software
14 .\" must display the following acknowledgement:
15 .\" This product includes software developed by Joerg Wunsch
16 .\" 4. The name authors may not be used to endorse or promote products
17 .\" derived from this software without specific prior written permission.
19 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
20 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22 .\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
23 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 .\" @(#)mcon.1, 3.00, Last Edit-Date: [Mon Jan 10 21:28:22 1994]
31 .\" $FreeBSD: src/usr.sbin/pcvt/mcon/mcon.1,v 1.8.2.1 2000/12/27 13:50:37 ru Exp $
38 .Nd controls pcvt mouse emulator
41 .Op Fl l Ar left-button-key
42 .Op Fl m Ar mid-button-key
43 .Op Fl r Ar right-button-key
44 .Op Fl a Ar accel-time
45 .Op Fl s Ar 0 | false | \&no
46 .Op Fl s Ar 1 | true | yes
51 utility controls the configurable parameters for the mouse emulator of
55 The mouse emulator is not configured in by default; the system's config
56 file needs to specify an option line
58 .Cd options PCVT_EMU_MOUSE
60 in order to get its functionality.
64 program must be called with an argument
66 that specifies the device node used for the mouse emulation.
68 usually the first device node of the
70 driver not being used as a virtual terminal device.
72 have configured eight virtual terminals
73 .Pq the default value ,
78 the mouse emulator would allocate
83 is called without any option, it will print the actual values of the
84 configurable parameters.
86 If called with an option, the program attempts to set up the new value.
88 The options are as follows:
90 .It Fl l Ar left-button-key
91 .It Fl m Ar mid-button-key
92 .It Fl r Ar right-button-key
95 to emulate either the left, middle, or right mouse button.
97 is the usual name for that key.
98 Normal ASCII keys are denoted by the
99 character they're labeled with, function keys are named
103 Note that the AT function keys
109 keys that cannot be mapped to be used with the mouse emulator since
110 it only allows basic PC-scancode keys to be used.
111 .It Fl a Ar accel-time
112 Set the time limit for the internal accelerator to
115 Key events occurring after a longer time than this limit
116 will move the mouse cursor in single steps.
117 Key events arriving more
118 frequently will move the cursor accelerated by a factor of 6. Note that
121 being the unit of choice here, the time resolution is restricted by the
122 timer tick distance of the underlying operating system, usually to a
123 granularity of 10 milliseconds.
124 .It Fl s Ar 0 | false | \&no
125 .It Fl s Ar 1 | true | yes
126 The first form disables, the second form enables the
128 behaviour of the mouse buttons.
129 Sticky mouse keys behave much like
130 toggle-buttons: on first press, they become active, on second press,
132 Pressing another button will deactivate any
133 other sticky button anyway.
135 Sticky buttons might be more convenient since you don't need 20 fingers
136 at all; on the other hand, they make it virtually impossible to initiate
137 double or triple mouse clicks.
140 The following example would install the default behaviour of the
151 The key names used to map the button-emulating keys to scan codes
153 are based on the American keyboard layout.
154 This would usually not
155 cause any trouble since the
157 is certainly some function key that should be equal for any national
160 The mouse emulator is a rude hack at all; its only purpose is to provide
161 a device to move the pointer within an X-windowing environment.
172 The mouse emulator has been contributed by
173 .An "J\(:org Wunsch" .