Bug 65749

Summary: Reformatted version of XKB Extension Lib Spec
Product: XStandards Reporter: Graham Wideman <gwbugz>
Component: XKBAssignee: Matt Dew <marcoz>
Status: RESOLVED MOVED QA Contact: Xorg Project Team <xorg-team>
Severity: normal    
Priority: medium CC: marcoz
Version: X11R6.6Keywords: love
Hardware: All   
OS: All   
Whiteboard:
i915 platform: i915 features:
Attachments: Reformatted version of X11R7.7 xkblib.pdf

Description Graham Wideman 2013-06-14 10:24:40 UTC 
X Keyboard Extension: Library Specification 
(http://www.x.org/releases/X11R7.7/doc/libX11/XKB/xkblib.html)
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.