libX11: Changes to 'master'

Sun Jul 20 09:24:09 PDT 2014

 specs/XKB/acknowledgement.xml |    9 
 specs/XKB/ch01.xml            |  111 
 specs/XKB/ch02.xml            | 1046 +++--
 specs/XKB/ch03.xml            |  126 
 specs/XKB/ch04.xml            |  890 ++---
 specs/XKB/ch05.xml            | 1191 +++---
 specs/XKB/ch06.xml            |  464 +-
 specs/XKB/ch07.xml            |  533 +--
 specs/XKB/ch08.xml            | 2920 ++++++++--------
 specs/XKB/ch09.xml            | 1430 ++++----
 specs/XKB/ch10.xml            | 7425 ++++++++++++++++++++----------------------
 specs/XKB/ch11.xml            |  586 +--
 specs/XKB/ch12.xml            | 1358 +++----
 specs/XKB/ch13.xml            | 6770 +++++++++++++++++++-------------------
 specs/XKB/ch14.xml            | 2205 ++++++------
 specs/XKB/ch15.xml            | 4120 +++++++++++------------
 specs/XKB/ch16.xml            | 6441 ++++++++++++++++++------------------
 specs/XKB/ch17.xml            | 2350 ++++++-------
 specs/XKB/ch18.xml            | 1551 ++++----
 specs/XKB/ch19.xml            |  351 +
 specs/XKB/ch20.xml            | 1212 +++---
 specs/XKB/ch21.xml            | 3076 ++++++++---------
 specs/XKB/ch22.xml            |  323 -
 specs/XKB/glossary.xml        |  331 -
 specs/XKB/xkblib.xml          |    1 
 25 files changed, 23649 insertions(+), 23171 deletions(-)

New commits:
commit 0885cad1e4a9ed57266582be320be55259c881bf
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 20 09:21:20 2014 -0700

    specs/XKB: Markup fractions as <{super,sub}script> instead of <emphasis>
    
    Matches the way they were styled in original doc, before conversion
    to DocBook.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit d0a9e9d56bb003315787201ee525b4d00fd54e06
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 23:55:47 2014 -0700

    specs/XKB: acknowledge my contributions
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 9c0be82017f513e2eb63d59b095f1cf1955f2e2b
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 23:53:48 2014 -0700

    specs/XKB: Trim leading spaces off text lines
    
    perl -i -p -e 's{/\*(\S)}{/* \1}g;' *.xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 75b0b10990f38d966c6fcc821bf15e58c5a90c91
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 20:30:55 2014 -0700

    specs/XKB: Add olinks to libX11 for "X Library Functions Affected by Xkb"
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 5009621799444e9d1d284719f871d00be13e7330
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 12:34:28 2014 -0700

    specs/XKB: Fix miscelleanous typos & spelling errors
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit ac219bf1522a592bd3e3283b1a6ea3dfd2c3c48c
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 00:46:41 2014 -0700

    specs/XKB: add some more indexterms by hand
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 5c3aa4c69e65ecf2e56d5e26f3833fb5d31973c2
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 00:48:02 2014 -0700

    specs/XKB: fixup various formatting issues in <programlisting>s
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 70c648ff852fd9bc784967cfc77ea70bd7f14c8d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 23:56:29 2014 -0700

    specs/XKB: fixup various formatting issues in <literallayout>s
    
    Including translating some that are really just lists into
    <simplelist> markup.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 94b56774784ac00b9db02403aecea10bb0814c10
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 23:18:52 2014 -0700

    specs/XKB: add some more links by hand
    
    random bits where a link looked handy
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 7a15a934cdb07ed1b991bd0ef633f32ee00b1833
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 23:16:31 2014 -0700

    specs/XKB: add links for terms in definition list under figure 1.1
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 92b86fc3c50fbb7ab2e36af10a2fb3fe6284f58c
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:52:16 2014 -0700

    specs/XKB: add links to more tables listing section references
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 06a4483a05053b4f8d8c0d4cc0513c68ea912676
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:49:34 2014 -0700

    specs/XKB: Table 4.1: remove page numbers & unnecessary para tags
    
    Page numbers refer to old doc format, didn't translate to new one
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 61bd55c6d1ab211b89d604bd05555dc417f6e53d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 11:55:51 2014 -0700

    specs/XKB: remove unwanted white space around C -> struct references
    
    perl -i -0 -p -e 's{\s*->\s*}{->}g' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 2be0cc0b2abbcc98cfd150210dea415a04787251
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:26:20 2014 -0700

    specs/XKB: replace -> with → when used as arrow, not in C structs
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit bf1f3d6f6f995303624679ae546f507c70967dc0
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:21:10 2014 -0700

    specs/XKB: replace => with ⇒ for double arrows
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit c7ee427fc0a72abd4a4f147ab16a5d1128a6a2ba
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 11:33:35 2014 -0700

    specs/XKB: Markup some ranges with – instead of -

