From b0a9f0bc62af3bfbacd85c62e90ee1d3cff1a01d Mon Sep 17 00:00:00 2001 From: Aaron Campbell Date: Mon, 30 Oct 2000 18:48:03 +0000 Subject: Fix up this man page considerably. --- usr.sbin/moused/moused.8 | 257 +++++++++++++++++++++++++++-------------------- 1 file changed, 146 insertions(+), 111 deletions(-) diff --git a/usr.sbin/moused/moused.8 b/usr.sbin/moused/moused.8 index e3eaccfcca8..bf404d4b10c 100644 --- a/usr.sbin/moused/moused.8 +++ b/usr.sbin/moused/moused.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: moused.8,v 1.3 2000/09/09 17:14:56 deraadt Exp $ +.\" $OpenBSD: moused.8,v 1.4 2000/10/30 18:48:02 aaron Exp $ .\" .Dd August 30, 2000 .Dt MOUSED 8 i386 @@ -49,62 +49,73 @@ maps the right mouse button to paste. The options are as follows: .Bl -tag -width Ds .It Fl 3 -Emulate the third (middle) button for 2-button mice. It is emulated by pressing -the left and right physical buttons simultaneously. +Emulate the third (middle) button for 2-button mice. +It is emulated by pressing the left and right physical buttons simultaneously. .It Fl C Set double click speed as the maximum interval in msec between button clicks. -Without this option, the default value of 500 msec will be assumed. This option -will have effect only on the cut and paste operations in the text mode console. +If omitted, the default value of 500 msec will be assumed. +This option will have effect only on the cut and paste operations +in the text mode console. .It Fl D -Lower DTR on the serial port. This option is valid only if -.Pa mousesystems -is selected as the protocol type. The DTR line may need to be -dropped for a 3-button mouse to operate in the -.Pa mousesystems +Lower DTR on the serial port. +This option is valid only if +.Em mousesystems +is selected as the protocol type. +The DTR line may need to be dropped for a 3-button mouse to operate in the +.Em mousesystems mode. .It Fl F Ar rate -Set the report rate (reports/sec) of the device if supported. +Set the report rate (reports/sec) of the device, if supported. .It Fl I Ar file -Write the process id of the -.Pa moused -daemon in the specified file. Without this option, the process id will be stored -in -.Pa /var/run/moused.pid. +Write the process ID of +.Nm +to the specified +.Ar file . +If omitted, the process ID will be stored in +.Pa /var/run/moused.pid . .It Fl P Do not start the Plug and Play COM device enumeration procedure when identifying -the serial mouse. If this option is given together with the -.Pa i -option, the -.Pa moused -command won't be able to print useful information for the serial mouse. +the serial mouse. +If this option is given together with the +.Fl i +option, +.Nm +won't be able to print useful information for the serial mouse. .It Fl R -Lower RTS on the serial port. This option is valid only if -.Pa mousesystems +Lower RTS on the serial port. +This option is valid only if +.Em mousesystems is selected as the protocol type by the -.Pa -t -option below. It is often used with the -.Pa -D option above. Both RTS and DTR lines may need to be dropped for a +.Fl t +option below. +It is often used with the +.Fl D +option above. +Both the RTS and DTR lines may need to be dropped for a 3-button mouse to operate in the -.Pa mousesystems +.Em mousesystems mode. is selected as the protocol type by the -.Pa mousesystems +.Em mousesystems mode. .It Fl S Ar baudrate Select the baudrate for the serial port (1200 to 9600). Not all serial mice support this option. .It Fl c Some mice report middle button down events as if the left and right buttons are -pressed. This option handles this. +pressed. +This option handles this. .It Fl d Enable debugging messages. .It Fl f -Do not become a daemon and instead run as a foreground process. Useful for -testing and debugging. +Do not become a daemon and instead run as a foreground process. +Useful for testing and debugging. .It Fl i Ar info -Print specified information and quit. Available pieces of information are : -.Bl -column -indent -.It port Ta Device name, i.e., +Print specified information and quit. +Available pieces of information are: +.Bl -tag -width model +.It port +Device name, i.e., .Pa /dev/cua0[0-3] for a serial mouse, .Pa /dev/lms0 @@ -113,29 +124,38 @@ for a logitech-style bus mouse, for a microsoft-style bus mouse and .Pa /dev/psm0 for a PS/2 mouse. -.It if Ta Physical interface : serial, bus, inport or PS/2. -.It type Ta Protocol type : one of the type supported by the -.Pa -t +.It if +Physical interface: serial, bus, inport, or PS/2. +.It type +Protocol type: one of the types supported by the +.Fl t option. -.It model Ta Mouse model. The -.Pa moused -command may not always be able to identify the model. -.It all Ta All of the above options. Print device name, physical interface, type -and model in this order, in one line. +.It model +Mouse model. +.Nm +may not always be able to identify the model. +.It all +All of the above options. +Print device name, physical interface, type, and model in this order, on +a single line. .El .It Fl m Ar mousetype -Precise the model of the mouse. For example, -.Pa IntelliMouse +Precise the model of the mouse. +For example, +.Em intellimouse can be specified for a PS/2 mouse with a wheel. .It Fl M Ar N=M Assign the physical button -.Pa N +.Em N to the logical button -.Pa M. -You may specify as many instances of this option as you like. More than one -physical button may be assigned to a logical button at the same time. In this -case the logical button will be down, if either of the assigned physical buttons -is held down. Do not put space around `='. +.Em M . +You may specify as many instances of this option as you like. +More than one +physical button may be assigned to a logical button at the same time. +In this case the logical button will be down, if either of the assigned +physical buttons is held down. +Do not put space around +.Ql = . .It Fl w Ar N Make the physical button .Ar N @@ -148,12 +168,11 @@ option below. .It Fl z Ar target Map Z axis (roller/wheel) movement to another axis or to virtual buttons. Valid -.Ar target -maybe: -.Bl -tag -compact -width x__ -.It Ar x -.It Ar y -X or Y axis movement will be reported when the Z axis movement is detected. +.Ar targets +are: +.Bl -tag -width x___ +.It Ar x , Ar y +X or Y axis movement will be reported when Z axis movement is detected. .It Ar N Report the virtual buttons .Ar N @@ -170,9 +189,9 @@ from the Z axis movement to the virtual buttons is done. .El .It Fl p Ar port Use the device -.Pa port +.Em port to communicate with the mouse. -.Pa port +.Em port must be one of .Pa /dev/cua0[0-3] for a serial mouse, @@ -184,85 +203,101 @@ for a microsoft-bus style mouse or for a PS/2 mouse. .It Fl r Ar resolution Set the resolution of the device; in Dots Per Inch, or -.Pa low -, -.Pa medium-low -, -.Pa medium-high +.Em low , +.Em medium-low , +.Em medium-high , or -.Pa high. +.Em high . This option may not be supported by all the devices. .It Fl s -Select a baudrate of 9600 for the serial line. Not all serial mice support this -option. +Select a baudrate of 9600 for the serial line. +Not all serial mice support this option. .It Fl t Ar type -Specify the protocol type of the mouse attached to the port. You may explicitly -specify a type listed below or use -.Pa auto -to let the -.Pa moused -command to automatically select an appropriate protocol for the given mouse. If -you entirely ommit this option in the command line, -.Pa auto -is assumed. Under normal circumstances, you need to use this option only if the -.Pa moused -command is unable to detect the protocol automatically. +Specify the protocol type of the mouse attached to the port. +You may explicitly specify a type listed below or use +.Em auto +to let +.Nm +to automatically select an appropriate protocol for the given mouse. +If this option is not specified, +.Em auto +is assumed. +Under normal circumstances, you need to use this option only if +.Nm +is unable to detect the protocol automatically. .Pp Note that if a protocol type is specified with this option, the -.Pa -P -option above is implied and Plug and Play COM device enumeration procedure will be disabled. +.Fl P +option above is implied and Plug and Play COM device enumeration procedure +will be disabled. .Pp Also note that if your mouse is attached to the PS/2 mouse port, you should always choose -.Pa auto +.Em auto or -.Pa ps/2 , -regardless of the brand and model of the mouse. Likewise, if your mouse is -attached to the bus mouse port, choose -.Pa auto +.Em ps/2 , +regardless of the brand and model of the mouse. +Likewise, if your mouse is attached to the bus mouse port, choose +.Em auto or -.Pa busmouse . +.Em busmouse . Serial mouse protocols will not work with these mice. .Pp -Valid protocol type for this option are the following: +Valid protocol types for this option are the following: .Pp For serial mice: .Bl -tag -width thinkingmouse -.It microsoft Ta Microsoft serial mouse protocol. Most 2-button serial mice use this protocol. -.It intellimouse Ta Microsoft IntelliMouse protocol. Genius NetMouse, ASCII Mie -Mouse, Logitech MouseMan+ and FirstMouse+ use this protocol too. Other mice -with a roller/wheel may be compatible with this protocol. -.It mousesystems Ta MouseSystems 5-byte protocol. 3-button mice may use this -protocol. -.It mmseries Ta MM Series mouse protocol. -.It logitech Ta Logitech mouse protocol. Note that this is for old Logitech -models. -.Pa mouseman +.It microsoft +Microsoft serial mouse protocol. +Most 2-button serial mice use this protocol. +.It intellimouse +Microsoft IntelliMouse protocol. +Genius NetMouse, ASCII Mie Mouse, Logitech MouseMan+, and FirstMouse+ use +use this protocol as well. +Other mice with a roller/wheel may be compatible with this protocol. +.It mousesystems +MouseSystems 5-byte protocol. +3-button mice may use this protocol. +.It mmseries +MM Series mouse protocol. +.It logitech +Logitech mouse protocol. +Note that this is for old Logitech models +.Em mouseman or -.Pa intellimouse +.Em intellimouse should be specified for newer models. -.It mouseman Ta Logitech MouseMan and TrackMan protocol. Some 3-button mice -may be compatible with this protocol. Note that MouseMan+ and FirstMouse+ use -.Pa intellimouse +.It mouseman +Logitech MouseMan and TrackMan protocol. +Some 3-button mice may be compatible with this protoco. +Note that MouseMan+ and FirstMouse+ use +.Em intellimouse protocol rather than this one. -.It glidepoint Ta ALPS GlidePoint protocol. -.It thinkingmouse Ta Ta Kensington ThinkingMouse protocol. -.It mmhitab Ta Hitachi tablet protocol. +.It glidepoint +ALPS GlidePoint protocol. +.It thinkingmouse +Kensington ThinkingMouse protocol. +.It mmhitab +Hitachi tablet protocol. .El .Pp -For the Logitech-style and Microsoft-style bus mouse: -.Bl -tag -indent -.It busmouse Ta This is the only protocol type available for the bus style +For the Logitech-style and Microsoft-style bus mice: +.Bl -tag -indent -width thinkingmouse +.It busmouse +This is the only protocol type available for the bus style mice and should be specified for any bus style mice, regardless of the brand. .El .Pp For the PS/2 mouse: -.Bl -tag -indent -.It ps/2 Ta This is the only protocol type available for the PS/2 mouse and +.Bl -tag -indent -width thinkingmouse +.It ps/2 +This is the only protocol type available for the PS/2 mouse and should be specified for any PS/2 mice, regardless of the brand. .Sh SEE ALSO .Xr pcvt 4 .Sh HISTORY -This moused daemon is a slightly modified version of the moused daemon from the -FreeBSD project, written by Michael Smith . Both inherits of -code from the Xfree Project. +The +.Nm +daemon is a slightly modified version of the moused daemon from the +FreeBSD project, written by Michael Smith . +Both inherit code from the XFree Project. -- cgit v1.2.3