summaryrefslogtreecommitdiff
path: root/doc/xorg-docs/specs
diff options
context:
space:
mode:
Diffstat (limited to 'doc/xorg-docs/specs')
-rw-r--r--doc/xorg-docs/specs/CTEXT/Makefile.am12
-rw-r--r--doc/xorg-docs/specs/CTEXT/Makefile.in243
-rw-r--r--doc/xorg-docs/specs/CTEXT/ctext.xml194
-rw-r--r--doc/xorg-docs/specs/ICCCM/Makefile.am12
-rw-r--r--doc/xorg-docs/specs/ICCCM/Makefile.in243
-rw-r--r--doc/xorg-docs/specs/ICCCM/icccm.xml1541
-rw-r--r--doc/xorg-docs/specs/Makefile.in11
-rw-r--r--doc/xorg-docs/specs/XLFD/Makefile.am12
-rw-r--r--doc/xorg-docs/specs/XLFD/Makefile.in243
-rw-r--r--doc/xorg-docs/specs/XLFD/xlfd.xml745
-rw-r--r--doc/xorg-docs/specs/Xext/Makefile.am12
-rw-r--r--doc/xorg-docs/specs/Xext/Makefile.in243
-rw-r--r--doc/xorg-docs/specs/Xext/lbxalg.xml23
-rw-r--r--doc/xorg-docs/specs/Xserver/Makefile.am12
-rw-r--r--doc/xorg-docs/specs/Xserver/Makefile.in243
-rw-r--r--doc/xorg-docs/specs/Xserver/XACE-Spec.xml48
-rw-r--r--doc/xorg-docs/specs/Xserver/analysis.xml259
-rw-r--r--doc/xorg-docs/specs/Xserver/appgroup.xml46
-rw-r--r--doc/xorg-docs/specs/Xserver/secint.xml77
19 files changed, 2224 insertions, 1995 deletions
diff --git a/doc/xorg-docs/specs/CTEXT/Makefile.am b/doc/xorg-docs/specs/CTEXT/Makefile.am
index 9492c4a11..43847e068 100644
--- a/doc/xorg-docs/specs/CTEXT/Makefile.am
+++ b/doc/xorg-docs/specs/CTEXT/Makefile.am
@@ -1,9 +1,13 @@
+
if ENABLE_SPECS
-xmldir = $(docdir)/$(subdir)
-doc_sources = ctext.xml
-dist_xml_DATA = $(doc_sources)
+# Main DocBook/XML files (DOCTYPE book)
+docbook = ctext.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+shelfdir = $(docdir)/ctext
-include $(top_srcdir)/xmlrules.in
+# Generate DocBook/XML output formats with or without stylesheets
+include $(top_srcdir)/docbook.am
endif ENABLE_SPECS
diff --git a/doc/xorg-docs/specs/CTEXT/Makefile.in b/doc/xorg-docs/specs/CTEXT/Makefile.in
index cf440f451..77a254c4e 100644
--- a/doc/xorg-docs/specs/CTEXT/Makefile.in
+++ b/doc/xorg-docs/specs/CTEXT/Makefile.in
@@ -15,26 +15,19 @@
@SET_MAKE@
#
-# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+# Generate output formats for a single DocBook/XML with/without chapters
#
-# 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:
+# 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.
#
-# 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.
+# 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.
#
srcdir = @srcdir@
@@ -46,9 +39,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ../..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -59,10 +52,14 @@ PRE_UNINSTALL = :
POST_UNINSTALL = :
build_triplet = @build@
host_triplet = @host@
-DIST_COMMON = $(am__dist_xml_DATA_DIST) $(srcdir)/Makefile.am \
- $(srcdir)/Makefile.in $(top_srcdir)/xmlrules.in
-@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt)
+DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
+ $(srcdir)/Makefile.in $(top_srcdir)/docbook.am
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
subdir = specs/CTEXT
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
@@ -72,17 +69,17 @@ mkinstalldirs = $(SHELL) $(install_sh) -d
CONFIG_CLEAN_FILES =
SOURCES =
DIST_SOURCES =
-am__dist_xml_DATA_DIST = ctext.xml
+am__dist_shelf_DATA_DIST = ctext.xml
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
am__vpath_adj = case $$p in \
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
*) f=$$p;; \
esac;
am__strip_dir = `echo $$p | sed -e 's|^.*/||'`;
-am__installdirs = "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"
-dist_xmlDATA_INSTALL = $(INSTALL_DATA)
-xmlDATA_INSTALL = $(INSTALL_DATA)
-DATA = $(dist_xml_DATA) $(xml_DATA)
+am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
+dist_shelfDATA_INSTALL = $(INSTALL_DATA)
+shelfDATA_INSTALL = $(INSTALL_DATA)
+DATA = $(dist_shelf_DATA) $(shelf_DATA)
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
ACLOCAL = @ACLOCAL@
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
@@ -97,6 +94,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -130,6 +128,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -160,12 +160,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
@@ -210,26 +212,73 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-@ENABLE_SPECS_TRUE@xmldir = $(docdir)/$(subdir)
-@ENABLE_SPECS_TRUE@doc_sources = ctext.xml
-@ENABLE_SPECS_TRUE@dist_xml_DATA = $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@xml_DATA = \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2)
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath $(XORG_SGML_PATH)/X11 \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam img.src.path=$(abs_builddir)/
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html
+
+# Main DocBook/XML files (DOCTYPE book)
+@ENABLE_SPECS_TRUE@docbook = ctext.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+@ENABLE_SPECS_TRUE@shelfdir = $(docdir)/ctext
+
+# DocBook/XML generated output formats to be installed
+@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
+@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
+
+# DocBook/XML file with chapters, appendix and images it includes
+@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
+
+
+# Generate documents cross-reference target databases
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+
+@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
all: all-am
.SUFFIXES:
-.SUFFIXES: .xml .ps .pdf .txt .html
-$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/xmlrules.in $(am__configure_deps)
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
@for dep in $?; do \
case '$(am__configure_deps)' in \
*$$dep*) \
@@ -259,39 +308,39 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
uninstall-info-am:
-install-dist_xmlDATA: $(dist_xml_DATA)
+install-dist_shelfDATA: $(dist_shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(dist_xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(dist_xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(dist_shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(dist_shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-dist_xmlDATA:
+uninstall-dist_shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
-install-xmlDATA: $(xml_DATA)
+install-shelfDATA: $(shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-xmlDATA:
+uninstall-shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(xml_DATA)'; for p in $$list; do \
+ @list='$(shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
tags: TAGS
TAGS:
@@ -332,7 +381,7 @@ check-am: all-am
check: check-am
all-am: Makefile $(DATA)
installdirs:
- for dir in "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"; do \
+ for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
test -z "$$dir" || $(mkdir_p) "$$dir"; \
done
install: install-am
@@ -360,11 +409,9 @@ distclean-generic:
maintainer-clean-generic:
@echo "This command is intended for maintainers to use"
@echo "it deletes files that may require special tools to rebuild."
-@ENABLE_SPECS_FALSE@clean-local:
-@HAVE_XMLTO_FALSE@clean-local:
clean: clean-am
-clean-am: clean-generic clean-local mostlyclean-am
+clean-am: clean-generic mostlyclean-am
distclean: distclean-am
-rm -f Makefile
@@ -380,7 +427,7 @@ info: info-am
info-am:
-install-data-am: install-dist_xmlDATA install-xmlDATA
+install-data-am: install-dist_shelfDATA install-shelfDATA
install-exec-am:
@@ -406,37 +453,33 @@ ps: ps-am
ps-am:
-uninstall-am: uninstall-dist_xmlDATA uninstall-info-am \
- uninstall-xmlDATA
-
-.PHONY: all all-am check check-am clean clean-generic clean-local \
- distclean distclean-generic distdir dvi dvi-am html html-am \
- info info-am install install-am install-data install-data-am \
- install-dist_xmlDATA install-exec install-exec-am install-info \
- install-info-am install-man install-strip install-xmlDATA \
- installcheck installcheck-am installdirs maintainer-clean \
- maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
- pdf-am ps ps-am uninstall uninstall-am uninstall-dist_xmlDATA \
- uninstall-info-am uninstall-xmlDATA
-
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@chunked-html: $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources)
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@clean-local:
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)rm -fr html/
+uninstall-am: uninstall-dist_shelfDATA uninstall-info-am \
+ uninstall-shelfDATA
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am html html-am info info-am \
+ install install-am install-data install-data-am \
+ install-dist_shelfDATA install-exec install-exec-am \
+ install-info install-info-am install-man install-shelfDATA \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-dist_shelfDATA uninstall-info-am uninstall-shelfDATA
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
+
+# Generate DocBook/XML output formats with or without stylesheets
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/xorg-docs/specs/CTEXT/ctext.xml b/doc/xorg-docs/specs/CTEXT/ctext.xml
index 2561e8bc8..809f78971 100644
--- a/doc/xorg-docs/specs/CTEXT/ctext.xml
+++ b/doc/xorg-docs/specs/CTEXT/ctext.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<!-- lifted from troff+ms+XMan by doclifter -->
@@ -9,16 +12,15 @@
<articleinfo>
<title>Compound Text Encoding</title>
<subtitle>X Consortium Standard</subtitle>
- <releaseinfo>X Version 11, Release 6.8</releaseinfo>
<authorgroup>
<author>
<firstname>Robert</firstname><othername>W.</othername><surname>Scheifler</surname>
+ <affiliation><orgname>X Consortium</orgname></affiliation>
</author>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
<copyright><year>1989</year><holder>X Consortium</holder></copyright>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
<releaseinfo>Version 1.1</releaseinfo>
- <affiliation><orgname>X Consortium</orgname></affiliation>
<legalnotice>
<para>
@@ -36,7 +38,7 @@ all copies or substantial portions of the Software.
</para>
<para>
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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
X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
@@ -49,6 +51,7 @@ Except as contained in this notice, the name of the X Consortium shall not be
used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization from the X Consortium.
</para>
+<para>X Window System is a trademark of The Open Group.</para>
</legalnotice>
</articleinfo>
<sect1 id="Overview">
@@ -95,23 +98,24 @@ For our purposes, the octet encoding space is divided into four ranges:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="9*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="9.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>C0</entry>
<entry>octets from 00/00 to 01/15</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>GL</entry>
<entry>octets from 02/00 to 07/15</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>C1</entry>
<entry>octets from 08/00 to 09/15</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>GR</entry>
<entry>octets from 10/00 to 15/15</entry>
</row>
@@ -141,22 +145,23 @@ In C0, only the following values will be used:
</para>
<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="5*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="1.0*"/>
+ <colspec colname='c3' colwidth="5.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>00/09</entry>
<entry>HT</entry>
<entry>HORIZONTAL TABULATION</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>00/10</entry>
<entry>NL</entry>
<entry>NEW LINE</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>ESC</entry>
<entry>(ESCAPE)</entry>
@@ -170,12 +175,13 @@ In C1, only the following value will be used:
</para>
<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="5*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="1.0*"/>
+ <colspec colname='c3' colwidth="5.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>09/11</entry>
<entry>CSI</entry>
<entry>CONTROL SEQUENCE INTRODUCER</entry>
@@ -247,19 +253,20 @@ the GL set, one of the following control sequences is used:
</para>
<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="2*"/>
- <colspec colname='c4' colsep="0" colwidth="8*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='4' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="1.0*"/>
+ <colspec colname='c3' colwidth="2.0*"/>
+ <colspec colname='c4' colwidth="8.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>02/08</entry>
<entry>{I} F</entry>
<entry>94 character set</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>02/04</entry>
<entry>02/08{I} F</entry>
@@ -276,25 +283,26 @@ the GR set, one of the following control sequences is used:
</para>
<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="2*"/>
- <colspec colname='c4' colsep="0" colwidth="8*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='4' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="1.0*"/>
+ <colspec colname='c3' colwidth="2.0*"/>
+ <colspec colname='c4' colwidth="8.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>02/09</entry>
<entry>{I} F</entry>
<entry>94 character set</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>02/13</entry>
<entry>{I} F</entry>
<entry>96 character set</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11</entry>
<entry>02/04</entry>
<entry>02/09 {I} F</entry>
@@ -336,19 +344,20 @@ The value of N is derived from the column value for F:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="3*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="3.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>column 04 or 05</entry>
<entry>2 octets</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>column 06</entry>
<entry>3 octets</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>column 07</entry>
<entry>4 or more octets</entry>
</row>
@@ -395,20 +404,21 @@ still deal with Intermediate characters in the event that additional encodings
are later added to this list.
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="5*"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="auto" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="1.0*"/>
+ <colspec colname='c3' colwidth="10.0*"/>
<thead>
- <row>
+ <row rowsep='1'>
<entry>{I} F</entry>
<entry>94/96</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>4/02</entry>
<entry>94</entry>
<entry>
@@ -513,27 +523,28 @@ following sequences:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="2*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="2.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>01/11 2/05 02/15 03/00 M L</entry>
<entry>variable number of octets per character</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11 2/05 02/15 03/01 M L</entry>
<entry>1 octet per character</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11 2/05 02/15 03/02 M L</entry>
<entry>2 octet per character</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11 2/05 02/15 03/03 M L</entry>
<entry>3 octet per character</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11 2/05 02/15 03/04 M L</entry>
<entry>4 octet per character</entry>
</row>
@@ -603,19 +614,20 @@ control sequences:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="2*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="2.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>09/11 03/01 05/13</entry>
<entry>begin left-to-right text</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>09/11 03/02 05/13</entry>
<entry>begin right-to-left text</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>09/11 05/13</entry>
<entry>end of string</entry>
</row>
@@ -684,80 +696,81 @@ The following CharSet names for the standard character set encodings are
registered for use in font names under the X Logical Font Description:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="1*"/>
- <colspec colname='c3' colsep="0" colwidth="2*"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="auto" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="2.0*"/>
+ <colspec colname='c3' colwidth="2.0*"/>
<thead>
- <row>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Encoding Standard</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>ISO8859-1</entry>
<entry>ISO8859-1</entry>
<entry>Latinalphabet No. 1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-2</entry>
<entry>ISO8859-2</entry>
<entry>Latinalphabet No. 2</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-3</entry>
<entry>ISO8859-3</entry>
<entry>Latinalphabet No. 3</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-4</entry>
<entry>ISO8859-4</entry>
<entry>Latinalphabet No. 4</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-5</entry>
<entry>ISO 8859-5</entry>
<entry>Latin/Cyrillic alphabet</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-6</entry>
<entry>ISO 8859-6</entry>
<entry>Latin/Arabic alphabet</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-7</entry>
<entry>ISO8859-7</entry>
<entry>Latin/Greekalphabet</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-8</entry>
<entry>ISO8859-8</entry>
<entry>Latin/Hebrew alphabet</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ISO8859-9</entry>
<entry>ISO8859-9</entry>
<entry>Latinalphabet No. 5</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>JISX0201.1976-0</entry>
<entry>JIS X0201-1976 (reaffirmed 1984)</entry>
<entry>8-bit Alphanumeric-Katakana Code</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>GB2312.1980-0</entry>
<entry>GB2312-1980, GL encoding</entry>
<entry>China (PRC) Hanzi</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>JISX0208.1983-0</entry>
<entry>JIS X0208-1983, GL encoding</entry>
<entry>Japanese Graphic Character Set</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>KSC5601.1987-0</entry>
<entry>KS C5601-1987, GL encoding</entry>
<entry>Korean Graphic Character Set</entry>
@@ -832,15 +845,16 @@ control sequences:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0" colwidth="1*"/>
- <colspec colname='c2' colsep="0" colwidth="2*"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth="1.0*"/>
+ <colspec colname='c2' colwidth="2.0*"/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>01/11 02/03 V 03/00</entry>
<entry>ignoring extensions is OK</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>01/11 02/03 V 03/01</entry>
<entry>ignoring extensions is not OK</entry>
</row>
diff --git a/doc/xorg-docs/specs/ICCCM/Makefile.am b/doc/xorg-docs/specs/ICCCM/Makefile.am
index 274a3956f..168232c9b 100644
--- a/doc/xorg-docs/specs/ICCCM/Makefile.am
+++ b/doc/xorg-docs/specs/ICCCM/Makefile.am
@@ -1,9 +1,13 @@
+
if ENABLE_SPECS
-xmldir = $(docdir)/$(subdir)
-doc_sources = icccm.xml
-dist_xml_DATA = $(doc_sources)
+# Main DocBook/XML files (DOCTYPE book)
+docbook = icccm.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+shelfdir = $(docdir)/icccm
-include $(top_srcdir)/xmlrules.in
+# Generate DocBook/XML output formats with or without stylesheets
+include $(top_srcdir)/docbook.am
endif ENABLE_SPECS
diff --git a/doc/xorg-docs/specs/ICCCM/Makefile.in b/doc/xorg-docs/specs/ICCCM/Makefile.in
index ccca6a57f..ee38e2722 100644
--- a/doc/xorg-docs/specs/ICCCM/Makefile.in
+++ b/doc/xorg-docs/specs/ICCCM/Makefile.in
@@ -15,26 +15,19 @@
@SET_MAKE@
#
-# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+# Generate output formats for a single DocBook/XML with/without chapters
#
-# 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:
+# 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.
#
-# 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.
+# 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.
#
srcdir = @srcdir@
@@ -46,9 +39,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ../..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -59,10 +52,14 @@ PRE_UNINSTALL = :
POST_UNINSTALL = :
build_triplet = @build@
host_triplet = @host@
-DIST_COMMON = $(am__dist_xml_DATA_DIST) $(srcdir)/Makefile.am \
- $(srcdir)/Makefile.in $(top_srcdir)/xmlrules.in
-@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt)
+DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
+ $(srcdir)/Makefile.in $(top_srcdir)/docbook.am
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
subdir = specs/ICCCM
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
@@ -72,17 +69,17 @@ mkinstalldirs = $(SHELL) $(install_sh) -d
CONFIG_CLEAN_FILES =
SOURCES =
DIST_SOURCES =
-am__dist_xml_DATA_DIST = icccm.xml
+am__dist_shelf_DATA_DIST = icccm.xml
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
am__vpath_adj = case $$p in \
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
*) f=$$p;; \
esac;
am__strip_dir = `echo $$p | sed -e 's|^.*/||'`;
-am__installdirs = "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"
-dist_xmlDATA_INSTALL = $(INSTALL_DATA)
-xmlDATA_INSTALL = $(INSTALL_DATA)
-DATA = $(dist_xml_DATA) $(xml_DATA)
+am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
+dist_shelfDATA_INSTALL = $(INSTALL_DATA)
+shelfDATA_INSTALL = $(INSTALL_DATA)
+DATA = $(dist_shelf_DATA) $(shelf_DATA)
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
ACLOCAL = @ACLOCAL@
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
@@ -97,6 +94,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -130,6 +128,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -160,12 +160,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
@@ -210,26 +212,73 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-@ENABLE_SPECS_TRUE@xmldir = $(docdir)/$(subdir)
-@ENABLE_SPECS_TRUE@doc_sources = icccm.xml
-@ENABLE_SPECS_TRUE@dist_xml_DATA = $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@xml_DATA = \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2)
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath $(XORG_SGML_PATH)/X11 \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam img.src.path=$(abs_builddir)/
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html
+
+# Main DocBook/XML files (DOCTYPE book)
+@ENABLE_SPECS_TRUE@docbook = icccm.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+@ENABLE_SPECS_TRUE@shelfdir = $(docdir)/icccm
+
+# DocBook/XML generated output formats to be installed
+@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
+@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
+
+# DocBook/XML file with chapters, appendix and images it includes
+@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
+
+
+# Generate documents cross-reference target databases
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+
+@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
all: all-am
.SUFFIXES:
-.SUFFIXES: .xml .ps .pdf .txt .html
-$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/xmlrules.in $(am__configure_deps)
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
@for dep in $?; do \
case '$(am__configure_deps)' in \
*$$dep*) \
@@ -259,39 +308,39 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
uninstall-info-am:
-install-dist_xmlDATA: $(dist_xml_DATA)
+install-dist_shelfDATA: $(dist_shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(dist_xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(dist_xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(dist_shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(dist_shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-dist_xmlDATA:
+uninstall-dist_shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
-install-xmlDATA: $(xml_DATA)
+install-shelfDATA: $(shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-xmlDATA:
+uninstall-shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(xml_DATA)'; for p in $$list; do \
+ @list='$(shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
tags: TAGS
TAGS:
@@ -332,7 +381,7 @@ check-am: all-am
check: check-am
all-am: Makefile $(DATA)
installdirs:
- for dir in "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"; do \
+ for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
test -z "$$dir" || $(mkdir_p) "$$dir"; \
done
install: install-am
@@ -360,11 +409,9 @@ distclean-generic:
maintainer-clean-generic:
@echo "This command is intended for maintainers to use"
@echo "it deletes files that may require special tools to rebuild."
-@ENABLE_SPECS_FALSE@clean-local:
-@HAVE_XMLTO_FALSE@clean-local:
clean: clean-am
-clean-am: clean-generic clean-local mostlyclean-am
+clean-am: clean-generic mostlyclean-am
distclean: distclean-am
-rm -f Makefile
@@ -380,7 +427,7 @@ info: info-am
info-am:
-install-data-am: install-dist_xmlDATA install-xmlDATA
+install-data-am: install-dist_shelfDATA install-shelfDATA
install-exec-am:
@@ -406,37 +453,33 @@ ps: ps-am
ps-am:
-uninstall-am: uninstall-dist_xmlDATA uninstall-info-am \
- uninstall-xmlDATA
-
-.PHONY: all all-am check check-am clean clean-generic clean-local \
- distclean distclean-generic distdir dvi dvi-am html html-am \
- info info-am install install-am install-data install-data-am \
- install-dist_xmlDATA install-exec install-exec-am install-info \
- install-info-am install-man install-strip install-xmlDATA \
- installcheck installcheck-am installdirs maintainer-clean \
- maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
- pdf-am ps ps-am uninstall uninstall-am uninstall-dist_xmlDATA \
- uninstall-info-am uninstall-xmlDATA
-
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@chunked-html: $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources)
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@clean-local:
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)rm -fr html/
+uninstall-am: uninstall-dist_shelfDATA uninstall-info-am \
+ uninstall-shelfDATA
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am html html-am info info-am \
+ install install-am install-data install-data-am \
+ install-dist_shelfDATA install-exec install-exec-am \
+ install-info install-info-am install-man install-shelfDATA \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-dist_shelfDATA uninstall-info-am uninstall-shelfDATA
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
+
+# Generate DocBook/XML output formats with or without stylesheets
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/xorg-docs/specs/ICCCM/icccm.xml b/doc/xorg-docs/specs/ICCCM/icccm.xml
index fb39ca78e..10402df55 100644
--- a/doc/xorg-docs/specs/ICCCM/icccm.xml
+++ b/doc/xorg-docs/specs/ICCCM/icccm.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<book id="icccm">
@@ -8,34 +11,24 @@
<bookinfo>
<title>Inter-Client Communication Conventions Manual</title>
<subtitle>X Consortium Standard</subtitle>
- <releaseinfo>Version 2.0</releaseinfo>
<authorgroup>
<author>
<firstname>David</firstname><surname>Rosenthal</surname>
<affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
</author>
- <othercredit>
- <contrib>Version 2 edited by</contrib>
+ <editor>
<firstname>Stuart</firstname><othername>W.</othername><surname>Marks</surname>
<affiliation><orgname>SunSoft, Inc.</orgname></affiliation>
- </othercredit>
+ </editor>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
- <affiliation><orgname>X Consortium</orgname></affiliation>
- <productnumber>X Version 11, Release 6.8</productnumber>
-
-
-<legalnotice>
-<para>
-X Window System is a trademark of The Open Group
-</para>
-</legalnotice>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+ <releaseinfo>Version 2.0</releaseinfo>
+ <copyright><year>1988</year><year>1991</year><year>1993</year><year>1994</year>
+ <holder>X Consortium</holder>
+ </copyright>
<legalnotice>
<para>
-Copyright &copy; 1988, 1991, 1993, 1994 X Consortium
-</para>
-<para>
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
@@ -49,7 +42,7 @@ The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
</para>
<para>
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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 X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
@@ -63,10 +56,11 @@ not be used in advertising or otherwise to promote the sale, use or
other dealings in this Software without prior written authorization
from the X Consortium.
</para>
+<para>X Window System is a trademark of The Open Group.</para>
</legalnotice>
<legalnotice>
-<para>
+<para role="multiLicensing">
Copyright &copy; 1987, 1988, 1989, 1993, 1994 Sun Microsystems, Inc
</para>
<para>
@@ -200,7 +194,7 @@ John Interrante John Thomas
</literallayout>
</preface>
-<chapter id="introduction">
+<chapter id='Introduction'>
<title>Introduction</title>
<para>
It was an explicit design goal of X Version 11 to specify mechanism,
@@ -262,7 +256,7 @@ and to the equivalent interfaces for other languages
is the subject of other documents.
</para>
-<sect1 id="evolution_of_the_conventions">
+<sect1 id='Evolution_of_the_Conventions'>
<title>Evolution of the Conventions</title>
<para>
In the interests of timely acceptance,
@@ -303,7 +297,7 @@ appropriate to protocol minor revision
</para>
</sect1>
-<sect1 id="atoms">
+<sect1 id='Atoms'>
<title>Atoms</title>
<para>
Many of the conventions use atoms.
@@ -311,7 +305,7 @@ To assist the reader,
the following sections attempt to amplify the description of atoms
that is provided in the protocol specification.
</para>
-<sect2 id="what_are_atoms">
+<sect2 id='What_Are_Atoms'>
<title>What Are Atoms?</title>
<para>
At the conceptual level,
@@ -349,7 +343,7 @@ The inverse operator is also available
</para>
</sect2>
-<sect2 id="predefined_atoms">
+<sect2 id='Predefined_Atoms'>
<title>Predefined Atoms</title>
<para>
The protocol specifies a number of atoms as being predefined:
@@ -385,7 +379,7 @@ and will typically initialize this cache with the predefined atoms.
</para>
</sect2>
-<sect2 id="naming_conventions">
+<sect2 id='Naming_Conventions'>
<title>Naming Conventions</title>
<para>
The built-in atoms are composed of uppercase ASCII characters with the
@@ -407,7 +401,7 @@ special quoting conventions would have to be used.
</para>
</sect2>
-<sect2 id="semantics">
+<sect2 id='Semantics'>
<title>Semantics</title>
<para>
The core protocol imposes no semantics on atoms except as they are used in
@@ -416,7 +410,7 @@ For further information on FONTPROP semantics,
see the <emphasis remap='I'>X Logical Font Description Conventions</emphasis>.
</para>
</sect2>
-<sect2 id="name_spaces">
+<sect2 id='Name_Spaces'>
<title>Name Spaces</title>
<para>
The protocol defines six distinct spaces in which atoms are interpreted.
@@ -424,46 +418,45 @@ Any particular atom may or may not have some valid interpretation
with respect to each of these name spaces.
</para>
-<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
- <colspec colname='c4' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.5*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Space</entry>
<entry>Briefly</entry>
<entry>Examples</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>Property name</entry>
<entry>Name</entry>
<entry>WM_HINTS, WM_NAME, RGB_BEST_MAP, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Property type</entry>
<entry>Type</entry>
<entry>WM_HINTS, CURSOR, RGB_COLOR_MAP, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Selection name</entry>
<entry>Selection</entry>
<entry>PRIMARY, SECONDARY, CLIPBOARD</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Selection target</entry>
<entry>Target</entry>
<entry>FILE_NAME, POSTSCRIPT, PIXMAP, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Font property</entry>
<entry></entry>
<entry>QUAD_WIDTH, POINT_SIZE, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>ClientMessage</function> type</entry>
<entry></entry>
<entry>WM_SAVE_YOURSELF, _DEC_SAVE_EDITS, &amp;...</entry>
@@ -473,7 +466,7 @@ with respect to each of these name spaces.
</informaltable>
</sect2>
-<sect2 id="discriminated_names">
+<sect2 id='Discriminated_Names'>
<title>Discriminated Names</title>
<para>
Sometimes a protocol requires an arbitrary number of similar
@@ -504,26 +497,26 @@ exactly 8 digits, and using uppercase letters, then such discriminated names
shall have the form:
</para>
-<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
- <colspec colname='c4' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='2.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='2.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Name Discriminated by</entry>
<entry>Form</entry>
<entry>Example</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>screen number</entry>
<entry><emphasis remap='I'>name</emphasis>_S<emphasis remap='I'>d</emphasis></entry>
<entry>WM_COMMS_S2</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>X resource</entry>
<entry><emphasis remap='I'>name</emphasis>_R<emphasis remap='I'>x</emphasis></entry>
<entry>GROUP_LEADER_R1234ABCD</entry>
@@ -588,7 +581,7 @@ conventions.
</sect1>
</chapter>
-<chapter id="peer_to_peer_communication_by_means_of_selections">
+<chapter id='Peer_to_Peer_Communication_by_Means_of_Selections'>
<title>Peer-to-Peer Communication by Means of Selections</title>
<para>
Selections are the primary mechanism that X Version 11 defines
@@ -596,8 +589,7 @@ for the exchange of information between clients,
for example, by cutting and pasting between windows.
Note that there can be an arbitrary number of selections
(each named by an atom) and that they are global to the server.
-<link linkend="use_of_selection_atoms">
-<xref linkend="use_of_selection_atoms"></xref></link>.
+<xref linkend='Use_of_Selection_Atoms' xrefstyle='select: title'/>.
discusses the choice of an atom.
Each selection is owned by a client and is attached to a window.
</para>
@@ -679,7 +671,7 @@ Thus, passing indirect references to data
is permitted only if both clients specifically agree.
</para>
-<sect1 id="acquiring_selection_ownership">
+<sect1 id='Acquiring_Selection_Ownership'>
<title>Acquiring Selection Ownership</title>
<para>
A client wishing to acquire ownership of a particular selection
@@ -693,19 +685,20 @@ which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>selection</emphasis>: ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>owner</emphasis>: WINDOW or
<function>None</function>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>time</emphasis>: TIMESTAMP or
<function>CurrentTime</function>
@@ -786,16 +779,17 @@ which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>selection</emphasis>: ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>-&gt;</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>owner</emphasis>: WINDOW or
<function>None</function>
@@ -830,7 +824,7 @@ of the selection for the time period starting at the specified time.
</para>
</sect1>
-<sect1 id="responsibilities_of_the_selection_owner">
+<sect1 id='Responsibilities_of_the_Selection_Owner'>
<title>Responsibilities of the Selection Owner</title>
<para>
When a requestor wants the value of a selection,
@@ -844,29 +838,30 @@ event, which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>owner</emphasis>: WINDOW</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>selection</emphasis>: ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>selection</emphasis>: ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>target</emphasis>: ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>property</emphasis>: ATOM or
<function>None</function></entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>requestor</emphasis>: WINDOW</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>time</emphasis>: TIMESTAMP or
<function>CurrentTime</function></entry>
</row>
@@ -949,8 +944,7 @@ the owner must refuse the
<function>SelectionRequest</function>,
as previously described.
See also
-<link linkend="large_data_transfers">
-<xref linkend="large_data_transfers"></xref></link>.
+<xref linkend='Large_Data_Transfers' xrefstyle='select: title'/>.
</para>
@@ -973,25 +967,26 @@ is defined as follows:
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry><emphasis remap='I'>requestor</emphasis>: WINDOW</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>selection</emphasis>,
<emphasis remap='I'>target</emphasis>: ATOM
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>property</emphasis>: ATOM or
<function>None</function>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>time</emphasis>: TIMESTAMP or
<function>CurrentTime</function>
@@ -1056,8 +1051,7 @@ Selection requestors are responsible for deleting properties whose
names they receive in
<function>SelectionNotify</function>
events (See
-<link linkend="requesting_a_selection">
-<xref linkend="requesting_a_selection"></xref></link>
+<xref linkend='Requesting_a_Selection' xrefstyle='select: title'/>
) or in properties with type MULTIPLE.
</para>
</blockquote>
@@ -1095,20 +1089,21 @@ event, which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>owner</emphasis>: WINDOW
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>selection</emphasis>: ATOM
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>time</emphasis>: TIMESTAMP
</entry>
@@ -1150,14 +1145,14 @@ the owner should take no action.
</sect1>
-<sect1 id="giving_up_selection_ownership">
+<sect1 id='Giving_Up_Selection_Ownership'>
<title>Giving Up Selection Ownership</title>
<para>
Clients may either give up selection ownership voluntarily
or lose it forcibly as the result of some other client's actions.
</para>
-<sect2 id="voluntarily_giving_up_selection_ownership">
+<sect2 id='Voluntarily_Giving_Up_Selection_Ownership'>
<title>Voluntarily Giving Up Selection Ownership</title>
<para>
To relinquish ownership of a selection voluntarily,
@@ -1179,7 +1174,7 @@ the ownership of the selection involved will revert to
</para>
</sect2>
-<sect2 id="forcibly_giving_up_selection_ownership">
+<sect2 id='Forcibly_Giving_Up_Selection_Ownership'>
<title>Forcibly Giving Up Selection Ownership</title>
<para>
If a client gives up ownership of a selection
@@ -1191,8 +1186,7 @@ the previous owner will receive a
event. For the definition of a
<function>SelectionClear</function>
event, see
-<link linkend="responsibilities_of_the_selection_owner">
-<xref linkend="responsibilities_of_the_selection_owner"></xref></link>
+<xref linkend='Responsibilities_of_the_Selection_Owner' xrefstyle='select: title'/>
</para>
<para>
@@ -1205,7 +1199,7 @@ request.
</sect2>
</sect1>
-<sect1 id="requesting_a_selection">
+<sect1 id='Requesting_a_Selection'>
<title>Requesting a Selection</title>
<para>
A client that wishes to obtain the value of a selection in a particular
@@ -1220,27 +1214,28 @@ request, which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>selection</emphasis>,
<emphasis remap='I'>target</emphasis>: ATOM
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>property</emphasis>: ATOM or
<function>None</function>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>requestor</emphasis>: WINDOW
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>time</emphasis>: TIMESTAMP or
<function>CurrentTime</function>
@@ -1255,8 +1250,7 @@ The selection argument specifies the particular selection involved,
and the target argument specifies the required form of the information.
For information about the choice of suitable atoms to use,
see
-<link linkend="use_of_selection_atoms">
-<xref linkend="use_of_selection_atoms"></xref></link>
+<xref linkend='Use_of_Selection_Atoms' xrefstyle='select: title'/>
The requestor should set the requestor argument to a window that it created;
the owner will place the reply property there.
The requestor should set the time argument to the timestamp on the event
@@ -1369,8 +1363,7 @@ event will be received.
For the definition of a
<function>SelectionNotify</function>
event, see
-<link linkend="responsibilities_of_the_selection_owner">
-<xref linkend="responsibilities_of_the_selection_owner"></xref></link>.
+<xref linkend='Responsibilities_of_the_Selection_Owner' xrefstyle='select: title'/>.
</para>
<para>
@@ -1405,57 +1398,57 @@ request, which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>window</emphasis>: WINDOW
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>property</emphasis>: ATOM
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>type</emphasis>: ATOM or
<function>AnyPropertyType</function>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>long-offset</emphasis>,
<emphasis remap='I'>long-length</emphasis>: CARD32
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
<emphasis remap='I'>delete</emphasis>: BOOL
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
-&gt;
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
type: ATOM or <function>None</function>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
format: {0, 8, 16, 32}
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
bytes-after: CARD32
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>
value: LISTofINT8 or LISTofINT16 or LISTofINT32
</entry>
@@ -1480,8 +1473,7 @@ Several
requests may be needed to retrieve all the data in the selection;
each should set the long-offset argument to the amount of data received so far,
and the size argument to some reasonable buffer size (see
-<link linkend="large_data_transfers">
-<xref linkend="large_data_transfers"></xref></link>.
+<xref linkend='Large_Data_Transfers' xrefstyle='select: title'/>.
).
If the returned value of bytes-after is zero, <!-- xref -->
the whole property has been transferred.
@@ -1491,8 +1483,7 @@ the whole property has been transferred.
Once all the data in the selection has been retrieved
(which may require getting the values of several properties --
see
-<link linkend="use_of_selection_properties">
-<xref linkend="use_of_selection_properties"></xref></link>.
+<xref linkend='Use_of_Selection_Properties' xrefstyle='select: title'/>.
),
the requestor should delete the property in the
<function>SelectionNotify</function>
@@ -1518,14 +1509,13 @@ The requestor should invoke either
after it has successfully retrieved all the data in the selection.
For further information,
see
-<link linkend="large_data_transfers">
-<xref linkend="large_data_transfers"></xref></link>.
+<xref linkend='Large_Data_Transfers' xrefstyle='select: title'/>.
</para>
</blockquote>
</sect1>
-<sect1 id="large_data_transfers">
+<sect1 id='Large_Data_Transfers'>
<title>Large Data Transfers</title>
<para>
Selections can get large, which poses two problems:
@@ -1565,8 +1555,7 @@ Selection owners should transfer the data describing a large selection
(relative to the maximum-request-size they received
in the connection handshake) using the INCR property mechanism
(see
-<link linkend="incr_properties">
-<xref linkend="incr_properties"></xref></link>.
+<xref linkend='INCR_Properties' xrefstyle='select: title'/>.
). <!-- xref -->
</para>
</listitem>
@@ -1579,7 +1568,7 @@ to acquire selection ownership should arrange to process
errors in property change requests.
For clients using Xlib,
this involves using the
-<function>XSetErrorHandler</function>
+<olink targetdoc='libX11' targetptr='XSetErrorHandler'><function>XSetErrorHandler</function></olink>
function to override the default handler.
</para>
</listitem>
@@ -1613,8 +1602,7 @@ all properties stored for this selection should be deleted
and the
<function>ConvertSelection</function>
request should be refused (see
-<link linkend="responsibilities_of_the_selection_owner">
-<xref linkend="responsibilities_of_the_selection_owner"></xref></link>.
+<xref linkend='Responsibilities_of_the_Selection_Owner' xrefstyle='select: title'/>.
). <!-- xref -->
</para>
</listitem>
@@ -1638,7 +1626,7 @@ data transfers.
</blockquote>
</sect1>
-<sect1 id="use_of_selection_atoms">
+<sect1 id='Use_of_Selection_Atoms'>
<title>Use of Selection Atoms</title>
<para>
Defining a new atom consumes resources in the server
@@ -1647,7 +1635,7 @@ Thus, reducing the need for newly minted atoms is an important goal
for the use of the selection atoms.
</para>
-<sect2 id="selection_atoms">
+<sect2 id='Selection_Atoms'>
<title>Selection Atoms</title>
<para>
There can be an arbitrary number of selections, each named by an atom.
@@ -1677,7 +1665,7 @@ Other selections may be used freely for private communication among
related groups of clients.
</para>
-<sect3 id="the_primary_Selection">
+<sect3 id='The_PRIMARY_Selection'>
<title>The PRIMARY Selection</title>
<para>
The selection named by the atom PRIMARY is used for all commands
@@ -1686,7 +1674,7 @@ between clients that use the selection mechanism.
</para>
</sect3>
-<sect3 id="the_secondary_Selection">
+<sect3 id='The_SECONDARY_Selection'>
<title>The SECONDARY Selection</title>
<para>
The selection named by the atom SECONDARY is used:
@@ -1707,7 +1695,7 @@ and the user does not want to disturb it
</itemizedlist>
</sect3>
-<sect3 id="the_clipboard_selection">
+<sect3 id='The_CLIPBOARD_Selection'>
<title>The CLIPBOARD Selection</title>
<para>
The selection named by the atom CLIPBOARD is used to hold data
@@ -1853,7 +1841,7 @@ Flexibility - The clipboard data may be available as more than one target.
</sect3>
</sect2>
-<sect2 id="target_atoms">
+<sect2 id='Target_Atoms'>
<title>Target Atoms</title>
<para>
The atom that a requestor supplies as the target of a
@@ -1874,86 +1862,84 @@ embedded in the table. This means that the auto-numbering needs to be
dinked around with after the end of the table.
-->
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.5*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='1.5*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Atom</entry>
<entry>Type </entry>
<entry>Data Received</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
- <entry>ADOBE_PORTABLE_DOCUMENT_FORMAT</entry>
+ <row>
+ <entry>ADOBE_PORTABLE_&shy;DOCUMENT_&shy;FORMAT</entry>
<entry>STRING</entry>
<entry>[1]</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>APPLE_PICT</entry>
<entry>APPLE_PICT</entry>
<entry>[2]</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>BACKGROUND</entry>
<entry>PIXEL</entry>
<entry>A list of pixel values</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>BITMAP</entry>
<entry>BITMAP</entry>
<entry>A list of bitmap IDs</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>CHARACTER_POSITION</entry>
<entry>SPAN</entry>
<entry>The start and end of the selection in bytes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>CLASS</entry>
<entry>TEXT</entry>
<entry>(see
-<link linkend="wm_class_property">
-<xref linkend="wm_class_property"></xref></link>.
+<xref linkend='WM_CLASS_Property' xrefstyle='select: title'/>.
)</entry> <!-- xref -->
</row>
- <row rowsep="0">
+ <row>
<entry>CLIENT_WINDOW</entry>
<entry>WINDOW</entry>
<entry>Any top-level window owned by the selection owner</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COLORMAP</entry>
<entry>COLORMAP</entry>
<entry>A list of colormap IDs</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COLUMN_NUMBER</entry>
<entry>SPAN</entry>
<entry>The start and end column numbers</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COMPOUND_TEXT</entry>
<entry>COMPOUND_TEXT</entry>
<entry>Compound Text</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DELETE</entry>
<entry>NULL</entry>
<entry>(see
-<link linkend="delete">
-<xref linkend="delete"></xref></link>.
+<xref linkend='DELETE' xrefstyle='select: title'/>.
)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DRAWABLE</entry>
<entry>DRAWABLE</entry>
<entry>A list of drawable IDs</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ENCAPSULATED_POSTSCRIPT</entry>
<entry>STRING</entry>
<entry>[3], Appendix H
@@ -1965,46 +1951,43 @@ type as well to allow for compatibility with older clients.
</para></footnote>
</entry>
</row>
- <row rowsep="0">
- <entry>ENCAPSULATED_POSTSCRIPT_INTERCHANGE</entry>
+ <row>
+ <entry>ENCAPSULATED_POSTSCRIPT_&shy;INTERCHANGE</entry>
<entry>STRING</entry>
<entry>[3], Appendix H</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FILE_NAME</entry>
<entry>TEXT</entry>
<entry>The full path name of a file</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FOREGROUND</entry>
<entry>PIXEL</entry>
<entry>A list of pixel values</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>HOST_NAME</entry>
<entry>TEXT</entry>
<entry>(see
-<link linkend="wm_client_machine_property">
-<xref linkend="wm_client_machine_property"></xref></link>.
+<xref linkend='WM_CLIENT_MACHINE_Property' xrefstyle='select: title'/>.
)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>INSERT_PROPERTY</entry>
<entry>NULL</entry>
<entry>(see
-<link linkend="insert_property">
-<xref linkend="insert_property"></xref></link>.
+<xref linkend='INSERT_PROPERTY' xrefstyle='select: title'/>.
)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>INSERT_SELECTION</entry>
<entry>NULL</entry>
<entry>(see
-<link linkend="insert_selection">
-<xref linkend="insert_selection"></xref></link>.
+<xref linkend='INSERT_SELECTION' xrefstyle='select: title'/>.
)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>LENGTH</entry>
<entry>INTEGER</entry>
<entry>The number of bytes in the selection
@@ -2017,45 +2000,44 @@ backward compatibility.
</para></footnote>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>LINE_NUMBER</entry>
<entry>SPAN</entry>
<entry>The start and end line numbers</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>LIST_LENGTH</entry>
<entry>INTEGER</entry>
<entry>The number of disjoint parts of the selection</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>MODULE</entry>
<entry>TEXT</entry>
<entry>The name of the selected procedure</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>MULTIPLE</entry>
<entry>ATOM_PAIR</entry>
<entry>(see the discussion that follows)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>NAME</entry>
<entry>TEXT</entry>
<entry>(see
-<link linkend="wm_name_property">
-<xref linkend="wm_name_property"></xref></link>.
+<xref linkend='WM_NAME_Property' xrefstyle='select: title'/>.
)</entry> <!-- xref -->
</row>
- <row rowsep="0">
+ <row>
<entry>ODIF</entry>
<entry>TEXT</entry>
<entry>ISO Office Document Interchange Format</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OWNER_OS</entry>
<entry>TEXT</entry>
<entry>The operating system of the owner client</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PIXMAP</entry>
<entry>PIXMAP
<footnote>
@@ -2070,47 +2052,47 @@ the result of a conversion to LENGTH; its use is thus deprecated.
</entry>
<entry>A list of pixmap IDs</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>POSTSCRIPT</entry>
<entry>STRING</entry>
<entry>[3]</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PROCEDURE</entry>
<entry>TEXT</entry>
<entry>The name of the selected procedure</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PROCESS</entry>
<entry>INTEGER, TEXT</entry>
<entry>The process ID of the owner</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>STRING</entry>
<entry>STRING</entry>
<entry>ISO Latin-1 (+TAB+NEWLINE) text</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>TARGETS</entry>
<entry>ATOM</entry>
<entry>A list of valid target atoms</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>TASK</entry>
<entry>INTEGER, TEXT</entry>
<entry>The task ID of the owner</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>TEXT</entry>
<entry>TEXT</entry>
<entry>The text in the owner's choice of encoding</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>TIMESTAMP</entry>
<entry>INTEGER</entry>
<entry>The timestamp used to acquire the selection</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>USER</entry>
<entry>TEXT</entry>
<entry>The name of the user running the owner</entry>
@@ -2250,8 +2232,7 @@ The entries in a MULTIPLE property must be processed in the order
they appear in the property.
For further information,
see
-<link linkend="selection_targets_with_side_effects">
-<xref linkend="selection_targets_with_side_effects"></xref></link>.
+<xref linkend='Selection_Targets_with_Side_Effects' xrefstyle='select: title'/>.
</para>
</blockquote>
<para>
@@ -2284,7 +2265,7 @@ returning the timestamp they used to obtain the selection.
</itemizedlist>
</sect2>
-<sect2 id="selection_targets_with_side_effects">
+<sect2 id='Selection_Targets_with_Side_Effects'>
<title>Selection Targets with Side Effects</title>
<para>
Some targets (for example, DELETE) have side effects.
@@ -2345,7 +2326,7 @@ These side-effect targets are used to implement operations such as
"exchange PRIMARY and SECONDARY selections."
</para>
-<sect3 id="delete">
+<sect3 id='DELETE'>
<title>DELETE</title>
<para>
When the owner of a selection receives a request to convert it to DELETE,
@@ -2355,7 +2336,7 @@ and return a zero-length property of type NULL if the deletion was successful.
</para>
</sect3>
-<sect3 id="insert_selection">
+<sect3 id='INSERT_SELECTION'>
<title>INSERT_SELECTION</title>
<para>
When the owner of a selection receives a request to convert it to
@@ -2369,7 +2350,7 @@ for which it got the INSERT_SELECTION request
(whatever doing so means for its internal data structures).
</para>
</sect3>
-<sect3 id="insert_property">
+<sect3 id='INSERT_PROPERTY'>
<title>INSERT_PROPERTY</title>
<para>
When the owner of a selection receives a request to convert it to
@@ -2382,7 +2363,7 @@ of the selection for which it got the INSERT_SELECTION request
</sect2>
</sect1>
-<sect1 id="use_of_selection_properties">
+<sect1 id='Use_of_Selection_Properties'>
<title>Use of Selection Properties</title>
<para>
The names of the properties used in selection data transfer are chosen by
@@ -2429,90 +2410,90 @@ For variable-length items such as text,
the separators are also listed.
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.5*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Type Atom</entry>
<entry>Format</entry>
<entry>Separator</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>APPLE_PICT</entry>
<entry>8</entry>
<entry>Self-sizing</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ATOM</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ATOM_PAIR</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>BITMAP</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>C_STRING</entry>
<entry>8</entry>
<entry>Zero</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COLORMAP</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COMPOUND_TEXT</entry>
<entry>8</entry>
<entry>Zero</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DRAWABLE</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>INCR</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>INTEGER</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PIXEL</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PIXMAP</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SPAN</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>STRING</entry>
<entry>8</entry>
<entry>Zero</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WINDOW</entry>
<entry>32</entry>
<entry>Fixed-size</entry>
@@ -2525,7 +2506,7 @@ the separators are also listed.
It is expected that this table will grow over time.
</para>
-<sect2 id="text_properties">
+<sect2 id='TEXT_Properties'>
<title>TEXT Properties</title>
<para>
In general,
@@ -2554,8 +2535,7 @@ it should request conversion into the name of that encoding.
<para>
In the table in
-<link linkend="target_atoms">
-<xref linkend="target_atoms"></xref></link>,
+<xref linkend='Target_Atoms' xrefstyle='select: title'/>,
the word TEXT (in the Type column) is used to indicate one
of the registered encoding names.
The type would not actually be TEXT;
@@ -2614,7 +2594,7 @@ specify an appropriate list format.
</para>
</sect2>
-<sect2 id="incr_properties">
+<sect2 id='INCR_Properties'>
<title>INCR Properties</title>
<para>
Requestors may receive a property of type INCR
@@ -2726,7 +2706,7 @@ The remaining partial properties must have the same type.
</para>
</sect2>
-<sect2 id="drawable_properties">
+<sect2 id='DRAWABLE_Properties'>
<title>DRAWABLE Properties</title>
<para>
Requestors may receive properties of type PIXMAP, BITMAP, DRAWABLE, or WINDOW,
@@ -2758,8 +2738,7 @@ Colormap ID
<para>
In general,
requestors converting into targets whose returned type in the table in
-<link linkend="target_atoms">
-<xref linkend="target_atoms"></xref></link>
+<xref linkend='Target_Atoms' xrefstyle='select: title'/>
is one of the DRAWABLE types should expect to convert also
into the following targets (using the MULTIPLE mechanism):
</para>
@@ -2785,7 +2764,7 @@ COLORMAP returns a colormap ID.
</sect2>
-<sect2 id="span_properties">
+<sect2 id='SPAN_Properties'>
<title>SPAN Properties</title>
<para>
Properties with type SPAN contain a list of cardinal-pairs
@@ -2801,18 +2780,16 @@ such as LINE_NUMBER or CHARACTER_POSITION.
</sect2>
</sect1>
-<sect1 id="manager_selections">
+<sect1 id='Manager_Selections'>
<title>Manager Selections</title>
<para>
Certain clients, often called managers, take on responsibility
for managing shared resources. A client that manages a shared
resource should take ownership of an appropriate selection,
named using the conventions described in
-<link linkend="naming_conventions">
-<xref linkend="naming_conventions"></xref></link>
+<xref linkend='Naming_Conventions' xrefstyle='select: title'/>
and
-<link linkend="discriminated_names">
-<xref linkend="discriminated_names"></xref></link>.
+<xref linkend='Discriminated_Names' xrefstyle='select: title'/>.
A client that manages multiple
shared resources (or groups of resources) should take
ownership of a selection for each one.
@@ -2836,15 +2813,12 @@ replace the old one. If so, it may then take ownership of the selection.
Managers should acquire the selection using a window created expressly for
this purpose. Managers must conform to the rules for selection owners
described in
-<link linkend="acquiring_selection_ownership">
-<xref linkend="acquiring_selection_ownership"></xref></link>
+<xref linkend='Acquiring_Selection_Ownership' xrefstyle='select: title'/>
and
-<link linkend="responsibilities_of_the_selection_owner">
-<xref linkend="responsibilities_of_the_selection_owner"></xref></link>
+<xref linkend='Responsibilities_of_the_Selection_Owner' xrefstyle='select: title'/>
, and they must also support the required
targets listed in
-<link linkend="use_of_selection_atoms">
-<xref linkend="use_of_selection_atoms"></xref></link>.
+<xref linkend='Use_of_Selection_Atoms' xrefstyle='select: title'/>.
</para>
<para>
@@ -2904,51 +2878,46 @@ protocol request with the following arguments:
<!-- .br -->
<!-- .ne 6 -->
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row>
- <entry namest="c1" nameend="c2">Argument</entry>
+ <row rowsep='1'>
+ <entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">destination:</entry>
+ <row>
+ <entry>destination:</entry>
<entry>
the root window of screen 0, or the root
window of the appropriate screen if the
manager is managing a screen-specific resource</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">propogate:</entry>
+ <row>
+ <entry>propogate:</entry>
<entry>False</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">event-mask:</entry>
+ <row>
+ <entry>event-mask:</entry>
<entry><function>StructureNotify</function></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>event:</entry>
- <entry></entry>
<entry><function>ClientMessage</function></entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>type:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type:</entry>
<entry>MANAGER</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>format:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;format:</entry>
<entry>32</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[0]
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[0]
<footnote>
<para>
We use the notation data[n] to indicate the n
@@ -2962,24 +2931,20 @@ The list is indexed from zero.
</entry>
<entry>timestamp</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[1]:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[1]:</entry>
<entry>manager selection atom</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[2]:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[2]:</entry>
<entry>the window owning the selection</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[3]:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[3]:</entry>
<entry>manager-selection-specific data</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[4]:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[4]:</entry>
<entry>manager-selection-specific data</entry>
</row>
</tbody>
@@ -2996,7 +2961,7 @@ on the appropriate root window and should watch for the appropriate MANAGER
</sect1>
</chapter>
-<chapter id="peer_to_peer_communication_by_means_of_cut_buffers">
+<chapter id='Peer_to_Peer_Communication_by_Means_of_Cut_Buffers'>
<title>Peer-to-Peer Communication by Means of Cut Buffers</title>
<para>
The cut buffer mechanism is much simpler but much less powerful
@@ -3028,7 +2993,7 @@ and CUT_BUFFER7 to CUT_BUFFER0.
It then must store the data into CUT_BUFFER0 by using a
<function>ChangeProperty</function>
request in mode
-<function>Replace</function>.
+<olink targetdoc='libXaw' targetptr='Replace'><function>Replace</function></olink>.
</para>
<para>
@@ -3054,7 +3019,7 @@ and need to be able to identify operations that transfer data to and fro.
</para>
</chapter>
-<chapter id="client_to_window_manager_communication">
+<chapter id='Client_to_Window_Manager_Communication'>
<title>Client-to-Window-Manager Communication</title>
<para>
To permit window managers to perform their role of mediating the competing
@@ -3115,7 +3080,7 @@ and it should be run under a window manager that allows other windows
(for example, the debugger) to appear on top.
</para>
-<sect1 id="clients_ctions">
+<sect1 id='Clients_Actions'>
<title>Client's Actions</title>
<para>
In general,
@@ -3143,7 +3108,7 @@ Being prepared for resource allocations to change at any time
</listitem>
</itemizedlist>
-<sect2 id="creating_a_top_level_window">
+<sect2 id='Creating_a_Top_Level_Window'>
<title>Creating a Top-Level Window</title>
<para>
A client's
@@ -3218,15 +3183,13 @@ Newly created windows start in the Withdrawn state.
Transitions between states happen when the top-level window is mapped
and unmapped and when the window manager receives certain messages.
For further details, see
-<link linkend="wm_hints_property">
-<xref linkend="wm_hints_property"></xref></link>.
+<xref linkend='WM_HINTS_Property' xrefstyle='select: title'/>.
and
-<link linkend="changing_window_state">
-<xref linkend="changing_window_state"></xref></link>.
+<xref linkend='Changing_Window_State' xrefstyle='select: title'/>.
</para>
</sect2>
-<sect2 id="client_properties">
+<sect2 id='Client_Properties'>
<title>Client Properties</title>
<para>
Once the client has one or more top-level windows,
@@ -3244,11 +3207,11 @@ and will monitor some properties for changes while the window is
in the Iconic or Normal state.
When the client changes one of these properties,
it must use
-<function>Replace</function>
+<olink targetdoc='libXaw' targetptr='Replace'><function>Replace</function></olink>
mode to overwrite the entire property with new data;
the window manager will retain no memory of the old value of the property.
All fields of the property must be set to suitable values in a single
-<function>Replace</function>
+<olink targetdoc='libXaw' targetptr='Replace'><function>Replace</function></olink>
mode <function>ChangeProperty</function>
request.
This ensures that the full contents of the property will be
@@ -3280,8 +3243,7 @@ should take place using separate properties.
The only exception to this rule is the WM_PROTOCOLS property, which may be
of arbitrary length and which may contain atoms representing private
protocols (see
-<link linkend="wm_protocols_property">
-<xref linkend="wm_protocols_property"></xref></link>
+<xref linkend='WM_PROTOCOLS_Property' xrefstyle='select: title'/>
).
</para>
@@ -3289,12 +3251,11 @@ protocols (see
The next sections describe each of the properties the clients
need to set, in turn.
They are summarized in the table in
-<link linkend="summary_of_window_manager_property_types">
-<xref linkend="summary_of_window_manager_property_types"></xref></link>
+<xref linkend='Summary_of_Window_Manager_Property_Types' xrefstyle='select: title'/>
</para>
-<sect3 id="wm_name_property">
+<sect3 id='WM_NAME_Property'>
<title>WM_NAME Property</title>
<para>
The WM_NAME property is an uninterpreted string
@@ -3306,8 +3267,7 @@ The encoding used for this string
(and all other uninterpreted string properties)
is implied by the type of the property.
The type atoms to be used for this purpose are described in
-<link linkend="text_properties">
-<xref linkend="text_properties"></xref></link>.
+<xref linkend='TEXT_Properties' xrefstyle='select: title'/>.
</para>
<para>
@@ -3339,7 +3299,7 @@ brevity here will pay dividends.
</para>
</sect3>
-<sect3 id="wm_icon_name_property">
+<sect3 id='WM_ICON_NAME_Property'>
<title>WM_ICON_NAME Property</title>
<para>
The WM_ICON_NAME property is an uninterpreted string
@@ -3357,81 +3317,81 @@ or windows; rather, they should rely on the window manager to do so.
</para>
</sect3>
-<sect3 id="wm_normal_hints_property">
+<sect3 id='WM_NORMAL_HINTS_Property'>
<title>WM_NORMAL_HINTS Property</title>
<para>
The type of the WM_NORMAL_HINTS property is WM_SIZE_HINTS.
Its contents are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='1.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>flags</entry>
<entry>CARD32</entry>
<entry>(see the next table)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>pad</entry>
<entry>4*CARD32</entry>
<entry>For backwards compatibility</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>min_width</entry>
<entry>INT32</entry>
<entry>If missing, assume base_width</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>min_height</entry>
<entry>INT32</entry>
<entry>If missing, assume base_height</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>max_width</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>max_height</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>width_inc</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>height_inc</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>min_aspect</entry>
<entry>(INT32,INT32)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>max_aspect</entry>
<entry>(INT32,INT32)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>base_width</entry>
<entry>INT32</entry>
<entry>If missing, assume min_width</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>base_height</entry>
<entry>INT32</entry>
<entry>If missing, assume min_height</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>win_gravity</entry>
<entry>INT32</entry>
<entry>If missing, assume <function>NorthWest</function></entry>
@@ -3444,65 +3404,65 @@ Its contents are as follows:
The WM_SIZE_HINTS.flags bit definitions are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='2.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Value</entry>
<entry>Field</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry><function>USPosition</function></entry>
<entry>1</entry>
<entry>User-specified x, y</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>USSize</function></entry>
<entry>2</entry>
<entry>User-specified width, height</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PPosition</function></entry>
<entry>4</entry>
<entry>Program-specified position</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PSize</function></entry>
<entry>8</entry>
<entry>Program-specified size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PMinSize</function></entry>
<entry>16</entry>
<entry>Program-specified minimum size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PMaxSize</function></entry>
<entry>32</entry>
<entry>Program-specified maximum size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PResizeInc</function></entry>
<entry>64</entry>
<entry>Program-specified resize increments</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PAspect</function></entry>
<entry>128</entry>
<entry>Program-specified min and max aspect ratios</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PBaseSize</function></entry>
<entry>256</entry>
<entry>Program-specified base size</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>PWinGravity</function></entry>
<entry>512</entry>
<entry>Program-specified window gravity</entry>
@@ -3625,7 +3585,7 @@ place of the base size for this purpose.)
</para>
</sect3>
-<sect3 id="wm_hints_property">
+<sect3 id='WM_HINTS_Property'>
<title>WM_HINTS Property</title>
<para>
The WM_HINTS property (whose type is WM_HINTS)
@@ -3640,59 +3600,59 @@ which need separate properties, such as WM_NAME.
The contents of the properties are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.3*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>flags</entry>
<entry>CARD32</entry>
<entry>(see the next table)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>input</entry>
<entry>CARD32</entry>
<entry>The client's input model</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>initial_state</entry>
<entry>CARD32</entry>
<entry>The state when first mapped</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon_pixmap</entry>
<entry>PIXMAP</entry>
<entry>The pixmap for the icon image</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon_window</entry>
<entry>WINDOW</entry>
<entry>The window for the icon image</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon_x</entry>
<entry>INT32</entry>
<entry>The icon location</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon_y</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon_mask</entry>
<entry>PIXMAP</entry>
<entry>The mask for the icon shape</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>window_group</entry>
<entry>WINDOW</entry>
<entry>The ID of the group leader window</entry>
@@ -3705,13 +3665,13 @@ The contents of the properties are as follows:
The WM_HINTS.flags bit definitions are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.3*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Value</entry>
<entry>Field</entry>
@@ -3723,42 +3683,42 @@ The WM_HINTS.flags bit definitions are as follows:
<entry>1</entry>
<entry>input</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>StateHint</function></entry>
<entry>2</entry>
<entry>initial_state</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>IconPixmapHint</function></entry>
<entry>4</entry>
<entry>icon_pixmap</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>IconWindowHint</function></entry>
<entry>8</entry>
<entry>icon_window</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>IconPositionHint</function></entry>
<entry>16</entry>
<entry>icon_x &amp; icon_y</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>IconMaskHint</function></entry>
<entry>32</entry>
<entry>icon_mask</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>WindowGroupHint</function></entry>
<entry>64</entry>
<entry>window_group</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>MessageHint</function></entry>
<entry>128</entry>
<entry>(this bit is obsolete)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>UrgencyHint</function></entry>
<entry>256</entry>
<entry>urgency</entry>
@@ -3775,8 +3735,7 @@ the WM_HINTS property if a window is mapped without one.
<para>
The input field is used to communicate to the window manager the input focus
model used by the client (see
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>
+<xref linkend='Input_Focus' xrefstyle='select: title'/>
).
</para>
@@ -3815,8 +3774,7 @@ Withdrawn
<para>
The semantics of these states are described in
-<link linkend="changing_window_state">
-<xref linkend="changing_window_state"></xref></link>.
+<xref linkend='Changing_Window_State' xrefstyle='select: title'/>.
Newly created windows start in the Withdrawn state.
Transitions between states happen when a
top-level window is mapped and unmapped
@@ -3829,25 +3787,26 @@ wishes to be in at the time the top-level window is mapped
from the Withdrawn state, as shown in the following table:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.3*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>State</entry>
<entry>Value</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>NormalState</entry>
<entry>1</entry>
<entry>The window is visible</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>IconicState</entry>
<entry>3</entry>
<entry>The icon is visible</entry>
@@ -3866,8 +3825,7 @@ This pixmap should be:
<para>
One of the sizes specified in the WM_ICON_SIZE property
on the root if it exists (see
-<link linkend="wm_icon_size_property">
-<xref linkend="wm_icon_size_property"></xref></link>
+<xref linkend='WM_ICON_SIZE_Property' xrefstyle='select: title'/>
).
</para>
</listitem>
@@ -3897,8 +3855,7 @@ Clients should not attempt to remedy the omission by working around it.
Clients that need more capabilities from the icons than a simple 2-color
bitmap should use icon windows.
Rules for clients that do are set out in
-<link linkend="icons">
-<xref linkend="icons"></xref></link>.
+<xref linkend='Icons' xrefstyle='select: title'/>.
</para>
<para>
@@ -3956,8 +3913,7 @@ in a backwards compatibility mode.
</para>
</footnote>
rather than the WM_PROTOCOLS mechanism of
-<link linkend="wm_protocols_property">
-<xref linkend="wm_protocols_property"></xref></link>
+<xref linkend='WM_PROTOCOLS_Property' xrefstyle='select: title'/>
</para>
<para>
@@ -3993,7 +3949,7 @@ window is iconic) or by raising it to the top of the stack.
</blockquote>
</sect3>
-<sect3 id="wm_class_property">
+<sect3 id='WM_CLASS_Property'>
<title>WM_CLASS Property</title>
<para>
The WM_CLASS property (of type STRING without control characters)
@@ -4065,7 +4021,7 @@ This inconsistency is necessary for backwards compatibility.
</para>
</sect3>
-<sect3 id="wm_transient_for_property">
+<sect3 id='WM_TRANSIENT_FOR_Property'>
<title>WM_TRANSIENT_FOR Property</title>
<para>
The WM_TRANSIENT_FOR property (of type WINDOW)
@@ -4092,7 +4048,7 @@ use override-redirect and grab the pointer while the window is mapped.
</para>
</sect3>
-<sect3 id="wm_protocols_property">
+<sect3 id='WM_PROTOCOLS_Property'>
<title>WM_PROTOCOLS Property</title>
<para>
The WM_PROTOCOLS property (of type ATOM) is a list of atoms.
@@ -4108,8 +4064,7 @@ involve the window manager sending the client a
event and the client taking appropriate action.
For details of the contents of the event,
see
-<link linkend="clientmessage_events">
-<xref linkend="clientmessage_events"></xref></link>
+<xref linkend='ClientMessage_Events' xrefstyle='select: title'/>
In each case,
the protocol transactions are initiated by the window manager.
</para>
@@ -4124,37 +4079,36 @@ in the name space.
The following table lists the protocols that have been defined to date.
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='1.5*'/>
<thead>
- <row>
+ <row rowsep='1'>
<entry>Protocol</entry>
<entry>Section</entry>
<entry>Purpose</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>WM_TAKE_FOCUS</entry>
<entry>
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>
+<xref linkend='Input_Focus' xrefstyle='select: title'/>
</entry>
<entry>Assignment of input focus</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_SAVE_YOURSELF</entry>
<entry>Appendix C</entry>
<entry>Save client state request (deprecated)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_DELETE_WINDOW</entry>
<entry>
-<link linkend="window_deletion">
-<xref linkend="window_deletion"></xref></link>
+<xref linkend='Window_Deletion' xrefstyle='select: title'/>
</entry>
<entry>Request to delete top-level window</entry>
</row>
@@ -4167,7 +4121,7 @@ It is expected that this table will grow over time.
</para>
</sect3>
-<sect3 id="wm_colormap_windows_property">
+<sect3 id='WM_COLORMAP_WINDOWS_Property'>
<title>WM_COLORMAP_WINDOWS Property</title>
<para>
The WM_COLORMAP_WINDOWS property (of type WINDOW) on a top-level window
@@ -4178,12 +4132,11 @@ colormap attributes.
The top-level window is always (implicitly or explicitly) on the watch list.
For the details of this mechanism,
see
-<link linkend="colormaps">
-<xref linkend="colormaps"></xref></link>
+<xref linkend='Colormaps' xrefstyle='select: title'/>
</para>
</sect3>
-<sect3 id="wm_client_machine_property">
+<sect3 id='WM_CLIENT_MACHINE_Property'>
<title>WM_CLIENT_MACHINE Property</title>
<para>
The client should set the WM_CLIENT_MACHINE property (of one of the TEXT
@@ -4193,7 +4146,7 @@ seen from the machine running the server.
</sect3>
</sect2>
-<sect2 id="window_manager_properties">
+<sect2 id='Window_Manager_Properties'>
<title>Window Manager Properties</title>
<para>
The properties that were described in the previous section are those
@@ -4202,7 +4155,7 @@ This section describes the properties that the window manager places on
client's top-level windows and on the root.
</para>
-<sect3 id="wm_state_property">
+<sect3 id='WM_STATE_Property'>
<title>WM_STATE Property</title>
<para>
The window manager will place a WM_STATE property (of type WM_STATE) on each
@@ -4229,25 +4182,26 @@ child-of-root window if one is present beneath the selected location.
The contents of the WM_STATE property are defined as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.3*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>state</entry>
<entry>CARD32</entry>
<entry>(see the next table)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>icon</entry>
<entry>WINDOW</entry>
<entry>ID of icon window</entry>
@@ -4260,26 +4214,27 @@ The contents of the WM_STATE property are defined as follows:
The following table lists the WM_STATE.state values:
</para>
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.3*'/>
+ <colspec colname='c2' colwidth='5.0*'/>
<thead>
- <row>
+ <row rowsep='1'>
<entry>State</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>WithdrawnState</entry>
<entry>0</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>NormalState</entry>
<entry>1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>IconicState</entry>
<entry>3</entry>
</row>
@@ -4328,7 +4283,7 @@ client's icon window.
</para>
</sect3>
-<sect3 id="wm_icon_size_property">
+<sect3 id='WM_ICON_SIZE_Property'>
<title>WM_ICON_SIZE Property</title>
<para>
A window manager that wishes to place constraints on the sizes of icon
@@ -4336,41 +4291,42 @@ pixmaps and/or windows should place a property called WM_ICON_SIZE on the root.
The contents of this property are listed in the following table.
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>min_width</entry>
<entry>CARD32</entry>
<entry>The data for the icon size series</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>min_height</entry>
<entry>CARD32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>max_width</entry>
<entry>CARD32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>max_height</entry>
<entry>CARD32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>width_inc</entry>
<entry>CARD32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>height_inc</entry>
<entry>CARD32</entry>
</row>
@@ -4385,7 +4341,7 @@ For more details see section 14.1.12 in <!-- xref -->
</sect3>
</sect2>
-<sect2 id="changing_window_state">
+<sect2 id='Changing_Window_State'>
<title>Changing Window State</title>
<para>
From the client's point of view,
@@ -4521,48 +4477,43 @@ using a
request with the following arguments:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">Argument</entry>
+ <row rowsep='1'>
+ <entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">destination</entry>
+ <row>
+ <entry>destination</entry>
<entry>The root</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">propogate</entry>
+ <row>
+ <entry>propogate</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">event-mask</entry>
+ <row>
+ <entry>event-mask</entry>
<entry>(<emphasis role="bold">SubstructureRedirect|SubstructureNotify</emphasis>)</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">
-event: an <function>UnmapNotify</function> with:
- </entry>
+ <row>
+ <entry>event: an <function>UnmapNotify</function> with:</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>event:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event:</entry>
<entry>The root</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>window:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;window:</entry>
<entry>The window itself</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>from-configure:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;from-configure:</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
</tbody>
@@ -4599,8 +4550,7 @@ on a window for which they have not yet received a real
When a client withdraws a window,
the window manager will then update or remove the WM_STATE
property as described in
-<link linkend="wm_state_property">
-<xref linkend="wm_state_property"></xref></link>.
+<xref linkend='WM_STATE_Property' xrefstyle='select: title'/>.
Clients that want to re-use a client window (e.g., by mapping it again or
reparenting it elsewhere) after withdrawing it must wait for the
withdrawal to be complete before proceeding. The preferred method for
@@ -4664,8 +4614,7 @@ The format of this
event does not match the format of
<function>ClientMessages</function>
in
-<link linkend="clientmessage_events">
-<xref linkend="clientmessage_events"></xref></link>.
+<xref linkend='ClientMessage_Events' xrefstyle='select: title'/>.
This is because they are sent by the window manager to clients,
and this message is sent by clients to the window manager.
</para>
@@ -4710,7 +4659,7 @@ advised to withdraw transients for the window.
</sect2>
-<sect2 id="configuring_the_window">
+<sect2 id='Configuring_the_Window'>
<title>Configuring the Window</title>
<para>
Clients can resize and reposition their top-level windows by using the
@@ -4752,8 +4701,7 @@ to be used are those most recently requested by the client.
Client configure requests are interpreted by the window manager
in the same manner as the initial window geometry mapped from
the Withdrawn state, as described in
-<link linkend="wm_normal_hints_property">
-<xref linkend="wm_normal_hints_property"></xref></link>
+<xref linkend='WM_NORMAL_HINTS_Property' xrefstyle='select: title'/>
Clients must be aware that there is no guarantee that the window manager
will allocate them the requested size or location and must be prepared to
deal with any size and location.
@@ -4921,48 +4869,43 @@ event by invoking a
request with the following arguments:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">Argument</entry>
+ <row rowsep='1'>
+ <entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">destination</entry>
+ <row>
+ <entry>destination</entry>
<entry>The root</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">propogate</entry>
+ <row>
+ <entry>propogate</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">event-mask</entry>
+ <row>
+ <entry>event-mask</entry>
<entry>(<emphasis role="bold">SubstructureRedirect|SubstructureNotify</emphasis>)</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">
-event: an <function>ConfigureRequest</function> with:
- </entry>
+ <row>
+ <entry>event: an <function>ConfigureRequest</function> with:</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>event:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;event:</entry>
<entry>The root</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>window:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;window:</entry>
<entry>The window itself</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>...</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;...</entry>
<entry>Other parameters from the <emphasis role="bold">ConfigureWindow</emphasis> request</entry>
</row>
</tbody>
@@ -4980,7 +4923,7 @@ contain useful information.
</para>
</sect2>
-<sect2 id="changing_window_attributes">
+<sect2 id='Changing_Window_Attributes'>
<title>Changing Window Attributes</title>
<para>
The attributes that may be supplied when a window is created may be
@@ -4990,66 +4933,66 @@ request.
The window attributes are listed in the following table:
</para>
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Attribute</entry>
<entry>Private to Client</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>Background pixmap</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Background pixel</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Border pixmap</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Border pixel</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Bit gravity</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Window gravity</entry>
<entry>No</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Backing-store hint</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Save-under hint</entry>
<entry>No</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Event Mask</entry>
<entry>No</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Do-not-propagate mask</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Override-redirect flag</entry>
<entry>No</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Colormap</entry>
<entry>Yes</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Cursor</entry>
<entry>Yes</entry>
</row>
@@ -5091,18 +5034,16 @@ windows.
<para>
Clients can set override-redirect on top-level windows but are
encouraged not to do so except as described in
-<link linkend="pop_up_windows">
-<xref linkend="pop_up_windows"></xref></link>.
+<xref linkend='Pop_up_Windows' xrefstyle='select: title'/>.
and
-<link linkend="redirecting_requests">
-<xref linkend="redirecting_requests"></xref></link>.
+<xref linkend='Redirecting_Requests' xrefstyle='select: title'/>.
<!-- xref -->
</para>
</listitem>
</itemizedlist>
</sect2>
-<sect2 id="input_focus">
+<sect2 id='Input_Focus'>
<title>Input Focus</title>
<para>
There are four models of input handling:
@@ -5164,35 +5105,36 @@ and the presence or absence of the WM_TAKE_FOCUS atom in the
WM_PROTOCOLS property are listed in the following table:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Input Model</entry>
<entry>Input Field</entry>
<entry>WM_TAKE_FOCUS</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>No Input</entry>
<entry><emphasis role="bold">False</emphasis></entry>
<entry>Absent</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Passive</entry>
<entry><emphasis role="bold">True</emphasis></entry>
<entry>Absent</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Locally Active</entry>
<entry><emphasis role="bold">True</emphasis></entry>
<entry>Present</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Globally Active</entry>
<entry><emphasis role="bold">False</emphasis></entry>
<entry>Present</entry>
@@ -5280,8 +5222,7 @@ Windows with the atom WM_TAKE_FOCUS in their WM_PROTOCOLS property
may receive a
<function>ClientMessage</function>
event from the window manager (as described in
-<link linkend="clientmessage_events">
-<xref linkend="clientmessage_events"></xref></link>.
+<xref linkend='ClientMessage_Events' xrefstyle='select: title'/>.
)
with WM_TAKE_FOCUS in its data[0] field and a valid timestamp
(i.e., not
@@ -5295,8 +5236,7 @@ that last had the input focus or to their default input window,
and the time field set to the timestamp in the message.
For further information,
see
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>
+<xref linkend='Input_Focus' xrefstyle='select: title'/>
</para>
<para>
<!-- .LP -->
@@ -5393,7 +5333,7 @@ They should ignore input that they receive instead.
</blockquote>
</sect2>
-<sect2 id="colormaps">
+<sect2 id='Colormaps'>
<title>Colormaps</title>
<para>
The window manager is responsible for installing and uninstalling
@@ -5438,8 +5378,7 @@ WM_COLORMAP_WINDOWS property. This property contains a list of IDs for
windows whose colormaps the window manager should attempt to have installed
when, in the course of its individual colormap focus policy, it assigns the
colormap focus to the top-level window (see
-<link linkend="wm_colormap_windows_property">
-<xref linkend="wm_colormap_windows_property"></xref></link>
+<xref linkend='WM_COLORMAP_WINDOWS_Property' xrefstyle='select: title'/>
). The list is
ordered by the importance to the client of having the colormaps installed.
The window manager will track changes to this property and will track
@@ -5502,85 +5441,76 @@ The client notifies the window manager by issuing a
request with the following arguments:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">Argument</entry>
+ <row rowsep='1'>
+ <entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">destination</entry>
+ <row>
+ <entry>destination</entry>
<entry>
The root window of the screen on which the colormap is installed
</entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">propogate</entry>
+ <row>
+ <entry>propogate</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">event-mask</entry>
+ <row>
+ <entry>event-mask</entry>
<entry><emphasis role="bold">ColormapChange</emphasis></entry>
</row>
- <row rowsep="0">
- <entry namest="c1" nameend="c2">
-event: an <function>ClientMessage</function> with:
- </entry>
- </row>
- <row rowsep="0">
+ <row>
+ <entry>event: an <function>ClientMessage</function> with:</entry>
<entry></entry>
- <entry>window:</entry>
+ </row>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;window:</entry>
<entry>The root window, as above</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>type:</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type:</entry>
<entry>WM_COLORMAP_NOTIFY</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>format</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;format</entry>
<entry>32</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[0]</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[0]</entry>
<entry>
the timestampe of the event that caused the client to start or stop
installing colormaps
</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[1]</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[1]</entry>
<entry>
1 if the client is starting colormap installation,
0 if the client is finished with colormap installation
</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[2]</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[2]</entry>
<entry>
reserved, must be zero
</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[3]</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[3]</entry>
<entry>
reserved, must be zero
</entry>
</row>
- <row rowsep="0">
- <entry></entry>
- <entry>data[4]</entry>
+ <row>
+ <entry>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data[4]</entry>
<entry>
reserved, must be zero
</entry>
@@ -5596,8 +5526,7 @@ This feature was introduced in version 2.0 of this document, and there will
be a significant period of time before all window managers can be expected
to implement this feature. Before using this feature, clients must check
the compliance level of the window manager (using the mechanism described in
-<link linkend="communication_with_the_window_manager_by_means_of_selections">
-<xref linkend="communication_with_the_window_manager_by_means_of_selections"></xref></link>
+<xref linkend='Communication_with_the_Window_Manager_by_Means_of_Selections' xrefstyle='select: title'/>
) to verify that it supports this feature. This is necessary to
prevent colormap installation conflicts between clients and older window
managers.
@@ -5645,7 +5574,7 @@ colormap installation policy in response to a command from the user.
</blockquote>
</sect2>
-<sect2 id="icons">
+<sect2 id='Icons'>
<title>Icons</title>
<para>
A client can hint to the window manager about the desired appearance
@@ -5810,7 +5739,7 @@ properties they find on icon windows.
</para>
</sect2>
-<sect2 id="pop_up_windows">
+<sect2 id='Pop_up_Windows'>
<title>Pop-up Windows</title>
<para>
Clients that wish to pop up a window can do one of three things:
@@ -5859,8 +5788,7 @@ client must have another top-level window that is not override-redirect and
that has selected the Locally Active or Globally Active focus model. The
client may set the focus to the override-redirect window when the other
window receives a WM_TAKE_FOCUS message or one of the events listed in
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>
+<xref linkend='Input_Focus' xrefstyle='select: title'/>
in the description of the Globally Active focus model.
</para>
</blockquote>
@@ -5877,7 +5805,7 @@ to enforce.
</para>
</sect2>
-<sect2 id="window_groups">
+<sect2 id='Window_Groups'>
<title>Window Groups</title>
<para>
A set of top-level windows that should be treated from the user's point of view
@@ -5910,7 +5838,7 @@ as opposed to an individual, operation.
</sect2>
</sect1>
-<sect1 id="client_responses_to_window_manager_actions">
+<sect1 id='Client_Responses_to_Window_Manager_Actions'>
<title>Client Responses to Window Manager Actions</title>
<para>
The window manager performs a number of operations on client resources,
@@ -5919,7 +5847,7 @@ Clients must not try to fight this but may elect to receive notification
of the window manager's operations.
</para>
-<sect2 id="reparenting">
+<sect2 id='Reparenting'>
<title>Reparenting</title>
<para>
Clients must be aware that some window managers will reparent
@@ -5954,13 +5882,11 @@ request in the new parent's coordinate space.
In fact, they usually will not be interpreted by the server
because a reparenting window manager usually will have intercepted
these operations (see
-<link linkend="redirection_of_operations">
-<xref linkend="redirection_of_operations"></xref></link>
+<xref linkend='Redirection_of_Operations' xrefstyle='select: title'/>
).
Clients should use the root coordinate space for these requests
(see
-<link linkend="configuring_the_window">
-<xref linkend="configuring_the_window"></xref></link>
+<xref linkend='Configuring_the_Window' xrefstyle='select: title'/>
).
</para>
</listitem>
@@ -5971,8 +5897,7 @@ Clients should use the root coordinate space for these requests
requests that name a specific sibling window may fail because the window named,
which used to be a sibling, no longer is after the reparenting operation
(see
-<link linkend="configuring_the_window">
-<xref linkend="configuring_the_window"></xref></link>
+<xref linkend='Configuring_the_Window' xrefstyle='select: title'/>
).
</para>
</listitem>
@@ -6026,7 +5951,7 @@ including transient windows and client icon windows.
</para>
</sect2>
-<sect2 id="redirection_of_operations">
+<sect2 id='Redirection_of_Operations'>
<title>Redirection of Operations</title>
<para>
Clients must be aware that some window managers will arrange
@@ -6138,14 +6063,12 @@ A window with the override-redirect bit set is immune from redirection,
but the bit should be set on top-level windows only in cases
where other windows should be prevented from processing input
while the override-redirect window is mapped (see
-<link linkend="pop_up_windows">
-<xref linkend="pop_up_windows"></xref></link>
+<xref linkend='Pop_up_Windows' xrefstyle='select: title'/>
)
and while responding to
<function>ResizeRequest</function>
events (see
-<link linkend="redirecting_requests">
-<xref linkend="redirecting_requests"></xref></link>
+<xref linkend='Redirecting_Requests' xrefstyle='select: title'/>
).
</para>
@@ -6179,7 +6102,7 @@ less demanding clients.
</para>
</sect2>
-<sect2 id="window_move">
+<sect2 id='Window_Move'>
<title>Window Move</title>
<para>
@@ -6209,26 +6132,27 @@ The window manager will send these events by using a
request with the following arguments:
</para>
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>destination</entry>
<entry>The client's window</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>propagate</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>event-mask</entry>
<entry><emphasis role="bold">StructureNotify</emphasis></entry>
</row>
@@ -6238,7 +6162,7 @@ request with the following arguments:
</sect2>
-<sect2 id="window_resize">
+<sect2 id='Window_Resize'>
<title>Window Resize</title>
<para>
The client can elect to receive notification of being resized by selecting for
@@ -6261,7 +6185,7 @@ clients are free to request to change to the Iconic state.
</para>
</sect2>
-<sect2 id="iconify_and_deiconify">
+<sect2 id='Iconify_and_Deiconify'>
<title>Iconify and Deiconify</title>
<para>
A top-level window that is not Withdrawn will be
@@ -6283,7 +6207,7 @@ event when it goes Normal.
</para>
</sect2>
-<sect2 id="colormap_change">
+<sect2 id='Colormap_Change'>
<title>Colormap Change</title>
<para>
Clients that wish to be notified of their colormaps being installed
@@ -6298,7 +6222,7 @@ is installed or uninstalled.
</para>
</sect2>
-<sect2 id="input_focus_2">
+<sect2 id='Input_Focus_2'>
<title>Input Focus</title>
<para>
Clients can request notification that they have the input focus by selecting
@@ -6329,15 +6253,13 @@ and actually have the input focus in one of their top-level windows
Set the input field of WM_HINTS to
<function>False</function>
and have received a suitable event as described in
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>.
+<xref linkend='Input_Focus' xrefstyle='select: title'/>.
</para>
</listitem>
<listitem>
<para>
Have received a WM_TAKE_FOCUS message as described in
-<link linkend="input_focus">
-<xref linkend="input_focus"></xref></link>.
+<xref linkend='Input_Focus' xrefstyle='select: title'/>.
</para>
</listitem>
</itemizedlist>
@@ -6346,8 +6268,7 @@ Clients should not warp the pointer in an attempt to transfer the focus;
they should set the focus and leave the pointer alone.
For further information,
see
-<link linkend="the_pointer">
-<xref linkend="the_pointer"></xref></link>.
+<xref linkend='The_Pointer' xrefstyle='select: title'/>.
</para>
<para>
<!-- .LP -->
@@ -6363,8 +6284,9 @@ request, which is defined as follows:
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
- <colspec colname='c1' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
<row>
<entry>
@@ -6428,7 +6350,7 @@ the revert-to field to
</sect2>
-<sect2 id="clientmessage_events">
+<sect2 id='ClientMessage_Events'>
<title>ClientMessage Events</title>
<para>
There is no way for clients to prevent themselves being sent
@@ -6440,8 +6362,7 @@ Top-level windows with a WM_PROTOCOLS property may be sent
<function>ClientMessage</function>
events specific to the protocols named by the atoms in the property
(see
-<link linkend="wm_protocols_property">
-<xref linkend="wm_protocols_property"></xref></link>
+<xref linkend='WM_PROTOCOLS_Property' xrefstyle='select: title'/>
).
For all protocols, the
<function>ClientMessage</function>
@@ -6483,30 +6404,31 @@ These events will be sent by using a
request with the following arguments:
</para>
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Argument</entry>
<entry>Value</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>destination</entry>
<entry>The client's window</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>propagate</entry>
<entry><emphasis role="bold">False</emphasis></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>event-mask</entry>
<entry>() empty</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>event</entry>
<entry>As specified by the protocol</entry>
</row>
@@ -6514,7 +6436,7 @@ request with the following arguments:
</tgroup>
</informaltable>
-<sect3 id="window_deletion">
+<sect3 id='Window_Deletion'>
<title>Window Deletion</title>
<para>
Clients, usually those with multiple top-level windows, whose server
@@ -6536,8 +6458,7 @@ and, if they decide to complete the deletion, should do the following:
<listitem>
<para>
Either change the window's state to Withdrawn (as described in
-<link linkend="changing_window_state">
-<xref linkend="changing_window_state"></xref></link>
+<xref linkend='Changing_Window_State' xrefstyle='select: title'/>
)
or destroy the window.
</para>
@@ -6579,7 +6500,7 @@ if the user asks for one of the client's top-level windows to be deleted.
</sect3>
</sect2>
-<sect2 id="redirecting_requests">
+<sect2 id='Redirecting_Requests'>
<title>Redirecting Requests</title>
<para>
Normal clients can use the redirection mechanism just as window managers do
@@ -6661,19 +6582,17 @@ the client.
</sect2>
</sect1>
-<sect1 id="communication_with_the_window_manager_by_means_of_selections">
+<sect1 id='Communication_with_the_Window_Manager_by_Means_of_Selections'>
<title>Communication with the Window Manager by Means of Selections</title>
<para>
For each screen they manage, window managers will acquire ownership of a
selection named WM_S<emphasis remap='I'>n</emphasis>, where
<emphasis remap='I'>n</emphasis> is the screen number, as
described in
-<link linkend="discriminated_names">
-<xref linkend="discriminated_names"></xref></link>
+<xref linkend='Discriminated_Names' xrefstyle='select: title'/>
Window managers should comply with the
conventions for "Manager Selections" described in
-<link linkend="manager_selections">
-<xref linkend="manager_selections"></xref></link>.
+<xref linkend='Manager_Selections' xrefstyle='select: title'/>.
The
intent is for clients to be able to request a variety of information or
services by issuing conversion requests on this selection. Window managers
@@ -6681,20 +6600,21 @@ should support conversion of the following target on their manager
selection:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Atom</entry>
<entry>Type</entry>
<entry>Data Received</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>VERSION</entry>
<entry>INTEGER</entry>
<entry>
@@ -6719,7 +6639,7 @@ or later.
</informaltable>
</sect1>
-<sect1 id="summary_of_window_manager_property_types">
+<sect1 id='Summary_of_Window_Manager_Property_Types'>
<title>Summary of Window Manager Property Types</title>
<para>
The window manager properties are summarized in the following table
@@ -6727,14 +6647,14 @@ The window manager properties are summarized in the following table
<emphasis remap='I'>Xlib - C Language X Interface</emphasis>).
</para>
-<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
- <colspec colname='c4' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='4' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='3.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
+ <colspec colname='c3' colwidth='1.0*'/>
+ <colspec colname='c4' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Type</entry>
<entry>Format</entry>
@@ -6742,103 +6662,92 @@ The window manager properties are summarized in the following table
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>WM_CLASS</entry>
<entry>STRING</entry>
<entry>8</entry>
<entry>
-<link linkend="wm_class_property">
-<xref linkend="wm_class_property"></xref></link>
+<xref linkend='WM_CLASS_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_CLIENT_MACHINE</entry>
<entry>TEXT</entry>
<entry></entry>
<entry>
-<link linkend="wm_client_machine_property">
-<xref linkend="wm_client_machine_property"></xref></link>
+<xref linkend='WM_CLIENT_MACHINE_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_COLORMAP_WINDOWS</entry>
<entry>WINDOW</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_colormap_windows_property">
-<xref linkend="wm_colormap_windows_property"></xref></link>
+<xref linkend='WM_COLORMAP_WINDOWS_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_HINTS</entry>
<entry>WM_HINTS</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_hints_property">
-<xref linkend="wm_hints_property"></xref></link>
+<xref linkend='WM_HINTS_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_ICON_NAME</entry>
<entry>TEXT</entry>
<entry></entry>
<entry>
-<link linkend="wm_icon_name_property">
-<xref linkend="wm_icon_name_property"></xref></link>
+<xref linkend='WM_ICON_NAME_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_ICON_SIZE</entry>
<entry>WM_ICON_SIZE</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_icon_size_property">
-<xref linkend="wm_icon_size_property"></xref></link>
+<xref linkend='WM_ICON_SIZE_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_NAME</entry>
<entry>TEXT</entry>
<entry></entry>
<entry>
-<link linkend="wm_name_property">
-<xref linkend="wm_name_property"></xref></link>
+<xref linkend='WM_NAME_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_NORMAL_HINTS</entry>
<entry>WM_SIZE_HINTS</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_normal_hints_property">
-<xref linkend="wm_normal_hints_property"></xref></link>
+<xref linkend='WM_NORMAL_HINTS_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_PROTOCOLS</entry>
<entry>ATOM</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_protocols_property">
-<xref linkend="wm_protocols_property"></xref></link>
+<xref linkend='WM_PROTOCOLS_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_STATE</entry>
<entry>WM_STATE</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_state_property">
-<xref linkend="wm_state_property"></xref></link>
+<xref linkend='WM_STATE_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_TRANSIENT_FOR</entry>
<entry>WINDOW</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_transient_for_property">
-<xref linkend="wm_transient_for_property"></xref></link>
+<xref linkend='WM_TRANSIENT_FOR_Property' xrefstyle='select: title'/>
</entry>
</row>
</tbody>
@@ -6847,7 +6756,7 @@ The window manager properties are summarized in the following table
</sect1>
</chapter>
-<chapter id="session_management_and_additional_inter_Client_exchanges">
+<chapter id='Session_Management_and_Additional_Inter_Client_Exchanges'>
<title>Session Management and Additional Inter-Client Exchanges</title>
<para>
This section contains some conventions for clients that participate in
@@ -6858,7 +6767,7 @@ expect their window state (e.g., WM_STATE, position, size, and stacking order)
to be preserved across sessions.
</para>
-<sect1 id="client_support_for_session_management">
+<sect1 id='Client_Support_for_Session_Management'>
<title>Client Support for Session Management</title>
<para>
Each session participant will obtain a unique client identifier (client-ID)
@@ -6968,7 +6877,7 @@ Contain a string restricted to the XPCS characters, encoded in ISO 8859-1
</itemizedlist>
</sect1>
-<sect1 id="window_manager_support_for_session_management">
+<sect1 id='Window_Manager_Support_for_Session_Management'>
<title>Window Manager Support for Session Management</title>
<para>
A window manager supporting session management must register with the
@@ -6983,7 +6892,7 @@ second checkpoint phase and save clients' state only during that phase.
</para>
</sect1>
-<sect1 id="support_for_ice_client_rendezvous">
+<sect1 id='Support_for_ICE_Client_Rendezvous'>
<title>Support for ICE Client Rendezvous</title>
<para>
The Inter-Client Exchange protocol (ICE) defined as of X11R6
@@ -7002,7 +6911,7 @@ events. Refer to that specification for complete details.
</sect1>
</chapter>
-<chapter id="manipulation_of_shared_resources">
+<chapter id='Manipulation_of_Shared_Resources'>
<title>Manipulation of Shared Resources</title>
<para>
X Version 11 permits clients to manipulate a number of shared resources,
@@ -7010,7 +6919,7 @@ for example, the input focus, the pointer, and colormaps.
Conventions are required so that clients share resources in an
orderly fashion.
</para>
-<sect1 id="the_input_focus">
+<sect1 id='The_Input_Focus'>
<title>The Input Focus</title>
<para>
Clients that explicitly set the input focus must observe one of two modes:
@@ -7064,7 +6973,7 @@ request, not
</sect1>
-<sect1 id="the_pointer">
+<sect1 id='The_Pointer'>
<title>The Pointer</title>
<para>
In general, clients should not warp the pointer.
@@ -7095,7 +7004,7 @@ request set to one of their windows.
</blockquote>
</sect1>
-<sect1 id="grabs">
+<sect1 id='Grabs'>
<title>Grabs</title>
<para>
A client's attempt to establish a button or a key grab on a window
@@ -7113,7 +7022,7 @@ the available keys and buttons.
</para>
<blockquote>
-<title> Convention</title>
+<title>Convention</title>
<para>
Window managers should ensure that they provide some mechanism for
their clients to receive events from all keys and all buttons,
@@ -7226,11 +7135,10 @@ by which the user can send an event from any key or button to the client
</itemizedlist>
</sect1>
-<sect1 id="colormaps_2">
+<sect1 id='Colormaps_2'>
<title>Colormaps</title>
<para>
-<link linkend="colormaps">
-<xref linkend="colormaps"></xref></link>
+<xref linkend='Colormaps' xrefstyle='select: title'/>
prescribes conventions for clients to communicate with the
window manager about their colormap needs. If your clients are
<function>DirectColor</function>
@@ -7246,65 +7154,65 @@ the root window of the appropriate screen.
The contents of the RGB_COLOR_MAP type property are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>colormap</entry>
<entry>COLORMAP</entry>
<entry>ID of the colormap described</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>red_max</entry>
<entry>CARD32</entry>
<entry>Values for pixel calculations</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>red_mult</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>green_max</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>green_mult</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>blue_max</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>blue_mult</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>base_pixel</entry>
<entry>CARD32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>visual_id</entry>
<entry>VISUALID</entry>
<entry>Visual to which colormap belongs</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>kill_id</entry>
<entry>CARD32</entry>
<entry>ID for destroying the resources</entry>
@@ -7359,7 +7267,7 @@ if they use the root visual.
</para>
</sect1>
-<sect1 id="the_keyboard_mapping">
+<sect1 id='The_Keyboard_Mapping'>
<title>The Keyboard Mapping</title>
<para>
The X server contains a table (which is read by
@@ -7453,7 +7361,7 @@ events should update any internal keycode translation tables they are using.
</sect1>
-<sect1 id="the_modifier_mapping">
+<sect1 id='The_Modifier_Mapping'>
<title>The Modifier Mapping</title>
<para>
X Version 11 supports 8 modifier bits of which 3 are preassigned
@@ -7595,7 +7503,7 @@ pair in these transactions atomic.
</sect1>
</chapter>
-<chapter id="device_color_characterization">
+<chapter id='Device_Color_Characterization'>
<title>Device Color Characterization</title>
<!-- .EQ -->
<!--
@@ -7685,7 +7593,7 @@ If other device types are eventually necessary, additional
properties will be required to describe them.
</para>
-<sect1 id="xyz_rgb_conversion_matrices">
+<sect1 id='XYZ_lt_gt_RGB_Conversion_Matrices'>
<title>XYZ &lt;-&gt; RGB Conversion Matrices</title>
<para>
Because of the limited dynamic range of both XYZ and RGB intensity,
@@ -7706,55 +7614,55 @@ each screen, using values appropriate for that screen.
This will be encoded as shown in the following table:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>M<subscript>0,0</subscript></entry>
<entry>INT32</entry>
<entry>Interpreted as a fixed-point number -16 &le; x &lt; 16</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>M<subscript>0,1</subscript></entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>M<subscript>3,3</subscript></entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>M<superscript>-1</superscript><subscript>0,0</subscript></entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>M<superscript>-1</superscript><subscript>0,1</subscript></entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>INT32</entry>
<entry></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>M<superscript>-1</superscript><subscript>3,3</subscript></entry>
<entry>INT32</entry>
<entry></entry>
@@ -7764,7 +7672,7 @@ This will be encoded as shown in the following table:
</informaltable>
</sect1>
-<sect1 id="intensity_da_rgb_value_conversion">
+<sect1 id='Intensity_dA_RGB_Value_Conversion'>
<title>Intensity (dA RGB Value Conversion</title>
<para>
XDCCC provides two representations for describing the conversion
@@ -7819,35 +7727,35 @@ This will be encoded as shown in the following table:
<para>
XDCCC_LINEAR_RGB_CORRECTION Property Contents for Type 0 Correction
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>VisualID0</entry>
<entry>CARD</entry>
<entry>Most significant portion of VisualID</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID1</entry>
<entry>CARD</entry>
<entry>Exists if and only if the property format is 8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID2</entry>
<entry>CARD</entry>
<entry>Exists if and only if the property format is 8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID3</entry>
<entry>CARD</entry>
<entry>
@@ -7855,34 +7763,34 @@ Least significant portion, exists if and only if the property
format is 8 or 16
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>type</entry>
<entry>CARD</entry>
<entry>0 for this type of correction</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>count</entry>
<entry>CARD</entry>
<entry>Number of tables following (either 1 or 3)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>length</entry>
<entry>CARD</entry>
<entry>Number of pairs -1 following in this table</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>value</entry>
<entry>CARD</entry>
<entry>X Protocol RBG value</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -7890,7 +7798,7 @@ Total of <emphasis remap='I'>length+1</emphasis> pairs of
value/intensity values
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>lengthg</entry>
<entry>CARD</entry>
<entry>
@@ -7898,19 +7806,19 @@ Number of pairs -1 following in this table (if and only if
<emphasis>count</emphasis> is 3
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>value</entry>
<entry>CARD</entry>
<entry>X Protocol RBG value</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as a number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -7918,7 +7826,7 @@ Total of <emphasis remap='I'>length+1</emphasis> pairs of
value/intensity values
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>lengthb</entry>
<entry>CARD</entry>
<entry>
@@ -7926,19 +7834,19 @@ Number of pairs -1 following in this table (if and only if
<emphasis>count</emphasis> is 3
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>value</entry>
<entry>CARD</entry>
<entry>X Protocol RBG value</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as a number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -7987,35 +7895,35 @@ This will be encoded as shown in the following table:
XDCCC_LINEAR_RGB_CORRECTION Property Contents for Type 1 Correction
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Type</entry>
<entry>Comments</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>VisualID0</entry>
<entry>CARD</entry>
<entry>Most significant portion of VisualID</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID1</entry>
<entry>CARD</entry>
<entry>Exists if and only if the property format is 8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID2</entry>
<entry>CARD</entry>
<entry>Exists if and only if the property format is 8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>VisualID3</entry>
<entry>CARD</entry>
<entry>
@@ -8023,29 +7931,29 @@ Least significant portion, exists if and only if the property
format is 8 or 16
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>type</entry>
<entry>CARD</entry>
<entry>1 for this type of correction</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>count</entry>
<entry>CARD</entry>
<entry>Number of tables following (either 1 or 3)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>length</entry>
<entry>CARD</entry>
<entry>Number of pairs -1 following in this table</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -8053,7 +7961,7 @@ Total of <emphasis remap='I'>length+1</emphasis> pairs of
value/intensity values
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>lengthg</entry>
<entry>CARD</entry>
<entry>
@@ -8061,14 +7969,14 @@ Number of pairs -1 following in this table (if and only if
<emphasis>count</emphasis> is 3
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as a number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -8076,7 +7984,7 @@ Total of <emphasis remap='I'>length+1</emphasis> pairs of
value/intensity values
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>lengthb</entry>
<entry>CARD</entry>
<entry>
@@ -8084,14 +7992,14 @@ Number of pairs -1 following in this table (if and only if
<emphasis>count</emphasis> is 3
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>intensity</entry>
<entry>CARD</entry>
<entry>
Interpret as a number 0 &le; <emphasis>intensity</emphasis> &le; 1
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>...</entry>
<entry>...</entry>
<entry>
@@ -8105,7 +8013,7 @@ value/intensity values
</sect1>
</chapter>
-<chapter id="conclusion">
+<chapter id='Conclusion'>
<title>Conclusion</title>
<para>
This document provides the protocol-level specification of the minimal
@@ -8120,7 +8028,7 @@ for information on session management, and to
for information on general-purpose communication among clients.
</para>
-<sect1 id="the_x_registry">
+<sect1 id='The_X_Registry'>
<title>The X Registry</title>
<!-- .IN "X Registry" -->
<para>
@@ -8170,7 +8078,7 @@ and the postal address of where to write to obtain the document.
This appendix describes the revision history of this document and
summarizes the incompatibilities between this and earlier versions.
</para>
-<sect1 id="the_x11r2_draft">
+<sect1 id='The_X11R2_Draft'>
<title>The X11R2 Draft</title>
<para>
The February 25, 1988, draft that was distributed as part of X Version 11,
@@ -8184,7 +8092,7 @@ in the X11R2 draft would still work.
</para>
</sect1>
-<sect1 id="the_july_draft">
+<sect1 id='The_July_27_1988_Draft'>
<title>The July 27, 1988, Draft</title>
<para>
The Consortium review was based on a draft dated July 27, 1988. This draft
@@ -8260,7 +8168,7 @@ sets a short property.
</itemizedlist>
</sect1>
-<sect1 id="the_public_review_drafts">
+<sect1 id='The_Public_Review_Drafts'>
<title>The Public Review Drafts</title>
<para>
The Consortium review resulted in several incompatible changes. These
@@ -8337,7 +8245,7 @@ These are the only cases in which they would have worked, anyway.
</itemizedlist>
</sect1>
-<sect1 id="version_1.0_july_1989">
+<sect1 id='Version_10_July_1989'>
<title>Version 1.0, July 1989</title>
<para>
The public review resulted in a set of mostly editorial changes. The
@@ -8348,8 +8256,7 @@ the earlier drafts are:
<listitem>
<para>
A new section (
-<link linkend="grabs">
-<xref linkend="grabs"></xref></link>
+<xref linkend='Grabs' xrefstyle='select: title'/>
) was added covering the window manager's
use of Grabs.
The restrictions it imposes should affect only window managers.
@@ -8435,7 +8342,7 @@ and the cases that would have worked will still work.
</itemizedlist>
</sect1>
-<sect1 id="version_1.1">
+<sect1 id='Version_11'>
<title>Version 1.1</title>
<para>
Version 1.1 was released with X11R5 in September 1991. In addition to some
@@ -8466,7 +8373,7 @@ Appropriate references to Compound Text were added.
</itemizedlist>
</sect1>
-<sect1 id="public_review_draft_december_1993">
+<sect1 id='Public_Review_Draft_December_1993'>
<title>Public Review Draft, December 1993</title>
<para>
The following changes have been made in preparing the public review draft
@@ -8491,8 +8398,7 @@ top-level window has been added.
<para>
<!-- .bP -->
[P06]
-<link linkend="colormaps">
-<xref linkend="colormaps"></xref></link>
+<xref linkend='Colormaps' xrefstyle='select: title'/>
, on colormaps, has been rewritten. A new feature that
allows clients to install their own colormaps has also been added.
</para>
@@ -8682,7 +8588,7 @@ Numerous editorial and typographical improvements have been made.
</itemizedlist>
</sect1>
-<sect1 id="version_2.0_april_1994">
+<sect1 id='Version_20_April_1994'>
<title>Version 2.0, April 1994</title>
<para>
The following changes have been made in preparation for releasing
@@ -8821,7 +8727,7 @@ session management, see
<emphasis remap='I'>X Session Management Protocol</emphasis>.
</para>
-<sect1 id="properties">
+<sect1 id='Properties'>
<title>Properties</title>
<para>
The client communicates with the session manager by placing two properties
@@ -8835,7 +8741,7 @@ on each top-level client window for use by session managers and other clients
that need to be able to identify top-level client windows and their state.
</para>
-<sect2 id="wm_command_property">
+<sect2 id='WM_COMMAND_Property'>
<title>WM_COMMAND Property</title>
<para>
The WM_COMMAND property represents the command used to start or restart the
@@ -8886,17 +8792,16 @@ messages on other top-level windows but will otherwise be ignored.
</para>
</sect2>
-<sect2 id="wm_client_machine_property_2">
+<sect2 id='WM_CLIENT_MACHINE_Property_2'>
<title>WM_CLIENT_MACHINE Property</title>
<para>
This property is described in
-<link linkend="wm_client_machine_property">
-<xref linkend="wm_client_machine_property"></xref></link>.
+<xref linkend='WM_CLIENT_MACHINE_Property' xrefstyle='select: title'/>.
</para>
</sect2>
</sect1>
-<sect1 id="termination">
+<sect1 id='Termination'>
<title>Termination</title>
<para>
Because they communicate by means of unreliable network connections, clients
@@ -8914,7 +8819,7 @@ question, and it will not be revived if the session is revived.
</para>
</sect1>
-<sect1 id="client_responses_to_session_manager_actions">
+<sect1 id='Client_Responses_to_Session_Manager_Actions'>
<title>Client Responses to Session Manager Actions</title>
<para>
Clients may need to respond to session manager actions in two ways:
@@ -8934,7 +8839,7 @@ Deleting a window
</listitem>
</itemizedlist>
-<sect2 id="saving_client_state">
+<sect2 id='Saving_Client_State'>
<title>Saving Client State</title>
<para>
Clients that want to be warned when the session manager feels
@@ -8945,8 +8850,7 @@ in the WM_SAVE_YOURSELF protocol.
They will receive a
<function>ClientMessage</function>
event as described in
-<link linkend="clientmessage_events">
-<xref linkend="clientmessage_events"></xref></link>
+<xref linkend='ClientMessage_Events' xrefstyle='select: title'/>
with the atom WM_SAVE_YOURSELF in its data[0] field.
</para>
@@ -9033,31 +8937,31 @@ with the X Consortium.
</para>
</sect2>
-<sect2 id="window_deletion_2">
+<sect2 id='Window_Deletion_2'>
<title>Window Deletion</title>
<para>
Windows are deleted using the WM_DELETE_WINDOW protocol, which
is described in
-<link linkend="window_deletion">
-<xref linkend="window_deletion"></xref></link>.
+<xref linkend='Window_Deletion' xrefstyle='select: title'/>.
</para>
</sect2>
</sect1>
-<sect1 id="summary_of_session_manager_property_types">
+<sect1 id='Summary_of_Session_Manager_Property_Types'>
<title>Summary of Session Manager Property Types</title>
<para>
The session manager properties are listed in the following table:
</para>
-<informaltable frame="none">
- <tgroup cols='4' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
- <colspec colname='c4' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='4' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='2.0*'/>
+ <colspec colname='c2' colwidth='1.0*'/>
+ <colspec colname='c3' colwidth='1.0*'/>
+ <colspec colname='c4' colwidth='3.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Type</entry>
<entry>Format</entry>
@@ -9065,31 +8969,28 @@ The session manager properties are listed in the following table:
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>WM_CLIENT_MACHINE</entry>
<entry>TEXT</entry>
<entry></entry>
<entry>
-<link linkend="wm_client_machine_property">
-<xref linkend="wm_client_machine_property"></xref></link>
+<xref linkend='WM_CLIENT_MACHINE_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_COMMAND</entry>
<entry>TEXT</entry>
<entry></entry>
<entry>
-<link linkend="wm_command_property">
-<xref linkend="wm_command_property"></xref></link>
+<xref linkend='WM_COMMAND_Property' xrefstyle='select: title'/>
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WM_STATE</entry>
<entry>WM_STATE</entry>
<entry>32</entry>
<entry>
-<link linkend="wm_state_property">
-<xref linkend="wm_state_property"></xref></link>
+<xref linkend='WM_STATE_Property' xrefstyle='select: title'/>
</entry>
</row>
</tbody>
diff --git a/doc/xorg-docs/specs/Makefile.in b/doc/xorg-docs/specs/Makefile.in
index a87e1d9b0..16c51ae55 100644
--- a/doc/xorg-docs/specs/Makefile.in
+++ b/doc/xorg-docs/specs/Makefile.in
@@ -22,9 +22,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -68,6 +68,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -101,6 +102,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -131,12 +134,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
diff --git a/doc/xorg-docs/specs/XLFD/Makefile.am b/doc/xorg-docs/specs/XLFD/Makefile.am
index 01f9a542a..b719a8682 100644
--- a/doc/xorg-docs/specs/XLFD/Makefile.am
+++ b/doc/xorg-docs/specs/XLFD/Makefile.am
@@ -1,9 +1,13 @@
+
if ENABLE_SPECS
-xmldir = $(docdir)/$(subdir)
-doc_sources = xlfd.xml
-dist_xml_DATA = $(doc_sources)
+# Main DocBook/XML files (DOCTYPE book)
+docbook = xlfd.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+shelfdir = $(docdir)/xlfd
-include $(top_srcdir)/xmlrules.in
+# Generate DocBook/XML output formats with or without stylesheets
+include $(top_srcdir)/docbook.am
endif ENABLE_SPECS
diff --git a/doc/xorg-docs/specs/XLFD/Makefile.in b/doc/xorg-docs/specs/XLFD/Makefile.in
index 3d3f4ca91..1ba3b785f 100644
--- a/doc/xorg-docs/specs/XLFD/Makefile.in
+++ b/doc/xorg-docs/specs/XLFD/Makefile.in
@@ -15,26 +15,19 @@
@SET_MAKE@
#
-# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+# Generate output formats for a single DocBook/XML with/without chapters
#
-# 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:
+# 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.
#
-# 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.
+# 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.
#
srcdir = @srcdir@
@@ -46,9 +39,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ../..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -59,10 +52,14 @@ PRE_UNINSTALL = :
POST_UNINSTALL = :
build_triplet = @build@
host_triplet = @host@
-DIST_COMMON = $(am__dist_xml_DATA_DIST) $(srcdir)/Makefile.am \
- $(srcdir)/Makefile.in $(top_srcdir)/xmlrules.in
-@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt)
+DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
+ $(srcdir)/Makefile.in $(top_srcdir)/docbook.am
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
subdir = specs/XLFD
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
@@ -72,17 +69,17 @@ mkinstalldirs = $(SHELL) $(install_sh) -d
CONFIG_CLEAN_FILES =
SOURCES =
DIST_SOURCES =
-am__dist_xml_DATA_DIST = xlfd.xml
+am__dist_shelf_DATA_DIST = xlfd.xml
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
am__vpath_adj = case $$p in \
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
*) f=$$p;; \
esac;
am__strip_dir = `echo $$p | sed -e 's|^.*/||'`;
-am__installdirs = "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"
-dist_xmlDATA_INSTALL = $(INSTALL_DATA)
-xmlDATA_INSTALL = $(INSTALL_DATA)
-DATA = $(dist_xml_DATA) $(xml_DATA)
+am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
+dist_shelfDATA_INSTALL = $(INSTALL_DATA)
+shelfDATA_INSTALL = $(INSTALL_DATA)
+DATA = $(dist_shelf_DATA) $(shelf_DATA)
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
ACLOCAL = @ACLOCAL@
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
@@ -97,6 +94,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -130,6 +128,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -160,12 +160,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
@@ -210,26 +212,73 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-@ENABLE_SPECS_TRUE@xmldir = $(docdir)/$(subdir)
-@ENABLE_SPECS_TRUE@doc_sources = xlfd.xml
-@ENABLE_SPECS_TRUE@dist_xml_DATA = $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@xml_DATA = \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2)
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath $(XORG_SGML_PATH)/X11 \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam img.src.path=$(abs_builddir)/
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html
+
+# Main DocBook/XML files (DOCTYPE book)
+@ENABLE_SPECS_TRUE@docbook = xlfd.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+@ENABLE_SPECS_TRUE@shelfdir = $(docdir)/xlfd
+
+# DocBook/XML generated output formats to be installed
+@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
+@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
+
+# DocBook/XML file with chapters, appendix and images it includes
+@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
+
+
+# Generate documents cross-reference target databases
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+
+@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
all: all-am
.SUFFIXES:
-.SUFFIXES: .xml .ps .pdf .txt .html
-$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/xmlrules.in $(am__configure_deps)
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
@for dep in $?; do \
case '$(am__configure_deps)' in \
*$$dep*) \
@@ -259,39 +308,39 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
uninstall-info-am:
-install-dist_xmlDATA: $(dist_xml_DATA)
+install-dist_shelfDATA: $(dist_shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(dist_xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(dist_xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(dist_shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(dist_shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-dist_xmlDATA:
+uninstall-dist_shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
-install-xmlDATA: $(xml_DATA)
+install-shelfDATA: $(shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-xmlDATA:
+uninstall-shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(xml_DATA)'; for p in $$list; do \
+ @list='$(shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
tags: TAGS
TAGS:
@@ -332,7 +381,7 @@ check-am: all-am
check: check-am
all-am: Makefile $(DATA)
installdirs:
- for dir in "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"; do \
+ for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
test -z "$$dir" || $(mkdir_p) "$$dir"; \
done
install: install-am
@@ -360,11 +409,9 @@ distclean-generic:
maintainer-clean-generic:
@echo "This command is intended for maintainers to use"
@echo "it deletes files that may require special tools to rebuild."
-@ENABLE_SPECS_FALSE@clean-local:
-@HAVE_XMLTO_FALSE@clean-local:
clean: clean-am
-clean-am: clean-generic clean-local mostlyclean-am
+clean-am: clean-generic mostlyclean-am
distclean: distclean-am
-rm -f Makefile
@@ -380,7 +427,7 @@ info: info-am
info-am:
-install-data-am: install-dist_xmlDATA install-xmlDATA
+install-data-am: install-dist_shelfDATA install-shelfDATA
install-exec-am:
@@ -406,37 +453,33 @@ ps: ps-am
ps-am:
-uninstall-am: uninstall-dist_xmlDATA uninstall-info-am \
- uninstall-xmlDATA
-
-.PHONY: all all-am check check-am clean clean-generic clean-local \
- distclean distclean-generic distdir dvi dvi-am html html-am \
- info info-am install install-am install-data install-data-am \
- install-dist_xmlDATA install-exec install-exec-am install-info \
- install-info-am install-man install-strip install-xmlDATA \
- installcheck installcheck-am installdirs maintainer-clean \
- maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
- pdf-am ps ps-am uninstall uninstall-am uninstall-dist_xmlDATA \
- uninstall-info-am uninstall-xmlDATA
-
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@chunked-html: $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources)
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@clean-local:
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)rm -fr html/
+uninstall-am: uninstall-dist_shelfDATA uninstall-info-am \
+ uninstall-shelfDATA
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am html html-am info info-am \
+ install install-am install-data install-data-am \
+ install-dist_shelfDATA install-exec install-exec-am \
+ install-info install-info-am install-man install-shelfDATA \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-dist_shelfDATA uninstall-info-am uninstall-shelfDATA
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
+
+# Generate DocBook/XML output formats with or without stylesheets
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/xorg-docs/specs/XLFD/xlfd.xml b/doc/xorg-docs/specs/XLFD/xlfd.xml
index 059c1133c..069050fb1 100644
--- a/doc/xorg-docs/specs/XLFD/xlfd.xml
+++ b/doc/xorg-docs/specs/XLFD/xlfd.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<book id="xlfd">
@@ -8,54 +11,21 @@
<bookinfo>
<title>X Logical Font Description Conventions</title>
<subtitle>X Consortium Standard</subtitle>
- <releaseinfo>Version 1.5</releaseinfo>
<authorgroup>
<author>
<firstname>Jim</firstname><surname>Flowers</surname>
- <affiliation><orgname>
-Digital Equipment Corporation
- </orgname></affiliation>
+ <affiliation><orgname>Digital Equipment Corporation</orgname></affiliation>
</author>
- <othercredit>
- <contrib>edited by</contrib>
+ <editor>
<firstname>Stephen </firstname><surname>Gildea</surname>
- </othercredit>
+ <affiliation><orgname>X Consortium</orgname></affiliation>
+ </editor>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
- <copyright><year>1988,1994</year><holder>X Consortium</holder></copyright>
- <copyright>
- <year>1988,1994</year>
- <holder>Digital Equipment Corporation</holder>
- </copyright>
- <affiliation><orgname>X Consortium</orgname></affiliation>
- <productnumber>X Version 11, Release 6.8</productnumber>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+ <releaseinfo>Version 1.5</releaseinfo>
+ <copyright><year>1988</year><year>1994</year><holder>X Consortium</holder></copyright>
<legalnotice>
-
-<para>
-<emphasis remap='I'>X Window System</emphasis> is a trademark of The Open Group.
-</para>
-<para>
-Helvetica and Times are registered trademarks of Linotype Company.
-</para>
-<para>
-ITC Avant Garde Gothic is a registered trademark of International
-Typeface Corporation.
-</para>
-<para>
-Times Roman is a registered trademark of Monotype Corporation.
-</para>
-<para>
-Bitstream Amerigo is a registered trademark of Bitstream Inc.
-</para>
-<para>
-Stone is a registered trademark of Adobe Systems Inc.
-</para>
-
-<para>
-Copyright 1988, 1994 X Consortium
-</para>
-
<para>
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
@@ -70,7 +40,7 @@ The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
</para>
<para>
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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 X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
@@ -84,8 +54,12 @@ not be used in advertising or otherwise to promote the sale, use or
other dealings in this Software without prior written authorization
from the X Consortium.
</para>
-<para>
-Copyright 1988, 1989
+<para>X Window System is a trademark of The Open Group.</para>
+</legalnotice>
+
+<legalnotice>
+<para role="multiLicensing">
+Copyright &copy; 1988, 1989
Digital Equipment Corporation, Maynard MA. All rights reserved.
</para>
<para>
@@ -100,8 +74,30 @@ This documentation is provided as is without express or implied warranty.
</para>
</legalnotice>
+
+
+<legalnotice>
+<para>
+Helvetica and Times are registered trademarks of Linotype Company.
+</para>
+<para>
+ITC Avant Garde Gothic is a registered trademark of International
+Typeface Corporation.
+</para>
+<para>
+Times Roman is a registered trademark of Monotype Corporation.
+</para>
+<para>
+Bitstream Amerigo is a registered trademark of Bitstream Inc.
+</para>
+<para>
+Stone is a registered trademark of Adobe Systems Inc.
+</para>
+</legalnotice>
+
+
</bookinfo>
-<chapter id="introduction">
+<chapter id='Introduction'>
<title>Introduction</title>
<!-- .XS -->
<!-- (SN Introduction -->
@@ -155,7 +151,7 @@ recommended leading, word-space values, and so on.
</para>
</chapter>
-<chapter id="requirements_and_goals">
+<chapter id='Requirements_and_Goals'>
<title>Requirements and Goals</title>
<!-- .XS -->
<!-- (SN Requirements and Goals -->
@@ -203,7 +199,7 @@ Is extensible
</listitem>
</itemizedlist>
-<sect1 id="provide_unique_and_descriptive_font_names">
+<sect1 id='Provide_Unique_and_Descriptive_Font_Names'>
<title>Provide Unique and Descriptive Font Names</title>
<!-- .XS -->
<!-- (SN Provide Unique and Descriptive Font Names -->
@@ -223,7 +219,7 @@ some subset of all possible fonts in the server.
</para>
</sect1>
-<sect1 id="support_multiple_font_vendors_and_character_sets">
+<sect1 id='Support_Multiple_Font_Vendors_and_Character_Sets'>
<title>Support Multiple Font Vendors and Character Sets</title>
<!-- .XS -->
<!-- (SN Support Multiple Font Vendors and Character Sets -->
@@ -249,7 +245,7 @@ in server environments where multiple charsets are supported.
</para>
</sect1>
-<sect1 id="support_scalable_and_polymorphic_fonts">
+<sect1 id='Support_Scalable_and_Polymorphic_Fonts'>
<title>Support Scalable and Polymorphic Fonts</title>
<!-- .XS -->
<!-- (SN Support Scalable and Polymorphic Fonts -->
@@ -264,7 +260,7 @@ instance.
</para>
</sect1>
-<sect1 id="support_transformations_and_subsetting_of_fonts">
+<sect1 id='Support_Transformations_and_Subsetting_of_Fonts'>
<title>Support Transformations and Subsetting of Fonts</title>
<!-- .XS -->
<!-- (SN Support Transformations and Subsetting of Fonts -->
@@ -279,7 +275,7 @@ request only a few characters from a font for efficiency.
</para>
</sect1>
-<sect1 id="be_independent_of_x_server_and_operating_or_file_system_implementations">
+<sect1 id='Be_Independent_of_X_Server_and_Operating_or_File_System_Implementations'>
<title>Be Independent of X Server and Operating or File System Implementations</title>
<!-- .XS -->
<!-- (SN Be Independent of X Server and Operating or File System Implementations -->
@@ -298,7 +294,7 @@ implementation dependent).
</para>
</sect1>
-<sect1 id="support_arbitrarily_complex_font_matching_and_substitution">
+<sect1 id='Support_Arbitrarily_Complex_Font_Matching_and_Substitution'>
<title>Support Arbitrarily Complex Font Matching and Substitution</title>
<!-- .XS -->
<!-- (SN Support Arbitrarily Complex Font Matching and Substitution -->
@@ -314,7 +310,7 @@ when asked to handle potentially unknown fonts, as required.
</para>
</sect1>
-<sect1 id="be_extensible">
+<sect1 id='Be_Extensible'>
<title>Be Extensible</title>
<!-- .XS -->
<!-- (SN Be Extensible -->
@@ -328,7 +324,7 @@ X client or server implementations obsolete.
</sect1>
</chapter>
-<chapter id="x_logical_font_description">
+<chapter id='X_Logical_Font_Description'>
<title>X Logical Font Description</title>
<!-- .XS -->
<!-- (SN X Logical Font Description -->
@@ -370,7 +366,7 @@ may also appear as items of the
<function>STARTPROPERTIES</function>...<function>ENDPROPERTIES</function>list
in the BDF V2.1 specification. <!-- xref -->
</para>
-<sect1 id="fontname">
+<sect1 id='FontName'>
<title>FontName</title>
<!-- .XS -->
<!-- (SN FontName -->
@@ -429,7 +425,7 @@ numeric property values are represented as signed or unsigned integers,
as appropriate.
</para>
-<sect2 id="fontname_syntax">
+<sect2 id='FontName_Syntax'>
<title>FontName Syntax</title>
<!-- .XS -->
<!-- (SN FontName Syntax -->
@@ -444,22 +440,23 @@ whose Backus-Naur Form syntax description is as follows:
<!-- .IN "FontName Syntax" -->
<!-- .SM -->
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>FontName ::=</entry>
<entry>
XFontNameRegistry XFontNameSuffix |
PrivFontNameRegistry PrivFontNameSuffix
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>XFontNameRegistry ::=</entry>
<entry>XFNDelim | XFNExtPrefix Version XFNDelim</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>XFontNameSuffix ::=</entry>
<entry>
FOUNDRY XFNDelim FAMILY_NAME XFNDelim WEIGHT_NAME
@@ -470,26 +467,26 @@ SPACING XFNDelim AVERAGE_WIDTH XFNDelim CHARSET_REGISTRY
XFNDelim CHARSET_ENCODING
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Version ::=</entry>
<entry>
STRING8 - the XLFD version that defines an extension
to the font name syntax (for example, "1.4")
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>XFNExtPrefix ::=</entry>
<entry>OCTET - "+" (PLUS)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>XFNDelim ::=</entry>
<entry>OCTET - "-" (HYPHEN)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PrivFontNameRegistry ::=</entry>
<entry>STRING8 - other than those strings reserved by XLFD</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PrivFontNameSuffix ::=</entry>
<entry>STRING8</entry>
</row>
@@ -543,7 +540,7 @@ FAMILY_NAME.
</para>
</sect2>
-<sect2 id="fontname_field_definitions">
+<sect2 id='FontName_Field_Definitions'>
<title>FontName Field Definitions</title>
<!-- .XS -->
<!-- (SN FontName Field Definitions -->
@@ -616,7 +613,7 @@ CHARSET_REGISTRY and CHARSET_ENCODING fields
</listitem>
</itemizedlist>
-<sect3 id="foundry_field">
+<sect3 id='FOUNDRY_Field'>
<title>FOUNDRY Field</title>
<!-- .XS -->
<!-- (SN FOUNDRY Field -->
@@ -659,7 +656,7 @@ a registry of such registered names for use in XLFD font names and properties.
</para>
</sect3>
-<sect3 id="family_name_field">
+<sect3 id='FAMILY_NAME_Field'>
<title>FAMILY_NAME Field</title>
<!-- .XS -->
<!-- (SN FAMILY_NAME Field -->
@@ -722,7 +719,7 @@ Stone
</itemizedlist>
</sect3>
-<sect3 id="weight_name_field">
+<sect3 id='WEIGHT_NAME_Field'>
<title>WEIGHT_NAME Field</title>
<!-- .XS -->
<!-- (SN WEIGHT_NAME Field -->
@@ -734,7 +731,7 @@ that is, the nominal blackness of the font,
according to the FOUNDRY's judgment.
This name must be human-understandable and suitable for presentation to a
font user.
-The value "0" is used to indicate a polymorphic font (see <xref linkend="polymorphic_fonts"/>).
+The value "0" is used to indicate a polymorphic font (see <xref linkend='Polymorphic_Fonts' xrefstyle='select: title'/>).
</para>
<para>
<!-- .LP -->
@@ -756,7 +753,7 @@ and the calculated weight, respectively.
</para>
</sect3>
-<sect3 id="slant_field">
+<sect3 id='SLANT_Field'>
<title>SLANT Field</title>
<!-- .XS -->
<!-- (SN SLANT Field -->
@@ -768,53 +765,54 @@ typeface design used in the font.
The encoding is as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
+ <colspec colname='c3' colwidth='5.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Code</entry>
<entry>English Translation</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>"R"</entry>
<entry>Roman</entry>
<entry>Upright design</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"I"</entry>
<entry>Italic</entry>
<entry>Italic design, slanted clockwise from the vertical</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"O"</entry>
<entry>Oblique</entry>
<entry>Obliqued upright design, slanted clockwise from the vertical</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"RI"</entry>
<entry>Reverse Italic</entry>
<entry>Italic design, slanted counterclockwise from the vertical</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"RO"</entry>
<entry>Reverse Oblique</entry>
<entry>Obliqued upright design, slanted counterclockwise from the vertical</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"OT"</entry>
<entry>Other</entry>
<entry>Other</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>numeric</entry>
<entry>Polymorphic</entry>
- <entry>See <xref linkend="polymorphic_fonts"/>.</entry>
+ <entry>See <xref linkend='Polymorphic_Fonts' xrefstyle='select: title'/>.</entry>
</row>
</tbody>
</tgroup>
@@ -827,7 +825,7 @@ presented to a user.
</para>
</sect3>
-<sect3 id="setwidth_name_field">
+<sect3 id='SETWIDTH_NAME_Field'>
<title>SETWIDTH_NAME Field</title>
<!-- .XS -->
<!-- (SN SETWIDTH_NAME Field -->
@@ -837,7 +835,7 @@ presented to a user.
SETWIDTH_NAME is a string that gives the font's typographic
proportionate width, that is, the nominal width per horizontal unit of the
font, according to the FOUNDRY's judgment.
-The value "0" is used to indicate a polymorphic font (see <xref linkend="polymorphic_fonts"/>).
+The value "0" is used to indicate a polymorphic font (see <xref linkend='Polymorphic_Fonts' xrefstyle='select: title'/>).
</para>
<para>
<!-- .LP -->
@@ -879,7 +877,7 @@ Double Wide
</itemizedlist>
</sect3>
-<sect3 id="add_style_name_field">
+<sect3 id='ADD_STYLE_NAME_Field'>
<title>ADD_STYLE_NAME Field</title>
<!-- .XS -->
<!-- (SN ADD_STYLE_NAME Field -->
@@ -890,7 +888,7 @@ ADD_STYLE_NAME is a string that identifies additional typographic
style information that is not captured by other fields but is needed
to identify the particular font.
The character "[" anywhere in the field is used to indicate a
-polymorphic font (see <xref linkend="polymorphic_fonts"/>).
+polymorphic font (see <xref linkend='Polymorphic_Fonts' xrefstyle='select: title'/>).
</para>
<para>
<!-- .LP -->
@@ -926,7 +924,7 @@ Decorated
</itemizedlist>
</sect3>
-<sect3 id="pixel_size_field">
+<sect3 id='PIXEL_SIZE_Field'>
<title>PIXEL_SIZE Field</title>
<!-- .XS -->
<!-- (SN PIXEL_SIZE Field -->
@@ -938,12 +936,12 @@ gives the body size of the font at a particular
POINT_SIZE and RESOLUTION_Y.
PIXEL_SIZE is either an integer-string or a string beginning
with "[". A string beginning with "[" represents a matrix
-(see <xref linkend="matrix_transformations"/>).
+(see <xref linkend='Matrix_Transformations' xrefstyle='select: title'/>).
PIXEL_SIZE usually incorporates additional vertical spacing
that is considered part of the font design.
(Note, however, that this value is not necessarily equivalent to the height
of the font bounding box.)
-Zero is used to indicate a scalable font (see <xref linkend="scalable_fonts"/>).
+Zero is used to indicate a scalable font (see <xref linkend='Scalable_Fonts' xrefstyle='select: title'/>).
</para>
<para>
<!-- .LP -->
@@ -954,7 +952,7 @@ for which the font was designed.
</para>
</sect3>
-<sect3 id="point_size_field">
+<sect3 id='SN_POINT_SIZE_Field'>
<title>SN POINT_SIZE Field</title>
<!-- .XS -->
<!-- (SN POINT_SIZE Field -->
@@ -965,14 +963,14 @@ POINT_SIZE gives the body size
for which the font was designed.
POINT_SIZE is either an integer-string or a string beginning
with "[". A string beginning with "[" represents a matrix
-(see <xref linkend="matrix_transformations"/>).
+(see <xref linkend='Matrix_Transformations' xrefstyle='select: title'/>).
This field usually incorporates additional vertical spacing
that is considered part of the font design.
(Note, however, that POINT_SIZE is not necessarily equivalent to the height
of the font bounding box.)
POINT_SIZE is expressed in decipoints (where points are as defined
in the X protocol or 72.27 points equal 1 inch).
-Zero is used to indicate a scalable font (see <xref linkend="scalable_fonts"/>).
+Zero is used to indicate a scalable font (see <xref linkend='Scalable_Fonts' xrefstyle='select: title'/>).
</para>
<para>
<!-- .LP -->
@@ -982,7 +980,7 @@ size on the display regardless of the PIXEL_SIZE used for the font.
</para>
</sect3>
-<sect3 id="resolution_x_and_resolution_y_fields">
+<sect3 id='RESOLUTION_X_and_RESOLUTION_Y_Fields'>
<title>RESOLUTION_X and RESOLUTION_Y Fields</title>
<!-- .XS -->
<!-- (SN RESOLUTION_X and RESOLUTION_Y Fields -->
@@ -993,7 +991,7 @@ RESOLUTION_X and RESOLUTION_Y are unsigned integer-strings that give
the horizontal and vertical resolution,
measured in pixels or dots per inch (dpi),
for which the font was designed.
-Zero is used to indicate a scalable font (see <xref linkend="scalable_fonts"/>).
+Zero is used to indicate a scalable font (see <xref linkend='Scalable_Fonts' xrefstyle='select: title'/>).
Horizontal and vertical values are required
because a separate bitmap font must be designed
for displays with very different aspect ratios
@@ -1016,7 +1014,7 @@ and display sizes or for other typographic considerations.
</para>
</sect3>
-<sect3 id="spacing_field">
+<sect3 id='SPACING_Field'>
<title>SPACING Field</title>
<!-- .XS -->
<!-- (SN SPACING Field -->
@@ -1030,20 +1028,20 @@ data-processing character cell font model).
The encoding is as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
+ <colspec colname='c3' colwidth='6.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Code</entry>
<entry>English Translation</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>"P"</entry>
<entry>Proportional</entry>
<entry>
@@ -1052,7 +1050,7 @@ Note that no other restrictions are placed on the metrics
of a proportional font.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"M"</entry>
<entry>Monospaced</entry>
<entry>
@@ -1061,7 +1059,7 @@ A font whose logical character widths are constant
No other restrictions are placed on the metrics of a monospaced font.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"C"</entry>
<entry>CharCell</entry>
<entry>
@@ -1086,7 +1084,7 @@ The cell height = font-descent + font-ascent, and the width = AVERAGE_WIDTH.
</informaltable>
</sect3>
-<sect3 id="average_width_field">
+<sect3 id='AVERAGE_WIDTH_Field'>
<title>AVERAGE_WIDTH Field</title>
<!-- .XS -->
<!-- (SN AVERAGE_WIDTH Field -->
@@ -1101,11 +1099,11 @@ writing direction for the font is right-to-left.
A leading "~" (TILDE) indicates a negative value.
For monospaced and character cell fonts,
this is the width of all glyphs in the font.
-Zero is used to indicate a scalable font (see <xref linkend="scalable_fonts"/>).
+Zero is used to indicate a scalable font (see <xref linkend='Scalable_Fonts' xrefstyle='select: title'/>).
</para>
</sect3>
-<sect3 id="charset_registry_and_charset_encoding_fields">
+<sect3 id='CHARSET_REGISTRY_and_CHARSET_ENCODING_Fields'>
<title>CHARSET_REGISTRY and CHARSET_ENCODING Fields</title>
<!-- .XS -->
<!-- (SN CHARSET_REGISTRY and CHARSET_ENCODING Fields -->
@@ -1143,51 +1141,51 @@ be constructed according to the following conventions:
<!-- .IN "CHARSET Syntax" -->
<!-- .SM -->
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>CharsetRegistry ::=</entry>
<entry>StdCharsetRegistryName | PrivCharsetRegistryName</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>CharsetEncoding ::=</entry>
<entry>StdCharsetEncodingName | PrivCharsetEncodingName</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>StdCharsetRegistryName ::=</entry>
<entry>StdOrganizationId StdNumber | StdOrganizationId StdNumber Dot Year</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PrivCharsetRegistryName ::=</entry>
<entry>OrganizationId STRING8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>StdCharsetEncodingName ::=</entry>
<entry>STRING8-numeric part number of referenced standard</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PrivCharsetEncodingName ::=</entry>
<entry>STRING8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>StdOrganizationId ::=</entry>
<entry>STRING8-the registered name or acronym of the referenced standard organization</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>StdNumber ::=</entry>
<entry>STRING8-referenced standard number</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OrganizationId ::=</entry>
<entry>STRING8-the registered name or acronym of the organization</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Dot ::=</entry>
<entry>OCTET-"." (FULL STOP)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Year ::=</entry>
<entry>STRING8-numeric year (for example, 1989)</entry>
</row>
@@ -1226,55 +1224,55 @@ The BNF for the subsetting hint is
</para>
<!-- .SM -->
<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>Subset ::=</entry>
<entry>LeftBracket RangeList RightBracket</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>RangeList ::=</entry>
<entry>Range | Range Space RangeList</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Range ::=</entry>
<entry>Number | Number Underscore Number</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Number ::=</entry>
<entry>"0x" HexNumber | DecNumber</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>HexNumber ::=</entry>
<entry>HexDigit | HexDigit HexNumber</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DecNumber ::=</entry>
<entry>DecDigit | DecDigit DecNumber</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DecDigit ::=</entry>
<entry>"0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>HexDigit ::=</entry>
<entry>DecDigit | "a" | "b" | "c" | "d" | "e" | "f"</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>LeftBracket ::=</entry>
<entry>"[" (LEFT SQUARE BRACKET)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>RightBracket ::=</entry>
<entry>"]" (RIGHT SQUARE BRACKET)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Space ::=</entry>
<entry>"\0" (SPACE)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Underscore ::=</entry>
<entry>"_" (LOW LINE)</entry>
</row>
@@ -1315,7 +1313,7 @@ tells the font source that the client is interested only in characters
</sect3>
</sect2>
-<sect2 id="examples">
+<sect2 id='Examples'>
<title>Examples</title>
<!-- .XS -->
<!-- (SN Examples -->
@@ -1328,96 +1326,96 @@ shipped with the X Consortium distribution.
<!-- .\" why is this table so long? I took out some fonts in v1.5 -->
<!-- .\" to make the page breaks better. -->
<!-- .SM -->
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Font</entry>
<entry>X FontName</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry><function>75-dpi Fonts</function></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Charter 12 pt</entry>
<entry>-Bitstream-Charter-Medium-R-Normal--12-120-75-75-P-68-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Charter Bold 12 pt</entry>
<entry>-Bitstream-Charter-Bold-R-Normal--12-120-75-75-P-76-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Charter Bold Italic 12 pt</entry>
<entry>-Bitstream-Charter-Bold-I-Normal--12-120-75-75-P-75-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Charter Italic 12 pt</entry>
<entry>-Bitstream-Charter-Medium-I-Normal--12-120-75-75-P-66-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier 8 pt</entry>
<entry>-Adobe-Courier-Medium-R-Normal--8-80-75-75-M-50-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier 10 pt</entry>
<entry>-Adobe-Courier-Medium-R-Normal--10-100-75-75-M-60-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier 12 pt</entry>
<entry>-Adobe-Courier-Medium-R-Normal--12-120-75-75-M-70-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier 24 pt</entry>
<entry>-Adobe-Courier-Medium-R-Normal--24-240-75-75-M-150-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier Bold 10 pt</entry>
<entry>-Adobe-Courier-Bold-R-Normal--10-100-75-75-M-60-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier Bold Oblique 10 pt</entry>
<entry>-Adobe-Courier-Bold-O-Normal--10-100-75-75-M-60-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Courier Oblique 10 pt</entry>
<entry>-Adobe-Courier-Medium-O-Normal--10-100-75-75-M-60-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry><function>100-dpi Fonts</function></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Symbol 10 pt</entry>
<entry>-Adobe-Symbol-Medium-R-Normal--14-100-100-100-P-85-Adobe-FONTSPECIFIC</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Symbol 14 pt</entry>
<entry>-Adobe-Symbol-Medium-R-Normal--20-140-100-100-P-107-Adobe-FONTSPECIFIC</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Symbol 18 pt</entry>
<entry>-Adobe-Symbol-Medium-R-Normal--25-180-100-100-P-142-Adobe-FONTSPECIFIC</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Symbol 24 pt</entry>
<entry>-Adobe-Symbol-Medium-R-Normal--34-240-100-100-P-191-Adobe-FONTSPECIFIC</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Times Bold 10 pt</entry>
<entry>-Adobe-Times-Bold-R-Normal--14-100-100-100-P-76-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Times Bold Italic 10 pt</entry>
<entry>-Adobe-Times-Bold-I-Normal--14-100-100-100-P-77-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Times Italic 10 pt</entry>
<entry>-Adobe-Times-Medium-I-Normal--14-100-100-100-P-73-ISO8859-1</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Times Roman 10 pt</entry>
<entry>-Adobe-Times-Medium-R-Normal--14-100-100-100-P-74-ISO8859-1</entry>
</row>
@@ -1427,7 +1425,7 @@ shipped with the X Consortium distribution.
</sect2>
</sect1>
-<sect1 id="font_properties">
+<sect1 id='Font_Properties'>
<title>Font Properties</title>
<!-- .XS -->
<!-- (SN Font Properties -->
@@ -1467,28 +1465,28 @@ The Backus-Naur Form syntax description of X font properties is as follows:
<!-- .IN "Font Properties" "BNF Syntax" -->
<!-- .SM -->
<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>Properties ::=</entry>
<entry>OptFontPropList</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OptFontPropList ::=</entry>
<entry>NULL | OptFontProp OptFontPropList</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OptFontProp ::=</entry>
<entry>PrivateFontProp | XFontProp</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>PrivateFontProp ::=</entry>
<entry>STRING8 | Underscore OrganizationId Underscore STRING8</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>XFontProp ::=</entry>
<entry>
FOUNDRY | FAMILY_NAME | WEIGHT_NAME | SLANT | SETWIDTH_NAME | ADD_STYLE_NAME
@@ -1507,11 +1505,11 @@ NOTICE | DESTINATION
RAW_ASCENT | RAW_DESCENT | RAW_* | AXIS_NAMES | AXIS_LIMITS |
AXIS_TYPES</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Underscore ::=</entry>
<entry>OCTET-"_" (LOW LINE)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OrganizationId ::=</entry>
<entry>STRING8-the registered name of the organization</entry>
</row>
@@ -1519,7 +1517,7 @@ AXIS_TYPES</entry>
</tgroup>
</informaltable>
-<sect2 id="foundry">
+<sect2 id='FOUNDRY'>
<title>FOUNDRY</title>
<!-- .XS -->
<!-- (SN FOUNDRY -->
@@ -1536,7 +1534,7 @@ FOUNDRY cannot be calculated or defaulted if not supplied as a font property.
</para>
</sect2>
-<sect2 id="family_name">
+<sect2 id='FAMILY_NAME'>
<title>FAMILY_NAME</title>
<!-- .XS -->
<!-- (SN FAMILY_NAME -->
@@ -1554,7 +1552,7 @@ property.
</para>
</sect2>
-<sect2 id="weight_name ">
+<sect2 id='WEIGHT_NAME'>
<title>WEIGHT_NAME</title>
<!-- .XS -->
<!-- (SN WEIGHT_NAME -->
@@ -1576,8 +1574,8 @@ if (WEIGHT_NAME undefined) then
</literallayout>
</sect2>
-<sect2 id="slant">
-<title>SLANT </title>
+<sect2 id='SLANT'>
+<title>SLANT</title>
<!-- .XS -->
<!-- (SN SLANT -->
<!-- .XE -->
@@ -1598,7 +1596,7 @@ if (SLANT undefined) then
</literallayout>
</sect2>
-<sect2 id="setwidth_name">
+<sect2 id='SETWIDTH_NAME'>
<title>SETWIDTH_NAME</title>
<!-- .XS -->
<!-- (SN SETWIDTH_NAME -->
@@ -1620,7 +1618,7 @@ if (SETWIDTH_NAME undefined) then
</literallayout>
</sect2>
-<sect2 id="add_style_name">
+<sect2 id='ADD_STYLE_NAME'>
<title>ADD_STYLE_NAME</title>
<!-- .XS -->
<!-- (SN ADD_STYLE_NAME -->
@@ -1642,7 +1640,7 @@ if (ADD_STYLE_NAME undefined) then
</literallayout>
</sect2>
-<sect2 id="pixel_size">
+<sect2 id='PIXEL_SIZE'>
<title>PIXEL_SIZE</title>
<!-- .XS -->
<!-- (SN PIXEL_SIZE -->
@@ -1686,6 +1684,7 @@ PIXEL_SIZE can be approximated if not supplied as a font property,
according to the following algorithm:
</para>
+<!-- <literallayout class="monospaced"> -->
<literallayout class="monospaced">
DeciPointsPerInch = 722.7
if (PIXEL_SIZE undefined) then
@@ -1694,7 +1693,7 @@ if (PIXEL_SIZE undefined) then
</sect2>
-<sect2 id="point_size">
+<sect2 id='POINT_SIZE'>
<title>POINT_SIZE</title>
<!-- .XS -->
<!-- (SN POINT_SIZE -->
@@ -1722,7 +1721,7 @@ Design POINT_SIZE cannot be calculated or approximated.
</para>
</sect2>
-<sect2 id="resolution_x">
+<sect2 id='RESOLUTION_X_x'>
<title>RESOLUTION_X</title>
<!-- .XS -->
<!-- (SN RESOLUTION_X -->
@@ -1739,7 +1738,7 @@ RESOLUTION_X cannot be calculated or approximated.
</para>
</sect2>
-<sect2 id="resolution_y">
+<sect2 id='RESOLUTION_Y_y'>
<title>RESOLUTION_Y</title>
<!-- .XS -->
<!-- (SN RESOLUTION_Y -->
@@ -1756,7 +1755,7 @@ RESOLUTION_X cannot be calculated or approximated.
</para>
</sect2>
-<sect2 id="spacing">
+<sect2 id='SPACING'>
<title>SPACING</title>
<!-- .XS -->
<!-- (SN SPACING -->
@@ -1775,7 +1774,7 @@ according to the definitions given above for the
</para>
</sect2>
-<sect2 id="average_width">
+<sect2 id='AVERAGE_WIDTH'>
<title>AVERAGE_WIDTH</title>
<!-- .XS -->
<!-- (SN AVERAGE_WIDTH -->
@@ -1815,7 +1814,7 @@ if (SPACING not proportional) then
</literallayout>
</sect2>
-<sect2 id="charset_registry">
+<sect2 id='CHARSET_REGISTRY'>
<title>CHARSET_REGISTRY</title>
<!-- .XS -->
<!-- (SN CHARSET_REGISTRY -->
@@ -1832,7 +1831,7 @@ CHARSET_REGISTRY cannot be defaulted if not supplied as a font property.
</para>
</sect2>
-<sect2 id="charset_encoding">
+<sect2 id='CHARSET_ENCODING'>
<title>CHARSET_ENCODING</title>
<!-- .XS -->
<!-- (SN CHARSET_ENCODING -->
@@ -1849,7 +1848,7 @@ CHARSET_ENCODING cannot be defaulted if not supplied as a font property.
</para>
</sect2>
-<sect2 id="min_space">
+<sect2 id='MIN_SPACE'>
<title>MIN_SPACE</title>
<!-- .XS -->
<!-- (SN MIN_SPACE -->
@@ -1871,7 +1870,7 @@ if (MIN_SPACE undefined) then
</literallayout>
</sect2>
-<sect2 id="norm_space">
+<sect2 id='NORM_SPACE'>
<title>NORM_SPACE</title>
<!-- .XS -->
<!-- (SN NORM_SPACE -->
@@ -1896,7 +1895,7 @@ if (NORM_SPACE undefined) then
</literallayout>
</sect2>
-<sect2 id="max_space">
+<sect2 id='MAX_SPACE'>
<title>MAX_SPACE</title>
<!-- .XS -->
<!-- (SN MAX_SPACE -->
@@ -1918,7 +1917,7 @@ if (MAX_SPACE undefined) then
</literallayout>
</sect2>
-<sect2 id="end_space">
+<sect2 id='END_SPACE'>
<title>END_SPACE</title>
<!-- .XS -->
<!-- (SN END_SPACE -->
@@ -1940,7 +1939,7 @@ if (END_SPACE undefined) then
</literallayout>
</sect2>
-<sect2 id="avg_capital_width">
+<sect2 id='AVG_CAPITAL_WIDTH'>
<title>AVG_CAPITAL_WIDTH</title>
<!-- .XS -->
<!-- (SN AVG_CAPITAL_WIDTH -->
@@ -1973,7 +1972,7 @@ if (AVG_CAPITAL_WIDTH undefined) then
</literallayout>
</sect2>
-<sect2 id="avg_lowercase_width">
+<sect2 id='AVG_LOWERCASE_WIDTH'>
<title>AVG_LOWERCASE_WIDTH</title>
<!-- .XS -->
<!-- (SN AVG_LOWERCASE_WIDTH -->
@@ -2006,7 +2005,7 @@ if (AVG_LOWERCASE_WIDTH undefined) then
</literallayout>
</sect2>
-<sect2 id="quad_width">
+<sect2 id='QUAD_WIDTH'>
<title>QUAD_WIDTH</title>
<!-- .XS -->
<!-- (SN QUAD_WIDTH -->
@@ -2033,7 +2032,7 @@ the FIGURE_WIDTH or one of the average character width font properties
<!-- .NE -->
</sect2>
-<sect2 id="figure_width">
+<sect2 id='FIGURE_WIDTH'>
<title>FIGURE_WIDTH</title>
<!-- .XS -->
<!-- (SN FIGURE_WIDTH -->
@@ -2058,7 +2057,7 @@ else FIGURE_WIDTH property undefined
</literallayout>
</sect2>
-<sect2 id="superscript_x">
+<sect2 id='SUPERSCRIPT_X_x'>
<title>SUPERSCRIPT_X</title>
<!-- .XS -->
<!-- (SN SUPERSCRIPT_X -->
@@ -2091,7 +2090,7 @@ its argument, which is in 1/64 degrees.
</para>
</sect2>
-<sect2 id="superscript_y">
+<sect2 id='SUPERSCRIPT_Y_y'>
<title>SUPERSCRIPT_Y</title>
<!-- .XS -->
<!-- (SN SUPERSCRIPT_Y -->
@@ -2115,7 +2114,7 @@ if (SUPERSCRIPT_Y undefined) then
</literallayout>
</sect2>
-<sect2 id="subscript_x">
+<sect2 id='SUBSCRIPT_X_x'>
<title>SUBSCRIPT_X</title>
<!-- .XS -->
<!-- (SN SUBSCRIPT_X -->
@@ -2142,7 +2141,7 @@ if (SUBSCRIPT_X undefined) then
</literallayout>
</sect2>
-<sect2 id="subscript_y">
+<sect2 id='SUBSCRIPT_Y_y'>
<title>SUBSCRIPT_Y</title>
<!-- .XS -->
<!-- (SN SUBSCRIPT_Y -->
@@ -2167,7 +2166,7 @@ if (SUBSCRIPT_Y undefined) then
</literallayout>
</sect2>
-<sect2 id="superscript_size">
+<sect2 id='SUPERSCRIPT_SIZE'>
<title>SUPERSCRIPT_SIZE</title>
<!-- .XS -->
<!-- (SN SUPERSCRIPT_SIZE -->
@@ -2193,7 +2192,7 @@ if (SUPERSCRIPT_SIZE undefined) then
</literallayout>
</sect2>
-<sect2 id="subscript_size">
+<sect2 id='SUBSCRIPT_SIZE'>
<title>SUBSCRIPT_SIZE</title>
<!-- .XS -->
<!-- (SN SUBSCRIPT_SIZE -->
@@ -2220,7 +2219,7 @@ if (SUBSCRIPT_SIZE undefined) then
</literallayout>
</sect2>
-<sect2 id="small_cap_size">
+<sect2 id='SMALL_CAP_SIZE'>
<title>SMALL_CAP_SIZE</title>
<!-- .XS -->
<!-- (SN SMALL_CAP_SIZE -->
@@ -2247,8 +2246,8 @@ if (SMALL_CAP_SIZE undefined) then
</literallayout>
</sect2>
-<sect2 id="underline_position">
-<title>UNDERLINE_POSITION </title>
+<sect2 id='UNDERLINE_POSITION'>
+<title>UNDERLINE_POSITION</title>
<!-- .XS -->
<!-- (SN UNDERLINE_POSITION -->
<!-- .XE -->
@@ -2277,7 +2276,7 @@ in pixels of any glyph in the font.
</para>
</sect2>
-<sect2 id="underline_thickness">
+<sect2 id='UNDERLINE_THICKNESS'>
<title>UNDERLINE_THICKNESS</title>
<!-- .XS -->
<!-- (SN UNDERLINE_THICKNESS -->
@@ -2300,7 +2299,7 @@ if (UNDERLINE_THICKNESS undefined) then
</literallayout>
</sect2>
-<sect2 id="strikeout_ascent">
+<sect2 id='STRIKEOUT_ASCENT'>
<title>STRIKEOUT_ASCENT</title>
<!-- .XS -->
<!-- (SN STRIKEOUT_ASCENT -->
@@ -2330,7 +2329,7 @@ in pixels of any glyph in the font.
</para>
</sect2>
-<sect2 id="strikeout_descent">
+<sect2 id='STRIKEOUT_DESCENT'>
<title>STRIKEOUT_DESCENT</title>
<!-- .XS -->
<!-- (SN STRIKEOUT_DESCENT -->
@@ -2362,7 +2361,7 @@ in pixels of any glyph in the font.
</para>
</sect2>
-<sect2 id="italic_angle">
+<sect2 id='ITALIC_ANGLE'>
<title>ITALIC_ANGLE</title>
<!-- .XS -->
<!-- (SN ITALIC_ANGLE -->
@@ -2384,7 +2383,7 @@ if (ITALIC_ANGLE undefined) then
</literallayout>
</sect2>
-<sect2 id="cap_height">
+<sect2 id='CAP_HEIGHT'>
<title>CAP_HEIGHT</title>
<!-- .XS -->
<!-- (SN CAP_HEIGHT -->
@@ -2419,7 +2418,7 @@ if (CAP_HEIGHT undefined) then
</literallayout>
</sect2>
-<sect2 id="x_height">
+<sect2 id='X_HEIGHT'>
<title>X_HEIGHT</title>
<!-- .XS -->
<!-- (SN X_HEIGHT -->
@@ -2455,7 +2454,7 @@ if (X_HEIGHT undefined) then
</literallayout>
</sect2>
-<sect2 id="relative_setwidth">
+<sect2 id='RELATIVE_SETWIDTH'>
<title>RELATIVE_SETWIDTH</title>
<!-- .XS -->
<!-- (SN RELATIVE_SETWIDTH -->
@@ -2472,62 +2471,62 @@ according to the type designer's or FOUNDRY's judgment.
RELATIVE_SETWIDTH ranges from 10 to 90 or is 0 if undefined or unknown.
The following reference values are defined:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
+ <colspec colname='c3' colwidth='5.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Code</entry>
<entry>English Translation</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>0</entry>
<entry>Undefined</entry>
<entry>Undefined or unknown</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>10</entry>
<entry>UltraCondensed</entry>
<entry>The lowest ratio of average width to height</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>20</entry>
<entry>ExtraCondensed</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>30</entry>
<entry>Condensed</entry>
<entry>Condensed, Narrow, Compressed, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>40</entry>
<entry>SemiCondensed</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>50</entry>
<entry>Medium</entry>
<entry>Medium, Normal, Regular, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>60</entry>
<entry>SemiExpanded</entry>
<entry>SemiExpanded, DemiExpanded, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>70</entry>
<entry>Expanded</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>80</entry>
<entry>ExtraExpanded</entry>
<entry>ExtraExpanded, Wide, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>90</entry>
<entry>UltraExpanded</entry>
<entry>The highest ratio of average width to height</entry>
@@ -2570,7 +2569,7 @@ calculated setwidth.
</para>
</sect2>
-<sect2 id="relative_weight">
+<sect2 id='RELATIVE_WEIGHT'>
<title>RELATIVE_WEIGHT</title>
<!-- .XS -->
<!-- (SN RELATIVE_WEIGHT -->
@@ -2587,62 +2586,62 @@ according to the type designer's or FOUNDRY's judgment.
RELATIVE_WEIGHT ranges from 10 to 90 or is 0 if undefined or unknown.
The following reference values are defined:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
+ <colspec colname='c3' colwidth='6.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Code</entry>
<entry>English Translation</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>0</entry>
<entry>Undefined</entry>
<entry>Undefined or unknown</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>10</entry>
<entry>UltraLight</entry>
<entry>The lowest ratio of stem width to height</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>20</entry>
<entry>ExtraLight</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>30</entry>
<entry>Light</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>40</entry>
<entry>SemiLight</entry>
<entry>SemiLight, Book, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>50</entry>
<entry>Medium</entry>
<entry>Medium, Normal, Regular,...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>60</entry>
<entry>SemiBold</entry>
<entry>SemiBold, DemiBold, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>70</entry>
<entry>Bold</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>80</entry>
<entry>ExtraBold</entry>
<entry>ExtraBold, Heavy, ...</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>90</entry>
<entry>UltraBold</entry>
<entry>
@@ -2671,7 +2670,7 @@ linear function of the font's weight axis.
</para>
</sect2>
-<sect2 id="weight">
+<sect2 id='WEIGHT'>
<title>WEIGHT</title>
<!-- .XS -->
<!-- (SN WEIGHT -->
@@ -2706,7 +2705,7 @@ the weight across all fonts and all font vendors.
</para>
</sect2>
-<sect2 id="resolution">
+<sect2 id='RESOLUTION'>
<title>RESOLUTION</title>
<!-- .XS -->
<!-- (SN RESOLUTION -->
@@ -2731,7 +2730,7 @@ as required.
</para></note>
</sect2>
-<sect2 id="font">
+<sect2 id='Font_support'>
<title>FONT</title>
<!-- .XS -->
<!-- (SN FONT -->
@@ -2748,7 +2747,7 @@ If not provided, the FONT property cannot be calculated.
</para>
</sect2>
-<sect2 id="face_name">
+<sect2 id='FACE_NAME'>
<title>FACE_NAME</title>
<!-- .XS -->
<!-- (SN FACE_NAME -->
@@ -2768,7 +2767,7 @@ property.
</para>
</sect2>
-<sect2 id="full_name">
+<sect2 id='FULL_NAME'>
<title>FULL_NAME</title>
<!-- .XS -->
<!-- (SN FULL_NAME -->
@@ -2780,7 +2779,7 @@ Its use is deprecated, but it is found on some old fonts.
</para>
</sect2>
-<sect2 id="copyright">
+<sect2 id='COPYRIGHT'>
<title>COPYRIGHT</title>
<!-- .XS -->
<!-- (SN COPYRIGHT -->
@@ -2805,7 +2804,7 @@ property.
</para>
</sect2>
-<sect2 id="notice">
+<sect2 id='NOTICE'>
<title>NOTICE</title>
<!-- .XS -->
<!-- (SN NOTICE -->
@@ -2833,7 +2832,7 @@ a font property.
</para>
</sect2>
-<sect2 id="destination">
+<sect2 id='DESTINATION'>
<title>DESTINATION</title>
<!-- .XS -->
<!-- (SN DESTINATION -->
@@ -2860,20 +2859,21 @@ to query for X screen fonts that suit their particular requirements.
<!-- .LP -->
The encoding is as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
- <colspec colname='c3' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
+ <colspec colname='c3' colwidth='6.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Code</entry>
<entry>English Translation</entry>
<entry>Description</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>0</entry>
<entry>WYSIWYG</entry>
<entry>
@@ -2881,7 +2881,7 @@ The font is optimized to match the typographic design and metrics of an
equivalent printer font.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>1</entry>
<entry>Video text</entry>
<entry>
@@ -2893,7 +2893,7 @@ The font is optimized for screen legibility and readability.
</informaltable>
</sect2>
-<sect2 id="font_type">
+<sect2 id='FONT_TYPE'>
<title>FONT_TYPE</title>
<!-- .XS -->
<!-- (SN FONT_TYPE -->
@@ -2911,25 +2911,26 @@ without regard to the rasterizer used to render the font.
<!-- .LP -->
Predefined values are as follows:
</para>
-<informaltable frame="none">
- <tgroup cols='3' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='5.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Value</entry>
<entry>When applicable</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>"Bitmap"</entry>
<entry>
Hand-tuned bitmap fonts. Some attempt has been made to optimize the visual
appearance of the font for the requested size and resolution.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"Prebuilt"</entry>
<entry>
All bitmap format fonts that cannot be described as "Bitmap", that is,
@@ -2938,19 +2939,19 @@ For example, a bitmap format font that was generated mechanically using
a scalable font rasterizer would be considered "Prebuilt", not "Bitmap".
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"Type 1"</entry>
<entry>Any Type 1 font.</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"TrueType"</entry>
<entry>Any TrueType font.</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"Speedo"</entry>
<entry>Any Speedo font.</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>"F3"</entry>
<entry>Any F3 font.</entry>
</row>
@@ -2962,7 +2963,7 @@ Other values may be registered with the X Consortium.
</para>
</sect2>
-<sect2 id="font_version">
+<sect2 id='FONT_VERSION'>
<title>FONT_VERSION</title>
<!-- .XS -->
<!-- (SN FONT_VERSION -->
@@ -2975,7 +2976,7 @@ that describes the formal or informal version of the font.
</para>
</sect2>
-<sect2 id="rasterizer_name">
+<sect2 id='RASTERIZER_NAME'>
<title>RASTERIZER_NAME</title>
<!-- .XS -->
<!-- (SN RASTERIZER_NAME -->
@@ -2995,27 +2996,30 @@ recommended:
<!-- .SM -->
<informaltable frame="none">
- <tgroup cols='2' align='left'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>RasterizerName ::=</entry>
<entry>OrganizationId Space Rasterizer</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OrganizationId ::=</entry>
<entry>
STRING8—the X Registry ORGANIZATION name of the rasterizer
implementor or maintainer.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Rasterizer ::=</entry>
<entry>
the case-sensitive, human-understandable product name of the rasterizer.
Words within this name should be separated by a single SPACE.
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Space ::=</entry>
<entry>OCTET−" " (SPACE)</entry>
</row>
@@ -3044,7 +3048,7 @@ rasterization operation has been applied to the FONT_TYPE.
</para>
</sect2>
-<sect2 id="rasterizer_version">
+<sect2 id='RASTERIZER_VERSION'>
<title>RASTERIZER_VERSION</title>
<!-- .XS -->
<!-- (SN RASTERIZER_VERSION -->
@@ -3059,7 +3063,7 @@ product version number known to users, when applicable.
</para>
</sect2>
-<sect2 id="raw_ascent">
+<sect2 id='RAW_ASCENT'>
<title>RAW_ASCENT</title>
<!-- .XS -->
<!-- (SN RAW_ASCENT -->
@@ -3068,11 +3072,11 @@ product version number known to users, when applicable.
<!-- .LP -->
For a font with a transformation matrix, RAW_ASCENT is the font ascent
in 1000 pixel metrics
-(see <xref linkend="metrics_and_font_properties"/>).
+(see <xref linkend='Metrics_and_Font_Properties' xrefstyle='select: title'/>).
</para>
</sect2>
-<sect2 id="raw_descent">
+<sect2 id='RAW_DESCENT'>
<title>RAW_DESCENT</title>
<!-- .XS -->
<!-- (SN RAW_DESCENT -->
@@ -3081,11 +3085,11 @@ in 1000 pixel metrics
<!-- .LP -->
For a font with a transformation matrix, RAW_DESCENT is the font
descent in 1000 pixel metrics
-(see <xref linkend="metrics_and_font_properties"/>).
+(see <xref linkend='Metrics_and_Font_Properties' xrefstyle='select: title'/>).
</para>
</sect2>
-<sect2 id="raw_">
+<sect2 id='RAW_'>
<title>RAW_*</title>
<!-- .XS -->
<!-- (SN RAW_* -->
@@ -3096,11 +3100,11 @@ For a font with a transformation matrix,
all font properties that represent horizontal or vertical sizes or
displacements will be accompanied by a new property, named as the
original except prefixed with "RAW_", that is computed as
-described in <xref linkend="metrics_and_font_properties" />.
+described in <xref linkend='Metrics_and_Font_Properties' xrefstyle='select: title' />.
</para>
</sect2>
-<sect2 id="axis_names">
+<sect2 id='AXIS_NAMES'>
<title>AXIS_NAMES</title>
<!-- .XS -->
<!-- (SN AXIS_NAMES -->
@@ -3114,7 +3118,7 @@ These names are suitable for presentation in a user interface
</para>
</sect2>
-<sect2 id="axis_limits">
+<sect2 id='AXIS_LIMITS'>
<title>AXIS_LIMITS</title>
<!-- .XS -->
<!-- (SN AXIS_LIMITS -->
@@ -3124,11 +3128,11 @@ These names are suitable for presentation in a user interface
AXIS_LIMITS is a list of integers, two for each axis,
giving the minimum and maximum allowable values for that axis of a
polymorphic font
-(see <xref linkend="polymorphic_fonts"/>).
+(see <xref linkend='Polymorphic_Fonts' xrefstyle='select: title'/>).
</para>
</sect2>
-<sect2 id="axis_types">
+<sect2 id='AXIS_TYPES'>
<title>AXIS_TYPES</title>
<!-- .XS -->
<!-- (SN AXIS_TYPES -->
@@ -3142,7 +3146,7 @@ but can be registered as having specific semantics
</sect2>
</sect1>
-<sect1 id="built-in_font_property_atoms">
+<sect1 id='Built_in_Font_Property_Atoms'>
<title>Built-in Font Property Atoms</title>
<!-- .XS -->
<!-- (SN Built-in Font Property Atoms -->
@@ -3153,110 +3157,111 @@ The following font property atom definitions were predefined in the initial
version of the core protocol:
</para>
-<informaltable frame="none">
- <tgroup cols='2' align='left'>
- <colspec colname='c1' colsep="0"/>
- <colspec colname='c2' colsep="0"/>
+<informaltable frame="topbot">
+ <?dbfo keep-together="auto" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='2.0*'/>
<thead>
- <row rowsep="0">
+ <row rowsep='1'>
<entry>Font Property/Atom Name</entry>
<entry>Property Type</entry>
</row>
</thead>
<tbody>
- <row rowsep="0">
+ <row>
<entry>MIN_SPACE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>NORM_SPACE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>MAX_SPACE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>END_SPACE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SUPERSCRIPT_X</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SUPERSCRIPT_Y</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SUBSCRIPT_X</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SUBSCRIPT_Y</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>UNDERLINE_POSITION</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>UNDERLINE_THICKNESS</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>STRIKEOUT_ASCENT</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>STRIKEOUT_DESCENT</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FONT_ASCENT</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FONT_DESCENT</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>ITALIC_ANGLE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>X_HEIGHT</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>QUAD_WIDTH</entry>
<entry>INT32 −<superscript>deprecated</superscript></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>WEIGHT</entry>
<entry>CARD32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>POINT_SIZE</entry>
<entry>INT32</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>RESOLUTION</entry>
<entry>CARD32 −<superscript>deprecated</superscript></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>COPYRIGHT</entry>
<entry>ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FULL_NAME</entry>
<entry>ATOM −<superscript>deprecated</superscript></entry>
</row>
- <row rowsep="0">
+ <row>
<entry>FAMILY_NAME</entry>
<entry>ATOM</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>DEFAULT_CHAR</entry>
<entry>CARD32</entry>
</row>
@@ -3267,7 +3272,7 @@ version of the core protocol:
</sect1>
</chapter>
-<chapter id="matrix_transformations">
+<chapter id='Matrix_Transformations'>
<title>Matrix Transformations</title>
<!-- .XS -->
<!-- (SN Matrix Transformations -->
@@ -3289,78 +3294,80 @@ The BNF for a matrix transformation string is as follows:
</para>
<informaltable frame="none">
- <tgroup cols='2' align='left'>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
+ <colspec colname='c2' colwidth='3.0*'/>
<tbody>
- <row rowsep="0">
+ <row>
<entry>MatrixString ::=</entry>
<entry>
LeftBracket OptionalSpace Float Space Float Space
Float Space Float OptionalSpace RightBracket
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>OptionalSpace ::=</entry>
<entry>"" | Space</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Space ::=</entry>
<entry>SpaceChar | SpaceChar Space</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Float ::=</entry>
<entry>Mantissa | Mantissa Exponent</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Mantissa ::=</entry>
<entry>Sign Number | Number</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Sign ::=</entry>
<entry>Plus | Tilde</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Number ::=</entry>
<entry>Integer | Integer Dot Integer | Dot Integer</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Integer ::=</entry>
<entry>Digit | Digit Integer</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Digit ::=</entry>
<entry>
"0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"
</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Exponent ::=</entry>
<entry>"e" SignedInteger | "E" SignedInteger</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SignedInteger ::=</entry>
<entry>Sign Integer | Integer</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>LeftBracket ::=</entry>
<entry>OCTET − "[" (LEFT SQUARE BRACKET)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>RightBracket ::=</entry>
<entry>OCTET − "]" (RIGHT SQUARE BRACKET)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>SpaceChar ::=</entry>
<entry>OCTET − " " (SPACE)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Tilde ::=</entry>
<entry>OCTET − "˜" (TILDE)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Plus ::=</entry>
<entry>OCTET − "+" (PLUS)</entry>
</row>
- <row rowsep="0">
+ <row>
<entry>Dot ::=</entry>
<entry>OCTET − "." (FULL STOP)</entry>
</row>
@@ -3375,16 +3382,18 @@ in the font by the matrix
</para>
<informaltable frame="none">
- <tgroup cols='1' align='left'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='1' align='left' colsep='0' rowsep='0'>
+ <colspec colname='c1' colwidth='1.0*'/>
<tbody>
- <row rowsep="0">
- <entry> [ a b 0 ]</entry>
+ <row>
+ <entry>[ a b 0 ]</entry>
</row>
- <row rowsep="0">
- <entry> [ c d 0 ]</entry>
+ <row>
+ <entry>[ c d 0 ]</entry>
</row>
- <row rowsep="0">
- <entry> [ 0 0 1 ]</entry>
+ <row>
+ <entry>[ 0 0 1 ]</entry>
</row>
</tbody>
</tgroup>
@@ -3427,7 +3436,7 @@ wildcarded), the preceding formulas can be used to compute one from the
other.
</para>
-<sect1 id="metrics_and_font_properties">
+<sect1 id='Metrics_and_Font_Properties'>
<title>Metrics and Font Properties</title>
<!-- .XS -->
<!-- (SN Metrics and Font Properties -->
@@ -3518,7 +3527,7 @@ the value of the width, height, or displacement in 1000 pixel metrics.
</sect1>
</chapter>
-<chapter id="scalable_fonts">
+<chapter id='Scalable_Fonts'>
<title>Scalable Fonts</title>
<!-- .XS -->
<!-- (SN Scalable Fonts -->
@@ -3694,7 +3703,7 @@ to use a more sophisticated matching algorithm.
</para>
</chapter>
-<chapter id="polymorphic_fonts">
+<chapter id='Polymorphic_Fonts'>
<title>Polymorphic Fonts</title>
<!-- .XS -->
<!-- (SN Polymorphic Fonts -->
@@ -3868,7 +3877,7 @@ accommodate the value.
</para>
</chapter>
-<chapter id="affected_elements_of_xlib_and_the_x_protocol">
+<chapter id='Affected_Elements_of_Xlib_and_the_X_Protocol'>
<title>Affected Elements of Xlib and the X Protocol</title>
<!-- .XS -->
<!-- (SN Affected Elements of Xlib and the X Protocol -->
@@ -3906,32 +3915,32 @@ the following Xlib functions must support the XLFD conventions:
<itemizedlist>
<listitem>
<para>
-<function>XLoadFont</function>
+<olink targetdoc='libX11' targetptr='XLoadFont'><function>XLoadFont</function></olink>
- for the name argument
</para>
</listitem>
<listitem>
<para>
-<function>XListFontsWithInfo</function>
+<olink targetdoc='libX11' targetptr='XListFontsWithInfo'><function>XListFontsWithInfo</function></olink>
- for the pattern argument
</para>
</listitem>
<listitem>
<para>
-<function>XLoadQueryFont</function>
+<olink targetdoc='libX11' targetptr='XLoadQueryFont'><function>XLoadQueryFont</function></olink>
- for the name argument
</para>
</listitem>
<listitem>
<para>
-<function>XListFonts</function>
+<olink targetdoc='libX11' targetptr='XListFonts'><function>XListFonts</function></olink>
- for the pattern argument
</para>
</listitem>
</itemizedlist>
</chapter>
-<chapter id="bdf_conformance">
+<chapter id='BDF_Conformance'>
<title>BDF Conformance</title>
<!-- .XS -->
<!-- (SN BDF Conformance -->
@@ -3946,7 +3955,7 @@ or the semantics of the font properties that might be provided in a BDF font.
This section identifies the requirements for BDF fonts that conform to XLFD.
</para>
-<sect1 id="xlfd_conformance_requirements">
+<sect1 id='XLFD_Conformance_Requirements'>
<title>XLFD Conformance Requirements</title>
<!-- .XS -->
<!-- (SN XLFD Conformance Requirements -->
@@ -4002,7 +4011,7 @@ or follows the definition of a private property.
</para>
</sect1>
-<sect1 id="font_ascent_font_descent_and_default_char">
+<sect1 id='FONT_ASCENT_FONT_DESCENT_and_DEFAULT_CHAR'>
<title>FONT_ASCENT, FONT_DESCENT, and DEFAULT_CHAR</title>
<!-- .XS -->
<!-- (SN FONT_ASCENT, FONT_DESCENT, and DEFAULT_CHAR -->
@@ -4018,7 +4027,7 @@ If present,
these properties shall comply with the following semantic definitions.
</para>
-<sect2 id="font_ascent">
+<sect2 id='FONT_ASCENT'>
<title>FONT_ASCENT</title>
<!-- .XS -->
<!-- (SN FONT_ASCENT -->
@@ -4050,7 +4059,7 @@ in pixels of any glyph in the font.
</para>
</sect2>
-<sect2 id="font_descent">
+<sect2 id='FONT_DESCENT'>
<title>FONT_DESCENT</title>
<!-- .XS -->
<!-- (SN FONT_DESCENT -->
@@ -4085,7 +4094,7 @@ in pixels of any glyph in the font.
</para>
</sect2>
-<sect2 id="default_char">
+<sect2 id='DEFAULT_CHAR'>
<title>DEFAULT_CHAR</title>
<!-- .XS -->
<!-- (SN DEFAULT_CHAR -->
diff --git a/doc/xorg-docs/specs/Xext/Makefile.am b/doc/xorg-docs/specs/Xext/Makefile.am
index 6cdb477d2..f9c4253bf 100644
--- a/doc/xorg-docs/specs/Xext/Makefile.am
+++ b/doc/xorg-docs/specs/Xext/Makefile.am
@@ -1,9 +1,13 @@
+
if ENABLE_SPECS
-xmldir = $(docdir)/$(subdir)
-doc_sources = lbxalg.xml
-dist_xml_DATA = $(doc_sources)
+# Main DocBook/XML files (DOCTYPE book)
+docbook = lbxalg.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+shelfdir = $(docdir)/xext
-include $(top_srcdir)/xmlrules.in
+# Generate DocBook/XML output formats with or without stylesheets
+include $(top_srcdir)/docbook.am
endif ENABLE_SPECS
diff --git a/doc/xorg-docs/specs/Xext/Makefile.in b/doc/xorg-docs/specs/Xext/Makefile.in
index 13c445b40..094154071 100644
--- a/doc/xorg-docs/specs/Xext/Makefile.in
+++ b/doc/xorg-docs/specs/Xext/Makefile.in
@@ -15,26 +15,19 @@
@SET_MAKE@
#
-# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+# Generate output formats for a single DocBook/XML with/without chapters
#
-# 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:
+# 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.
#
-# 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.
+# 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.
#
srcdir = @srcdir@
@@ -46,9 +39,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ../..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -59,10 +52,14 @@ PRE_UNINSTALL = :
POST_UNINSTALL = :
build_triplet = @build@
host_triplet = @host@
-DIST_COMMON = $(am__dist_xml_DATA_DIST) $(srcdir)/Makefile.am \
- $(srcdir)/Makefile.in $(top_srcdir)/xmlrules.in
-@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt)
+DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
+ $(srcdir)/Makefile.in $(top_srcdir)/docbook.am
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
subdir = specs/Xext
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
@@ -72,17 +69,17 @@ mkinstalldirs = $(SHELL) $(install_sh) -d
CONFIG_CLEAN_FILES =
SOURCES =
DIST_SOURCES =
-am__dist_xml_DATA_DIST = lbxalg.xml
+am__dist_shelf_DATA_DIST = lbxalg.xml
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
am__vpath_adj = case $$p in \
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
*) f=$$p;; \
esac;
am__strip_dir = `echo $$p | sed -e 's|^.*/||'`;
-am__installdirs = "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"
-dist_xmlDATA_INSTALL = $(INSTALL_DATA)
-xmlDATA_INSTALL = $(INSTALL_DATA)
-DATA = $(dist_xml_DATA) $(xml_DATA)
+am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
+dist_shelfDATA_INSTALL = $(INSTALL_DATA)
+shelfDATA_INSTALL = $(INSTALL_DATA)
+DATA = $(dist_shelf_DATA) $(shelf_DATA)
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
ACLOCAL = @ACLOCAL@
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
@@ -97,6 +94,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -130,6 +128,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -160,12 +160,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
@@ -210,26 +212,73 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-@ENABLE_SPECS_TRUE@xmldir = $(docdir)/$(subdir)
-@ENABLE_SPECS_TRUE@doc_sources = lbxalg.xml
-@ENABLE_SPECS_TRUE@dist_xml_DATA = $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@xml_DATA = \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2)
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath $(XORG_SGML_PATH)/X11 \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam img.src.path=$(abs_builddir)/
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html
+
+# Main DocBook/XML files (DOCTYPE book)
+@ENABLE_SPECS_TRUE@docbook = lbxalg.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+@ENABLE_SPECS_TRUE@shelfdir = $(docdir)/xext
+
+# DocBook/XML generated output formats to be installed
+@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
+@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
+
+# DocBook/XML file with chapters, appendix and images it includes
+@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
+
+
+# Generate documents cross-reference target databases
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+
+@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
all: all-am
.SUFFIXES:
-.SUFFIXES: .xml .ps .pdf .txt .html
-$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/xmlrules.in $(am__configure_deps)
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
@for dep in $?; do \
case '$(am__configure_deps)' in \
*$$dep*) \
@@ -259,39 +308,39 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
uninstall-info-am:
-install-dist_xmlDATA: $(dist_xml_DATA)
+install-dist_shelfDATA: $(dist_shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(dist_xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(dist_xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(dist_shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(dist_shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-dist_xmlDATA:
+uninstall-dist_shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
-install-xmlDATA: $(xml_DATA)
+install-shelfDATA: $(shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-xmlDATA:
+uninstall-shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(xml_DATA)'; for p in $$list; do \
+ @list='$(shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
tags: TAGS
TAGS:
@@ -332,7 +381,7 @@ check-am: all-am
check: check-am
all-am: Makefile $(DATA)
installdirs:
- for dir in "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"; do \
+ for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
test -z "$$dir" || $(mkdir_p) "$$dir"; \
done
install: install-am
@@ -360,11 +409,9 @@ distclean-generic:
maintainer-clean-generic:
@echo "This command is intended for maintainers to use"
@echo "it deletes files that may require special tools to rebuild."
-@ENABLE_SPECS_FALSE@clean-local:
-@HAVE_XMLTO_FALSE@clean-local:
clean: clean-am
-clean-am: clean-generic clean-local mostlyclean-am
+clean-am: clean-generic mostlyclean-am
distclean: distclean-am
-rm -f Makefile
@@ -380,7 +427,7 @@ info: info-am
info-am:
-install-data-am: install-dist_xmlDATA install-xmlDATA
+install-data-am: install-dist_shelfDATA install-shelfDATA
install-exec-am:
@@ -406,37 +453,33 @@ ps: ps-am
ps-am:
-uninstall-am: uninstall-dist_xmlDATA uninstall-info-am \
- uninstall-xmlDATA
-
-.PHONY: all all-am check check-am clean clean-generic clean-local \
- distclean distclean-generic distdir dvi dvi-am html html-am \
- info info-am install install-am install-data install-data-am \
- install-dist_xmlDATA install-exec install-exec-am install-info \
- install-info-am install-man install-strip install-xmlDATA \
- installcheck installcheck-am installdirs maintainer-clean \
- maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
- pdf-am ps ps-am uninstall uninstall-am uninstall-dist_xmlDATA \
- uninstall-info-am uninstall-xmlDATA
-
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@chunked-html: $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources)
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@clean-local:
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)rm -fr html/
+uninstall-am: uninstall-dist_shelfDATA uninstall-info-am \
+ uninstall-shelfDATA
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am html html-am info info-am \
+ install install-am install-data install-data-am \
+ install-dist_shelfDATA install-exec install-exec-am \
+ install-info install-info-am install-man install-shelfDATA \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-dist_shelfDATA uninstall-info-am uninstall-shelfDATA
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
+
+# Generate DocBook/XML output formats with or without stylesheets
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/xorg-docs/specs/Xext/lbxalg.xml b/doc/xorg-docs/specs/Xext/lbxalg.xml
index 9c1a89ab0..27ae898db 100644
--- a/doc/xorg-docs/specs/Xext/lbxalg.xml
+++ b/doc/xorg-docs/specs/Xext/lbxalg.xml
@@ -1,12 +1,17 @@
<?xml version="1.0" encoding="UTF-8" ?>
-<!DOCTYPE article
- PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<article id='lbxalg'>
-<title>LBX X Consortium Algorithms</title>
+ <articleinfo>
+ <title>LBX X Consortium Algorithms</title>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+</articleinfo>
-<sect1 id='introduction'>
+<sect1 id='Introduction'>
<title>Introduction</title>
<para>
The Low Bandwidth X extension allows for negotiating various algorithms used
@@ -15,7 +20,7 @@ implementation of LBX in the X11 Release 6.4.
</para>
</sect1>
-<sect1 id='streaming_compression'>
+<sect1 id='Streaming_Compression'>
<title>Streaming Compression</title>
<para>
@@ -42,7 +47,7 @@ If the compflag is false, then the contents of the block are not compressed.
</sect1>
-<sect1 id='bitmap_compression'>
+<sect1 id='Bitmap_Compression'>
<title>Bitmap Compression</title>
<para>
LBX also negotiates for bitmap compression. The consortium
@@ -52,7 +57,7 @@ which uses the CCITT Group 4 2D compression algorithm.
</sect1>
-<sect1 id='pixmap_compression'>
+<sect1 id='Pixmap_Compression'>
<title>Pixmap Compression</title>
<para>
@@ -65,7 +70,7 @@ stream compressor to compress the image.
</sect1>
-<sect1 id='colormap_algorithm'>
+<sect1 id='Colormap_Algorithm'>
<title>Colormap Algorithm</title>
<para>
LBX negotiates for use of a colormap algorithm, used for color
diff --git a/doc/xorg-docs/specs/Xserver/Makefile.am b/doc/xorg-docs/specs/Xserver/Makefile.am
index 24e4c95dc..68f70152a 100644
--- a/doc/xorg-docs/specs/Xserver/Makefile.am
+++ b/doc/xorg-docs/specs/Xserver/Makefile.am
@@ -1,9 +1,13 @@
+
if ENABLE_SPECS
-xmldir = $(docdir)/$(subdir)
-doc_sources = analysis.xml appgroup.xml secint.xml XACE-Spec.xml
-dist_xml_DATA = $(doc_sources)
+# Main DocBook/XML files (DOCTYPE book)
+docbook = analysis.xml appgroup.xml secint.xml XACE-Spec.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+shelfdir = $(docdir)/Xserver
-include $(top_srcdir)/xmlrules.in
+# Generate DocBook/XML output formats with or without stylesheets
+include $(top_srcdir)/docbook.am
endif ENABLE_SPECS
diff --git a/doc/xorg-docs/specs/Xserver/Makefile.in b/doc/xorg-docs/specs/Xserver/Makefile.in
index 618ec2708..bb292e2cc 100644
--- a/doc/xorg-docs/specs/Xserver/Makefile.in
+++ b/doc/xorg-docs/specs/Xserver/Makefile.in
@@ -15,26 +15,19 @@
@SET_MAKE@
#
-# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
+# Generate output formats for a single DocBook/XML with/without chapters
#
-# 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:
+# 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.
#
-# 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.
+# 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.
#
srcdir = @srcdir@
@@ -46,9 +39,9 @@ pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ../..
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
-install_sh_DATA = $(install_sh) -c -m 644
-install_sh_PROGRAM = $(install_sh) -c
-install_sh_SCRIPT = $(install_sh) -c
+install_sh_DATA = ${SHELL} $(install_sh) -c -m 644
+install_sh_PROGRAM = ${SHELL} $(install_sh) -c
+install_sh_SCRIPT = ${SHELL} $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
@@ -59,10 +52,14 @@ PRE_UNINSTALL = :
POST_UNINSTALL = :
build_triplet = @build@
host_triplet = @host@
-DIST_COMMON = $(am__dist_xml_DATA_DIST) $(srcdir)/Makefile.am \
- $(srcdir)/Makefile.in $(top_srcdir)/xmlrules.in
-@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(doc_sources:.xml=.ps) $(doc_sources:.xml=.pdf)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(doc_sources:.xml=.txt)
+DIST_COMMON = $(am__dist_shelf_DATA_DIST) $(srcdir)/Makefile.am \
+ $(srcdir)/Makefile.in $(top_srcdir)/docbook.am
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_1 = $(docbook:.xml=.html)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@am__append_2 = $(docbook:.xml=.txt)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@am__append_3 = $(docbook:.xml=.pdf) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(docbook:.xml=.ps)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@am__append_4 = $(docbook:.xml=.html.db) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(docbook:.xml=.pdf.db)
subdir = specs/Xserver
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
@@ -72,7 +69,7 @@ mkinstalldirs = $(SHELL) $(install_sh) -d
CONFIG_CLEAN_FILES =
SOURCES =
DIST_SOURCES =
-am__dist_xml_DATA_DIST = analysis.xml appgroup.xml secint.xml \
+am__dist_shelf_DATA_DIST = analysis.xml appgroup.xml secint.xml \
XACE-Spec.xml
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
am__vpath_adj = case $$p in \
@@ -80,10 +77,10 @@ am__vpath_adj = case $$p in \
*) f=$$p;; \
esac;
am__strip_dir = `echo $$p | sed -e 's|^.*/||'`;
-am__installdirs = "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"
-dist_xmlDATA_INSTALL = $(INSTALL_DATA)
-xmlDATA_INSTALL = $(INSTALL_DATA)
-DATA = $(dist_xml_DATA) $(xml_DATA)
+am__installdirs = "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"
+dist_shelfDATA_INSTALL = $(INSTALL_DATA)
+shelfDATA_INSTALL = $(INSTALL_DATA)
+DATA = $(dist_shelf_DATA) $(shelf_DATA)
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
ACLOCAL = @ACLOCAL@
ADMIN_MAN_DIR = @ADMIN_MAN_DIR@
@@ -98,6 +95,7 @@ AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
+BASE_CFLAGS = @BASE_CFLAGS@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
@@ -131,6 +129,8 @@ HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@
HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@
HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@
HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@
+HAVE_XSLTPROC_FALSE = @HAVE_XSLTPROC_FALSE@
+HAVE_XSLTPROC_TRUE = @HAVE_XSLTPROC_TRUE@
INSTALL_CMD = @INSTALL_CMD@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
@@ -161,12 +161,14 @@ PKG_CONFIG = @PKG_CONFIG@
SED = @SED@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
+STRICT_CFLAGS = @STRICT_CFLAGS@
STRIP = @STRIP@
STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@
VERSION = @VERSION@
XMLTO = @XMLTO@
XORG_MAN_PAGE = @XORG_MAN_PAGE@
XORG_SGML_PATH = @XORG_SGML_PATH@
+XSLTPROC = @XSLTPROC@
XSL_STYLESHEET = @XSL_STYLESHEET@
ac_ct_CC = @ac_ct_CC@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
@@ -211,26 +213,73 @@ sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
-@ENABLE_SPECS_TRUE@xmldir = $(docdir)/$(subdir)
-@ENABLE_SPECS_TRUE@doc_sources = analysis.xml appgroup.xml secint.xml XACE-Spec.xml
-@ENABLE_SPECS_TRUE@dist_xml_DATA = $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@xml_DATA = \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(doc_sources:.xml=.html) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_1) \
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(am__append_2)
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FLAGS = \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ -m $(XSL_STYLESHEET) \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath $(XORG_SGML_PATH)/X11 \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam html.stylesheet=$(STYLESHEET_SRCDIR)/xorg.css \
-@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam img.src.path=$(abs_builddir)/
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@CLEANFILES = $(xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@SUFFIXES = .xml .ps .pdf .txt .html
+
+# Main DocBook/XML files (DOCTYPE book)
+@ENABLE_SPECS_TRUE@docbook = analysis.xml appgroup.xml secint.xml XACE-Spec.xml
+
+# The location where the DocBook/XML files and their generated formats are installed
+@ENABLE_SPECS_TRUE@shelfdir = $(docdir)/Xserver
+
+# DocBook/XML generated output formats to be installed
+@ENABLE_SPECS_TRUE@shelf_DATA = $(am__append_1) $(am__append_2) \
+@ENABLE_SPECS_TRUE@ $(am__append_3) $(am__append_4)
+
+# DocBook/XML file with chapters, appendix and images it includes
+@ENABLE_SPECS_TRUE@dist_shelf_DATA = $(docbook) $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --searchpath "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.html.xml \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_HTML_OLINK_FLAGS)
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_IMAGEPATH_FLAGS = --stringparam img.src.path=$(abs_builddir)/
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_PDF_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam target.database.document=$(XORG_SGML_PATH)/X11/dbs/masterdb.pdf.xml \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ --stringparam current.docid="$(<:.xml=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_STYLESHEET_FLAGS = -x $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@XMLTO_FO_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_STYLESHEET_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_FO_IMAGEPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(XMLTO_PDF_OLINK_FLAGS)
+
+
+# Generate documents cross-reference target databases
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_SEARCHPATH_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(XORG_SGML_PATH)/X11" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --path "$(abs_top_builddir)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_OLINK_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam targets.filename "$@" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam collect.xref.targets "only" \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --stringparam olink.base.uri "$(@:.db=)"
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_HTML_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-xhtml.xsl
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@XSLT_PDF_FLAGS = \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_SEARCHPATH_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(XSLT_OLINK_FLAGS) \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ --nonet --xinclude \
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(STYLESHEET_SRCDIR)/xorg-fo.xsl
+
+@ENABLE_SPECS_TRUE@CLEANFILES = $(shelf_DATA)
all: all-am
.SUFFIXES:
-.SUFFIXES: .xml .ps .pdf .txt .html
-$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/xmlrules.in $(am__configure_deps)
+$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/docbook.am $(am__configure_deps)
@for dep in $?; do \
case '$(am__configure_deps)' in \
*$$dep*) \
@@ -260,39 +309,39 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
uninstall-info-am:
-install-dist_xmlDATA: $(dist_xml_DATA)
+install-dist_shelfDATA: $(dist_shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(dist_xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(dist_xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(dist_shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(dist_shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-dist_xmlDATA:
+uninstall-dist_shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(dist_xml_DATA)'; for p in $$list; do \
+ @list='$(dist_shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
-install-xmlDATA: $(xml_DATA)
+install-shelfDATA: $(shelf_DATA)
@$(NORMAL_INSTALL)
- test -z "$(xmldir)" || $(mkdir_p) "$(DESTDIR)$(xmldir)"
- @list='$(xml_DATA)'; for p in $$list; do \
+ test -z "$(shelfdir)" || $(mkdir_p) "$(DESTDIR)$(shelfdir)"
+ @list='$(shelf_DATA)'; for p in $$list; do \
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
f=$(am__strip_dir) \
- echo " $(xmlDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(xmldir)/$$f'"; \
- $(xmlDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " $(shelfDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(shelfdir)/$$f'"; \
+ $(shelfDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(shelfdir)/$$f"; \
done
-uninstall-xmlDATA:
+uninstall-shelfDATA:
@$(NORMAL_UNINSTALL)
- @list='$(xml_DATA)'; for p in $$list; do \
+ @list='$(shelf_DATA)'; for p in $$list; do \
f=$(am__strip_dir) \
- echo " rm -f '$(DESTDIR)$(xmldir)/$$f'"; \
- rm -f "$(DESTDIR)$(xmldir)/$$f"; \
+ echo " rm -f '$(DESTDIR)$(shelfdir)/$$f'"; \
+ rm -f "$(DESTDIR)$(shelfdir)/$$f"; \
done
tags: TAGS
TAGS:
@@ -333,7 +382,7 @@ check-am: all-am
check: check-am
all-am: Makefile $(DATA)
installdirs:
- for dir in "$(DESTDIR)$(xmldir)" "$(DESTDIR)$(xmldir)"; do \
+ for dir in "$(DESTDIR)$(shelfdir)" "$(DESTDIR)$(shelfdir)"; do \
test -z "$$dir" || $(mkdir_p) "$$dir"; \
done
install: install-am
@@ -361,11 +410,9 @@ distclean-generic:
maintainer-clean-generic:
@echo "This command is intended for maintainers to use"
@echo "it deletes files that may require special tools to rebuild."
-@ENABLE_SPECS_FALSE@clean-local:
-@HAVE_XMLTO_FALSE@clean-local:
clean: clean-am
-clean-am: clean-generic clean-local mostlyclean-am
+clean-am: clean-generic mostlyclean-am
distclean: distclean-am
-rm -f Makefile
@@ -381,7 +428,7 @@ info: info-am
info-am:
-install-data-am: install-dist_xmlDATA install-xmlDATA
+install-data-am: install-dist_shelfDATA install-shelfDATA
install-exec-am:
@@ -407,37 +454,33 @@ ps: ps-am
ps-am:
-uninstall-am: uninstall-dist_xmlDATA uninstall-info-am \
- uninstall-xmlDATA
-
-.PHONY: all all-am check check-am clean clean-generic clean-local \
- distclean distclean-generic distdir dvi dvi-am html html-am \
- info info-am install install-am install-data install-data-am \
- install-dist_xmlDATA install-exec install-exec-am install-info \
- install-info-am install-man install-strip install-xmlDATA \
- installcheck installcheck-am installdirs maintainer-clean \
- maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
- pdf-am ps ps-am uninstall uninstall-am uninstall-dist_xmlDATA \
- uninstall-info-am uninstall-xmlDATA
-
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) txt $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) xhtml-nochunks $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop pdf $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(dist_xml_DATA)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) --with-fop ps $<
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@chunked-html: $(doc_sources)
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FLAGS) -o html xhtml $(doc_sources)
-
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@clean-local:
-@ENABLE_SPECS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)rm -fr html/
+uninstall-am: uninstall-dist_shelfDATA uninstall-info-am \
+ uninstall-shelfDATA
+
+.PHONY: all all-am check check-am clean clean-generic distclean \
+ distclean-generic distdir dvi dvi-am html html-am info info-am \
+ install install-am install-data install-data-am \
+ install-dist_shelfDATA install-exec install-exec-am \
+ install-info install-info-am install-man install-shelfDATA \
+ install-strip installcheck installcheck-am installdirs \
+ maintainer-clean maintainer-clean-generic mostlyclean \
+ mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
+ uninstall-dist_shelfDATA uninstall-info-am uninstall-shelfDATA
+
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.html: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) xhtml-nochunks $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@%.txt: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TEXT_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_HTML_FLAGS) txt $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.pdf: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop pdf $<
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@%.ps: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_FOP_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@ $(AM_V_GEN)$(XMLTO) $(XMLTO_FO_FLAGS) --with-fop ps $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.html.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_HTML_FLAGS) $<
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@%.pdf.db: %.xml $(chapters)
+@ENABLE_SPECS_TRUE@@HAVE_STYLESHEETS_TRUE@@HAVE_XMLTO_TRUE@@HAVE_XSLTPROC_TRUE@ $(AM_V_GEN)$(XSLTPROC) $(XSLT_PDF_FLAGS) $<
+
+# Generate DocBook/XML output formats with or without stylesheets
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/xorg-docs/specs/Xserver/XACE-Spec.xml b/doc/xorg-docs/specs/Xserver/XACE-Spec.xml
index 92e5fb385..bc7340db8 100644
--- a/doc/xorg-docs/specs/Xserver/XACE-Spec.xml
+++ b/doc/xorg-docs/specs/Xserver/XACE-Spec.xml
@@ -1,17 +1,20 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
-[]>
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<article>
<articleinfo>
<author><firstname>Eamon</firstname><othername>F.</othername><surname>Walsh</surname></author>
<authorinitials>efw</authorinitials>
<publisher><publishername>National Security Agency</publishername></publisher>
- <pubdate>2009</pubdate>
<title>X Access Control Extension Specification</title>
<titleabbrev>XACE-Spec</titleabbrev>
- <revhistory>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+ <pubdate>2009</pubdate>
+ <revhistory>
<revision>
<revnumber>1.0</revnumber>
<date>19 Oct 2006</date>
@@ -38,7 +41,30 @@
</revision>
</revhistory>
<legalnotice>
- <para>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 AUTHOR 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 OF OR OTHER DEALINGS IN THE SOFTWARE.</para>
+ <para>
+ 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:
+ </para>
+
+ <para>
+ The above copyright notice and this permission notice (including the next
+ paragraph) shall be included in all copies or substantial portions of the
+ Software.
+ </para>
+
+ <para>
+ THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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.
+ </para>
</legalnotice>
<abstract>
<para>The X Access Control Extension (XACE) is a set of generic "hooks" that can be used by other X extensions to perform access checks. The goal of XACE is to prevent clutter in the core dix/os code by providing a common mechanism for doing these sorts of checks. The concept is identical to the Linux Security Module (LSM) in the Linux Kernel.</para>
@@ -156,10 +182,10 @@
</funcprototype>
</funcsynopsis>
</blockquote>
- When the callback is called, <parameter>pcbl</parameter> points to the callback list itself. The X callback mechanism allows the list to be manipulated in various ways, but XACE callbacks should not do this. Remember that other security extensions may be registered on the same hook. <parameter>userdata</parameter> is set to the data argument that was passed to <function>XaceRegisterCallback</function> at registration time; this can be used by your extension to pass data into the callback. <parameter>calldata</parameter> points to a value or structure which is specific to each XACE hook. These are discussed in the documentation for each specific hook, below. Your extension must cast this argument to the appropriate pointer type.</para>
- <para>To register a callback on a given hook, use <function>XaceRegisterCallback</function>:
+ When the callback is called, <parameter>pcbl</parameter> points to the callback list itself. The X callback mechanism allows the list to be manipulated in various ways, but XACE callbacks should not do this. Remember that other security extensions may be registered on the same hook. <parameter>userdata</parameter> is set to the data argument that was passed to <xref linkend='XaceRegisterCallback' xrefstyle='select: title'/> at registration time; this can be used by your extension to pass data into the callback. <parameter>calldata</parameter> points to a value or structure which is specific to each XACE hook. These are discussed in the documentation for each specific hook, below. Your extension must cast this argument to the appropriate pointer type.</para>
+ <para>To register a callback on a given hook, use <xref linkend='XaceRegisterCallback' xrefstyle='select: title'/>:
<blockquote>
- <funcsynopsis>
+ <funcsynopsis id='XaceRegisterCallback'>
<funcprototype><funcdef>Bool <function>XaceRegisterCallback</function></funcdef>
<paramdef>
<parameter>int hook</parameter>
@@ -169,10 +195,10 @@
</funcprototype>
</funcsynopsis>
</blockquote>
- Where <parameter>hook</parameter> is the XACE hook you wish to register on, <parameter>callback</parameter> is the callback function you wish to register, and <parameter>userdata</parameter> will be passed through to the callback as its second argument, as described above. See <xref linkend="hooks_tab"/> for the list of XACE hook codes. <function>XaceRegisterCallback</function> is typically called from the extension initialization code; see the SECURITY source for examples. The return value is <literal>TRUE</literal> for success, <literal>FALSE</literal> otherwise.</para>
- <para>To unregister a callback, use <function>XaceDeleteCallback</function>:
+ Where <parameter>hook</parameter> is the XACE hook you wish to register on, <parameter>callback</parameter> is the callback function you wish to register, and <parameter>userdata</parameter> will be passed through to the callback as its second argument, as described above. See <xref linkend="hooks_tab"/> for the list of XACE hook codes. <xref linkend='XaceRegisterCallback' xrefstyle='select: title'/> is typically called from the extension initialization code; see the SECURITY source for examples. The return value is <literal>TRUE</literal> for success, <literal>FALSE</literal> otherwise.</para>
+ <para>To unregister a callback, use <xref linkend='XaceDeleteCallback' xrefstyle='select: title'/>:
<blockquote>
- <funcsynopsis>
+ <funcsynopsis id='XaceDeleteCallback'>
<funcprototype><funcdef>Bool <function>XaceDeleteCallback</function></funcdef>
<paramdef>
<parameter>int hook</parameter>
@@ -182,7 +208,7 @@
</funcprototype>
</funcsynopsis>
</blockquote>
- where the three arguments are identical to those used in the call to <function>XaceRegisterCallback</function>. The return value is <literal>TRUE</literal> for success, <literal>FALSE</literal> otherwise.</para>
+ where the three arguments are identical to those used in the call to <xref linkend='XaceRegisterCallback' xrefstyle='select: title'/>. The return value is <literal>TRUE</literal> for success, <literal>FALSE</literal> otherwise.</para>
</section>
<section>
diff --git a/doc/xorg-docs/specs/Xserver/analysis.xml b/doc/xorg-docs/specs/Xserver/analysis.xml
index 54a63b8ad..730789c0d 100644
--- a/doc/xorg-docs/specs/Xserver/analysis.xml
+++ b/doc/xorg-docs/specs/Xserver/analysis.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<!-- by TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)
@@ -11,29 +14,49 @@ xhtml,docbook,html,refcaption
<bookinfo>
<title>Analysis of the X Protocol for Security Concerns</title>
- <subtitle>Draft Version 2</subtitle>
- <date>May 10, 1996</date>
+ <pubdate>May 10, 1996</pubdate>
<authorgroup>
<author>
- <firstname>David</firstname><surname>Wiggins</surname>
+ <firstname>David</firstname><othername>P.</othername><surname>Wiggins</surname>
+ <affiliation><orgname>X Consortium</orgname></affiliation>
</author>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+ <releaseinfo>Draft Version 2</releaseinfo>
<copyright><year>1996</year><holder>X Consortium</holder></copyright>
- <affiliation><orgname>X Consortium</orgname></affiliation>
-
- <othercredit>
- <firstname>Matt</firstname><surname>Dew</surname>
- <contrib>conversion from tex to docbook</contrib>
- </othercredit>
<legalnotice>
-<para>THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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 X CONSORTIUM 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.</para>
-
-<para>Except as contained in this notice, the name of the X Consortium shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from the X Consortium.</para>
-
+<para>
+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:
+</para>
+<para>
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+</para>
+<para>
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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 X CONSORTIUM 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.
+</para>
+<para>
+Except as contained in this notice, the name of the X Consortium shall
+not be used in advertising or otherwise to promote the sale, use or
+other dealings in this Software without prior written authorization
+from the X Consortium.
+</para>
<para>X Window System is a trademark of The Open Group.</para>
</legalnotice>
+
<abstract>
<para>
This paper attempts to list all instances of certain types of security
@@ -45,7 +68,7 @@ the semantics of the X Protocol to reduce these risks.
</abstract>
</bookinfo>
-<chapter id="definition_of_threats">
+<chapter id='Definition_of_Threats'>
<title>Definition of Threats</title>
<para>
@@ -122,7 +145,7 @@ more damage.
</para>
</chapter>
-<chapter id="general_security_concerns_and_remedies">
+<chapter id='General_security_concerns_and_remedies'>
<title>General security concerns and remedies</title>
<para>
@@ -193,7 +216,7 @@ resource. The disallowed operations cause Access errors. The resiource at
issue is usually a root window.
</para>
-<sect1 id="access_to_server_resources">
+<sect1 id='Access_to_Server_Resources'>
<title>Access to Server Resources</title>
<para>
The X protocol allows clients to manipulate resources (objects) belonging to
@@ -255,10 +278,10 @@ or the ICCCM that breaks if you hide resources?
</sect1>
-<sect1 id="denial_of_service">
+<sect1 id='Denial_of_Service'>
<title>Denial of Service</title>
-<sect2 id="memory_exhaustion">
+<sect2 id='Memory_Exhaustion'>
<title>Memory Exhaustion</title>
<para>
@@ -325,7 +348,7 @@ mentioned as a defense in the list below.
</sect2>
-<sect2 id="cpu_monopolization">
+<sect2 id='CPU_Monopolization'>
<title>CPU Monopolization</title>
<para>
@@ -352,10 +375,10 @@ already exists in the server to support it, so this should be simple to add.
</chapter>
-<chapter id="security_concerns_with_specific_window_attributes">
+<chapter id='Security_concerns_with_specific_window_attributes'>
<title>Security concerns with specific window attributes</title>
-<sect1 id="background_pixmap">
+<sect1 id='Background_pixmap'>
<title>Background-pixmap</title>
<para>
Clients can use windows with the background-pixmap attribute set to None
@@ -408,7 +431,7 @@ contains bits from trusted windows?
</sect1>
-<sect1 id="parentrelative_and_copyfromparent">
+<sect1 id='ParentRelative_and_CopyFromParent'>
<title>ParentRelative and CopyFromParent</title>
<para>
@@ -431,7 +454,7 @@ below). We recommend that nothing more be done to counter this threat.
</sect1>
-<sect1 id="override_redirect">
+<sect1 id='Override_redirect'>
<title>Override-redirect</title>
<para>
Windows with the override-redirect bit set to True are generally ignored by
@@ -450,15 +473,14 @@ windows of untrusted clients.
Override-redirect windows also make some spoofing attacks easier since the
client can more carefully control the presentation of the window to mimic
another client. Defenses against spoofing will be given under
-<link linkend="mapwindow">
-<xref linkend="mapwindow"></xref></link>
+<xref linkend='MapWindow' xrefstyle='select: title'/>
.
</para>
</sect1>
</chapter>
-<chapter id="security_concerns_with_specific_requests">
+<chapter id='Security_concerns_with_specific_requests'>
<title>Security concerns with specific requests</title>
<para>
@@ -475,7 +497,7 @@ Resources owned by the server, such as the root window and the default
colormap, are considered to be owned by a trusted client.
</para>
-<sect1 id="create_window">
+<sect1 id='CreateWindow'>
<title>CreateWindow</title>
<para>
@@ -528,13 +550,12 @@ Defense: quotas.
</para>
<para>
Also
-<link linkend="security_concerns_with_specific_window_attributes">
-<xref linkend="security_concerns_with_specific_window_attributes"></xref></link>
+<xref linkend='Security_concerns_with_specific_window_attributes' xrefstyle='select: title'/>
</para>
</sect1>
-<sect1 id="changewindowattributes">
+<sect1 id='ChangeWindowAttributes'>
<title>ChangeWindowAttributes</title>
<para>
@@ -576,13 +597,12 @@ Defense: send Pixmap, Colormap, or Cursor error.
</para>
<para>
Also
-<link linkend="security_concerns_with_specific_window_attributes">
-<xref linkend="security_concerns_with_specific_window_attributes"></xref></link>
+<xref linkend='Security_concerns_with_specific_window_attributes' xrefstyle='select: title'/>
</para>
</sect1>
-<sect1 id="getwindowattributes">
+<sect1 id='GetWindowAttributes'>
<title>GetWindowAttributes</title>
<para>
@@ -597,7 +617,7 @@ Defense for both of the above: send Window error.
</sect1>
-<sect1 id="destroywindow__destroysubwindows">
+<sect1 id='DestroyWindow_DestroySubwindows'>
<title>DestroyWindow, DestroySubwindows</title>
<para>
@@ -611,7 +631,7 @@ Defense for both of the above: send Window error.
</para>
</sect1>
-<sect1 id="changesaveset">
+<sect1 id='ChangeSaveSet'>
<title>ChangeSaveSet</title>
<para>
@@ -635,7 +655,7 @@ Defense: send Window error.
</sect1>
-<sect1 id="mapwindow">
+<sect1 id='MapWindow'>
<title>MapWindow</title>
<para>
@@ -710,7 +730,7 @@ unobscurable windows.
</sect1>
-<sect1 id="window_operations">
+<sect1 id='Window_Operations'>
<title>Window Operations</title>
<para>
@@ -733,7 +753,7 @@ window, in which case we should send an Access error.
</sect1>
-<sect1 id="getgeometry">
+<sect1 id='GetGeometry'>
<title>GetGeometry</title>
<para>
@@ -750,7 +770,7 @@ will be allowed.
</sect1>
-<sect1 id="querytree">
+<sect1 id='QueryTree'>
<title>QueryTree</title>
<para>
@@ -785,15 +805,14 @@ window?
<para>
ISSUE: the Motif drag protocol (both preregister and dynamic) needs to be able
to locate other top-level windows for potential drop sites. See also
-<link linkend="access_to_server_resources">
-<xref linkend="access_to_server_resources"></xref></link>
+<xref linkend='Access_to_Server_Resources' xrefstyle='select: title'/>
.
</para>
</note>
</sect1>
-<sect1 id="internatom">
+<sect1 id='InternAtom'>
<title>InternAtom</title>
<para>
@@ -818,7 +837,7 @@ Defense: quotas.
</sect1>
-<sect1 id="getatomname">
+<sect1 id='GetAtomName'>
<title>GetAtomName</title>
<para>
@@ -834,7 +853,7 @@ threat.
</sect1>
-<sect1 id="changeproperty">
+<sect1 id='ChangeProperty'>
<title>ChangeProperty</title>
<para>
@@ -875,7 +894,7 @@ Defense: quotas.
</para>
</sect1>
-<sect1 id="deleteproperty">
+<sect1 id='DeleteProperty'>
<title>DeleteProperty</title>
<para>
@@ -892,7 +911,7 @@ Defense for both of the above: send Window error.
</sect1>
-<sect1 id="getproperty">
+<sect1 id='GetProperty'>
<title>GetProperty</title>
<para>
@@ -927,7 +946,7 @@ have fixed names.
</sect1>
-<sect1 id="rotateproperties">
+<sect1 id='RotateProperties'>
<title>RotateProperties</title>
<para>
@@ -943,7 +962,7 @@ Defense for both of the above: send Window error.
</para>
</sect1>
-<sect1 id="listproperties">
+<sect1 id='ListProperties'>
<title>ListProperties</title>
<para>
@@ -965,7 +984,7 @@ ISSUE: should certain root window properties be listable?
</note>
</sect1>
-<sect1 id="setselectionowner">
+<sect1 id='SetSelectionOwner'>
<title>SetSelectionOwner</title>
<para>
@@ -998,7 +1017,7 @@ Defense: send Window error.
</para>
</sect1>
-<sect1 id="getselectionowner">
+<sect1 id='GetSelectionOwner'>
<title>GetSelectionOwner</title>
<para>
@@ -1018,7 +1037,7 @@ ISSUE: how does the security manager get involved here?
</note>
</sect1>
-<sect1 id="convertselection">
+<sect1 id='ConvertSelection'>
<title>ConvertSelection</title>
<para>
@@ -1044,7 +1063,7 @@ Defense: send Window error.
</sect1>
-<sect1 id="sendevent">
+<sect1 id='SendEvent'>
<title>SendEvent</title>
<para>
@@ -1078,7 +1097,7 @@ Defense: send Window error.
</sect1>
-<sect1 id="keyboard_and_pointer_grabs">
+<sect1 id='Keyboard_and_Pointer_Grabs'>
<title>Keyboard and Pointer Grabs</title>
<para>
@@ -1095,8 +1114,7 @@ input may not have been intended for the grabbing client.
<para>
Defense: provide a way to break grabs via some keystroke combination, and
have a status area that shows which client is getting input. (See
-<link linkend="mapwindow">
-<xref linkend="mapwindow"></xref></link>
+<xref linkend='MapWindow' xrefstyle='select: title'/>
).
</para>
@@ -1112,7 +1130,7 @@ Defense: send Window or Cursor error.
-<sect1 id="changeactivepointergrab">
+<sect1 id='ChangeActivePointerGrab'>
<title>ChangeActivePointerGrab</title>
<para>
@@ -1125,7 +1143,7 @@ Defense: send Cursor error.
</sect1>
-<sect1 id="grabserver">
+<sect1 id='GrabServer'>
<title>GrabServer</title>
<para>
@@ -1139,7 +1157,7 @@ Defense: provide a way to break grabs via some keystroke combination.
</sect1>
-<sect1 id="querypointer">
+<sect1 id='QueryPointer'>
<title>QueryPointer</title>
<para>
@@ -1161,7 +1179,7 @@ Defense: send Window error.
</para>
</sect1>
-<sect1 id="getmotionevents">
+<sect1 id='GetMotionEvents'>
<title>GetMotionEvents</title>
<para>
@@ -1184,7 +1202,7 @@ Defense: send Window error.
</para>
</sect1>
-<sect1 id="translatecoordinates">
+<sect1 id='TranslateCoordinates'>
<title>TranslateCoordinates</title>
<para>
@@ -1206,7 +1224,7 @@ Defense: send Window error.
</para>
</sect1>
-<sect1 id="warppointer">
+<sect1 id='WarpPointer'>
<title>WarpPointer</title>
<para>
@@ -1233,7 +1251,7 @@ Defense: send Window error.
</para>
</sect1>
-<sect1 id="setinputfocus">
+<sect1 id='SetInputFocus'>
<title>SetInputFocus</title>
<para>
@@ -1269,7 +1287,7 @@ Defense: send Window error.
</sect1>
-<sect1 id="getinputfocus">
+<sect1 id='GetInputFocus'>
<title>GetInputFocus</title>
<para>
@@ -1282,7 +1300,7 @@ the input focus.
</sect1>
-<sect1 id="querykeymap">
+<sect1 id='QueryKeymap'>
<title>QueryKeymap</title>
<para>
@@ -1295,7 +1313,7 @@ the input focus.
</para>
</sect1>
-<sect1 id="font_requests">
+<sect1 id='Font_Requests'>
<title>Font Requests</title>
<para>
@@ -1343,7 +1361,7 @@ Defense: quotas.
</sect1>
-<sect1 id="closefont">
+<sect1 id='CloseFont'>
<title>CloseFont</title>
<para>
@@ -1354,7 +1372,7 @@ Defense: send Font error.
</para>
</sect1>
-<sect1 id="setfontpath">
+<sect1 id='SetFontPath'>
<title>SetFontPath</title>
<para>
@@ -1381,7 +1399,7 @@ surface.
</note>
</sect1>
-<sect1 id="getfontpath">
+<sect1 id='GetFontPath'>
<title>GetFontPath</title>
<para>
@@ -1398,7 +1416,7 @@ untrusted clients, as described in the Font Requests section.
</sect1>
-<sect1 id="createpixmap">
+<sect1 id='CreatePixmap'>
<title>CreatePixmap</title>
<para>
@@ -1415,7 +1433,7 @@ Defense: quotas.
</para>
</sect1>
-<sect1 id="freepixma">
+<sect1 id='FreePixmap'>
<title>FreePixmap</title>
<para>
@@ -1426,7 +1444,7 @@ Defense: send Pixmap error.
</para>
</sect1>
-<sect1 id="creategc">
+<sect1 id='CreateGC'>
<title>CreateGC</title>
<para>
@@ -1444,7 +1462,7 @@ Defense: quotas.
</sect1>
-<sect1 id="copygc">
+<sect1 id='CopyGC'>
<title>CopyGC</title>
<para>
@@ -1459,7 +1477,7 @@ Defense for both of the above: send GC error.
</sect1>
-<sect1 id="changegc__setdashes__setcliprectangles">
+<sect1 id='ChangeGC_SetDashes_SetClipRectangles'>
<title>ChangeGC, SetDashes, SetClipRectangles</title>
<para>
@@ -1474,7 +1492,7 @@ Defense for both of the above: send GC error.
</para>
</sect1>
-<sect1 id="freegc">
+<sect1 id='FreeGC'>
<title>FreeGC</title>
<para>
@@ -1487,7 +1505,7 @@ Defense: send GC error.
</sect1>
-<sect1 id="drawing_requests">
+<sect1 id='Drawing_Requests'>
<title>Drawing Requests</title>
<para>
@@ -1516,14 +1534,13 @@ Spoofing: draw to a window to make it resemble a window of another client.
</para>
<para>
Defense: see
-<link linkend="mapwindow">
-<xref linkend="mapwindow"></xref></link>
+<xref linkend='MapWindow' xrefstyle='select: title'/>
.
</para>
</sect1>
-<sect1 id="getimage">
+<sect1 id='GetImage'>
<title>GetImage</title>
<para>
@@ -1545,7 +1562,7 @@ from trusted windows.
</para>
</sect1>
-<sect1 id="createcolormap">
+<sect1 id='CreateColormap'>
<title>CreateColormap</title>
<para>
@@ -1564,7 +1581,7 @@ Defense: quotas.
</para>
</sect1>
-<sect1 id="freecolormap">
+<sect1 id='FreeColormap'>
<title>FreeColormap</title>
<para>
@@ -1576,7 +1593,7 @@ Defense: send Colormap error.
</sect1>
-<sect1 id="copycolormapandfree">
+<sect1 id='CopyColormapAndFree'>
<title>CopyColormapAndFree</title>
<para>
@@ -1601,7 +1618,7 @@ Defense: quotas.
</para>
</sect1>
-<sect1 id="installcolormap__uninstallcolormap">
+<sect1 id='InstallColormap_UninstallColormap'>
<title>InstallColormap, UninstallColormap</title>
<para>
@@ -1628,7 +1645,7 @@ has the pointer grabbed. Do we need to allow that too?
</note>
</sect1>
-<sect1 id="listinstalledcolormaps">
+<sect1 id='ListInstalledColormaps'>
<title>ListInstalledColormaps</title>
<para>
@@ -1647,7 +1664,7 @@ colormaps and colormaps of untrusted clients.
</para>
</sect1>
-<sect1 id="color_allocation_requests">
+<sect1 id='Color_Allocation_Requests'>
<title>Color Allocation Requests</title>
<para>
@@ -1668,7 +1685,7 @@ colormaps will be allowed.
</para>
</sect1>
-<sect1 id="freecolors">
+<sect1 id='FreeColors'>
<title>FreeColors</title>
<para>
@@ -1679,7 +1696,7 @@ Defense: send Colormap error. However, default colormaps will be allowed.
</para>
</sect1>
-<sect1 id="storecolors__storenamedcolor">
+<sect1 id='StoreColors_StoreNamedColor'>
<title>StoreColors, StoreNamedColor</title>
<para>
@@ -1695,7 +1712,7 @@ colormaps will be allowed.
</sect1>
-<sect1 id="querycolors__lookupcolor">
+<sect1 id='QueryColors_LookupColor'>
<title>QueryColors, LookupColor</title>
<para>
@@ -1710,7 +1727,7 @@ colormaps will be allowed.
</para>
</sect1>
-<sect1 id="createcursor__createglyphcursor">
+<sect1 id='CreateCursor_CreateGlyphCursor'>
<title>CreateCursor, CreateGlyphCursor</title>
<para>
@@ -1727,7 +1744,7 @@ Defense: quotas.
</para>
</sect1>
-<sect1 id="freecursor">
+<sect1 id='FreeCursor'>
<title>FreeCursor</title>
<para>
@@ -1738,7 +1755,7 @@ Defense: send Cursor error.
</para>
</sect1>
-<sect1 id="recolorcursor">
+<sect1 id='RecolorCursor'>
<title>RecolorCursor</title>
<para>
@@ -1752,7 +1769,7 @@ Defense for both of the above: send Cursor error.
</para>
</sect1>
-<sect1 id="querybestsize">
+<sect1 id='QueryBestSize'>
<title>QueryBestSize</title>
<para>
@@ -1763,7 +1780,7 @@ Defense: send Drawable error.
</para>
</sect1>
-<sect1 id="listextensions__queryextension">
+<sect1 id='ListExtensions_QueryExtension'>
<title>ListExtensions, QueryExtension</title>
<para>
@@ -1777,7 +1794,7 @@ about extensions that claim to be safe.
</para>
</sect1>
-<sect1 id="keyboard_configuration_requests">
+<sect1 id='Keyboard_configuration_requests'>
<title>Keyboard configuration requests</title>
<para>
@@ -1800,7 +1817,7 @@ Defense for both of the above: treat these requests as a no-op.
</sect1>
-<sect1 id="keyboard_query_requets">
+<sect1 id='Keyboard_query_requests'>
<title>Keyboard query requests</title>
<para>
@@ -1816,7 +1833,7 @@ threat.
</sect1>
-<sect1 id="changepointercontrol__setpointermapping">
+<sect1 id='ChangePointerControl_SetPointerMapping'>
<title>ChangePointerControl, SetPointerMapping</title>
<para>
@@ -1832,7 +1849,7 @@ Defense for both of the above: treat these requests as a no-op.
</para>
</sect1>
-<sect1 id="getpointercontrol__getpointermapping">
+<sect1 id='GetPointerControl_GetPointerMapping'>
<title>GetPointerControl, GetPointerMapping</title>
<para>
@@ -1844,7 +1861,7 @@ threat.
</para>
</sect1>
-<sect1 id="setscreensaver">
+<sect1 id='SetScreenSaver'>
<title>SetScreenSaver</title>
<para>
@@ -1861,7 +1878,7 @@ Defense for both of the above: treat these requests as a no-op.
</sect1>
-<sect1 id="getscreensaver">
+<sect1 id='GetScreenSaver'>
<title>GetScreenSaver</title>
<para>
@@ -1873,7 +1890,7 @@ threat.
</para>
</sect1>
-<sect1 id="forcescreensaver">
+<sect1 id='ForceScreenSaver'>
<title>ForceScreenSaver</title>
<para>
@@ -1889,7 +1906,7 @@ Defense for both of the above: treat these requests as a no-op.
</para>
</sect1>
-<sect1 id="changehost">
+<sect1 id='ChangeHost'>
<title>ChangeHost</title>
<para>
@@ -1910,7 +1927,7 @@ Defense for both of the above: return Access error.
</sect1>
-<sect1 id="listhosts">
+<sect1 id='ListHosts'>
<title>ListHosts</title>
<para>
@@ -1926,7 +1943,7 @@ Defense for both of the above: return only untrusted hosts.
</sect1>
-<sect1 id="setaccesscontrol">
+<sect1 id='SetAccessControl'>
<title>SetAccessControl</title>
<para>
@@ -1945,7 +1962,7 @@ Defense for both of the above: return Access error.
</para>
</sect1>
-<sect1 id="setclosedownmode">
+<sect1 id='SetCloseDownMode'>
<title>SetCloseDownMode</title>
<para>
@@ -1962,7 +1979,7 @@ Defense: treat this request as a no-op.
</para>
</sect1>
-<sect1 id="killclient">
+<sect1 id='KillClient'>
<title>KillClient</title>
<para>
@@ -1981,7 +1998,7 @@ Defense for all of the above: return Value error.
</para>
</sect1>
-<sect1 id="clean_requests">
+<sect1 id='Clean_Requests'>
<title>Clean Requests</title>
<para>
@@ -1992,7 +2009,7 @@ UngrabKey, UngrabServer, NoOperation, and Bell.
</sect1>
</chapter>
-<chapter id="events">
+<chapter id='Events'>
<title>Events</title>
<para>
@@ -2002,7 +2019,7 @@ assuming that the client only selects for events on its own resources,
then asking whether the events provide information about other clients.
</para>
-<sect1 id="keymapnotify">
+<sect1 id='KeymapNotify'>
<title>KeymapNotify</title>
<para>
@@ -2016,7 +2033,7 @@ input focus.
</para>
</sect1>
-<sect1 id="expose">
+<sect1 id='Expose'>
<title>Expose</title>
<para>
@@ -2032,7 +2049,7 @@ memory. We propose to do nothing about this threat.
</para>
</sect1>
-<sect1 id="graphicsexposure">
+<sect1 id='GraphicsExposure'>
<title>GraphicsExposure</title>
<para>
@@ -2045,7 +2062,7 @@ Defense: see Expose above. We propose to do nothing about this threat.
</para>
</sect1>
-<sect1 id="visibilitynotify">
+<sect1 id='VisibilityNotify'>
<title>VisibilityNotify</title>
<para>
@@ -2058,7 +2075,7 @@ do nothing about this threat.
</para>
</sect1>
-<sect1 id="reparentnotify">
+<sect1 id='ReparentNotify'>
<title>ReparentNotify</title>
<para>
@@ -2079,7 +2096,7 @@ ISSUE: what is the application impact?
</sect1>
-<sect1 id="configurenotify">
+<sect1 id='ConfigureNotify'>
<title>ConfigureNotify</title>
@@ -2099,7 +2116,7 @@ ISSUE: what is the application impact?
</sect1>
-<sect1 id="configurerequest">
+<sect1 id='ConfigureRequest'>
<title>ConfigureRequest</title>
<para>
@@ -2114,7 +2131,7 @@ ISSUE: what is the application impact?
</sect1>
-<sect1 id="selectionclear">
+<sect1 id='SelectionClear'>
<title>SelectionClear</title>
<para>
@@ -2125,7 +2142,7 @@ Defense: return None for the owner window if it belongs to a trusted client.
</para>
</sect1>
-<sect1 id="selectionrequest">
+<sect1 id='SelectionRequest'>
<title>SelectionRequest</title>
<para>
@@ -2141,7 +2158,7 @@ selections.
</sect1>
-<sect1 id="mappingnotify">
+<sect1 id='MappingNotify'>
<title>MappingNotify</title>
<para>
@@ -2156,7 +2173,7 @@ likely to confuse the user. We propose to do nothing about this threat.
</sect1>
</chapter>
-<chapter id="errors">
+<chapter id='Errors'>
<title>Errors</title>
<para>
@@ -2168,7 +2185,7 @@ There appear to be no threats related to procotol errors.
-<chapter id="future_work">
+<chapter id='Future_Work'>
<title>Future Work</title>
<para>
@@ -2180,7 +2197,7 @@ questions.
</chapter>
-<chapter id="references">
+<chapter id='References'>
<title>References</title>
<para>
diff --git a/doc/xorg-docs/specs/Xserver/appgroup.xml b/doc/xorg-docs/specs/Xserver/appgroup.xml
index ef3c06512..00750e8ff 100644
--- a/doc/xorg-docs/specs/Xserver/appgroup.xml
+++ b/doc/xorg-docs/specs/Xserver/appgroup.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<article id="appgroup">
@@ -8,28 +11,17 @@
<articleinfo>
<title>Description of the Application Group Extension</title>
<subtitle>Implementation for the X11 Sample Server</subtitle>
- <releaseinfo>Version 1.0</releaseinfo>
<authorgroup>
<author>
<firstname>Kaleb </firstname><surname>KEITHLEY</surname>
<affiliation><orgname>FUJITSU Limited.</orgname></affiliation>
</author>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
+ <releaseinfo>Version 1.0</releaseinfo>
<copyright><year>1996</year><holder>X Consortium</holder></copyright>
- <affiliation><orgname>X Consortium</orgname></affiliation>
- <productnumber>X Version 11, Release 7</productnumber>
-
-<abstract>
-<para>
-The following document explains the server side of the Application
-Group Extension.
-</para>
-</abstract>
<legalnotice>
-
-
<para>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -45,7 +37,7 @@ all copies or substantial portions of the Software.
</para>
<para>
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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
X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
@@ -54,16 +46,26 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
</para>
<para>
-The following document explains the server side of the Application
-Group Extension.
+Except as contained in this notice, the name of the X Consortium shall
+not be used in advertising or otherwise to promote the sale, use or
+other dealings in this Software without prior written authorization
+from the X Consortium.
</para>
+<para>X Window System is a trademark of The Open Group.</para>
+</legalnotice>
+
+<legalnotice>
+<para>WindowsNT is a trademark of Microsoft, Inc.</para>
+<para>Macintosh and Apple are trademarks of Apple Computer, Inc.</para>
+</legalnotice>
+<abstract>
<para>
-WindowsNT is a trademark of Microsoft, Inc. Macintosh and Apple
-are trademarks of Apple Computer, Inc. X Window System is a
-trademark of X Consortium, Inc.
+The following document explains the server side of the Application
+Group Extension.
</para>
-</legalnotice>
+</abstract>
+
</articleinfo>
<para>
@@ -229,7 +231,7 @@ by the record, and finally frees the record itself.
</para>
</sect1>
-<sect1 id="Known_Problems_in_this_release_">
+<sect1 id='Known_Problems_in_this_release'>
<title>Known Problems in this release.</title>
<para>
In a combined UI/Print server the connection setup returned to an
diff --git a/doc/xorg-docs/specs/Xserver/secint.xml b/doc/xorg-docs/specs/Xserver/secint.xml
index ad90bee4d..f2dd841bf 100644
--- a/doc/xorg-docs/specs/Xserver/secint.xml
+++ b/doc/xorg-docs/specs/Xserver/secint.xml
@@ -1,6 +1,9 @@
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
- "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
+[
+<!ENTITY % defs SYSTEM "defs.ent"> %defs;
+]>
<!--translated from secint.tex, on 2010-06-27 15:38:00,
@@ -12,36 +15,48 @@ xhtml,docbook,html,refcaption -->
<bookinfo>
<title>Security Extension Server Design Draft</title>
<subtitle>X Consortium Standard</subtitle>
- <releaseinfo>June 27, 2010</releaseinfo>
<authorgroup>
<author>
- <firstname>David</firstname><surname>Wiggins</surname>
+ <firstname>David</firstname><othername>P.</othername><surname>Wiggins</surname>
+ <affiliation><orgname>X Consortium</orgname></affiliation>
</author>
</authorgroup>
- <corpname>X Consortium Standard</corpname>
- <copyright><year>1996</year><holder>X Consortium</holder></copyright>
+ <releaseinfo>X Version 11, Release &fullrelvers;</releaseinfo>
<releaseinfo>Version 3.0</releaseinfo>
- <affiliation><orgname>X Consortium</orgname></affiliation>
- <productnumber>X Version 11, Release 7</productnumber>
+ <copyright><year>1996</year><holder>X Consortium</holder></copyright>
<legalnotice>
-<para>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 X
-CONSORTIUM 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 OF OR OTHER DEALINGS IN THE
-SOFTWARE.
+<para>
+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:
</para>
-<para>Except as contained in this notice, the name of the X Consortium shall
-not be used in advertising or otherwise to promote the sale, use or other
-dealings in this Software without prior written authorization from the X
-Consortium.
+<para>
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
</para>
-
+<para>
+THE SOFTWARE IS PROVIDED &ldquo;AS IS&rdquo;, 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 X CONSORTIUM 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.
+</para>
+<para>
+Except as contained in this notice, the name of the X Consortium shall
+not be used in advertising or otherwise to promote the sale, use or
+other dealings in this Software without prior written authorization
+from the X Consortium.
+</para>
+<para>X Window System is a trademark of The Open Group.</para>
</legalnotice>
+<pubdate>June 27, 2010</pubdate>
<abstract>
<para>This paper describes the implementation strategy used to implement
@@ -52,7 +67,7 @@ Consortium.
</bookinfo>
-<chapter id="generate_authorization_request">
+<chapter id='Generate_Authorization_Request'>
<title>Generate Authorization Request</title>
<para>
@@ -103,7 +118,7 @@ Return the authorization ID and generated auth data to the client.
</para>
</chapter>
-<chapter id="client_connection">
+<chapter id='Client_Connection'>
<title>Client Connection</title>
<para>
@@ -149,7 +164,7 @@ authorization structure.
</para>
</chapter>
-<chapter id="client_disconnection">
+<chapter id='Client_disconnection'>
<title>Client disconnection</title>
<para>
@@ -176,7 +191,7 @@ yet.
</para>
</chapter>
-<chapter id="resource_id_security">
+<chapter id='Resource_ID_Security'>
<title>Resource ID Security</title>
<para>
@@ -226,7 +241,7 @@ the server uses essentially the same code as before for resource lookups.
</para>
</chapter>
-<chapter id="extension_security">
+<chapter id='Extension_Security'>
<title>Extension Security</title>
<para>
@@ -235,7 +250,7 @@ extension is considered secure. It is initialized to FALSE by AddExtension.
The following new dix function can be used to set the secure field:
</para>
-<funcsynopsis>
+<funcsynopsis id='DeclareExtensionSecurity'>
<funcprototype>
<funcdef>void <function>DeclareExtensionSecurity</function></funcdef>
<paramdef>char <parameter> *extname</parameter></paramdef>
@@ -248,7 +263,7 @@ The name of the extension and the desired value of the secure field are
passed. If an extension is secure, a call to this function with
secure = TRUE will typically appear right after the call to
<function>AddExtension</function>.
-<function>DeclareExtensionSecurity</function>
+<xref linkend='DeclareExtensionSecurity' xrefstyle='select: title'/>
should be called during server reset. It should not
be called after the first client has connected. Passing the name of an
extension that has not been initialized has no effect (the secure value will
@@ -270,15 +285,15 @@ opcode, one of two new Proc vectors are used by untusted clients,
as <function>ProcVector</function> and
<function>SwappedProcVector</function> respectively for the first 128
entries. Entries 128 through 255 are initialized to ProcBadRequest. If
-<function>DeclareExtensionSecurity</function> is called with secure =
+<xref linkend='DeclareExtensionSecurity' xrefstyle='select: title'/> is called with secure =
TRUE, that extension's dispatch function is plugged into the appropriate entry
so that the extension can be used. If
-<function>DeclareExtensionSecurity</function> is called with secure =
+<xref linkend='DeclareExtensionSecurity' xrefstyle='select: title'/> is called with secure =
FALSE, the appropriate entry is reset to ProcBadRequest.
</para>
<para>
-Now we can explain why <function>DeclareExtensionSecurity</function>
+Now we can explain why <xref linkend='DeclareExtensionSecurity' xrefstyle='select: title'/>
should not be called after the first client connects. In some cases,
the Record extension gives clients a private copy of the proc vector,
which it then changes to intercept certain requests. Changing entries in
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-22 23:13:42 +0000