[PATCH app/xinput] man: clean up the man page.

Alan Coopersmith Alan.Coopersmith at Sun.COM
Thu Oct 8 22:25:08 PDT 2009


Looks good to me.

Reviewed-by: Alan Coopersmith <alan.coopersmith at sun.com>

Peter Hutterer wrote:
> Several changes to the man page to tidy it up a bit:
> - RCS tag removed
> - synopsis shortened, OPTIONS section added instead
> - "xinput" dropped before the option descriptions, options in manpage
>   prefixed with '--'.
> - device_name replaced with just device, since it may be a deviceid.
> - Removed references to XI man page calls that some options use, it really
>   doesn't matter to users what the underlying Xlib call is.
> - mark set-int-prop and set-float-prop as deprecated in the man page.
> - add --test_xi2 flag
> - Added a few more authors.
> 
> Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
> ---
> 
> A long-needed xinput man page update.
> 
>  man/xinput.man |  100 +++++++++++++++++++++++++++++--------------------------
>  1 files changed, 53 insertions(+), 47 deletions(-)
> 
> diff --git a/man/xinput.man b/man/xinput.man
> index eba85fd..174df27 100644
> --- a/man/xinput.man
> +++ b/man/xinput.man
> @@ -1,99 +1,103 @@
> -.\" $Id: xinput.man,v 1.5 1997/06/09 16:06:31 fred Exp $
>  .TH xinput 1 __xorgversion__
>  
>  .SH NAME
> -xinput - utility to configure and test XInput devices
> +xinput - utility to configure and test X input devices
>  
>  .SH SYNOPSIS
> -.B xinput
> -[version]
> -[list [--short || --long] [\fIdevice_name\fP]]
> -[set-pointer \fIdevice_name\fP]
> -[get-feedbacks \fIdevice_name\fP]
> -[set-mode \fIdevice_name\fP \fIABSOLUTE|RELATIVE\fP]
> -[set-ptr-feedback \fIdevice_name\fP \fIthreshold\fP \fInum\fP \fIdenom\fP]
> -[set-integer-feedback \fIdevice_name\fP \fIindex\fP \fIvalue\fP]
> -[set-button-map \fIdevice_name\fP \fImap button 1\fP [\fImap button 2\fP [\fI...\fP]]]
> -[query-state \fIdevice_name\fP]
> -[test [-proximity] \fIdevice_name\fP]
> +.B xinput [OPTIONS] [DEVICE]
>  
>  .SH DESCRIPTION
> +xinput is a utility to list available input devices, query information about
> +a device and change input device settings.
> +.SH OPTIONS
>  .TP 8
> -.B xinput version
> -test if the XInput extension is available and return the version number
> -of the program.
> +.B --version
> +Test if the X Input extension is available and return the version number
> +of the program. This option does not require a device name.
>  .PP
>  .TP 8
> -.B xinput list [--short || --long] [\fIdevice_name\fP]
> +.B --list [--short || --long] [\fIdevice\fP]
>  If no argument is given list all the input devices. If an argument is given,
> -show all the features of \fIdevice_name\fP. Uses XListInputDevices(3).
> +show all the features of \fIdevice\fP. Uses XListInputDevices(3).
>  If --long is provided, the output includes detailed information about the
>  capabilities of each devices. Otherwise, or if --short is provided, only the
>  device names and some minimal information is listed.
>  .PP
>  .TP 8
> -.B xinput get-feedbacks \fIdevice_name\fP
> -Display the feedbacks of \fIdevice_name\fP. Uses XGetFeedbackControl(3).
> +.B --get-feedbacks \fIdevice\fP
> +Display the feedbacks of \fIdevice\fP.
>  .PP
>  .TP 8
> -.B xinput set-pointer \fIdevice_name\fP
> -Switch \fIdevice_name\fP in core pointer. Uses XChangePointerDevice(3).
> +.B --set-pointer \fIdevice\fP
> +Switch \fIdevice\fP in core pointer.
> +This option does nothing on X servers 1.5 and later.
>  .PP
>  .TP 8
> -.B xinput set-mode \fIdevice_name\fP \fIABSOLUTE|RELATIVE\fP
> -Change the mode of \fIdevice_name\fP. Uses XSetDeviceMode(3).
> +.B --set-mode \fIdevice\fP \fIABSOLUTE|RELATIVE\fP
> +Change the mode of \fIdevice\fP.
>  .PP
>  .TP 8
> -.B xinput set-ptr-feedback \fIdevice_name\fP \fIthreshold\fP \fInum\fP \fIdenom\fP
> -Change the acceleration of \fIdevice_name\fP. Uses XChangeFeedbackControl(3).
> +.B --set-ptr-feedback \fIdevice\fP \fIthreshold\fP \fInum\fP \fIdenom\fP
> +Change the acceleration of \fIdevice\fP.
>  .PP
>  .TP 8
> -.B xinput set-integer-feedback \fIdevice_name\fP \fIindex\fP \fIvalue\fP
> -Change the value of an integer feedback of \fIdevice_name\fP. Uses XChangeFeedbackControl(3).
> +.B --set-integer-feedback \fIdevice\fP \fIindex\fP \fIvalue\fP
> +Change the value of an integer feedback of \fIdevice\fP.
>  .PP
>  .TP 8
> -.B xinput set-button-map \fIdevice_name\fP \fImap button 1\fP [\fImap button 2\fP [\fI...\fP]]
> -Change the button mapping of \fIdevice_name\fP. Uses XSetDeviceButtonMapping(3).
> +.B --set-button-map \fIdevice\fP \fImap_button_1\fP [\fImap_button_2\fP [\fI...\fP]]
> +Change the button mapping of \fIdevice\fP. The buttons are specified in
> +physical order (starting with button 1) and are mapped to the logical button
> +provided. 0 disables a button. The default button mapping for a device is 1
> +2 3 4 5 6 etc.
>  .PP
>  .TP 8
> -.B xinput query-state \fIdevice_name\fP
> -Query the device state. Uses XQueryDeviceState(3).
> +.B --query-state \fIdevice\fP
> +Query the device state.
>  .PP
>  .TP 8
> -.B xinput list-props \fIdevice_name\fP [\fIdevice_name\fP...]
> +.B --list-props \fIdevice\fP [\fIdevice\fP [\fI...\fP]]
>  Lists properties that can be set for the given device(s).
>  .PP
>  .TP 8
> -.B xinput set-int-prop \fIdevice_name\fP \fIproperty\fP \fIformat\fP \fIvalue\fP
> +.B --set-int-prop \fIdevice\fP \fIproperty\fP \fIformat\fP \fIvalue\fP
>  Sets an integer property for the device.  Appropriate values for \fIformat\fP
> -are 8, 16, or 32, depending on the property.
> +are 8, 16, or 32, depending on the property. Deprecated, use
> +.B --set-prop
> +instead.
>  .PP
>  .TP 8
> -.B xinput set-float-prop \fIdevice_name\fP \fIproperty\fP \fIvalue\fP
> -Sets a float property for the device.
> +.B --set-float-prop \fIdevice\fP \fIproperty\fP \fIvalue\fP
> +Sets a float property for the device. Deprecated, use
> +.B --set-prop
> +instead.
>  .PP
>  .TP 8
> -.B xinput set\-prop [\-\-type=\fIatom|float|int\fP] [\-\-format=\fI8|16|32\fP] \fIdevice_name\fP \fIproperty\fP \fIvalue\fP [...]
> +.B --set\-prop [\-\-type=\fIatom|float|int\fP] [\-\-format=\fI8|16|32\fP] \fIdevice\fP \fIproperty\fP \fIvalue\fP [...]
>  Set the property to the given value(s).  If not specified, the format and type
>  of the property are left as-is.  The arguments are interpreted according to the
>  property type.
>  .PP
>  .TP 8
> -.B xinput watch-props \fIdevice_name\fP
> +.B --watch-props \fIdevice\fP
>  Prints to standard out when property changes occur.
>  .PP
>  .TP 8
> -.B xinput delete-prop \fIdevice_name\fP \fIproperty\fP
> +.B --delete-prop \fIdevice\fP \fIproperty\fP
>  Delete the property from the device.
>  .PP
> -.PP
>  .TP 8
> -.B xinput test [-proximity] \fIdevice_name\fP
> -Register all extended events from \fIdevice_name\fP and enter an endless
> +.B --test [-proximity] \fIdevice\fP
> +Register all extended events from \fIdevice\fP and enter an endless
>  loop displaying events received. If the -proximity is given, ProximityIn
>  and ProximityOut are registered.
>  .PP
> -\fIdevice_name\fP can be the device name as a string or the XID of the
> +.TP 8
> +.B --test_xi2
> +Register for a number of XI2 events and display them. This option does not
> +take a device argument.
> +.PP
> +\fIdevice\fP can be the device name as a string or the XID of the
>  device.
>  .PP
>  \fIproperty\fP can be the property as a string or the Atom value.
> @@ -104,11 +108,13 @@ Copyright 1996,1997, Frederic Lepied.
>  .PP
>  Copyright 2008, Philip Langdale.
>  
> -.SH AUTHOR
> +.SH AUTHORS
>  
>  .nf
>  Philip Langdale, <philipl at alumni.utexas.net>
>  Frederic Lepied, France <Frederic.Lepied at sugix.frmug.org>
> +Peter Hutterer <peter.hutterer at who-t.net>
> +Julien Cristau <jcristau at debian.org>
> +Thomas Jaeger <ThJaeger at gmail.com>
> +and more.
>  .fi
> -
> -Patches, bug reports, and suggestions are welcome.

-- 
	-Alan Coopersmith-           alan.coopersmith at sun.com
	 Sun Microsystems, Inc. - X Window System Engineering



More information about the xorg-devel mailing list