Bug 65749 - Reformatted version of XKB Extension Lib Spec
Summary: Reformatted version of XKB Extension Lib Spec
Alias: None
Product: XStandards
Classification: Unclassified
Component: XKB (show other bugs)
Version: X11R6.6
Hardware: All All
: medium normal
Assignee: Matt Dew
QA Contact: Xorg Project Team
Keywords: love
Depends on:
Reported: 2013-06-14 10:24 UTC by Graham Wideman
Modified: 2019-02-21 10:29 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:

Reformatted version of X11R7.7 xkblib.pdf (2.18 MB, application/octet-stream)
2013-06-14 10:25 UTC, Graham Wideman

Description Graham Wideman 2013-06-14 10:24:40 UTC
X Keyboard Extension: Library Specification 
is an essential doc for XKB, yet its formatting makes both the html and PDF versions almost impossible to use. Problems include:

-- Crucial diagrams either too small (html), or so large that only a portion is shown (pdf).

-- "See also section xxx" appears frequently, yet doc has no section numbers. (And the html version TOC has no page numbers, of course.)

-- The many source code samples are very poorly formatted for readability

No doubt these are problems with the translation process from the source format to PDF and HTML, and that process should be fixed.

In lieu of that, I have created a replacement version in which I've fixed all of these problems, (and edited nothing else).  Attached.

I suggest this be considered for addition to the doc page mentioned above.

If interested, my original is in Word format.
Comment 1 Graham Wideman 2013-06-14 10:25:59 UTC
Created attachment 80807 [details]
Reformatted version of X11R7.7 xkblib.pdf
Comment 2 GitLab Migration User 2019-02-21 10:29:47 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/xorg/lib/libx11/issues/88.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.