Re: [PATCH xinput] man: document XI2 options

[Jeremy Huddleston]

On Feb 3, 2010, at 21:06, Peter Hutterer wrote:

> +.B --reattach \fIdevice\fP \fImaster\fP
> +Reattach the given device to the given master device.

Formatting throughout this file seems inconsistent with respect to hilighting 
arguments in the descriptions.  Shouldn't this be more like:

.B --reattach \fIdevice\fP \fImaster\fP
Reattach \fIdevice\fP to the \fImaster\fP device.

which better matches what's already in the man page:
.B --get-feedbacks \fIdevice\fP
Display the feedbacks of \fIdevice\fP.

I just picked this one line as an example, but there are inconsistencies like 
this throughout.  As example, this is currently in the man page:


___
xorg-devel mailing list
xorg-devel@lists.x.org
http://lists.x.org/mailman/listinfo/xorg-devel

[PATCH xinput] man: document XI2 options

[Peter Hutterer]

Document the options to modifiy the device hierarchy and change the
ClientPointer.

Signed-off-by: Peter Hutterer 
---
 man/xinput.man |   29 +
 1 files changed, 29 insertions(+), 0 deletions(-)

diff --git a/man/xinput.man b/man/xinput.man
index 7e1a9d3..42739fe 100644
--- a/man/xinput.man
+++ b/man/xinput.man
@@ -102,6 +102,35 @@ and ProximityOut are registered.
 Register for a number of XI2 events and display them. This option does not
 take a device argument.
 .PP
+.TP 8
+.B --create-master \fIprefix\fP [sendCore] [enable]
+Create a new pair of master devices on an XI2-enabled server with the given
+prefix. The server will create one master pointer named "prefix pointer"
+and one master keyboard named "prefix keyboard".  If sendCore is 1, this
+pair of master devices is set to send core events (default).
+If enable is 1, this master device pair will be enabled immediately.
+.PP
+.TP 8
+.B --remove-master \fIdevice\fP [Floating|AttachToMaster] [returnPointer] 
[returnKeyboard]
+Remove the given master device and the paired master device. Attached slave
+devices are set floating if Floating is specified or the argument is
+omitted. If the second argument is AttachToMaster, returnPointer specifies
+the master pointer to attach all slave pointers to and returnKeyboard 
specifies the
+master keyboard to attach all slave keyboards to.
+.PP
+.TP 8
+.B --reattach \fIdevice\fP \fImaster\fP
+Reattach the given device to the given master device.
+.PP
+.TP 8
+.B --float \fIdevice\fP
+Float the given device (i.e. remove it from the master device).
+.PP
+.TP 8
+.B --set-cp \fIwindow\fP \fIdevice\fP
+Set the ClientPointer for the client owning window to device. Device must
+specify a master pointer.
+.PP
 \fIdevice\fP can be the device name as a string or the XID of the
 device.
 .PP
-- 
1.6.6

___
xorg-devel mailing list
xorg-devel@lists.x.org
http://lists.x.org/mailman/listinfo/xorg-devel