Fix up this man page considerably.

1 files 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 <msmith@FreeBSD.org>. 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 <msmith@FreeBSD.org>.
+Both inherit code from the XFree Project.