From: Jacob Nevins <0jacobnk....@chiark.greenend.org.uk> Source: http://sourceforge.net/p/linuxwacom/patches/88/ Signed-off-by: Jason Gerecke <killert...@gmail.com> --- man/wacom.man | 2 ++ man/xsetwacom.man | 42 +++++++++++++++++++++++++++++++++--------- 2 files changed, 35 insertions(+), 9 deletions(-)
diff --git a/man/wacom.man b/man/wacom.man index ae042f6..cd33438 100644 --- a/man/wacom.man +++ b/man/wacom.man @@ -147,6 +147,8 @@ server will think they are the same physical button. The default action reported to the X server is mouse button M click. Because X uses buttons 4, 5, 6, and 7 as the four scrolling directions, physical buttons 4 and higher are mapped to 8 and higher by default. +Only simple button presses can be configured here; for more complex +actions, use xsetwacom(__appmansuffix__). To ignore the button click, i.e., to not report any button click event to the X server, use "0" or "button 0". .TP 4 diff --git a/man/xsetwacom.man b/man/xsetwacom.man index 35ee9fe..1930d67 100644 --- a/man/xsetwacom.man +++ b/man/xsetwacom.man @@ -56,8 +56,8 @@ or the command. Note that not all parameters are available on all device types. .TP \fBlist\fR modifiers -List the available list of modifiers to be used when setting key or button -actions. +List the aliases for modifiers and other keys that can be used when setting +button action mappings. .SS "GET COMMANDS" .TP @@ -104,17 +104,41 @@ is provided, the default mapping is restored. Numeric button mappings indicate what X11 button number the given button-number should correspond to. For example, a mapping of "3" means a press of the given -button-number will produce as a press of X11 button 3 (i.e. right click). +button-number will produce a press of X11 button 3 (i.e. right click). Action mappings allow button presses to perform many events. They take the form -of a string of keywords and arguments. For example, "key +a +shift b -shift -a" -converts the button into a series of keystrokes, in this example "press a, press -shift, press and release b, release shift, release a". In addition to the "key" -keyword, "button" and "modetoggle" are also recognized. Multiple keywords may -be present in one action if desired: for example "key +ctrl button 5 key -ctrl". +of a string of keywords and arguments. + +The "key" keyword is following by a list of key names. These can optionally +be preceded by "+" for press and "-" for release. If +/- is not given, +press-and-release is assumed, except for modifier keys which are left pressed. +Key names can be X11 KeySyms or some aliases such as 'shift' or 'f1' (the +full list can be seen with the +.B list modifiers +command). + +For example, "key +a +shift b -shift -a" converts the button into a series of +keystrokes, in this example "press a, press shift, press and release b, +release shift, release a". + +The "button" keyword is similar except that its arguments are X11 button +numbers. + +The "modetoggle" keyword is also recognized; it takes no arguments, +and toggles the device mode between relative and absolute pointer tracking. + +The events in the action mapping are sent when the physical button is pressed. +If the action mapping leaves any buttons or keys pressed (such as a modifier +key), they will be released when the physical button is released. + +Multiple keywords may be present in one action if desired: for example +"key +ctrl button 5 key -ctrl". Each keyword takes all arguments until the +next keyword. + +A maximum of 256 presses and/or releases can be specified in an action mapping. The driver can only simulate physical key events but not keysyms and -xetwacom translates the mapping sequence into such events. Thus, +xsetwacom translates the mapping sequence into such events. Thus, symbols on the same physical key will generate the same event. For example, '1' and '!' are on the same key on a US keyboard and thus have the same keycode). For access to keys on a higher shift level, the sequence -- 1.9.2 ------------------------------------------------------------------------------ Is your legacy SCM system holding you back? Join Perforce May 7 to find out: • 3 signs your SCM is hindering your productivity • Requirements for releasing software faster • Expert tips and advice for migrating your SCM now http://p.sf.net/sfu/perforce _______________________________________________ Linuxwacom-devel mailing list Linuxwacom-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linuxwacom-devel
