[PATCH libX11 1/4] man: Redirect users from XKeycodeToKeysym to XkbKeycodeToKeysym #25732

Dirk Wallenstein halsmit at t-online.de
Tue Feb 2 12:24:29 PST 2010

XKeycodeToKeysym keeps compatibility with pre-XKB and thus only sees 2
groups with 2 levels each. It wraps the index into the next group.
This behavior confuses the unaware user, and therefore this will add a
reference to XkbKeycodeToKeysym in the corresponding man paragraph.

Another bug had that issue, too. #5349

Signed-off-by: Dirk Wallenstein <halsmit at t-online.de>
 man/XStringToKeysym.man |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/man/XStringToKeysym.man b/man/XStringToKeysym.man
index 62212db..067765b 100644
--- a/man/XStringToKeysym.man
+++ b/man/XStringToKeysym.man
@@ -202,6 +202,10 @@ If no symbol is defined,
 .ZN XKeycodeToKeysym
 .ZN NoSymbol .
+.ZN XKeycodeToKeysym
+predates the XKB extension. If you want to lookup a KeySym while
+using XKB you have to use
+.ZN XkbKeycodeToKeysym .
 If the specified KeySym is not defined for any KeyCode,
 .ZN XKeysymToKeycode

More information about the xorg-devel mailing list