commit ec4075303c6c0d1d64bfe378e585968f9a137da7
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:10:45 2014 -0700

    specs/XKB: Markup some subtractions with − instead of -
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 441a267e461132a38abed205245f028686526f1d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 22:04:40 2014 -0700

    specs/XKB: make sure all files have DOCTYPEs so standard entities work
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 88fd70bee410f290b4f540405fdc7ecd85c26f25
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 21:55:41 2014 -0700

    specs/XKB: Markup quoted terms as <quote> instead of with ""
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 3576587ff10334a8f48c34b4fe5b7e829dec9a1b
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sat Jul 19 09:01:26 2014 -0700

    specs/XKB: fixup newlines between tags and punctuation
    
    Get rid of unwanted whitespace before punctuation by moving them to the
    lines with the tags, instead of before & after.
    
    perl -i -0 -p -e 's{\>\s*\n([\.,;:])}{>\1\n}g' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 6d5ec492cd28c206423337f926503349702af5a6
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 21:29:33 2014 -0700

    specs/XKB: fixup newlines between tags and parens
    
    Get rid of unwanted whitespace inside parens by moving them to the
    lines with the tags, instead of before & after.
    
    perl -i -0 -p \
         -e 's{(?<!--) \(\s*\n\<}{\n(<}g;' \
         -e 's{\>\s*\n\)([\.,;]?)(?! [^\n]*--)}{>)\1\n}g' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 59d688f4c787250e0b401a92b1db0437d8c60f2d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Fri Jul 18 21:09:24 2014 -0700

    specs/XKB: Markup key terms as <firstterm> instead of <emphasis>
    
    Also add <indexterm> entries for most of them, to make their definitions
    or introductions easy to find from the index.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 861f3087ee0f501362a67501f384c2ca4c7bfe73
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 20:00:53 2014 -0700

    specs/XKB: Manual fixup of type markup
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 6b96259dabe52701fd1bcaa0625b574180c4e769
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 15:00:30 2014 -0700

    specs/XKB: Manual fixup of parameter markup
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 5526dce6812a84102f556fdde8f2b52b21c8bcdc
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 13:40:40 2014 -0700

    specs/XKB: Manual fixup of struct name/field markup
    
    Handles typos that caused the scripts to miss matches, misnamed structs, etc.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit c36ee1a4db4e7876526190b8ab6b0da5867f76f7
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Wed Jul 9 23:26:37 2014 -0700

    specs/XKB: Manual fixup of symbol name markup
    
    Handles typos that caused the scripts to miss matches, misnamed masks, etc.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit eb1453a0c69606b8af96b90ddccf1b93a069fb35
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Wed Jul 9 00:03:23 2014 -0700

    specs/XKB: Manual fixup of function name markup
    
    Handles typos that caused the scripts to miss matches, functions like
    malloc & free from other libraries, function name patterns, etc.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 252d99c87b60ac6f3f2b36f292f9b3880daabe26
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 19:42:31 2014 -0700

    specs/XKB: Markup protocol requests as <systemitem> instead of <emphasis>
    
    No great fit in DocBook, so follow what we used in Xlib spec.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit ed60df10aad15057577d5714c955d22d2a446e51
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 15:45:57 2014 -0700

    specs/XKB: Markup keyboard keys as <keycap> instead of <emphasis>
    
    Also uses <guilabel> for LED names/labels, for lack of a better fit
    in DocBook.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit f57b91ee497414083cc1bf481d28eb9ad9f965fb
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 15:41:19 2014 -0700

    specs/XKB: Markup characters & strings as <literal> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit cfd4279c9b59d7e87c9f7c67692c87973adb7667
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Thu Jul 10 11:08:14 2014 -0700

    specs/XKB: Markup structs as <struct{name,field}> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit a014bb4cc013b0d1b76524b7868e860c7e7ebc79
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Wed Jul 9 23:30:54 2014 -0700

    specs/XKB: Markup symbol names in table entries too
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 907f7ad7a7a977bf4f19daa3143d47c4d07ca33d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 23:35:48 2014 -0700

    specs/XKB: Markup *Ptr as <type> instead of <emphasis>
    
    perl -i -p -e 's{<emphasis>(\w*Ptr)</emphasis>}{<type>\1</type>}g' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 9f6c00629fd4b713082cc11f9150f7aafd272c89
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 23:34:29 2014 -0700

    specs/XKB: Markup *Rec as <structname> instead of <emphasis>
    
    perl -i -p -e \
     's{<emphasis>(\w*Rec)</emphasis>}{<structname>\1</structname>}g' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 83839e37802b8b752c77859a95de60ad757feb79
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 23:29:49 2014 -0700

    specs/XKB: Markup XKB macros as <symbol> instead of <emphasis>
    
    Performed via:
     perl -n -e 'printf "s{<emphasis>\\s*%s\\s*</emphasis>}{<symbol>%s</symbol>};\n", $1, $1 if m{^#define\s+([^\s\(]*)}' \
      /usr/include/X11/extensions/XK*h /usr/include/X11/XKBlib.h \
      | sort -u > xkb-defines.pl
     perl -i -p -f xkb-defines.pl *.xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 9e397ed37ce4cc70621de347de3a795df88d4506
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 22:53:12 2014 -0700

    specs/XKB: Use Â° instead of o for degrees.
    
    Conversion from framemaker turned superscripted "o" into plain "o".
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 3b8364c21f5119105a2c14ae8cc75a11494cb7a7
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 22:46:03 2014 -0700

    specs/XKB: Markup keysyms as <keysym> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 33bef065683c8f910f3722730503c0c0699ee8be
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 22:26:56 2014 -0700

    specs/XKB: Markup NULL as <symbol> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit f10aa1e09468bd28454d85ac8ab55d9dc7178029
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Tue Jul 8 22:22:29 2014 -0700

    specs/XKB: Markup function args as <parameter> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 79ba58cceb69521fcb313c69233cf93a9fcb177f
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 23:56:13 2014 -0700

    specs/XKB: Convert remaining error names to errorname tags
    
    Most were caught by applying libX11 lists, but BadKeyboard & XKB*_Bad*
    are XKB-specific.   (Plus some were badly split across tag boundaries.)
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 42b2f5388c399949ece377f9cc9c479c06964972
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 23:16:56 2014 -0700

    specs/XKB: manually fixup some more emphasis tagging mismatches
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 3b2f47d44a55d93c65455ff183f3b47da04b1de1
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 23:02:31 2014 -0700

    specs/XKB: re-normalize <emphasis> layout in xml files
    
    Same script as before, just with <!-- xref --> comments out of the way
    now.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit ce95f152eda509263874c53fb7c6b4a6bdab2c29
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 22:59:25 2014 -0700

    specs/XKB: Remove remaining xref comments
    
    All the places marked by these have been turned into the appropriate
    link, xref, or olink tags now.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 6590b66e19af8dff68888ac403ac82f5d585b4e2
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 22:56:36 2014 -0700

    specs/XKB: make olinks to xkbproto for references in section 10.13
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit fcda446877a62e7443d7bc704ba3610e90d1e755
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 22:22:28 2014 -0700

    specs/XKB: Add <figure> tags and make Figure references link to them
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 087a2338476719e340dc3d5af0df6fdc4a26ce7a
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Mon Jul 7 21:30:01 2014 -0700

    specs/XKB: Turn Table references into links
    
    Adds id attributes to all table tags so we can link to them
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 135fa07b74cb50172c6a75768d499cd87ddb336e
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 21:29:59 2014 -0700

    specs/XKB: Turn section references into xref links
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 53e931d79926af8a3996253efd8b5f6c21d9e5d7
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 21:17:18 2014 -0700

    specs/XKB: Turn Chapter references into xref links
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit b7f00ce5bcb0c00696bb82503ab548e14f04d17d
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 20:40:18 2014 -0700

    specs/XKB: Apply <emphasis> to semantic tag transformations from Xlib spec
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit b00a7ddff2744238fbfe31c2298b02028a45a6ff
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 20:34:51 2014 -0700

    specs/XKB: Markup function names as <function> instead of <emphasis>
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit bfbb58b7679221cb5c9212665209ea9099ad079a
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 20:25:46 2014 -0700

    specs/XKB: normalize <emphasis> layout in xml files
    
    - Stop placing <emphasis> on empty space, commas, and periods.
    - Move periods & commas after closing </emphasis> tag
    - move <emphasis> open & close tags to same line, instead of mirroring
      nroff layout.
    
    Simplifies automating further transformations of these tags.
    
    Performed via:
     perl -i -0 -p \
        -e 's{<emphasis>(\s*)</emphasis>}{}msg;' \
        -e 's{<emphasis>([\s\.,]*)</emphasis>\s*}{\1}msg;' \
        -e 's{\n([\.,])\s*}{\1\n}msg;' \
        -e 's{([^\.])([\.,])\s*</emphasis>}{\1</emphasis>\2}msg;' \
        -e 's{\s*<emphasis>\n\s*}{\n<emphasis>}msg;' *xml
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit b16ee69a0103109a661a88140a1765dcd7bda634
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 15:57:41 2014 -0700

    specs/XKB: Convert to funcsynopsis+variablelist instead of informaltable
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit b41d43d4cf0c0a1a049a171ee8cf6fd8a3ee4335
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 19:29:38 2014 -0700

    specs/XKB: Add index
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 72ae1d793be078db521dda60af578ece71f364de
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 13:21:40 2014 -0700

    specs/XKB: Fix various markup issues in functiondecl tables
    
    - Merge some functionargdecl entries incorrectly split across rows
    - Add missing parameter name markup to some functionargdecls
    - Add missing function prototype markup to a functiondecl
    - Remove stray emphasis tags in a functiondecl
    
    Allows them to correctly convert to funcsynopsis markup in next step.
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>

commit 9fdb973012de80ac60dbc59c39162f4e839fc5a4
Author: Alan Coopersmith <alan.coopersmith at oracle.com>
Date:   Sun Jul 6 12:15:23 2014 -0700

    specs/XKB: Convert header filenames to filename tags
    
    Signed-off-by: Alan Coopersmith <alan.coopersmith at oracle.com>