fdo-mirrors/xorg-libx11
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/xorg/lib/libx11.git synced 2026-05-07 19:08:11 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
1242 commits 25 branches 130 tags 13 MiB
Commit graph

1242 commits

This branch
This branch
All branches
Author SHA1 Message Date
Alan Coopersmith
9c0be82017 specs/XKB: Trim leading spaces off text lines 
perl -i -p -e 's{/\*(\S)}{/* \1}g;' *.xml

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 23:55:38 -07:00
Alan Coopersmith
75b0b10990 specs/XKB: Add olinks to libX11 for "X Library Functions Affected by Xkb" 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 23:51:06 -07:00
Alan Coopersmith
5009621799 specs/XKB: Fix miscelleanous typos & spelling errors 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 23:51:06 -07:00
Alan Coopersmith
ac219bf152 specs/XKB: add some more indexterms by hand 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 23:51:06 -07:00
Alan Coopersmith
5c3aa4c69e specs/XKB: fixup various formatting issues in <programlisting>s 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 23:51:05 -07:00
Alan Coopersmith
70c648ff85 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@oracle.com>
 2014-07-19 20:19:44 -07:00
Alan Coopersmith
94b5677478 specs/XKB: add some more links by hand 
random bits where a link looked handy

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:19:44 -07:00
Alan Coopersmith
7a15a934cd specs/XKB: add links for terms in definition list under figure 1.1 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:19:43 -07:00
Alan Coopersmith
92b86fc3c5 specs/XKB: add links to more tables listing section references 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:19:43 -07:00
Alan Coopersmith
06a4483a05 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@oracle.com>
 2014-07-19 20:19:43 -07:00
Alan Coopersmith
61bd55c6d1 specs/XKB: remove unwanted white space around C -&gt; struct references 
perl -i -0 -p -e 's{\s*-&gt;\s*}{-&gt;}g' *xml

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:19:42 -07:00
Alan Coopersmith
2be0cc0b2a specs/XKB: replace -&gt; with &rarr; when used as arrow, not in C structs 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:57 -07:00
Alan Coopersmith
bf1f3d6f6f specs/XKB: replace =&gt; with &rArr; for double arrows 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:56 -07:00
Alan Coopersmith
c7ee427fc0 specs/XKB: Markup some ranges with &ndash; instead of - 2014-07-19 20:18:56 -07:00
Alan Coopersmith
ec4075303c specs/XKB: Markup some subtractions with &minus; instead of - 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:56 -07:00
Alan Coopersmith
441a267e46 specs/XKB: make sure all files have DOCTYPEs so standard entities work 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:56 -07:00
Alan Coopersmith
88fd70bee4 specs/XKB: Markup quoted terms as <quote> instead of with "" 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:56 -07:00
Alan Coopersmith
3576587ff1 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@oracle.com>
 2014-07-19 20:18:56 -07:00
Alan Coopersmith
6d5ec492cd 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@oracle.com>
 2014-07-19 20:18:54 -07:00
Alan Coopersmith
59d688f4c7 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@oracle.com>
 2014-07-19 20:18:14 -07:00
Alan Coopersmith
861f3087ee specs/XKB: Manual fixup of type markup 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:14 -07:00
Alan Coopersmith
6b96259dab specs/XKB: Manual fixup of parameter markup 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 20:18:14 -07:00
Alan Coopersmith
5526dce681 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@oracle.com>
 2014-07-19 20:18:14 -07:00
Alan Coopersmith
c36ee1a4db 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@oracle.com>
 2014-07-19 13:56:57 -07:00
Alan Coopersmith
eb1453a0c6 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@oracle.com>
 2014-07-19 13:56:57 -07:00
Alan Coopersmith
252d99c87b 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@oracle.com>
 2014-07-19 13:56:57 -07:00
Alan Coopersmith
ed60df10aa 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@oracle.com>
 2014-07-19 13:56:57 -07:00
Alan Coopersmith
f57b91ee49 specs/XKB: Markup characters & strings as <literal> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:57 -07:00
Alan Coopersmith
cfd4279c9b specs/XKB: Markup structs as <struct{name,field}> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:56 -07:00
Alan Coopersmith
a014bb4cc0 specs/XKB: Markup symbol names in table entries too 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:56 -07:00
Alan Coopersmith
907f7ad7a7 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@oracle.com>
 2014-07-19 13:56:56 -07:00
Alan Coopersmith
9f6c00629f 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@oracle.com>
 2014-07-19 13:56:56 -07:00
Alan Coopersmith
83839e3780 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@oracle.com>
 2014-07-19 13:56:56 -07:00
Alan Coopersmith
9e397ed37c 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>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
3b8364c21f specs/XKB: Markup keysyms as <keysym> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
33bef06568 specs/XKB: Markup NULL as <symbol> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
f10aa1e094 specs/XKB: Markup function args as <parameter> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
79ba58cceb 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>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
42b2f5388c specs/XKB: manually fixup some more emphasis tagging mismatches 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:55 -07:00
Alan Coopersmith
3b2f47d44a 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>
 2014-07-19 13:56:54 -07:00
Alan Coopersmith
ce95f152ed 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>
 2014-07-19 13:56:54 -07:00
Alan Coopersmith
6590b66e19 specs/XKB: make olinks to xkbproto for references in section 10.13 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:54 -07:00
Alan Coopersmith
fcda446877 specs/XKB: Add <figure> tags and make Figure references link to them 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:53 -07:00
Alan Coopersmith
087a233847 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>
 2014-07-19 13:56:53 -07:00
Alan Coopersmith
135fa07b74 specs/XKB: Turn section references into xref links 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:53 -07:00
Alan Coopersmith
53e931d799 specs/XKB: Turn Chapter references into xref links 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:53 -07:00
Alan Coopersmith
b7f00ce5bc specs/XKB: Apply <emphasis> to semantic tag transformations from Xlib spec 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:53 -07:00
Alan Coopersmith
b00a7ddff2 specs/XKB: Markup function names as <function> instead of <emphasis> 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:52 -07:00
Alan Coopersmith
bfbb58b767 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>
 2014-07-19 13:56:51 -07:00
Alan Coopersmith
b16ee69a01 specs/XKB: Convert to funcsynopsis+variablelist instead of informaltable 
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
 2014-07-19 13:56:16 -07:00