x11proto-core: Changes to 'upstream-unstable'
COPYING | 53 +++
XF86keysym.h | 3
Xfuncproto.h.in | 62 +++-
configure.ac | 13
docbook.am | 97 ++++++
keysym.h | 1
keysymdef.h | 114 +++++++-
specs/.gitignore | 1
specs/Makefile.am | 76 -----
specs/encoding.xml | 8
specs/glossary.xml | 209 +++++++-------
specs/keysyms.xml | 11
specs/sect1-9.xml | 707 ++++++++++++++++++++++++++------------------------
specs/x11protocol.xml | 2
14 files changed, 825 insertions(+), 532 deletions(-)
New commits:
commit 42c16165df536f74d1177eae2b94f96b3ebbdfb2
Author: Peter Hutterer <peter.hutterer@who-t.net>
Date: Thu Jun 23 09:28:57 2011 +1000
xproto 7.0.22
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
diff --git a/configure.ac b/configure.ac
index 1b9d19c..dad03e3 100644
--- a/configure.ac
+++ b/configure.ac
@@ -1,5 +1,5 @@
AC_PREREQ([2.60])
-AC_INIT([Xproto], [7.0.21],
+AC_INIT([Xproto], [7.0.22],
[https://bugs.freedesktop.org/enter_bug.cgi?product=xorg])
AM_INIT_AUTOMAKE([foreign dist-bzip2])
AM_MAINTAINER_MODE
commit 13799852a8b8116094a885809782604fa7507115
Author: Peter Hutterer <peter.hutterer@who-t.net>
Date: Thu Jun 16 11:01:39 2011 +1000
Add two more symbols for logging grab and window trees
These two keysyms provide exciting new possibilities of a close relationship
between our valued users and hard-working developers through innovative
logging solutions. Such keysyms truly pave new ground in the reponsiveness
to bug reports and and debug-ability of grabs.
For unprecedented uses of these keysyms, see the patches here:
http://patchwork.freedesktop.org/patch/5936/
http://patchwork.freedesktop.org/patch/5935/
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Daniel Stone <daniel@fooishbar.org>
diff --git a/XF86keysym.h b/XF86keysym.h
index fd3af4f..df5e9cc 100644
--- a/XF86keysym.h
+++ b/XF86keysym.h
@@ -229,4 +229,5 @@
#define XF86XK_ClearGrab 0x1008FE21 /* kill application with grab */
#define XF86XK_Next_VMode 0x1008FE22 /* next video mode available */
#define XF86XK_Prev_VMode 0x1008FE23 /* prev. video mode available */
-
+#define XF86XK_LogWindowTree 0x1008FE24 /* print window tree to log */
+#define XF86XK_LogGrabInfo 0x1008FE25 /* print all active grabs to log */
commit 7c3c4332d63d9003f7115173b7ece6ab1297cc15
Author: Gaetan Nadon <memsize@videotron.ca>
Date: Sun Jun 12 17:54:50 2011 -0400
Install xml versions of specs even if HAVE_XMLTO is false
DocBook/XML input source is also a usefull output format that can be viewed
with an XML viewer or editor and by some O/S help system.
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
diff --git a/docbook.am b/docbook.am
index 5864c9e..2ffb7e6 100644
--- a/docbook.am
+++ b/docbook.am
@@ -20,6 +20,7 @@ shelf_DATA =
# DocBook/XML file with chapters, appendix and images it includes
dist_shelf_DATA = $(docbook) $(chapters)
+if HAVE_XMLTO
#
# Generate DocBook/XML output formats with or without stylesheets
#
@@ -91,5 +92,6 @@ XSLTPROC_FLAGS = \
endif HAVE_XSLTPROC
endif HAVE_STYLESHEETS
+endif HAVE_XMLTO
CLEANFILES = $(shelf_DATA)
diff --git a/specs/Makefile.am b/specs/Makefile.am
index 44068aa..c7c4fe5 100644
--- a/specs/Makefile.am
+++ b/specs/Makefile.am
@@ -1,7 +1,6 @@
SUBDIRS = SIAddresses
if ENABLE_SPECS
-if HAVE_XMLTO
# Main DocBook/XML files (DOCTYPE book)
docbook = x11protocol.xml
@@ -19,5 +18,4 @@ shelfdir = $(docdir)
# Generate DocBook/XML output formats with or without stylesheets
include $(top_srcdir)/docbook.am
-endif HAVE_XMLTO
endif ENABLE_SPECS
commit c10589c12f45bfb8c0134d0370cf5f36ac7262bf
Author: Gaetan Nadon <memsize@videotron.ca>
Date: Sun Jun 5 16:27:37 2011 -0400
Install target dbs alongside generated documents
This matches a change in xorg-sgml-docs whereby the masterdb will look for
the target dbs into the same location as the generated documents.
The target dbs are now installed alongside the generated documents.
Previously they are installed in $prefix/sgml/X11/dbs alongside masterdb which
has the potential of installing outside the package prefix and cause
distcheck to fail when user does not have write permission in this package.
Requires XORG_CHECK_SGML_DOCTOOLS(1.8) which was released 2011-06-11
diff --git a/configure.ac b/configure.ac
index 559e200..1b9d19c 100644
--- a/configure.ac
+++ b/configure.ac
@@ -13,7 +13,7 @@ XORG_ENABLE_SPECS
XORG_WITH_XMLTO(0.0.22)
XORG_WITH_FOP
XORG_WITH_XSLTPROC
-XORG_CHECK_SGML_DOCTOOLS(1.7)
+XORG_CHECK_SGML_DOCTOOLS(1.8)
AC_CONFIG_HEADER([do-not-use-config.h])
AC_CONFIG_HEADER([Xfuncproto.h])
diff --git a/docbook.am b/docbook.am
index 3cf21e8..5864c9e 100644
--- a/docbook.am
+++ b/docbook.am
@@ -71,7 +71,7 @@ if HAVE_STYLESHEETS
if HAVE_XSLTPROC
# DocBook/XML generated document cross-reference database
-sgmldbs_DATA = $(docbook:.xml=.html.db) $(docbook:.xml=.fo.db)
+shelf_DATA += $(docbook:.xml=.html.db) $(docbook:.xml=.fo.db)
# Generate DocBook/XML document cross-reference database
# Flags for the XSL Transformation processor generating xref target databases
@@ -92,4 +92,4 @@ XSLTPROC_FLAGS = \
endif HAVE_XSLTPROC
endif HAVE_STYLESHEETS
-CLEANFILES = $(shelf_DATA) $(sgmldbs_DATA)
+CLEANFILES = $(shelf_DATA)
commit 951295cceb72e929c55f639bbb91314fa276b2aa
Author: Cyril Brulebois <kibi@debian.org>
Date: Sun Jun 5 09:26:33 2011 +0000
Fix sorting by codepoint in Latin 2.
Sort performed by calling “sort -k 3” on the part between #ifdef
XK_LATIN8 and #endif.
Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Signed-off-by: Cyril Brulebois <kibi@debian.org>
diff --git a/keysymdef.h b/keysymdef.h
index 1a07d83..73b5533 100644
--- a/keysymdef.h
+++ b/keysymdef.h
@@ -782,9 +782,9 @@ SOFTWARE.
#define XK_nacute 0x01f1 /* U+0144 LATIN SMALL LETTER N WITH ACUTE */
#define XK_ncaron 0x01f2 /* U+0148 LATIN SMALL LETTER N WITH CARON */
#define XK_odoubleacute 0x01f5 /* U+0151 LATIN SMALL LETTER O WITH DOUBLE ACUTE */
-#define XK_udoubleacute 0x01fb /* U+0171 LATIN SMALL LETTER U WITH DOUBLE ACUTE */
#define XK_rcaron 0x01f8 /* U+0159 LATIN SMALL LETTER R WITH CARON */
#define XK_uring 0x01f9 /* U+016F LATIN SMALL LETTER U WITH RING ABOVE */
+#define XK_udoubleacute 0x01fb /* U+0171 LATIN SMALL LETTER U WITH DOUBLE ACUTE */
#define XK_tcedilla 0x01fe /* U+0163 LATIN SMALL LETTER T WITH CEDILLA */
#define XK_abovedot 0x01ff /* U+02D9 DOT ABOVE */
#endif /* XK_LATIN2 */
commit d8920f71b68fe3fabd4ba04e2a4308579a8fe333
Author: Cyril Brulebois <kibi@debian.org>
Date: Fri Jun 3 14:27:45 2011 +0200
build: Add SIAddresses as a subdir of specs.
Fix the following distcheck failure:
| configure: creating ./config.status
| config.status: creating Makefile
| config.status: creating specs/Makefile
| config.status: error: cannot find input file: `specs/SIAddresses/Makefile.in'
| make: *** [distcheck] Error 1
Signed-off-by: Cyril Brulebois <kibi@debian.org>
Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
diff --git a/specs/Makefile.am b/specs/Makefile.am
index 26fe571..44068aa 100644
--- a/specs/Makefile.am
+++ b/specs/Makefile.am
@@ -1,3 +1,4 @@
+SUBDIRS = SIAddresses
if ENABLE_SPECS
if HAVE_XMLTO
commit 2ef6cb7ced5812975b3630cf201e75db439936e6
Author: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Sat May 28 17:31:36 2011 -0700
spec: Add more indexterm & glossterm links
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
diff --git a/specs/encoding.xml b/specs/encoding.xml
index b67b48e..e3b2399 100644
--- a/specs/encoding.xml
+++ b/specs/encoding.xml
@@ -265,7 +265,10 @@ If the number of unused bytes is variable, the encode-form typically is:
<para>
where E is some expression,
+<phrase id="encoding:pad">
+<indexterm zone="encoding:pad" significance="preferred"><primary>Padding</primary></indexterm>
and pad(E) is the number of bytes needed to round E up to a multiple of four.
+</phrase>
</para>
<literallayout class="monospaced">
@@ -275,6 +278,7 @@ and pad(E) is the number of bytes needed to round E up to a multiple of four.
<sect1 id="common_types_encoding">
<title>Common Types</title>
+<indexterm zone="common_types_encoding"><primary>Types</primary><secondary>encoding</secondary></indexterm>
<variablelist>
<varlistentry>
@@ -538,6 +542,7 @@ STR
<sect1 id="errors_encoding">
<title>Errors</title>
+<indexterm zone="errors_encoding"><primary>Error report</primary><secondary>encoding</secondary></indexterm>
<literallayout class="monospaced">
<emphasis role='bold'>Request</emphasis>
@@ -722,6 +727,7 @@ BUTTON values are numbered starting with one.
</sect1>
<sect1 id="predefined">
<title>Predefined Atoms</title>
+<indexterm zone="predefined"><primary>Atom</primary><secondary>predefined</secondary></indexterm>
<literallayout class="monospaced">
PRIMARY 1 WM_NORMAL_HINTS 40
@@ -934,6 +940,7 @@ VISUALTYPE
<sect1 id="requests_encoding">
<title>Requests</title>
+<indexterm zone="requests_encoding"><primary>Request</primary><secondary>encoding</secondary></indexterm>
<literallayout class="monospaced">
<link linkend="requests:CreateWindow"><emphasis role='bold'>CreateWindow</emphasis></link>
@@ -2791,6 +2798,7 @@ VISUALTYPE
<sect1 id="events_encoding">
<title>Events</title>
+<indexterm zone="events_encoding"><primary>Event</primary><secondary>encoding</secondary></indexterm>
<literallayout class="monospaced">
<link linkend="events:KeyPress"><emphasis role='bold'>KeyPress</emphasis></link>
diff --git a/specs/glossary.xml b/specs/glossary.xml
index 63dd92d..61233e3 100644
--- a/specs/glossary.xml
+++ b/specs/glossary.xml
@@ -158,6 +158,7 @@ and the server swaps bytes as necessary.
<glossentry id="glossary:Children">
<glossterm>Children</glossterm>
<indexterm zone="glossary:Children" significance="preferred"><primary>Children</primary></indexterm>
+ <indexterm zone="glossary:Children" significance="preferred"><primary>Window</primary><secondary>children</secondary></indexterm>
<glossdef>
<para>
The children of a window are its first-level subwindows.
@@ -199,8 +200,8 @@ The image defined by the bitmap or rectangles is called a clipping region.
</glossentry>
<glossentry id="glossary:Colormap">
<glossterm>Colormap</glossterm>
+ <indexterm zone="glossary:Colormap" significance="preferred"><primary>Colormap</primary></indexterm>
<glossdef>
-<!-- .IN "Colormap" "" "@DEF@" -->
<para>
A colormap consists of a set of entries defining color values.
The colormap associated with a window is used to display the contents of
@@ -434,8 +435,8 @@ all possible and are expected.
</glossentry>
<glossentry id="glossary:Focus_window">
<glossterm>Focus window</glossterm>
+ <indexterm zone="glossary:Focus_window" significance="preferred"><primary>Focus window</primary></indexterm>
<glossdef>
-<!-- .IN "Focus window" "" ""@DEF@" -->
<para>
The focus window is another term for the <glossterm linkend="glossary:Input_focus">input focus</glossterm>.
<!-- .KE -->
@@ -458,8 +459,8 @@ and interline spacing.
</glossentry>
<glossentry id="glossary:GC">
<glossterm>GC, GContext</glossterm>
- <indexterm zone="glossary:GC" significance="preferred"><primary>GC</primary></indexterm>
- <indexterm zone="glossary:GC" significance="preferred"><primary>GContext</primary></indexterm>
+ <indexterm zone="glossary:GC" significance="preferred"><primary>GC</primary><seealso>Graphics context</seealso></indexterm>
+ <indexterm zone="glossary:GC" significance="preferred"><primary>GContext</primary><seealso>Graphics context</seealso></indexterm>
<glossdef>
<para>
GC and gcontext are abbreviations for <glossterm linkend="glossary:Graphics_context">graphics context</glossterm>.
@@ -479,7 +480,7 @@ A glyph is an image, typically of a character, in a font.
</glossentry>
<glossentry id="glossary:Grab">
<glossterm>Grab</glossterm>
- <indexterm zone="glossary:Grab" significance="preferred"><primary>Grab</primary></indexterm>
+ <indexterm zone="glossary:Grab" significance="preferred"><primary>Grab</primary><seealso>Active grab</seealso><seealso>Passive grab</seealso></indexterm>
<glossdef>
<para>
Keyboard keys, the keyboard, pointer buttons, the pointer, and the
@@ -682,6 +683,7 @@ Unmapped windows and their inferiors are never viewable or visible.
<glossentry id="glossary:Modifier_keys">
<glossterm>Modifier keys</glossterm>
<indexterm zone="glossary:Modifier_keys" significance="preferred"><primary>Modifier keys</primary></indexterm>
+ <indexterm zone="glossary:Modifier_keys"><primary>Key</primary><secondary>modifier</secondary><see>Modifier keys</see></indexterm>
<glossdef>
<para>
Shift, Control, Meta, Super, Hyper, Alt, Compose, Apple, CapsLock,
@@ -1191,6 +1193,7 @@ The pixmap itself is also known as a tile.
<glossentry id="glossary:Timestamp">
<glossterm>Timestamp</glossterm>
<indexterm zone="glossary:Timestamp" significance="preferred"><primary>Timestamp</primary></indexterm>
+ <indexterm zone="glossary:Timestamp" significance="preferred"><primary>CurrentTime</primary></indexterm>
<glossdef>
<para>
A timestamp is a time value, expressed in milliseconds.
diff --git a/specs/keysyms.xml b/specs/keysyms.xml
index 58e3f2a..0ef4ac0 100644
--- a/specs/keysyms.xml
+++ b/specs/keysyms.xml
@@ -1,5 +1,7 @@
<appendix id="keysym_encoding">
<title>KEYSYM Encoding</title>
+<indexterm zone="keysym_encoding"><primary>Types</primary><secondary>KEYSYM</secondary></indexterm>
+<indexterm zone="keysym_encoding"><primary>Keysym</primary></indexterm>
<para>
KEYSYM values are 32-bit integers that encode the symbols on the
@@ -99,6 +101,7 @@ U+007E and U+00A0 to U+00FF, respectively.
<sect1 id="unicode_keysyms">
<title>Unicode KEYSYMs</title>
+<indexterm zone="unicode_keysyms"><primary>Keysym</primary><secondary>Unicode</secondary></indexterm>
<para>
These occupy the range #x01000100 to #x0110FFFF and represent the ISO
diff --git a/specs/sect1-9.xml b/specs/sect1-9.xml
index 1748935..78c53e5 100644
--- a/specs/sect1-9.xml
+++ b/specs/sect1-9.xml
@@ -820,12 +820,14 @@ or
<chapter id="keyboards">
<title>Keyboards</title>
+<indexterm zone="keyboards"><primary>Keyboard</primary></indexterm>
<!-- .XS -->
<!-- (SN Keyboards -->
<!-- .XE -->
<para id="keycode">
A KEYCODE represents a physical (or logical) key.
<indexterm zone="keycode"><primary>Types</primary><secondary>KEYCODE</secondary></indexterm>
+<indexterm zone="keycode" significance="preferred"><primary>Keycode</primary></indexterm>
Keycodes lie in the inclusive range [8,255].
A keycode value carries no intrinsic information,
although server implementors may attempt to encode geometry information
@@ -836,6 +838,7 @@ protocol.
<para id="keysym">
A KEYSYM is an encoding of a symbol on the cap of a key.
<indexterm zone="keysym"><primary>Types</primary><secondary>KEYSYM</secondary></indexterm>
+<indexterm zone="keysym"><primary>Keysym</primary></indexterm>
The set of defined KEYSYMs include the character sets Latin-1, Latin-2,
Latin-3, Latin-4, Kana, Arabic, Cyrillic, Greek, Tech, Special, Publish, APL,
Hebrew, Thai, and Korean as well as a set of symbols common on keyboards
@@ -1139,6 +1142,7 @@ other names.
<chapter id="connection_setup">
<title>Connection Setup</title>
+ <indexterm zone="connection_setup"><primary>Connection</primary></indexterm>
<para>
For remote clients,
@@ -1147,6 +1151,7 @@ the X protocol can be built on top of any reliable byte stream.
<section id="connection_initiation">
<title>Connection Initiation</title>
+ <indexterm zone="connection_initiation"><primary>Connection</primary><secondary>opening</secondary></indexterm>
<para id="byte-order">
The client must send an initial byte of data to identify the byte order to be
@@ -1493,9 +1498,10 @@ The byte order for images is given by image-byte-order and applies to each
scanline unit in XY format (bitmap format) and to each pixel value in Z format.
</para>
<para id="bitmap-format">
-A bitmap is represented in scanline order.
+A bitmap is represented in <glossterm linkend="glossary:Scanline_order">scanline order</glossterm>.
<indexterm zone="bitmap-format"><primary>Bitmap</primary><secondary>format</secondary></indexterm>
-Each scanline is padded to a multiple of bits as given by bitmap-scanline-pad.
+Each <glossterm linkend="glossary:Scanline">scanline</glossterm>
+is padded to a multiple of bits as given by bitmap-scanline-pad.
The pad bits are of arbitrary value.
The scanline is quantized in multiples of bits as given by bitmap-scanline-unit.
The bitmap-scanline-unit is always less than or equal to the
@@ -1503,15 +1509,19 @@ bitmap-scanline-pad.
Within each unit,
the leftmost bit in the bitmap is either the least significant
or most significant bit in the unit, as given by bitmap-bit-order.
+<indexterm zone="bitmap-format"><primary>XYFormat</primary></indexterm>
If a pixmap is represented in XY format,
each plane is represented as a bitmap, and the planes appear from
most significant to least significant in bit order with no padding
between planes.
</para>
<para id="pixmap-formats">
-Pixmap-formats contains one entry for each depth value.
+Pixmap-formats contains one entry for each
+<glossterm linkend="glossary:Depth">depth</glossterm> value.
<indexterm zone="pixmap-formats"><primary>Pixmap</primary><secondary>format</secondary></indexterm>
-The entry describes the Z format used to represent images of that depth.
+<indexterm zone="pixmap-formats"><primary>ZFormat</primary></indexterm>
+The entry describes the <glossterm linkend="glossary:ZFormat">Z format</glossterm>
+used to represent images of that depth.
An entry for a depth is included if any screen supports that depth,
and all screens supporting that depth must support only that Z format for that
depth.
@@ -1560,7 +1570,9 @@ Maximum-request-length will always be at least 4096
(that is, requests of length up to and including 16384 bytes
will be accepted by all servers).
</para>
- <para>
+ <para id="keycode_range">
+<indexterm zone="keycode_range"><primary>Types</primary><secondary>KEYCODE</secondary></indexterm>
+<indexterm zone="keycode_range"><primary>Keycode</primary></indexterm>
Min-keycode and max-keycode specify the smallest and largest keycode
values transmitted by the server.
Min-keycode is never less than 8,
@@ -1631,7 +1643,8 @@ resource ID should be considered as a single map for the purposes of this
number.
For the typical case of a single hardware colormap, both values will be 1.
</para>
- <para>
+ <para id="Backing-stores">
+<indexterm zone="Backing-stores"><primary>Backing store</primary></indexterm>
Backing-stores indicates when the server supports backing stores for
this screen, although it may be storage limited in the number of
windows it can support at once.
@@ -1652,6 +1665,7 @@ would return for the all-event-masks for the root window.
<section id="visual_information">
<title>Visual Information</title>
+ <indexterm zone="visual_information" significance="preferred"><primary>Visual</primary><secondary>information</secondary></indexterm>
<para>
The information that applies per visual-type is:
@@ -1662,7 +1676,9 @@ A given visual type might be listed for more than one depth or for
more than one screen.
</para>
- <para>
+ <para id="colormap_types">
+<indexterm zone="colormap_types" significance="preferred"><primary>Colormap</primary><secondary>types</secondary></indexterm>
+<indexterm zone="colormap_types"><primary>Pixel value</primary></indexterm>
For
<emphasis role='bold'>PseudoColor</emphasis>,
a pixel value indexes a colormap to produce independent RGB values;
@@ -2123,7 +2139,8 @@ error to specify any other attributes for
<emphasis role='bold'>InputOnly</emphasis>
windows.
</para>
-<para>
+<para id="requests:CreateWindow:background">
+<indexterm zone="requests:CreateWindow:background"><primary>Background</primary></indexterm>
If background-pixmap is given,
it overrides the default background-pixmap.
The background pixmap and the window must have the
@@ -2259,7 +2276,9 @@ value.
Any bits beyond the specified depth of the window in these
values are simply ignored.
</para>
-<para>
+<para id="requests:CreateWindow:event-mask">
+<indexterm zone="requests:CreateWindow:event-mask"><primary>Event</primary><secondary>mask</secondary></indexterm>
+<indexterm zone="requests:CreateWindow:event-mask"><primary>Event</primary><secondary>propagation</secondary></indexterm>
The event-mask defines which events the client is interested in for
this window (or for some event types, inferiors of the window).
The do-not-propagate-mask defines which events should not be propagated to
@@ -2794,6 +2813,7 @@ background, and the new parent is not the same depth as the window.
<section id="requests:MapWindow">
<title>MapWindow</title>
<indexterm zone="requests:MapWindow" significance="preferred"><primary>MapWindow</primary></indexterm>
+ <indexterm zone="requests:MapWindow"><primary>Mapped window</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -3091,7 +3111,10 @@ on the parent has precedence over
<emphasis role='bold'>ResizeRedirect</emphasis>
on the window.
</para>
-<para>
+<para id="requests:ConfigureWindow:gravity">
+<indexterm zone="requests:ConfigureWindow:gravity"><primary>Gravity</primary></indexterm>
+<indexterm zone="requests:ConfigureWindow:gravity"><primary>Bit</primary><secondary>gravity</secondary></indexterm>
+<indexterm zone="requests:ConfigureWindow:gravity"><primary>Window</primary><secondary>gravity</secondary></indexterm>
The geometry of the window is changed as specified,
the window is restacked among siblings, and a
<link linkend="events:ConfigureNotify"><emphasis role='bold'>ConfigureNotify</emphasis></link>
@@ -3517,6 +3540,7 @@ window as a drawable to this request.
<section id="requests:QueryTree">
<title>QueryTree</title>
<indexterm zone="requests:QueryTree" significance="preferred"><primary>QueryTree</primary></indexterm>
+ <indexterm zone="requests:QueryTree"><primary>Children</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -3573,6 +3597,7 @@ The children are listed in bottom-to-top stacking order.
<section id="requests:InternAtom">
<title>InternAtom</title>
<indexterm zone="requests:InternAtom" significance="preferred"><primary>InternAtom</primary></indexterm>
+ <indexterm zone="requests:InternAtom"><primary>Atom</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -3677,6 +3702,7 @@ This request returns the name for the given atom.
<section id="requests:ChangeProperty">
<title>ChangeProperty</title>
<indexterm zone="requests:ChangeProperty" significance="preferred"><primary>ChangeProperty</primary></indexterm>
+ <indexterm zone="requests:ChangeProperty"><primary>Property</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -4051,6 +4077,7 @@ This request returns the atoms of properties currently defined on the window.
<section id="requests:SetSelectionOwner">
<title>SetSelectionOwner</title>
<indexterm zone="requests:SetSelectionOwner" significance="preferred"><primary>SetSelectionOwner</primary></indexterm>
+ <indexterm zone="requests:SetSelectionOwner"><primary>Selection</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -4247,6 +4274,7 @@ The arguments are passed on unchanged in either of the events.
<section id="requests:SendEvent">
<title>SendEvent</title>
<indexterm zone="requests:SendEvent" significance="preferred"><primary>SendEvent</primary></indexterm>
+ <indexterm zone="requests:SendEvent" significance="preferred"><primary>Event</primary><secondary>sending</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -4347,6 +4375,8 @@ Active grabs are ignored for this request.
<section id="requests:GrabPointer">
<title>GrabPointer</title>
<indexterm zone="requests:GrabPointer" significance="preferred"><primary>GrabPointer</primary></indexterm>
+ <indexterm zone="requests:GrabPointer"><primary>Active grab</primary><secondary>pointer</secondary></indexterm>
+ <indexterm zone="requests:GrabPointer"><primary>Pointer</primary><secondary>grabbing</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -4763,6 +4793,7 @@ The request has no effect on an active grab.
<section id="requests:ChangeActivePointerGrab">
<title>ChangeActivePointerGrab</title>
<indexterm zone="requests:ChangeActivePointerGrab" significance="preferred"><primary>ChangeActivePointerGrab</primary></indexterm>
+ <indexterm zone="requests:ChangeActivePointerGrab"><primary>Active grab</primary><secondary>pointer</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -4815,6 +4846,8 @@ with
<section id="requests:GrabKeyboard">
<title>GrabKeyboard</title>
<indexterm zone="requests:GrabKeyboard" significance="preferred"><primary>GrabKeyboard</primary></indexterm>
+ <indexterm zone="requests:GrabKeyboard"><primary>Active grab</primary><secondary>keyboard</secondary></indexterm>
+ <indexterm zone="requests:GrabKeyboard"><primary>Keyboard</primary><secondary>grabbing</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -5001,6 +5034,7 @@ becomes not viewable.
<section id="requests:GrabKey">
<title>GrabKey</title>
<indexterm zone="requests:GrabKey" significance="preferred"><primary>GrabKey</primary></indexterm>
+ <indexterm zone="requests:GrabKey"><primary>Key</primary><secondary>grabbing</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -5562,6 +5596,7 @@ If the stop time is in the future, it is equivalent to specifying
<section id="requests:TranslateCoordinates">
<title>TranslateCoordinates</title>
<indexterm zone="requests:TranslateCoordinates" significance="preferred"><primary>TranslateCoordinates</primary></indexterm>
+ <indexterm zone="glossary:Coordinate_system"><primary>Coordinate system</primary><secondary>translating</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -5711,6 +5746,7 @@ moved the pointer.
<section id="requests:SetInputFocus">
<title>SetInputFocus</title>
<indexterm zone="requests:SetInputFocus" significance="preferred"><primary>SetInputFocus</primary></indexterm>
+ <indexterm zone="requests:SetInputFocus"><primary>Input focus</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -5896,6 +5932,7 @@ may lag the physical state if device event processing is frozen.
<section id="requests:OpenFont">
<title>OpenFont</title>
<indexterm zone="requests:OpenFont" significance="preferred"><primary>OpenFont</primary></indexterm>
+ <indexterm zone="requests:OpenFont"><primary>Font</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -6705,6 +6742,7 @@ The pixmap storage will be freed when no other resource references it.
<section id="requests:CreateGC">
<title>CreateGC</title>
<indexterm zone="requests:CreateGC" significance="preferred"><primary>CreateGC</primary></indexterm>
+ <indexterm zone="requests:CreateGC"><primary>Graphics context</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -6919,7 +6957,8 @@ PIXMAP or
</tgroup>
</informaltable>
-<para>
+<para id="requests:CreateGC:plane-mask">
+<indexterm zone="requests:CreateGC:plane-mask"><primary>Plane</primary><secondary>mask</secondary></indexterm>
In graphics operations,
given a source and destination pixel,
the result is computed bitwise on corresponding bits of the pixels;
@@ -6938,7 +6977,7 @@ or plane-mask.
They are simply truncated to the appropriate number of bits.
</para>
-<para>
+<para id="requests:CreateGC:function">
The meanings of the functions are:
</para>
@@ -7053,7 +7092,8 @@ The meanings of the functions are:
</tgroup>
</informaltable>
-<para>
+<para id="requests:CreateGC:line-width">
+<indexterm zone="requests:CreateGC:line-width"><primary>Line</primary><secondary>drawing</secondary></indexterm>
The line-width is measured in pixels and can be greater than or equal to
one, a wide line, or the special value zero, a thin line.
</para>
@@ -7119,7 +7159,7 @@ If it is desirable to obtain precise and uniform results across all displays,
a client should always use a line-width of one, rather than a line-width of
zero.
</para>
-<para>
+<para id="requests:CreateGC:line-style">
The line-style defines which sections of a line are drawn:
</para>
@@ -7165,7 +7205,7 @@ is treated as
</tgroup>
</informaltable>
-<para>
+<para id="requests:CreateGC:cap-style">
The cap-style defines how the endpoints of a path are drawn:
</para>
@@ -7222,7 +7262,7 @@ for line-width zero.
-<para>
+<para id="requests:CreateGC:join-style">
The join-style defines how corners are drawn for wide lines:
</para>
@@ -7500,7 +7540,8 @@ The meaning of dash-offset and dashes are explained in the
<link linkend="requests:SetDashes"><emphasis role='bold'>SetDashes</emphasis></link>
request.
</para>
-<para>
+<para id="requests:CreateGC:clip-mask">
+<indexterm zone="requests:CreateGC:clip-mask"><primary>Clipping region</primary></indexterm>
The clip-mask restricts writes to the destination drawable.
Only pixels where the clip-mask has bits set to 1 are drawn.
Pixels are not drawn outside the area covered by the clip-mask
@@ -7537,7 +7578,9 @@ with a source or destination window of one depth with mapped inferiors
of differing depth is not illegal,
but the semantics is undefined by the core protocol.
</para>
-<para>
+<para id="requests:CreateGC:fill-rule">
+<indexterm zone="requests:CreateGC:fill-rule" significance="preferred"><primary>Winding rule</primary></indexterm>
+<indexterm zone="requests:CreateGC:fill-rule" significance="preferred"><primary>Fill rule</primary></indexterm>
The fill-rule defines what pixels are inside (that is, are drawn) for
paths given in
<link linkend="requests:FillPoly"><emphasis role='bold'>FillPoly</emphasis></link>
@@ -8074,7 +8117,7 @@ and destroys the gcontext.
<section id="requests:ClearArea">
<title>ClearArea</title>
<indexterm zone="requests:ClearArea" significance="preferred"><primary>ClearArea</primary></indexterm>
-<informaltable frame='none'>
+ <indexterm zone="requests:ClearArea"><primary>Background</primary></indexterm><informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
<tbody>
@@ -8389,6 +8432,7 @@ clip-x-origin, clip-y-origin, clip-mask
<section id="requests:PolyLine">
<title>PolyLine</title>
<indexterm zone="requests:PolyLine" significance="preferred"><primary>PolyLine</primary></indexterm>
+ <indexterm zone="requests:PolyLine"><primary>Line</primary><secondary>drawing</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -9668,6 +9712,7 @@ CHAR2B is taken as the most significant byte).
<section id="requests:CreateColormap">
<title>CreateColormap</title>
<indexterm zone="requests:CreateColormap" significance="preferred"><primary>CreateColormap</primary></indexterm>
+ <indexterm zone="requests:CreateColormap"><primary>Colormap</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -10717,6 +10762,7 @@ and uppercase and lowercase do not matter.
<section id="requests:CreateCursor">
<title>CreateCursor</title>
<indexterm zone="requests:CreateCursor" significance="preferred"><primary>CreateCursor</primary></indexterm>
+ <indexterm zone="requests:CreateCursor"><primary>Cursor</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11068,6 +11114,7 @@ error results).
<section id="requests:QueryExtension">
<title>QueryExtension</title>
<indexterm zone="requests:QueryExtension" significance="preferred"><primary>QueryExtension</primary></indexterm>
+ <indexterm zone="requests:QueryExtension"><primary>Extension</primary><secondary>querying</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11135,6 +11182,7 @@ and uppercase and lowercase matter.
<section id="requests:ListExtensions">
<title>ListExtensions</title>
<indexterm zone="requests:ListExtensions" significance="preferred"><primary>ListExtensions</primary></indexterm>
+ <indexterm zone="requests:ListExtensions"><primary>Extension</primary><secondary>listing</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11163,6 +11211,7 @@ This request returns a list of all extensions supported by the server.
<section id="requests:SetModifierMapping">
<title>SetModifierMapping</title>
<indexterm zone="requests:SetModifierMapping" significance="preferred"><primary>SetModifierMapping</primary></indexterm>
+ <indexterm zone="requests:SetModifierMapping"><primary>Modifier keys</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11270,6 +11319,7 @@ status.
<section id="requests:GetModifierMapping">
<title>GetModifierMapping</title>
<indexterm zone="requests:GetModifierMapping" significance="preferred"><primary>GetModifierMapping</primary></indexterm>
+ <indexterm zone="requests:GetModifierMapping"><primary>Modifier keys</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11323,6 +11373,7 @@ The order of keycodes within each set is chosen arbitrarily by the server.
<section id="requests:ChangeKeyboardMapping">
<title>ChangeKeyboardMapping</title>
<indexterm zone="requests:ChangeKeyboardMapping" significance="preferred"><primary>ChangeKeyboardMapping</primary></indexterm>
+ <indexterm zone="requests:ChangeKeyboardMapping"><primary>Keysym</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -11411,6 +11462,7 @@ it is merely stored for reading and writing by clients
<section id="requests:GetKeyboardMapping">
<title>GetKeyboardMapping</title>
<indexterm zone="requests:GetKeyboardMapping" significance="preferred"><primary>GetKeyboardMapping</primary></indexterm>
+ <indexterm zone="requests:GetKeyboardMapping"><primary>Keysym</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -12452,6 +12504,7 @@ to begin on 64-bit boundaries.
<chapter id="connection_close">
<title>Connection Close</title>
+ <indexterm zone="connection_close"><primary>Connection</primary><secondary>closing</secondary></indexterm>
<!-- .XS -->
<!-- \*(SN Connection Close -->
<!-- .XE -->
@@ -12543,6 +12596,7 @@ will not cause the server to reset.
<!-- \*(SN Events -->
<!-- .XE -->
<para>
+<indexterm zone="events"><primary>Event</primary></indexterm>
When a button press is processed with the pointer in some window W
and no active pointer grab is in progress,
the ancestors of W are searched from the root down,
@@ -12711,7 +12765,10 @@ Note that
and
<emphasis role='bold'>KeyRelease</emphasis>
are generated for all keys, even those mapped to modifier bits.
+<phrase id="events:input:source">
The source of the event is the window the pointer is in.
+</phrase>
+<indexterm zone="events:input:source"><primary>Event</primary><secondary>source</secondary></indexterm>
The window the event is reported with respect to is called the event window.
The event window is found by starting with the source window and
looking up the hierarchy for the first window on which any client has selected
@@ -13731,6 +13788,7 @@ and
<section id="events:Expose">
<title>Expose</title>
<indexterm zone="events:Expose" significance="preferred"><primary>Expose</primary></indexterm>
+ <indexterm zone="events:Expose"><primary>Event</primary><secondary>Exposure</secondary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
@@ -14202,6 +14260,7 @@ when the window itself had a win-gravity of
<section id="events:MapNotify">
<title>MapNotify</title>
<indexterm zone="events:MapNotify" significance="preferred"><primary>MapNotify</primary></indexterm>
+ <indexterm zone="events:MapNotify"><primary>Mapped window</primary></indexterm>
<informaltable frame='none'>
<tgroup cols='1' align='left'>
<colspec colname='c1' colsep='0'/>
commit 0ffb15d69844f1a653d51e29e0c6a1140cd52c3e
Author: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Sat May 28 13:53:10 2011 -0700
spec: move id attributes for event definitions so fop can find them
FOP gives 'Unresolved ID reference "events:FocusOut" found.' errors
when the id attribute is on the emphasis tag, so moved up to the
surrounding entry tag.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
diff --git a/specs/sect1-9.xml b/specs/sect1-9.xml
index 5976546..1748935 100644
--- a/specs/sect1-9.xml
+++ b/specs/sect1-9.xml
@@ -12629,33 +12629,33 @@ can both be used to modify the active grab.
<colspec colname='c1' colsep='0'/>
<tbody>
<row rowsep='0'>
- <entry>
+ <entry id="events:KeyPress">
<indexterm zone="events:KeyPress" significance="preferred"><primary>KeyPress</primary></indexterm>
-<emphasis role='bold' id="events:KeyPress">KeyPress</emphasis>
+<emphasis role='bold'>KeyPress</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:KeyRelease">
<indexterm zone="events:KeyRelease" significance="preferred"><primary>KeyRelease</primary></indexterm>
-<emphasis role='bold' id="events:KeyRelease">KeyRelease</emphasis>
+<emphasis role='bold'>KeyRelease</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:ButtonPress">
<indexterm zone="events:ButtonPress" significance="preferred"><primary>ButtonPress</primary></indexterm>
-<emphasis role='bold' id="events:ButtonPress">ButtonPress</emphasis>
+<emphasis role='bold'>ButtonPress</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:ButtonRelease">
<indexterm zone="events:ButtonRelease" significance="preferred"><primary>ButtonRelease</primary></indexterm>
-<emphasis role='bold' id="events:ButtonRelease">ButtonRelease</emphasis>
+<emphasis role='bold'>ButtonRelease</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:MotionNotify">
<indexterm zone="events:MotionNotify" significance="preferred"><primary>MotionNotify</primary></indexterm>
-<emphasis role='bold' id="events:MotionNotify">MotionNotify</emphasis>
+<emphasis role='bold'>MotionNotify</emphasis>
</entry>
</row>
<row rowsep='0'>
@@ -12824,15 +12824,15 @@ request.
<colspec colname='c1' colsep='0'/>
<tbody>
<row rowsep='0'>
- <entry>
+ <entry id="events:EnterNotify">
<indexterm zone="events:EnterNotify" significance="preferred"><primary>EnterNotify</primary></indexterm>
-<emphasis role='bold' id="events:EnterNotify">EnterNotify</emphasis>
+<emphasis role='bold'>EnterNotify</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:LeaveNotify">
<indexterm zone="events:LeaveNotify" significance="preferred"><primary>LeaveNotify</primary></indexterm>
-<emphasis role='bold' id="events:LeaveNotify">LeaveNotify</emphasis>
+<emphasis role='bold'>LeaveNotify</emphasis>
</entry>
</row>
<row rowsep='0'>
@@ -13187,15 +13187,15 @@ and final positions for the events.
<colspec colname='c1' colsep='0'/>
<tbody>
<row rowsep='0'>
- <entry>
+ <entry id="events:FocusIn">
<indexterm zone="events:FocusIn" significance="preferred"><primary>FocusIn</primary></indexterm>
-<emphasis role='bold' id="events:FocusIn">FocusIn</emphasis>
+<emphasis role='bold'>FocusIn</emphasis>
</entry>
</row>
<row rowsep='0'>
- <entry>
+ <entry id="events:FocusOut">
<indexterm zone="events:FocusOut" significance="preferred"><primary>FocusOut</primary></indexterm>
-<emphasis role='bold' id="events:FocusOut">FocusOut</emphasis>
+<emphasis role='bold'>FocusOut</emphasis>
</entry>
</row>
<row rowsep='0'>
commit 41da11426e0ad420952fbd329527c2ae267e232b
Author: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Sat May 28 13:39:37 2011 -0700
spec: Add zone attributes to indexterm tags for more stable link ids
Use named id's instead of autogenerating idXXXXXX values that change
in different versions so that it's easier to have stable links.
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
diff --git a/specs/glossary.xml b/specs/glossary.xml
index 7c5c86c..63dd92d 100644
--- a/specs/glossary.xml
+++ b/specs/glossary.xml
@@ -4,7 +4,7 @@
<glossentry id="glossary:Access_control_list">
<glossterm>Access control list</glossterm>
- <indexterm significance="preferred"><primary>Access control list</primary></indexterm>
+ <indexterm zone="glossary:Access_control_list" significance="preferred"><primary>Access control list</primary></indexterm>
<glossdef>
<para>
X maintains a list of hosts from which client programs can be run.
@@ -22,7 +22,7 @@ protocol name and data received by the server at connection setup.
</glossentry>
<glossentry id="glossary:Active_grab">
<glossterm>Active grab</glossterm>
- <indexterm significance="preferred"><primary>Active grab</primary></indexterm>
+ <indexterm zone="glossary:Active_grab" significance="preferred"><primary>Active grab</primary></indexterm>
<glossdef>
<para>
A grab is active when the pointer or keyboard is actually owned by
@@ -33,7 +33,7 @@ the single grabbing client.
</glossentry>
<glossentry id="glossary:Ancestors">
<glossterm>Ancestors</glossterm>
- <indexterm significance="preferred"><primary>Ancestors</primary></indexterm>
+ <indexterm zone="glossary:Ancestors" significance="preferred"><primary>Ancestors</primary></indexterm>
<glossdef>
<para>
If W is an <glossterm linkend="glossary:Inferiors">inferior</glossterm> of A, then A is an ancestor of W.
@@ -43,7 +43,7 @@ If W is an <glossterm linkend="glossary:Inferiors">inferior</glossterm> of A, th
</glossentry>
<glossentry id="glossary:Atom">
<glossterm>Atom</glossterm>
- <indexterm significance="preferred"><primary>Atom</primary></indexterm>
+ <indexterm zone="glossary:Atom" significance="preferred"><primary>Atom</primary></indexterm>
<glossdef>
<para>
An atom is a unique ID corresponding to a string name.
@@ -54,7 +54,7 @@ Atoms are used to identify properties, types, and selections.
</glossentry>
<glossentry id="glossary:Background">
<glossterm>Background</glossterm>
- <indexterm significance="preferred"><primary>Background</primary></indexterm>
+ <indexterm zone="glossary:Background" significance="preferred"><primary>Background</primary></indexterm>
<glossdef>
<para>
An
@@ -68,7 +68,7 @@ the server will automatically tile those regions with the background.
Reply to: