diff options
| author | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2011-08-20 17:40:03 +0000 |
|---|---|---|
| committer | Matthieu Herrb <matthieu@cvs.openbsd.org> | 2011-08-20 17:40:03 +0000 |
| commit | 3747772b54b61b1947df2bf8f15872e3a3ff2973 (patch) | |
| tree | f1acd233da60d5cadc76607936d6d1452754da2c /proto | |
| parent | 150c38b97a98ae495f1d8f2c98420ac65a6c69a3 (diff) | |
Update to x11proto 7.0.22.
Diffstat (limited to 'proto')
| -rw-r--r-- | proto/x11proto/ChangeLog | 241 | ||||
| -rw-r--r-- | proto/x11proto/XF86keysym.h | 3 | ||||
| -rw-r--r-- | proto/x11proto/Xfuncproto.h.in | 23 | ||||
| -rw-r--r-- | proto/x11proto/configure.ac | 13 | ||||
| -rw-r--r-- | proto/x11proto/docbook.am | 97 | ||||
| -rw-r--r-- | proto/x11proto/keysymdef.h | 26 | ||||
| -rw-r--r-- | proto/x11proto/specs/Makefile.am | 76 | ||||
| -rw-r--r-- | proto/x11proto/specs/encoding.xml | 8 | ||||
| -rw-r--r-- | proto/x11proto/specs/glossary.xml | 209 | ||||
| -rw-r--r-- | proto/x11proto/specs/keysyms.xml | 11 | ||||
| -rw-r--r-- | proto/x11proto/specs/sect1-9.xml | 707 | ||||
| -rw-r--r-- | proto/x11proto/specs/x11protocol.xml | 2 |
12 files changed, 898 insertions, 518 deletions
diff --git a/proto/x11proto/ChangeLog b/proto/x11proto/ChangeLog index 80d13940a..0236df9d8 100644 --- a/proto/x11proto/ChangeLog +++ b/proto/x11proto/ChangeLog @@ -1,3 +1,244 @@ +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> + +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> + +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> + +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 + +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> + +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> + +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> + +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> + +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> + +commit 58897af838482f52abc8a70fc1e1d39c89736bfb +Author: Alan Coopersmith <alan.coopersmith@oracle.com> +Date: Sat May 28 11:04:17 2011 -0700 + + spec: move > outside emphasis to match < in note after error list + + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit 19b35215c9cff167c62dabecef89e3d5f8df2853 +Author: Alan Coopersmith <alan.coopersmith@oracle.com> +Date: Sat May 28 10:56:36 2011 -0700 + + spec: Syntactic Conventions examples should not be separate list entries + + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit e6ad4dd8d054caf6cd63575167db468929532089 +Author: Alan Coopersmith <alan.coopersmith@oracle.com> +Date: Sat May 28 09:54:07 2011 -0700 + + spec: Add cross-reference links in glossary to InputOnly & InputOutput + + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit 2fc4719ba4f122ce5604d693442fa041114526ac +Author: Alan Coopersmith <alan.coopersmith@oracle.com> +Date: Sat May 28 09:43:04 2011 -0700 + + spec: Markup VoidSymbol and NoSymbol with <keysym> instead of <emphasis> + + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit 9bbb6e3f835219110ec0f7bd72ba7fa92974bae8 +Author: Cyril Brulebois <kibi@debian.org> +Date: Tue May 24 13:08:27 2011 +0200 + + Sort Latin 8 keysyms by codepoints. + + The overall chaos misled implementors into writing interval checks to + determine the case, but that doesn't work too well when lines aren't + sorted. + + Sort performed by calling “sort -k 3” on the part between #ifdef + XK_LATIN8 and #endif. + + Signed-off-by: Cyril Brulebois <kibi@debian.org> + Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit b283f6cba77987b215556f80b6b2f1da45672d8b +Author: Alan Coopersmith <alan.coopersmith@oracle.com> +Date: Mon May 23 16:01:02 2011 -0700 + + Add comments to Xfuncproto.h noting required xproto versions for each macro + + Saves time trawling git logs to determine what to put in the call to + PKG_CHECK_MODULES in configure.ac when you start using one of these. + + Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com> + Reviewed-by: Jeremy Huddleston <jeremyhu@apple.com> + Acked-by: Cyril Brulebois <kibi@debian.org> + +commit 217d1dae0093ccaaac59a4fa42000e732492cb66 +Author: Jeremy Huddleston <jeremyhu@apple.com> +Date: Wed Apr 27 17:25:53 2011 -0700 + + Add _X_NONNULL macro to annotate when a function expects arguments to be non-null + + This will allow with compiler optimization and better static analysis. + + Signed-off-by: Jeremy Huddleston <jeremyhu@apple.com> + Reviewed-by: Daniel Stone <daniel@fooishbar.org> + +commit 6648db8f910fb74c100cf24436bf0df12cba7fd7 +Author: Jeremy Huddleston <jeremyhu@apple.com> +Date: Wed Apr 27 17:25:40 2011 -0700 + + Add _X_UNUSED attribute to designate unused variables and silence warnings + + Signed-off-by: Jeremy Huddleston <jeremyhu@apple.com> + Reviewed-by: Daniel Stone <daniel@fooishbar.org> + +commit 19c12c60c22d5a23039bc90845a6ecacdd64f2db +Author: Matthieu Herrb <matthieu.herrb@laas.fr> +Date: Wed Apr 20 22:57:05 2011 +0200 + + Fix __STDC_VERSION__ tests. + + the existing test: + defined(__STDC__) && (__STDC_VERSION__ - 0 >= 199901L) causes an + warning when building X stuff with gcc -Wundef. Other tests for + __STDC_VERSION__ in the X sources all use + defined(__STDC_VERSION__) && (__STDC_VERSION__ -0 >= 199901L) + + Signed-off-by: Matthieu Herrb <matthieu.herrb@laas.fr> + Reviewed-by: Matt Turner <mattst88@gmail.com> + Reviewed-by: Alan Coopersmith <alan.coopersmith@oracle.com> + +commit da46c2d0e11c1709b7dd6b2c79253ce8751c81bb +Author: Gaetan Nadon <memsize@videotron.ca> +Date: Sun Feb 27 15:06:18 2011 -0500 + + Documentation: add Docbook external references support + + When writing technical documentation, it is often necessary to cross + reference to other information. When that other information is not in the + current document, additional support is needed, namely <olink>. + + A new feature with version 1.7 of xorg-sgml-doctools adds references to + other documents within or outside this package. + + This patch adds technical support for this feature but does not change + the content of the documentation as seen by the end user. + + Each book or article must generate a database containing the href + of sections that can be referred to from another document. This database + is installed in DATAROOTDIR/sgml/X11/dbs. There is a requirement that + the value of DATAROOTDIR for xorg-sgml-doctools and for the package + documentation is the same. This forms a virtual document tree. + + This database is consulted by other documents while they are being generated + in order to fulfill the missing information for linking. + Refer to the xorg-sgml-doctools for further technical information. + + Co-authored-by: Matt Dew <marcoz@osource.org> + + Signed-off-by: Gaetan Nadon <memsize@videotron.ca> + commit 452ae1076b4ad8ccd60e218a3676baa274c083ff Author: Peter Hutterer <peter.hutterer@who-t.net> Date: Wed Mar 23 11:44:18 2011 +1000 diff --git a/proto/x11proto/XF86keysym.h b/proto/x11proto/XF86keysym.h index fd3af4f44..df5e9cc7f 100644 --- a/proto/x11proto/XF86keysym.h +++ b/proto/x11proto/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 */ diff --git a/proto/x11proto/Xfuncproto.h.in b/proto/x11proto/Xfuncproto.h.in index 2b8a2267f..0d7b8b720 100644 --- a/proto/x11proto/Xfuncproto.h.in +++ b/proto/x11proto/Xfuncproto.h.in @@ -75,12 +75,14 @@ in this Software without prior written authorization from The Open Group. #endif #endif /* _XFUNCPROTOBEGIN */ +/* Added in X11R6.9, so available in any version of modular xproto */ #if defined(__GNUC__) && (__GNUC__ >= 4) # define _X_SENTINEL(x) __attribute__ ((__sentinel__(x))) #else # define _X_SENTINEL(x) #endif /* GNUC >= 4 */ +/* Added in X11R6.9, so available in any version of modular xproto */ #if defined(__GNUC__) && (__GNUC__ >= 4) && !defined(__CYGWIN__) # define _X_EXPORT __attribute__((visibility("default"))) # define _X_HIDDEN __attribute__((visibility("hidden"))) @@ -95,6 +97,7 @@ in this Software without prior written authorization from The Open Group. # define _X_INTERNAL #endif /* GNUC >= 4 */ +/* requires xproto >= 7.0.9 */ #if defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 303) # define _X_LIKELY(x) __builtin_expect(!!(x), 1) # define _X_UNLIKELY(x) __builtin_expect(!!(x), 0) @@ -103,12 +106,14 @@ in this Software without prior written authorization from The Open Group. # define _X_UNLIKELY(x) (x) #endif +/* Added in X11R6.9, so available in any version of modular xproto */ #if defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 301) # define _X_DEPRECATED __attribute__((deprecated)) #else /* not gcc >= 3.1 */ # define _X_DEPRECATED #endif +/* requires xproto >= 7.0.17 */ #if (defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 205)) \ || (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x590)) # define _X_NORETURN __attribute((noreturn)) @@ -116,13 +121,30 @@ in this Software without prior written authorization from The Open Group. # define _X_NORETURN #endif /* GNUC */ +/* Added in X11R6.9, so available in any version of modular xproto */ #if defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 203) # define _X_ATTRIBUTE_PRINTF(x,y) __attribute__((__format__(__printf__,x,y))) #else /* not gcc >= 2.3 */ # define _X_ATTRIBUTE_PRINTF(x,y) #endif +/* requires xproto >= 7.0.22 */ +#if defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 303) +#define _X_NONNULL(args...) __attribute__((nonnull(args))) +#else +#define _X_NONNULL(...) /* */ +#endif + +/* requires xproto >= 7.0.22 */ +#if defined(__GNUC__) && ((__GNUC__ * 100 + __GNUC_MINOR__) >= 205) +#define _X_UNUSED __attribute__((__unused__)) +#else +#define _X_UNUSED /* */ +#endif + /* C99 keyword "inline" or equivalent extensions in pre-C99 compilers */ +/* requires xproto >= 7.0.9 + (introduced in 7.0.8 but didn't support all compilers until 7.0.9) */ #if defined(inline) /* assume autoconf set it correctly */ || \ (defined(__STDC_VERSION__) && (__STDC_VERSION__ - 0 >= 199901L)) /* C99 */ || \ (defined(__SUNPRO_C) && (__SUNPRO_C >= 0x550)) @@ -134,6 +156,7 @@ in this Software without prior written authorization from The Open Group. #endif /* C99 keyword "restrict" or equivalent extensions in pre-C99 compilers */ +/* requires xproto >= 7.0.21 */ #ifndef _X_RESTRICT_KYWD # if defined(restrict) /* assume autoconf set it correctly */ || \ (defined(__STDC_VERSION__) && (__STDC_VERSION__ - 0 >= 199901L)) /* C99 */ diff --git a/proto/x11proto/configure.ac b/proto/x11proto/configure.ac index 9e515a9ec..dad03e34d 100644 --- a/proto/x11proto/configure.ac +++ b/proto/x11proto/configure.ac @@ -1,18 +1,19 @@ 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 -# Require xorg-macros minimum of 1.10 for DocBook XML documentation +# Require xorg-macros minimum of 1.12 for DocBook external references m4_ifndef([XORG_MACROS_VERSION], - [m4_fatal([must install xorg-macros 1.10 or later before running autoconf/autogen])]) -XORG_MACROS_VERSION(1.10) + [m4_fatal([must install xorg-macros 1.12 or later before running autoconf/autogen])]) +XORG_MACROS_VERSION(1.12) XORG_DEFAULT_OPTIONS XORG_ENABLE_SPECS -XORG_WITH_XMLTO(0.0.20) +XORG_WITH_XMLTO(0.0.22) XORG_WITH_FOP -XORG_CHECK_SGML_DOCTOOLS(1.5) +XORG_WITH_XSLTPROC +XORG_CHECK_SGML_DOCTOOLS(1.8) AC_CONFIG_HEADER([do-not-use-config.h]) AC_CONFIG_HEADER([Xfuncproto.h]) diff --git a/proto/x11proto/docbook.am b/proto/x11proto/docbook.am new file mode 100644 index 000000000..2ffb7e60a --- /dev/null +++ b/proto/x11proto/docbook.am @@ -0,0 +1,97 @@ +# +# Generate output formats for a single DocBook/XML with/without chapters +# +# Variables set by the calling Makefile: +# shelfdir: the location where the docs/specs are installed. Typically $(docdir) +# docbook: the main DocBook/XML file, no chapters, appendix or image files +# chapters: all files pulled in by an XInclude statement and images. +# + +# +# This makefile is intended for Users Documentation and Functional Specifications. +# Do not use for Developer Documentation which is not installed and does not require olink. +# Refer to http://www.x.org/releases/X11R7.6/doc/xorg-docs/ReleaseNotes.html#id2584393 +# for an explanation on documents classification. +# + +# DocBook/XML generated output formats to be installed +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 +# + +# Stylesheets are available if the package xorg-sgml-doctools is installed +if HAVE_STYLESHEETS + +# The location where all cross reference databases are installed +sgmldbsdir = $(XORG_SGML_PATH)/X11/dbs +masterdb = "$(sgmldbsdir)/masterdb$(suffix $@).xml" +XMLTO_FLAGS = \ + --searchpath "$(XORG_SGML_PATH)/X11" \ + --stringparam target.database.document=$(masterdb) \ + --stringparam current.docid="$(<:.xml=)" \ + --stringparam collect.xref.targets="no" + +XMLTO_XHTML_FLAGS = \ + -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl \ + --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css + +XMLTO_FO_FLAGS = \ + -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl +endif HAVE_STYLESHEETS + +shelf_DATA += $(docbook:.xml=.html) +%.html: %.xml $(chapters) + $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_XHTML_FLAGS) xhtml-nochunks $< + +if HAVE_FOP +shelf_DATA += $(docbook:.xml=.pdf) $(docbook:.xml=.ps) +%.pdf: %.xml $(chapters) + $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_FO_FLAGS) --with-fop pdf $< +%.ps: %.xml $(chapters) + $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_FO_FLAGS) --with-fop ps $< +endif HAVE_FOP + +if HAVE_XMLTO_TEXT +shelf_DATA += $(docbook:.xml=.txt) +%.txt: %.xml $(chapters) + $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) $(XMLTO_XHTML_FLAGS) txt $< +endif HAVE_XMLTO_TEXT + +# +# Generate documents cross-reference target databases +# + +# This is only possible if the xorg-sgml-doctools package is installed +if HAVE_STYLESHEETS +if HAVE_XSLTPROC + +# DocBook/XML generated document cross-reference database +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 +XSLTPROC_FLAGS = \ + --path "$(XORG_SGML_PATH)/X11" \ + --stringparam targets.filename "$@" \ + --stringparam collect.xref.targets "only" \ + --nonet --xinclude + +%.html.db: %.xml $(chapters) + $(AM_V_GEN)$(XSLTPROC) $(XSLTPROC_FLAGS) \ + http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl $< + +%.fo.db: %.xml $(chapters) + $(AM_V_GEN)$(XSLTPROC) $(XSLTPROC_FLAGS) \ + http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl $< + +endif HAVE_XSLTPROC +endif HAVE_STYLESHEETS +endif HAVE_XMLTO + +CLEANFILES = $(shelf_DATA) diff --git a/proto/x11proto/keysymdef.h b/proto/x11proto/keysymdef.h index a4a760db4..73b55339c 100644 --- a/proto/x11proto/keysymdef.h +++ b/proto/x11proto/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 */ @@ -868,32 +868,32 @@ SOFTWARE. * Latin 8 */ #ifdef XK_LATIN8 +#define XK_Wcircumflex 0x1000174 /* U+0174 LATIN CAPITAL LETTER W WITH CIRCUMFLEX */ +#define XK_wcircumflex 0x1000175 /* U+0175 LATIN SMALL LETTER W WITH CIRCUMFLEX */ +#define XK_Ycircumflex 0x1000176 /* U+0176 LATIN CAPITAL LETTER Y WITH CIRCUMFLEX */ +#define XK_ycircumflex 0x1000177 /* U+0177 LATIN SMALL LETTER Y WITH CIRCUMFLEX */ #define XK_Babovedot 0x1001e02 /* U+1E02 LATIN CAPITAL LETTER B WITH DOT ABOVE */ #define XK_babovedot 0x1001e03 /* U+1E03 LATIN SMALL LETTER B WITH DOT ABOVE */ #define XK_Dabovedot 0x1001e0a /* U+1E0A LATIN CAPITAL LETTER D WITH DOT ABOVE */ -#define XK_Wgrave 0x1001e80 /* U+1E80 LATIN CAPITAL LETTER W WITH GRAVE */ -#define XK_Wacute 0x1001e82 /* U+1E82 LATIN CAPITAL LETTER W WITH ACUTE */ #define XK_dabovedot 0x1001e0b /* U+1E0B LATIN SMALL LETTER D WITH DOT ABOVE */ -#define XK_Ygrave 0x1001ef2 /* U+1EF2 LATIN CAPITAL LETTER Y WITH GRAVE */ #define XK_Fabovedot 0x1001e1e /* U+1E1E LATIN CAPITAL LETTER F WITH DOT ABOVE */ #define XK_fabovedot 0x1001e1f /* U+1E1F LATIN SMALL LETTER F WITH DOT ABOVE */ #define XK_Mabovedot 0x1001e40 /* U+1E40 LATIN CAPITAL LETTER M WITH DOT ABOVE */ #define XK_mabovedot 0x1001e41 /* U+1E41 LATIN SMALL LETTER M WITH DOT ABOVE */ #define XK_Pabovedot 0x1001e56 /* U+1E56 LATIN CAPITAL LETTER P WITH DOT ABOVE */ -#define XK_wgrave 0x1001e81 /* U+1E81 LATIN SMALL LETTER W WITH GRAVE */ #define XK_pabovedot 0x1001e57 /* U+1E57 LATIN SMALL LETTER P WITH DOT ABOVE */ -#define XK_wacute 0x1001e83 /* U+1E83 LATIN SMALL LETTER W WITH ACUTE */ #define XK_Sabovedot 0x1001e60 /* U+1E60 LATIN CAPITAL LETTER S WITH DOT ABOVE */ -#define XK_ygrave 0x1001ef3 /* U+1EF3 LATIN SMALL LETTER Y WITH GRAVE */ -#define XK_Wdiaeresis 0x1001e84 /* U+1E84 LATIN CAPITAL LETTER W WITH DIAERESIS */ -#define XK_wdiaeresis 0x1001e85 /* U+1E85 LATIN SMALL LETTER W WITH DIAERESIS */ #define XK_sabovedot 0x1001e61 /* U+1E61 LATIN SMALL LETTER S WITH DOT ABOVE */ -#define XK_Wcircumflex 0x1000174 /* U+0174 LATIN CAPITAL LETTER W WITH CIRCUMFLEX */ #define XK_Tabovedot 0x1001e6a /* U+1E6A LATIN CAPITAL LETTER T WITH DOT ABOVE */ -#define XK_Ycircumflex 0x1000176 /* U+0176 LATIN CAPITAL LETTER Y WITH CIRCUMFLEX */ -#define XK_wcircumflex 0x1000175 /* U+0175 LATIN SMALL LETTER W WITH CIRCUMFLEX */ #define XK_tabovedot 0x1001e6b /* U+1E6B LATIN SMALL LETTER T WITH DOT ABOVE */ -#define XK_ycircumflex 0x1000177 /* U+0177 LATIN SMALL LETTER Y WITH CIRCUMFLEX */ +#define XK_Wgrave 0x1001e80 /* U+1E80 LATIN CAPITAL LETTER W WITH GRAVE */ +#define XK_wgrave 0x1001e81 /* U+1E81 LATIN SMALL LETTER W WITH GRAVE */ +#define XK_Wacute 0x1001e82 /* U+1E82 LATIN CAPITAL LETTER W WITH ACUTE */ +#define XK_wacute 0x1001e83 /* U+1E83 LATIN SMALL LETTER W WITH ACUTE */ +#define XK_Wdiaeresis 0x1001e84 /* U+1E84 LATIN CAPITAL LETTER W WITH DIAERESIS */ +#define XK_wdiaeresis 0x1001e85 /* U+1E85 LATIN SMALL LETTER W WITH DIAERESIS */ +#define XK_Ygrave 0x1001ef2 /* U+1EF2 LATIN CAPITAL LETTER Y WITH GRAVE */ +#define XK_ygrave 0x1001ef3 /* U+1EF3 LATIN SMALL LETTER Y WITH GRAVE */ #endif /* XK_LATIN8 */ /* diff --git a/proto/x11proto/specs/Makefile.am b/proto/x11proto/specs/Makefile.am index c0b1642da..c7c4fe5ea 100644 --- a/proto/x11proto/specs/Makefile.am +++ b/proto/x11proto/specs/Makefile.am @@ -1,73 +1,21 @@ -# -# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved. -# -# Permission is hereby granted, free of charge, to any person obtaining a -# copy of this software and associated documentation files (the "Software"), -# to deal in the Software without restriction, including without limitation -# the rights to use, copy, modify, merge, publish, distribute, sublicense, -# and/or sell copies of the Software, and to permit persons to whom the -# Software is furnished to do so, subject to the following conditions: -# -# The above copyright notice and this permission notice (including the next -# paragraph) shall be included in all copies or substantial portions of the -# Software. -# -# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL -# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING -# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER -# DEALINGS IN THE SOFTWARE. -# - SUBDIRS = SIAddresses if ENABLE_SPECS -doc_sources = x11protocol.xml -dist_doc_DATA = $(doc_sources) \ - encoding.xml \ - glossary.xml \ - keysyms.xml \ - sect1-9.xml - -if HAVE_XMLTO -doc_DATA = $(doc_sources:.xml=.html) - -if HAVE_FOP -doc_DATA += $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf) -endif - -if HAVE_XMLTO_TEXT -doc_DATA += $(doc_sources:.xml=.txt) -endif - -if HAVE_STYLESHEETS -XMLTO_FLAGS = \ - -m $(XSL_STYLESHEET) \ - --stringparam img.src.path=$(abs_builddir)/ \ - --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css -endif +# Main DocBook/XML files (DOCTYPE book) +docbook = x11protocol.xml -CLEANFILES = $(doc_DATA) - -SUFFIXES = .xml .ps .pdf .txt .html - -%.txt: %.xml $(dist_doc_DATA) - $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $< - -%.html: %.xml $(dist_doc_DATA) - $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $< - -%.pdf: %.xml $(dist_doc_DATA) - $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $< +# Included chapters, appendix, images +chapters = \ + encoding.xml \ + glossary.xml \ + keysyms.xml \ + sect1-9.xml -%.ps: %.xml $(dist_doc_DATA) - $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $< +# The location where the DocBook/XML files and their generated formats are installed +shelfdir = $(docdir) -chunked-html: $(dist_doc_DATA) - $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources) +# Generate DocBook/XML output formats with or without stylesheets +include $(top_srcdir)/docbook.am -endif HAVE_XMLTO endif ENABLE_SPECS diff --git a/proto/x11proto/specs/encoding.xml b/proto/x11proto/specs/encoding.xml index b67b48ef7..e3b239965 100644 --- a/proto/x11proto/specs/encoding.xml +++ b/proto/x11proto/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/proto/x11proto/specs/glossary.xml b/proto/x11proto/specs/glossary.xml index 118601314..61233e3c4 100644 --- a/proto/x11proto/specs/glossary.xml +++ b/proto/x11proto/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,11 +54,11 @@ 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 -<emphasis role='bold'>InputOutput</emphasis> +<glossterm linkend="glossary:InputOutput_window"><emphasis role='bold'>InputOutput</emphasis></glossterm> window can have a background, which is defined as a pixmap. When regions of the window have their contents lost or invalidated, the server will automatically tile those regions with the background. @@ -68,7 +68,7 @@ the server will automatically tile those regions with the background. </glossentry> <glossentry id="glossary:Backing_store"> <glossterm>Backing store</glossterm> - <indexterm significance="preferred"><primary>Backing store</primary></indexterm> + <indexterm zone="glossary:Backing_store" significance="preferred"><primary>Backing store</primary></indexterm> <glossdef> <para> When a server maintains the contents of a window, @@ -79,7 +79,7 @@ the pixels saved off screen are known as a backing store. </glossentry> <glossentry id="glossary:Bit_gravity"> <glossterm>Bit gravity</glossterm> - <indexterm significance="preferred"><primary>Bit</primary><secondary>gravity</secondary></indexterm> + <indexterm zone="glossary:Bit_gravity" significance="preferred"><primary>Bit</primary><secondary>gravity</secondary></indexterm> <glossdef> <para> When a window is resized, @@ -94,7 +94,7 @@ a window is known as bit gravity. </glossentry> <glossentry id="glossary:Bit_plane"> <glossterm>Bit plane</glossterm> - <indexterm significance="preferred"><primary>Bit</primary><secondary>plane</secondary></indexterm> + <indexterm zone="glossary:Bit_plane" significance="preferred"><primary>Bit</primary><secondary>plane</secondary></indexterm> <glossdef> <para> When a pixmap or window is thought of as a stack of bitmaps, @@ -105,7 +105,7 @@ each bitmap is called a bit plane or plane. </glossentry> <glossentry id="glossary:Bitmap"> <glossterm>Bitmap</glossterm> - <indexterm significance="preferred"><primary>Bitmap</primary></indexterm> + <indexterm zone="glossary:Bitmap" significance="preferred"><primary>Bitmap</primary></indexterm> <glossdef> <para> A bitmap is a <glossterm linkend="glossary:Pixmap">pixmap</glossterm> of depth one. @@ -115,11 +115,11 @@ A bitmap is a <glossterm linkend="glossary:Pixmap">pixmap</glossterm> of depth o </glossentry> <glossentry id="glossary:Border"> <glossterm>Border</glossterm> - <indexterm significance="preferred"><primary>Border</primary></indexterm> + <indexterm zone="glossary:Border" significance="preferred"><primary>Border</primary></indexterm> <glossdef> <para> An -<emphasis role='bold'>InputOutput</emphasis> +<glossterm linkend="glossary:InputOutput_window"><emphasis role='bold'>InputOutput</emphasis></glossterm> window can have a border of equal thickness on all four sides of the window. A pixmap defines the contents of the border, and the server automatically maintains the contents of the border. @@ -130,7 +130,7 @@ Exposure events are never generated for border regions. </glossentry> <glossentry id="glossary:Button_grabbing"> <glossterm>Button grabbing</glossterm> - <indexterm significance="preferred"><primary>Button</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="glossary:Button_grabbing" significance="preferred"><primary>Button</primary><secondary>grabbing</secondary></indexterm> <glossdef> <para> Buttons on the pointer may be passively grabbed by a client. @@ -142,7 +142,7 @@ the pointer is then actively grabbed by the client. </glossentry> <glossentry id="glossary:Byte_order"> <glossterm>Byte order</glossterm> - <indexterm significance="preferred"><primary>Byte order</primary></indexterm> + <indexterm zone="glossary:Byte_order" significance="preferred"><primary>Byte order</primary></indexterm> <glossdef> <para> For image (pixmap/bitmap) data, @@ -157,7 +157,8 @@ and the server swaps bytes as necessary. </glossentry> <glossentry id="glossary:Children"> <glossterm>Children</glossterm> - <indexterm significance="preferred"><primary>Children</primary></indexterm> + <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. @@ -167,7 +168,7 @@ The children of a window are its first-level subwindows. </glossentry> <glossentry id="glossary:Client"> <glossterm>Client</glossterm> - <indexterm significance="preferred"><primary>Client</primary></indexterm> + <indexterm zone="glossary:Client" significance="preferred"><primary>Client</primary></indexterm> <glossdef> <para> An application program connects to the window system server by some @@ -186,7 +187,7 @@ not by program lifetimes. </glossentry> <glossentry id="glossary:Clipping_region"> <glossterm>Clipping region</glossterm> - <indexterm significance="preferred"><primary>Clipping region</primary></indexterm> + <indexterm zone="glossary:Clipping_region" significance="preferred"><primary>Clipping region</primary></indexterm> <glossdef> <para> In a <glossterm linkend="glossary:Graphics_context">graphics context</glossterm>, @@ -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 @@ -215,7 +216,7 @@ so that windows associated with those maps display with correct colors. </glossentry> <glossentry id="glossary:Connection"> <glossterm>Connection</glossterm> - <indexterm significance="preferred"><primary>Connection</primary></indexterm> + <indexterm zone="glossary:Connection" significance="preferred"><primary>Connection</primary></indexterm> <glossdef> <para> The interprocess communication path between the server and client @@ -228,7 +229,7 @@ connection to the server over which requests and events are sent. </glossentry> <glossentry id="glossary:Containment"> <glossterm>Containment</glossterm> - <indexterm significance="preferred"><primary>Containment</primary></indexterm> + <indexterm zone="glossary:Containment" significance="preferred"><primary>Containment</primary></indexterm> <glossdef> <para> A window <quote>contains</quote> the pointer if the window is viewable and the @@ -244,7 +245,7 @@ but no inferior contains the pointer. </glossentry> <glossentry id="glossary:Coordinate_system"> <glossterm>Coordinate system</glossterm> - <indexterm significance="preferred"><primary>Coordinate system</primary></indexterm> + <indexterm zone="glossary:Coordinate_system" significance="preferred"><primary>Coordinate system</primary></indexterm> <glossdef> <para> The coordinate system has the X axis horizontal and the Y axis vertical, @@ -261,7 +262,7 @@ the origin is inside the border at the inside upper left. </glossentry> <glossentry id="glossary:Cursor"> <glossterm>Cursor</glossterm> - <indexterm significance="preferred"><primary>Cursor</primary></indexterm> + <indexterm zone="glossary:Cursor" significance="preferred"><primary>Cursor</primary></indexterm> <glossdef> <para> A cursor is the visible shape of the pointer on a screen. @@ -275,7 +276,7 @@ when the pointer is in that window. </glossentry> <glossentry id="glossary:Depth"> <glossterm>Depth</glossterm> - <indexterm significance="preferred"><primary>Depth</primary></indexterm> + <indexterm zone="glossary:Depth" significance="preferred"><primary>Depth</primary></indexterm> <glossdef> <para> The depth of a window or pixmap is the number of bits per pixel that it has. @@ -287,7 +288,7 @@ used in conjunction with for graphics output. </glossentry> <glossentry id="glossary:Device"> <glossterm>Device</glossterm> - <indexterm significance="preferred"><primary>Device</primary></indexterm> + <indexterm zone="glossary:Device" significance="preferred"><primary>Device</primary></indexterm> <glossdef> <para> Keyboards, mice, tablets, track-balls, button boxes, and so on are all @@ -300,7 +301,7 @@ The core protocol only deals with two devices, </glossentry> <glossentry id="glossary:DirectColor"> <glossterm>DirectColor</glossterm> - <indexterm significance="preferred"><primary>DirectColor</primary></indexterm> + <indexterm zone="glossary:DirectColor" significance="preferred"><primary>DirectColor</primary></indexterm> <glossdef> <para> <emphasis role='bold'>DirectColor</emphasis> @@ -316,7 +317,7 @@ The RGB values can be changed dynamically. </glossentry> <glossentry id="glossary:Display"> <glossterm>Display</glossterm> - <indexterm significance="preferred"><primary>Display</primary></indexterm> + <indexterm zone="glossary:Display" significance="preferred"><primary>Display</primary></indexterm> <glossdef> <para> A server, together with its screens and input devices, is called a display. @@ -326,14 +327,14 @@ A server, together with its screens and input devices, is called a display. </glossentry> <glossentry id="glossary:Drawable"> <glossterm>Drawable</glossterm> - <indexterm significance="preferred"><primary>Drawable</primary></indexterm> + <indexterm zone="glossary:Drawable" significance="preferred"><primary>Drawable</primary></indexterm> <glossdef> <para> Both windows and pixmaps can be used as sources and destinations in graphics operations. These windows and pixmaps are collectively known as drawables. However, an -<emphasis role='bold'>InputOnly</emphasis> +<glossterm linkend="glossary:InputOnly_window"><emphasis role='bold'>InputOnly</emphasis></glossterm> window cannot be used as a source or destination in a graphics operation. <!-- .KE --> </para> @@ -341,7 +342,7 @@ window cannot be used as a source or destination in a graphics operation. </glossentry> <glossentry id="glossary:Event"> <glossterm>Event</glossterm> - <indexterm significance="preferred"><primary>Event</primary></indexterm> + <indexterm zone="glossary:Event" significance="preferred"><primary>Event</primary></indexterm> <glossdef> <para> Clients are informed of information asynchronously by means of events. @@ -358,7 +359,7 @@ Events are typically reported relative to a window. </glossentry> <glossentry id="glossary:Event_mask"> <glossterm>Event mask</glossterm> - <indexterm significance="preferred"><primary>Event</primary><secondary>mask</secondary></indexterm> + <indexterm zone="glossary:Event_mask" significance="preferred"><primary>Event</primary><secondary>mask</secondary></indexterm> <glossdef> <para> Events are requested relative to a window. @@ -370,7 +371,7 @@ is described by using an event mask. </glossentry> <glossentry id="glossary:Event_synchronization"> <glossterm>Event synchronization</glossterm> - <indexterm significance="preferred"><primary>Event</primary><secondary>synchronization</secondary></indexterm> + <indexterm zone="glossary:Event_synchronization" significance="preferred"><primary>Event</primary><secondary>synchronization</secondary></indexterm> <glossdef> <para> There are certain race conditions possible when demultiplexing device @@ -385,7 +386,7 @@ of device events. </glossentry> <glossentry id="glossary:Event_propagation"> <glossterm>Event propagation</glossterm> - <indexterm significance="preferred"><primary>Event</primary><secondary>propagation</secondary></indexterm> + <indexterm zone="glossary:Event_propagation" significance="preferred"><primary>Event</primary><secondary>propagation</secondary></indexterm> <glossdef> <para> Device-related events propagate from the source window to ancestor @@ -397,7 +398,7 @@ of event or until the event is discarded explicitly. </glossentry> <glossentry id="glossary:Event_source"> <glossterm>Event source</glossterm> - <indexterm significance="preferred"><primary>Event</primary><secondary>source</secondary></indexterm> + <indexterm zone="glossary:Event_source" significance="preferred"><primary>Event</primary><secondary>source</secondary></indexterm> <glossdef> <para> The window the pointer is in is the source of a device-related @@ -408,7 +409,7 @@ event. </glossentry> <glossentry id="glossary:Exposure_event"> <glossterm>Exposure event</glossterm> - <indexterm significance="preferred"><primary>Event</primary><secondary>Exposure</secondary></indexterm> + <indexterm zone="glossary:Exposure_event" significance="preferred"><primary>Event</primary><secondary>Exposure</secondary></indexterm> <glossdef> <para> Servers do not guarantee to preserve the contents of windows when @@ -421,7 +422,7 @@ of regions of windows have been lost. </glossentry> <glossentry id="glossary:Extension"> <glossterm>Extension</glossterm> - <indexterm significance="preferred"><primary>Extension</primary></indexterm> + <indexterm zone="glossary:Extension" significance="preferred"><primary>Extension</primary></indexterm> <glossdef> <para> Named extensions to the core protocol can be defined to extend the @@ -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 --> @@ -444,7 +445,7 @@ The focus window is another term for the <glossterm linkend="glossary:Input_focu </glossentry> <glossentry id="glossary:Font"> <glossterm>Font</glossterm> - <indexterm significance="preferred"><primary>Font</primary></indexterm> + <indexterm zone="glossary:Font" significance="preferred"><primary>Font</primary></indexterm> <glossdef> <para> A font is a matrix of glyphs (typically characters). @@ -458,8 +459,8 @@ and interline spacing. </glossentry> <glossentry id="glossary:GC"> <glossterm>GC, GContext</glossterm> - <indexterm significance="preferred"><primary>GC</primary></indexterm> - <indexterm 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>. @@ -469,7 +470,7 @@ GC and gcontext are abbreviations for <glossterm linkend="glossary:Graphics_cont </glossentry> <glossentry id="glossary:Glyph"> <glossterm>Glyph</glossterm> - <indexterm significance="preferred"><primary>Glyph</primary></indexterm> + <indexterm zone="glossary:Glyph" significance="preferred"><primary>Glyph</primary></indexterm> <glossdef> <para> A glyph is an image, typically of a character, in a font. @@ -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 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 @@ -494,7 +495,7 @@ various styles of user interfaces. </glossentry> <glossentry id="glossary:Graphics_context"> <glossterm>Graphics context</glossterm> - <indexterm significance="preferred"><primary>Graphics context</primary></indexterm> + <indexterm zone="glossary:Graphics_context" significance="preferred"><primary>Graphics context</primary></indexterm> <glossdef> <para> Various information for graphics output is stored in a graphics context @@ -509,7 +510,7 @@ and the same depth as the graphics context. </glossentry> <glossentry id="glossary:Gravity"> <glossterm>Gravity</glossterm> - <indexterm significance="preferred"><primary>Gravity</primary></indexterm> + <indexterm zone="glossary:Gravity" significance="preferred"><primary>Gravity</primary></indexterm> <glossdef> <para> See <glossterm linkend="glossary:Bit_gravity">bit gravity</glossterm> @@ -520,7 +521,7 @@ and <glossterm linkend="glossary:Window_gravity">window gravity</glossterm>. </glossentry> <glossentry id="glossary:GrayScale"> <glossterm>GrayScale</glossterm> - <indexterm significance="preferred"><primary>GrayScale</primary></indexterm> + <indexterm zone="glossary:GrayScale" significance="preferred"><primary>GrayScale</primary></indexterm> <glossdef> <para> <emphasis role='bold'>GrayScale</emphasis> @@ -535,7 +536,7 @@ The gray values can be changed dynamically. </glossentry> <glossentry id="glossary:Hotspot"> <glossterm>Hotspot</glossterm> - <indexterm significance="preferred"><primary>Hotspot</primary></indexterm> + <indexterm zone="glossary:Hotspot" significance="preferred"><primary>Hotspot</primary></indexterm> <glossdef> <para> A cursor has an associated hotspot that defines the point in the @@ -546,7 +547,7 @@ cursor corresponding to the coordinates reported for the pointer. </glossentry> <glossentry id="glossary:Identifier"> <glossterm>Identifier</glossterm> - <indexterm significance="preferred"><primary>Identifier</primary></indexterm> + <indexterm zone="glossary:Identifier" significance="preferred"><primary>Identifier</primary></indexterm> <glossdef> <para> An identifier is a unique value associated with a resource that clients use @@ -558,7 +559,7 @@ The identifier can be used over any connection. </glossentry> <glossentry id="glossary:Inferiors"> <glossterm>Inferiors</glossterm> - <indexterm significance="preferred"><primary>Inferiors</primary></indexterm> + <indexterm zone="glossary:Inferiors" significance="preferred"><primary>Inferiors</primary></indexterm> <glossdef> <para> The inferiors of a window are all of the subwindows nested below it: @@ -569,7 +570,7 @@ the children, the children's children, and so on. </glossentry> <glossentry id="glossary:Input_focus"> <glossterm>Input focus</glossterm> - <indexterm significance="preferred"><primary>Input focus</primary></indexterm> + <indexterm zone="glossary:Input_focus" significance="preferred"><primary>Input focus</primary></indexterm> <glossdef> <para> The input focus is normally a window defining the scope for @@ -589,7 +590,7 @@ the pointer is on at each keyboard event. </glossentry> <glossentry id="glossary:Input_manager"> <glossterm>Input manager</glossterm> - <indexterm significance="preferred"><primary>Input manager</primary></indexterm> + <indexterm zone="glossary:Input_manager" significance="preferred"><primary>Input manager</primary></indexterm> <glossdef> <para> Control over keyboard input is typically provided by an input manager client. @@ -599,7 +600,7 @@ Control over keyboard input is typically provided by an input manager client. </glossentry> <glossentry id="glossary:InputOnly_window"> <glossterm>InputOnly window</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>InputOnly</secondary></indexterm> + <indexterm zone="glossary:InputOnly_window" significance="preferred"><primary>Window</primary><secondary>InputOnly</secondary></indexterm> <glossdef> <para> An @@ -618,7 +619,7 @@ windows as inferiors. </glossentry> <glossentry id="glossary:InputOutput_window"> <glossterm>InputOutput window</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>InputOutput</secondary></indexterm> + <indexterm zone="glossary:InputOutput_window" significance="preferred"><primary>Window</primary><secondary>InputOutput</secondary></indexterm> <glossdef> <para> An @@ -636,7 +637,7 @@ windows as inferiors. </glossentry> <glossentry id="glossary:Key_grabbing"> <glossterm>Key grabbing</glossterm> - <indexterm significance="preferred"><primary>Key</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="glossary:Key_grabbing" significance="preferred"><primary>Key</primary><secondary>grabbing</secondary></indexterm> <glossdef> <para> Keys on the keyboard can be passively grabbed by a client. @@ -648,7 +649,7 @@ the keyboard is then actively grabbed by the client. </glossentry> <glossentry id="glossary:Keyboard_grabbing"> <glossterm>Keyboard grabbing</glossterm> - <indexterm significance="preferred"><primary>Keyboard</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="glossary:Keyboard_grabbing" significance="preferred"><primary>Keyboard</primary><secondary>grabbing</secondary></indexterm> <glossdef> <para> A client can actively grab control of the keyboard, and key events @@ -660,7 +661,7 @@ normally have been sent to. </glossentry> <glossentry id="glossary:Keysym"> <glossterm>Keysym</glossterm> - <indexterm significance="preferred"><primary>Keysym</primary></indexterm> + <indexterm zone="glossary:Keysym" significance="preferred"><primary>Keysym</primary></indexterm> <glossdef> <para> An encoding of a symbol on a keycap on a keyboard. @@ -670,7 +671,7 @@ An encoding of a symbol on a keycap on a keyboard. </glossentry> <glossentry id="glossary:Mapped"> <glossterm>Mapped</glossterm> - <indexterm significance="preferred"><primary>Mapped window</primary></indexterm> + <indexterm zone="glossary:Mapped" significance="preferred"><primary>Mapped window</primary></indexterm> <glossdef> <para> A window is said to be mapped if a map call has been performed on it. @@ -681,7 +682,8 @@ Unmapped windows and their inferiors are never viewable or visible. </glossentry> <glossentry id="glossary:Modifier_keys"> <glossterm>Modifier keys</glossterm> - <indexterm significance="preferred"><primary>Modifier keys</primary></indexterm> + <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, @@ -692,7 +694,7 @@ ShiftLock, and similar keys are called modifier keys. </glossentry> <glossentry id="glossary:Monochrome"> <glossterm>Monochrome</glossterm> - <indexterm significance="preferred"><primary>Monochrome</primary></indexterm> + <indexterm zone="glossary:Monochrome" significance="preferred"><primary>Monochrome</primary></indexterm> <glossdef> <para> Monochrome is a special case of @@ -704,12 +706,12 @@ in which there are only two colormap entries. </glossentry> <glossentry id="glossary:Obscure"> <glossterm>Obscure</glossterm> - <indexterm significance="preferred"><primary>Obscure</primary></indexterm> + <indexterm zone="glossary:Obscure" significance="preferred"><primary>Obscure</primary></indexterm> <glossdef> <para> A window is obscured if some other window obscures it. Window A obscures window B if both are viewable -<emphasis role='bold'>InputOutput</emphasis> +<glossterm linkend="glossary:InputOutput_window"><emphasis role='bold'>InputOutput</emphasis></glossterm> windows, A is higher in the global stacking order, and the rectangle defined by the outside edges of A intersects the rectangle defined by the outside edges of B. @@ -722,7 +724,7 @@ and that a window can be obscured and yet still have visible regions. </glossentry> <glossentry id="glossary:Occlude"> <glossterm>Occlude</glossterm> - <indexterm significance="preferred"><primary>Occlude</primary></indexterm> + <indexterm zone="glossary:Occlude" significance="preferred"><primary>Occlude</primary></indexterm> <glossdef> <para> A window is occluded if some other window occludes it. @@ -737,7 +739,7 @@ Also note that window borders are included in the calculation. </glossentry> <glossentry id="glossary:Padding"> <glossterm>Padding</glossterm> - <indexterm significance="preferred"><primary>Padding</primary></indexterm> + <indexterm zone="glossary:Padding" significance="preferred"><primary>Padding</primary></indexterm> <glossdef> <para> Some padding bytes are inserted in the data stream to maintain @@ -749,7 +751,7 @@ This increases ease of portability to some machine architectures. </glossentry> <glossentry id="glossary:Parent_window"> <glossterm>Parent window</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>parent</secondary></indexterm> + <indexterm zone="glossary:Parent_window" significance="preferred"><primary>Window</primary><secondary>parent</secondary></indexterm> <glossdef> <para> If C is a <glossterm linkend="glossary:Children">child</glossterm> of P, @@ -760,7 +762,7 @@ then P is the parent of C. </glossentry> <glossentry id="glossary:Passive_grab"> <glossterm>Passive grab</glossterm> - <indexterm significance="preferred"><primary>Passive grab</primary></indexterm> + <indexterm zone="glossary:Passive_grab" significance="preferred"><primary>Passive grab</primary></indexterm> <glossdef> <para> Grabbing a key or button is a passive grab. @@ -771,7 +773,7 @@ The grab activates when the key or button is actually pressed. </glossentry> <glossentry id="glossary:Pixel_value"> <glossterm>Pixel value</glossterm> - <indexterm significance="preferred"><primary>Pixel value</primary></indexterm> + <indexterm zone="glossary:Pixel_value" significance="preferred"><primary>Pixel value</primary></indexterm> <glossdef> <para> A pixel is an N-bit value, where N is the number of bit planes used @@ -785,7 +787,7 @@ a pixel value indexes a colormap to derive an actual color to be displayed. </glossentry> <glossentry id="glossary:Pixmap"> <glossterm>Pixmap</glossterm> - <indexterm significance="preferred"><primary>Pixmap</primary></indexterm> + <indexterm zone="glossary:Pixmap" significance="preferred"><primary>Pixmap</primary></indexterm> <glossdef> <para> A pixmap is a three-dimensional array of bits. @@ -799,7 +801,7 @@ A pixmap can also be thought of as a stack of N bitmaps. </glossentry> <glossentry id="glossary:Plane"> <glossterm>Plane</glossterm> - <indexterm significance="preferred"><primary>Plane</primary></indexterm> + <indexterm zone="glossary:Plane" significance="preferred"><primary>Plane</primary></indexterm> <glossdef> <para> When a pixmap or window is thought of as a stack of bitmaps, @@ -810,7 +812,7 @@ each bitmap is called a plane or bit plane. </glossentry> <glossentry id="glossary:Plane_mask"> <glossterm>Plane mask</glossterm> - <indexterm significance="preferred"><primary>Plane</primary><secondary>mask</secondary></indexterm> + <indexterm zone="glossary:Plane_mask" significance="preferred"><primary>Plane</primary><secondary>mask</secondary></indexterm> <glossdef> <para> Graphics operations can be restricted to only affect a subset of bit @@ -823,7 +825,7 @@ The plane mask is stored in a graphics context. </glossentry> <glossentry id="glossary:Pointer"> <glossterm>Pointer</glossterm> - <indexterm significance="preferred"><primary>Pointer</primary></indexterm> + <indexterm zone="glossary:Pointer" significance="preferred"><primary>Pointer</primary></indexterm> <glossdef> <para> The pointer is the pointing device attached to the cursor @@ -834,7 +836,7 @@ and tracked on the screens. </glossentry> <glossentry id="glossary:Pointer_grabbing"> <glossterm>Pointer grabbing</glossterm> - <indexterm significance="preferred"><primary>Pointer</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="glossary:Pointer_grabbing" significance="preferred"><primary>Pointer</primary><secondary>grabbing</secondary></indexterm> <glossdef> <para> A client can actively grab control of the pointer. @@ -846,7 +848,7 @@ rather than the client the events would normally have been sent to. </glossentry> <glossentry id="glossary:Pointing_device"> <glossterm>Pointing device</glossterm> - <indexterm significance="preferred"><primary>Pointing device</primary></indexterm> + <indexterm zone="glossary:Pointing_device" significance="preferred"><primary>Pointing device</primary></indexterm> <glossdef> <para> A pointing device is typically a mouse, tablet, or some other @@ -859,7 +861,7 @@ and it tracks whatever pointing device is attached as the pointer. </glossentry> <glossentry id="glossary:Property"> <glossterm>Property</glossterm> - <indexterm significance="preferred"><primary>Property</primary></indexterm> + <indexterm zone="glossary:Property" significance="preferred"><primary>Property</primary></indexterm> <glossdef> <para> Windows may have associated properties, @@ -874,7 +876,7 @@ hints, program names, and icon formats with a window manager. </glossentry> <glossentry id="glossary:Property_list"> <glossterm>Property list</glossterm> - <indexterm significance="preferred"><primary>Property list</primary></indexterm> + <indexterm zone="glossary:Property_list" significance="preferred"><primary>Property list</primary></indexterm> <glossdef> <para> The property list of a window is the list of properties that have @@ -885,7 +887,7 @@ been defined for the window. </glossentry> <glossentry id="glossary:PseudoColor"> <glossterm>PseudoColor</glossterm> - <indexterm significance="preferred"><primary>PseudoColor</primary></indexterm> + <indexterm zone="glossary:PseudoColor" significance="preferred"><primary>PseudoColor</primary></indexterm> <glossdef> <para> <emphasis role='bold'>PseudoColor</emphasis> @@ -899,7 +901,7 @@ The RGB values can be changed dynamically. </glossentry> <glossentry id="glossary:Redirecting_control"> <glossterm>Redirecting control</glossterm> - <indexterm significance="preferred"><primary>Redirecting control</primary></indexterm> + <indexterm zone="glossary:Redirecting_control" significance="preferred"><primary>Redirecting control</primary></indexterm> <glossdef> <para> Window managers (or client programs) may want to enforce window layout @@ -913,7 +915,7 @@ rather than the operation actually being performed. </glossentry> <glossentry id="glossary:Reply"> <glossterm>Reply</glossterm> - <indexterm significance="preferred"><primary>Reply</primary></indexterm> + <indexterm zone="glossary:Reply" significance="preferred"><primary>Reply</primary></indexterm> <glossdef> <para> Information requested by a client program is sent back to the client @@ -927,7 +929,7 @@ although some requests generate multiple replies. </glossentry> <glossentry id="glossary:Request"> <glossterm>Request</glossterm> - <indexterm significance="preferred"><primary>Request</primary></indexterm> + <indexterm zone="glossary:Request" significance="preferred"><primary>Request</primary></indexterm> <glossdef> <para> A command to the server is called a request. @@ -938,7 +940,7 @@ It is a single block of data sent over a connection. </glossentry> <glossentry id="glossary:Resource"> <glossterm>Resource</glossterm> - <indexterm significance="preferred"><primary>Resource</primary></indexterm> + <indexterm zone="glossary:Resource" significance="preferred"><primary>Resource</primary></indexterm> <glossdef> <para> Windows, pixmaps, cursors, fonts, graphics contexts, and colormaps are @@ -952,7 +954,7 @@ over which the resource was created. </glossentry> <glossentry id="glossary:RGB_values"> <glossterm>RGB values</glossterm> - <indexterm significance="preferred"><primary>RGB values</primary></indexterm> + <indexterm zone="glossary:RGB_values" significance="preferred"><primary>RGB values</primary></indexterm> <glossdef> <para> Red, green, and blue (RGB) intensity values are used to define color. @@ -965,7 +967,7 @@ The server scales the values to match the display hardware. </glossentry> <glossentry id="glossary:Root"> <glossterm>Root</glossterm> - <indexterm significance="preferred"><primary>Root</primary></indexterm> + <indexterm zone="glossary:Root" significance="preferred"><primary>Root</primary></indexterm> <glossdef> <para> The root of a pixmap, colormap, or graphics context is the same as the root of @@ -978,7 +980,7 @@ The root of a window is the root window under which the window was created. </glossentry> <glossentry id="glossary:Root_window"> <glossterm>Root window</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>root</secondary></indexterm> + <indexterm zone="glossary:Root_window" significance="preferred"><primary>Window</primary><secondary>root</secondary></indexterm> <glossdef> <para> Each screen has a root window covering it. @@ -991,7 +993,7 @@ A root window has no parent. </glossentry> <glossentry id="glossary:Save_set"> <glossterm>Save set</glossterm> - <indexterm significance="preferred"><primary>Save set</primary></indexterm> + <indexterm zone="glossary:Save_set" significance="preferred"><primary>Save set</primary></indexterm> <glossdef> <para> The save set of a client is a list of other clients' windows that, @@ -1005,7 +1007,7 @@ lost windows if the manager terminates abnormally. </glossentry> <glossentry id="glossary:Scanline"> <glossterm>Scanline</glossterm> - <indexterm significance="preferred"><primary>Scanline</primary></indexterm> + <indexterm zone="glossary:Scanline" significance="preferred"><primary>Scanline</primary></indexterm> <glossdef> <para> A scanline is a list of pixel or bit values viewed as a horizontal @@ -1017,7 +1019,7 @@ values ordered by increasing x coordinate. </glossentry> <glossentry id="glossary:Scanline_order"> <glossterm>Scanline order</glossterm> - <indexterm significance="preferred"><primary>Scanline order</primary></indexterm> + <indexterm zone="glossary:Scanline_order" significance="preferred"><primary>Scanline order</primary></indexterm> <glossdef> <para> An image represented in scanline order contains scanlines ordered by @@ -1028,7 +1030,7 @@ increasing y coordinate. </glossentry> <glossentry id="glossary:Screen"> <glossterm>Screen</glossterm> - <indexterm significance="preferred"><primary>Screen</primary></indexterm> + <indexterm zone="glossary:Screen" significance="preferred"><primary>Screen</primary></indexterm> <glossdef> <para> A server can provide several independent screens, @@ -1041,7 +1043,7 @@ and pointer shared among the screens. </glossentry> <glossentry id="glossary:Selection"> <glossterm>Selection</glossterm> - <indexterm significance="preferred"><primary>Selection</primary></indexterm> + <indexterm zone="glossary:Selection" significance="preferred"><primary>Selection</primary></indexterm> <glossdef> <para> A selection can be thought of as an indirect property with dynamic @@ -1070,7 +1072,7 @@ The protocol does not constrain the semantics. </glossentry> <glossentry id="glossary:Server"> <glossterm>Server</glossterm> - <indexterm significance="preferred"><primary>Server</primary></indexterm> + <indexterm zone="glossary:Server" significance="preferred"><primary>Server</primary></indexterm> <glossdef> <para> The server provides the basic windowing mechanism. @@ -1083,7 +1085,7 @@ and demultiplexes input back to the appropriate clients. </glossentry> <glossentry id="glossary:Server_grabbing"> <glossterm>Server grabbing</glossterm> - <indexterm significance="preferred"><primary>Server</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="glossary:Server_grabbing" significance="preferred"><primary>Server</primary><secondary>grabbing</secondary></indexterm> <glossdef> <para> The server can be grabbed by a single client for exclusive use. @@ -1098,7 +1100,7 @@ indivisibly. </glossentry> <glossentry id="glossary:Sibling"> <glossterm>Sibling</glossterm> - <indexterm significance="preferred"><primary>Sibling</primary></indexterm> + <indexterm zone="glossary:Sibling" significance="preferred"><primary>Sibling</primary></indexterm> <glossdef> <para> Children of the same parent window are known as sibling windows. @@ -1108,7 +1110,7 @@ Children of the same parent window are known as sibling windows. </glossentry> <glossentry id="glossary:Stacking_order"> <glossterm>Stacking order</glossterm> - <indexterm significance="preferred"><primary>Stacking order</primary></indexterm> + <indexterm zone="glossary:Stacking_order" significance="preferred"><primary>Stacking order</primary></indexterm> <glossdef> <para> Sibling windows may stack on top of each other. @@ -1121,7 +1123,7 @@ The relationship between sibling windows is known as the stacking order. </glossentry> <glossentry id="glossary:StaticColor"> <glossterm>StaticColor</glossterm> - <indexterm significance="preferred"><primary>StaticColor</primary></indexterm> + <indexterm zone="glossary:StaticColor" significance="preferred"><primary>StaticColor</primary></indexterm> <glossdef> <para> <emphasis role='bold'>StaticColor</emphasis> @@ -1134,7 +1136,7 @@ in which the RGB values are predefined and read-only. </glossentry> <glossentry id="glossary:StaticGray"> <glossterm>StaticGray</glossterm> - <indexterm significance="preferred"><primary>StaticGray</primary></indexterm> + <indexterm zone="glossary:StaticGray" significance="preferred"><primary>StaticGray</primary></indexterm> <glossdef> <para> <emphasis role='bold'>StaticGray</emphasis> @@ -1148,7 +1150,7 @@ The values are typically linear or near-linear increasing ramps. </glossentry> <glossentry id="glossary:Stipple"> <glossterm>Stipple</glossterm> - <indexterm significance="preferred"><primary>Stipple</primary></indexterm> + <indexterm zone="glossary:Stipple" significance="preferred"><primary>Stipple</primary></indexterm> <glossdef> <para> A stipple pattern is a bitmap that is used to tile a region that will serve @@ -1160,7 +1162,7 @@ color. </glossentry> <glossentry id="glossary:String_Equivalence"> <glossterm>String Equivalence</glossterm> - <indexterm significance="preferred"><primary>String Equivalence</primary></indexterm> + <indexterm zone="glossary:String_Equivalence" significance="preferred"><primary>String Equivalence</primary></indexterm> <glossdef> <para> Two ISO Latin-1 STRING8 values are considered equal if they are the same @@ -1179,7 +1181,7 @@ are pairwise equivalent to decimal values 246 to 254 inclusive </glossentry> <glossentry id="glossary:Tile"> <glossterm>Tile</glossterm> - <indexterm significance="preferred"><primary>Tile</primary></indexterm> + <indexterm zone="glossary:Tile" significance="preferred"><primary>Tile</primary></indexterm> <glossdef> <para> A pixmap can be replicated in two dimensions to tile a region. @@ -1190,7 +1192,8 @@ The pixmap itself is also known as a tile. </glossentry> <glossentry id="glossary:Timestamp"> <glossterm>Timestamp</glossterm> - <indexterm significance="preferred"><primary>Timestamp</primary></indexterm> + <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. @@ -1212,7 +1215,7 @@ server time. </glossentry> <glossentry id="glossary:TrueColor"> <glossterm>TrueColor</glossterm> - <indexterm significance="preferred"><primary>TrueColor</primary></indexterm> + <indexterm zone="glossary:TrueColor" significance="preferred"><primary>TrueColor</primary></indexterm> <glossdef> <para> <emphasis role='bold'>TrueColor</emphasis> @@ -1228,7 +1231,7 @@ The values are typically linear or near-linear increasing ramps. </glossentry> <glossentry id="glossary:Type"> <glossterm>Type</glossterm> - <indexterm significance="preferred"><primary>Type</primary></indexterm> + <indexterm zone="glossary:Type" significance="preferred"><primary>Type</primary></indexterm> <glossdef> <para> A type is an arbitrary atom used to identify the interpretation of @@ -1241,7 +1244,7 @@ and are solely for the benefit of clients. </glossentry> <glossentry id="glossary:Viewable"> <glossterm>Viewable</glossterm> - <indexterm significance="preferred"><primary>Viewable</primary></indexterm> + <indexterm zone="glossary:Viewable" significance="preferred"><primary>Viewable</primary></indexterm> <glossdef> <para> A window is viewable if it and all of its ancestors are mapped. @@ -1255,7 +1258,7 @@ backing store. </glossentry> <glossentry id="glossary:Visible"> <glossterm>Visible</glossterm> - <indexterm significance="preferred"><primary>Visible</primary></indexterm> + <indexterm zone="glossary:Visible" significance="preferred"><primary>Visible</primary></indexterm> <glossdef> <para> A region of a window is visible if someone looking at the screen can @@ -1268,7 +1271,7 @@ other window. </glossentry> <glossentry id="glossary:Window_gravity"> <glossterm>Window gravity</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>gravity</secondary></indexterm> + <indexterm zone="glossary:Window_gravity" significance="preferred"><primary>Window</primary><secondary>gravity</secondary></indexterm> <glossdef> <para> When windows are resized, @@ -1282,7 +1285,7 @@ as window gravity. </glossentry> <glossentry id="glossary:Window_manager"> <glossterm>Window manager</glossterm> - <indexterm significance="preferred"><primary>Window</primary><secondary>manager</secondary></indexterm> + <indexterm zone="glossary:Window_manager" significance="preferred"><primary>Window</primary><secondary>manager</secondary></indexterm> <glossdef> <para> Manipulation of windows on the screen and much of the user interface @@ -1293,7 +1296,7 @@ Manipulation of windows on the screen and much of the user interface </glossentry> <glossentry id="glossary:XYFormat"> <glossterm>XYFormat</glossterm> - <indexterm significance="preferred"><primary>XYFormat</primary></indexterm> + <indexterm zone="glossary:XYFormat" significance="preferred"><primary>XYFormat</primary></indexterm> <glossdef> <para> The data for a pixmap is said to be in XY format if it is organized as @@ -1305,7 +1308,7 @@ appearing from most-significant to least-significant in bit order. </glossentry> <glossentry id="glossary:ZFormat"> <glossterm>ZFormat</glossterm> - <indexterm significance="preferred"><primary>ZFormat</primary></indexterm> + <indexterm zone="glossary:ZFormat" significance="preferred"><primary>ZFormat</primary></indexterm> <glossdef> <para> The data for a pixmap is said to be in Z format if it is organized as diff --git a/proto/x11proto/specs/keysyms.xml b/proto/x11proto/specs/keysyms.xml index 0b457ae53..0ef4ac062 100644 --- a/proto/x11proto/specs/keysyms.xml +++ b/proto/x11proto/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 @@ -40,9 +42,9 @@ There are six categories of KEYSYM values. <title>Special KEYSYMs</title> <para> There are two special values: -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> and -<emphasis role='bold'>VoidSymbol</emphasis>. +<keysym>VoidSymbol</keysym>. They are used to indicate the absence of symbols (see <link linkend="keyboards">Section 5, Keyboards</link>). </para> @@ -72,7 +74,7 @@ They are used to indicate the absence of symbols (see <entry>0</entry> <entry>0</entry> <entry>#x00000000</entry> - <entry><emphasis role='bold'>NoSymbol</emphasis></entry> + <entry><keysym>NoSymbol</keysym></entry> </row> <row rowsep="0"> <entry>0</entry> @@ -80,7 +82,7 @@ They are used to indicate the absence of symbols (see <entry>255</entry> <entry>255</entry> <entry>#x00FFFFFF</entry> - <entry><emphasis role='bold'>VoidSymbol</emphasis></entry> + <entry><keysym>VoidSymbol</keysym></entry> </row> </tbody> </tgroup> @@ -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/proto/x11proto/specs/sect1-9.xml b/proto/x11proto/specs/sect1-9.xml index 91e3cac98..78c53e5be 100644 --- a/proto/x11proto/specs/sect1-9.xml +++ b/proto/x11proto/specs/sect1-9.xml @@ -79,12 +79,12 @@ X Consortium, Inc. <section id="request_format"> <title>Request Format</title> - <indexterm significance="preferred"><primary>Request</primary><secondary>format</secondary></indexterm> + <indexterm zone="request_format" significance="preferred"><primary>Request</primary><secondary>format</secondary></indexterm> <para> -Every request contains an 8-bit <firstterm>major opcode</firstterm> -<indexterm significance="preferred"><primary>Opcode</primary><secondary>major</secondary></indexterm> -and a 16-bit <firstterm>length field</firstterm> -<indexterm significance="preferred"><primary>Request</primary><secondary>length</secondary></indexterm> +Every request contains an 8-bit <firstterm id="major_opcode">major opcode</firstterm> +<indexterm zone="major_opcode" significance="preferred"><primary>Opcode</primary><secondary>major</secondary></indexterm> +and a 16-bit <firstterm id="request_length">length field</firstterm> +<indexterm zone="request_length" significance="preferred"><primary>Request</primary><secondary>length</secondary></indexterm> expressed in units of four bytes. Every request consists of four bytes of a header (containing the major opcode, the length field, and a data byte) @@ -95,25 +95,26 @@ the request. If the specified length is smaller or larger than the required length, an error is generated. Unused bytes in a request are not required to be zero. -Major opcodes 128 through 255 are reserved for extensions. -<indexterm><primary>Extension</primary></indexterm> +Major opcodes 128 through 255 are reserved for +<firstterm id="extension">extensions</firstterm>. +<indexterm zone="extension"><primary>Extension</primary></indexterm> Extensions are intended to contain multiple requests, -so extension requests typically have an additional <firstterm>minor -opcode</firstterm> encoded +so extension requests typically have an additional +<firstterm id="minor_opcode">minor opcode</firstterm> encoded in the second data byte in the request header. -<indexterm significance="preferred"><primary>Opcode</primary><secondary>minor</secondary></indexterm> +<indexterm zone="minor_opcode" significance="preferred"><primary>Opcode</primary><secondary>minor</secondary></indexterm> However, the placement and interpretation of this minor opcode and of all other fields in extension requests are not defined by the core protocol. Every request on a given connection is implicitly assigned a -<firstterm>sequence number</firstterm>, -<indexterm significance="preferred"><primary>Sequence number</primary></indexterm> +<firstterm id="sequence_number">sequence number</firstterm>, +<indexterm zone="sequence_number" significance="preferred"><primary>Sequence number</primary></indexterm> starting with one, that is used in replies, errors, and events. </para> </section> <section id="reply_format"> <title>Reply Format</title> - <indexterm significance="preferred"><primary>Reply</primary><secondary>format</secondary></indexterm> + <indexterm zone="reply_format" significance="preferred"><primary>Reply</primary><secondary>format</secondary></indexterm> <para> Every <firstterm>reply</firstterm> contains a 32-bit length field expressed in units of four bytes. @@ -127,13 +128,15 @@ of the corresponding request. <section id="error_format"> <title>Error Format</title> - <indexterm significance="preferred"><primary>Error report</primary><secondary>format</secondary></indexterm> + <indexterm zone="error_format" significance="preferred"><primary>Error report</primary><secondary>format</secondary></indexterm> <para> Error reports are 32 bytes long. Every error includes an 8-bit error code. +<phrase id="errors:extensions"> Error codes 128 through 255 are reserved for extensions. -<indexterm significance="preferred"><primary>Error Codes</primary><secondary>extensions</secondary></indexterm> -<indexterm significance="preferred"><primary>Extension</primary><secondary>error codes</secondary></indexterm> +</phrase> +<indexterm zone="errors:extensions" significance="preferred"><primary>Error Codes</primary><secondary>extensions</secondary></indexterm> +<indexterm zone="errors:extensions" significance="preferred"><primary>Extension</primary><secondary>error codes</secondary></indexterm> Every error also includes the major and minor opcodes of the failed request and the least significant 16 bits of the sequence number of the request. For the following errors (see <link linkend="errors">section 4</link>), @@ -160,7 +163,7 @@ Unused bytes within an error are not guaranteed to be zero. <section id="event_format"> <title>Event Format</title> - <indexterm significance="preferred"><primary>Event</primary><secondary>format</secondary></indexterm> + <indexterm zone="event_format" significance="preferred"><primary>Event</primary><secondary>format</secondary></indexterm> <para> <firstterm>Events</firstterm> are 32 bytes long. Unused bytes within an event are not guaranteed to be zero. @@ -168,10 +171,12 @@ Every event contains an 8-bit type code. The most significant bit in this code is set if the event was generated from a <link linkend="requests:SendEvent"><emphasis role='bold'>SendEvent</emphasis></link> request. +<phrase id="events:extensions"> Event codes 64 through 127 are reserved for extensions, although the core protocol does not define a mechanism for selecting interest in such events. -<indexterm significance="preferred"><primary>Event</primary><secondary>extension</secondary></indexterm> -<indexterm significance="preferred"><primary>Extension</primary><secondary>event</secondary></indexterm> +</phrase> +<indexterm zone="events:extensions" significance="preferred"><primary>Event</primary><secondary>extension</secondary></indexterm> +<indexterm zone="events:extensions" significance="preferred"><primary>Extension</primary><secondary>event</secondary></indexterm> Every core event (with the exception of <link linkend="events:KeymapNotify"><emphasis role='bold'>KeymapNotify</emphasis></link>) also contains the least significant 16 bits of the sequence number of the last @@ -212,10 +217,6 @@ are capitalized. <para> Requests in <link linkend="requests">section 9</link> are described in the following format: - </para> - </listitem> - <listitem> - <para> <literallayout class="monospaced"> <emphasis role='bold'>RequestName</emphasis> <emphasis remap='I'>arg1</emphasis>: type1 @@ -231,8 +232,6 @@ in the following format: Description. </literallayout> </para> - </listitem> - <listitem> <para> If no ▶ is present in the description, then the request has no reply (it is asynchronous), @@ -245,10 +244,6 @@ then one or more replies can be generated for a single request. <para> Events in <link linkend="events">section 11</link> are described in the following format: - </para> - </listitem> - <listitem> - <para> <literallayout class="monospaced"> <emphasis role='bold'>EventName</emphasis> <emphasis remap='I'>value1</emphasis>: type1 @@ -279,7 +274,7 @@ in the following format: </thead> <tbody> <row rowsep="0"> - <entry>LISTofFOO<indexterm significance="preferred"><primary>Types</primary><secondary>LISTofFOO</secondary></indexterm></entry> + <entry id="types:LISTofFOO">LISTofFOO<indexterm zone="types:LISTofFOO" significance="preferred"><primary>Types</primary><secondary>LISTofFOO</secondary></indexterm></entry> <entry> A type name of the form LISTofFOO means a counted list of elements of type @@ -292,7 +287,7 @@ zero-length lists are legal. </entry> </row> <row rowsep="0"> - <entry><para>BITMASK<indexterm significance="preferred"><primary>Types</primary><secondary>BITMASK</secondary></indexterm></para><para>LISTofVALUE<indexterm significance="preferred"><primary>Types</primary><secondary>LISTofVALUE</secondary></indexterm></para></entry> + <entry><para id="types:BITMASK">BITMASK<indexterm zone="types:BITMASK" significance="preferred"><primary>Types</primary><secondary>BITMASK</secondary></indexterm></para><para id="types:LISTofVALUE">LISTofVALUE<indexterm zone="types:LISTofVALUE" significance="preferred"><primary>Types</primary><secondary>LISTofVALUE</secondary></indexterm></para></entry> <entry> <para> The types BITMASK and LISTofVALUE are somewhat special. @@ -323,90 +318,90 @@ The values of the unused bytes do not matter. </entry> </row> <row rowsep="0"> - <entry>OR<indexterm significance="preferred"><primary>Types</primary><secondary>OR</secondary></indexterm></entry> + <entry id="types:OR">OR<indexterm zone="types:OR" significance="preferred"><primary>Types</primary><secondary>OR</secondary></indexterm></entry> <entry> A type of the form "T1 or ... or Tn" means the union of the indicated types. A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>WINDOW<indexterm significance="preferred"><primary>Types</primary><secondary>WINDOW</secondary></indexterm></entry> + <entry id="types:WINDOW">WINDOW<indexterm zone="types:WINDOW" significance="preferred"><primary>Types</primary><secondary>WINDOW</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>PIXMAP<indexterm significance="preferred"><primary>Types</primary><secondary>PIXMAP</secondary></indexterm></entry> + <entry id="types:PIXMAP">PIXMAP<indexterm zone="types:PIXMAP" significance="preferred"><primary>Types</primary><secondary>PIXMAP</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>CURSOR<indexterm significance="preferred"><primary>Types</primary><secondary>CURSOR</secondary></indexterm></entry> + <entry id="types:CURSOR">CURSOR<indexterm zone="types:CURSOR" significance="preferred"><primary>Types</primary><secondary>CURSOR</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>FONT<indexterm significance="preferred"><primary>Types</primary><secondary>FONT</secondary></indexterm></entry> + <entry id="types:FONT">FONT<indexterm zone="types:FONT" significance="preferred"><primary>Types</primary><secondary>FONT</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>GCONTEXT<indexterm significance="preferred"><primary>Types</primary><secondary>GCONTEXT</secondary></indexterm></entry> + <entry id="types:GCONTEXT">GCONTEXT<indexterm zone="types:GCONTEXT" significance="preferred"><primary>Types</primary><secondary>GCONTEXT</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>COLORMAP<indexterm significance="preferred"><primary>Types</primary><secondary>COLORMAP</secondary></indexterm></entry> + <entry id="types:COLORMAP">COLORMAP<indexterm zone="types:COLORMAP" significance="preferred"><primary>Types</primary><secondary>COLORMAP</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>DRAWABLE<indexterm significance="preferred"><primary>Types</primary><secondary>DRAWABLE</secondary></indexterm></entry> + <entry id="types:DRAWABLE">DRAWABLE<indexterm zone="types:DRAWABLE" significance="preferred"><primary>Types</primary><secondary>DRAWABLE</secondary></indexterm></entry> <entry>WINDOW or PIXMAP</entry> </row> <row rowsep="0"> - <entry>FONTABLE<indexterm significance="preferred"><primary>Types</primary><secondary>FONTABLE</secondary></indexterm></entry> + <entry id="types:FONTABLE">FONTABLE<indexterm zone="types:FONTABLE" significance="preferred"><primary>Types</primary><secondary>FONTABLE</secondary></indexterm></entry> <entry>FONT or GCONTEXT</entry> </row> <row rowsep="0"> - <entry>ATOM<indexterm significance="preferred"><primary>Types</primary><secondary>ATOM</secondary></indexterm></entry> + <entry id="types:ATOM">ATOM<indexterm zone="types:ATOM" significance="preferred"><primary>Types</primary><secondary>ATOM</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>VISUALID<indexterm significance="preferred"><primary>Types</primary><secondary>VISUALID</secondary></indexterm></entry> + <entry id="types:VISUALID">VISUALID<indexterm zone="types:VISUALID" significance="preferred"><primary>Types</primary><secondary>VISUALID</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>VALUE<indexterm significance="preferred"><primary>Types</primary><secondary>VALUE</secondary></indexterm></entry> + <entry id="types:VALUE">VALUE<indexterm zone="types:VALUE" significance="preferred"><primary>Types</primary><secondary>VALUE</secondary></indexterm></entry> <entry>32-bit quantity (used only in LISTofVALUE)</entry> </row> <row rowsep="0"> - <entry>BYTE<indexterm significance="preferred"><primary>Types</primary><secondary>BYTE</secondary></indexterm></entry> + <entry id="types:BYTE">BYTE<indexterm zone="types:BYTE" significance="preferred"><primary>Types</primary><secondary>BYTE</secondary></indexterm></entry> <entry>8-bit value</entry> </row> <row rowsep="0"> - <entry>INT8<indexterm significance="preferred"><primary>Types</primary><secondary>INT8</secondary></indexterm></entry> + <entry id="types:INT8">INT8<indexterm zone="types:INT8" significance="preferred"><primary>Types</primary><secondary>INT8</secondary></indexterm></entry> <entry>8-bit signed integer</entry> </row> <row rowsep="0"> - <entry>INT16<indexterm significance="preferred"><primary>Types</primary><secondary>INT16</secondary></indexterm></entry> + <entry id="types:INT16">INT16<indexterm zone="types:INT16" significance="preferred"><primary>Types</primary><secondary>INT16</secondary></indexterm></entry> <entry>16-bit signed integer</entry> </row> <row rowsep="0"> - <entry>INT32<indexterm significance="preferred"><primary>Types</primary><secondary>INT32</secondary></indexterm></entry> + <entry id="types:INT32">INT32<indexterm zone="types:INT32" significance="preferred"><primary>Types</primary><secondary>INT32</secondary></indexterm></entry> <entry>32-bit signed integer</entry> </row> <row rowsep="0"> - <entry>CARD8<indexterm significance="preferred"><primary>Types</primary><secondary>CARD8</secondary></indexterm></entry> + <entry id="types:CARD8">CARD8<indexterm zone="types:CARD8" significance="preferred"><primary>Types</primary><secondary>CARD8</secondary></indexterm></entry> <entry>8-bit unsigned integer</entry> </row> <row rowsep="0"> - <entry>CARD16<indexterm significance="preferred"><primary>Types</primary><secondary>CARD16</secondary></indexterm></entry> + <entry id="types:CARD16">CARD16<indexterm zone="types:CARD16" significance="preferred"><primary>Types</primary><secondary>CARD16</secondary></indexterm></entry> <entry>16-bit unsigned integer</entry> </row> <row rowsep="0"> - <entry>CARD32<indexterm significance="preferred"><primary>Types</primary><secondary>CARD32</secondary></indexterm></entry> + <entry id="types:CARD32">CARD32<indexterm zone="types:CARD32" significance="preferred"><primary>Types</primary><secondary>CARD32</secondary></indexterm></entry> <entry>32-bit unsigned integer</entry> </row> <row rowsep="0"> - <entry>TIMESTAMP<indexterm significance="preferred"><primary>Types</primary><secondary>TIMESTAMP</secondary></indexterm></entry> + <entry id="types:TIMESTAMP">TIMESTAMP<indexterm zone="types:TIMESTAMP" significance="preferred"><primary>Types</primary><secondary>TIMESTAMP</secondary></indexterm></entry> <entry>CARD32</entry> </row> <row rowsep="0"> - <entry>BITGRAVITY<indexterm significance="preferred"><primary>Types</primary><secondary>BITGRAVITY</secondary></indexterm></entry> + <entry id="types:BITGRAVITY">BITGRAVITY<indexterm zone="types:BITGRAVITY" significance="preferred"><primary>Types</primary><secondary>BITGRAVITY</secondary></indexterm></entry> <entry> { <emphasis role='bold'>Forget</emphasis>, <emphasis role='bold'>Static</emphasis>, @@ -422,7 +417,7 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>WINGRAVITY<indexterm significance="preferred"><primary>Types</primary><secondary>WINGRAVITY</secondary></indexterm></entry> + <entry id="types:WINGRAVITY">WINGRAVITY<indexterm zone="types:WINGRAVITY" significance="preferred"><primary>Types</primary><secondary>WINGRAVITY</secondary></indexterm></entry> <entry> { <emphasis role='bold'>Unmap</emphasis>, <emphasis role='bold'>Static</emphasis>, @@ -438,14 +433,14 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>BOOL<indexterm significance="preferred"><primary>Types</primary><secondary>BOOL</secondary></indexterm></entry> + <entry id="types:BOOL">BOOL<indexterm zone="types:BOOL" significance="preferred"><primary>Types</primary><secondary>BOOL</secondary></indexterm></entry> <entry> { <emphasis role='bold'>True</emphasis>, <emphasis role='bold'>False</emphasis> } </entry> </row> <row rowsep="0"> - <entry>EVENT<indexterm significance="preferred"><primary>Types</primary><secondary>EVENT</secondary></indexterm></entry> + <entry id="types:EVENT">EVENT<indexterm zone="types:EVENT" significance="preferred"><primary>Types</primary><secondary>EVENT</secondary></indexterm></entry> <entry> { <emphasis role='bold'>KeyPress</emphasis>, <emphasis role='bold'>KeyRelease</emphasis>, @@ -475,7 +470,7 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>POINTEREVENT<indexterm significance="preferred"><primary>Types</primary><secondary>POINTEREVENT</secondary></indexterm></entry> + <entry id="types:POINTEREVENT">POINTEREVENT<indexterm zone="types:POINTEREVENT" significance="preferred"><primary>Types</primary><secondary>POINTEREVENT</secondary></indexterm></entry> <entry> { <emphasis role='bold'>ButtonPress</emphasis>, <emphasis role='bold'>ButtonRelease</emphasis>, @@ -493,7 +488,7 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>DEVICEEVENT<indexterm significance="preferred"><primary>Types</primary><secondary>DEVICEEVENT</secondary></indexterm></entry> + <entry id="types:DEVICEEVENT">DEVICEEVENT<indexterm zone="types:DEVICEEVENT" significance="preferred"><primary>Types</primary><secondary>DEVICEEVENT</secondary></indexterm></entry> <entry> { <emphasis role='bold'>KeyPress</emphasis>, <emphasis role='bold'>KeyRelease</emphasis>, @@ -509,19 +504,19 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>KEYSYM<indexterm significance="preferred"><primary>Types</primary><secondary>KEYSYM</secondary></indexterm></entry> + <entry id="types:KEYSYM">KEYSYM<indexterm zone="types:KEYSYM" significance="preferred"><primary>Types</primary><secondary>KEYSYM</secondary></indexterm></entry> <entry>32-bit value (top three bits guaranteed to be zero)</entry> </row> <row rowsep="0"> - <entry>KEYCODE<indexterm significance="preferred"><primary>Types</primary><secondary>KEYCODE</secondary></indexterm></entry> + <entry id="types:KEYCODE">KEYCODE<indexterm zone="types:KEYCODE" significance="preferred"><primary>Types</primary><secondary>KEYCODE</secondary></indexterm></entry> <entry>CARD8</entry> </row> <row rowsep="0"> - <entry>BUTTON<indexterm significance="preferred"><primary>Types</primary><secondary>BUTTON</secondary></indexterm></entry> + <entry id="types:BUTTON">BUTTON<indexterm zone="types:BUTTON" significance="preferred"><primary>Types</primary><secondary>BUTTON</secondary></indexterm></entry> <entry>CARD8</entry> </row> <row rowsep="0"> - <entry>KEYMASK<indexterm significance="preferred"><primary>Types</primary><secondary>KEYMASK</secondary></indexterm></entry> + <entry id="types:KEYMASK">KEYMASK<indexterm zone="types:KEYMASK" significance="preferred"><primary>Types</primary><secondary>KEYMASK</secondary></indexterm></entry> <entry> { <emphasis role='bold'>Shift</emphasis>, <emphasis role='bold'>Lock</emphasis>, @@ -534,7 +529,7 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>BUTMASK<indexterm significance="preferred"><primary>Types</primary><secondary>BUTMASK</secondary></indexterm></entry> + <entry id="types:BUTMASK">BUTMASK<indexterm zone="types:BUTMASK" significance="preferred"><primary>Types</primary><secondary>BUTMASK</secondary></indexterm></entry> <entry> { <emphasis role='bold'>Button1</emphasis>, <emphasis role='bold'>Button2</emphasis>, @@ -544,34 +539,34 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>KEYBUTMASK<indexterm significance="preferred"><primary>Types</primary><secondary>KEYBUTMASK</secondary></indexterm></entry> + <entry id="types:KEYBUTMASK">KEYBUTMASK<indexterm zone="types:KEYBUTMASK" significance="preferred"><primary>Types</primary><secondary>KEYBUTMASK</secondary></indexterm></entry> <entry>KEYMASK or BUTMASK</entry> </row> <row rowsep="0"> - <entry>STRING8<indexterm significance="preferred"><primary>Types</primary><secondary>STRING8</secondary></indexterm></entry> + <entry id="types:STRING8">STRING8<indexterm zone="types:STRING8" significance="preferred"><primary>Types</primary><secondary>STRING8</secondary></indexterm></entry> <entry>LISTofCARD8</entry> </row> <row rowsep="0"> - <entry>STRING16<indexterm significance="preferred"><primary>Types</primary><secondary>STRING16</secondary></indexterm></entry> + <entry id="types:STRING16">STRING16<indexterm zone="types:STRING16" significance="preferred"><primary>Types</primary><secondary>STRING16</secondary></indexterm></entry> <entry>LISTofCHAR2B</entry> </row> <row rowsep="0"> - <entry>CHAR2B<indexterm significance="preferred"><primary>Types</primary><secondary>CHAR2B</secondary></indexterm></entry> + <entry id="types:CHAR2B">CHAR2B<indexterm zone="types:CHAR2B" significance="preferred"><primary>Types</primary><secondary>CHAR2B</secondary></indexterm></entry> <entry>[byte1, byte2: CARD8]</entry> </row> <row rowsep="0"> - <entry>POINT<indexterm significance="preferred"><primary>Types</primary><secondary>POINT</secondary></indexterm></entry> + <entry id="types:POINT">POINT<indexterm zone="types:POINT" significance="preferred"><primary>Types</primary><secondary>POINT</secondary></indexterm></entry> <entry>[x, y: INT16]</entry> </row> <row rowsep="0"> - <entry>RECTANGLE<indexterm significance="preferred"><primary>Types</primary><secondary>RECTANGLE</secondary></indexterm></entry> + <entry id="types:RECTANGLE">RECTANGLE<indexterm zone="types:RECTANGLE" significance="preferred"><primary>Types</primary><secondary>RECTANGLE</secondary></indexterm></entry> <entry> <para>[x, y: INT16,</para> <para>width, height: CARD16]</para> </entry> </row> <row rowsep="0"> - <entry>ARC<indexterm significance="preferred"><primary>Types</primary><secondary>ARC</secondary></indexterm></entry> + <entry id="types:ARC">ARC<indexterm zone="types:ARC" significance="preferred"><primary>Types</primary><secondary>ARC</secondary></indexterm></entry> <entry> <para>[x, y: INT16,</para> <para>width, height: CARD16,</para> @@ -579,7 +574,7 @@ A single-element type is given as the element without enclosing braces. </entry> </row> <row rowsep="0"> - <entry>HOST<indexterm significance="preferred"><primary>Types</primary><secondary>HOST</secondary></indexterm></entry> + <entry id="types:HOST">HOST<indexterm zone="types:HOST" significance="preferred"><primary>Types</primary><secondary>HOST</secondary></indexterm></entry> <entry> <para> [family: @@ -659,7 +654,7 @@ The following error codes result from various requests as follows: </thead> <tbody> <row rowsep="0"> - <entry><emphasis role='bold'>Access</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Access</secondary></indexterm></entry> + <entry id="errors:Access"><emphasis role='bold'>Access</emphasis><indexterm zone="errors:Access" significance="preferred"><primary>Error Codes</primary><secondary>Access</secondary></indexterm></entry> <entry> An attempt is made to grab a key/button combination already grabbed by another client. @@ -673,7 +668,7 @@ select at a time when another client has already selected it. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Alloc</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Alloc</secondary></indexterm></entry> + <entry id="errors:Alloc"><emphasis role='bold'>Alloc</emphasis><indexterm zone="errors:Alloc" significance="preferred"><primary>Error Codes</primary><secondary>Alloc</secondary></indexterm></entry> <entry> The server failed to allocate the requested resource. Note that the explicit listing of @@ -690,32 +685,32 @@ or discard them. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Atom</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Atom</secondary></indexterm></entry> + <entry id="errors:Atom"><emphasis role='bold'>Atom</emphasis><indexterm zone="errors:Atom" significance="preferred"><primary>Error Codes</primary><secondary>Atom</secondary></indexterm></entry> <entry> A value for an ATOM argument does not name a defined ATOM. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Colormap</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Colormap</secondary></indexterm></entry> + <entry id="errors:Colormap"><emphasis role='bold'>Colormap</emphasis><indexterm zone="errors:Colormap" significance="preferred"><primary>Error Codes</primary><secondary>Colormap</secondary></indexterm></entry> <entry> A value for a COLORMAP argument does not name a defined COLORMAP. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Cursor</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Cursor</secondary></indexterm></entry> + <entry id="errors:Cursor"><emphasis role='bold'>Cursor</emphasis><indexterm zone="errors:Cursor" significance="preferred"><primary>Error Codes</primary><secondary>Cursor</secondary></indexterm></entry> <entry> A value for a CURSOR argument does not name a defined CURSOR. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Drawable</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Drawable</secondary></indexterm></entry> + <entry id="errors:Drawable"><emphasis role='bold'>Drawable</emphasis><indexterm zone="errors:Drawable" significance="preferred"><primary>Error Codes</primary><secondary>Drawable</secondary></indexterm></entry> <entry> A value for a DRAWABLE argument does not name a defined WINDOW or PIXMAP. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Font</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Font</secondary></indexterm></entry> + <entry id="errors:Font"><emphasis role='bold'>Font</emphasis><indexterm zone="errors:Font" significance="preferred"><primary>Error Codes</primary><secondary>Font</secondary></indexterm></entry> <entry> A value for a FONT argument does not name a defined FONT. A value for a FONTABLE argument does not name a defined FONT or a @@ -723,20 +718,20 @@ defined GCONTEXT. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>GContext</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>GContext</secondary></indexterm></entry> + <entry id="errors:GContext"><emphasis role='bold'>GContext</emphasis><indexterm zone="errors:GContext" significance="preferred"><primary>Error Codes</primary><secondary>GContext</secondary></indexterm></entry> <entry> A value for a GCONTEXT argument does not name a defined GCONTEXT. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>IDChoice</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>IDChoice</secondary></indexterm></entry> + <entry id="errors:IDChoice"><emphasis role='bold'>IDChoice</emphasis><indexterm zone="errors:IDChoice" significance="preferred"><primary>Error Codes</primary><secondary>IDChoice</secondary></indexterm></entry> <entry> The value chosen for a resource identifier either is not included in the range assigned to the client or is already in use. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Implementation</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Implementation</secondary></indexterm></entry> + <entry id="errors:Implementation"><emphasis role='bold'>Implementation</emphasis><indexterm zone="errors:Implementation" significance="preferred"><primary>Error Codes</primary><secondary>Implementation</secondary></indexterm></entry> <entry> The server does not implement some aspect of the request. A server that generates this error for a core request is deficient. @@ -746,7 +741,7 @@ and handle or discard them. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Length</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Length</secondary></indexterm></entry> + <entry id="errors:Length"><emphasis role='bold'>Length</emphasis><indexterm zone="errors:Length" significance="preferred"><primary>Error Codes</primary><secondary>Length</secondary></indexterm></entry> <entry> The length of a request is shorter or longer than that required to minimally contain the arguments. @@ -755,7 +750,7 @@ server. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Match</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Match</secondary></indexterm></entry> + <entry id="errors:Match"><emphasis role='bold'>Match</emphasis><indexterm zone="errors:Match" significance="preferred"><primary>Error Codes</primary><secondary>Match</secondary></indexterm></entry> <entry> An <emphasis role='bold'>InputOnly</emphasis> @@ -767,25 +762,25 @@ but it fails to match in some other way required by the request. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Name</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Name</secondary></indexterm></entry> + <entry id="errors:Name"><emphasis role='bold'>Name</emphasis><indexterm zone="errors:Name" significance="preferred"><primary>Error Codes</primary><secondary>Name</secondary></indexterm></entry> <entry> A font or color of the specified name does not exist. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Pixmap</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Pixmap</secondary></indexterm></entry> + <entry id="errors:Pixmap"><emphasis role='bold'>Pixmap</emphasis><indexterm zone="errors:Pixmap" significance="preferred"><primary>Error Codes</primary><secondary>Pixmap</secondary></indexterm></entry> <entry> A value for a PIXMAP argument does not name a defined PIXMAP. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Request</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Request</secondary></indexterm></entry> + <entry id="errors:Request"><emphasis role='bold'>Request</emphasis><indexterm zone="errors:Request" significance="preferred"><primary>Error Codes</primary><secondary>Request</secondary></indexterm></entry> <entry> The major or minor opcode does not specify a valid request. </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Value</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Value</secondary></indexterm></entry> + <entry id="errors:Value"><emphasis role='bold'>Value</emphasis><indexterm zone="errors:Value" significance="preferred"><primary>Error Codes</primary><secondary>Value</secondary></indexterm></entry> <entry> Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified for an argument, @@ -795,7 +790,7 @@ this error (due to the encoding). </entry> </row> <row rowsep="0"> - <entry><emphasis role='bold'>Window</emphasis><indexterm significance="preferred"><primary>Error Codes</primary><secondary>Window</secondary></indexterm></entry> + <entry id="errors:Window"><emphasis role='bold'>Window</emphasis><indexterm zone="errors:Window" significance="preferred"><primary>Error Codes</primary><secondary>Window</secondary></indexterm></entry> <entry> A value for a WINDOW argument does not name a defined WINDOW. </entry> @@ -819,18 +814,20 @@ errors are also used when the argument type is extended by union with a set of fixed alternatives, for example, <WINDOW or <emphasis role='bold'>PointerRoot</emphasis> or -<emphasis role='bold'>None ></emphasis>. +<emphasis role='bold'>None</emphasis>>. </para></note> </chapter> <chapter id="keyboards"> <title>Keyboards</title> +<indexterm zone="keyboards"><primary>Keyboard</primary></indexterm> <!-- .XS --> <!-- (SN Keyboards --> <!-- .XE --> -<para> +<para id="keycode"> A KEYCODE represents a physical (or logical) key. -<indexterm><primary>Types</primary><secondary>KEYCODE</secondary></indexterm> +<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 @@ -838,9 +835,10 @@ although server implementors may attempt to encode geometry information The mapping between keys and keycodes cannot be changed using the protocol. </para> -<para> +<para id="keysym"> A KEYSYM is an encoding of a symbol on the cap of a key. -<indexterm><primary>Types</primary><secondary>KEYSYM</secondary></indexterm> +<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 @@ -853,24 +851,25 @@ as vendor-specific. A list of KEYSYMs is associated with each KEYCODE. The list is intended to convey the set of symbols on the corresponding key. If the list (ignoring trailing -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> entries) is a single KEYSYM "<emphasis remap='I'>K</emphasis>", then the list is treated as if it were -the list "<emphasis remap='I'>K</emphasis> NoSymbol -<emphasis remap='I'>K</emphasis> NoSymbol". -If the list (ignoring trailing NoSymbol entries) is a pair of KEYSYMs +the list "<emphasis remap='I'>K</emphasis> <keysym>NoSymbol</keysym> +<emphasis remap='I'>K</emphasis> <keysym>NoSymbol</keysym>". +If the list (ignoring trailing <keysym>NoSymbol</keysym> entries) +is a pair of KEYSYMs "<emphasis remap='I'>K1 K2</emphasis>", then the list is treated as if it were the list "<emphasis remap='I'>K1 K2 K1 K2</emphasis>". If the list (ignoring trailing -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> entries) is a triple of KEYSYMs "<emphasis remap='I'>K1 K2 K3</emphasis>", then the list is treated as if it were the list " -<emphasis remap='I'>K1 K2 K3</emphasis> NoSymbol". +<emphasis remap='I'>K1 K2 K3</emphasis> <keysym>NoSymbol</keysym>". When an explicit "void" element is desired in the list, the value -<emphasis role='bold'>VoidSymbol</emphasis> +<keysym>VoidSymbol</keysym> can be used. </para> <para> @@ -880,7 +879,7 @@ Group 1 contains the first and second KEYSYMs, Group 2 contains the third and fourth KEYSYMs. Within each group, if the second element of the group is -<emphasis role='bold'>NoSymbol</emphasis>, +<keysym>NoSymbol</keysym>, then the group should be treated as if the second element were the same as the first element, except when the first element is an alphabetic KEYSYM "<emphasis remap='I'>K</emphasis>" for which both lowercase @@ -891,10 +890,10 @@ element were the uppercase form of "<emphasis remap='I'>K</emphasis>". </para> -<para> +<para id="keysym_from_keypress"> The standard rules for obtaining a KEYSYM from a <link linkend="events:KeyPress"><emphasis role='bold'>KeyPress</emphasis></link> -<indexterm><primary>KeyPress</primary></indexterm> +<indexterm zone="keysym_from_keypress"><primary>KeyPress</primary></indexterm> event make use of only the Group 1 and Group 2 KEYSYMs; no interpretation of other KEYSYMs in the list is defined. The modifier state determines which group to use. Switching between groups is controlled by the KEYSYM named @@ -904,15 +903,15 @@ KEYCODE to any one of the modifiers through <emphasis role='bold'>Mod5</emphasis>. This modifier is -<indexterm significance="preferred"><primary>modifier</primary><secondary>group</secondary></indexterm> -called the "group modifier". For any KEYCODE, Group 1 is used when the +<indexterm zone="group_modifier" significance="preferred"><primary>modifier</primary><secondary>group</secondary></indexterm> +called the "<firstterm id="group_modifier">group modifier</firstterm>". For any KEYCODE, Group 1 is used when the group modifier is off, and Group 2 is used when the group modifier is on. </para> -<para> +<para id="modifier:lock"> The <emphasis role='bold'>Lock</emphasis> -<indexterm significance="preferred"><primary>modifier</primary><secondary>Lock</secondary></indexterm> +<indexterm zone="modifier:lock" significance="preferred"><primary>modifier</primary><secondary>Lock</secondary></indexterm> modifier is interpreted as CapsLock when the KEYSYM named CAPS LOCK is attached to some KEYCODE and that KEYCODE is attached to the <emphasis role='bold'>Lock</emphasis> @@ -928,7 +927,7 @@ modifier could be interpreted as both CapsLock and ShiftLock, the CapsLock interpretation is used. </para> -<para> +<para id="modifier:numlock"> <!-- .LP --> The operation of "keypad" keys is controlled by the KEYSYM named NUM LOCK, by attaching that KEYSYM to some KEYCODE and attaching that KEYCODE to any @@ -937,7 +936,7 @@ one of the modifiers through <emphasis role='bold'>Mod5</emphasis>. This modifier is called the -<indexterm significance="preferred"><primary>modifier</primary><secondary>NumLock</secondary></indexterm> +<indexterm zone="modifier:lock" significance="preferred"><primary>modifier</primary><secondary>NumLock</secondary></indexterm> "numlock modifier". The standard KEYSYMs with the prefix KEYPAD in their name are called "keypad" KEYSYMs; these are KEYSYMS with numeric value in the hexadecimal range #xFF80 to #xFFBD inclusive. In addition, @@ -1021,9 +1020,9 @@ it is merely stored for reading and writing by clients. <!-- .XS --> <!-- (SN Pointers --> <!-- .XE --> -<para> +<para id="pointers:buttons"> Buttons are always numbered starting with one. -<indexterm><primary>Button</primary><secondary>number</secondary></indexterm> +<indexterm zone="pointers:buttons"><primary>Button</primary><secondary>number</secondary></indexterm> </para> </chapter> @@ -1034,8 +1033,8 @@ Buttons are always numbered starting with one. <!-- .XE --> <para> <!-- .LP --> +<indexterm zone="predefined_atoms"><primary>Atom</primary><secondary>predefined</secondary></indexterm> Predefined atoms are not strictly necessary and may not be useful in all -<indexterm><primary>Atom</primary><secondary>predefined</secondary></indexterm> environments, but they will eliminate many <link linkend="requests:InternAtom"><emphasis role='bold'>InternAtom</emphasis></link> requests in most applications. @@ -1143,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, @@ -1151,11 +1151,12 @@ 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> + <para id="byte-order"> The client must send an initial byte of data to identify the byte order to be employed. -<indexterm><primary>Byte order</primary></indexterm> +<indexterm zone="byte-order"><primary>Byte order</primary></indexterm> The value of the byte must be octal 102 or 154. The value 102 (ASCII uppercase B) means values are transmitted most significant byte first, and value 154 (ASCII lowercase l) means values are transmitted @@ -1188,11 +1189,11 @@ authorization-protocol-data: STRING8 The version numbers indicate what version of the protocol the client expects the server to implement. </para> - <para> + <para id="authorization"> The authorization name indicates what authorization (and authentication) protocol the client expects the server to use, and the data is specific to that protocol. -<indexterm significance="preferred"><primary>Authorization</primary></indexterm> +<indexterm zone="authorization" significance="preferred"><primary>Authorization</primary></indexterm> Specification of valid authorization mechanisms is not part of the core X protocol. A server that does not implement the protocol the client expects @@ -1468,12 +1469,12 @@ The vendor string gives some identification of the owner of the server implementation. The vendor controls the semantics of the release number. </para> - <para> + <para id="resource-id-mask"> The resource-id-mask contains a single contiguous set of bits (at least 18). The client allocates resource IDs for types WINDOW, PIXMAP, CURSOR, FONT, GCONTEXT, and COLORMAP by choosing a value with only some subset of these bits set and ORing it with resource-id-base. -<indexterm><primary>Resource</primary><secondary>ID</secondary></indexterm> +<indexterm zone="resource-id-mask"><primary>Resource</primary><secondary>ID</secondary></indexterm> Only values constructed in this way can be used to name newly created resources over this connection. Resource IDs never have the top three bits set. @@ -1496,10 +1497,11 @@ specified by the server. 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> -A bitmap is represented in scanline order. -<indexterm><primary>Bitmap</primary><secondary>format</secondary></indexterm> -Each scanline is padded to a multiple of bits as given by bitmap-scanline-pad. + <para id="bitmap-format"> +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 <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 @@ -1507,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> -Pixmap-formats contains one entry for each depth value. -<indexterm><primary>Pixmap</primary><secondary>format</secondary></indexterm> -The entry describes the Z format used to represent images of that depth. + <para id="pixmap-formats"> +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> +<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. @@ -1550,10 +1556,10 @@ request makes such history available. The motion-buffer-size gives the approximate maximum number of elements in the history buffer. </para> - <para> + <para id="Maximum-request-length"> Maximum-request-length specifies the maximum length of a request accepted by the server, in 4-byte units. -<indexterm><primary>Request</primary><secondary>length</secondary></indexterm> +<indexterm zone="Maximum-request-length"><primary>Request</primary><secondary>length</secondary></indexterm> That is, length is the maximum value that can appear in the length field of a request. Requests larger than this maximum generate a @@ -1564,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, @@ -1575,7 +1583,7 @@ Not all keycodes in this range are required to have corresponding keys. <section id="screen_information"> <title>Screen Information</title> - <indexterm><primary>Screen</primary></indexterm> + <indexterm zone="screen_information"><primary>Screen</primary></indexterm> <para> The information that applies per screen is: @@ -1635,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. @@ -1656,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: @@ -1666,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; @@ -1746,7 +1758,7 @@ red-mask, green-mask, and blue-mask. <title>Requests</title> <section id="requests:CreateWindow"> <title>CreateWindow</title> - <indexterm significance="preferred"><primary>CreateWindow</primary></indexterm> + <indexterm zone="requests:CreateWindow" significance="preferred"><primary>CreateWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2127,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 @@ -2263,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 @@ -2335,7 +2350,7 @@ The server might or might not make a copy of the pixmap. </section> <section id="requests:ChangeWindowAttributes"> <title>ChangeWindowAttributes</title> - <indexterm significance="preferred"><primary>ChangeWindowAttributes</primary></indexterm> + <indexterm zone="requests:ChangeWindowAttributes" significance="preferred"><primary>ChangeWindowAttributes</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2455,7 +2470,7 @@ a subset of the attributes may have been altered. </section> <section id="requests:GetWindowAttributes"> <title>GetWindowAttributes</title> - <indexterm significance="preferred"><primary>GetWindowAttributes</primary></indexterm> + <indexterm zone="requests:GetWindowAttributes" significance="preferred"><primary>GetWindowAttributes</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2579,7 +2594,7 @@ Your-event-mask is the event mask selected by the querying client. </section> <section id="requests:DestroyWindow"> <title>DestroyWindow</title> - <indexterm significance="preferred"><primary>DestroyWindow</primary></indexterm> + <indexterm zone="requests:DestroyWindow" significance="preferred"><primary>DestroyWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2632,7 +2647,7 @@ this request has no effect. </section> <section id="requests:DestroySubwindows"> <title>DestroySubwindows</title> - <indexterm significance="preferred"><primary>DestroySubwindows</primary></indexterm> + <indexterm zone="requests:DestroySubwindows" significance="preferred"><primary>DestroySubwindows</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2666,7 +2681,7 @@ request on all children of the window, in bottom-to-top stacking order. </section> <section id="requests:ChangeSaveSet"> <title>ChangeSaveSet</title> - <indexterm significance="preferred"><primary>ChangeSaveSet</primary></indexterm> + <indexterm zone="requests:ChangeSaveSet" significance="preferred"><primary>ChangeSaveSet</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2717,7 +2732,7 @@ the server automatically removes them from the save-set. </section> <section id="requests:ReparentWindow"> <title>ReparentWindow</title> - <indexterm significance="preferred"><primary>ReparentWindow</primary></indexterm> + <indexterm zone="requests:ReparentWindow" significance="preferred"><primary>ReparentWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2797,7 +2812,8 @@ background, and the new parent is not the same depth as the window. </section> <section id="requests:MapWindow"> <title>MapWindow</title> - <indexterm significance="preferred"><primary>MapWindow</primary></indexterm> + <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'/> @@ -2854,7 +2870,7 @@ Similar tiling and exposure take place for any newly viewable inferiors. </section> <section id="requests:MapSubwindows"> <title>MapSubwindows</title> - <indexterm significance="preferred"><primary>MapSubwindows</primary></indexterm> + <indexterm zone="requests:MapSubwindows" significance="preferred"><primary>MapSubwindows</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2889,7 +2905,7 @@ in top-to-bottom stacking order. </section> <section id="requests:UnmapWindow"> <title>UnmapWindow</title> - <indexterm significance="preferred"><primary>UnmapWindow</primary></indexterm> + <indexterm zone="requests:UnmapWindow" significance="preferred"><primary>UnmapWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2925,7 +2941,7 @@ Normal exposure processing on formerly obscured windows is performed. </section> <section id="requests:UnmapSubwindows"> <title>UnmapSubwindows</title> - <indexterm significance="preferred"><primary>UnmapSubwindows</primary></indexterm> + <indexterm zone="requests:UnmapSubwindows" significance="preferred"><primary>UnmapSubwindows</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -2960,7 +2976,7 @@ in bottom-to-top stacking order. </section> <section id="requests:ConfigureWindow"> <title>ConfigureWindow</title> - <indexterm significance="preferred"><primary>ConfigureWindow</primary></indexterm> + <indexterm zone="requests:ConfigureWindow" significance="preferred"><primary>ConfigureWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3095,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> @@ -3390,7 +3409,7 @@ Attempts to configure a root window have no effect. </section> <section id="requests:CirculateWindow"> <title>CirculateWindow</title> - <indexterm significance="preferred"><primary>CirculateWindow</primary></indexterm> + <indexterm zone="requests:CirculateWindow" significance="preferred"><primary>CirculateWindow</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3450,7 +3469,7 @@ Exposure processing is performed on formerly obscured windows. </section> <section id="requests:GetGeometry"> <title>GetGeometry</title> - <indexterm significance="preferred"><primary>GetGeometry</primary></indexterm> + <indexterm zone="requests:GetGeometry" significance="preferred"><primary>GetGeometry</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3520,7 +3539,8 @@ window as a drawable to this request. </section> <section id="requests:QueryTree"> <title>QueryTree</title> - <indexterm significance="preferred"><primary>QueryTree</primary></indexterm> + <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'/> @@ -3576,7 +3596,8 @@ The children are listed in bottom-to-top stacking order. </section> <section id="requests:InternAtom"> <title>InternAtom</title> - <indexterm significance="preferred"><primary>InternAtom</primary></indexterm> + <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'/> @@ -3636,7 +3657,7 @@ Atoms remain defined until server reset (see <link linkend="connection_close">se </section> <section id="requests:GetAtomName"> <title>GetAtomName</title> - <indexterm significance="preferred"><primary>GetAtomName</primary></indexterm> + <indexterm zone="requests:GetAtomName" significance="preferred"><primary>GetAtomName</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3680,7 +3701,8 @@ This request returns the name for the given atom. </section> <section id="requests:ChangeProperty"> <title>ChangeProperty</title> - <indexterm significance="preferred"><primary>ChangeProperty</primary></indexterm> + <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'/> @@ -3776,7 +3798,7 @@ The maximum size of a property is server-dependent and may vary dynamically. </section> <section id="requests:DeleteProperty"> <title>DeleteProperty</title> - <indexterm significance="preferred"><primary>DeleteProperty</primary></indexterm> + <indexterm zone="requests:DeleteProperty" significance="preferred"><primary>DeleteProperty</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3817,7 +3839,7 @@ event on the window unless the property does not exist. </section> <section id="requests:GetProperty"> <title>GetProperty</title> - <indexterm significance="preferred"><primary>GetProperty</primary></indexterm> + <indexterm zone="requests:GetProperty" significance="preferred"><primary>GetProperty</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -3943,7 +3965,7 @@ event is generated on the window. </section> <section id="requests:RotateProperties"> <title>RotateProperties</title> - <indexterm significance="preferred"><primary>RotateProperties</primary></indexterm> + <indexterm zone="requests:RotateProperties" significance="preferred"><primary>RotateProperties</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4010,7 +4032,7 @@ error is generated, no properties are changed. </section> <section id="requests:ListProperties"> <title>ListProperties</title> - <indexterm significance="preferred"><primary>ListProperties</primary></indexterm> + <indexterm zone="requests:ListProperties" significance="preferred"><primary>ListProperties</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4054,7 +4076,8 @@ This request returns the atoms of properties currently defined on the window. </section> <section id="requests:SetSelectionOwner"> <title>SetSelectionOwner</title> - <indexterm significance="preferred"><primary>SetSelectionOwner</primary></indexterm> + <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'/> @@ -4142,7 +4165,7 @@ Selections are global to the server. </section> <section id="requests:GetSelectionOwner"> <title>GetSelectionOwner</title> - <indexterm significance="preferred"><primary>GetSelectionOwner</primary></indexterm> + <indexterm zone="requests:GetSelectionOwner" significance="preferred"><primary>GetSelectionOwner</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4191,7 +4214,7 @@ is returned, then there is no owner for the selection. </section> <section id="requests:ConvertSelection"> <title>ConvertSelection</title> - <indexterm significance="preferred"><primary>ConvertSelection</primary></indexterm> + <indexterm zone="requests:ConvertSelection" significance="preferred"><primary>ConvertSelection</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4250,7 +4273,8 @@ The arguments are passed on unchanged in either of the events. </section> <section id="requests:SendEvent"> <title>SendEvent</title> - <indexterm significance="preferred"><primary>SendEvent</primary></indexterm> + <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'/> @@ -4350,7 +4374,9 @@ Active grabs are ignored for this request. </section> <section id="requests:GrabPointer"> <title>GrabPointer</title> - <indexterm significance="preferred"><primary>GrabPointer</primary></indexterm> + <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'/> @@ -4528,7 +4554,7 @@ replaced by the current server time. </section> <section id="requests:UngrabPointer"> <title>UngrabPointer</title> - <indexterm significance="preferred"><primary>UngrabPointer</primary></indexterm> + <indexterm zone="requests:UngrabPointer" significance="preferred"><primary>UngrabPointer</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4575,8 +4601,8 @@ completely outside the boundaries of the root window. </section> <section id="requests:GrabButton"> <title>GrabButton</title> - <indexterm significance="preferred"><primary>GrabButton</primary></indexterm> - <indexterm><primary>Button</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="requests:GrabButton" significance="preferred"><primary>GrabButton</primary></indexterm> + <indexterm zone="requests:GrabButton"><primary>Button</primary><secondary>grabbing</secondary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4647,7 +4673,7 @@ Errors: <!-- .eM --> <para> This request establishes a passive grab. -<indexterm><primary>Passive grab</primary><secondary>pointer</secondary></indexterm> +<indexterm zone="requests:GrabButton"><primary>Passive grab</primary><secondary>pointer</secondary></indexterm> In the future, the pointer is actively grabbed as described in <link linkend="requests:GrabPointer"><emphasis role='bold'>GrabPointer</emphasis></link>, @@ -4712,7 +4738,7 @@ The request has no effect on an active grab. </section> <section id="requests:UngrabButton"> <title>UngrabButton</title> - <indexterm significance="preferred"><primary>UngrabButton</primary></indexterm> + <indexterm zone="requests:UngrabButton" significance="preferred"><primary>UngrabButton</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -4766,7 +4792,8 @@ The request has no effect on an active grab. </section> <section id="requests:ChangeActivePointerGrab"> <title>ChangeActivePointerGrab</title> - <indexterm significance="preferred"><primary>ChangeActivePointerGrab</primary></indexterm> + <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'/> @@ -4818,7 +4845,9 @@ with </section> <section id="requests:GrabKeyboard"> <title>GrabKeyboard</title> - <indexterm significance="preferred"><primary>GrabKeyboard</primary></indexterm> + <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'/> @@ -4959,7 +4988,7 @@ replaced by the current server time. </section> <section id="requests:UngrabKeyboard"> <title>UngrabKeyboard</title> - <indexterm significance="preferred"><primary>UngrabKeyboard</primary></indexterm> + <indexterm zone="requests:UngrabKeyboard" significance="preferred"><primary>UngrabKeyboard</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5004,7 +5033,8 @@ becomes not viewable. </section> <section id="requests:GrabKey"> <title>GrabKey</title> - <indexterm significance="preferred"><primary>GrabKey</primary></indexterm> + <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'/> @@ -5057,7 +5087,7 @@ Errors: <!-- .eM --> <para> This request establishes a passive grab on the keyboard. -<indexterm><primary>Passive grab</primary><secondary>keyboard</secondary></indexterm> +<indexterm zone="requests:GrabKey"><primary>Passive grab</primary><secondary>keyboard</secondary></indexterm> In the future, the keyboard is actively grabbed as described in <link linkend="requests:GrabKeyboard"><emphasis role='bold'>GrabKeyboard</emphasis></link>, @@ -5124,7 +5154,7 @@ error is generated if there is a conflicting grab for any combination. </section> <section id="requests:UngrabKey"> <title>UngrabKey</title> - <indexterm significance="preferred"><primary>UngrabKey</primary></indexterm> + <indexterm zone="requests:UngrabKey" significance="preferred"><primary>UngrabKey</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5178,7 +5208,7 @@ This request has no effect on an active grab. </section> <section id="requests:AllowEvents"> <title>AllowEvents</title> - <indexterm significance="preferred"><primary>AllowEvents</primary></indexterm> + <indexterm zone="requests:AllowEvents" significance="preferred"><primary>AllowEvents</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5387,8 +5417,8 @@ releases both. </section> <section id="requests:GrabServer"> <title>GrabServer</title> - <indexterm significance="preferred"><primary>GrabServer</primary></indexterm> - <indexterm><primary>Server</primary><secondary>grabbing</secondary></indexterm> + <indexterm zone="requests:GrabServer" significance="preferred"><primary>GrabServer</primary></indexterm> + <indexterm zone="requests:GrabServer"><primary>Server</primary><secondary>grabbing</secondary></indexterm> <para> This request disables processing of requests and close-downs on all connections other than the one this request arrived on. @@ -5397,7 +5427,7 @@ connections other than the one this request arrived on. </section> <section id="requests:UngrabServer"> <title>UngrabServer</title> - <indexterm significance="preferred"><primary>UngrabServer</primary></indexterm> + <indexterm zone="requests:UngrabServer" significance="preferred"><primary>UngrabServer</primary></indexterm> <para> This request restarts processing of requests and close-downs on other connections. @@ -5406,7 +5436,7 @@ on other connections. </section> <section id="requests:QueryPointer"> <title>QueryPointer</title> - <indexterm significance="preferred"><primary>QueryPointer</primary></indexterm> + <indexterm zone="requests:QueryPointer" significance="preferred"><primary>QueryPointer</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5487,7 +5517,7 @@ may lag the physical state if device event processing is frozen. </section> <section id="requests:GetMotionEvents"> <title>GetMotionEvents</title> - <indexterm significance="preferred"><primary>GetMotionEvents</primary></indexterm> + <indexterm zone="requests:GetMotionEvents" significance="preferred"><primary>GetMotionEvents</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5565,7 +5595,8 @@ If the stop time is in the future, it is equivalent to specifying </section> <section id="requests:TranslateCoordinates"> <title>TranslateCoordinates</title> - <indexterm significance="preferred"><primary>TranslateCoordinates</primary></indexterm> + <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'/> @@ -5633,7 +5664,7 @@ then that child is returned. </section> <section id="requests:WarpPointer"> <title>WarpPointer</title> - <indexterm significance="preferred"><primary>WarpPointer</primary></indexterm> + <indexterm zone="requests:WarpPointer" significance="preferred"><primary>WarpPointer</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5714,7 +5745,8 @@ moved the pointer. </section> <section id="requests:SetInputFocus"> <title>SetInputFocus</title> - <indexterm significance="preferred"><primary>SetInputFocus</primary></indexterm> + <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'/> @@ -5824,7 +5856,7 @@ but the last-focus-change time is not affected. </section> <section id="requests:GetInputFocus"> <title>GetInputFocus</title> - <indexterm significance="preferred"><primary>GetInputFocus</primary></indexterm> + <indexterm zone="requests:GetInputFocus" significance="preferred"><primary>GetInputFocus</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5864,7 +5896,7 @@ This request returns the current focus state. </section> <section id="requests:QueryKeymap"> <title>QueryKeymap</title> - <indexterm significance="preferred"><primary>QueryKeymap</primary></indexterm> + <indexterm zone="requests:QueryKeymap" significance="preferred"><primary>QueryKeymap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5899,7 +5931,8 @@ may lag the physical state if device event processing is frozen. </section> <section id="requests:OpenFont"> <title>OpenFont</title> - <indexterm significance="preferred"><primary>OpenFont</primary></indexterm> + <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'/> @@ -5953,7 +5986,7 @@ and can be stored as a component of any graphics context. </section> <section id="requests:CloseFont"> <title>CloseFont</title> - <indexterm significance="preferred"><primary>CloseFont</primary></indexterm> + <indexterm zone="requests:CloseFont" significance="preferred"><primary>CloseFont</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -5986,7 +6019,7 @@ The font itself will be freed when no other resource references it. </section> <section id="requests:QueryFont"> <title>QueryFont</title> - <indexterm significance="preferred"><primary>QueryFont</primary></indexterm> + <indexterm zone="requests:QueryFont" significance="preferred"><primary>QueryFont</primary></indexterm> <informaltable frame='none'> <tgroup cols='3' align='left' rowsep='0'> <colspec colname='c1' colsep='0'/> @@ -6289,7 +6322,7 @@ server-dependent. </section> <section id="requests:QueryTextExtents"> <title>QueryTextExtents</title> - <indexterm significance="preferred"><primary>QueryTextExtents</primary></indexterm> + <indexterm zone="requests:QueryTextExtents" significance="preferred"><primary>QueryTextExtents</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6403,7 +6436,7 @@ then undefined characters in the string are also ignored. </section> <section id="requests:ListFonts"> <title>ListFonts</title> - <indexterm significance="preferred"><primary>ListFonts</primary></indexterm> + <indexterm zone="requests:ListFonts" significance="preferred"><primary>ListFonts</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6456,7 +6489,7 @@ The returned names are in lowercase. </section> <section id="requests:ListFontsWithInfo"> <title>ListFontsWithInfo</title> - <indexterm significance="preferred"><primary>ListFontsWithInfo</primary></indexterm> + <indexterm zone="requests:ListFontsWithInfo" significance="preferred"><primary>ListFontsWithInfo</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6535,7 +6568,7 @@ sequence. </section> <section id="requests:SetFontPath"> <title>SetFontPath</title> - <indexterm significance="preferred"><primary>SetFontPath</primary></indexterm> + <indexterm zone="requests:SetFontPath" significance="preferred"><primary>SetFontPath</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6583,7 +6616,7 @@ The meaning of an error from this request is system specific. </section> <section id="requests:GetFontPath"> <title>GetFontPath</title> - <indexterm significance="preferred"><primary>GetFontPath</primary></indexterm> + <indexterm zone="requests:GetFontPath" significance="preferred"><primary>GetFontPath</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6612,7 +6645,7 @@ This request returns the current search path for fonts. </section> <section id="requests:CreatePixmap"> <title>CreatePixmap</title> - <indexterm significance="preferred"><primary>CreatePixmap</primary></indexterm> + <indexterm zone="requests:CreatePixmap" significance="preferred"><primary>CreatePixmap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6675,7 +6708,7 @@ window as a drawable to this request. </section> <section id="requests:FreePixmap"> <title>FreePixmap</title> - <indexterm significance="preferred"><primary>FreePixmap</primary></indexterm> + <indexterm zone="requests:FreePixmap" significance="preferred"><primary>FreePixmap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -6708,7 +6741,8 @@ The pixmap storage will be freed when no other resource references it. </section> <section id="requests:CreateGC"> <title>CreateGC</title> - <indexterm significance="preferred"><primary>CreateGC</primary></indexterm> + <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'/> @@ -6923,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; @@ -6942,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> @@ -7057,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> @@ -7123,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> @@ -7169,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> @@ -7226,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> @@ -7504,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 @@ -7541,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> @@ -7740,7 +7779,7 @@ changes to a single gcontext. </section> <section id="requests:ChangeGC"> <title>ChangeGC</title> - <indexterm significance="preferred"><primary>ChangeGC</primary></indexterm> + <indexterm zone="requests:ChangeGC" significance="preferred"><primary>ChangeGC</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -7804,7 +7843,7 @@ a subset of the components may have been altered. </section> <section id="requests:CopyGC"> <title>CopyGC</title> - <indexterm significance="preferred"><primary>CopyGC</primary></indexterm> + <indexterm zone="requests:CopyGC" significance="preferred"><primary>CopyGC</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -7849,7 +7888,7 @@ error results). </section> <section id="requests:SetDashes"> <title>SetDashes</title> - <indexterm significance="preferred"><primary>SetDashes</primary></indexterm> + <indexterm zone="requests:SetDashes" significance="preferred"><primary>SetDashes</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -7948,7 +7987,7 @@ would be included in the dash when drawn unclipped. </section> <section id="requests:SetClipRectangles"> <title>SetClipRectangles</title> - <indexterm significance="preferred"><primary>SetClipRectangles</primary></indexterm> + <indexterm zone="requests:SetClipRectangles" significance="preferred"><primary>SetClipRectangles</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8044,7 +8083,7 @@ extents. </section> <section id="requests:FreeGC"> <title>FreeGC</title> - <indexterm significance="preferred"><primary>FreeGC</primary></indexterm> + <indexterm zone="requests:FreeGC" significance="preferred"><primary>FreeGC</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8077,8 +8116,8 @@ and destroys the gcontext. </section> <section id="requests:ClearArea"> <title>ClearArea</title> - <indexterm significance="preferred"><primary>ClearArea</primary></indexterm> -<informaltable frame='none'> + <indexterm zone="requests:ClearArea" significance="preferred"><primary>ClearArea</primary></indexterm> + <indexterm zone="requests:ClearArea"><primary>Background</primary></indexterm><informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> <tbody> @@ -8151,7 +8190,7 @@ window in this request. </section> <section id="requests:CopyArea"> <title>CopyArea</title> - <indexterm significance="preferred"><primary>CopyArea</primary></indexterm> + <indexterm zone="requests:CopyArea" significance="preferred"><primary>CopyArea</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8247,7 +8286,7 @@ graphics-exposures, clip-x-origin, clip-y-origin, clip-mask </section> <section id="requests:CopyPlane"> <title>CopyPlane</title> - <indexterm significance="preferred"><primary>CopyPlane</primary></indexterm> + <indexterm zone="requests:CopyPlane" significance="preferred"><primary>CopyPlane</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8329,7 +8368,7 @@ clip-mask </section> <section id="requests:PolyPoint"> <title>PolyPoint</title> - <indexterm significance="preferred"><primary>PolyPoint</primary></indexterm> + <indexterm zone="requests:PolyPoint" significance="preferred"><primary>PolyPoint</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8392,7 +8431,8 @@ clip-x-origin, clip-y-origin, clip-mask </section> <section id="requests:PolyLine"> <title>PolyLine</title> - <indexterm significance="preferred"><primary>PolyLine</primary></indexterm> + <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'/> @@ -8481,7 +8521,7 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes </section> <section id="requests:PolySegment"> <title>PolySegment</title> - <indexterm significance="preferred"><primary>PolySegment</primary></indexterm> + <indexterm zone="requests:PolySegment" significance="preferred"><primary>PolySegment</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8555,7 +8595,7 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes </section> <section id="requests:PolyRectangle"> <title>PolyRectangle</title> - <indexterm significance="preferred"><primary>PolyRectangle</primary></indexterm> + <indexterm zone="requests:PolyRectangle" significance="preferred"><primary>PolyRectangle</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8626,7 +8666,7 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes </section> <section id="requests:PolyArc"> <title>PolyArc</title> - <indexterm significance="preferred"><primary>PolyArc</primary></indexterm> + <indexterm zone="requests:PolyArc" significance="preferred"><primary>PolyArc</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8800,7 +8840,7 @@ tile-stipple-x-origin, tile-stipple-y-origin, dash-offset, dashes </section> <section id="requests:FillPoly"> <title>FillPoly</title> - <indexterm significance="preferred"><primary>FillPoly</primary></indexterm> + <indexterm zone="requests:FillPoly" significance="preferred"><primary>FillPoly</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8911,7 +8951,7 @@ tile-stipple-x-origin, tile-stipple-y-origin </section> <section id="requests:PolyFillRectangle"> <title>PolyFillRectangle</title> - <indexterm significance="preferred"><primary>PolyFillRectangle</primary></indexterm> + <indexterm zone="requests:PolyFillRectangle" significance="preferred"><primary>PolyFillRectangle</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -8979,7 +9019,7 @@ tile-stipple-x-origin, tile-stipple-y-origin </section> <section id="requests:PolyFillArc"> <title>PolyFillArc</title> - <indexterm significance="preferred"><primary>PolyFillArc</primary></indexterm> + <indexterm zone="requests:PolyFillArc" significance="preferred"><primary>PolyFillArc</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9071,7 +9111,7 @@ tile-stipple-x-origin, tile-stipple-y-origin </section> <section id="requests:PutImage"> <title>PutImage</title> - <indexterm significance="preferred"><primary>PutImage</primary></indexterm> + <indexterm zone="requests:PutImage" significance="preferred"><primary>PutImage</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9197,7 +9237,7 @@ GC mode-dependent components: foreground, background </section> <section id="requests:GetImage"> <title>GetImage</title> - <indexterm significance="preferred"><primary>GetImage</primary></indexterm> + <indexterm zone="requests:GetImage" significance="preferred"><primary>GetImage</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9326,7 +9366,7 @@ It is intended specifically for rudimentary hardcopy support. </section> <section id="requests:PolyText8"> <title>PolyText8</title> - <indexterm significance="preferred"><primary>PolyText8</primary></indexterm> + <indexterm zone="requests:PolyText8" significance="preferred"><primary>PolyText8</primary></indexterm> <informaltable frame='none'> <tgroup cols='3' align='left' rowsep='0'> <colspec colname='c1' colsep='0'/> @@ -9439,7 +9479,7 @@ tile-stipple-x-origin, tile-stipple-y-origin </section> <section id="requests:PolyText16"> <title>PolyText16</title> - <indexterm significance="preferred"><primary>PolyText16</primary></indexterm> + <indexterm zone="requests:PolyText16" significance="preferred"><primary>PolyText16</primary></indexterm> <informaltable frame='none'> <tgroup cols='3' align='left' rowsep='0'> <colspec colname='c1' colsep='0'/> @@ -9526,7 +9566,7 @@ CHAR2B is taken as the most significant byte). </section> <section id="requests:ImageText8"> <title>ImageText8</title> - <indexterm significance="preferred"><primary>ImageText8</primary></indexterm> + <indexterm zone="requests:ImageText8" significance="preferred"><primary>ImageText8</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9616,7 +9656,7 @@ subwindow-mode, clip-x-origin, clip-y-origin, clip-mask </section> <section id="requests:ImageText16"> <title>ImageText16</title> - <indexterm significance="preferred"><primary>ImageText16</primary></indexterm> + <indexterm zone="requests:ImageText16" significance="preferred"><primary>ImageText16</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9671,7 +9711,8 @@ CHAR2B is taken as the most significant byte). </section> <section id="requests:CreateColormap"> <title>CreateColormap</title> - <indexterm significance="preferred"><primary>CreateColormap</primary></indexterm> + <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'/> @@ -9779,7 +9820,7 @@ in all cases, none of these entries can be freed with </section> <section id="requests:FreeColormap"> <title>FreeColormap</title> - <indexterm significance="preferred"><primary>FreeColormap</primary></indexterm> + <indexterm zone="requests:FreeColormap" significance="preferred"><primary>FreeColormap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9830,7 +9871,7 @@ This request has no effect on a default colormap for a screen. </section> <section id="requests:CopyColormapAndFree"> <title>CopyColormapAndFree</title> - <indexterm significance="preferred"><primary>CopyColormapAndFree</primary></indexterm> + <indexterm zone="requests:CopyColormapAndFree" significance="preferred"><primary>CopyColormapAndFree</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9890,7 +9931,7 @@ and that have not been freed since they were allocated. </section> <section id="requests:InstallColormap"> <title>InstallColormap</title> - <indexterm significance="preferred"><primary>InstallColormap</primary></indexterm> + <indexterm zone="requests:InstallColormap" significance="preferred"><primary>InstallColormap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -9960,7 +10001,7 @@ the required list). </section> <section id="requests:UninstallColormap"> <title>UninstallColormap</title> - <indexterm significance="preferred"><primary>UninstallColormap</primary></indexterm> + <indexterm zone="requests:UninstallColormap" significance="preferred"><primary>UninstallColormap</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10010,7 +10051,7 @@ event is generated on every window having that colormap as an attribute. </section> <section id="requests:ListInstalledColormaps"> <title>ListInstalledColormaps</title> - <indexterm significance="preferred"><primary>ListInstalledColormaps</primary></indexterm> + <indexterm zone="requests:ListInstalledColormaps" significance="preferred"><primary>ListInstalledColormaps</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10059,7 +10100,7 @@ request). </section> <section id="requests:AllocColor"> <title>AllocColor</title> - <indexterm significance="preferred"><primary>AllocColor</primary></indexterm> + <indexterm zone="requests:AllocColor" significance="preferred"><primary>AllocColor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10118,7 +10159,7 @@ the same read-only entry, allowing entries to be shared. </section> <section id="requests:AllocNamedColor"> <title>AllocNamedColor</title> - <indexterm significance="preferred"><primary>AllocNamedColor</primary></indexterm> + <indexterm zone="requests:AllocNamedColor" significance="preferred"><primary>AllocNamedColor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10187,7 +10228,7 @@ and the visual values specify the values actually used in the colormap. </section> <section id="requests:AllocColorCells"> <title>AllocColorCells</title> - <indexterm significance="preferred"><primary>AllocColorCells</primary></indexterm> + <indexterm zone="requests:AllocColorCells" significance="preferred"><primary>AllocColorCells</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10270,7 +10311,7 @@ The RGB values of the allocated entries are undefined. </section> <section id="requests:AllocColorPlanes"> <title>AllocColorPlanes</title> - <indexterm significance="preferred"><primary>AllocColorPlanes</primary></indexterm> + <indexterm zone="requests:AllocColorPlanes" significance="preferred"><primary>AllocColorPlanes</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10361,7 +10402,7 @@ corresponding independent entries are updated. </section> <section id="requests:FreeColors"> <title>FreeColors</title> - <indexterm significance="preferred"><primary>FreeColors</primary></indexterm> + <indexterm zone="requests:FreeColors" significance="preferred"><primary>FreeColors</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10442,7 +10483,7 @@ it is arbitrary as to which pixel is reported. </section> <section id="requests:StoreColors"> <title>StoreColors</title> - <indexterm significance="preferred"><primary>StoreColors</primary></indexterm> + <indexterm zone="requests:StoreColors" significance="preferred"><primary>StoreColors</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> @@ -10528,7 +10569,7 @@ it is arbitrary as to which pixel is reported. </section> <section id="requests:StoreNamedColor"> <title>StoreNamedColor</title> - <indexterm significance="preferred"><primary>StoreNamedColor</primary></indexterm> + <indexterm zone="requests:StoreNamedColor" significance="preferred"><primary>StoreNamedColor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10589,7 +10630,7 @@ errors are the same as in </section> <section id="requests:QueryColors"> <title>QueryColors</title> - <indexterm significance="preferred"><primary>QueryColors</primary></indexterm> + <indexterm zone="requests:QueryColors" significance="preferred"><primary>QueryColors</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10660,7 +10701,7 @@ it is arbitrary as to which pixel is reported. </section> <section id="requests:LookupColor"> <title>LookupColor</title> - <indexterm significance="preferred"><primary>LookupColor</primary></indexterm> + <indexterm zone="requests:LookupColor" significance="preferred"><primary>LookupColor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10720,7 +10761,8 @@ and uppercase and lowercase do not matter. </section> <section id="requests:CreateCursor"> <title>CreateCursor</title> - <indexterm significance="preferred"><primary>CreateCursor</primary></indexterm> + <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'/> @@ -10819,7 +10861,7 @@ The server might or might not make a copy of the pixmap. </section> <section id="requests:CreateGlyphCursor"> <title>CreateGlyphCursor</title> - <indexterm significance="preferred"><primary>CreateGlyphCursor</primary></indexterm> + <indexterm zone="requests:CreateGlyphCursor" significance="preferred"><primary>CreateGlyphCursor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10907,7 +10949,7 @@ them are to be made. </section> <section id="requests:FreeCursor"> <title>FreeCursor</title> - <indexterm significance="preferred"><primary>FreeCursor</primary></indexterm> + <indexterm zone="requests:FreeCursor" significance="preferred"><primary>FreeCursor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10940,7 +10982,7 @@ The cursor storage will be freed when no other resource references it. </section> <section id="requests:RecolorCursor"> <title>RecolorCursor</title> - <indexterm significance="preferred"><primary>RecolorCursor</primary></indexterm> + <indexterm zone="requests:RecolorCursor" significance="preferred"><primary>RecolorCursor</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -10984,7 +11026,7 @@ the change is visible immediately. </section> <section id="requests:QueryBestSize"> <title>QueryBestSize</title> - <indexterm significance="preferred"><primary>QueryBestSize</primary></indexterm> + <indexterm zone="requests:QueryBestSize" significance="preferred"><primary>QueryBestSize</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11071,7 +11113,8 @@ error results). </section> <section id="requests:QueryExtension"> <title>QueryExtension</title> - <indexterm significance="preferred"><primary>QueryExtension</primary></indexterm> + <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'/> @@ -11138,7 +11181,8 @@ and uppercase and lowercase matter. </section> <section id="requests:ListExtensions"> <title>ListExtensions</title> - <indexterm significance="preferred"><primary>ListExtensions</primary></indexterm> + <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'/> @@ -11166,7 +11210,8 @@ This request returns a list of all extensions supported by the server. </section> <section id="requests:SetModifierMapping"> <title>SetModifierMapping</title> - <indexterm significance="preferred"><primary>SetModifierMapping</primary></indexterm> + <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'/> @@ -11273,7 +11318,8 @@ status. </section> <section id="requests:GetModifierMapping"> <title>GetModifierMapping</title> - <indexterm significance="preferred"><primary>GetModifierMapping</primary></indexterm> + <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'/> @@ -11326,7 +11372,8 @@ The order of keycodes within each set is chosen arbitrarily by the server. </section> <section id="requests:ChangeKeyboardMapping"> <title>ChangeKeyboardMapping</title> - <indexterm significance="preferred"><primary>ChangeKeyboardMapping</primary></indexterm> + <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'/> @@ -11394,10 +11441,10 @@ in keysyms. The keysyms-per-keycode can be chosen arbitrarily by the client to be large enough to hold all desired symbols. A special KEYSYM value of -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> should be used to fill in unused elements for individual keycodes. It is legal for -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> to appear in nontrailing positions of the effective list for a keycode. </para> <para> @@ -11414,7 +11461,8 @@ it is merely stored for reading and writing by clients </section> <section id="requests:GetKeyboardMapping"> <title>GetKeyboardMapping</title> - <indexterm significance="preferred"><primary>GetKeyboardMapping</primary></indexterm> + <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'/> @@ -11494,14 +11542,14 @@ in keysyms. The keysyms-per-keycode value is chosen arbitrarily by the server to be large enough to report all requested symbols. A special KEYSYM value of -<emphasis role='bold'>NoSymbol</emphasis> +<keysym>NoSymbol</keysym> is used to fill in unused elements for individual keycodes. <!-- .sp --> </para> </section> <section id="requests:ChangeKeyboardControl"> <title>ChangeKeyboardControl</title> - <indexterm significance="preferred"><primary>ChangeKeyboardControl</primary></indexterm> + <indexterm zone="requests:ChangeKeyboardControl" significance="preferred"><primary>ChangeKeyboardControl</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11672,7 +11720,7 @@ a subset of the controls may have been altered. </section> <section id="requests:GetKeyboardControl"> <title>GetKeyboardControl</title> - <indexterm significance="preferred"><primary>GetKeyboardControl</primary></indexterm> + <indexterm zone="requests:GetKeyboardControl" significance="preferred"><primary>GetKeyboardControl</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11741,7 +11789,7 @@ with the least significant bit in the byte representing key 8N. </section> <section id="requests:Bell"> <title>Bell</title> - <indexterm significance="preferred"><primary>Bell</primary></indexterm> + <indexterm zone="requests:Bell" significance="preferred"><primary>Bell</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11787,7 +11835,7 @@ When percent is negative, it is: </section> <section id="requests:SetPointerMapping"> <title>SetPointerMapping</title> - <indexterm significance="preferred"><primary>SetPointerMapping</primary></indexterm> + <indexterm zone="requests:SetPointerMapping" significance="preferred"><primary>SetPointerMapping</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11861,7 +11909,7 @@ status. </section> <section id="requests:GetPointerMapping"> <title>GetPointerMapping</title> - <indexterm significance="preferred"><primary>GetPointerMapping</primary></indexterm> + <indexterm zone="requests:GetPointerMapping" significance="preferred"><primary>GetPointerMapping</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11895,7 +11943,7 @@ The nominal mapping for a pointer is the identity mapping: map[i]=i. </section> <section id="requests:ChangePointerControl"> <title>ChangePointerControl</title> - <indexterm significance="preferred"><primary>ChangePointerControl</primary></indexterm> + <indexterm zone="requests:ChangePointerControl" significance="preferred"><primary>ChangePointerControl</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11947,7 +11995,7 @@ error, as does a zero value for acceleration-denominator. </section> <section id="requests:GetPointerControl"> <title>GetPointerControl</title> - <indexterm significance="preferred"><primary>GetPointerControl</primary></indexterm> + <indexterm zone="requests:GetPointerControl" significance="preferred"><primary>GetPointerControl</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -11981,7 +12029,7 @@ This request returns the current acceleration and threshold for the pointer. </section> <section id="requests:SetScreenSaver"> <title>SetScreenSaver</title> - <indexterm significance="preferred"><primary>SetScreenSaver</primary></indexterm> + <indexterm zone="requests:SetScreenSaver" significance="preferred"><primary>SetScreenSaver</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12063,7 +12111,7 @@ randomly reorigined periodically. </section> <section id="requests:GetScreenSaver"> <title>GetScreenSaver</title> - <indexterm significance="preferred"><primary>GetScreenSaver</primary></indexterm> + <indexterm zone="requests:GetScreenSaver" significance="preferred"><primary>GetScreenSaver</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12106,7 +12154,7 @@ This request returns the current screen-saver control values. </section> <section id="requests:ForceScreenSaver"> <title>ForceScreenSaver</title> - <indexterm significance="preferred"><primary>ForceScreenSaver</primary></indexterm> + <indexterm zone="requests:ForceScreenSaver" significance="preferred"><primary>ForceScreenSaver</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12150,7 +12198,7 @@ as if device input had just been received. </section> <section id="requests:ChangeHosts"> <title>ChangeHosts</title> - <indexterm significance="preferred"><primary>ChangeHosts</primary></indexterm> + <indexterm zone="requests:ChangeHosts" significance="preferred"><primary>ChangeHosts</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12185,7 +12233,7 @@ Errors: <!-- .eM --> <para> This request adds or removes the specified host from the access control list. -<indexterm><primary>Access control list</primary></indexterm> +<indexterm zone="requests:ChangeHosts"><primary>Access control list</primary></indexterm> When the access control mechanism is enabled and a client attempts to establish a connection to the server, the host on which the client resides must be in the access control list, @@ -12202,9 +12250,9 @@ error results). An initial access control list can usually be specified, typically by naming a file that the server reads at startup and reset. </para> -<para> +<para id="address_families"> The following address families are defined. -<indexterm><primary>Types</primary><secondary>HOST</secondary></indexterm> +<indexterm zone="address_families"><primary>Types</primary><secondary>HOST</secondary></indexterm> A server is not required to support these families and may support families not listed here. Use of an unsupported family, an improper address format, @@ -12267,7 +12315,7 @@ or public key encryption, are recommended. </section> <section id="requests:ListHosts"> <title>ListHosts</title> - <indexterm significance="preferred"><primary>ListHosts</primary></indexterm> + <indexterm zone="requests:ListHosts" significance="preferred"><primary>ListHosts</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12308,7 +12356,7 @@ Each HOST is padded to a multiple of four bytes. </section> <section id="requests:SetAccessControl"> <title>SetAccessControl</title> - <indexterm significance="preferred"><primary>SetAccessControl</primary></indexterm> + <indexterm zone="requests:SetAccessControl" significance="preferred"><primary>SetAccessControl</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12351,7 +12399,7 @@ error results). </section> <section id="requests:SetCloseDownMode"> <title>SetCloseDownMode</title> - <indexterm significance="preferred"><primary>SetCloseDownMode</primary></indexterm> + <indexterm zone="requests:SetCloseDownMode" significance="preferred"><primary>SetCloseDownMode</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12392,7 +12440,7 @@ in <link linkend="connection_close">section 10</link>. </section> <section id="requests:KillClient"> <title>KillClient</title> - <indexterm significance="preferred"><primary>KillClient</primary></indexterm> + <indexterm zone="requests:KillClient" significance="preferred"><primary>KillClient</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -12439,7 +12487,7 @@ are destroyed. </section> <section id="requests:NoOperation"> <title>NoOperation</title> - <indexterm significance="preferred"><primary>NoOperation</primary></indexterm> + <indexterm zone="requests:NoOperation" significance="preferred"><primary>NoOperation</primary></indexterm> <para> This request has no arguments and no results, but the request length field @@ -12456,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 --> @@ -12547,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, @@ -12626,40 +12676,40 @@ can both be used to modify the active grab. <section id="events:input"> <title>Input Device events</title> - <indexterm significance="preferred"><primary>Input device</primary><secondary>events</secondary></indexterm> + <indexterm zone="events:input" significance="preferred"><primary>Input device</primary><secondary>events</secondary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> <tbody> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>KeyPress</primary></indexterm> -<emphasis role='bold' id="events:KeyPress">KeyPress</emphasis> + <entry id="events:KeyPress"> +<indexterm zone="events:KeyPress" significance="preferred"><primary>KeyPress</primary></indexterm> +<emphasis role='bold'>KeyPress</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>KeyRelease</primary></indexterm> -<emphasis role='bold' id="events:KeyRelease">KeyRelease</emphasis> + <entry id="events:KeyRelease"> +<indexterm zone="events:KeyRelease" significance="preferred"><primary>KeyRelease</primary></indexterm> +<emphasis role='bold'>KeyRelease</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>ButtonPress</primary></indexterm> -<emphasis role='bold' id="events:ButtonPress">ButtonPress</emphasis> + <entry id="events:ButtonPress"> +<indexterm zone="events:ButtonPress" significance="preferred"><primary>ButtonPress</primary></indexterm> +<emphasis role='bold'>ButtonPress</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>ButtonRelease</primary></indexterm> -<emphasis role='bold' id="events:ButtonRelease">ButtonRelease</emphasis> + <entry id="events:ButtonRelease"> +<indexterm zone="events:ButtonRelease" significance="preferred"><primary>ButtonRelease</primary></indexterm> +<emphasis role='bold'>ButtonRelease</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>MotionNotify</primary></indexterm> -<emphasis role='bold' id="events:MotionNotify">MotionNotify</emphasis> + <entry id="events:MotionNotify"> +<indexterm zone="events:MotionNotify" significance="preferred"><primary>MotionNotify</primary></indexterm> +<emphasis role='bold'>MotionNotify</emphasis> </entry> </row> <row rowsep='0'> @@ -12715,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 @@ -12828,15 +12881,15 @@ request. <colspec colname='c1' colsep='0'/> <tbody> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>EnterNotify</primary></indexterm> -<emphasis role='bold' id="events:EnterNotify">EnterNotify</emphasis> + <entry id="events:EnterNotify"> +<indexterm zone="events:EnterNotify" significance="preferred"><primary>EnterNotify</primary></indexterm> +<emphasis role='bold'>EnterNotify</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>LeaveNotify</primary></indexterm> -<emphasis role='bold' id="events:LeaveNotify">LeaveNotify</emphasis> + <entry id="events:LeaveNotify"> +<indexterm zone="events:LeaveNotify" significance="preferred"><primary>LeaveNotify</primary></indexterm> +<emphasis role='bold'>LeaveNotify</emphasis> </entry> </row> <row rowsep='0'> @@ -13184,22 +13237,22 @@ and final positions for the events. </section> <section id="events:input_focus"> <title>Input Focus events</title> - <indexterm significance="preferred"><primary>Input focus</primary><secondary>events</secondary></indexterm> + <indexterm zone="events:input_focus" significance="preferred"><primary>Input focus</primary><secondary>events</secondary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> <tbody> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>FocusIn</primary></indexterm> -<emphasis role='bold' id="events:FocusIn">FocusIn</emphasis> + <entry id="events:FocusIn"> +<indexterm zone="events:FocusIn" significance="preferred"><primary>FocusIn</primary></indexterm> +<emphasis role='bold'>FocusIn</emphasis> </entry> </row> <row rowsep='0'> - <entry> -<indexterm significance="preferred"><primary>FocusOut</primary></indexterm> -<emphasis role='bold' id="events:FocusOut">FocusOut</emphasis> + <entry id="events:FocusOut"> +<indexterm zone="events:FocusOut" significance="preferred"><primary>FocusOut</primary></indexterm> +<emphasis role='bold'>FocusOut</emphasis> </entry> </row> <row rowsep='0'> @@ -13700,7 +13753,7 @@ above) as if the focus were to change from G to F. </section> <section id="events:KeymapNotify"> <title>KeymapNotify</title> - <indexterm significance="preferred"><primary>KeymapNotify</primary></indexterm> + <indexterm zone="events:KeymapNotify" significance="preferred"><primary>KeymapNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> @@ -13734,7 +13787,8 @@ and </section> <section id="events:Expose"> <title>Expose</title> - <indexterm significance="preferred"><primary>Expose</primary></indexterm> + <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'/> @@ -13841,7 +13895,7 @@ events is not constrained. </section> <section id="events:GraphicsExposure"> <title>GraphicsExposure</title> - <indexterm significance="preferred"><primary>GraphicsExposure</primary></indexterm> + <indexterm zone="events:GraphicsExposure" significance="preferred"><primary>GraphicsExposure</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -13916,7 +13970,7 @@ and minor-opcode is always zero. </section> <section id="events:NoExposure"> <title>NoExposure</title> - <indexterm significance="preferred"><primary>NoExposure</primary></indexterm> + <indexterm zone="events:NoExposure" significance="preferred"><primary>NoExposure</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -13970,7 +14024,7 @@ and the minor-opcode is always zero. </section> <section id="events:VisibilityNotify"> <title>VisibilityNotify</title> - <indexterm significance="preferred"><primary>VisibilityNotify</primary></indexterm> + <indexterm zone="events:VisibilityNotify" significance="preferred"><primary>VisibilityNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14063,7 +14117,7 @@ events is not constrained. </section> <section id="events:CreateNotify"> <title>CreateNotify</title> - <indexterm significance="preferred"><primary>CreateNotify</primary></indexterm> + <indexterm zone="events:CreateNotify" significance="preferred"><primary>CreateNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14113,7 +14167,7 @@ request. </section> <section id="events:DestroyNotify"> <title>DestroyNotify</title> - <indexterm significance="preferred"><primary>DestroyNotify</primary></indexterm> + <indexterm zone="events:DestroyNotify" significance="preferred"><primary>DestroyNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14159,7 +14213,7 @@ otherwise constrained. </section> <section id="events:UnmapNotify"> <title>UnmapNotify</title> - <indexterm significance="preferred"><primary>UnmapNotify</primary></indexterm> + <indexterm zone="events:UnmapNotify" significance="preferred"><primary>UnmapNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14205,7 +14259,8 @@ when the window itself had a win-gravity of </section> <section id="events:MapNotify"> <title>MapNotify</title> - <indexterm significance="preferred"><primary>MapNotify</primary></indexterm> + <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'/> @@ -14247,7 +14302,7 @@ The override-redirect flag is from the window's attribute. </section> <section id="events:MapRequest"> <title>MapRequest</title> - <indexterm significance="preferred"><primary>MapRequest</primary></indexterm> + <indexterm zone="events:MapRequest" significance="preferred"><primary>MapRequest</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14281,7 +14336,7 @@ request is issued on an unmapped window with an override-redirect attribute of </section> <section id="events:ReparentNotify"> <title>ReparentNotify</title> - <indexterm significance="preferred"><primary>ReparentNotify</primary></indexterm> + <indexterm zone="events:ReparentNotify" significance="preferred"><primary>ReparentNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14331,7 +14386,7 @@ The override-redirect flag is from the window's attribute. </section> <section id="events:ConfigureNotify"> <title>ConfigureNotify</title> - <indexterm significance="preferred"><primary>ConfigureNotify</primary></indexterm> + <indexterm zone="events:ConfigureNotify" significance="preferred"><primary>ConfigureNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14398,7 +14453,7 @@ The override-redirect flag is from the window's attribute. </section> <section id="events:GravityNotify"> <title>GravityNotify</title> - <indexterm significance="preferred"><primary>GravityNotify</primary></indexterm> + <indexterm zone="events:GravityNotify" significance="preferred"><primary>GravityNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14442,7 +14497,7 @@ and specify the position of the upper-left outer corner of the window. </section> <section id="events:ResizeRequest"> <title>ResizeRequest</title> - <indexterm significance="preferred"><primary>ResizeRequest</primary></indexterm> + <indexterm zone="events:ResizeRequest" significance="preferred"><primary>ResizeRequest</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14482,7 +14537,7 @@ The width and height are the requested inside size, not including the border. </section> <section id="events:ConfigureRequest"> <title>ConfigureRequest</title> - <indexterm significance="preferred"><primary>ConfigureRequest</primary></indexterm> + <indexterm zone="events:ConfigureRequest" significance="preferred"><primary>ConfigureRequest</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14556,7 +14611,7 @@ and </section> <section id="events:CirculateNotify"> <title>CirculateNotify</title> - <indexterm significance="preferred"><primary>CirculateNotify</primary></indexterm> + <indexterm zone="events:CirculateNotify" significance="preferred"><primary>CirculateNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14605,7 +14660,7 @@ Otherwise, it is below all siblings. </section> <section id="events:CirculateRequest"> <title>CirculateRequest</title> - <indexterm significance="preferred"><primary>CirculateRequest</primary></indexterm> + <indexterm zone="events:CirculateRequest" significance="preferred"><primary>CirculateRequest</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14647,7 +14702,7 @@ and the place specifies what the new position in the stacking order should be. </section> <section id="events:PropertyNotify"> <title>PropertyNotify</title> - <indexterm significance="preferred"><primary>PropertyNotify</primary></indexterm> + <indexterm zone="events:PropertyNotify" significance="preferred"><primary>PropertyNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14714,7 +14769,7 @@ The timestamp indicates the server time when the property was changed. </section> <section id="events:SelectionClear"> <title>SelectionClear</title> - <indexterm significance="preferred"><primary>SelectionClear</primary></indexterm> + <indexterm zone="events:SelectionClear" significance="preferred"><primary>SelectionClear</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14759,7 +14814,7 @@ request. </section> <section id="events:SelectionRequest"> <title>SelectionRequest</title> - <indexterm significance="preferred"><primary>SelectionRequest</primary></indexterm> + <indexterm zone="events:SelectionRequest" significance="preferred"><primary>SelectionRequest</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14832,7 +14887,7 @@ standard <citetitle>Inter-Client Communication Conventions Manual</citetitle>. </section> <section id="events:SelectionNotify"> <title>SelectionNotify</title> - <indexterm significance="preferred"><primary>SelectionNotify</primary></indexterm> + <indexterm zone="events:SelectionNotify" significance="preferred"><primary>SelectionNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14887,7 +14942,7 @@ or when a selection conversion could not be performed (indicated with property </section> <section id="events:ColormapNotify"> <title>ColormapNotify</title> - <indexterm significance="preferred"><primary>ColormapNotify</primary></indexterm> + <indexterm zone="events:ColormapNotify" significance="preferred"><primary>ColormapNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14944,7 +14999,7 @@ the state indicates whether the colormap is currently installed. </section> <section id="events:MappingNotify"> <title>MappingNotify</title> - <indexterm significance="preferred"><primary>MappingNotify</primary></indexterm> + <indexterm zone="events:MappingNotify" significance="preferred"><primary>MappingNotify</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> @@ -14996,7 +15051,7 @@ then first-keycode and count indicate the range of altered keycodes. </section> <section id="events:ClientMessage"> <title>ClientMessage</title> - <indexterm significance="preferred"><primary>ClientMessage</primary></indexterm> + <indexterm zone="events:ClientMessage" significance="preferred"><primary>ClientMessage</primary></indexterm> <informaltable frame='none'> <tgroup cols='1' align='left'> <colspec colname='c1' colsep='0'/> diff --git a/proto/x11proto/specs/x11protocol.xml b/proto/x11proto/specs/x11protocol.xml index 562ed01ed..7a210a920 100644 --- a/proto/x11proto/specs/x11protocol.xml +++ b/proto/x11proto/specs/x11protocol.xml @@ -63,6 +63,6 @@ in this Software without prior written authorization from the Open Group. <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="keysyms.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="encoding.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="glossary.xml"/> -<index /> +<index id="index" /> </book> |