xcb-proto/0006-xproto.xml-Update-doc-text-for-GrabKey.patch
zhang-liang-pengkun a01e508fb7 xproto.xml: Update doc text for GrabKey
Signed-off-by: zhang-liang-pengkun <zhangliangpengkun@xfusion.com>
2024-01-05 17:08:36 +08:00

60 lines
2.1 KiB
Diff

From b51f95645f0dbbdeeb20b30774f66eb161b5ce37 Mon Sep 17 00:00:00 2001
From: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Tue, 1 Jun 2021 17:32:15 -0700
Subject: [PATCH] xproto.xml: Update doc text for GrabKey
A little too much copy-and-paste from the GrabPointer doc text had
happened here.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
---
src/xproto.xml | 13 +++++--------
1 file changed, 5 insertions(+), 8 deletions(-)
diff --git a/src/xproto.xml b/src/xproto.xml
index 116781e..19a8a6a 100644
--- a/src/xproto.xml
+++ b/src/xproto.xml
@@ -2981,25 +2981,21 @@ results (no grabs are established) if there is a conflicting grab for any combin
]]></description>
<field name="owner_events"><![CDATA[
-If 1, the `grab_window` will still get the pointer events. If 0, events are not
+If 1, the `grab_window` will still get the key events. If 0, events are not
reported to the `grab_window`.
]]></field>
<field name="grab_window"><![CDATA[
-Specifies the window on which the pointer should be grabbed.
+Specifies the window on which the key should be grabbed.
]]></field>
<field name="key"><![CDATA[
The keycode of the key to grab.
The special value `XCB_GRAB_ANY` means grab any key.
- ]]></field>
- <field name="cursor"><![CDATA[
-Specifies the cursor that should be displayed or `XCB_NONE` to not change the
-cursor.
]]></field>
<field name="modifiers"><![CDATA[
The modifiers to grab.
-Using the special value `XCB_MOD_MASK_ANY` means grab the pointer with all
+Using the special value `XCB_MOD_MASK_ANY` means grab the key with all
possible modifier combinations.
]]></field>
<!-- the enum doc is sufficient. -->
@@ -3010,7 +3006,8 @@ Another client has already issued a GrabKey with the same button/key
combination on the same window.
]]></error>
<error type="Value"><![CDATA[
-TODO: reasons?
+The key is not `XCB_GRAB_ANY` and not in the range specified by `min_keycode`
+and `max_keycode` in the connection setup.
]]></error>
<error type="Window"><![CDATA[
The specified `window` does not exist.
--
2.39.0.windows.2