[PATCH:libX11 0/2] Make XKB docs match implementation.

Alan Coopersmith alan.coopersmith at oracle.com
Sun Mar 19 19:32:21 UTC 2017


The things you find when cleaning out your old open bugs...

Since the code has been like this for over two decades, it's too late to
change it even if we wanted to, and the code is a better match for other
XKB functions, so it appears this was just a forgotten edit in the spec
long ago, which Sun then propogated into the man pages based on the spec.

We found this originally when updating the Solaris AccessX code base from
the old standalone extension to using XKB instead, and reported it at the
time to the old X.Org Group, and waited for them to convene their standards
committee to update the formal standard spec.

That didn't happen before the X.Org industry consortium handed X off to the
X.Org open source foundation.  I forwarded the bug for the new X.Org standards
at https://bugs.freedesktop.org/show_bug.cgi?id=251 which waited for us to
figure out what the standards process would be.  Once we decided there was
effectively none, then we waited to get the XKB specs doc converted from
FrameMaker into a open format we could edit (thanks Matt!) and by the time
that was done, this was long forgotten.

Alan Coopersmith (2):
  Make Xkb{Get,Set}NamedIndicator spec & manpages match code
  Clarify state parameter to XkbSetNamedDeviceIndicator

 man/xkb/Makefile.am                    |   2 +
 man/xkb/XkbGetNamedDeviceIndicator.man |   1 +
 man/xkb/XkbGetNamedIndicator.man       |  58 +++++--
 man/xkb/XkbSetNamedDeviceIndicator.man |   1 +
 man/xkb/XkbSetNamedIndicator.man       |  88 ++++++++--
 specs/XKB/ch08.xml                     | 302 ++++++++++++++++++++++++++++++---
 6 files changed, 401 insertions(+), 51 deletions(-)
 create mode 100644 man/xkb/XkbGetNamedDeviceIndicator.man
 create mode 100644 man/xkb/XkbSetNamedDeviceIndicator.man

-- 
2.7.4



More information about the xorg-devel mailing list