specs/XKB: Convert header filenames to filename tags

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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@oracle.com>
specs/XKB: Add index

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

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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@oracle.com>
specs/XKB: Markup function names as <function> instead of <emphasis>

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

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

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

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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@oracle.com>
specs/XKB: Add <figure> tags and make Figure references link to them

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

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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@oracle.com>
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@oracle.com>
specs/XKB: manually fixup some more emphasis tagging mismatches

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
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@oracle.com>
specs/XKB: Markup function args as <parameter> instead of <emphasis>

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

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

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
specs/XKB: Use ° instead of o for degrees.

Conversion from framemaker turned superscripted "o" into plain "o".

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>