xproto.xml: Update doc text for GrabKey

Signed-off-by: zhang-liang-pengkun <zhangliangpengkun@xfusion.com>

0006-xproto.xml-Update-doc-text-for-GrabKey.patch

@@ -0,0 +1,59 @@
+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
+

xcb-proto.spec

@@ -1,7 +1,7 @@
 %define debug_package %{nil}
 Name:           xcb-proto
 Version:        1.14
-Release:        7
+Release:        8
 Summary:        XCB protocol descriptions
 License:        MIT
 URL:            https://gitlab.freedesktop.org/xorg/proto/xcbproto/
@@ -11,6 +11,7 @@ Patch02:        0002-xcbgen-Use-math.gcd-for-Python-3.5.patch
 Patch03:        0003-xcbgen-xml.etree.cElementTree-has-been-dropped-in-Py.patch
 Patch04:        0004-xfixes-Add-ClientDisconnectMode.patch
 Patch05:        0005-xcbgen-Use-xml.etree.ElementTree-for-Python-3.3.patch
+Patch06:        0006-xproto.xml-Update-doc-text-for-GrabKey.patch
 BuildArch:      noarch
 
 BuildRequires:	python3-devel
@@ -41,6 +42,9 @@ export PYTHON="python3"
 %{python3_sitelib}/xcbgen
 
 %changelog
+* Fri Jan 05 2024 zhangliangpengkun<zhangliangpengkun@xfusion.com> - 1.14-8
+- xproto.xml: Update doc text for GrabKey
+
 * Tue Dec 26 2023 zhangliangpengkun<zhangliangpengkun@xfusion.com> - 1.14-7
 - xcbgen: Use xml.etree.ElementTree for Python >= 3.3.