diff mbox

Documentation: event-codes.txt: clarify we want BTN_TOOL_<name> on proximity

Message ID 20160224041203.GA32566@jelly.redhat.com (mailing list archive)
State Accepted
Headers show

Commit Message

Peter Hutterer Feb. 24, 2016, 4:12 a.m. UTC
This explicitly states behavior we already use for some touchpads and tablet
devices.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
---
 Documentation/input/event-codes.txt | 4 ++++
 1 file changed, 4 insertions(+)

Comments

Peter Hutterer April 6, 2016, 5:09 a.m. UTC | #1
On Wed, Feb 24, 2016 at 02:12:03PM +1000, Peter Hutterer wrote:
> This explicitly states behavior we already use for some touchpads and tablet
> devices.
> 
> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
> ---
>  Documentation/input/event-codes.txt | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/Documentation/input/event-codes.txt b/Documentation/input/event-codes.txt
> index 3f0f5ce..36ea940 100644
> --- a/Documentation/input/event-codes.txt
> +++ b/Documentation/input/event-codes.txt
> @@ -173,6 +173,10 @@ A few EV_ABS codes have special meanings:
>      proximity of the device and while the value of the BTN_TOUCH code is 0. If
>      the input device may be used freely in three dimensions, consider ABS_Z
>      instead.
> +  - BTN_TOOL_<name> should be set to 1 when the tool comes into detectable
> +    proximity and set to 0 when the tool leaves detectable proximity.
> +    BTN_TOOL_<name> signals the type of tool that is currently detected by the
> +    hardware and is otherwise independent of ABS_DISTANCE and/or BTN_TOUCH.
>  
>  * ABS_MT_<name>:
>    - Used to describe multitouch input events. Please see
> -- 
> 2.5.0
 
almost forgot about this one, Dmitry, you happy with this one?

Cheers,
   Peter
--
To unsubscribe from this list: send the line "unsubscribe linux-input" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Dmitry Torokhov April 6, 2016, 5:16 p.m. UTC | #2
On Wed, Feb 24, 2016 at 02:12:03PM +1000, Peter Hutterer wrote:
> This explicitly states behavior we already use for some touchpads and tablet
> devices.
> 
> Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>

Applied, thank you.

> ---
>  Documentation/input/event-codes.txt | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/Documentation/input/event-codes.txt b/Documentation/input/event-codes.txt
> index 3f0f5ce..36ea940 100644
> --- a/Documentation/input/event-codes.txt
> +++ b/Documentation/input/event-codes.txt
> @@ -173,6 +173,10 @@ A few EV_ABS codes have special meanings:
>      proximity of the device and while the value of the BTN_TOUCH code is 0. If
>      the input device may be used freely in three dimensions, consider ABS_Z
>      instead.
> +  - BTN_TOOL_<name> should be set to 1 when the tool comes into detectable
> +    proximity and set to 0 when the tool leaves detectable proximity.
> +    BTN_TOOL_<name> signals the type of tool that is currently detected by the
> +    hardware and is otherwise independent of ABS_DISTANCE and/or BTN_TOUCH.
>  
>  * ABS_MT_<name>:
>    - Used to describe multitouch input events. Please see
> -- 
> 2.5.0
>
diff mbox

Patch

diff --git a/Documentation/input/event-codes.txt b/Documentation/input/event-codes.txt
index 3f0f5ce..36ea940 100644
--- a/Documentation/input/event-codes.txt
+++ b/Documentation/input/event-codes.txt
@@ -173,6 +173,10 @@  A few EV_ABS codes have special meanings:
     proximity of the device and while the value of the BTN_TOUCH code is 0. If
     the input device may be used freely in three dimensions, consider ABS_Z
     instead.
+  - BTN_TOOL_<name> should be set to 1 when the tool comes into detectable
+    proximity and set to 0 when the tool leaves detectable proximity.
+    BTN_TOOL_<name> signals the type of tool that is currently detected by the
+    hardware and is otherwise independent of ABS_DISTANCE and/or BTN_TOUCH.
 
 * ABS_MT_<name>:
   - Used to describe multitouch input events. Please see