diff options
Diffstat (limited to 'doc')
25 files changed, 16029 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 00000000..1c16425a --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,4 @@ +SUBDIRS = man creating_themes + +EXTRA_DIST=theme-format.txt marco-theme.dtd dialogs.txt code-overview.txt \ + how-to-get-focus-right.txt diff --git a/doc/Makefile.in b/doc/Makefile.in new file mode 100644 index 00000000..906b9bbd --- /dev/null +++ b/doc/Makefile.in @@ -0,0 +1,609 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = doc +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +SOURCES = +DIST_SOURCES = +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +AM_RECURSIVE_TARGETS = $(RECURSIVE_TARGETS:-recursive=) \ + $(RECURSIVE_CLEAN_TARGETS:-recursive=) tags TAGS ctags CTAGS \ + distdir +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +am__relativize = \ + dir0=`pwd`; \ + sed_first='s,^\([^/]*\)/.*$$,\1,'; \ + sed_rest='s,^[^/]*/*,,'; \ + sed_last='s,^.*/\([^/]*\)$$,\1,'; \ + sed_butlast='s,/*[^/]*$$,,'; \ + while test -n "$$dir1"; do \ + first=`echo "$$dir1" | sed -e "$$sed_first"`; \ + if test "$$first" != "."; then \ + if test "$$first" = ".."; then \ + dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \ + dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \ + else \ + first2=`echo "$$dir2" | sed -e "$$sed_first"`; \ + if test "$$first2" = "$$first"; then \ + dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \ + else \ + dir2="../$$dir2"; \ + fi; \ + dir0="$$dir0"/"$$first"; \ + fi; \ + fi; \ + dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \ + done; \ + reldir="$$dir2" +ACLOCAL = @ACLOCAL@ +ACLOCAL_AMFLAGS = @ACLOCAL_AMFLAGS@ +ALL_CFLAGS = @ALL_CFLAGS@ +ALL_LIBS = @ALL_LIBS@ +ALL_LINGUAS = @ALL_LINGUAS@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOGS = @CATALOGS@ +CATOBJEXT = @CATOBJEXT@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DATADIRNAME = @DATADIRNAME@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DISTCHECK_CONFIGURE_FLAGS = @DISTCHECK_CONFIGURE_FLAGS@ +DLLTOOL = @DLLTOOL@ +DOC_USER_FORMATS = @DOC_USER_FORMATS@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GMOFILES = @GMOFILES@ +GMSGFMT = @GMSGFMT@ +GREP = @GREP@ +GTK_API_VERSION = @GTK_API_VERSION@ +HELP_DIR = @HELP_DIR@ +HOST_ALIAS = @HOST_ALIAS@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INSTOBJEXT = @INSTOBJEXT@ +INTLLIBS = @INTLLIBS@ +INTLTOOL_EXTRACT = @INTLTOOL_EXTRACT@ +INTLTOOL_MERGE = @INTLTOOL_MERGE@ +INTLTOOL_PERL = @INTLTOOL_PERL@ +INTLTOOL_UPDATE = @INTLTOOL_UPDATE@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MARCO_CFLAGS = @MARCO_CFLAGS@ +MARCO_LIBS = @MARCO_LIBS@ +MARCO_MESSAGE_CFLAGS = @MARCO_MESSAGE_CFLAGS@ +MARCO_MESSAGE_LIBS = @MARCO_MESSAGE_LIBS@ +MARCO_WINDOW_DEMO_CFLAGS = @MARCO_WINDOW_DEMO_CFLAGS@ +MARCO_WINDOW_DEMO_LIBS = @MARCO_WINDOW_DEMO_LIBS@ +MATECONFTOOL = @MATECONFTOOL@ +MATECONF_SCHEMA_CONFIG_SOURCE = @MATECONF_SCHEMA_CONFIG_SOURCE@ +MATECONF_SCHEMA_FILE_DIR = @MATECONF_SCHEMA_FILE_DIR@ +MATEDIALOG = @MATEDIALOG@ +MATE_KEYBINDINGS_KEYSDIR = @MATE_KEYBINDINGS_KEYSDIR@ +MKDIR_P = @MKDIR_P@ +MKINSTALLDIRS = @MKINSTALLDIRS@ +MSGFMT = @MSGFMT@ +MSGFMT_OPTS = @MSGFMT_OPTS@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OMF_DIR = @OMF_DIR@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +POFILES = @POFILES@ +POSUB = @POSUB@ +PO_IN_DATADIR_FALSE = @PO_IN_DATADIR_FALSE@ +PO_IN_DATADIR_TRUE = @PO_IN_DATADIR_TRUE@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMKMF = @XMKMF@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +SUBDIRS = man creating_themes +EXTRA_DIST = theme-format.txt marco-theme.dtd dialogs.txt code-overview.txt \ + how-to-get-focus-right.txt + +all: all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @fail= failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +$(RECURSIVE_CLEAN_TARGETS): + @fail= failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || ($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + set x; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + shift; \ + if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + if test $$# -gt 0; then \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + "$$@" $$unique; \ + else \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$unique; \ + fi; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && $(am__cd) $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) "$$here" + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done + @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + fi; \ + done + @list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + dir1=$$subdir; dir2="$(distdir)/$$subdir"; \ + $(am__relativize); \ + new_distdir=$$reldir; \ + dir1=$$subdir; dir2="$(top_distdir)"; \ + $(am__relativize); \ + new_top_distdir=$$reldir; \ + echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \ + echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \ + ($(am__cd) $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$new_top_distdir" \ + distdir="$$new_distdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + am__skip_mode_fix=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +uninstall: uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-recursive + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +html-am: + +info: info-recursive + +info-am: + +install-data-am: + +install-dvi: install-dvi-recursive + +install-dvi-am: + +install-exec-am: + +install-html: install-html-recursive + +install-html-am: + +install-info: install-info-recursive + +install-info-am: + +install-man: + +install-pdf: install-pdf-recursive + +install-pdf-am: + +install-ps: install-ps-recursive + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) ctags-recursive \ + install-am install-strip tags-recursive + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am clean clean-generic clean-libtool \ + ctags ctags-recursive distclean distclean-generic \ + distclean-libtool distclean-tags distdir dvi dvi-am html \ + html-am info info-am install install-am install-data \ + install-data-am install-dvi install-dvi-am install-exec \ + install-exec-am install-html install-html-am install-info \ + install-info-am install-man install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs installdirs-am maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic \ + mostlyclean-libtool pdf pdf-am ps ps-am tags tags-recursive \ + uninstall uninstall-am + + +# 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/code-overview.txt b/doc/code-overview.txt new file mode 100644 index 00000000..566abd04 --- /dev/null +++ b/doc/code-overview.txt @@ -0,0 +1,185 @@ +This is not meant to be comprehensive by any means. Rather it is +meant as just a brief overview of some of the bigger structures and +files, with guides for a variety of task categories providing places +to start looking in the code and things to look for. + +Overview + Jobs of various files + Major data structures and their relationships + Getting started -- where to look + + +Jobs of various files + src/window.c is where all the guts of the window manager live. This is + basically the only remotely scary file. + + src/frames.c is the GtkWidget that handles drawing window frames. + + src/core.h defines the interface used by the GTK portion of the window + manager to talk to the other portions. There's some cruft in here that's + unused, since nearly all window operations have moved out of this file so + frameless apps can have window operations. + + src/ui.h defines the interface the plain Xlib portion of the window + manager uses to talk to the GTK portion. + + src/theme.c and src/theme-parser.c have the theme system; this is + well-modularized from the rest of the code, since the theme viewer app + links to these files in addition to the WM itself. + +Major data structures and their relationships + Major structs have a "Meta" prefix, thus MetaDisplay, MetaScreen, + MetaWindow, etc. This serves as a way of namespacing in C. It also has + the side effect of avoiding conflicts with common names that X already + uses such as Display, Screen, Window, etc. Note that when I refer to a + display below, I'm meaning a MetaDisplay and not a Display. + + Don't confuse displays and screens. While Marco can run with multiple + displays, it is kind of useless since you might as well just run two + copies of Marco. However, having multiple screens per display is + useful and increasingly common (known as "multiscreen" and "xinerama" + setups, where users make use of more than one monitor). You should + basically think of a display as a combination of one or more monitors + with a single keyboard (...and usually only one mouse). + + There is also a significant difference between multiscreen and xinerama + as well. Basically, each MetaScreen is a root window (root node in the + tree of windows). With Xinerama, a single root window appears to span + multiple monitors, whereas with multiscreen a root window is confined to + a single monitor. To re-emphasize the distinction between a display and + a screen, the pointer and keyboard are shared between all root windows + for a given display. + + The display keeps track of a lot of various global quantities, but in + particular has a compositor and a list (GList) of screens. + + A compositor is an opaque structure (only defined in compositor.c), + meaning that you'll only reference the API for it. It handles (or will + handle) cool stuff with the new X extensions, such as smooth resizing and + alpha transparency. + + A screen keeps track of a number of quantities as well, in particular a + stack and a list of workspaces. + + A stack is basically a list of windows, and the depth order they have + relative to each other (which thus determines which windows are on top + and which are obscured). + + A workspace mostly contains a list of windows for the workspace, but also + has a few other quantities as well (a list of struts which are areas + where windows should not be placed and an mru_list or "most recently used + window list"). + + A window has a huge list of quantities for keeping track of things about + a window on the screen. (We want to avoid making this list larger + because the memory for all these quantities is per window.) One item in + particular that a window has, though, is a frame. + + A frame is the decorations that surround the window (i.e. the titlebar and + the minimize and close buttons and the part that you can use to resize), + and contains a handful of variables related to that, but no other major + structures. + +Getting started -- where to look + Getting started on developing free software projects can often be like + being dropped off in a town that is unknown to you and being told to make + a map, when various road and building signs are missing or fading. To + try to alleviate that initial difficulty in orientation, below I list a + variety of general task categories with file, function, variable, and x + property names that may be useful to fixing bugs or writing features that + fall within that category. + + First, though, it's useful to note that most event and message passing + goes through display.c:event_callback(), so that's often a good place to + start reading for general familiarity with the code (actually, I'd + suggest skipping down to the first switch statement within that + function). Of course, not all events go through that function, as there + are a few other places that handle events too such as frames.c. + + Anyway, without further ado, here are the categories and (hopefully) + useful things to look at for each: + + Focus issues (i.e. issues with which window is active): + doc/how-to-get-focus-right.txt + meta_workspace_focus_default_window + _NET_ACTIVE_WINDOW + _NET_WM_USER_TIME + meta_window_focus + meta_display_(set_input|focus_the_no)_focus_window + XSetInputFocus (only for purposes of understanding how X focus/input works) + CurrentTime (mostly, you should just think "Bad; don't use it") + + Compositor stuff (X extension for eye candy like transparency): + compositor.c + The luminocity module in CVS + + Window depth (i.e. stacking or lowering/raising) issues: + stack.c + _NET_CLIENT_LIST_STACKING + transient_for + WM_TRANSIENT_FOR + meta_window_(raise|lower) + _NET_WM_WINDOW_TYPE + _NET_WM_MOUSE_ACTION/_NET_WM_TAKE_ACTIVITY? (aren't yet in EWMH) + + Window placement issues: + place.c + constraints.c + _NET_WM_STRUT + WM_SIZE_HINTS + + Moving and resizing issues: + constraints.c + update_move + update_resize + meta_window_handle_mouse_grab_op_event + _NET_MOVERESIZE_WINDOW + _NET_WM_STRUT + + Drag and drop issues: + the XDND protocol (see http://www.newplanetsoftware.com/xdnd/ and + http://freedesktop.org/Standards/XDND) + _NET_WM_MOUSE_ACTION/_NET_WM_TAKE_ACTIVITY (aren't yet in EWMH) + A general pointer: what causes the difficulty here is that when the + application receives a mouse click to start a drag, it does a grab + so that the window manager doesn't get any further events; thus + correcting things require standards so that applications and window + managers can collaborate correctly + + Theme issues: ??? + doc/theme-format.txt + theme.c + theme-parser.c + (ui.c, core.c, frames.c, frame.c? I dunno...) + + Session management issues: ??? + session.c + http://www.x.org/X11R6.8.1/doc/SM/xsmp.pdf ? + http://www.x.org/X11R6.8.1/doc/SM/SMlib.pdf ? + meta_window_apply_session_info + + Tasklist and Workspace switcher issues: + window-props.c + various functions in screen.c (especially ones using XChangeProperty) + xprops.c + The libwnck module in cvs + meta_window_client_message + Lots of the EWMH + + Window and workspace selection/changing issues: + tabpopup.c + keybindings.c, functions: *_workspace*, *_tab_* + meta_screen_ensure_*_popup + display.c, functions: *_tab* + + Key and mouse binding actions: + keybindings.c + meta_frames_button_(press|release)_event + display.c: event_callback, but only the (Key|Button)_(Press|Release) cases + + Xinerama and multiscreen: ??? + In general, just search for Xinerama, but in particular see + screen.c + window.c + place.c + constraints.c diff --git a/doc/creating_themes/C/calstblx.dtd b/doc/creating_themes/C/calstblx.dtd new file mode 100644 index 00000000..fac58d77 --- /dev/null +++ b/doc/creating_themes/C/calstblx.dtd @@ -0,0 +1,215 @@ +<!-- ...................................................................... --> +<!-- DocBook CALS Table Model V4.5 ........................................ --> +<!-- File calstblx.mod .................................................... --> + +<!-- Copyright 1992-2002 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + This DTD is based on the CALS Table Model + PUBLIC "-//USA-DOD//DTD Table Model 951010//EN" + + $Id: calstblx.dtd 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the definitions for the CALS Table Model + converted to XML. It has been modified slightly for use in the + combined HTML/CALS models supported by DocBook V4.5. +--> + +<!-- These definitions are not directly related to the table model, but are + used in the default CALS table model and are usually defined elsewhere + (and prior to the inclusion of this table module) in a CALS DTD. --> + +<!ENTITY % bodyatt ""> +<!ENTITY % secur ""> + +<!-- no if zero(s), + yes if any other digits value --> + +<!ENTITY % yesorno 'CDATA'> +<!ENTITY % titles 'title?'> + +<!-- default for use in entry content --> + +<!ENTITY % paracon '#PCDATA'> + +<!-- +The parameter entities as defined below provide the CALS table model +as published (as part of the Example DTD) in MIL-HDBK-28001. + +These following declarations provide the CALS-compliant default definitions +for these entities. However, these entities can and should be redefined +(by giving the appropriate parameter entity declaration(s) prior to the +reference to this Table Model declaration set entity) to fit the needs +of the current application. +--> + +<!ENTITY % tbl.table.name "(table|chart)"> +<!ENTITY % tbl.table-titles.mdl "%titles;,"> +<!ENTITY % tbl.table-main.mdl "(tgroup+|graphic+)"> +<!ENTITY % tbl.table.mdl "%tbl.table-titles.mdl; %tbl.table-main.mdl;"> +<!ENTITY % tbl.table.att ' + tabstyle CDATA #IMPLIED + tocentry %yesorno; #IMPLIED + shortentry %yesorno; #IMPLIED + orient (port|land) #IMPLIED + pgwide %yesorno; #IMPLIED '> +<!ENTITY % tbl.tgroup.mdl "colspec*,spanspec*,thead?,tfoot?,tbody"> +<!ENTITY % tbl.tgroup.att ' + tgroupstyle CDATA #IMPLIED '> +<!ENTITY % tbl.hdft.mdl "colspec*,row+"> +<!ENTITY % tbl.row.mdl "(entry|entrytbl)+"> +<!ENTITY % tbl.entrytbl.mdl "colspec*,spanspec*,thead?,tbody"> +<!ENTITY % tbl.entry.mdl "(para|warning|caution|note|legend|%paracon;)*"> + +<!ENTITY % tbl.frame.attval "top|bottom|topbot|all|sides|none"> +<!ENTITY % tbl.tbody.mdl "row+"> + +<!-- ===== Element and attribute declarations follow. ===== --> + +<!--doc:A formal table in a document.--> +<!ELEMENT table %ho; (%tbl.table.mdl;)> + +<!ATTLIST table + frame (%tbl.frame.attval;) #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + %tbl.table.att; + %bodyatt; + %secur; +> + +<!--doc:A wrapper for the main content of a table, or part of a table.--> +<!ELEMENT tgroup %ho; (%tbl.tgroup.mdl;) > + +<!ATTLIST tgroup + cols CDATA #REQUIRED + %tbl.tgroup.att; + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED + %secur; +> + +<!--doc:Specifications for a column in a table.--> +<!ELEMENT colspec %ho; EMPTY > + +<!ATTLIST colspec + colnum CDATA #IMPLIED + colname CDATA #IMPLIED + colwidth CDATA #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED +> + +<!--doc:Formatting information for a spanned column in a table.--> +<!ELEMENT spanspec %ho; EMPTY > + +<!ATTLIST spanspec + namest CDATA #REQUIRED + nameend CDATA #REQUIRED + spanname CDATA #REQUIRED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED +> + +<!--doc:A table header consisting of one or more rows.--> +<!ELEMENT thead %ho; (%tbl.hdft.mdl;)> +<!ATTLIST thead + valign (top|middle|bottom) #IMPLIED + %secur; +> + +<!--doc:A table footer consisting of one or more rows.--> +<!ELEMENT tfoot %ho; (%tbl.hdft.mdl;)> +<!ATTLIST tfoot + valign (top|middle|bottom) #IMPLIED + %secur; +> + +<!--doc:A wrapper for the rows of a table or informal table.--> +<!ELEMENT tbody %ho; (%tbl.tbody.mdl;)> + +<!ATTLIST tbody + valign (top|middle|bottom) #IMPLIED + %secur; +> + +<!--doc:A row in a table.--> +<!ELEMENT row %ho; (%tbl.row.mdl;)> + +<!ATTLIST row + rowsep %yesorno; #IMPLIED + valign (top|middle|bottom) #IMPLIED + %secur; +> + +<!--doc:A subtable appearing in place of an Entry in a table.--> +<!ELEMENT entrytbl %ho; (%tbl.entrytbl.mdl;)> + +<!ATTLIST entrytbl + cols CDATA #REQUIRED + %tbl.tgroup.att; + colname CDATA #IMPLIED + spanname CDATA #IMPLIED + namest CDATA #IMPLIED + nameend CDATA #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED + %secur; +> + +<!--doc:A cell in a table.--> +<!ELEMENT entry %ho; (%tbl.entry.mdl;)*> + +<!ATTLIST entry + colname CDATA #IMPLIED + namest CDATA #IMPLIED + nameend CDATA #IMPLIED + spanname CDATA #IMPLIED + morerows CDATA #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED + rotate %yesorno; #IMPLIED + valign (top|middle|bottom) #IMPLIED + %secur; +> + +<!-- End of DocBook CALS Table Model V4.5 ................................. --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/creating-marco-themes.xml b/doc/creating_themes/C/creating-marco-themes.xml new file mode 100644 index 00000000..a2b6da7c --- /dev/null +++ b/doc/creating_themes/C/creating-marco-themes.xml @@ -0,0 +1,286 @@ +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "docbookx.dtd" [ +]> + +<book id="index"> + + <bookinfo> + + <title>Understanding Marco Themes</title> + + <authorgroup> + <author> + <firstname>Thomas</firstname> + <surname>Thurman</surname> + </author> + </authorgroup> + + <abstract> + + <para> + We very much appreciate any reports of inaccuracies or other errors in + this document. Contributions are also most welcome. Post your + suggestions, critiques or addenda to the <ulink + url="mailto:[email protected]">team</ulink>.</para> + + </abstract> + + <copyright> + <year>2008</year> + <holder>Thomas Thurman</holder> + </copyright> + + <legalnotice> + <para> + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + </para> + </legalnotice> + + </bookinfo> + +<chapter id="sec-introduction"> +<title>Introduction</title> + +<para>This is an article about how to theme Marco. It is a work in progress, and I have had to dig deeply to find some answers; I may well have made mistakes and I welcome corrections and suggestions.</para> +<para>MATE lets you theme a bunch of different things, but we're only talking about <literal>window border</literal> themes here, which some people call Marco themes; <ulink url="http://en.wikipedia.org/wiki/Marco#Themes">Wikipedia begins a sentence</ulink> with "Despite the incomplete state of Marco theme development documentation", and though there <emphasis>is</emphasis> <ulink url="http://svn.mate.org/viewvc/marco/trunk/doc/theme-format.txt?view=markup">documentation in the source</ulink>, apparently not many people find it, and it's written more for programmers than theme designers. Glynn Foster also wrote <ulink url="http://developer.mate.org/doc/tutorials/marco/marco-themes.html">a very good introduction to Marco themes</ulink> (<ulink url="http://home.arcor.de/rybaczyk/documents/tutorials/marco/marco-themes.de.html">[de]</ulink>) six years ago, but things have changed a little since then. <ulink url="http://lists.freedesktop.org/archives/compiz/2006-September/000445.html">Marco themes can also be used by Compiz</ulink>, and perhaps by other window managers for all I know.</para> + +<para>So, a Marco theme is a set of instructions about how to "decorate" (draw the borders around) a window. Presumably you don't want to style all windows identically, so the format lets you specify details for different kinds of window:</para> + +<para> +<variablelist> + <varlistentry> + <term>state:</term><listitem><para>Every window must be in exactly one of these states: <literal>normal</literal>, <literal>dialog</literal>, <literal>modal dialog</literal> (i.e. a dialogue which means you can't interact with the rest of the program while it's up), <literal>menu</literal> (torn off from the main application, not that people do that much these days), <literal>utility</literal> (that is, palettes and toolboxes and things), and <literal>border</literal>. X also allows a window to explicitly ask to be undecorated, but of course we don't provide for those in a list of decoration instructions.</para></listitem> + </varlistentry> + <varlistentry> + <term>focused</term><listitem><para>Every window is either the active window (which X people call "focused"), or it isn't.</para></listitem> + </varlistentry> + <varlistentry> + <term>maximized</term><listitem><para>Every window is either (fully) maximised (horizontal and vertical only don't count), or it isn't.</para></listitem> + </varlistentry> + <varlistentry> + <term>shaded</term><listitem><para>Every window is either rolled up to show just its titlebar (which techies call "shaded" for some reason I can't fathom), or it isn't.</para></listitem> + </varlistentry> +</variablelist> +</para> + +<para> +<itemizedlist> +<listitem><para><emphasis>If a window is not fully maximised and not shaded,</emphasis> it either allows horizontal resizing, or it doesn't.</para></listitem> +<listitem><para><emphasis>If a window is not fully maximised and not shaded,</emphasis> it either allows vertical resizing, or it doesn't.</para></listitem> +</itemizedlist> +</para> + +</chapter> + +<chapter> +<title>What's in the file</title> + +<para>The files must be called either</para> + +<para> +<itemizedlist> +<listitem><para>~/.themes/<varname>N</varname>/marco-1/marco-theme-<varname>V</varname>.xml +for a theme used only by you, or</para></listitem> +<listitem><para>/usr/share/themes/<varname>N</varname>/marco-1/marco-theme-<varname>V</varname>.xml +for a theme installed for all users.</para></listitem> +</itemizedlist> +</para> + +<para>where <varname>N</varname> is the name of the theme and <varname>V</varname> is the version of the format. Version 2, <ulink url="http://svn.mate.org/viewvc/marco?view=revision&revision=2973">introduced in October 2006</ulink>, adds a few extra features, but it's rarely used. Version 1 is the original format. The formats are fixed once they're stable for both backwards and forwards compatibility; <ulink url="http://bugzilla.mate.org/show_bug.cgi?id=482165">new features</ulink> can't be added without introducing a new version number, which is why improvements come out rarely and in large clumps. <literal>marco-1</literal> in the names is a fossil and doesn't mean version 1 of anything.</para> + +<para>The marco-theme-V.xml files are <ulink url="http://blogs.mate.org/tthurman/2008/02/14/gmarkup/">GMarkup files</ulink>, which are very similar to XML. For now, you actually have to write these in a text editor or something; you can either start with a blank page, or modify a theme someone else has made. (I am thinking of writing a general theme editor program, but that'll have to wait until I've reduced Marco's open bug queue a little.) If you want to see a fully-fledged one, you can look at <ulink url="http://svn.mate.org/viewvc/marco/trunk/src/themes/Atlanta/marco-theme-1.xml?view=markup">the current version of "Atlanta"</ulink>, one of the simplest themes, but even that is quite complicated-looking at first.</para> +<para>So, let's talk about what actually goes inside the files. As in any XML file, <!-<!-- x -->- … <!-- x -->> are comments. At its most basic, it would go:</para> + +<para> +<programlisting> +<marco_theme> +<!-<!-- x -->- Helper stuff: -<!-- x -->-> +<info …> <!-<!-- x -->- to be explained -<!-- x -->-> +<constant …> <!-<!-- x -->- maybe; to be explained -<!-- x -->-> + +<draw_ops …> <!-<!-- x -->- maybe; to be explained -<!-- x -->-> + +<!-<!-- x -->- Things we build the top level onto: -<!-- x -->-> +<frame_geometry …> <!-<!-- x -->- to be explained -<!-- x -->-> + +<frame_style …> <!-<!-- x -->- to be explained -<!-- x -->-> +<frame_style_set …> <!-<!-- x -->- to be explained -<!-- x -->-> + +<!-<!-- x -->- And the top level: -<!-- x -->-> + +<window type="normal" style_set="…" /> +<window type="dialog" style_set="…" /> +<window type="modal_dialog" style_set="…" /> + +<window type="menu" style_set="…" /> +<window type="utility" style_set="…" /> +<window type="border" style_set="…" /> + +</marco_theme> +</programlisting> +</para> + +</chapter> + +<chapter> +<title>Matching windows</title> + +<para> +<variablelist> + <varlistentry> + <term>window</term><listitem><para>You see that at the top level we have a list of <window> tags, one for each window state we discussed above. The style_set argument of each of these gives the name of a frame_style_set.</para></listitem> + </varlistentry> + <varlistentry> + <term>frame_style_set:</term><listitem><para>tells Marco how to draw windows according to whether they're focused or not, maximised or not, shaded or not, and allowing resizing vertically, horizontally, both, or neither. It looks like this:</para></listitem> + </varlistentry> +</variablelist> +</para> + +<para> +<programlisting> +<frame_style_set> +<frame focus="F" state="S" resize="R" style="N"/> +<frame… /> + +… +</frame_style_set> +</programlisting> +</para> + +<para>where:</para> + +<para> +<variablelist> + <varlistentry> + <term>F</term><listitem><para>is yes for focused, no for unfocused.</para></listitem> + </varlistentry> + <varlistentry> + <term>S</term><listitem><para>combines the shaded and maximized flags: normal, maximized, shaded, or maximized_and_shaded.</para></listitem> + </varlistentry> + <varlistentry> + <term>R</term><listitem><para>represents resize permissions that the window gives us: none, vertical, horizontal, or both. Frame settings for maximised windows, which can't be resized, don't have this attribute.</para></listitem> + </varlistentry> +</variablelist> +</para> + +<para> +<varname>N</varname> is the name of a <literal>frame_style</literal> to apply to a window which has these attributes.</para> + +<para>A <literal>frame_style_set</literal> tag may also have a "parent" tag, which should be the name of another <literal>frame_style_set</literal>. This means that if Marco wants to know about a kind of window which that <literal>frame_style_set</literal> doesn't describe, it should look in the parent. Most of the more complicated tags in Marco theme files also have a "parent" attribute which work the same way. This is particularly useful because, taken together, all the <literal>frame_style_set</literal>s in a theme file must be capable of matching every possible kind of window; if a window turns up that they can't match, there will be an error at runtime.</para> + +<para>Let's recap what we've seen so far. The combination of a <literal>window</literal>, which matches a window's state (normal, dialog, and so forth), with an entry in the corresponding <literal>frame_style_set</literal>, which matches its focus, shadedness, maximisedness, and resize permissions where relevant, will allow you to make a list of rules to match any window against. The next piece of this puzzle lets you specify what Marco should do with such windows once it's matched them.</para> + +</chapter> + +<chapter> +<title>Actually drawing stuff</title> + +<para><literal>frame_style:</literal> This is probably the most complicated part of the whole system. A <literal>frame_style</literal> a series of <emphasis><literal>piece</literal></emphasis>s and <emphasis><literal>button</literal></emphasis>s. It looks like this:</para> + +<para> +<programlisting> +<frame_style name="…" geometry="G"> +<piece position="P"> +<draw_ops> +</draw_ops> +</piece> +… +<button function="F" state="S" draw_ops="D"/> + +<draw_ops> +</draw_ops> +</button> +… +</frame_style> +</programlisting> +</para> + +<para>The <literal>pieces</literal> are pieces of the window frame. When Marco draws a window frame, it renders its various pieces always in the same order. The bolded parts are all the possible values of P:</para> + +<para> +<itemizedlist> +<listitem><para>the <literal>entire_background</literal>, covering the whole frame</para></listitem> + +<listitem><para>the <literal>titlebar</literal>, covering the entire background of the titlebar</para></listitem> +<listitem><para>the <literal>titlebar_middle</literal>, the part of the titlebar that doesn't touch its edges</para></listitem> +<listitem><para>the <literal>left_titlebar_edge</literal>, <literal>right_titlebar_edge</literal>, <literal>top_titlebar_edge</literal>, and <literal>bottom_titlebar_edge</literal></para></listitem> + +<listitem><para>the <literal>title</literal>, just exactly that area which is covered by the text on the titlebar</para></listitem> +<listitem><para>the <literal>left_edge</literal>, <literal>right_edge</literal>, and <literal>bottom_edge</literal> of the frame (yes, there is no top_edge: it's identical to top_titlebar_edge, isn't it?)</para></listitem> +<listitem><para>the <literal>overlay</literal>, which covers everything– the same as entire_background, but done last instead of first.</para></listitem> +</itemizedlist> +</para> + +<para><emphasis>What</emphasis> Marco draws in these pieces is decided by the theme. If a <literal>frame_style</literal> or its parents don't specify a particular piece, nothing will be drawn for that piece. You have two ways to specify what to draw: one is that the <literal>piece</literal> tag can have a <literal>draw_ops</literal> tag inside it which lists a sequence of drawing operations in Marco's custom format. <ulink url="http://bugzilla.mate.org/show_bug.cgi?id=107012">You might ask why we don't use SVG</ulink>; one answer is that SVG support wasn't very strong when this format was designed, and another answer is that these days you can use SVG all you like; just include it as an image and Marco will know what to do.</para> + +<para>An alternative to including a draw_ops tag inside a piece tag is to add a draw_ops attribute to the piece tag. Then you can add a draw_ops tag at top level (inside the marco_theme tag) with a name attribute, and Marco will use that. This is useful if you use similar draw_ops over and over.</para> +<para>I'm not going to document draw_ops at present, because this is already very long. I will write it up later and link it from here.</para> +<para>The <literal>button</literal> tag tells Marco how, but not where, to draw buttons. Buttons are drawn after all the pieces are finished, and the way to draw them is also given using draw_ops. You ought to provide buttons for all the possible kinds of button; if you don't give one it won't be drawn, which is unfortunate for the user who wants to use it:</para> + +<para> +<itemizedlist> +<listitem><para><literal>left_left_background</literal>, <literal>left_middle_background</literal>, and <literal>left_right_background</literal> don't represent buttons as such, but the background behind them, assuming there can be at most three buttons on the left. These days there can be more, so the extra ones also use left_middle_background.</para></listitem> + +<listitem><para><literal>right_left_background</literal>, <literal>right_middle_background</literal>, and <literal>right_right_background</literal> similarly.</para></listitem> +<listitem><para><literal>close</literal>, <literal>minimize</literal>, <literal>maximize</literal> are the obvious original three buttons.</para></listitem> +<listitem><para><literal>menu</literal> is the menu button you can click to get a list of actions you can perform on the window.</para></listitem> + +<listitem><para><literal>shade</literal>, <literal>above</literal>, <literal>stick</literal> are similar to the original buttons but only allowed in version 2</para></listitem> +<listitem><para><literal>unshade</literal>, <literal>unabove</literal>, <literal>unstick</literal> are the toggled versions of these buttons. Again, version 2 only.</para></listitem> + +</itemizedlist> +</para> + +<para>The reason there are toggled versions of shade, above, and stick, and not maximize, is that by the time you get this far you've probably already decided whether you're drawing a maximised window. So if you <emphasis>are</emphasis> drawing a maximised window, you can make the button called "maximize" look how you want the restore button to be; otherwise, make it look like you want the maximise button to be.</para> +<para>For each button tag you should also set a "state" attribute; this time the state is either <literal>normal</literal> (the way you see it most of the time), <literal>pressed</literal>, or <literal>prelight</literal> (this makes the buttons subtly light up when you hover over them). You only really need "normal", but the others are good to have too.</para> + +<para>The "geometry" attribute of a <literal>frame_style</literal> tag is the name of a…</para> + +</chapter> + +<chapter> +<title>Geometry</title> + +<para>The <literal>geometry</literal> tag defines the sizes of things around the window. It is important, but not easy to explain, and again this file has gone on too long. I'll write it up later.</para> + +</chapter> + +<chapter> +<title>Other things which lie around a file</title> + +<para>The most important other thing in a theme file is the metadata held in the <literal>info</literal> tag. This contains a set of tags each of which contains some text explaining something about the theme itself, in a sort of <ulink url="http://en.wikipedia.org/wiki/Dublin_Core">Dublin Core</ulink> sort of way. (Next time around, we should probably use the actual Dublin Core.) The tags are <literal>name</literal>, <literal>author</literal>, <literal>copyright</literal>, <literal>date</literal>, and <literal>description</literal>.</para> + +<para>Version 1 of the format had a <literal>menu_icon</literal> tag at top level, which let themes specify the icons beside options in the menu you get from the menu icon. This has become redundant; the icons are taken from the icon theme! The tag can still be used in all formats, but does nothing and is deprecated.</para> +<para>Version 2 of the format has a <literal>fallback</literal> tag at top level, which let the theme specify what icon a window should be considered to have if it doesn't provide an icon of its own. This should also be taken from the icon theme, <ulink url="http://bugzilla.mate.org/show_bug.cgi?id=524343">if anyone fancies fixing it</ulink>, and the tag should also then be deprecated. It shouldn't be hard.</para> + +</chapter> + +<chapter> +<title>When you're working on a theme</title> + +<para>When you're editing a theme, you can view it without using it on the whole desktop using +<command>marco-theme-viewer YourThemeName</command></para> +<para>and view it on the whole desktop using +<command>mateconftool -<!-- x -->-type=string -<!-- x -->-set /apps/marco/general/theme YourThemeName</command></para> + +<para>Whenever you change the selected theme in MateConf, Marco will load the newly-chosen theme. This is how control-center does it. But when you change a theme, as you're working on it, you might want to ask Marco to reload the theme which is currently used on the whole desktop to reflect your changes. You can do this using the little-known <command>marco-message</command> program, with the command <literal>marco-message reload-theme</literal>. This works by sending the ClientMessage <literal>_MARCO_RELOAD_THEME_MESSAGE</literal> to the root window, in case you're interested.</para> + +<para>Once you're done with your theme, consider submitting it to <ulink url="http://art.mate.org/themes/marco/">the art.mate.org site</ulink>, or <ulink url="http://www.mate-look.org/index.php?xcontentmode=101">the mate-look site</ulink>.</para> + +</chapter> + +<chapter> +<title>The future</title> + +<para>Please feel free to link to this so people don't have to keep asking the basic questions and can start asking the deeper ones. One of the important deeper ones is: where should we go in the future? Since this format is becoming something of a de facto standard between window managers, should we set up some kind of freedesktop.org standards discussion? Would it be useful to spin off Marco's theme parsing code into a separate, LGPL-licensed library so that other applications could use it more easily?</para> +<para>What would a version 3 of this format look like? Could we simplify the window / frame_style_set system? (I can imagine abolishing both, and being able to write <literal><frame_style for="normal+unfocused+maximized">…</literal> and having Marco assume it applied to all resize permissions and shadednesses.) Maybe we should try to do everything with SVG we can? Getting more wild and handwavey, is it worth keeping XML-like? Maybe if other window managers were dealing with the files, .ini-style files would be more universally useful? Or perhaps not. And then of course we need a decent graphical editor for it. I have a few ideas, but if anyone fancies jumping in...</para> +</chapter> + +</book> + + diff --git a/doc/creating_themes/C/dbcentx.mod b/doc/creating_themes/C/dbcentx.mod new file mode 100644 index 00000000..60de99f8 --- /dev/null +++ b/doc/creating_themes/C/dbcentx.mod @@ -0,0 +1,384 @@ +<!-- ...................................................................... --> +<!-- DocBook character entities module V4.5 ............................... --> +<!-- File dbcentx.mod ..................................................... --> + +<!-- Copyright 1992-2004 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + $Id: dbcentx.mod 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the entity declarations for the standard ISO + entity sets used by DocBook. + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % dbcent PUBLIC + "-//OASIS//ENTITIES DocBook Character Entities V4.5//EN" + "dbcentx.mod"> + %dbcent; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!-- ...................................................................... --> + +<![%sgml.features;[ + +<!ENTITY % ISOamsa.module "INCLUDE"> +<![ %ISOamsa.module; [ +<!ENTITY % ISOamsa PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN"> +<!--end of ISOamsa.module-->]]> + +<!ENTITY % ISOamsb.module "INCLUDE"> +<![ %ISOamsb.module; [ +<!ENTITY % ISOamsb PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN"> +<!--end of ISOamsb.module-->]]> + +<!ENTITY % ISOamsc.module "INCLUDE"> +<![ %ISOamsc.module; [ +<!ENTITY % ISOamsc PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN"> +<!--end of ISOamsc.module-->]]> + +<!ENTITY % ISOamsn.module "INCLUDE"> +<![ %ISOamsn.module; [ +<!ENTITY % ISOamsn PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN"> +<!--end of ISOamsn.module-->]]> + +<!ENTITY % ISOamso.module "INCLUDE"> +<![ %ISOamso.module; [ +<!ENTITY % ISOamso PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN"> +<!--end of ISOamso.module-->]]> + +<!ENTITY % ISOamsr.module "INCLUDE"> +<![ %ISOamsr.module; [ +<!ENTITY % ISOamsr PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN"> +<!--end of ISOamsr.module-->]]> + +<!ENTITY % ISObox.module "INCLUDE"> +<![ %ISObox.module; [ +<!ENTITY % ISObox PUBLIC +"ISO 8879:1986//ENTITIES Box and Line Drawing//EN"> +<!--end of ISObox.module-->]]> + +<!ENTITY % ISOcyr1.module "INCLUDE"> +<![ %ISOcyr1.module; [ +<!ENTITY % ISOcyr1 PUBLIC +"ISO 8879:1986//ENTITIES Russian Cyrillic//EN"> +<!--end of ISOcyr1.module-->]]> + +<!ENTITY % ISOcyr2.module "INCLUDE"> +<![ %ISOcyr2.module; [ +<!ENTITY % ISOcyr2 PUBLIC +"ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN"> +<!--end of ISOcyr2.module-->]]> + +<!ENTITY % ISOdia.module "INCLUDE"> +<![ %ISOdia.module; [ +<!ENTITY % ISOdia PUBLIC +"ISO 8879:1986//ENTITIES Diacritical Marks//EN"> +<!--end of ISOdia.module-->]]> + +<!ENTITY % ISOgrk1.module "INCLUDE"> +<![ %ISOgrk1.module; [ +<!ENTITY % ISOgrk1 PUBLIC +"ISO 8879:1986//ENTITIES Greek Letters//EN"> +<!--end of ISOgrk1.module-->]]> + +<!ENTITY % ISOgrk2.module "INCLUDE"> +<![ %ISOgrk2.module; [ +<!ENTITY % ISOgrk2 PUBLIC +"ISO 8879:1986//ENTITIES Monotoniko Greek//EN"> +<!--end of ISOgrk2.module-->]]> + +<!ENTITY % ISOgrk3.module "INCLUDE"> +<![ %ISOgrk3.module; [ +<!ENTITY % ISOgrk3 PUBLIC +"ISO 8879:1986//ENTITIES Greek Symbols//EN"> +<!--end of ISOgrk3.module-->]]> + +<!ENTITY % ISOgrk4.module "INCLUDE"> +<![ %ISOgrk4.module; [ +<!ENTITY % ISOgrk4 PUBLIC +"ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN"> +<!--end of ISOgrk4.module-->]]> + +<!ENTITY % ISOlat1.module "INCLUDE"> +<![ %ISOlat1.module; [ +<!ENTITY % ISOlat1 PUBLIC +"ISO 8879:1986//ENTITIES Added Latin 1//EN"> +<!--end of ISOlat1.module-->]]> + +<!ENTITY % ISOlat2.module "INCLUDE"> +<![ %ISOlat2.module; [ +<!ENTITY % ISOlat2 PUBLIC +"ISO 8879:1986//ENTITIES Added Latin 2//EN"> +<!--end of ISOlat2.module-->]]> + +<!ENTITY % ISOnum.module "INCLUDE"> +<![ %ISOnum.module; [ +<!ENTITY % ISOnum PUBLIC +"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN"> +<!--end of ISOnum.module-->]]> + +<!ENTITY % ISOpub.module "INCLUDE"> +<![ %ISOpub.module; [ +<!ENTITY % ISOpub PUBLIC +"ISO 8879:1986//ENTITIES Publishing//EN"> +<!--end of ISOpub.module-->]]> + +<!ENTITY % ISOtech.module "INCLUDE"> +<![ %ISOtech.module; [ +<!ENTITY % ISOtech PUBLIC +"ISO 8879:1986//ENTITIES General Technical//EN"> +<!--end of ISOtech.module-->]]> + +<!--end of sgml.features-->]]> + +<![%xml.features;[ + +<!ENTITY % ISOamsa.module "INCLUDE"> +<![%ISOamsa.module;[ +<!ENTITY % ISOamsa PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Arrow Relations//EN//XML" +"ent/isoamsa.ent"> +<!--end of ISOamsa.module-->]]> + +<!ENTITY % ISOamsb.module "INCLUDE"> +<![%ISOamsb.module;[ +<!ENTITY % ISOamsb PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Binary Operators//EN//XML" +"ent/isoamsb.ent"> +<!--end of ISOamsb.module-->]]> + +<!ENTITY % ISOamsc.module "INCLUDE"> +<![%ISOamsc.module;[ +<!ENTITY % ISOamsc PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Delimiters//EN//XML" +"ent/isoamsc.ent"> +<!--end of ISOamsc.module-->]]> + +<!ENTITY % ISOamsn.module "INCLUDE"> +<![%ISOamsn.module;[ +<!ENTITY % ISOamsn PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Negated Relations//EN//XML" +"ent/isoamsn.ent"> +<!--end of ISOamsn.module-->]]> + +<!ENTITY % ISOamso.module "INCLUDE"> +<![%ISOamso.module;[ +<!ENTITY % ISOamso PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Ordinary//EN//XML" +"ent/isoamso.ent"> +<!--end of ISOamso.module-->]]> + +<!ENTITY % ISOamsr.module "INCLUDE"> +<![%ISOamsr.module;[ +<!ENTITY % ISOamsr PUBLIC +"ISO 8879:1986//ENTITIES Added Math Symbols: Relations//EN//XML" +"ent/isoamsr.ent"> +<!--end of ISOamsr.module-->]]> + +<!ENTITY % ISObox.module "INCLUDE"> +<![%ISObox.module;[ +<!ENTITY % ISObox PUBLIC +"ISO 8879:1986//ENTITIES Box and Line Drawing//EN//XML" +"ent/isobox.ent"> +<!--end of ISObox.module-->]]> + +<!ENTITY % ISOcyr1.module "INCLUDE"> +<![%ISOcyr1.module;[ +<!ENTITY % ISOcyr1 PUBLIC +"ISO 8879:1986//ENTITIES Russian Cyrillic//EN//XML" +"ent/isocyr1.ent"> +<!--end of ISOcyr1.module-->]]> + +<!ENTITY % ISOcyr2.module "INCLUDE"> +<![%ISOcyr2.module;[ +<!ENTITY % ISOcyr2 PUBLIC +"ISO 8879:1986//ENTITIES Non-Russian Cyrillic//EN//XML" +"ent/isocyr2.ent"> +<!--end of ISOcyr2.module-->]]> + +<!ENTITY % ISOdia.module "INCLUDE"> +<![%ISOdia.module;[ +<!ENTITY % ISOdia PUBLIC +"ISO 8879:1986//ENTITIES Diacritical Marks//EN//XML" +"ent/isodia.ent"> +<!--end of ISOdia.module-->]]> + +<!ENTITY % ISOgrk1.module "INCLUDE"> +<![%ISOgrk1.module;[ +<!ENTITY % ISOgrk1 PUBLIC +"ISO 8879:1986//ENTITIES Greek Letters//EN//XML" +"ent/isogrk1.ent"> +<!--end of ISOgrk1.module-->]]> + +<!ENTITY % ISOgrk2.module "INCLUDE"> +<![%ISOgrk2.module;[ +<!ENTITY % ISOgrk2 PUBLIC +"ISO 8879:1986//ENTITIES Monotoniko Greek//EN//XML" +"ent/isogrk2.ent"> +<!--end of ISOgrk2.module-->]]> + +<!ENTITY % ISOgrk3.module "INCLUDE"> +<![%ISOgrk3.module;[ +<!ENTITY % ISOgrk3 PUBLIC +"ISO 8879:1986//ENTITIES Greek Symbols//EN//XML" +"ent/isogrk3.ent"> +<!--end of ISOgrk3.module-->]]> + +<!ENTITY % ISOgrk4.module "INCLUDE"> +<![%ISOgrk4.module;[ +<!ENTITY % ISOgrk4 PUBLIC +"ISO 8879:1986//ENTITIES Alternative Greek Symbols//EN//XML" +"ent/isogrk4.ent"> +<!--end of ISOgrk4.module-->]]> + +<!ENTITY % ISOlat1.module "INCLUDE"> +<![%ISOlat1.module;[ +<!ENTITY % ISOlat1 PUBLIC +"ISO 8879:1986//ENTITIES Added Latin 1//EN//XML" +"ent/isolat1.ent"> +<!--end of ISOlat1.module-->]]> + +<!ENTITY % ISOlat2.module "INCLUDE"> +<![%ISOlat2.module;[ +<!ENTITY % ISOlat2 PUBLIC +"ISO 8879:1986//ENTITIES Added Latin 2//EN//XML" +"ent/isolat2.ent"> +<!--end of ISOlat2.module-->]]> + +<!ENTITY % ISOnum.module "INCLUDE"> +<![%ISOnum.module;[ +<!ENTITY % ISOnum PUBLIC +"ISO 8879:1986//ENTITIES Numeric and Special Graphic//EN//XML" +"ent/isonum.ent"> +<!--end of ISOnum.module-->]]> + +<!ENTITY % ISOpub.module "INCLUDE"> +<![%ISOpub.module;[ +<!ENTITY % ISOpub PUBLIC +"ISO 8879:1986//ENTITIES Publishing//EN//XML" +"ent/isopub.ent"> +<!--end of ISOpub.module-->]]> + +<!ENTITY % ISOtech.module "INCLUDE"> +<![%ISOtech.module;[ +<!ENTITY % ISOtech PUBLIC +"ISO 8879:1986//ENTITIES General Technical//EN//XML" +"ent/isotech.ent"> +<!--end of ISOtech.module-->]]> + +<!--end of xml.features-->]]> + +<![ %ISOamsa.module; [ +%ISOamsa; +]]> + +<![ %ISOamsb.module; [ +%ISOamsb; +]]> + +<![ %ISOamsc.module; [ +%ISOamsc; +]]> + +<![ %ISOamsn.module; [ +%ISOamsn; +]]> + +<![ %ISOamso.module; [ +%ISOamso; +]]> + +<![ %ISOamsr.module; [ +%ISOamsr; +]]> + +<![ %ISObox.module; [ +%ISObox; +]]> + +<![ %ISOcyr1.module; [ +%ISOcyr1; +]]> + +<![ %ISOcyr2.module; [ +%ISOcyr2; +]]> + +<![ %ISOdia.module; [ +%ISOdia; +]]> + +<![ %ISOgrk1.module; [ +%ISOgrk1; +]]> + +<![ %ISOgrk2.module; [ +%ISOgrk2; +]]> + +<![ %ISOgrk3.module; [ +%ISOgrk3; +]]> + +<![ %ISOgrk4.module; [ +%ISOgrk4; +]]> + +<![ %ISOlat1.module; [ +%ISOlat1; +]]> + +<![ %ISOlat2.module; [ +%ISOlat2; +]]> + +<![ %ISOnum.module; [ +%ISOnum; +]]> + +<![ %ISOpub.module; [ +%ISOpub; +]]> + +<![ %ISOtech.module; [ +%ISOtech; +]]> + +<!-- End of DocBook character entity sets module V4.5 ..................... --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/dbgenent.mod b/doc/creating_themes/C/dbgenent.mod new file mode 100644 index 00000000..ff5ba90d --- /dev/null +++ b/doc/creating_themes/C/dbgenent.mod @@ -0,0 +1,41 @@ +<!-- ...................................................................... --> +<!-- DocBook additional general entities V4.5 ............................. --> + +<!-- Copyright 1992-2004 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % dbgenent PUBLIC + "-//OASIS//ENTITIES DocBook Additional General Entities V4.5//EN" + "dbgenent.mod"> + %dbgenent; +--> + +<!-- File dbgenent.mod .................................................... --> + +<!-- You can edit this file to add the following: + + o General entity declarations of any kind. For example: + + <!ENTITY productname "WinWidget"> (small boilerplate) + <!ENTITY legal-notice SYSTEM "notice.sgm"> (large boilerplate) + + o Notation declarations. For example: + + <!NOTATION chicken-scratch SYSTEM> + + o Declarations for and references to external parameter entities + containing collections of any of the above. For example: + + <!ENTITY % all-titles PUBLIC "-//DocTools//ELEMENTS Book Titles//EN" + "booktitles.ent"> + %all-titles; +--> + +<!-- End of DocBook additional general entities V4.5 ...................... --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/dbhierx.mod b/doc/creating_themes/C/dbhierx.mod new file mode 100644 index 00000000..5f839f56 --- /dev/null +++ b/doc/creating_themes/C/dbhierx.mod @@ -0,0 +1,2193 @@ +<!-- ...................................................................... --> +<!-- DocBook document hierarchy module V4.5 ............................... --> +<!-- File dbhierx.mod ..................................................... --> + +<!-- Copyright 1992-2004 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + $Id: dbhierx.mod 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the definitions for the overall document + hierarchies of DocBook documents. It covers computer documentation + manuals and manual fragments, as well as reference entries (such as + man pages) and technical journals or anthologies containing + articles. + + This module depends on the DocBook information pool module. All + elements and entities referenced but not defined here are assumed + to be defined in the information pool module. + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % dbhier PUBLIC + "-//OASIS//ELEMENTS DocBook Document Hierarchy V4.5//EN" + "dbhierx.mod"> + %dbhier; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!-- ...................................................................... --> +<!-- Entities for module inclusions ....................................... --> + +<!ENTITY % dbhier.redecl.module "IGNORE"> +<!ENTITY % dbhier.redecl2.module "IGNORE"> + +<!-- ...................................................................... --> +<!-- Entities for element classes ......................................... --> + +<!ENTITY % local.appendix.class ""> +<!ENTITY % appendix.class "appendix %local.appendix.class;"> + +<!ENTITY % local.article.class ""> +<!ENTITY % article.class "article %local.article.class;"> + +<!ENTITY % local.book.class ""> +<!ENTITY % book.class "book %local.book.class;"> + +<!ENTITY % local.chapter.class ""> +<!ENTITY % chapter.class "chapter %local.chapter.class;"> + +<!ENTITY % local.index.class ""> +<!ENTITY % index.class "index|setindex %local.index.class;"> + +<!ENTITY % local.refentry.class ""> +<!ENTITY % refentry.class "refentry %local.refentry.class;"> + +<!ENTITY % local.section.class ""> +<!ENTITY % section.class "section %local.section.class;"> + +<!ENTITY % local.nav.class ""> +<!ENTITY % nav.class "toc|lot|index|glossary|bibliography + %local.nav.class;"> + +<!-- Redeclaration placeholder ............................................ --> + +<!-- For redeclaring entities that are declared after this point while + retaining their references to the entities that are declared before + this point --> + +<![%dbhier.redecl.module;[ +<!-- Defining rdbhier here makes some buggy XML parsers happy. --> +<!ENTITY % rdbhier ""> +%rdbhier; +<!--end of dbhier.redecl.module-->]]> + +<!-- ...................................................................... --> +<!-- Entities for element mixtures ........................................ --> + +<!ENTITY % local.divcomponent.mix ""> +<!ENTITY % divcomponent.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |%compound.class; + |%genobj.class; |%descobj.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.divcomponent.mix;"> + +<!ENTITY % local.refcomponent.mix ""> +<!ENTITY % refcomponent.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |%compound.class; + |%genobj.class; |%descobj.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.refcomponent.mix;"> + +<!ENTITY % local.indexdivcomponent.mix ""> +<!ENTITY % indexdivcomponent.mix + "itemizedlist|orderedlist|variablelist|simplelist + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |anchor|remark + |%link.char.class; + |beginpage + %local.indexdivcomponent.mix;"> + +<!ENTITY % local.refname.char.mix ""> +<!ENTITY % refname.char.mix + "#PCDATA + |%tech.char.class; + %local.refname.char.mix;"> + +<!ENTITY % local.partcontent.mix ""> +<!ENTITY % partcontent.mix + "%appendix.class;|%chapter.class;|%nav.class;|%article.class; + |preface|%refentry.class;|reference %local.partcontent.mix;"> + +<!ENTITY % local.refinline.char.mix ""> +<!ENTITY % refinline.char.mix + "#PCDATA + |%xref.char.class; |%gen.char.class; + |%link.char.class; |%tech.char.class; + |%base.char.class; |%docinfo.char.class; + |%other.char.class; + |%ndxterm.class; |beginpage + %local.refinline.char.mix;"> + +<!ENTITY % local.refclass.char.mix ""> +<!ENTITY % refclass.char.mix + "#PCDATA + |application + %local.refclass.char.mix;"> + +<!-- Redeclaration placeholder 2 .......................................... --> + +<!-- For redeclaring entities that are declared after this point while + retaining their references to the entities that are declared before + this point --> + +<![%dbhier.redecl2.module;[ +<!-- Defining rdbhier2 here makes some buggy XML parsers happy. --> +<!ENTITY % rdbhier2 ""> +%rdbhier2; +<!--end of dbhier.redecl2.module-->]]> + +<!-- ...................................................................... --> +<!-- Entities for content models .......................................... --> + +<!ENTITY % div.title.content + "title, subtitle?, titleabbrev?"> + +<!ENTITY % bookcomponent.title.content + "title, subtitle?, titleabbrev?"> + +<!ENTITY % sect.title.content + "title, subtitle?, titleabbrev?"> + +<!ENTITY % refsect.title.content + "title, subtitle?, titleabbrev?"> + +<!ENTITY % bookcomponent.content + "((%divcomponent.mix;)+, + (sect1*|(%refentry.class;)*|simplesect*|(%section.class;)*)) + | (sect1+|(%refentry.class;)+|simplesect+|(%section.class;)+)"> + +<!-- ...................................................................... --> +<!-- Set and SetInfo ...................................................... --> + +<!ENTITY % set.content.module "INCLUDE"> +<![%set.content.module;[ +<!ENTITY % set.module "INCLUDE"> +<![%set.module;[ +<!ENTITY % local.set.attrib ""> +<!ENTITY % set.role.attrib "%role.attrib;"> + +<!ENTITY % set.element "INCLUDE"> +<![%set.element;[ +<!--doc:A collection of books.--> +<!ELEMENT set %ho; ((%div.title.content;)?, setinfo?, toc?, (set|%book.class;)+, + setindex?) + %ubiq.inclusion;> +<!--end of set.element-->]]> + +<!-- FPI: SGML formal public identifier --> + + +<!ENTITY % set.attlist "INCLUDE"> +<![%set.attlist;[ +<!ATTLIST set + fpi CDATA #IMPLIED + %status.attrib; + %common.attrib; + %set.role.attrib; + %local.set.attrib; +> +<!--end of set.attlist-->]]> +<!--end of set.module-->]]> + +<!ENTITY % setinfo.module "INCLUDE"> +<![%setinfo.module;[ +<!ENTITY % local.setinfo.attrib ""> +<!ENTITY % setinfo.role.attrib "%role.attrib;"> + +<!ENTITY % setinfo.element "INCLUDE"> +<![%setinfo.element;[ +<!--doc:Meta-information for a Set.--> +<!ELEMENT setinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of setinfo.element-->]]> + +<!-- Contents: IDs of the ToC, Books, and SetIndex that comprise + the set, in the order of their appearance --> + + +<!ENTITY % setinfo.attlist "INCLUDE"> +<![%setinfo.attlist;[ +<!ATTLIST setinfo + contents IDREFS #IMPLIED + %common.attrib; + %setinfo.role.attrib; + %local.setinfo.attrib; +> +<!--end of setinfo.attlist-->]]> +<!--end of setinfo.module-->]]> +<!--end of set.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Book and BookInfo .................................................... --> + +<!ENTITY % book.content.module "INCLUDE"> +<![%book.content.module;[ +<!ENTITY % book.module "INCLUDE"> +<![%book.module;[ + +<!ENTITY % local.book.attrib ""> +<!ENTITY % book.role.attrib "%role.attrib;"> + +<!ENTITY % book.element "INCLUDE"> +<![%book.element;[ +<!--doc:A book.--> +<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo?, + (dedication | toc | lot + | glossary | bibliography | preface + | %chapter.class; | reference | part + | %article.class; + | %appendix.class; + | %index.class; + | colophon)*) + %ubiq.inclusion;> +<!--end of book.element-->]]> + +<!-- FPI: SGML formal public identifier --> + + +<!ENTITY % book.attlist "INCLUDE"> +<![%book.attlist;[ +<!ATTLIST book fpi CDATA #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %book.role.attrib; + %local.book.attrib; +> +<!--end of book.attlist-->]]> +<!--end of book.module-->]]> + +<!ENTITY % bookinfo.module "INCLUDE"> +<![%bookinfo.module;[ +<!ENTITY % local.bookinfo.attrib ""> +<!ENTITY % bookinfo.role.attrib "%role.attrib;"> + +<!ENTITY % bookinfo.element "INCLUDE"> +<![%bookinfo.element;[ +<!--doc:Meta-information for a Book.--> +<!ELEMENT bookinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of bookinfo.element-->]]> + +<!-- Contents: IDs of the ToC, LoTs, Prefaces, Parts, Chapters, + Appendixes, References, GLossary, Bibliography, and indexes + comprising the Book, in the order of their appearance --> + + +<!ENTITY % bookinfo.attlist "INCLUDE"> +<![%bookinfo.attlist;[ +<!ATTLIST bookinfo + contents IDREFS #IMPLIED + %common.attrib; + %bookinfo.role.attrib; + %local.bookinfo.attrib; +> +<!--end of bookinfo.attlist-->]]> +<!--end of bookinfo.module-->]]> +<!--end of book.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Dedication, ToC, and LoT ............................................. --> + +<!ENTITY % dedication.module "INCLUDE"> +<![%dedication.module;[ +<!ENTITY % local.dedication.attrib ""> +<!ENTITY % dedication.role.attrib "%role.attrib;"> + +<!ENTITY % dedication.element "INCLUDE"> +<![%dedication.element;[ +<!--doc:A wrapper for the dedication section of a book.--> +<!ELEMENT dedication %ho; ((%sect.title.content;)?, (%legalnotice.mix;)+)> +<!--end of dedication.element-->]]> + +<!ENTITY % dedication.attlist "INCLUDE"> +<![%dedication.attlist;[ +<!ATTLIST dedication + %status.attrib; + %common.attrib; + %dedication.role.attrib; + %local.dedication.attrib; +> +<!--end of dedication.attlist-->]]> +<!--end of dedication.module-->]]> + +<!ENTITY % colophon.module "INCLUDE"> +<![ %colophon.module; [ +<!ENTITY % local.colophon.attrib ""> +<!ENTITY % colophon.role.attrib "%role.attrib;"> + +<!ENTITY % colophon.element "INCLUDE"> +<![ %colophon.element; [ +<!--doc:Text at the back of a book describing facts about its production.--> +<!ELEMENT colophon %ho; ((%sect.title.content;)?, (%textobject.mix;)+)> +<!--end of colophon.element-->]]> + +<!ENTITY % colophon.attlist "INCLUDE"> +<![ %colophon.attlist; [ +<!ATTLIST colophon + %status.attrib; + %common.attrib; + %colophon.role.attrib; + %local.colophon.attrib;> +<!--end of colophon.attlist-->]]> +<!--end of colophon.module-->]]> + +<!ENTITY % toc.content.module "INCLUDE"> +<![%toc.content.module;[ +<!ENTITY % toc.module "INCLUDE"> +<![%toc.module;[ +<!ENTITY % local.toc.attrib ""> +<!ENTITY % toc.role.attrib "%role.attrib;"> + +<!ENTITY % toc.element "INCLUDE"> +<![%toc.element;[ +<!--doc:A table of contents.--> +<!ELEMENT toc %ho; (beginpage?, + (%bookcomponent.title.content;)?, + tocfront*, + (tocpart | tocchap)*, tocback*)> +<!--end of toc.element-->]]> + +<!ENTITY % toc.attlist "INCLUDE"> +<![%toc.attlist;[ +<!ATTLIST toc + %pagenum.attrib; + %common.attrib; + %toc.role.attrib; + %local.toc.attrib; +> +<!--end of toc.attlist-->]]> +<!--end of toc.module-->]]> + +<!ENTITY % tocfront.module "INCLUDE"> +<![%tocfront.module;[ +<!ENTITY % local.tocfront.attrib ""> +<!ENTITY % tocfront.role.attrib "%role.attrib;"> + +<!ENTITY % tocfront.element "INCLUDE"> +<![%tocfront.element;[ +<!--doc:An entry in a table of contents for a front matter component.--> +<!ELEMENT tocfront %ho; (%para.char.mix;)*> +<!--end of tocfront.element-->]]> + +<!-- to element that this entry represents --> + + +<!ENTITY % tocfront.attlist "INCLUDE"> +<![%tocfront.attlist;[ +<!ATTLIST tocfront + %label.attrib; + %linkend.attrib; %pagenum.attrib; + %common.attrib; + %tocfront.role.attrib; + %local.tocfront.attrib; +> +<!--end of tocfront.attlist-->]]> +<!--end of tocfront.module-->]]> + +<!ENTITY % tocentry.module "INCLUDE"> +<![%tocentry.module;[ +<!ENTITY % local.tocentry.attrib ""> +<!ENTITY % tocentry.role.attrib "%role.attrib;"> + +<!ENTITY % tocentry.element "INCLUDE"> +<![%tocentry.element;[ +<!--doc:A component title in a table of contents.--> +<!ELEMENT tocentry %ho; (%para.char.mix;)*> +<!--end of tocentry.element-->]]> + +<!-- to element that this entry represents --> + + +<!ENTITY % tocentry.attlist "INCLUDE"> +<![%tocentry.attlist;[ +<!ATTLIST tocentry + %linkend.attrib; %pagenum.attrib; + %common.attrib; + %tocentry.role.attrib; + %local.tocentry.attrib; +> +<!--end of tocentry.attlist-->]]> +<!--end of tocentry.module-->]]> + +<!ENTITY % tocpart.module "INCLUDE"> +<![%tocpart.module;[ +<!ENTITY % local.tocpart.attrib ""> +<!ENTITY % tocpart.role.attrib "%role.attrib;"> + +<!ENTITY % tocpart.element "INCLUDE"> +<![%tocpart.element;[ +<!--doc:An entry in a table of contents for a part of a book.--> +<!ELEMENT tocpart %ho; (tocentry+, tocchap*)> +<!--end of tocpart.element-->]]> + +<!ENTITY % tocpart.attlist "INCLUDE"> +<![%tocpart.attlist;[ +<!ATTLIST tocpart + %common.attrib; + %tocpart.role.attrib; + %local.tocpart.attrib; +> +<!--end of tocpart.attlist-->]]> +<!--end of tocpart.module-->]]> + +<!ENTITY % tocchap.module "INCLUDE"> +<![%tocchap.module;[ +<!ENTITY % local.tocchap.attrib ""> +<!ENTITY % tocchap.role.attrib "%role.attrib;"> + +<!ENTITY % tocchap.element "INCLUDE"> +<![%tocchap.element;[ +<!--doc:An entry in a table of contents for a component in the body of a document.--> +<!ELEMENT tocchap %ho; (tocentry+, toclevel1*)> +<!--end of tocchap.element-->]]> + +<!ENTITY % tocchap.attlist "INCLUDE"> +<![%tocchap.attlist;[ +<!ATTLIST tocchap + %label.attrib; + %common.attrib; + %tocchap.role.attrib; + %local.tocchap.attrib; +> +<!--end of tocchap.attlist-->]]> +<!--end of tocchap.module-->]]> + +<!ENTITY % toclevel1.module "INCLUDE"> +<![%toclevel1.module;[ +<!ENTITY % local.toclevel1.attrib ""> +<!ENTITY % toclevel1.role.attrib "%role.attrib;"> + +<!ENTITY % toclevel1.element "INCLUDE"> +<![%toclevel1.element;[ +<!--doc:A top-level entry within a table of contents entry for a chapter-like component.--> +<!ELEMENT toclevel1 %ho; (tocentry+, toclevel2*)> +<!--end of toclevel1.element-->]]> + +<!ENTITY % toclevel1.attlist "INCLUDE"> +<![%toclevel1.attlist;[ +<!ATTLIST toclevel1 + %common.attrib; + %toclevel1.role.attrib; + %local.toclevel1.attrib; +> +<!--end of toclevel1.attlist-->]]> +<!--end of toclevel1.module-->]]> + +<!ENTITY % toclevel2.module "INCLUDE"> +<![%toclevel2.module;[ +<!ENTITY % local.toclevel2.attrib ""> +<!ENTITY % toclevel2.role.attrib "%role.attrib;"> + +<!ENTITY % toclevel2.element "INCLUDE"> +<![%toclevel2.element;[ +<!--doc:A second-level entry within a table of contents entry for a chapter-like component.--> +<!ELEMENT toclevel2 %ho; (tocentry+, toclevel3*)> +<!--end of toclevel2.element-->]]> + +<!ENTITY % toclevel2.attlist "INCLUDE"> +<![%toclevel2.attlist;[ +<!ATTLIST toclevel2 + %common.attrib; + %toclevel2.role.attrib; + %local.toclevel2.attrib; +> +<!--end of toclevel2.attlist-->]]> +<!--end of toclevel2.module-->]]> + +<!ENTITY % toclevel3.module "INCLUDE"> +<![%toclevel3.module;[ +<!ENTITY % local.toclevel3.attrib ""> +<!ENTITY % toclevel3.role.attrib "%role.attrib;"> + +<!ENTITY % toclevel3.element "INCLUDE"> +<![%toclevel3.element;[ +<!--doc:A third-level entry within a table of contents entry for a chapter-like component.--> +<!ELEMENT toclevel3 %ho; (tocentry+, toclevel4*)> +<!--end of toclevel3.element-->]]> + +<!ENTITY % toclevel3.attlist "INCLUDE"> +<![%toclevel3.attlist;[ +<!ATTLIST toclevel3 + %common.attrib; + %toclevel3.role.attrib; + %local.toclevel3.attrib; +> +<!--end of toclevel3.attlist-->]]> +<!--end of toclevel3.module-->]]> + +<!ENTITY % toclevel4.module "INCLUDE"> +<![%toclevel4.module;[ +<!ENTITY % local.toclevel4.attrib ""> +<!ENTITY % toclevel4.role.attrib "%role.attrib;"> + +<!ENTITY % toclevel4.element "INCLUDE"> +<![%toclevel4.element;[ +<!--doc:A fourth-level entry within a table of contents entry for a chapter-like component.--> +<!ELEMENT toclevel4 %ho; (tocentry+, toclevel5*)> +<!--end of toclevel4.element-->]]> + +<!ENTITY % toclevel4.attlist "INCLUDE"> +<![%toclevel4.attlist;[ +<!ATTLIST toclevel4 + %common.attrib; + %toclevel4.role.attrib; + %local.toclevel4.attrib; +> +<!--end of toclevel4.attlist-->]]> +<!--end of toclevel4.module-->]]> + +<!ENTITY % toclevel5.module "INCLUDE"> +<![%toclevel5.module;[ +<!ENTITY % local.toclevel5.attrib ""> +<!ENTITY % toclevel5.role.attrib "%role.attrib;"> + +<!ENTITY % toclevel5.element "INCLUDE"> +<![%toclevel5.element;[ +<!--doc:A fifth-level entry within a table of contents entry for a chapter-like component.--> +<!ELEMENT toclevel5 %ho; (tocentry+)> +<!--end of toclevel5.element-->]]> + +<!ENTITY % toclevel5.attlist "INCLUDE"> +<![%toclevel5.attlist;[ +<!ATTLIST toclevel5 + %common.attrib; + %toclevel5.role.attrib; + %local.toclevel5.attrib; +> +<!--end of toclevel5.attlist-->]]> +<!--end of toclevel5.module-->]]> + +<!ENTITY % tocback.module "INCLUDE"> +<![%tocback.module;[ +<!ENTITY % local.tocback.attrib ""> +<!ENTITY % tocback.role.attrib "%role.attrib;"> + +<!ENTITY % tocback.element "INCLUDE"> +<![%tocback.element;[ +<!--doc:An entry in a table of contents for a back matter component.--> +<!ELEMENT tocback %ho; (%para.char.mix;)*> +<!--end of tocback.element-->]]> + +<!-- to element that this entry represents --> + + +<!ENTITY % tocback.attlist "INCLUDE"> +<![%tocback.attlist;[ +<!ATTLIST tocback + %label.attrib; + %linkend.attrib; %pagenum.attrib; + %common.attrib; + %tocback.role.attrib; + %local.tocback.attrib; +> +<!--end of tocback.attlist-->]]> +<!--end of tocback.module-->]]> +<!--end of toc.content.module-->]]> + +<!ENTITY % lot.content.module "INCLUDE"> +<![%lot.content.module;[ +<!ENTITY % lot.module "INCLUDE"> +<![%lot.module;[ +<!ENTITY % local.lot.attrib ""> +<!ENTITY % lot.role.attrib "%role.attrib;"> + +<!ENTITY % lot.element "INCLUDE"> +<![%lot.element;[ +<!--doc:A list of the titles of formal objects (as tables or figures) in a document.--> +<!ELEMENT lot %ho; (beginpage?, (%bookcomponent.title.content;)?, lotentry*)> +<!--end of lot.element-->]]> + +<!ENTITY % lot.attlist "INCLUDE"> +<![%lot.attlist;[ +<!ATTLIST lot + %label.attrib; + %common.attrib; + %lot.role.attrib; + %local.lot.attrib; +> +<!--end of lot.attlist-->]]> +<!--end of lot.module-->]]> + +<!ENTITY % lotentry.module "INCLUDE"> +<![%lotentry.module;[ +<!ENTITY % local.lotentry.attrib ""> +<!ENTITY % lotentry.role.attrib "%role.attrib;"> + +<!ENTITY % lotentry.element "INCLUDE"> +<![%lotentry.element;[ +<!--doc:An entry in a list of titles.--> +<!ELEMENT lotentry %ho; (%para.char.mix;)*> +<!--end of lotentry.element-->]]> + +<!-- SrcCredit: Information about the source of the entry, + as for a list of illustrations --> +<!-- linkend: to element that this entry represents--> +<!ENTITY % lotentry.attlist "INCLUDE"> +<![%lotentry.attlist;[ +<!ATTLIST lotentry + %linkend.attrib; + %pagenum.attrib; + srccredit CDATA #IMPLIED + %common.attrib; + %lotentry.role.attrib; + %local.lotentry.attrib; +> +<!--end of lotentry.attlist-->]]> +<!--end of lotentry.module-->]]> +<!--end of lot.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Appendix, Chapter, Part, Preface, Reference, PartIntro ............... --> + +<!ENTITY % appendix.module "INCLUDE"> +<![%appendix.module;[ +<!ENTITY % local.appendix.attrib ""> +<!ENTITY % appendix.role.attrib "%role.attrib;"> + +<!ENTITY % appendix.element "INCLUDE"> +<![%appendix.element;[ +<!--doc:An appendix in a Book or Article.--> +<!ELEMENT appendix %ho; (beginpage?, + appendixinfo?, + (%bookcomponent.title.content;), + (%nav.class;)*, + tocchap?, + (%bookcomponent.content;), + (%nav.class;)*) + %ubiq.inclusion;> +<!--end of appendix.element-->]]> + +<!ENTITY % appendix.attlist "INCLUDE"> +<![%appendix.attlist;[ +<!ATTLIST appendix + %label.attrib; + %status.attrib; + %common.attrib; + %appendix.role.attrib; + %local.appendix.attrib; +> +<!--end of appendix.attlist-->]]> +<!--end of appendix.module-->]]> + +<!ENTITY % chapter.module "INCLUDE"> +<![%chapter.module;[ +<!ENTITY % local.chapter.attrib ""> +<!ENTITY % chapter.role.attrib "%role.attrib;"> + +<!ENTITY % chapter.element "INCLUDE"> +<![%chapter.element;[ +<!--doc:A chapter, as of a book.--> +<!ELEMENT chapter %ho; (beginpage?, + chapterinfo?, + (%bookcomponent.title.content;), + (%nav.class;)*, + tocchap?, + (%bookcomponent.content;), + (%nav.class;)*) + %ubiq.inclusion;> +<!--end of chapter.element-->]]> + +<!ENTITY % chapter.attlist "INCLUDE"> +<![%chapter.attlist;[ +<!ATTLIST chapter + %label.attrib; + %status.attrib; + %common.attrib; + %chapter.role.attrib; + %local.chapter.attrib; +> +<!--end of chapter.attlist-->]]> +<!--end of chapter.module-->]]> + +<!ENTITY % part.module "INCLUDE"> +<![%part.module;[ + +<!-- Note that Part was to have its content model reduced in V4.5. This +change will not be made after all. --> + +<!ENTITY % local.part.attrib ""> +<!ENTITY % part.role.attrib "%role.attrib;"> + +<!ENTITY % part.element "INCLUDE"> +<![%part.element;[ +<!--doc:A division in a book.--> +<!ELEMENT part %ho; (beginpage?, + partinfo?, (%bookcomponent.title.content;), partintro?, + (%partcontent.mix;)+) + %ubiq.inclusion;> +<!--end of part.element-->]]> + +<!ENTITY % part.attlist "INCLUDE"> +<![%part.attlist;[ +<!ATTLIST part + %label.attrib; + %status.attrib; + %common.attrib; + %part.role.attrib; + %local.part.attrib; +> +<!--end of part.attlist-->]]> +<!--ELEMENT PartIntro (defined below)--> +<!--end of part.module-->]]> + +<!ENTITY % preface.module "INCLUDE"> +<![%preface.module;[ +<!ENTITY % local.preface.attrib ""> +<!ENTITY % preface.role.attrib "%role.attrib;"> + +<!ENTITY % preface.element "INCLUDE"> +<![%preface.element;[ +<!--doc:Introductory matter preceding the first chapter of a book.--> +<!ELEMENT preface %ho; (beginpage?, + prefaceinfo?, + (%bookcomponent.title.content;), + (%nav.class;)*, + tocchap?, + (%bookcomponent.content;), + (%nav.class;)*) + %ubiq.inclusion;> +<!--end of preface.element-->]]> + +<!ENTITY % preface.attlist "INCLUDE"> +<![%preface.attlist;[ +<!ATTLIST preface + %status.attrib; + %common.attrib; + %preface.role.attrib; + %local.preface.attrib; +> +<!--end of preface.attlist-->]]> +<!--end of preface.module-->]]> + +<!ENTITY % reference.module "INCLUDE"> +<![%reference.module;[ +<!ENTITY % local.reference.attrib ""> +<!ENTITY % reference.role.attrib "%role.attrib;"> + +<!ENTITY % reference.element "INCLUDE"> +<![%reference.element;[ +<!--doc:A collection of reference entries.--> +<!ELEMENT reference %ho; (beginpage?, + referenceinfo?, + (%bookcomponent.title.content;), partintro?, + (%refentry.class;)+) + %ubiq.inclusion;> +<!--end of reference.element-->]]> + +<!ENTITY % reference.attlist "INCLUDE"> +<![%reference.attlist;[ +<!ATTLIST reference + %label.attrib; + %status.attrib; + %common.attrib; + %reference.role.attrib; + %local.reference.attrib; +> +<!--end of reference.attlist-->]]> +<!--ELEMENT PartIntro (defined below)--> +<!--end of reference.module-->]]> + +<!ENTITY % partintro.module "INCLUDE"> +<![%partintro.module;[ +<!ENTITY % local.partintro.attrib ""> +<!ENTITY % partintro.role.attrib "%role.attrib;"> + +<!ENTITY % partintro.element "INCLUDE"> +<![%partintro.element;[ +<!--doc:An introduction to the contents of a part.--> +<!ELEMENT partintro %ho; ((%div.title.content;)?, (%bookcomponent.content;)) + %ubiq.inclusion;> +<!--end of partintro.element-->]]> + +<!ENTITY % partintro.attlist "INCLUDE"> +<![%partintro.attlist;[ +<!ATTLIST partintro + %label.attrib; + %common.attrib; + %partintro.role.attrib; + %local.partintro.attrib; +> +<!--end of partintro.attlist-->]]> +<!--end of partintro.module-->]]> + +<!-- ...................................................................... --> +<!-- Other Info elements .................................................. --> + +<!ENTITY % appendixinfo.module "INCLUDE"> +<![ %appendixinfo.module; [ +<!ENTITY % local.appendixinfo.attrib ""> +<!ENTITY % appendixinfo.role.attrib "%role.attrib;"> + +<!ENTITY % appendixinfo.element "INCLUDE"> +<![ %appendixinfo.element; [ +<!--doc:Meta-information for an Appendix.--> +<!ELEMENT appendixinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of appendixinfo.element-->]]> + +<!ENTITY % appendixinfo.attlist "INCLUDE"> +<![ %appendixinfo.attlist; [ +<!ATTLIST appendixinfo + %common.attrib; + %appendixinfo.role.attrib; + %local.appendixinfo.attrib; +> +<!--end of appendixinfo.attlist-->]]> +<!--end of appendixinfo.module-->]]> + +<!ENTITY % bibliographyinfo.module "INCLUDE"> +<![ %bibliographyinfo.module; [ +<!ENTITY % local.bibliographyinfo.attrib ""> +<!ENTITY % bibliographyinfo.role.attrib "%role.attrib;"> + +<!ENTITY % bibliographyinfo.element "INCLUDE"> +<![ %bibliographyinfo.element; [ +<!--doc:Meta-information for a Bibliography.--> +<!ELEMENT bibliographyinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of bibliographyinfo.element-->]]> + +<!ENTITY % bibliographyinfo.attlist "INCLUDE"> +<![ %bibliographyinfo.attlist; [ +<!ATTLIST bibliographyinfo + %common.attrib; + %bibliographyinfo.role.attrib; + %local.bibliographyinfo.attrib; +> +<!--end of bibliographyinfo.attlist-->]]> +<!--end of bibliographyinfo.module-->]]> + +<!ENTITY % chapterinfo.module "INCLUDE"> +<![ %chapterinfo.module; [ +<!ENTITY % local.chapterinfo.attrib ""> +<!ENTITY % chapterinfo.role.attrib "%role.attrib;"> + +<!ENTITY % chapterinfo.element "INCLUDE"> +<![ %chapterinfo.element; [ +<!--doc:Meta-information for a Chapter.--> +<!ELEMENT chapterinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of chapterinfo.element-->]]> + +<!ENTITY % chapterinfo.attlist "INCLUDE"> +<![ %chapterinfo.attlist; [ +<!ATTLIST chapterinfo + %common.attrib; + %chapterinfo.role.attrib; + %local.chapterinfo.attrib; +> +<!--end of chapterinfo.attlist-->]]> +<!--end of chapterinfo.module-->]]> + +<!ENTITY % glossaryinfo.module "INCLUDE"> +<![ %glossaryinfo.module; [ +<!ENTITY % local.glossaryinfo.attrib ""> +<!ENTITY % glossaryinfo.role.attrib "%role.attrib;"> + +<!ENTITY % glossaryinfo.element "INCLUDE"> +<![ %glossaryinfo.element; [ +<!--doc:Meta-information for a Glossary.--> +<!ELEMENT glossaryinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of glossaryinfo.element-->]]> + +<!ENTITY % glossaryinfo.attlist "INCLUDE"> +<![ %glossaryinfo.attlist; [ +<!ATTLIST glossaryinfo + %common.attrib; + %glossaryinfo.role.attrib; + %local.glossaryinfo.attrib; +> +<!--end of glossaryinfo.attlist-->]]> +<!--end of glossaryinfo.module-->]]> + +<!ENTITY % indexinfo.module "INCLUDE"> +<![ %indexinfo.module; [ +<!ENTITY % local.indexinfo.attrib ""> +<!ENTITY % indexinfo.role.attrib "%role.attrib;"> + +<!ENTITY % indexinfo.element "INCLUDE"> +<![ %indexinfo.element; [ +<!--doc:Meta-information for an Index.--> +<!ELEMENT indexinfo %ho; ((%info.class;)+)> +<!--end of indexinfo.element-->]]> + +<!ENTITY % indexinfo.attlist "INCLUDE"> +<![ %indexinfo.attlist; [ +<!ATTLIST indexinfo + %common.attrib; + %indexinfo.role.attrib; + %local.indexinfo.attrib; +> +<!--end of indexinfo.attlist-->]]> +<!--end of indexinfo.module-->]]> + +<!ENTITY % setindexinfo.module "INCLUDE"> +<![ %setindexinfo.module; [ +<!ENTITY % local.setindexinfo.attrib ""> +<!ENTITY % setindexinfo.role.attrib "%role.attrib;"> + +<!ENTITY % setindexinfo.element "INCLUDE"> +<![ %setindexinfo.element; [ +<!--doc:Meta-information for a SetIndex.--> +<!ELEMENT setindexinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of setindexinfo.element-->]]> + +<!ENTITY % setindexinfo.attlist "INCLUDE"> +<![ %setindexinfo.attlist; [ +<!ATTLIST setindexinfo + %common.attrib; + %setindexinfo.role.attrib; + %local.setindexinfo.attrib; +> +<!--end of setindexinfo.attlist-->]]> +<!--end of setindexinfo.module-->]]> + +<!ENTITY % partinfo.module "INCLUDE"> +<![ %partinfo.module; [ +<!ENTITY % local.partinfo.attrib ""> +<!ENTITY % partinfo.role.attrib "%role.attrib;"> + +<!ENTITY % partinfo.element "INCLUDE"> +<![ %partinfo.element; [ +<!--doc:Meta-information for a Part.--> +<!ELEMENT partinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of partinfo.element-->]]> + +<!ENTITY % partinfo.attlist "INCLUDE"> +<![ %partinfo.attlist; [ +<!ATTLIST partinfo + %common.attrib; + %partinfo.role.attrib; + %local.partinfo.attrib; +> +<!--end of partinfo.attlist-->]]> +<!--end of partinfo.module-->]]> + +<!ENTITY % prefaceinfo.module "INCLUDE"> +<![ %prefaceinfo.module; [ +<!ENTITY % local.prefaceinfo.attrib ""> +<!ENTITY % prefaceinfo.role.attrib "%role.attrib;"> + +<!ENTITY % prefaceinfo.element "INCLUDE"> +<![ %prefaceinfo.element; [ +<!--doc:Meta-information for a Preface.--> +<!ELEMENT prefaceinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of prefaceinfo.element-->]]> + +<!ENTITY % prefaceinfo.attlist "INCLUDE"> +<![ %prefaceinfo.attlist; [ +<!ATTLIST prefaceinfo + %common.attrib; + %prefaceinfo.role.attrib; + %local.prefaceinfo.attrib; +> +<!--end of prefaceinfo.attlist-->]]> +<!--end of prefaceinfo.module-->]]> + +<!ENTITY % refentryinfo.module "INCLUDE"> +<![ %refentryinfo.module; [ +<!ENTITY % local.refentryinfo.attrib ""> +<!ENTITY % refentryinfo.role.attrib "%role.attrib;"> + +<!ENTITY % refentryinfo.element "INCLUDE"> +<![ %refentryinfo.element; [ +<!--doc:Meta-information for a Refentry.--> +<!ELEMENT refentryinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refentryinfo.element-->]]> + +<!ENTITY % refentryinfo.attlist "INCLUDE"> +<![ %refentryinfo.attlist; [ +<!ATTLIST refentryinfo + %common.attrib; + %refentryinfo.role.attrib; + %local.refentryinfo.attrib; +> +<!--end of refentryinfo.attlist-->]]> +<!--end of refentryinfo.module-->]]> + +<!ENTITY % refsectioninfo.module "INCLUDE"> +<![ %refsectioninfo.module; [ +<!ENTITY % local.refsectioninfo.attrib ""> +<!ENTITY % refsectioninfo.role.attrib "%role.attrib;"> + +<!ENTITY % refsectioninfo.element "INCLUDE"> +<![ %refsectioninfo.element; [ +<!--doc:Meta-information for a refsection.--> +<!ELEMENT refsectioninfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refsectioninfo.element-->]]> + +<!ENTITY % refsectioninfo.attlist "INCLUDE"> +<![ %refsectioninfo.attlist; [ +<!ATTLIST refsectioninfo + %common.attrib; + %refsectioninfo.role.attrib; + %local.refsectioninfo.attrib; +> +<!--end of refsectioninfo.attlist-->]]> +<!--end of refsectioninfo.module-->]]> + +<!ENTITY % refsect1info.module "INCLUDE"> +<![ %refsect1info.module; [ +<!ENTITY % local.refsect1info.attrib ""> +<!ENTITY % refsect1info.role.attrib "%role.attrib;"> + +<!ENTITY % refsect1info.element "INCLUDE"> +<![ %refsect1info.element; [ +<!--doc:Meta-information for a RefSect1.--> +<!ELEMENT refsect1info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refsect1info.element-->]]> + +<!ENTITY % refsect1info.attlist "INCLUDE"> +<![ %refsect1info.attlist; [ +<!ATTLIST refsect1info + %common.attrib; + %refsect1info.role.attrib; + %local.refsect1info.attrib; +> +<!--end of refsect1info.attlist-->]]> +<!--end of refsect1info.module-->]]> + +<!ENTITY % refsect2info.module "INCLUDE"> +<![ %refsect2info.module; [ +<!ENTITY % local.refsect2info.attrib ""> +<!ENTITY % refsect2info.role.attrib "%role.attrib;"> + +<!ENTITY % refsect2info.element "INCLUDE"> +<![ %refsect2info.element; [ +<!--doc:Meta-information for a RefSect2.--> +<!ELEMENT refsect2info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refsect2info.element-->]]> + +<!ENTITY % refsect2info.attlist "INCLUDE"> +<![ %refsect2info.attlist; [ +<!ATTLIST refsect2info + %common.attrib; + %refsect2info.role.attrib; + %local.refsect2info.attrib; +> +<!--end of refsect2info.attlist-->]]> +<!--end of refsect2info.module-->]]> + +<!ENTITY % refsect3info.module "INCLUDE"> +<![ %refsect3info.module; [ +<!ENTITY % local.refsect3info.attrib ""> +<!ENTITY % refsect3info.role.attrib "%role.attrib;"> + +<!ENTITY % refsect3info.element "INCLUDE"> +<![ %refsect3info.element; [ +<!--doc:Meta-information for a RefSect3.--> +<!ELEMENT refsect3info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refsect3info.element-->]]> + +<!ENTITY % refsect3info.attlist "INCLUDE"> +<![ %refsect3info.attlist; [ +<!ATTLIST refsect3info + %common.attrib; + %refsect3info.role.attrib; + %local.refsect3info.attrib; +> +<!--end of refsect3info.attlist-->]]> +<!--end of refsect3info.module-->]]> + +<!ENTITY % refsynopsisdivinfo.module "INCLUDE"> +<![ %refsynopsisdivinfo.module; [ +<!ENTITY % local.refsynopsisdivinfo.attrib ""> +<!ENTITY % refsynopsisdivinfo.role.attrib "%role.attrib;"> + +<!ENTITY % refsynopsisdivinfo.element "INCLUDE"> +<![ %refsynopsisdivinfo.element; [ +<!--doc:Meta-information for a RefSynopsisDiv.--> +<!ELEMENT refsynopsisdivinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of refsynopsisdivinfo.element-->]]> + +<!ENTITY % refsynopsisdivinfo.attlist "INCLUDE"> +<![ %refsynopsisdivinfo.attlist; [ +<!ATTLIST refsynopsisdivinfo + %common.attrib; + %refsynopsisdivinfo.role.attrib; + %local.refsynopsisdivinfo.attrib; +> +<!--end of refsynopsisdivinfo.attlist-->]]> +<!--end of refsynopsisdivinfo.module-->]]> + +<!ENTITY % referenceinfo.module "INCLUDE"> +<![ %referenceinfo.module; [ +<!ENTITY % local.referenceinfo.attrib ""> +<!ENTITY % referenceinfo.role.attrib "%role.attrib;"> + +<!ENTITY % referenceinfo.element "INCLUDE"> +<![ %referenceinfo.element; [ +<!--doc:Meta-information for a Reference.--> +<!ELEMENT referenceinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of referenceinfo.element-->]]> + +<!ENTITY % referenceinfo.attlist "INCLUDE"> +<![ %referenceinfo.attlist; [ +<!ATTLIST referenceinfo + %common.attrib; + %referenceinfo.role.attrib; + %local.referenceinfo.attrib; +> +<!--end of referenceinfo.attlist-->]]> +<!--end of referenceinfo.module-->]]> + +<!ENTITY % local.sect1info.attrib ""> +<!ENTITY % sect1info.role.attrib "%role.attrib;"> + +<!ENTITY % sect1info.element "INCLUDE"> +<![%sect1info.element;[ +<!--doc:Meta-information for a Sect1.--> +<!ELEMENT sect1info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sect1info.element-->]]> + +<!ENTITY % sect1info.attlist "INCLUDE"> +<![%sect1info.attlist;[ +<!ATTLIST sect1info + %common.attrib; + %sect1info.role.attrib; + %local.sect1info.attrib; +> +<!--end of sect1info.attlist-->]]> + +<!ENTITY % local.sect2info.attrib ""> +<!ENTITY % sect2info.role.attrib "%role.attrib;"> + +<!ENTITY % sect2info.element "INCLUDE"> +<![%sect2info.element;[ +<!--doc:Meta-information for a Sect2.--> +<!ELEMENT sect2info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sect2info.element-->]]> + +<!ENTITY % sect2info.attlist "INCLUDE"> +<![%sect2info.attlist;[ +<!ATTLIST sect2info + %common.attrib; + %sect2info.role.attrib; + %local.sect2info.attrib; +> +<!--end of sect2info.attlist-->]]> + +<!ENTITY % local.sect3info.attrib ""> +<!ENTITY % sect3info.role.attrib "%role.attrib;"> + +<!ENTITY % sect3info.element "INCLUDE"> +<![%sect3info.element;[ +<!--doc:Meta-information for a Sect3.--> +<!ELEMENT sect3info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sect3info.element-->]]> + +<!ENTITY % sect3info.attlist "INCLUDE"> +<![%sect3info.attlist;[ +<!ATTLIST sect3info + %common.attrib; + %sect3info.role.attrib; + %local.sect3info.attrib; +> +<!--end of sect3info.attlist-->]]> + +<!ENTITY % local.sect4info.attrib ""> +<!ENTITY % sect4info.role.attrib "%role.attrib;"> + +<!ENTITY % sect4info.element "INCLUDE"> +<![%sect4info.element;[ +<!--doc:Meta-information for a Sect4.--> +<!ELEMENT sect4info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sect4info.element-->]]> + +<!ENTITY % sect4info.attlist "INCLUDE"> +<![%sect4info.attlist;[ +<!ATTLIST sect4info + %common.attrib; + %sect4info.role.attrib; + %local.sect4info.attrib; +> +<!--end of sect4info.attlist-->]]> + +<!ENTITY % local.sect5info.attrib ""> +<!ENTITY % sect5info.role.attrib "%role.attrib;"> + +<!ENTITY % sect5info.element "INCLUDE"> +<![%sect5info.element;[ +<!--doc:Meta-information for a Sect5.--> +<!ELEMENT sect5info %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sect5info.element-->]]> + +<!ENTITY % sect5info.attlist "INCLUDE"> +<![%sect5info.attlist;[ +<!ATTLIST sect5info + %common.attrib; + %sect5info.role.attrib; + %local.sect5info.attrib; +> +<!--end of sect5info.attlist-->]]> + +<!-- ...................................................................... --> +<!-- Section (parallel to Sect*) ......................................... --> + +<!ENTITY % section.content.module "INCLUDE"> +<![ %section.content.module; [ +<!ENTITY % section.module "INCLUDE"> +<![ %section.module; [ +<!ENTITY % local.section.attrib ""> +<!ENTITY % section.role.attrib "%role.attrib;"> + +<!ENTITY % section.element "INCLUDE"> +<![ %section.element; [ +<!--doc:A recursive section.--> +<!ELEMENT section %ho; (sectioninfo?, + (%sect.title.content;), + (%nav.class;)*, + (((%divcomponent.mix;)+, + ((%refentry.class;)*|(%section.class;)*|simplesect*)) + | (%refentry.class;)+|(%section.class;)+|simplesect+), + (%nav.class;)*) + %ubiq.inclusion;> +<!--end of section.element-->]]> + +<!ENTITY % section.attlist "INCLUDE"> +<![ %section.attlist; [ +<!ATTLIST section + %label.attrib; + %status.attrib; + %common.attrib; + %section.role.attrib; + %local.section.attrib; +> +<!--end of section.attlist-->]]> +<!--end of section.module-->]]> + +<!ENTITY % sectioninfo.module "INCLUDE"> +<![ %sectioninfo.module; [ +<!ENTITY % sectioninfo.role.attrib "%role.attrib;"> +<!ENTITY % local.sectioninfo.attrib ""> + +<!ENTITY % sectioninfo.element "INCLUDE"> +<![ %sectioninfo.element; [ +<!--doc:Meta-information for a recursive section.--> +<!ELEMENT sectioninfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sectioninfo.element-->]]> + +<!ENTITY % sectioninfo.attlist "INCLUDE"> +<![ %sectioninfo.attlist; [ +<!ATTLIST sectioninfo + %common.attrib; + %sectioninfo.role.attrib; + %local.sectioninfo.attrib; +> +<!--end of sectioninfo.attlist-->]]> +<!--end of sectioninfo.module-->]]> +<!--end of section.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Sect1, Sect2, Sect3, Sect4, Sect5 .................................... --> + +<!ENTITY % sect1.module "INCLUDE"> +<![%sect1.module;[ +<!ENTITY % local.sect1.attrib ""> +<!ENTITY % sect1.role.attrib "%role.attrib;"> + +<!ENTITY % sect1.element "INCLUDE"> +<![%sect1.element;[ +<!--doc:A top-level section of document.--> +<!ELEMENT sect1 %ho; (sect1info?, (%sect.title.content;), (%nav.class;)*, + (((%divcomponent.mix;)+, + ((%refentry.class;)* | sect2* | simplesect*)) + | (%refentry.class;)+ | sect2+ | simplesect+), (%nav.class;)*) + %ubiq.inclusion;> +<!--end of sect1.element-->]]> + +<!-- Renderas: Indicates the format in which the heading should + appear --> + + +<!ENTITY % sect1.attlist "INCLUDE"> +<![%sect1.attlist;[ +<!ATTLIST sect1 + renderas (sect2 + |sect3 + |sect4 + |sect5) #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %sect1.role.attrib; + %local.sect1.attrib; +> +<!--end of sect1.attlist-->]]> +<!--end of sect1.module-->]]> + +<!ENTITY % sect2.module "INCLUDE"> +<![%sect2.module;[ +<!ENTITY % local.sect2.attrib ""> +<!ENTITY % sect2.role.attrib "%role.attrib;"> + +<!ENTITY % sect2.element "INCLUDE"> +<![%sect2.element;[ +<!--doc:A subsection within a Sect1.--> +<!ELEMENT sect2 %ho; (sect2info?, (%sect.title.content;), (%nav.class;)*, + (((%divcomponent.mix;)+, + ((%refentry.class;)* | sect3* | simplesect*)) + | (%refentry.class;)+ | sect3+ | simplesect+), (%nav.class;)*)> +<!--end of sect2.element-->]]> + +<!-- Renderas: Indicates the format in which the heading should + appear --> + + +<!ENTITY % sect2.attlist "INCLUDE"> +<![%sect2.attlist;[ +<!ATTLIST sect2 + renderas (sect1 + |sect3 + |sect4 + |sect5) #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %sect2.role.attrib; + %local.sect2.attrib; +> +<!--end of sect2.attlist-->]]> +<!--end of sect2.module-->]]> + +<!ENTITY % sect3.module "INCLUDE"> +<![%sect3.module;[ +<!ENTITY % local.sect3.attrib ""> +<!ENTITY % sect3.role.attrib "%role.attrib;"> + +<!ENTITY % sect3.element "INCLUDE"> +<![%sect3.element;[ +<!--doc:A subsection within a Sect2.--> +<!ELEMENT sect3 %ho; (sect3info?, (%sect.title.content;), (%nav.class;)*, + (((%divcomponent.mix;)+, + ((%refentry.class;)* | sect4* | simplesect*)) + | (%refentry.class;)+ | sect4+ | simplesect+), (%nav.class;)*)> +<!--end of sect3.element-->]]> + +<!-- Renderas: Indicates the format in which the heading should + appear --> + + +<!ENTITY % sect3.attlist "INCLUDE"> +<![%sect3.attlist;[ +<!ATTLIST sect3 + renderas (sect1 + |sect2 + |sect4 + |sect5) #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %sect3.role.attrib; + %local.sect3.attrib; +> +<!--end of sect3.attlist-->]]> +<!--end of sect3.module-->]]> + +<!ENTITY % sect4.module "INCLUDE"> +<![%sect4.module;[ +<!ENTITY % local.sect4.attrib ""> +<!ENTITY % sect4.role.attrib "%role.attrib;"> + +<!ENTITY % sect4.element "INCLUDE"> +<![%sect4.element;[ +<!--doc:A subsection within a Sect3.--> +<!ELEMENT sect4 %ho; (sect4info?, (%sect.title.content;), (%nav.class;)*, + (((%divcomponent.mix;)+, + ((%refentry.class;)* | sect5* | simplesect*)) + | (%refentry.class;)+ | sect5+ | simplesect+), (%nav.class;)*)> +<!--end of sect4.element-->]]> + +<!-- Renderas: Indicates the format in which the heading should + appear --> + + +<!ENTITY % sect4.attlist "INCLUDE"> +<![%sect4.attlist;[ +<!ATTLIST sect4 + renderas (sect1 + |sect2 + |sect3 + |sect5) #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %sect4.role.attrib; + %local.sect4.attrib; +> +<!--end of sect4.attlist-->]]> +<!--end of sect4.module-->]]> + +<!ENTITY % sect5.module "INCLUDE"> +<![%sect5.module;[ +<!ENTITY % local.sect5.attrib ""> +<!ENTITY % sect5.role.attrib "%role.attrib;"> + +<!ENTITY % sect5.element "INCLUDE"> +<![%sect5.element;[ +<!--doc:A subsection within a Sect4.--> +<!ELEMENT sect5 %ho; (sect5info?, (%sect.title.content;), (%nav.class;)*, + (((%divcomponent.mix;)+, ((%refentry.class;)* | simplesect*)) + | (%refentry.class;)+ | simplesect+), (%nav.class;)*)> +<!--end of sect5.element-->]]> + +<!-- Renderas: Indicates the format in which the heading should + appear --> + + +<!ENTITY % sect5.attlist "INCLUDE"> +<![%sect5.attlist;[ +<!ATTLIST sect5 + renderas (sect1 + |sect2 + |sect3 + |sect4) #IMPLIED + %label.attrib; + %status.attrib; + %common.attrib; + %sect5.role.attrib; + %local.sect5.attrib; +> +<!--end of sect5.attlist-->]]> +<!--end of sect5.module-->]]> + +<!ENTITY % simplesect.module "INCLUDE"> +<![%simplesect.module;[ +<!ENTITY % local.simplesect.attrib ""> +<!ENTITY % simplesect.role.attrib "%role.attrib;"> + +<!ENTITY % simplesect.element "INCLUDE"> +<![%simplesect.element;[ +<!--doc:A section of a document with no subdivisions.--> +<!ELEMENT simplesect %ho; ((%sect.title.content;), (%divcomponent.mix;)+) + %ubiq.inclusion;> +<!--end of simplesect.element-->]]> + +<!ENTITY % simplesect.attlist "INCLUDE"> +<![%simplesect.attlist;[ +<!ATTLIST simplesect + %common.attrib; + %simplesect.role.attrib; + %local.simplesect.attrib; +> +<!--end of simplesect.attlist-->]]> +<!--end of simplesect.module-->]]> + +<!-- ...................................................................... --> +<!-- Bibliography ......................................................... --> + +<!ENTITY % bibliography.content.module "INCLUDE"> +<![%bibliography.content.module;[ +<!ENTITY % bibliography.module "INCLUDE"> +<![%bibliography.module;[ +<!ENTITY % local.bibliography.attrib ""> +<!ENTITY % bibliography.role.attrib "%role.attrib;"> + +<!ENTITY % bibliography.element "INCLUDE"> +<![%bibliography.element;[ +<!--doc:A bibliography.--> +<!ELEMENT bibliography %ho; (bibliographyinfo?, + (%bookcomponent.title.content;)?, + (%component.mix;)*, + (bibliodiv+ | (biblioentry|bibliomixed)+))> +<!--end of bibliography.element-->]]> + +<!ENTITY % bibliography.attlist "INCLUDE"> +<![%bibliography.attlist;[ +<!ATTLIST bibliography + %status.attrib; + %common.attrib; + %bibliography.role.attrib; + %local.bibliography.attrib; +> +<!--end of bibliography.attlist-->]]> +<!--end of bibliography.module-->]]> + +<!ENTITY % bibliodiv.module "INCLUDE"> +<![%bibliodiv.module;[ +<!ENTITY % local.bibliodiv.attrib ""> +<!ENTITY % bibliodiv.role.attrib "%role.attrib;"> + +<!ENTITY % bibliodiv.element "INCLUDE"> +<![%bibliodiv.element;[ +<!--doc:A section of a Bibliography.--> +<!ELEMENT bibliodiv %ho; ((%sect.title.content;)?, (%component.mix;)*, + (biblioentry|bibliomixed)+)> +<!--end of bibliodiv.element-->]]> + +<!ENTITY % bibliodiv.attlist "INCLUDE"> +<![%bibliodiv.attlist;[ +<!ATTLIST bibliodiv + %status.attrib; + %common.attrib; + %bibliodiv.role.attrib; + %local.bibliodiv.attrib; +> +<!--end of bibliodiv.attlist-->]]> +<!--end of bibliodiv.module-->]]> +<!--end of bibliography.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Glossary ............................................................. --> + +<!ENTITY % glossary.content.module "INCLUDE"> +<![%glossary.content.module;[ +<!ENTITY % glossary.module "INCLUDE"> +<![%glossary.module;[ +<!ENTITY % local.glossary.attrib ""> +<!ENTITY % glossary.role.attrib "%role.attrib;"> + +<!ENTITY % glossary.element "INCLUDE"> +<![%glossary.element;[ +<!--doc:A glossary.--> +<!ELEMENT glossary %ho; (glossaryinfo?, + (%bookcomponent.title.content;)?, + (%component.mix;)*, + (glossdiv+ | glossentry+), bibliography?)> +<!--end of glossary.element-->]]> + +<!ENTITY % glossary.attlist "INCLUDE"> +<![%glossary.attlist;[ +<!ATTLIST glossary + %status.attrib; + %common.attrib; + %glossary.role.attrib; + %local.glossary.attrib; +> +<!--end of glossary.attlist-->]]> +<!--end of glossary.module-->]]> + +<!ENTITY % glossdiv.module "INCLUDE"> +<![%glossdiv.module;[ +<!ENTITY % local.glossdiv.attrib ""> +<!ENTITY % glossdiv.role.attrib "%role.attrib;"> + +<!ENTITY % glossdiv.element "INCLUDE"> +<![%glossdiv.element;[ +<!--doc:A division in a Glossary.--> +<!ELEMENT glossdiv %ho; ((%sect.title.content;), (%component.mix;)*, + glossentry+)> +<!--end of glossdiv.element-->]]> + +<!ENTITY % glossdiv.attlist "INCLUDE"> +<![%glossdiv.attlist;[ +<!ATTLIST glossdiv + %status.attrib; + %common.attrib; + %glossdiv.role.attrib; + %local.glossdiv.attrib; +> +<!--end of glossdiv.attlist-->]]> +<!--end of glossdiv.module-->]]> +<!--end of glossary.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Index and SetIndex ................................................... --> + +<!ENTITY % index.content.module "INCLUDE"> +<![%index.content.module;[ +<!ENTITY % indexes.module "INCLUDE"> +<![%indexes.module;[ +<!ENTITY % local.indexes.attrib ""> +<!ENTITY % indexes.role.attrib "%role.attrib;"> + +<!ENTITY % index.element "INCLUDE"> +<![%index.element;[ +<!--doc:An index.--> +<!ELEMENT index %ho; (indexinfo?, + (%bookcomponent.title.content;)?, + (%component.mix;)*, + (indexdiv* | indexentry*)) + %ndxterm.exclusion;> +<!--end of index.element-->]]> + +<!ENTITY % index.attlist "INCLUDE"> +<![%index.attlist;[ +<!ATTLIST index + type CDATA #IMPLIED + %common.attrib; + %indexes.role.attrib; + %local.indexes.attrib; +> +<!--end of index.attlist-->]]> + +<!ENTITY % setindex.element "INCLUDE"> +<![%setindex.element;[ +<!--doc:An index to a set of books.--> +<!ELEMENT setindex %ho; (setindexinfo?, + (%bookcomponent.title.content;)?, + (%component.mix;)*, + (indexdiv* | indexentry*)) + %ndxterm.exclusion;> +<!--end of setindex.element-->]]> + +<!ENTITY % setindex.attlist "INCLUDE"> +<![%setindex.attlist;[ +<!ATTLIST setindex + %common.attrib; + %indexes.role.attrib; + %local.indexes.attrib; +> +<!--end of setindex.attlist-->]]> +<!--end of indexes.module-->]]> + +<!ENTITY % indexdiv.module "INCLUDE"> +<![%indexdiv.module;[ + +<!-- SegmentedList in this content is useful for marking up permuted + indices. --> + +<!ENTITY % local.indexdiv.attrib ""> +<!ENTITY % indexdiv.role.attrib "%role.attrib;"> + +<!ENTITY % indexdiv.element "INCLUDE"> +<![%indexdiv.element;[ +<!--doc:A division in an index.--> +<!ELEMENT indexdiv %ho; ((%sect.title.content;)?, ((%indexdivcomponent.mix;)*, + (indexentry+ | segmentedlist)))> +<!--end of indexdiv.element-->]]> + +<!ENTITY % indexdiv.attlist "INCLUDE"> +<![%indexdiv.attlist;[ +<!ATTLIST indexdiv + %common.attrib; + %indexdiv.role.attrib; + %local.indexdiv.attrib; +> +<!--end of indexdiv.attlist-->]]> +<!--end of indexdiv.module-->]]> + +<!ENTITY % indexentry.module "INCLUDE"> +<![%indexentry.module;[ +<!-- Index entries appear in the index, not the text. --> + +<!ENTITY % local.indexentry.attrib ""> +<!ENTITY % indexentry.role.attrib "%role.attrib;"> + +<!ENTITY % indexentry.element "INCLUDE"> +<![%indexentry.element;[ +<!--doc:An entry in an index.--> +<!ELEMENT indexentry %ho; (primaryie, (seeie|seealsoie)*, + (secondaryie, (seeie|seealsoie|tertiaryie)*)*)> +<!--end of indexentry.element-->]]> + +<!ENTITY % indexentry.attlist "INCLUDE"> +<![%indexentry.attlist;[ +<!ATTLIST indexentry + %common.attrib; + %indexentry.role.attrib; + %local.indexentry.attrib; +> +<!--end of indexentry.attlist-->]]> +<!--end of indexentry.module-->]]> + +<!ENTITY % primsecterie.module "INCLUDE"> +<![%primsecterie.module;[ +<!ENTITY % local.primsecterie.attrib ""> +<!ENTITY % primsecterie.role.attrib "%role.attrib;"> + +<!ENTITY % primaryie.element "INCLUDE"> +<![%primaryie.element;[ +<!--doc:A primary term in an index entry, not in the text.--> +<!ELEMENT primaryie %ho; (%ndxterm.char.mix;)*> +<!--end of primaryie.element-->]]> + +<!-- to IndexTerms that these entries represent --> + +<!ENTITY % primaryie.attlist "INCLUDE"> +<![%primaryie.attlist;[ +<!ATTLIST primaryie + %linkends.attrib; %common.attrib; + %primsecterie.role.attrib; + %local.primsecterie.attrib; +> +<!--end of primaryie.attlist-->]]> + +<!ENTITY % secondaryie.element "INCLUDE"> +<![%secondaryie.element;[ +<!--doc:A secondary term in an index entry, rather than in the text.--> +<!ELEMENT secondaryie %ho; (%ndxterm.char.mix;)*> +<!--end of secondaryie.element-->]]> + +<!-- to IndexTerms that these entries represent --> + +<!ENTITY % secondaryie.attlist "INCLUDE"> +<![%secondaryie.attlist;[ +<!ATTLIST secondaryie + %linkends.attrib; %common.attrib; + %primsecterie.role.attrib; + %local.primsecterie.attrib; +> +<!--end of secondaryie.attlist-->]]> + +<!ENTITY % tertiaryie.element "INCLUDE"> +<![%tertiaryie.element;[ +<!--doc:A tertiary term in an index entry, rather than in the text.--> +<!ELEMENT tertiaryie %ho; (%ndxterm.char.mix;)*> +<!--end of tertiaryie.element-->]]> + +<!-- to IndexTerms that these entries represent --> + +<!ENTITY % tertiaryie.attlist "INCLUDE"> +<![%tertiaryie.attlist;[ +<!ATTLIST tertiaryie + %linkends.attrib; %common.attrib; + %primsecterie.role.attrib; + %local.primsecterie.attrib; +> +<!--end of tertiaryie.attlist-->]]> + +<!--end of primsecterie.module-->]]> + +<!ENTITY % seeie.module "INCLUDE"> +<![%seeie.module;[ +<!ENTITY % local.seeie.attrib ""> +<!ENTITY % seeie.role.attrib "%role.attrib;"> + +<!ENTITY % seeie.element "INCLUDE"> +<![%seeie.element;[ +<!--doc:A See entry in an index, rather than in the text.--> +<!ELEMENT seeie %ho; (%ndxterm.char.mix;)*> +<!--end of seeie.element-->]]> + +<!-- to IndexEntry to look up --> + + +<!ENTITY % seeie.attlist "INCLUDE"> +<![%seeie.attlist;[ +<!ATTLIST seeie + %linkend.attrib; %common.attrib; + %seeie.role.attrib; + %local.seeie.attrib; +> +<!--end of seeie.attlist-->]]> +<!--end of seeie.module-->]]> + +<!ENTITY % seealsoie.module "INCLUDE"> +<![%seealsoie.module;[ +<!ENTITY % local.seealsoie.attrib ""> +<!ENTITY % seealsoie.role.attrib "%role.attrib;"> + +<!ENTITY % seealsoie.element "INCLUDE"> +<![%seealsoie.element;[ +<!--doc:A See also entry in an index, rather than in the text.--> +<!ELEMENT seealsoie %ho; (%ndxterm.char.mix;)*> +<!--end of seealsoie.element-->]]> + +<!-- to related IndexEntries --> + + +<!ENTITY % seealsoie.attlist "INCLUDE"> +<![%seealsoie.attlist;[ +<!ATTLIST seealsoie + %linkends.attrib; %common.attrib; + %seealsoie.role.attrib; + %local.seealsoie.attrib; +> +<!--end of seealsoie.attlist-->]]> +<!--end of seealsoie.module-->]]> +<!--end of index.content.module-->]]> + +<!-- ...................................................................... --> +<!-- RefEntry ............................................................. --> + +<!ENTITY % refentry.content.module "INCLUDE"> +<![%refentry.content.module;[ +<!ENTITY % refentry.module "INCLUDE"> +<![%refentry.module;[ +<!ENTITY % local.refentry.attrib ""> +<!ENTITY % refentry.role.attrib "%role.attrib;"> + +<!ENTITY % refentry.element "INCLUDE"> +<![%refentry.element;[ +<!--doc:A reference page (originally a UNIX man-style reference page).--> +<!ELEMENT refentry %ho; (beginpage?, + (%ndxterm.class;)*, + refentryinfo?, refmeta?, (remark|%link.char.class;)*, + refnamediv+, refsynopsisdiv?, (refsect1+|refsection+)) + %ubiq.inclusion;> +<!--end of refentry.element-->]]> + +<!ENTITY % refentry.attlist "INCLUDE"> +<![%refentry.attlist;[ +<!ATTLIST refentry + %status.attrib; + %common.attrib; + %refentry.role.attrib; + %local.refentry.attrib; +> +<!--end of refentry.attlist-->]]> +<!--end of refentry.module-->]]> + +<!ENTITY % refmeta.module "INCLUDE"> +<![%refmeta.module;[ +<!ENTITY % local.refmeta.attrib ""> +<!ENTITY % refmeta.role.attrib "%role.attrib;"> + +<!ENTITY % refmeta.element "INCLUDE"> +<![%refmeta.element;[ +<!--doc:Meta-information for a reference entry.--> +<!ELEMENT refmeta %ho; ((%ndxterm.class;)*, + refentrytitle, manvolnum?, refmiscinfo*, + (%ndxterm.class;)*) + %beginpage.exclusion;> +<!--end of refmeta.element-->]]> + +<!ENTITY % refmeta.attlist "INCLUDE"> +<![%refmeta.attlist;[ +<!ATTLIST refmeta + %common.attrib; + %refmeta.role.attrib; + %local.refmeta.attrib; +> +<!--end of refmeta.attlist-->]]> +<!--end of refmeta.module-->]]> + +<!ENTITY % refmiscinfo.module "INCLUDE"> +<![%refmiscinfo.module;[ +<!ENTITY % local.refmiscinfo.attrib ""> +<!ENTITY % refmiscinfo.role.attrib "%role.attrib;"> + +<!ENTITY % refmiscinfo.element "INCLUDE"> +<![%refmiscinfo.element;[ +<!--doc:Meta-information for a reference entry other than the title and volume number.--> +<!ELEMENT refmiscinfo %ho; (%docinfo.char.mix;)*> +<!--end of refmiscinfo.element-->]]> + +<!-- Class: Freely assignable parameter; no default --> + + +<!ENTITY % refmiscinfo.attlist "INCLUDE"> +<![%refmiscinfo.attlist;[ +<!ATTLIST refmiscinfo + class CDATA #IMPLIED + %common.attrib; + %refmiscinfo.role.attrib; + %local.refmiscinfo.attrib; +> +<!--end of refmiscinfo.attlist-->]]> +<!--end of refmiscinfo.module-->]]> + +<!ENTITY % refnamediv.module "INCLUDE"> +<![%refnamediv.module;[ +<!ENTITY % local.refnamediv.attrib ""> +<!ENTITY % refnamediv.role.attrib "%role.attrib;"> + +<!ENTITY % refnamediv.element "INCLUDE"> +<![%refnamediv.element;[ +<!--doc:The name, purpose, and classification of a reference page.--> +<!ELEMENT refnamediv %ho; (refdescriptor?, refname+, refpurpose, refclass*, + (remark|%link.char.class;)*)> +<!--end of refnamediv.element-->]]> + +<!ENTITY % refnamediv.attlist "INCLUDE"> +<![%refnamediv.attlist;[ +<!ATTLIST refnamediv + %common.attrib; + %refnamediv.role.attrib; + %local.refnamediv.attrib; +> +<!--end of refnamediv.attlist-->]]> +<!--end of refnamediv.module-->]]> + +<!ENTITY % refdescriptor.module "INCLUDE"> +<![%refdescriptor.module;[ +<!ENTITY % local.refdescriptor.attrib ""> +<!ENTITY % refdescriptor.role.attrib "%role.attrib;"> + +<!ENTITY % refdescriptor.element "INCLUDE"> +<![%refdescriptor.element;[ +<!--doc:A description of the topic of a reference page.--> +<!ELEMENT refdescriptor %ho; (%refname.char.mix;)*> +<!--end of refdescriptor.element-->]]> + +<!ENTITY % refdescriptor.attlist "INCLUDE"> +<![%refdescriptor.attlist;[ +<!ATTLIST refdescriptor + %common.attrib; + %refdescriptor.role.attrib; + %local.refdescriptor.attrib; +> +<!--end of refdescriptor.attlist-->]]> +<!--end of refdescriptor.module-->]]> + +<!ENTITY % refname.module "INCLUDE"> +<![%refname.module;[ +<!ENTITY % local.refname.attrib ""> +<!ENTITY % refname.role.attrib "%role.attrib;"> + +<!ENTITY % refname.element "INCLUDE"> +<![%refname.element;[ +<!--doc:The name of (one of) the subject(s) of a reference page.--> +<!ELEMENT refname %ho; (%refname.char.mix;)*> +<!--end of refname.element-->]]> + +<!ENTITY % refname.attlist "INCLUDE"> +<![%refname.attlist;[ +<!ATTLIST refname + %common.attrib; + %refname.role.attrib; + %local.refname.attrib; +> +<!--end of refname.attlist-->]]> +<!--end of refname.module-->]]> + +<!ENTITY % refpurpose.module "INCLUDE"> +<![%refpurpose.module;[ +<!ENTITY % local.refpurpose.attrib ""> +<!ENTITY % refpurpose.role.attrib "%role.attrib;"> + +<!ENTITY % refpurpose.element "INCLUDE"> +<![%refpurpose.element;[ +<!--doc:A short (one sentence) synopsis of the topic of a reference page.--> +<!ELEMENT refpurpose %ho; (%refinline.char.mix;)*> +<!--end of refpurpose.element-->]]> + +<!ENTITY % refpurpose.attlist "INCLUDE"> +<![%refpurpose.attlist;[ +<!ATTLIST refpurpose + %common.attrib; + %refpurpose.role.attrib; + %local.refpurpose.attrib; +> +<!--end of refpurpose.attlist-->]]> +<!--end of refpurpose.module-->]]> + +<!ENTITY % refclass.module "INCLUDE"> +<![%refclass.module;[ +<!ENTITY % local.refclass.attrib ""> +<!ENTITY % refclass.role.attrib "%role.attrib;"> + +<!ENTITY % refclass.element "INCLUDE"> +<![%refclass.element;[ +<!--doc:The scope or other indication of applicability of a reference entry.--> +<!ELEMENT refclass %ho; (%refclass.char.mix;)*> +<!--end of refclass.element-->]]> + +<!ENTITY % refclass.attlist "INCLUDE"> +<![%refclass.attlist;[ +<!ATTLIST refclass + %common.attrib; + %refclass.role.attrib; + %local.refclass.attrib; +> +<!--end of refclass.attlist-->]]> +<!--end of refclass.module-->]]> + +<!ENTITY % refsynopsisdiv.module "INCLUDE"> +<![%refsynopsisdiv.module;[ +<!ENTITY % local.refsynopsisdiv.attrib ""> +<!ENTITY % refsynopsisdiv.role.attrib "%role.attrib;"> + +<!ENTITY % refsynopsisdiv.element "INCLUDE"> +<![%refsynopsisdiv.element;[ +<!--doc:A syntactic synopsis of the subject of the reference page.--> +<!ELEMENT refsynopsisdiv %ho; (refsynopsisdivinfo?, (%refsect.title.content;)?, + (((%refcomponent.mix;)+, refsect2*) | (refsect2+)))> +<!--end of refsynopsisdiv.element-->]]> + +<!ENTITY % refsynopsisdiv.attlist "INCLUDE"> +<![%refsynopsisdiv.attlist;[ +<!ATTLIST refsynopsisdiv + %common.attrib; + %refsynopsisdiv.role.attrib; + %local.refsynopsisdiv.attrib; +> +<!--end of refsynopsisdiv.attlist-->]]> +<!--end of refsynopsisdiv.module-->]]> + +<!ENTITY % refsection.module "INCLUDE"> +<![%refsection.module;[ +<!ENTITY % local.refsection.attrib ""> +<!ENTITY % refsection.role.attrib "%role.attrib;"> + +<!ENTITY % refsection.element "INCLUDE"> +<![%refsection.element;[ +<!--doc:A recursive section in a refentry.--> +<!ELEMENT refsection %ho; (refsectioninfo?, (%refsect.title.content;), + (((%refcomponent.mix;)+, refsection*) | refsection+))> +<!--end of refsection.element-->]]> + +<!ENTITY % refsection.attlist "INCLUDE"> +<![%refsection.attlist;[ +<!ATTLIST refsection + %status.attrib; + %common.attrib; + %refsection.role.attrib; + %local.refsection.attrib; +> +<!--end of refsection.attlist-->]]> +<!--end of refsection.module-->]]> + +<!ENTITY % refsect1.module "INCLUDE"> +<![%refsect1.module;[ +<!ENTITY % local.refsect1.attrib ""> +<!ENTITY % refsect1.role.attrib "%role.attrib;"> + +<!ENTITY % refsect1.element "INCLUDE"> +<![%refsect1.element;[ +<!--doc:A major subsection of a reference entry.--> +<!ELEMENT refsect1 %ho; (refsect1info?, (%refsect.title.content;), + (((%refcomponent.mix;)+, refsect2*) | refsect2+))> +<!--end of refsect1.element-->]]> + +<!ENTITY % refsect1.attlist "INCLUDE"> +<![%refsect1.attlist;[ +<!ATTLIST refsect1 + %status.attrib; + %common.attrib; + %refsect1.role.attrib; + %local.refsect1.attrib; +> +<!--end of refsect1.attlist-->]]> +<!--end of refsect1.module-->]]> + +<!ENTITY % refsect2.module "INCLUDE"> +<![%refsect2.module;[ +<!ENTITY % local.refsect2.attrib ""> +<!ENTITY % refsect2.role.attrib "%role.attrib;"> + +<!ENTITY % refsect2.element "INCLUDE"> +<![%refsect2.element;[ +<!--doc:A subsection of a RefSect1.--> +<!ELEMENT refsect2 %ho; (refsect2info?, (%refsect.title.content;), + (((%refcomponent.mix;)+, refsect3*) | refsect3+))> +<!--end of refsect2.element-->]]> + +<!ENTITY % refsect2.attlist "INCLUDE"> +<![%refsect2.attlist;[ +<!ATTLIST refsect2 + %status.attrib; + %common.attrib; + %refsect2.role.attrib; + %local.refsect2.attrib; +> +<!--end of refsect2.attlist-->]]> +<!--end of refsect2.module-->]]> + +<!ENTITY % refsect3.module "INCLUDE"> +<![%refsect3.module;[ +<!ENTITY % local.refsect3.attrib ""> +<!ENTITY % refsect3.role.attrib "%role.attrib;"> + +<!ENTITY % refsect3.element "INCLUDE"> +<![%refsect3.element;[ +<!--doc:A subsection of a RefSect2.--> +<!ELEMENT refsect3 %ho; (refsect3info?, (%refsect.title.content;), + (%refcomponent.mix;)+)> +<!--end of refsect3.element-->]]> + +<!ENTITY % refsect3.attlist "INCLUDE"> +<![%refsect3.attlist;[ +<!ATTLIST refsect3 + %status.attrib; + %common.attrib; + %refsect3.role.attrib; + %local.refsect3.attrib; +> +<!--end of refsect3.attlist-->]]> +<!--end of refsect3.module-->]]> +<!--end of refentry.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Article .............................................................. --> + +<!ENTITY % article.module "INCLUDE"> +<![%article.module;[ +<!-- An Article is a chapter-level, stand-alone document that is often, + but need not be, collected into a Book. --> + +<!ENTITY % local.article.attrib ""> +<!ENTITY % article.role.attrib "%role.attrib;"> + +<!ENTITY % article.element "INCLUDE"> +<![%article.element;[ +<!--doc:An article.--> +<!ELEMENT article %ho; ((%div.title.content;)?, articleinfo?, tocchap?, lot*, + (%bookcomponent.content;), + (%nav.class;|%appendix.class;|colophon|ackno)*) + %ubiq.inclusion;> +<!--end of article.element-->]]> + +<!-- Class: Indicates the type of a particular article; + all articles have the same structure and general purpose. + No default. --> +<!-- ParentBook: ID of the enclosing Book --> + + +<!ENTITY % article.attlist "INCLUDE"> +<![%article.attlist;[ +<!ATTLIST article + class (journalarticle + |productsheet + |whitepaper + |techreport + |specification + |faq) #IMPLIED + parentbook IDREF #IMPLIED + %status.attrib; + %common.attrib; + %article.role.attrib; + %local.article.attrib; +> +<!--end of article.attlist-->]]> +<!--end of article.module-->]]> + +<!-- End of DocBook document hierarchy module V4.5 ........................ --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/dbnotnx.mod b/doc/creating_themes/C/dbnotnx.mod new file mode 100644 index 00000000..2416049b --- /dev/null +++ b/doc/creating_themes/C/dbnotnx.mod @@ -0,0 +1,101 @@ +<!-- ...................................................................... --> +<!-- DocBook notations module V4.5 ........................................ --> +<!-- File dbnotnx.mod ..................................................... --> + +<!-- Copyright 1992-2004 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + $Id: dbnotnx.mod 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the notation declarations used by DocBook. + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % dbnotn PUBLIC + "-//OASIS//ENTITIES DocBook Notations V4.5//EN" + "dbnotnx.mod"> + %dbnotn; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!ENTITY % local.notation.class ""> +<!ENTITY % notation.class + "BMP| CGM-CHAR | CGM-BINARY | CGM-CLEAR | DITROFF | DVI + | EPS | EQN | FAX | GIF | GIF87a | GIF89a + | JPG | JPEG | IGES | PCX + | PIC | PNG | PS | SGML | TBL | TEX | TIFF | WMF | WPG + | SVG | PDF | SWF + | linespecific + %local.notation.class;"> + +<!NOTATION BMP PUBLIC +"+//ISBN 0-7923-94.2-1::Graphic Notation//NOTATION Microsoft Windows bitmap//EN"> +<!NOTATION CGM-CHAR PUBLIC "ISO 8632/2//NOTATION Character encoding//EN"> +<!NOTATION CGM-BINARY PUBLIC "ISO 8632/3//NOTATION Binary encoding//EN"> +<!NOTATION CGM-CLEAR PUBLIC "ISO 8632/4//NOTATION Clear text encoding//EN"> +<!NOTATION DITROFF SYSTEM "DITROFF"> +<!NOTATION DVI SYSTEM "DVI"> +<!NOTATION EPS PUBLIC +"+//ISBN 0-201-18127-4::Adobe//NOTATION PostScript Language Ref. Manual//EN"> +<!NOTATION EQN SYSTEM "EQN"> +<!NOTATION FAX PUBLIC +"-//USA-DOD//NOTATION CCITT Group 4 Facsimile Type 1 Untiled Raster//EN"> +<!NOTATION GIF SYSTEM "GIF"> +<!NOTATION GIF87a PUBLIC +"-//CompuServe//NOTATION Graphics Interchange Format 87a//EN"> + +<!NOTATION GIF89a PUBLIC +"-//CompuServe//NOTATION Graphics Interchange Format 89a//EN"> +<!NOTATION JPG SYSTEM "JPG"> +<!NOTATION JPEG SYSTEM "JPG"> +<!NOTATION IGES PUBLIC +"-//USA-DOD//NOTATION (ASME/ANSI Y14.26M-1987) Initial Graphics Exchange Specification//EN"> +<!NOTATION PCX PUBLIC +"+//ISBN 0-7923-94.2-1::Graphic Notation//NOTATION ZSoft PCX bitmap//EN"> +<!NOTATION PIC SYSTEM "PIC"> +<!NOTATION PNG SYSTEM "http://www.w3.org/TR/REC-png"> +<!NOTATION PS SYSTEM "PS"> +<!NOTATION SGML PUBLIC +"ISO 8879:1986//NOTATION Standard Generalized Markup Language//EN"> +<!NOTATION TBL SYSTEM "TBL"> +<!NOTATION TEX PUBLIC +"+//ISBN 0-201-13448-9::Knuth//NOTATION The TeXbook//EN"> +<!NOTATION TIFF SYSTEM "TIFF"> +<!NOTATION WMF PUBLIC +"+//ISBN 0-7923-94.2-1::Graphic Notation//NOTATION Microsoft Windows Metafile//EN"> +<!NOTATION WPG SYSTEM "WPG"> <!--WordPerfect Graphic format--> +<!NOTATION SVG SYSTEM "http://www.w3.org/TR/SVG/"> +<!NOTATION PDF SYSTEM "http://www.adobe.com/products/acrobat/adobepdf.html"> +<!NOTATION SWF SYSTEM "http://www.macromedia.com/software/flash"> +<!NOTATION linespecific SYSTEM "linespecific"> + +<!-- End of DocBook notations module V4.5 ................................. --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/dbpoolx.mod b/doc/creating_themes/C/dbpoolx.mod new file mode 100644 index 00000000..53b07044 --- /dev/null +++ b/doc/creating_themes/C/dbpoolx.mod @@ -0,0 +1,8701 @@ +<!-- ...................................................................... --> +<!-- DocBook XML information pool module V4.5 ............................. --> +<!-- File dbpoolx.mod ..................................................... --> + +<!-- Copyright 1992-2004 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + $Id: dbpoolx.mod 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook XML DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook XML DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the definitions for the objects, inline + elements, and so on that are available to be used as the main + content of DocBook documents. Some elements are useful for general + publishing, and others are useful specifically for computer + documentation. + + This module has the following dependencies on other modules: + + o It assumes that a %notation.class; entity is defined by the + driver file or other high-level module. This entity is + referenced in the NOTATION attributes for the graphic-related and + ModeSpec elements. + + o It assumes that an appropriately parameterized table module is + available for use with the table-related elements. + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % dbpool PUBLIC + "-//OASIS//ELEMENTS DocBook XML Information Pool V4.5//EN" + "dbpoolx.mod"> + %dbpool; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!-- ...................................................................... --> +<!-- Forms entities ....................................................... --> +<!-- These PEs provide the hook by which the forms module can be inserted --> +<!-- into the DTD. --> +<!ENTITY % forminlines.hook ""> +<!ENTITY % forms.hook ""> + +<!-- ...................................................................... --> +<!-- General-purpose semantics entities ................................... --> + +<!ENTITY % yesorno.attvals "CDATA"> + +<!-- ...................................................................... --> +<!-- Entities for module inclusions ....................................... --> + +<!ENTITY % dbpool.redecl.module "IGNORE"> + +<!-- ...................................................................... --> +<!-- Entities for element classes and mixtures ............................ --> + +<!-- "Ubiquitous" classes: ndxterm.class and beginpage --> + +<!ENTITY % local.ndxterm.class ""> +<!ENTITY % ndxterm.class + "indexterm %local.ndxterm.class;"> + +<!-- Object-level classes ................................................. --> + +<!ENTITY % local.list.class ""> +<!ENTITY % list.class + "calloutlist|glosslist|bibliolist|itemizedlist|orderedlist|segmentedlist + |simplelist|variablelist %local.list.class;"> + +<!ENTITY % local.admon.class ""> +<!ENTITY % admon.class + "caution|important|note|tip|warning %local.admon.class;"> + +<!ENTITY % local.linespecific.class ""> +<!ENTITY % linespecific.class + "literallayout|programlisting|programlistingco|screen + |screenco|screenshot %local.linespecific.class;"> + +<!ENTITY % local.method.synop.class ""> +<!ENTITY % method.synop.class + "constructorsynopsis + |destructorsynopsis + |methodsynopsis %local.method.synop.class;"> + +<!ENTITY % local.synop.class ""> +<!ENTITY % synop.class + "synopsis|cmdsynopsis|funcsynopsis + |classsynopsis|fieldsynopsis + |%method.synop.class; %local.synop.class;"> + +<!ENTITY % local.para.class ""> +<!ENTITY % para.class + "formalpara|para|simpara %local.para.class;"> + +<!ENTITY % local.informal.class ""> +<!ENTITY % informal.class + "address|blockquote + |graphic|graphicco|mediaobject|mediaobjectco + |informalequation + |informalexample + |informalfigure + |informaltable %local.informal.class;"> + +<!ENTITY % local.formal.class ""> +<!ENTITY % formal.class + "equation|example|figure|table %local.formal.class;"> + +<!-- The DocBook TC may produce an official EBNF module for DocBook. --> +<!-- This PE provides the hook by which it can be inserted into the DTD. --> +<!ENTITY % ebnf.block.hook ""> + +<!ENTITY % local.compound.class ""> +<!ENTITY % compound.class + "msgset|procedure|sidebar|qandaset|task + %ebnf.block.hook; + %local.compound.class;"> + +<!ENTITY % local.genobj.class ""> +<!ENTITY % genobj.class + "anchor|bridgehead|remark|highlights + %local.genobj.class;"> + +<!ENTITY % local.descobj.class ""> +<!ENTITY % descobj.class + "abstract|authorblurb|epigraph + %local.descobj.class;"> + +<!-- Character-level classes .............................................. --> + +<!ENTITY % local.xref.char.class ""> +<!ENTITY % xref.char.class + "footnoteref|xref|biblioref %local.xref.char.class;"> + +<!ENTITY % local.gen.char.class ""> +<!ENTITY % gen.char.class + "abbrev|acronym|citation|citerefentry|citetitle|citebiblioid|emphasis + |firstterm|foreignphrase|glossterm|termdef|footnote|phrase + |orgname|quote|trademark|wordasword + |personname %local.gen.char.class;"> + +<!ENTITY % local.link.char.class ""> +<!ENTITY % link.char.class + "link|olink|ulink %local.link.char.class;"> + +<!-- The DocBook TC may produce an official EBNF module for DocBook. --> +<!-- This PE provides the hook by which it can be inserted into the DTD. --> +<!ENTITY % ebnf.inline.hook ""> + +<!ENTITY % local.tech.char.class ""> +<!ENTITY % tech.char.class + "action|application + |classname|methodname|interfacename|exceptionname + |ooclass|oointerface|ooexception + |package + |command|computeroutput + |database|email|envar|errorcode|errorname|errortype|errortext|filename + |function|guibutton|guiicon|guilabel|guimenu|guimenuitem + |guisubmenu|hardware|interface|keycap + |keycode|keycombo|keysym|literal|code|constant|markup|medialabel + |menuchoice|mousebutton|option|optional|parameter + |prompt|property|replaceable|returnvalue|sgmltag|structfield + |structname|symbol|systemitem|uri|token|type|userinput|varname + %ebnf.inline.hook; + %local.tech.char.class;"> + +<!ENTITY % local.base.char.class ""> +<!ENTITY % base.char.class + "anchor %local.base.char.class;"> + +<!ENTITY % local.docinfo.char.class ""> +<!ENTITY % docinfo.char.class + "author|authorinitials|corpauthor|corpcredit|modespec|othercredit + |productname|productnumber|revhistory + %local.docinfo.char.class;"> + +<!ENTITY % local.other.char.class ""> +<!ENTITY % other.char.class + "remark|subscript|superscript %local.other.char.class;"> + +<!ENTITY % local.inlineobj.char.class ""> +<!ENTITY % inlineobj.char.class + "inlinegraphic|inlinemediaobject|inlineequation %local.inlineobj.char.class;"> + +<!-- ...................................................................... --> +<!-- Entities for content models .......................................... --> + +<!ENTITY % formalobject.title.content "title, titleabbrev?"> + +<!-- Redeclaration placeholder ............................................ --> + +<!-- For redeclaring entities that are declared after this point while + retaining their references to the entities that are declared before + this point --> + +<![%dbpool.redecl.module;[ +<!-- Defining rdbpool here makes some buggy XML parsers happy. --> +<!ENTITY % rdbpool ""> +%rdbpool; +<!--end of dbpool.redecl.module-->]]> + +<!-- Object-level mixtures ................................................ --> + +<!-- + list admn line synp para infm form cmpd gen desc +Component mixture X X X X X X X X X X +Sidebar mixture X X X X X X X a X +Footnote mixture X X X X X +Example mixture X X X X X +Highlights mixture X X X +Paragraph mixture X X X X +Admonition mixture X X X X X X b c +Figure mixture X X X +Table entry mixture X X X X d +Glossary def mixture X X X X X e +Legal notice mixture X X X X f + +a. Just Procedure; not Sidebar itself or MsgSet. +b. No MsgSet. +c. No Highlights. +d. Just Graphic; no other informal objects. +e. No Anchor, BridgeHead, or Highlights. +f. Just BlockQuote; no other informal objects. +--> + +<!ENTITY % local.component.mix ""> +<!ENTITY % component.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |%compound.class; + |%genobj.class; |%descobj.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.component.mix;"> + +<!ENTITY % local.sidebar.mix ""> +<!ENTITY % sidebar.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |procedure + |%genobj.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.sidebar.mix;"> + +<!ENTITY % local.qandaset.mix ""> +<!ENTITY % qandaset.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |procedure + |%genobj.class; + |%ndxterm.class; + %forms.hook; + %local.qandaset.mix;"> + +<!ENTITY % local.revdescription.mix ""> +<!ENTITY % revdescription.mix + "%list.class; |%admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |procedure + |%genobj.class; + |%ndxterm.class; + %local.revdescription.mix;"> + +<!ENTITY % local.footnote.mix ""> +<!ENTITY % footnote.mix + "%list.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + %local.footnote.mix;"> + +<!ENTITY % local.example.mix ""> +<!ENTITY % example.mix + "%list.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%ndxterm.class; |beginpage + |procedure + %forms.hook; + %local.example.mix;"> + +<!ENTITY % local.highlights.mix ""> +<!ENTITY % highlights.mix + "%list.class; |%admon.class; + |%para.class; + |%ndxterm.class; + %local.highlights.mix;"> + +<!-- %formal.class; is explicitly excluded from many contexts in which + paragraphs are used --> +<!ENTITY % local.para.mix ""> +<!ENTITY % para.mix + "%list.class; |%admon.class; + |%linespecific.class; + |%informal.class; + |%formal.class; + %local.para.mix;"> + +<!ENTITY % local.admon.mix ""> +<!ENTITY % admon.mix + "%list.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; |procedure|sidebar + |anchor|bridgehead|remark + |%ndxterm.class; |beginpage + %forms.hook; + %local.admon.mix;"> + +<!ENTITY % local.figure.mix ""> +<!ENTITY % figure.mix + "%linespecific.class; |%synop.class; + |%informal.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.figure.mix;"> + +<!ENTITY % local.tabentry.mix ""> +<!ENTITY % tabentry.mix + "%list.class; |%admon.class; + |%linespecific.class; + |%para.class; |graphic|mediaobject + %forms.hook; + %local.tabentry.mix;"> + +<!ENTITY % local.glossdef.mix ""> +<!ENTITY % glossdef.mix + "%list.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%formal.class; + |remark + |%ndxterm.class; |beginpage + %local.glossdef.mix;"> + +<!ENTITY % local.legalnotice.mix ""> +<!ENTITY % legalnotice.mix + "%list.class; |%admon.class; + |%linespecific.class; + |%para.class; |blockquote + |%ndxterm.class; |beginpage + %local.legalnotice.mix;"> + +<!ENTITY % local.textobject.mix ""> +<!ENTITY % textobject.mix + "%list.class; |%admon.class; + |%linespecific.class; + |%para.class; |blockquote + %local.textobject.mix;"> + +<!ENTITY % local.mediaobject.mix ""> +<!ENTITY % mediaobject.mix + "videoobject|audioobject|imageobject|imageobjectco|textobject %local.mediaobject.mix;"> + +<!ENTITY % local.listpreamble.mix ""> +<!ENTITY % listpreamble.mix + " %admon.class; + |%linespecific.class; |%synop.class; + |%para.class; |%informal.class; + |%genobj.class; |%descobj.class; + |%ndxterm.class; |beginpage + %forms.hook; + %local.listpreamble.mix;"> + +<!-- Character-level mixtures ............................................. --> + +<![%sgml.features;[ +<!ENTITY % local.ubiq.mix ""> +<!ENTITY % ubiq.mix "%ndxterm.class;|beginpage %local.ubiq.mix;"> + +<!ENTITY % ubiq.exclusion "-(%ubiq.mix)"> +<!ENTITY % ubiq.inclusion "+(%ubiq.mix)"> + +<!ENTITY % footnote.exclusion "-(footnote|%formal.class;)"> +<!ENTITY % highlights.exclusion "-(%ubiq.mix;|%formal.class;)"> +<!ENTITY % admon.exclusion "-(%admon.class;)"> +<!ENTITY % formal.exclusion "-(%formal.class;)"> +<!ENTITY % acronym.exclusion "-(acronym)"> +<!ENTITY % beginpage.exclusion "-(beginpage)"> +<!ENTITY % ndxterm.exclusion "-(%ndxterm.class;)"> +<!ENTITY % blockquote.exclusion "-(epigraph)"> +<!ENTITY % remark.exclusion "-(remark|%ubiq.mix;)"> +<!ENTITY % glossterm.exclusion "-(glossterm)"> +<!ENTITY % links.exclusion "-(link|olink|ulink|xref|biblioref)"> +]]><!-- sgml.features --> + +<!-- not [sgml.features[ --> +<!ENTITY % local.ubiq.mix ""> +<!ENTITY % ubiq.mix ""> + +<!ENTITY % ubiq.exclusion ""> +<!ENTITY % ubiq.inclusion ""> + +<!ENTITY % footnote.exclusion ""> +<!ENTITY % highlights.exclusion ""> +<!ENTITY % admon.exclusion ""> +<!ENTITY % formal.exclusion ""> +<!ENTITY % acronym.exclusion ""> +<!ENTITY % beginpage.exclusion ""> +<!ENTITY % ndxterm.exclusion ""> +<!ENTITY % blockquote.exclusion ""> +<!ENTITY % remark.exclusion ""> +<!ENTITY % glossterm.exclusion ""> +<!ENTITY % links.exclusion ""> +<!-- ]] not sgml.features --> + +<!-- + #PCD xref word link cptr base dnfo othr inob (synop) +para.char.mix X X X X X X X X X +title.char.mix X X X X X X X X X +ndxterm.char.mix X X X X X X X X a +cptr.char.mix X X X X X a +smallcptr.char.mix X b a +word.char.mix X c X X X a +docinfo.char.mix X d X b X a + +a. Just InlineGraphic; no InlineEquation. +b. Just Replaceable; no other computer terms. +c. Just Emphasis and Trademark; no other word elements. +d. Just Acronym, Emphasis, and Trademark; no other word elements. +--> + +<!ENTITY % local.para.char.mix ""> +<!ENTITY % para.char.mix + "#PCDATA + |%xref.char.class; |%gen.char.class; + |%link.char.class; |%tech.char.class; + |%base.char.class; |%docinfo.char.class; + |%other.char.class; |%inlineobj.char.class; + |%synop.class; + |%ndxterm.class; |beginpage + %forminlines.hook; + %local.para.char.mix;"> + +<!ENTITY % local.title.char.mix ""> +<!ENTITY % title.char.mix + "#PCDATA + |%xref.char.class; |%gen.char.class; + |%link.char.class; |%tech.char.class; + |%base.char.class; |%docinfo.char.class; + |%other.char.class; |%inlineobj.char.class; + |%ndxterm.class; + %local.title.char.mix;"> + +<!ENTITY % local.ndxterm.char.mix ""> +<!ENTITY % ndxterm.char.mix + "#PCDATA + |%xref.char.class; |%gen.char.class; + |%link.char.class; |%tech.char.class; + |%base.char.class; |%docinfo.char.class; + |%other.char.class; |inlinegraphic|inlinemediaobject + %local.ndxterm.char.mix;"> + +<!ENTITY % local.cptr.char.mix ""> +<!ENTITY % cptr.char.mix + "#PCDATA + |%link.char.class; |%tech.char.class; + |%base.char.class; + |%other.char.class; |inlinegraphic|inlinemediaobject + |%ndxterm.class; |beginpage + %local.cptr.char.mix;"> + +<!ENTITY % local.smallcptr.char.mix ""> +<!ENTITY % smallcptr.char.mix + "#PCDATA + |replaceable + |inlinegraphic|inlinemediaobject + |%ndxterm.class; |beginpage + %local.smallcptr.char.mix;"> + +<!ENTITY % local.word.char.mix ""> +<!ENTITY % word.char.mix + "#PCDATA + |acronym|emphasis|trademark + |%link.char.class; + |%base.char.class; + |%other.char.class; |inlinegraphic|inlinemediaobject + |%ndxterm.class; |beginpage + %local.word.char.mix;"> + +<!ENTITY % local.docinfo.char.mix ""> +<!ENTITY % docinfo.char.mix + "#PCDATA + |%link.char.class; + |emphasis|trademark + |replaceable + |%other.char.class; |inlinegraphic|inlinemediaobject + |%ndxterm.class; + %local.docinfo.char.mix;"> +<!--ENTITY % bibliocomponent.mix (see Bibliographic section, below)--> +<!--ENTITY % person.ident.mix (see Bibliographic section, below)--> + +<!-- ...................................................................... --> +<!-- Entities for attributes and attribute components ..................... --> + +<!-- Effectivity attributes ............................................... --> + + +<!-- Arch: Computer or chip architecture to which element applies; no + default --> + +<!ENTITY % arch.attrib + "arch CDATA #IMPLIED"> + +<!-- Condition: General-purpose effectivity attribute --> + +<!ENTITY % condition.attrib + "condition CDATA #IMPLIED"> + +<!-- Conformance: Standards conformance characteristics --> + +<!ENTITY % conformance.attrib + "conformance NMTOKENS #IMPLIED"> + + +<!-- OS: Operating system to which element applies; no default --> + +<!ENTITY % os.attrib + "os CDATA #IMPLIED"> + + +<!-- Revision: Editorial revision to which element belongs; no default --> + +<!ENTITY % revision.attrib + "revision CDATA #IMPLIED"> + +<!-- Security: Security classification; no default --> + +<!ENTITY % security.attrib + "security CDATA #IMPLIED"> + +<!-- UserLevel: Level of user experience to which element applies; no + default --> + +<!ENTITY % userlevel.attrib + "userlevel CDATA #IMPLIED"> + +<!-- Vendor: Computer vendor to which element applies; no default --> + +<!ENTITY % vendor.attrib + "vendor CDATA #IMPLIED"> + +<!-- Wordsize: Computer word size (32 bit, 64 bit, etc.); no default --> + +<!ENTITY % wordsize.attrib + "wordsize CDATA #IMPLIED"> + +<!ENTITY % local.effectivity.attrib ""> +<!ENTITY % effectivity.attrib + "%arch.attrib; + %condition.attrib; + %conformance.attrib; + %os.attrib; + %revision.attrib; + %security.attrib; + %userlevel.attrib; + %vendor.attrib; + %wordsize.attrib; + %local.effectivity.attrib;" +> + +<!-- Common attributes .................................................... --> + + +<!-- Id: Unique identifier of element; no default --> + +<!ENTITY % id.attrib + "id ID #IMPLIED"> + + +<!-- Id: Unique identifier of element; a value must be supplied; no + default --> + +<!ENTITY % idreq.attrib + "id ID #REQUIRED"> + + +<!-- Lang: Indicator of language in which element is written, for + translation, character set management, etc.; no default --> + +<!ENTITY % lang.attrib + "lang CDATA #IMPLIED"> + + +<!-- Remap: Previous role of element before conversion; no default --> + +<!ENTITY % remap.attrib + "remap CDATA #IMPLIED"> + + +<!-- Role: New role of element in local environment; no default --> + +<!ENTITY % role.attrib + "role CDATA #IMPLIED"> + + +<!-- XRefLabel: Alternate labeling string for XRef text generation; + default is usually title or other appropriate label text already + contained in element --> + +<!ENTITY % xreflabel.attrib + "xreflabel CDATA #IMPLIED"> + + +<!-- RevisionFlag: Revision status of element; default is that element + wasn't revised --> + +<!ENTITY % revisionflag.attrib + "revisionflag (changed + |added + |deleted + |off) #IMPLIED"> + +<!ENTITY % local.common.attrib ""> + +<!-- dir: Bidirectional override --> + +<!ENTITY % dir.attrib + "dir (ltr + |rtl + |lro + |rlo) #IMPLIED"> + +<!-- xml:base: base URI --> + +<![%sgml.features;[ +<!ENTITY % xml-base.attrib ""> +]]> +<!ENTITY % xml-base.attrib + "xml:base CDATA #IMPLIED"> + +<!-- Role is included explicitly on each element --> + +<!ENTITY % common.attrib + "%id.attrib; + %lang.attrib; + %remap.attrib; + %xreflabel.attrib; + %revisionflag.attrib; + %effectivity.attrib; + %dir.attrib; + %xml-base.attrib; + %local.common.attrib;" +> + +<!-- Role is included explicitly on each element --> + +<!ENTITY % idreq.common.attrib + "%idreq.attrib; + %lang.attrib; + %remap.attrib; + %xreflabel.attrib; + %revisionflag.attrib; + %effectivity.attrib; + %dir.attrib; + %xml-base.attrib; + %local.common.attrib;" +> + +<!-- Semi-common attributes and other attribute entities .................. --> + +<!ENTITY % local.graphics.attrib ""> + +<!-- EntityRef: Name of an external entity containing the content + of the graphic --> +<!-- FileRef: Filename, qualified by a pathname if desired, + designating the file containing the content of the graphic --> +<!-- Format: Notation of the element content, if any --> +<!-- SrcCredit: Information about the source of the Graphic --> +<!-- Width: Same as CALS reprowid (desired width) --> +<!-- Depth: Same as CALS reprodep (desired depth) --> +<!-- Align: Same as CALS hplace with 'none' removed; #IMPLIED means + application-specific --> +<!-- Scale: Conflation of CALS hscale and vscale --> +<!-- Scalefit: Same as CALS scalefit --> + +<!ENTITY % graphics.attrib + " + entityref ENTITY #IMPLIED + fileref CDATA #IMPLIED + format (%notation.class;) #IMPLIED + srccredit CDATA #IMPLIED + width CDATA #IMPLIED + contentwidth CDATA #IMPLIED + depth CDATA #IMPLIED + contentdepth CDATA #IMPLIED + align (left + |right + |center) #IMPLIED + valign (top + |middle + |bottom) #IMPLIED + scale CDATA #IMPLIED + scalefit %yesorno.attvals; + #IMPLIED + %local.graphics.attrib;" +> + +<!ENTITY % local.keyaction.attrib ""> + +<!-- Action: Key combination type; default is unspecified if one + child element, Simul if there is more than one; if value is + Other, the OtherAction attribute must have a nonempty value --> +<!-- OtherAction: User-defined key combination type --> + +<!ENTITY % keyaction.attrib + " + action (click + |double-click + |press + |seq + |simul + |other) #IMPLIED + otheraction CDATA #IMPLIED + %local.keyaction.attrib;" +> + + +<!-- Label: Identifying number or string; default is usually the + appropriate number or string autogenerated by a formatter --> + +<!ENTITY % label.attrib + "label CDATA #IMPLIED"> + + +<!-- xml:space: whitespace treatment --> + +<![%sgml.features;[ +<!ENTITY % xml-space.attrib ""> +]]> +<!ENTITY % xml-space.attrib + "xml:space (preserve) #IMPLIED"> + +<!-- Format: whether element is assumed to contain significant white + space --> + +<!ENTITY % linespecific.attrib + "format NOTATION + (linespecific) 'linespecific' + %xml-space.attrib; + linenumbering (numbered|unnumbered) #IMPLIED + continuation (continues|restarts) #IMPLIED + startinglinenumber CDATA #IMPLIED + language CDATA #IMPLIED"> + +<!-- Linkend: link to related information; no default --> + +<!ENTITY % linkend.attrib + "linkend IDREF #IMPLIED"> + + +<!-- Linkend: required link to related information --> + +<!ENTITY % linkendreq.attrib + "linkend IDREF #REQUIRED"> + + +<!-- Linkends: link to one or more sets of related information; no + default --> + +<!ENTITY % linkends.attrib + "linkends IDREFS #IMPLIED"> + + +<!ENTITY % local.mark.attrib ""> +<!ENTITY % mark.attrib + "mark CDATA #IMPLIED + %local.mark.attrib;" +> + + +<!-- MoreInfo: whether element's content has an associated RefEntry --> + +<!ENTITY % moreinfo.attrib + "moreinfo (refentry|none) 'none'"> + + +<!-- Pagenum: number of page on which element appears; no default --> + +<!ENTITY % pagenum.attrib + "pagenum CDATA #IMPLIED"> + +<!ENTITY % local.status.attrib ""> + +<!-- Status: Editorial or publication status of the element + it applies to, such as "in review" or "approved for distribution" --> + +<!ENTITY % status.attrib + "status CDATA #IMPLIED + %local.status.attrib;" +> + + +<!-- Width: width of the longest line in the element to which it + pertains, in number of characters --> + +<!ENTITY % width.attrib + "width CDATA #IMPLIED"> + +<!-- ...................................................................... --> +<!-- Title elements ....................................................... --> + +<!ENTITY % title.module "INCLUDE"> +<![%title.module;[ +<!ENTITY % local.title.attrib ""> +<!ENTITY % title.role.attrib "%role.attrib;"> + +<!ENTITY % title.element "INCLUDE"> +<![%title.element;[ +<!--doc:The text of the title of a section of a document or of a formal block-level element.--> +<!ELEMENT title %ho; (%title.char.mix;)*> +<!--end of title.element-->]]> + +<!ENTITY % title.attlist "INCLUDE"> +<![%title.attlist;[ +<!ATTLIST title + %pagenum.attrib; + %common.attrib; + %title.role.attrib; + %local.title.attrib; +> +<!--end of title.attlist-->]]> +<!--end of title.module-->]]> + +<!ENTITY % titleabbrev.module "INCLUDE"> +<![%titleabbrev.module;[ +<!ENTITY % local.titleabbrev.attrib ""> +<!ENTITY % titleabbrev.role.attrib "%role.attrib;"> + +<!ENTITY % titleabbrev.element "INCLUDE"> +<![%titleabbrev.element;[ +<!--doc:The abbreviation of a Title.--> +<!ELEMENT titleabbrev %ho; (%title.char.mix;)*> +<!--end of titleabbrev.element-->]]> + +<!ENTITY % titleabbrev.attlist "INCLUDE"> +<![%titleabbrev.attlist;[ +<!ATTLIST titleabbrev + %common.attrib; + %titleabbrev.role.attrib; + %local.titleabbrev.attrib; +> +<!--end of titleabbrev.attlist-->]]> +<!--end of titleabbrev.module-->]]> + +<!ENTITY % subtitle.module "INCLUDE"> +<![%subtitle.module;[ +<!ENTITY % local.subtitle.attrib ""> +<!ENTITY % subtitle.role.attrib "%role.attrib;"> + +<!ENTITY % subtitle.element "INCLUDE"> +<![%subtitle.element;[ +<!--doc:The subtitle of a document.--> +<!ELEMENT subtitle %ho; (%title.char.mix;)*> +<!--end of subtitle.element-->]]> + +<!ENTITY % subtitle.attlist "INCLUDE"> +<![%subtitle.attlist;[ +<!ATTLIST subtitle + %common.attrib; + %subtitle.role.attrib; + %local.subtitle.attrib; +> +<!--end of subtitle.attlist-->]]> +<!--end of subtitle.module-->]]> + +<!-- ...................................................................... --> +<!-- Bibliographic entities and elements .................................. --> + +<!-- The bibliographic elements are typically used in the document + hierarchy. They do not appear in content models of information + pool elements. See also the document information elements, + below. --> + +<!ENTITY % local.person.ident.mix ""> +<!ENTITY % person.ident.mix + "honorific|firstname|surname|lineage|othername|affiliation + |authorblurb|contrib %local.person.ident.mix;"> + +<!ENTITY % local.bibliocomponent.mix ""> +<!ENTITY % bibliocomponent.mix + "abbrev|abstract|address|artpagenums|author + |authorgroup|authorinitials|bibliomisc|biblioset + |collab|confgroup|contractnum|contractsponsor + |copyright|corpauthor|corpname|corpcredit|date|edition + |editor|invpartnumber|isbn|issn|issuenum|orgname + |biblioid|citebiblioid|bibliosource|bibliorelation|bibliocoverage + |othercredit|pagenums|printhistory|productname + |productnumber|pubdate|publisher|publishername + |pubsnumber|releaseinfo|revhistory|seriesvolnums + |subtitle|title|titleabbrev|volumenum|citetitle + |personname|%person.ident.mix; + |%ndxterm.class; + %local.bibliocomponent.mix;"> + +<!-- I don't think this is well placed, but it needs to be here because of --> +<!-- the reference to bibliocomponent.mix --> +<!ENTITY % local.info.class ""> +<!ENTITY % info.class + "graphic | mediaobject | legalnotice | modespec + | subjectset | keywordset | itermset | %bibliocomponent.mix; + %local.info.class;"> + + +<!-- BiblioList ........................ --> + +<!ENTITY % bibliolist.module "INCLUDE"> +<![%bibliolist.module;[ +<!ENTITY % local.bibliolist.attrib ""> +<!ENTITY % bibliolist.role.attrib "%role.attrib;"> + +<!ENTITY % bibliolist.element "INCLUDE"> +<![%bibliolist.element;[ +<!--doc:A wrapper for a set of bibliography entries.--> +<!ELEMENT bibliolist %ho; (blockinfo?, (%formalobject.title.content;)?, + (biblioentry|bibliomixed)+)> +<!--end of bibliolist.element-->]]> + +<!ENTITY % bibliolist.attlist "INCLUDE"> +<![%bibliolist.attlist;[ +<!ATTLIST bibliolist + %common.attrib; + %bibliolist.role.attrib; + %local.bibliolist.attrib; +> +<!--end of bibliolist.attlist-->]]> +<!--end of bibliolist.module-->]]> + +<!ENTITY % biblioentry.module "INCLUDE"> +<![%biblioentry.module;[ +<!ENTITY % local.biblioentry.attrib ""> +<!ENTITY % biblioentry.role.attrib "%role.attrib;"> + +<!ENTITY % biblioentry.element "INCLUDE"> +<![%biblioentry.element;[ +<!--doc:An entry in a Bibliography.--> +<!ELEMENT biblioentry %ho; ((articleinfo | (%bibliocomponent.mix;))+) + %ubiq.exclusion;> +<!--end of biblioentry.element-->]]> + +<!ENTITY % biblioentry.attlist "INCLUDE"> +<![%biblioentry.attlist;[ +<!ATTLIST biblioentry + %common.attrib; + %biblioentry.role.attrib; + %local.biblioentry.attrib; +> +<!--end of biblioentry.attlist-->]]> +<!--end of biblioentry.module-->]]> + +<!ENTITY % bibliomixed.module "INCLUDE"> +<![%bibliomixed.module;[ +<!ENTITY % local.bibliomixed.attrib ""> +<!ENTITY % bibliomixed.role.attrib "%role.attrib;"> + +<!ENTITY % bibliomixed.element "INCLUDE"> +<![%bibliomixed.element;[ +<!--doc:An entry in a Bibliography.--> +<!ELEMENT bibliomixed %ho; (#PCDATA | %bibliocomponent.mix; | bibliomset)* + %ubiq.exclusion;> +<!--end of bibliomixed.element-->]]> + +<!ENTITY % bibliomixed.attlist "INCLUDE"> +<![%bibliomixed.attlist;[ +<!ATTLIST bibliomixed + %common.attrib; + %bibliomixed.role.attrib; + %local.bibliomixed.attrib; +> +<!--end of bibliomixed.attlist-->]]> +<!--end of bibliomixed.module-->]]> + +<!ENTITY % articleinfo.module "INCLUDE"> +<![%articleinfo.module;[ +<!ENTITY % local.articleinfo.attrib ""> +<!ENTITY % articleinfo.role.attrib "%role.attrib;"> + +<!ENTITY % articleinfo.element "INCLUDE"> +<![%articleinfo.element;[ +<!--doc:Meta-information for an Article.--> +<!ELEMENT articleinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of articleinfo.element-->]]> + +<!ENTITY % articleinfo.attlist "INCLUDE"> +<![%articleinfo.attlist;[ +<!ATTLIST articleinfo + %common.attrib; + %articleinfo.role.attrib; + %local.articleinfo.attrib; +> +<!--end of articleinfo.attlist-->]]> +<!--end of articleinfo.module-->]]> + +<!ENTITY % biblioset.module "INCLUDE"> +<![%biblioset.module;[ +<!ENTITY % local.biblioset.attrib ""> +<!ENTITY % biblioset.role.attrib "%role.attrib;"> + +<!ENTITY % biblioset.element "INCLUDE"> +<![%biblioset.element;[ +<!--doc:A "raw" container for related bibliographic information.--> +<!ELEMENT biblioset %ho; ((%bibliocomponent.mix;)+) + %ubiq.exclusion;> +<!--end of biblioset.element-->]]> + +<!-- Relation: Relationship of elements contained within BiblioSet --> + + +<!ENTITY % biblioset.attlist "INCLUDE"> +<![%biblioset.attlist;[ +<!ATTLIST biblioset + relation CDATA #IMPLIED + %common.attrib; + %biblioset.role.attrib; + %local.biblioset.attrib; +> +<!--end of biblioset.attlist-->]]> +<!--end of biblioset.module-->]]> + +<!ENTITY % bibliomset.module "INCLUDE"> +<![%bibliomset.module;[ +<!ENTITY % bibliomset.role.attrib "%role.attrib;"> +<!ENTITY % local.bibliomset.attrib ""> + +<!ENTITY % bibliomset.element "INCLUDE"> +<![%bibliomset.element;[ +<!--doc:A "cooked" container for related bibliographic information.--> +<!ELEMENT bibliomset %ho; (#PCDATA | %bibliocomponent.mix; | bibliomset)* + %ubiq.exclusion;> +<!--end of bibliomset.element-->]]> + +<!-- Relation: Relationship of elements contained within BiblioMSet --> + + +<!ENTITY % bibliomset.attlist "INCLUDE"> +<![%bibliomset.attlist;[ +<!ATTLIST bibliomset + relation CDATA #IMPLIED + %common.attrib; + %bibliomset.role.attrib; + %local.bibliomset.attrib; +> +<!--end of bibliomset.attlist-->]]> +<!--end of bibliomset.module-->]]> + +<!ENTITY % bibliomisc.module "INCLUDE"> +<![%bibliomisc.module;[ +<!ENTITY % local.bibliomisc.attrib ""> +<!ENTITY % bibliomisc.role.attrib "%role.attrib;"> + +<!ENTITY % bibliomisc.element "INCLUDE"> +<![%bibliomisc.element;[ +<!--doc:Untyped bibliographic information.--> +<!ELEMENT bibliomisc %ho; (%para.char.mix;)*> +<!--end of bibliomisc.element-->]]> + +<!ENTITY % bibliomisc.attlist "INCLUDE"> +<![%bibliomisc.attlist;[ +<!ATTLIST bibliomisc + %common.attrib; + %bibliomisc.role.attrib; + %local.bibliomisc.attrib; +> +<!--end of bibliomisc.attlist-->]]> +<!--end of bibliomisc.module-->]]> + +<!-- ...................................................................... --> +<!-- Subject, Keyword, and ITermSet elements .............................. --> + +<!ENTITY % subjectset.content.module "INCLUDE"> +<![%subjectset.content.module;[ +<!ENTITY % subjectset.module "INCLUDE"> +<![%subjectset.module;[ +<!ENTITY % local.subjectset.attrib ""> +<!ENTITY % subjectset.role.attrib "%role.attrib;"> + +<!ENTITY % subjectset.element "INCLUDE"> +<![%subjectset.element;[ +<!--doc:A set of terms describing the subject matter of a document.--> +<!ELEMENT subjectset %ho; (subject+)> +<!--end of subjectset.element-->]]> + +<!-- Scheme: Controlled vocabulary employed in SubjectTerms --> + + +<!ENTITY % subjectset.attlist "INCLUDE"> +<![%subjectset.attlist;[ +<!ATTLIST subjectset + scheme NMTOKEN #IMPLIED + %common.attrib; + %subjectset.role.attrib; + %local.subjectset.attrib; +> +<!--end of subjectset.attlist-->]]> +<!--end of subjectset.module-->]]> + +<!ENTITY % subject.module "INCLUDE"> +<![%subject.module;[ +<!ENTITY % local.subject.attrib ""> +<!ENTITY % subject.role.attrib "%role.attrib;"> + +<!ENTITY % subject.element "INCLUDE"> +<![%subject.element;[ +<!--doc:One of a group of terms describing the subject matter of a document.--> +<!ELEMENT subject %ho; (subjectterm+)> +<!--end of subject.element-->]]> + +<!-- Weight: Ranking of this group of SubjectTerms relative + to others, 0 is low, no highest value specified --> + + +<!ENTITY % subject.attlist "INCLUDE"> +<![%subject.attlist;[ +<!ATTLIST subject + weight CDATA #IMPLIED + %common.attrib; + %subject.role.attrib; + %local.subject.attrib; +> +<!--end of subject.attlist-->]]> +<!--end of subject.module-->]]> + +<!ENTITY % subjectterm.module "INCLUDE"> +<![%subjectterm.module;[ +<!ENTITY % local.subjectterm.attrib ""> +<!ENTITY % subjectterm.role.attrib "%role.attrib;"> + +<!ENTITY % subjectterm.element "INCLUDE"> +<![%subjectterm.element;[ +<!--doc:A term in a group of terms describing the subject matter of a document.--> +<!ELEMENT subjectterm %ho; (#PCDATA)> +<!--end of subjectterm.element-->]]> + +<!ENTITY % subjectterm.attlist "INCLUDE"> +<![%subjectterm.attlist;[ +<!ATTLIST subjectterm + %common.attrib; + %subjectterm.role.attrib; + %local.subjectterm.attrib; +> +<!--end of subjectterm.attlist-->]]> +<!--end of subjectterm.module-->]]> +<!--end of subjectset.content.module-->]]> + +<!ENTITY % keywordset.content.module "INCLUDE"> +<![%keywordset.content.module;[ +<!ENTITY % keywordset.module "INCLUDE"> +<![%keywordset.module;[ +<!ENTITY % local.keywordset.attrib ""> +<!ENTITY % keywordset.role.attrib "%role.attrib;"> + +<!ENTITY % keywordset.element "INCLUDE"> +<![%keywordset.element;[ +<!--doc:A set of keywords describing the content of a document.--> +<!ELEMENT keywordset %ho; (keyword+)> +<!--end of keywordset.element-->]]> + +<!ENTITY % keywordset.attlist "INCLUDE"> +<![%keywordset.attlist;[ +<!ATTLIST keywordset + %common.attrib; + %keywordset.role.attrib; + %local.keywordset.attrib; +> +<!--end of keywordset.attlist-->]]> +<!--end of keywordset.module-->]]> + +<!ENTITY % keyword.module "INCLUDE"> +<![%keyword.module;[ +<!ENTITY % local.keyword.attrib ""> +<!ENTITY % keyword.role.attrib "%role.attrib;"> + +<!ENTITY % keyword.element "INCLUDE"> +<![%keyword.element;[ +<!--doc:One of a set of keywords describing the content of a document.--> +<!ELEMENT keyword %ho; (#PCDATA)> +<!--end of keyword.element-->]]> + +<!ENTITY % keyword.attlist "INCLUDE"> +<![%keyword.attlist;[ +<!ATTLIST keyword + %common.attrib; + %keyword.role.attrib; + %local.keyword.attrib; +> +<!--end of keyword.attlist-->]]> +<!--end of keyword.module-->]]> +<!--end of keywordset.content.module-->]]> + +<!ENTITY % itermset.module "INCLUDE"> +<![%itermset.module;[ +<!ENTITY % local.itermset.attrib ""> +<!ENTITY % itermset.role.attrib "%role.attrib;"> + +<!ENTITY % itermset.element "INCLUDE"> +<![%itermset.element;[ +<!--doc:A set of index terms in the meta-information of a document.--> +<!ELEMENT itermset %ho; (indexterm+)> +<!--end of itermset.element-->]]> + +<!ENTITY % itermset.attlist "INCLUDE"> +<![%itermset.attlist;[ +<!ATTLIST itermset + %common.attrib; + %itermset.role.attrib; + %local.itermset.attrib; +> +<!--end of itermset.attlist-->]]> +<!--end of itermset.module-->]]> + +<!-- Bibliographic info for "blocks" --> + +<!ENTITY % blockinfo.module "INCLUDE"> +<![ %blockinfo.module; [ +<!ENTITY % local.blockinfo.attrib ""> +<!ENTITY % blockinfo.role.attrib "%role.attrib;"> + +<!ENTITY % blockinfo.element "INCLUDE"> +<![ %blockinfo.element; [ +<!--doc:Meta-information for a block element.--> +<!ELEMENT blockinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of blockinfo.element-->]]> + +<!ENTITY % blockinfo.attlist "INCLUDE"> +<![ %blockinfo.attlist; [ +<!ATTLIST blockinfo + %common.attrib; + %blockinfo.role.attrib; + %local.blockinfo.attrib; +> +<!--end of blockinfo.attlist-->]]> +<!--end of blockinfo.module-->]]> + +<!-- ...................................................................... --> +<!-- Compound (section-ish) elements ...................................... --> + +<!-- Message set ...................... --> + +<!ENTITY % msgset.content.module "INCLUDE"> +<![%msgset.content.module;[ +<!ENTITY % msgset.module "INCLUDE"> +<![%msgset.module;[ +<!ENTITY % local.msgset.attrib ""> +<!ENTITY % msgset.role.attrib "%role.attrib;"> + +<!ENTITY % msgset.element "INCLUDE"> +<![%msgset.element;[ +<!--doc:A detailed set of messages, usually error messages.--> +<!ELEMENT msgset %ho; (blockinfo?, (%formalobject.title.content;)?, + (msgentry+|simplemsgentry+))> +<!--end of msgset.element-->]]> + +<!ENTITY % msgset.attlist "INCLUDE"> +<![%msgset.attlist;[ +<!ATTLIST msgset + %common.attrib; + %msgset.role.attrib; + %local.msgset.attrib; +> +<!--end of msgset.attlist-->]]> +<!--end of msgset.module-->]]> + +<!ENTITY % msgentry.module "INCLUDE"> +<![%msgentry.module;[ +<!ENTITY % local.msgentry.attrib ""> +<!ENTITY % msgentry.role.attrib "%role.attrib;"> + +<!ENTITY % msgentry.element "INCLUDE"> +<![%msgentry.element;[ +<!--doc:A wrapper for an entry in a message set.--> +<!ELEMENT msgentry %ho; (msg+, msginfo?, msgexplan*)> +<!--end of msgentry.element-->]]> + +<!ENTITY % msgentry.attlist "INCLUDE"> +<![%msgentry.attlist;[ +<!ATTLIST msgentry + %common.attrib; + %msgentry.role.attrib; + %local.msgentry.attrib; +> +<!--end of msgentry.attlist-->]]> +<!--end of msgentry.module-->]]> + +<!ENTITY % simplemsgentry.module "INCLUDE"> +<![ %simplemsgentry.module; [ +<!ENTITY % local.simplemsgentry.attrib ""> +<!ENTITY % simplemsgentry.role.attrib "%role.attrib;"> + +<!ENTITY % simplemsgentry.element "INCLUDE"> +<![ %simplemsgentry.element; [ +<!--doc:A wrapper for a simpler entry in a message set.--> +<!ELEMENT simplemsgentry %ho; (msgtext, msgexplan+)> +<!--end of simplemsgentry.element-->]]> + +<!ENTITY % simplemsgentry.attlist "INCLUDE"> +<![ %simplemsgentry.attlist; [ +<!ATTLIST simplemsgentry + audience CDATA #IMPLIED + level CDATA #IMPLIED + origin CDATA #IMPLIED + %common.attrib; + %simplemsgentry.role.attrib; + %local.simplemsgentry.attrib; +> +<!--end of simplemsgentry.attlist-->]]> +<!--end of simplemsgentry.module-->]]> + +<!ENTITY % msg.module "INCLUDE"> +<![%msg.module;[ +<!ENTITY % local.msg.attrib ""> +<!ENTITY % msg.role.attrib "%role.attrib;"> + +<!ENTITY % msg.element "INCLUDE"> +<![%msg.element;[ +<!--doc:A message in a message set.--> +<!ELEMENT msg %ho; (title?, msgmain, (msgsub | msgrel)*)> +<!--end of msg.element-->]]> + +<!ENTITY % msg.attlist "INCLUDE"> +<![%msg.attlist;[ +<!ATTLIST msg + %common.attrib; + %msg.role.attrib; + %local.msg.attrib; +> +<!--end of msg.attlist-->]]> +<!--end of msg.module-->]]> + +<!ENTITY % msgmain.module "INCLUDE"> +<![%msgmain.module;[ +<!ENTITY % local.msgmain.attrib ""> +<!ENTITY % msgmain.role.attrib "%role.attrib;"> + +<!ENTITY % msgmain.element "INCLUDE"> +<![%msgmain.element;[ +<!--doc:The primary component of a message in a message set.--> +<!ELEMENT msgmain %ho; (title?, msgtext)> +<!--end of msgmain.element-->]]> + +<!ENTITY % msgmain.attlist "INCLUDE"> +<![%msgmain.attlist;[ +<!ATTLIST msgmain + %common.attrib; + %msgmain.role.attrib; + %local.msgmain.attrib; +> +<!--end of msgmain.attlist-->]]> +<!--end of msgmain.module-->]]> + +<!ENTITY % msgsub.module "INCLUDE"> +<![%msgsub.module;[ +<!ENTITY % local.msgsub.attrib ""> +<!ENTITY % msgsub.role.attrib "%role.attrib;"> + +<!ENTITY % msgsub.element "INCLUDE"> +<![%msgsub.element;[ +<!--doc:A subcomponent of a message in a message set.--> +<!ELEMENT msgsub %ho; (title?, msgtext)> +<!--end of msgsub.element-->]]> + +<!ENTITY % msgsub.attlist "INCLUDE"> +<![%msgsub.attlist;[ +<!ATTLIST msgsub + %common.attrib; + %msgsub.role.attrib; + %local.msgsub.attrib; +> +<!--end of msgsub.attlist-->]]> +<!--end of msgsub.module-->]]> + +<!ENTITY % msgrel.module "INCLUDE"> +<![%msgrel.module;[ +<!ENTITY % local.msgrel.attrib ""> +<!ENTITY % msgrel.role.attrib "%role.attrib;"> + +<!ENTITY % msgrel.element "INCLUDE"> +<![%msgrel.element;[ +<!--doc:A related component of a message in a message set.--> +<!ELEMENT msgrel %ho; (title?, msgtext)> +<!--end of msgrel.element-->]]> + +<!ENTITY % msgrel.attlist "INCLUDE"> +<![%msgrel.attlist;[ +<!ATTLIST msgrel + %common.attrib; + %msgrel.role.attrib; + %local.msgrel.attrib; +> +<!--end of msgrel.attlist-->]]> +<!--end of msgrel.module-->]]> + +<!-- MsgText (defined in the Inlines section, below)--> + +<!ENTITY % msginfo.module "INCLUDE"> +<![%msginfo.module;[ +<!ENTITY % local.msginfo.attrib ""> +<!ENTITY % msginfo.role.attrib "%role.attrib;"> + +<!ENTITY % msginfo.element "INCLUDE"> +<![%msginfo.element;[ +<!--doc:Information about a message in a message set.--> +<!ELEMENT msginfo %ho; ((msglevel | msgorig | msgaud)*)> +<!--end of msginfo.element-->]]> + +<!ENTITY % msginfo.attlist "INCLUDE"> +<![%msginfo.attlist;[ +<!ATTLIST msginfo + %common.attrib; + %msginfo.role.attrib; + %local.msginfo.attrib; +> +<!--end of msginfo.attlist-->]]> +<!--end of msginfo.module-->]]> + +<!ENTITY % msglevel.module "INCLUDE"> +<![%msglevel.module;[ +<!ENTITY % local.msglevel.attrib ""> +<!ENTITY % msglevel.role.attrib "%role.attrib;"> + +<!ENTITY % msglevel.element "INCLUDE"> +<![%msglevel.element;[ +<!--doc:The level of importance or severity of a message in a message set.--> +<!ELEMENT msglevel %ho; (%smallcptr.char.mix;)*> +<!--end of msglevel.element-->]]> + +<!ENTITY % msglevel.attlist "INCLUDE"> +<![%msglevel.attlist;[ +<!ATTLIST msglevel + %common.attrib; + %msglevel.role.attrib; + %local.msglevel.attrib; +> +<!--end of msglevel.attlist-->]]> +<!--end of msglevel.module-->]]> + +<!ENTITY % msgorig.module "INCLUDE"> +<![%msgorig.module;[ +<!ENTITY % local.msgorig.attrib ""> +<!ENTITY % msgorig.role.attrib "%role.attrib;"> + +<!ENTITY % msgorig.element "INCLUDE"> +<![%msgorig.element;[ +<!--doc:The origin of a message in a message set.--> +<!ELEMENT msgorig %ho; (%smallcptr.char.mix;)*> +<!--end of msgorig.element-->]]> + +<!ENTITY % msgorig.attlist "INCLUDE"> +<![%msgorig.attlist;[ +<!ATTLIST msgorig + %common.attrib; + %msgorig.role.attrib; + %local.msgorig.attrib; +> +<!--end of msgorig.attlist-->]]> +<!--end of msgorig.module-->]]> + +<!ENTITY % msgaud.module "INCLUDE"> +<![%msgaud.module;[ +<!ENTITY % local.msgaud.attrib ""> +<!ENTITY % msgaud.role.attrib "%role.attrib;"> + +<!ENTITY % msgaud.element "INCLUDE"> +<![%msgaud.element;[ +<!--doc:The audience to which a message in a message set is relevant.--> +<!ELEMENT msgaud %ho; (%para.char.mix;)*> +<!--end of msgaud.element-->]]> + +<!ENTITY % msgaud.attlist "INCLUDE"> +<![%msgaud.attlist;[ +<!ATTLIST msgaud + %common.attrib; + %msgaud.role.attrib; + %local.msgaud.attrib; +> +<!--end of msgaud.attlist-->]]> +<!--end of msgaud.module-->]]> + +<!ENTITY % msgexplan.module "INCLUDE"> +<![%msgexplan.module;[ +<!ENTITY % local.msgexplan.attrib ""> +<!ENTITY % msgexplan.role.attrib "%role.attrib;"> + +<!ENTITY % msgexplan.element "INCLUDE"> +<![%msgexplan.element;[ +<!--doc:Explanatory material relating to a message in a message set.--> +<!ELEMENT msgexplan %ho; (title?, (%component.mix;)+)> +<!--end of msgexplan.element-->]]> + +<!ENTITY % msgexplan.attlist "INCLUDE"> +<![%msgexplan.attlist;[ +<!ATTLIST msgexplan + %common.attrib; + %msgexplan.role.attrib; + %local.msgexplan.attrib; +> +<!--end of msgexplan.attlist-->]]> +<!--end of msgexplan.module-->]]> +<!--end of msgset.content.module-->]]> + +<!ENTITY % task.content.module "INCLUDE"> +<![%task.content.module;[ +<!ENTITY % task.module "INCLUDE"> +<![%task.module;[ +<!ENTITY % local.task.attrib ""> +<!ENTITY % task.role.attrib "%role.attrib;"> + +<!ENTITY % task.element "INCLUDE"> +<![%task.element;[ +<!--doc:A task to be completed.--> +<!ELEMENT task %ho; (blockinfo?,(%ndxterm.class;)*, + (%formalobject.title.content;), + tasksummary?, + taskprerequisites?, + procedure, + example*, + taskrelated?)> +<!--end of task.element-->]]> + +<!ENTITY % task.attlist "INCLUDE"> +<![%task.attlist;[ +<!ATTLIST task + %common.attrib; + %task.role.attrib; + %local.task.attrib; +> +<!--end of task.attlist-->]]> +<!--end of task.module-->]]> + +<!ENTITY % tasksummary.module "INCLUDE"> +<![%tasksummary.module;[ +<!ENTITY % local.tasksummary.attrib ""> +<!ENTITY % tasksummary.role.attrib "%role.attrib;"> + +<!ENTITY % tasksummary.element "INCLUDE"> +<![%tasksummary.element;[ +<!--doc:A summary of a task.--> +<!ELEMENT tasksummary %ho; (blockinfo?, + (%formalobject.title.content;)?, + (%component.mix;)+)> +<!--end of tasksummary.element-->]]> + +<!ENTITY % tasksummary.attlist "INCLUDE"> +<![%tasksummary.attlist;[ +<!ATTLIST tasksummary + %common.attrib; + %tasksummary.role.attrib; + %local.tasksummary.attrib; +> +<!--end of tasksummary.attlist-->]]> +<!--end of tasksummary.module-->]]> + +<!ENTITY % taskprerequisites.module "INCLUDE"> +<![%taskprerequisites.module;[ +<!ENTITY % local.taskprerequisites.attrib ""> +<!ENTITY % taskprerequisites.role.attrib "%role.attrib;"> + +<!ENTITY % taskprerequisites.element "INCLUDE"> +<![%taskprerequisites.element;[ +<!--doc:The prerequisites for a task.--> +<!ELEMENT taskprerequisites %ho; (blockinfo?, + (%formalobject.title.content;)?, + (%component.mix;)+)> +<!--end of taskprerequisites.element-->]]> + +<!ENTITY % taskprerequisites.attlist "INCLUDE"> +<![%taskprerequisites.attlist;[ +<!ATTLIST taskprerequisites + %common.attrib; + %taskprerequisites.role.attrib; + %local.taskprerequisites.attrib; +> +<!--end of taskprerequisites.attlist-->]]> +<!--end of taskprerequisites.module-->]]> + +<!ENTITY % taskrelated.module "INCLUDE"> +<![%taskrelated.module;[ +<!ENTITY % local.taskrelated.attrib ""> +<!ENTITY % taskrelated.role.attrib "%role.attrib;"> + +<!ENTITY % taskrelated.element "INCLUDE"> +<![%taskrelated.element;[ +<!--doc:Information related to a task.--> +<!ELEMENT taskrelated %ho; (blockinfo?, + (%formalobject.title.content;)?, + (%component.mix;)+)> +<!--end of taskrelated.element-->]]> + +<!ENTITY % taskrelated.attlist "INCLUDE"> +<![%taskrelated.attlist;[ +<!ATTLIST taskrelated + %common.attrib; + %taskrelated.role.attrib; + %local.taskrelated.attrib; +> +<!--end of taskrelated.attlist-->]]> +<!--end of taskrelated.module-->]]> +<!--end of task.content.module-->]]> + +<!-- QandASet ........................ --> +<!ENTITY % qandaset.content.module "INCLUDE"> +<![ %qandaset.content.module; [ +<!ENTITY % qandaset.module "INCLUDE"> +<![ %qandaset.module; [ +<!ENTITY % local.qandaset.attrib ""> +<!ENTITY % qandaset.role.attrib "%role.attrib;"> + +<!ENTITY % qandaset.element "INCLUDE"> +<![ %qandaset.element; [ +<!--doc:A question-and-answer set.--> +<!ELEMENT qandaset %ho; (blockinfo?, (%formalobject.title.content;)?, + (%qandaset.mix;)*, + (qandadiv+|qandaentry+))> +<!--end of qandaset.element-->]]> + +<!ENTITY % qandaset.attlist "INCLUDE"> +<![ %qandaset.attlist; [ +<!ATTLIST qandaset + defaultlabel (qanda|number|none) #IMPLIED + %common.attrib; + %qandaset.role.attrib; + %local.qandaset.attrib;> +<!--end of qandaset.attlist-->]]> +<!--end of qandaset.module-->]]> + +<!ENTITY % qandadiv.module "INCLUDE"> +<![ %qandadiv.module; [ +<!ENTITY % local.qandadiv.attrib ""> +<!ENTITY % qandadiv.role.attrib "%role.attrib;"> + +<!ENTITY % qandadiv.element "INCLUDE"> +<![ %qandadiv.element; [ +<!--doc:A titled division in a QandASet.--> +<!ELEMENT qandadiv %ho; (blockinfo?, (%formalobject.title.content;)?, + (%qandaset.mix;)*, + (qandadiv+|qandaentry+))> +<!--end of qandadiv.element-->]]> + +<!ENTITY % qandadiv.attlist "INCLUDE"> +<![ %qandadiv.attlist; [ +<!ATTLIST qandadiv + %common.attrib; + %qandadiv.role.attrib; + %local.qandadiv.attrib;> +<!--end of qandadiv.attlist-->]]> +<!--end of qandadiv.module-->]]> + +<!ENTITY % qandaentry.module "INCLUDE"> +<![ %qandaentry.module; [ +<!ENTITY % local.qandaentry.attrib ""> +<!ENTITY % qandaentry.role.attrib "%role.attrib;"> + +<!ENTITY % qandaentry.element "INCLUDE"> +<![ %qandaentry.element; [ +<!--doc:A question/answer set within a QandASet.--> +<!ELEMENT qandaentry %ho; (blockinfo?, revhistory?, question, answer*)> +<!--end of qandaentry.element-->]]> + +<!ENTITY % qandaentry.attlist "INCLUDE"> +<![ %qandaentry.attlist; [ +<!ATTLIST qandaentry + %common.attrib; + %qandaentry.role.attrib; + %local.qandaentry.attrib;> +<!--end of qandaentry.attlist-->]]> +<!--end of qandaentry.module-->]]> + +<!ENTITY % question.module "INCLUDE"> +<![ %question.module; [ +<!ENTITY % local.question.attrib ""> +<!ENTITY % question.role.attrib "%role.attrib;"> + +<!ENTITY % question.element "INCLUDE"> +<![ %question.element; [ +<!--doc:A question in a QandASet.--> +<!ELEMENT question %ho; (label?, (%qandaset.mix;)+)> +<!--end of question.element-->]]> + +<!ENTITY % question.attlist "INCLUDE"> +<![ %question.attlist; [ +<!ATTLIST question + %common.attrib; + %question.role.attrib; + %local.question.attrib; +> +<!--end of question.attlist-->]]> +<!--end of question.module-->]]> + +<!ENTITY % answer.module "INCLUDE"> +<![ %answer.module; [ +<!ENTITY % local.answer.attrib ""> +<!ENTITY % answer.role.attrib "%role.attrib;"> + +<!ENTITY % answer.element "INCLUDE"> +<![ %answer.element; [ +<!--doc:An answer to a question posed in a QandASet.--> +<!ELEMENT answer %ho; (label?, (%qandaset.mix;)*, qandaentry*)> +<!--end of answer.element-->]]> + +<!ENTITY % answer.attlist "INCLUDE"> +<![ %answer.attlist; [ +<!ATTLIST answer + %common.attrib; + %answer.role.attrib; + %local.answer.attrib; +> +<!--end of answer.attlist-->]]> +<!--end of answer.module-->]]> + +<!ENTITY % label.module "INCLUDE"> +<![ %label.module; [ +<!ENTITY % local.label.attrib ""> +<!ENTITY % label.role.attrib "%role.attrib;"> + +<!ENTITY % label.element "INCLUDE"> +<![ %label.element; [ +<!--doc:A label on a Question or Answer.--> +<!ELEMENT label %ho; (%word.char.mix;)*> +<!--end of label.element-->]]> + +<!ENTITY % label.attlist "INCLUDE"> +<![ %label.attlist; [ +<!ATTLIST label + %common.attrib; + %label.role.attrib; + %local.label.attrib; +> +<!--end of label.attlist-->]]> +<!--end of label.module-->]]> +<!--end of qandaset.content.module-->]]> + +<!-- Procedure ........................ --> + +<!ENTITY % procedure.content.module "INCLUDE"> +<![%procedure.content.module;[ +<!ENTITY % procedure.module "INCLUDE"> +<![%procedure.module;[ +<!ENTITY % local.procedure.attrib ""> +<!ENTITY % procedure.role.attrib "%role.attrib;"> + +<!ENTITY % procedure.element "INCLUDE"> +<![%procedure.element;[ +<!--doc:A list of operations to be performed in a well-defined sequence.--> +<!ELEMENT procedure %ho; (blockinfo?, (%formalobject.title.content;)?, + (%component.mix;)*, step+)> +<!--end of procedure.element-->]]> + +<!ENTITY % procedure.attlist "INCLUDE"> +<![%procedure.attlist;[ +<!ATTLIST procedure + %common.attrib; + %procedure.role.attrib; + %local.procedure.attrib; +> +<!--end of procedure.attlist-->]]> +<!--end of procedure.module-->]]> + +<!ENTITY % step.module "INCLUDE"> +<![%step.module;[ +<!ENTITY % local.step.attrib ""> +<!ENTITY % step.role.attrib "%role.attrib;"> + +<!ENTITY % step.element "INCLUDE"> +<![%step.element;[ +<!--doc:A unit of action in a procedure.--> +<!ELEMENT step %ho; (title?, (((%component.mix;)+, ((substeps|stepalternatives), (%component.mix;)*)?) + | ((substeps|stepalternatives), (%component.mix;)*)))> +<!--end of step.element-->]]> + +<!-- Performance: Whether the Step must be performed --> +<!-- not #REQUIRED! --> + + +<!ENTITY % step.attlist "INCLUDE"> +<![%step.attlist;[ +<!ATTLIST step + performance (optional + |required) "required" + %common.attrib; + %step.role.attrib; + %local.step.attrib; +> +<!--end of step.attlist-->]]> +<!--end of step.module-->]]> + +<!ENTITY % substeps.module "INCLUDE"> +<![%substeps.module;[ +<!ENTITY % local.substeps.attrib ""> +<!ENTITY % substeps.role.attrib "%role.attrib;"> + +<!ENTITY % substeps.element "INCLUDE"> +<![%substeps.element;[ +<!--doc:A wrapper for steps that occur within steps in a procedure.--> +<!ELEMENT substeps %ho; (step+)> +<!--end of substeps.element-->]]> + +<!-- Performance: whether entire set of substeps must be performed --> +<!-- not #REQUIRED! --> + +<!ENTITY % substeps.attlist "INCLUDE"> +<![%substeps.attlist;[ +<!ATTLIST substeps + performance (optional + |required) "required" + %common.attrib; + %substeps.role.attrib; + %local.substeps.attrib; +> +<!--end of substeps.attlist-->]]> +<!--end of substeps.module-->]]> + +<!ENTITY % stepalternatives.module "INCLUDE"> +<![%stepalternatives.module;[ +<!ENTITY % local.stepalternatives.attrib ""> +<!ENTITY % stepalternatives.role.attrib "%role.attrib;"> + +<!ENTITY % stepalternatives.element "INCLUDE"> +<![%stepalternatives.element;[ +<!--doc:Alternative steps in a procedure.--> +<!ELEMENT stepalternatives %ho; (step+)> +<!--end of stepalternatives.element-->]]> + +<!-- Performance: Whether (one of) the alternatives must be performed --> +<!-- not #REQUIRED! --> + +<!ENTITY % stepalternatives.attlist "INCLUDE"> +<![%stepalternatives.attlist;[ +<!ATTLIST stepalternatives + performance (optional + |required) "required" + %common.attrib; + %stepalternatives.role.attrib; + %local.stepalternatives.attrib; +> +<!--end of stepalternatives.attlist-->]]> +<!--end of stepalternatives.module-->]]> +<!--end of procedure.content.module-->]]> + +<!-- Sidebar .......................... --> + +<!ENTITY % sidebar.content.model "INCLUDE"> +<![ %sidebar.content.model; [ + +<!ENTITY % sidebarinfo.module "INCLUDE"> +<![ %sidebarinfo.module; [ +<!ENTITY % local.sidebarinfo.attrib ""> +<!ENTITY % sidebarinfo.role.attrib "%role.attrib;"> + +<!ENTITY % sidebarinfo.element "INCLUDE"> +<![ %sidebarinfo.element; [ +<!--doc:Meta-information for a Sidebar.--> +<!ELEMENT sidebarinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of sidebarinfo.element-->]]> + +<!ENTITY % sidebarinfo.attlist "INCLUDE"> +<![ %sidebarinfo.attlist; [ +<!ATTLIST sidebarinfo + %common.attrib; + %sidebarinfo.role.attrib; + %local.sidebarinfo.attrib; +> +<!--end of sidebarinfo.attlist-->]]> +<!--end of sidebarinfo.module-->]]> + +<!ENTITY % sidebar.module "INCLUDE"> +<![%sidebar.module;[ +<!ENTITY % local.sidebar.attrib ""> +<!ENTITY % sidebar.role.attrib "%role.attrib;"> + +<!ENTITY % sidebar.element "INCLUDE"> +<![%sidebar.element;[ +<!--doc:A portion of a document that is isolated from the main narrative flow.--> +<!ELEMENT sidebar %ho; (sidebarinfo?, + (%formalobject.title.content;)?, + (%sidebar.mix;)+)> +<!--end of sidebar.element-->]]> + +<!ENTITY % sidebar.attlist "INCLUDE"> +<![%sidebar.attlist;[ +<!ATTLIST sidebar + %common.attrib; + %sidebar.role.attrib; + %local.sidebar.attrib; +> +<!--end of sidebar.attlist-->]]> +<!--end of sidebar.module-->]]> +<!--end of sidebar.content.model-->]]> + +<!-- ...................................................................... --> +<!-- Paragraph-related elements ........................................... --> + +<!ENTITY % abstract.module "INCLUDE"> +<![%abstract.module;[ +<!ENTITY % local.abstract.attrib ""> +<!ENTITY % abstract.role.attrib "%role.attrib;"> + +<!ENTITY % abstract.element "INCLUDE"> +<![%abstract.element;[ +<!--doc:A summary.--> +<!ELEMENT abstract %ho; (title?, (%para.class;)+)> +<!--end of abstract.element-->]]> + +<!ENTITY % abstract.attlist "INCLUDE"> +<![%abstract.attlist;[ +<!ATTLIST abstract + %common.attrib; + %abstract.role.attrib; + %local.abstract.attrib; +> +<!--end of abstract.attlist-->]]> +<!--end of abstract.module-->]]> + +<!ENTITY % authorblurb.module "INCLUDE"> +<![%authorblurb.module;[ +<!ENTITY % local.authorblurb.attrib ""> +<!ENTITY % authorblurb.role.attrib "%role.attrib;"> + +<!ENTITY % authorblurb.element "INCLUDE"> +<![%authorblurb.element;[ +<!--doc:A short description or note about an author.--> +<!ELEMENT authorblurb %ho; (title?, (%para.class;)+)> +<!--end of authorblurb.element-->]]> + +<!ENTITY % authorblurb.attlist "INCLUDE"> +<![%authorblurb.attlist;[ +<!ATTLIST authorblurb + %common.attrib; + %authorblurb.role.attrib; + %local.authorblurb.attrib; +> +<!--end of authorblurb.attlist-->]]> +<!--end of authorblurb.module-->]]> + +<!ENTITY % personblurb.module "INCLUDE"> +<![%personblurb.module;[ +<!ENTITY % local.personblurb.attrib ""> +<!ENTITY % personblurb.role.attrib "%role.attrib;"> + +<!ENTITY % personblurb.element "INCLUDE"> +<![%personblurb.element;[ +<!--doc:A short description or note about a person.--> +<!ELEMENT personblurb %ho; (title?, (%para.class;)+)> +<!--end of personblurb.element-->]]> + +<!ENTITY % personblurb.attlist "INCLUDE"> +<![%personblurb.attlist;[ +<!ATTLIST personblurb + %common.attrib; + %personblurb.role.attrib; + %local.personblurb.attrib; +> +<!--end of personblurb.attlist-->]]> +<!--end of personblurb.module-->]]> + +<!ENTITY % blockquote.module "INCLUDE"> +<![%blockquote.module;[ + +<!ENTITY % local.blockquote.attrib ""> +<!ENTITY % blockquote.role.attrib "%role.attrib;"> + +<!ENTITY % blockquote.element "INCLUDE"> +<![%blockquote.element;[ +<!--doc:A quotation set off from the main text.--> +<!ELEMENT blockquote %ho; (blockinfo?, title?, attribution?, (%component.mix;)+) + %blockquote.exclusion;> +<!--end of blockquote.element-->]]> + +<!ENTITY % blockquote.attlist "INCLUDE"> +<![%blockquote.attlist;[ +<!ATTLIST blockquote + %common.attrib; + %blockquote.role.attrib; + %local.blockquote.attrib; +> +<!--end of blockquote.attlist-->]]> +<!--end of blockquote.module-->]]> + +<!ENTITY % attribution.module "INCLUDE"> +<![%attribution.module;[ +<!ENTITY % local.attribution.attrib ""> +<!ENTITY % attribution.role.attrib "%role.attrib;"> + +<!ENTITY % attribution.element "INCLUDE"> +<![%attribution.element;[ +<!--doc:The source of a block quote or epigraph.--> +<!ELEMENT attribution %ho; (%para.char.mix;)*> +<!--end of attribution.element-->]]> + +<!ENTITY % attribution.attlist "INCLUDE"> +<![%attribution.attlist;[ +<!ATTLIST attribution + %common.attrib; + %attribution.role.attrib; + %local.attribution.attrib; +> +<!--end of attribution.attlist-->]]> +<!--end of attribution.module-->]]> + +<!ENTITY % bridgehead.module "INCLUDE"> +<![%bridgehead.module;[ +<!ENTITY % local.bridgehead.attrib ""> +<!ENTITY % bridgehead.role.attrib "%role.attrib;"> + +<!ENTITY % bridgehead.element "INCLUDE"> +<![%bridgehead.element;[ +<!--doc:A free-floating heading.--> +<!ELEMENT bridgehead %ho; (%title.char.mix;)*> +<!--end of bridgehead.element-->]]> + +<!-- Renderas: Indicates the format in which the BridgeHead + should appear --> + + +<!ENTITY % bridgehead.attlist "INCLUDE"> +<![%bridgehead.attlist;[ +<!ATTLIST bridgehead + renderas (other + |sect1 + |sect2 + |sect3 + |sect4 + |sect5) #IMPLIED + %common.attrib; + %bridgehead.role.attrib; + %local.bridgehead.attrib; +> +<!--end of bridgehead.attlist-->]]> +<!--end of bridgehead.module-->]]> + +<!ENTITY % remark.module "INCLUDE"> +<![%remark.module;[ +<!ENTITY % local.remark.attrib ""> +<!ENTITY % remark.role.attrib "%role.attrib;"> + +<!ENTITY % remark.element "INCLUDE"> +<![%remark.element;[ +<!--doc:A remark (or comment) intended for presentation in a draft manuscript.--> +<!ELEMENT remark %ho; (%para.char.mix;)* + %remark.exclusion;> +<!--end of remark.element-->]]> + +<!ENTITY % remark.attlist "INCLUDE"> +<![%remark.attlist;[ +<!ATTLIST remark + %common.attrib; + %remark.role.attrib; + %local.remark.attrib; +> +<!--end of remark.attlist-->]]> +<!--end of remark.module-->]]> + +<!ENTITY % epigraph.module "INCLUDE"> +<![%epigraph.module;[ +<!ENTITY % local.epigraph.attrib ""> +<!ENTITY % epigraph.role.attrib "%role.attrib;"> + +<!ENTITY % epigraph.element "INCLUDE"> +<![%epigraph.element;[ +<!--doc:A short inscription at the beginning of a document or component.--> +<!ELEMENT epigraph %ho; (attribution?, ((%para.class;)|literallayout)+)> +<!--end of epigraph.element-->]]> + +<!ENTITY % epigraph.attlist "INCLUDE"> +<![%epigraph.attlist;[ +<!ATTLIST epigraph + %common.attrib; + %epigraph.role.attrib; + %local.epigraph.attrib; +> +<!--end of epigraph.attlist-->]]> +<!-- Attribution (defined above)--> +<!--end of epigraph.module-->]]> + +<!ENTITY % footnote.module "INCLUDE"> +<![%footnote.module;[ +<!ENTITY % local.footnote.attrib ""> +<!ENTITY % footnote.role.attrib "%role.attrib;"> + +<!ENTITY % footnote.element "INCLUDE"> +<![%footnote.element;[ +<!--doc:A footnote.--> +<!ELEMENT footnote %ho; ((%footnote.mix;)+) + %footnote.exclusion;> +<!--end of footnote.element-->]]> + +<!ENTITY % footnote.attlist "INCLUDE"> +<![%footnote.attlist;[ +<!ATTLIST footnote + %label.attrib; + %common.attrib; + %footnote.role.attrib; + %local.footnote.attrib; +> +<!--end of footnote.attlist-->]]> +<!--end of footnote.module-->]]> + +<!ENTITY % highlights.module "INCLUDE"> +<![%highlights.module;[ +<!ENTITY % local.highlights.attrib ""> +<!ENTITY % highlights.role.attrib "%role.attrib;"> + +<!ENTITY % highlights.element "INCLUDE"> +<![%highlights.element;[ +<!--doc:A summary of the main points of the discussed component.--> +<!ELEMENT highlights %ho; ((%highlights.mix;)+) + %highlights.exclusion;> +<!--end of highlights.element-->]]> + +<!ENTITY % highlights.attlist "INCLUDE"> +<![%highlights.attlist;[ +<!ATTLIST highlights + %common.attrib; + %highlights.role.attrib; + %local.highlights.attrib; +> +<!--end of highlights.attlist-->]]> +<!--end of highlights.module-->]]> + +<!ENTITY % formalpara.module "INCLUDE"> +<![%formalpara.module;[ +<!ENTITY % local.formalpara.attrib ""> +<!ENTITY % formalpara.role.attrib "%role.attrib;"> + +<!ENTITY % formalpara.element "INCLUDE"> +<![%formalpara.element;[ +<!--doc:A paragraph with a title.--> +<!ELEMENT formalpara %ho; (title, (%ndxterm.class;)*, para)> +<!--end of formalpara.element-->]]> + +<!ENTITY % formalpara.attlist "INCLUDE"> +<![%formalpara.attlist;[ +<!ATTLIST formalpara + %common.attrib; + %formalpara.role.attrib; + %local.formalpara.attrib; +> +<!--end of formalpara.attlist-->]]> +<!--end of formalpara.module-->]]> + +<!ENTITY % para.module "INCLUDE"> +<![%para.module;[ +<!ENTITY % local.para.attrib ""> +<!ENTITY % para.role.attrib "%role.attrib;"> + +<!ENTITY % para.element "INCLUDE"> +<![%para.element;[ +<!--doc:A paragraph.--> +<!ELEMENT para %ho; (%para.char.mix; | %para.mix;)*> +<!--end of para.element-->]]> + +<!ENTITY % para.attlist "INCLUDE"> +<![%para.attlist;[ +<!ATTLIST para + %common.attrib; + %para.role.attrib; + %local.para.attrib; +> +<!--end of para.attlist-->]]> +<!--end of para.module-->]]> + +<!ENTITY % simpara.module "INCLUDE"> +<![%simpara.module;[ +<!ENTITY % local.simpara.attrib ""> +<!ENTITY % simpara.role.attrib "%role.attrib;"> + +<!ENTITY % simpara.element "INCLUDE"> +<![%simpara.element;[ +<!--doc:A paragraph that contains only text and inline markup, no block elements.--> +<!ELEMENT simpara %ho; (%para.char.mix;)*> +<!--end of simpara.element-->]]> + +<!ENTITY % simpara.attlist "INCLUDE"> +<![%simpara.attlist;[ +<!ATTLIST simpara + %common.attrib; + %simpara.role.attrib; + %local.simpara.attrib; +> +<!--end of simpara.attlist-->]]> +<!--end of simpara.module-->]]> + +<!ENTITY % admon.module "INCLUDE"> +<![%admon.module;[ +<!ENTITY % local.admon.attrib ""> +<!ENTITY % admon.role.attrib "%role.attrib;"> + + +<!ENTITY % caution.element "INCLUDE"> +<![%caution.element;[ +<!--doc:A note of caution.--> +<!ELEMENT caution %ho; (title?, (%admon.mix;)+) + %admon.exclusion;> +<!--end of caution.element-->]]> + +<!ENTITY % caution.attlist "INCLUDE"> +<![%caution.attlist;[ +<!ATTLIST caution + %common.attrib; + %admon.role.attrib; + %local.admon.attrib; +> +<!--end of caution.attlist-->]]> + + +<!ENTITY % important.element "INCLUDE"> +<![%important.element;[ +<!--doc:An admonition set off from the text.--> +<!ELEMENT important %ho; (title?, (%admon.mix;)+) + %admon.exclusion;> +<!--end of important.element-->]]> + +<!ENTITY % important.attlist "INCLUDE"> +<![%important.attlist;[ +<!ATTLIST important + %common.attrib; + %admon.role.attrib; + %local.admon.attrib; +> +<!--end of important.attlist-->]]> + + +<!ENTITY % note.element "INCLUDE"> +<![%note.element;[ +<!--doc:A message set off from the text.--> +<!ELEMENT note %ho; (title?, (%admon.mix;)+) + %admon.exclusion;> +<!--end of note.element-->]]> + +<!ENTITY % note.attlist "INCLUDE"> +<![%note.attlist;[ +<!ATTLIST note + %common.attrib; + %admon.role.attrib; + %local.admon.attrib; +> +<!--end of note.attlist-->]]> + +<!ENTITY % tip.element "INCLUDE"> +<![%tip.element;[ +<!--doc:A suggestion to the user, set off from the text.--> +<!ELEMENT tip %ho; (title?, (%admon.mix;)+) + %admon.exclusion;> +<!--end of tip.element-->]]> + +<!ENTITY % tip.attlist "INCLUDE"> +<![%tip.attlist;[ +<!ATTLIST tip + %common.attrib; + %admon.role.attrib; + %local.admon.attrib; +> +<!--end of tip.attlist-->]]> + + +<!ENTITY % warning.element "INCLUDE"> +<![%warning.element;[ +<!--doc:An admonition set off from the text.--> +<!ELEMENT warning %ho; (title?, (%admon.mix;)+) + %admon.exclusion;> +<!--end of warning.element-->]]> + +<!ENTITY % warning.attlist "INCLUDE"> +<![%warning.attlist;[ +<!ATTLIST warning + %common.attrib; + %admon.role.attrib; + %local.admon.attrib; +> +<!--end of warning.attlist-->]]> + +<!--end of admon.module-->]]> + +<!-- ...................................................................... --> +<!-- Lists ................................................................ --> + +<!-- GlossList ........................ --> + +<!ENTITY % glosslist.module "INCLUDE"> +<![%glosslist.module;[ +<!ENTITY % local.glosslist.attrib ""> +<!ENTITY % glosslist.role.attrib "%role.attrib;"> + +<!ENTITY % glosslist.element "INCLUDE"> +<![%glosslist.element;[ +<!--doc:A wrapper for a set of GlossEntrys.--> +<!ELEMENT glosslist %ho; (blockinfo?, (%formalobject.title.content;)?, glossentry+)> +<!--end of glosslist.element-->]]> + +<!ENTITY % glosslist.attlist "INCLUDE"> +<![%glosslist.attlist;[ +<!ATTLIST glosslist + %common.attrib; + %glosslist.role.attrib; + %local.glosslist.attrib; +> +<!--end of glosslist.attlist-->]]> +<!--end of glosslist.module-->]]> + +<!ENTITY % glossentry.content.module "INCLUDE"> +<![%glossentry.content.module;[ +<!ENTITY % glossentry.module "INCLUDE"> +<![%glossentry.module;[ +<!ENTITY % local.glossentry.attrib ""> +<!ENTITY % glossentry.role.attrib "%role.attrib;"> + +<!ENTITY % glossentry.element "INCLUDE"> +<![%glossentry.element;[ +<!--doc:An entry in a Glossary or GlossList.--> +<!ELEMENT glossentry %ho; (glossterm, acronym?, abbrev?, + (%ndxterm.class;)*, + revhistory?, (glosssee|glossdef+))> +<!--end of glossentry.element-->]]> + +<!-- SortAs: String by which the GlossEntry is to be sorted + (alphabetized) in lieu of its proper content --> + + +<!ENTITY % glossentry.attlist "INCLUDE"> +<![%glossentry.attlist;[ +<!ATTLIST glossentry + sortas CDATA #IMPLIED + %common.attrib; + %glossentry.role.attrib; + %local.glossentry.attrib; +> +<!--end of glossentry.attlist-->]]> +<!--end of glossentry.module-->]]> + +<!-- GlossTerm (defined in the Inlines section, below)--> +<!ENTITY % glossdef.module "INCLUDE"> +<![%glossdef.module;[ +<!ENTITY % local.glossdef.attrib ""> +<!ENTITY % glossdef.role.attrib "%role.attrib;"> + +<!ENTITY % glossdef.element "INCLUDE"> +<![%glossdef.element;[ +<!--doc:A definition in a GlossEntry.--> +<!ELEMENT glossdef %ho; ((%glossdef.mix;)+, glossseealso*)> +<!--end of glossdef.element-->]]> + +<!-- Subject: List of subjects; keywords for the definition --> + + +<!ENTITY % glossdef.attlist "INCLUDE"> +<![%glossdef.attlist;[ +<!ATTLIST glossdef + subject CDATA #IMPLIED + %common.attrib; + %glossdef.role.attrib; + %local.glossdef.attrib; +> +<!--end of glossdef.attlist-->]]> +<!--end of glossdef.module-->]]> + +<!ENTITY % glosssee.module "INCLUDE"> +<![%glosssee.module;[ +<!ENTITY % local.glosssee.attrib ""> +<!ENTITY % glosssee.role.attrib "%role.attrib;"> + +<!ENTITY % glosssee.element "INCLUDE"> +<![%glosssee.element;[ +<!--doc:A cross-reference from one GlossEntry to another.--> +<!ELEMENT glosssee %ho; (%para.char.mix;)*> +<!--end of glosssee.element-->]]> + +<!-- OtherTerm: Reference to the GlossEntry whose GlossTerm + should be displayed at the point of the GlossSee --> + + +<!ENTITY % glosssee.attlist "INCLUDE"> +<![%glosssee.attlist;[ +<!ATTLIST glosssee + otherterm IDREF #IMPLIED + %common.attrib; + %glosssee.role.attrib; + %local.glosssee.attrib; +> +<!--end of glosssee.attlist-->]]> +<!--end of glosssee.module-->]]> + +<!ENTITY % glossseealso.module "INCLUDE"> +<![%glossseealso.module;[ +<!ENTITY % local.glossseealso.attrib ""> +<!ENTITY % glossseealso.role.attrib "%role.attrib;"> + +<!ENTITY % glossseealso.element "INCLUDE"> +<![%glossseealso.element;[ +<!--doc:A cross-reference from one GlossEntry to another.--> +<!ELEMENT glossseealso %ho; (%para.char.mix;)*> +<!--end of glossseealso.element-->]]> + +<!-- OtherTerm: Reference to the GlossEntry whose GlossTerm + should be displayed at the point of the GlossSeeAlso --> + + +<!ENTITY % glossseealso.attlist "INCLUDE"> +<![%glossseealso.attlist;[ +<!ATTLIST glossseealso + otherterm IDREF #IMPLIED + %common.attrib; + %glossseealso.role.attrib; + %local.glossseealso.attrib; +> +<!--end of glossseealso.attlist-->]]> +<!--end of glossseealso.module-->]]> +<!--end of glossentry.content.module-->]]> + +<!-- ItemizedList and OrderedList ..... --> + +<!ENTITY % itemizedlist.module "INCLUDE"> +<![%itemizedlist.module;[ +<!ENTITY % local.itemizedlist.attrib ""> +<!ENTITY % itemizedlist.role.attrib "%role.attrib;"> + +<!ENTITY % itemizedlist.element "INCLUDE"> +<![%itemizedlist.element;[ +<!--doc:A list in which each entry is marked with a bullet or other dingbat.--> +<!ELEMENT itemizedlist %ho; (blockinfo?, (%formalobject.title.content;)?, + (%listpreamble.mix;)*, listitem+)> + +<!--end of itemizedlist.element-->]]> + +<!-- Spacing: Whether the vertical space in the list should be + compressed --> +<!-- Mark: Keyword, e.g., bullet, dash, checkbox, none; + list of keywords and defaults are implementation specific --> + + +<!ENTITY % itemizedlist.attlist "INCLUDE"> +<![%itemizedlist.attlist;[ +<!ATTLIST itemizedlist + spacing (normal + |compact) #IMPLIED + %mark.attrib; + %common.attrib; + %itemizedlist.role.attrib; + %local.itemizedlist.attrib; +> +<!--end of itemizedlist.attlist-->]]> +<!--end of itemizedlist.module-->]]> + +<!ENTITY % orderedlist.module "INCLUDE"> +<![%orderedlist.module;[ +<!ENTITY % local.orderedlist.attrib ""> +<!ENTITY % orderedlist.role.attrib "%role.attrib;"> + +<!ENTITY % orderedlist.element "INCLUDE"> +<![%orderedlist.element;[ +<!--doc:A list in which each entry is marked with a sequentially incremented label.--> +<!ELEMENT orderedlist %ho; (blockinfo?, (%formalobject.title.content;)?, + (%listpreamble.mix;)*, listitem+)> + +<!--end of orderedlist.element-->]]> + +<!-- Numeration: Style of ListItem numbered; default is expected + to be Arabic --> +<!-- InheritNum: Specifies for a nested list that the numbering + of ListItems should include the number of the item + within which they are nested (e.g., 1a and 1b within 1, + rather than a and b) --> +<!-- Continuation: Where list numbering begins afresh (Restarts, + the default) or continues that of the immediately preceding + list (Continues) --> +<!-- Spacing: Whether the vertical space in the list should be + compressed --> + + +<!ENTITY % orderedlist.attlist "INCLUDE"> +<![%orderedlist.attlist;[ +<!ATTLIST orderedlist + numeration (arabic + |upperalpha + |loweralpha + |upperroman + |lowerroman) #IMPLIED + inheritnum (inherit + |ignore) "ignore" + continuation (continues + |restarts) "restarts" + spacing (normal + |compact) #IMPLIED + %common.attrib; + %orderedlist.role.attrib; + %local.orderedlist.attrib; +> +<!--end of orderedlist.attlist-->]]> +<!--end of orderedlist.module-->]]> + +<!ENTITY % listitem.module "INCLUDE"> +<![%listitem.module;[ +<!ENTITY % local.listitem.attrib ""> +<!ENTITY % listitem.role.attrib "%role.attrib;"> + +<!ENTITY % listitem.element "INCLUDE"> +<![%listitem.element;[ +<!--doc:A wrapper for the elements of a list item.--> +<!ELEMENT listitem %ho; ((%component.mix;)+)> +<!--end of listitem.element-->]]> + +<!-- Override: Indicates the mark to be used for this ListItem + instead of the default mark or the mark specified by + the Mark attribute on the enclosing ItemizedList --> + + +<!ENTITY % listitem.attlist "INCLUDE"> +<![%listitem.attlist;[ +<!ATTLIST listitem + override CDATA #IMPLIED + %common.attrib; + %listitem.role.attrib; + %local.listitem.attrib; +> +<!--end of listitem.attlist-->]]> +<!--end of listitem.module-->]]> + +<!-- SegmentedList .................... --> +<!ENTITY % segmentedlist.content.module "INCLUDE"> +<![%segmentedlist.content.module;[ +<!ENTITY % segmentedlist.module "INCLUDE"> +<![%segmentedlist.module;[ +<!ENTITY % local.segmentedlist.attrib ""> +<!ENTITY % segmentedlist.role.attrib "%role.attrib;"> + +<!ENTITY % segmentedlist.element "INCLUDE"> +<![%segmentedlist.element;[ +<!--doc:A segmented list, a list of sets of elements.--> +<!ELEMENT segmentedlist %ho; ((%formalobject.title.content;)?, + segtitle+, + seglistitem+)> +<!--end of segmentedlist.element-->]]> + +<!ENTITY % segmentedlist.attlist "INCLUDE"> +<![%segmentedlist.attlist;[ +<!ATTLIST segmentedlist + %common.attrib; + %segmentedlist.role.attrib; + %local.segmentedlist.attrib; +> +<!--end of segmentedlist.attlist-->]]> +<!--end of segmentedlist.module-->]]> + +<!ENTITY % segtitle.module "INCLUDE"> +<![%segtitle.module;[ +<!ENTITY % local.segtitle.attrib ""> +<!ENTITY % segtitle.role.attrib "%role.attrib;"> + +<!ENTITY % segtitle.element "INCLUDE"> +<![%segtitle.element;[ +<!--doc:The title of an element of a list item in a segmented list.--> +<!ELEMENT segtitle %ho; (%title.char.mix;)*> +<!--end of segtitle.element-->]]> + +<!ENTITY % segtitle.attlist "INCLUDE"> +<![%segtitle.attlist;[ +<!ATTLIST segtitle + %common.attrib; + %segtitle.role.attrib; + %local.segtitle.attrib; +> +<!--end of segtitle.attlist-->]]> +<!--end of segtitle.module-->]]> + +<!ENTITY % seglistitem.module "INCLUDE"> +<![%seglistitem.module;[ +<!ENTITY % local.seglistitem.attrib ""> +<!ENTITY % seglistitem.role.attrib "%role.attrib;"> + +<!ENTITY % seglistitem.element "INCLUDE"> +<![%seglistitem.element;[ +<!--doc:A list item in a segmented list.--> +<!ELEMENT seglistitem %ho; (seg+)> +<!--end of seglistitem.element-->]]> + +<!ENTITY % seglistitem.attlist "INCLUDE"> +<![%seglistitem.attlist;[ +<!ATTLIST seglistitem + %common.attrib; + %seglistitem.role.attrib; + %local.seglistitem.attrib; +> +<!--end of seglistitem.attlist-->]]> +<!--end of seglistitem.module-->]]> + +<!ENTITY % seg.module "INCLUDE"> +<![%seg.module;[ +<!ENTITY % local.seg.attrib ""> +<!ENTITY % seg.role.attrib "%role.attrib;"> + +<!ENTITY % seg.element "INCLUDE"> +<![%seg.element;[ +<!--doc:An element of a list item in a segmented list.--> +<!ELEMENT seg %ho; (%para.char.mix;)*> +<!--end of seg.element-->]]> + +<!ENTITY % seg.attlist "INCLUDE"> +<![%seg.attlist;[ +<!ATTLIST seg + %common.attrib; + %seg.role.attrib; + %local.seg.attrib; +> +<!--end of seg.attlist-->]]> +<!--end of seg.module-->]]> +<!--end of segmentedlist.content.module-->]]> + +<!-- SimpleList ....................... --> + +<!ENTITY % simplelist.content.module "INCLUDE"> +<![%simplelist.content.module;[ +<!ENTITY % simplelist.module "INCLUDE"> +<![%simplelist.module;[ +<!ENTITY % local.simplelist.attrib ""> +<!ENTITY % simplelist.role.attrib "%role.attrib;"> + +<!ENTITY % simplelist.element "INCLUDE"> +<![%simplelist.element;[ +<!--doc:An undecorated list of single words or short phrases.--> +<!ELEMENT simplelist %ho; (member+)> +<!--end of simplelist.element-->]]> + +<!-- Columns: The number of columns the array should contain --> +<!-- Type: How the Members of the SimpleList should be + formatted: Inline (members separated with commas etc. + inline), Vert (top to bottom in n Columns), or Horiz (in + the direction of text flow) in n Columns. If Column + is 1 or implied, Type=Vert and Type=Horiz give the same + results. --> + + +<!ENTITY % simplelist.attlist "INCLUDE"> +<![%simplelist.attlist;[ +<!ATTLIST simplelist + columns CDATA #IMPLIED + type (inline + |vert + |horiz) "vert" + %common.attrib; + %simplelist.role.attrib; + %local.simplelist.attrib; +> +<!--end of simplelist.attlist-->]]> +<!--end of simplelist.module-->]]> + +<!ENTITY % member.module "INCLUDE"> +<![%member.module;[ +<!ENTITY % local.member.attrib ""> +<!ENTITY % member.role.attrib "%role.attrib;"> + +<!ENTITY % member.element "INCLUDE"> +<![%member.element;[ +<!--doc:An element of a simple list.--> +<!ELEMENT member %ho; (%para.char.mix;)*> +<!--end of member.element-->]]> + +<!ENTITY % member.attlist "INCLUDE"> +<![%member.attlist;[ +<!ATTLIST member + %common.attrib; + %member.role.attrib; + %local.member.attrib; +> +<!--end of member.attlist-->]]> +<!--end of member.module-->]]> +<!--end of simplelist.content.module-->]]> + +<!-- VariableList ..................... --> + +<!ENTITY % variablelist.content.module "INCLUDE"> +<![%variablelist.content.module;[ +<!ENTITY % variablelist.module "INCLUDE"> +<![%variablelist.module;[ +<!ENTITY % local.variablelist.attrib ""> +<!ENTITY % variablelist.role.attrib "%role.attrib;"> + +<!ENTITY % variablelist.element "INCLUDE"> +<![%variablelist.element;[ +<!--doc:A list in which each entry is composed of a set of one or more terms and an associated description.--> +<!ELEMENT variablelist %ho; (blockinfo?, (%formalobject.title.content;)?, + (%listpreamble.mix;)*, varlistentry+)> +<!--end of variablelist.element-->]]> + +<!-- TermLength: Length beyond which the presentation engine + may consider the Term too long and select an alternate + presentation of the Term and, or, its associated ListItem. --> + + +<!ENTITY % variablelist.attlist "INCLUDE"> +<![%variablelist.attlist;[ +<!ATTLIST variablelist + termlength CDATA #IMPLIED + spacing (normal + |compact) #IMPLIED + %common.attrib; + %variablelist.role.attrib; + %local.variablelist.attrib; +> +<!--end of variablelist.attlist-->]]> +<!--end of variablelist.module-->]]> + +<!ENTITY % varlistentry.module "INCLUDE"> +<![%varlistentry.module;[ +<!ENTITY % local.varlistentry.attrib ""> +<!ENTITY % varlistentry.role.attrib "%role.attrib;"> + +<!ENTITY % varlistentry.element "INCLUDE"> +<![%varlistentry.element;[ +<!--doc:A wrapper for a set of terms and the associated description in a variable list.--> +<!ELEMENT varlistentry %ho; (term+, listitem)> +<!--end of varlistentry.element-->]]> + +<!ENTITY % varlistentry.attlist "INCLUDE"> +<![%varlistentry.attlist;[ +<!ATTLIST varlistentry + %common.attrib; + %varlistentry.role.attrib; + %local.varlistentry.attrib; +> +<!--end of varlistentry.attlist-->]]> +<!--end of varlistentry.module-->]]> + +<!ENTITY % term.module "INCLUDE"> +<![%term.module;[ +<!ENTITY % local.term.attrib ""> +<!ENTITY % term.role.attrib "%role.attrib;"> + +<!ENTITY % term.element "INCLUDE"> +<![%term.element;[ +<!--doc:The word or phrase being defined or described in a variable list.--> +<!ELEMENT term %ho; (%para.char.mix;)*> +<!--end of term.element-->]]> + +<!ENTITY % term.attlist "INCLUDE"> +<![%term.attlist;[ +<!ATTLIST term + %common.attrib; + %term.role.attrib; + %local.term.attrib; +> +<!--end of term.attlist-->]]> +<!--end of term.module-->]]> + +<!-- ListItem (defined above)--> +<!--end of variablelist.content.module-->]]> + +<!-- CalloutList ...................... --> + +<!ENTITY % calloutlist.content.module "INCLUDE"> +<![%calloutlist.content.module;[ +<!ENTITY % calloutlist.module "INCLUDE"> +<![%calloutlist.module;[ +<!ENTITY % local.calloutlist.attrib ""> +<!ENTITY % calloutlist.role.attrib "%role.attrib;"> + +<!ENTITY % calloutlist.element "INCLUDE"> +<![%calloutlist.element;[ +<!--doc:A list of Callouts.--> +<!ELEMENT calloutlist %ho; ((%formalobject.title.content;)?, callout+)> +<!--end of calloutlist.element-->]]> + +<!ENTITY % calloutlist.attlist "INCLUDE"> +<![%calloutlist.attlist;[ +<!ATTLIST calloutlist + %common.attrib; + %calloutlist.role.attrib; + %local.calloutlist.attrib; +> +<!--end of calloutlist.attlist-->]]> +<!--end of calloutlist.module-->]]> + +<!ENTITY % callout.module "INCLUDE"> +<![%callout.module;[ +<!ENTITY % local.callout.attrib ""> +<!ENTITY % callout.role.attrib "%role.attrib;"> + +<!ENTITY % callout.element "INCLUDE"> +<![%callout.element;[ +<!--doc:A “called out” description of a marked Area.--> +<!ELEMENT callout %ho; ((%component.mix;)+)> +<!--end of callout.element-->]]> + +<!-- AreaRefs: IDs of one or more Areas or AreaSets described + by this Callout --> + + +<!ENTITY % callout.attlist "INCLUDE"> +<![%callout.attlist;[ +<!ATTLIST callout + arearefs IDREFS #REQUIRED + %common.attrib; + %callout.role.attrib; + %local.callout.attrib; +> +<!--end of callout.attlist-->]]> +<!--end of callout.module-->]]> +<!--end of calloutlist.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Objects .............................................................. --> + +<!-- Examples etc. .................... --> + +<!ENTITY % example.module "INCLUDE"> +<![%example.module;[ +<!ENTITY % local.example.attrib ""> +<!ENTITY % example.role.attrib "%role.attrib;"> + +<!ENTITY % example.element "INCLUDE"> +<![%example.element;[ +<!--doc:A formal example, with a title.--> +<!ELEMENT example %ho; (blockinfo?, (%formalobject.title.content;), (%example.mix;)+) + %formal.exclusion;> +<!--end of example.element-->]]> + +<!ENTITY % example.attlist "INCLUDE"> +<![%example.attlist;[ +<!ATTLIST example + floatstyle CDATA #IMPLIED + %label.attrib; + %width.attrib; + %common.attrib; + %example.role.attrib; + %local.example.attrib; +> +<!--end of example.attlist-->]]> +<!--end of example.module-->]]> + +<!ENTITY % informalexample.module "INCLUDE"> +<![%informalexample.module;[ +<!ENTITY % local.informalexample.attrib ""> +<!ENTITY % informalexample.role.attrib "%role.attrib;"> + +<!ENTITY % informalexample.element "INCLUDE"> +<![%informalexample.element;[ +<!--doc:A displayed example without a title.--> +<!ELEMENT informalexample %ho; (blockinfo?, (%example.mix;)+)> +<!--end of informalexample.element-->]]> + +<!ENTITY % informalexample.attlist "INCLUDE"> +<![%informalexample.attlist;[ +<!ATTLIST informalexample + floatstyle CDATA #IMPLIED + %width.attrib; + %common.attrib; + %informalexample.role.attrib; + %local.informalexample.attrib; +> +<!--end of informalexample.attlist-->]]> +<!--end of informalexample.module-->]]> + +<!ENTITY % programlistingco.module "INCLUDE"> +<![%programlistingco.module;[ +<!ENTITY % local.programlistingco.attrib ""> +<!ENTITY % programlistingco.role.attrib "%role.attrib;"> + +<!ENTITY % programlistingco.element "INCLUDE"> +<![%programlistingco.element;[ +<!--doc:A program listing with associated areas used in callouts.--> +<!ELEMENT programlistingco %ho; (areaspec, programlisting, calloutlist*)> +<!--end of programlistingco.element-->]]> + +<!ENTITY % programlistingco.attlist "INCLUDE"> +<![%programlistingco.attlist;[ +<!ATTLIST programlistingco + %common.attrib; + %programlistingco.role.attrib; + %local.programlistingco.attrib; +> +<!--end of programlistingco.attlist-->]]> +<!-- CalloutList (defined above in Lists)--> +<!--end of informalexample.module-->]]> + +<!ENTITY % areaspec.content.module "INCLUDE"> +<![%areaspec.content.module;[ +<!ENTITY % areaspec.module "INCLUDE"> +<![%areaspec.module;[ +<!ENTITY % local.areaspec.attrib ""> +<!ENTITY % areaspec.role.attrib "%role.attrib;"> + +<!ENTITY % areaspec.element "INCLUDE"> +<![%areaspec.element;[ +<!--doc:A collection of regions in a graphic or code example.--> +<!ELEMENT areaspec %ho; ((area|areaset)+)> +<!--end of areaspec.element-->]]> + +<!-- Units: global unit of measure in which coordinates in + this spec are expressed: + + - CALSPair "x1,y1 x2,y2": lower-left and upper-right + coordinates in a rectangle describing repro area in which + graphic is placed, where X and Y dimensions are each some + number 0..10000 (taken from CALS graphic attributes) + + - LineColumn "line column": line number and column number + at which to start callout text in "linespecific" content + + - LineRange "startline endline": whole lines from startline + to endline in "linespecific" content + + - LineColumnPair "line1 col1 line2 col2": starting and ending + points of area in "linespecific" content that starts at + first position and ends at second position (including the + beginnings of any intervening lines) + + - Other: directive to look at value of OtherUnits attribute + to get implementation-specific keyword + + The default is implementation-specific; usually dependent on + the parent element (GraphicCO gets CALSPair, ProgramListingCO + and ScreenCO get LineColumn) --> +<!-- OtherUnits: User-defined units --> + + +<!ENTITY % areaspec.attlist "INCLUDE"> +<![%areaspec.attlist;[ +<!ATTLIST areaspec + units (calspair + |linecolumn + |linerange + |linecolumnpair + |other) #IMPLIED + otherunits NMTOKEN #IMPLIED + %common.attrib; + %areaspec.role.attrib; + %local.areaspec.attrib; +> +<!--end of areaspec.attlist-->]]> +<!--end of areaspec.module-->]]> + +<!ENTITY % area.module "INCLUDE"> +<![%area.module;[ +<!ENTITY % local.area.attrib ""> +<!ENTITY % area.role.attrib "%role.attrib;"> + +<!ENTITY % area.element "INCLUDE"> +<![%area.element;[ +<!--doc:A region defined for a Callout in a graphic or code example.--> +<!ELEMENT area %ho; EMPTY> +<!--end of area.element-->]]> + +<!-- bug number/symbol override or initialization --> +<!-- to any related information --> +<!-- Units: unit of measure in which coordinates in this + area are expressed; inherits from AreaSet and AreaSpec --> +<!-- OtherUnits: User-defined units --> + + +<!ENTITY % area.attlist "INCLUDE"> +<![%area.attlist;[ +<!ATTLIST area + %label.attrib; + %linkends.attrib; + units (calspair + |linecolumn + |linerange + |linecolumnpair + |other) #IMPLIED + otherunits NMTOKEN #IMPLIED + coords CDATA #REQUIRED + %idreq.common.attrib; + %area.role.attrib; + %local.area.attrib; +> +<!--end of area.attlist-->]]> +<!--end of area.module-->]]> + +<!ENTITY % areaset.module "INCLUDE"> +<![%areaset.module;[ +<!ENTITY % local.areaset.attrib ""> +<!ENTITY % areaset.role.attrib "%role.attrib;"> + +<!ENTITY % areaset.element "INCLUDE"> +<![%areaset.element;[ +<!--doc:A set of related areas in a graphic or code example.--> +<!ELEMENT areaset %ho; (area+)> +<!--end of areaset.element-->]]> + +<!-- bug number/symbol override or initialization --> +<!-- Units: unit of measure in which coordinates in this + area are expressed; inherits from AreaSpec --> + + +<!ENTITY % areaset.attlist "INCLUDE"> +<![%areaset.attlist;[ +<!ATTLIST areaset + %label.attrib; + units (calspair + |linecolumn + |linerange + |linecolumnpair + |other) #IMPLIED + otherunits NMTOKEN #IMPLIED + coords CDATA #REQUIRED + %idreq.common.attrib; + %areaset.role.attrib; + %local.areaset.attrib; +> +<!--end of areaset.attlist-->]]> +<!--end of areaset.module-->]]> +<!--end of areaspec.content.module-->]]> + +<!ENTITY % programlisting.module "INCLUDE"> +<![%programlisting.module;[ +<!ENTITY % local.programlisting.attrib ""> +<!ENTITY % programlisting.role.attrib "%role.attrib;"> + +<!ENTITY % programlisting.element "INCLUDE"> +<![%programlisting.element;[ +<!--doc:A literal listing of all or part of a program.--> +<!ELEMENT programlisting %ho; (%para.char.mix;|co|coref|lineannotation|textobject)*> +<!--end of programlisting.element-->]]> + +<!ENTITY % programlisting.attlist "INCLUDE"> +<![%programlisting.attlist;[ +<!ATTLIST programlisting + %width.attrib; + %linespecific.attrib; + %common.attrib; + %programlisting.role.attrib; + %local.programlisting.attrib; +> +<!--end of programlisting.attlist-->]]> +<!--end of programlisting.module-->]]> + +<!ENTITY % literallayout.module "INCLUDE"> +<![%literallayout.module;[ +<!ENTITY % local.literallayout.attrib ""> +<!ENTITY % literallayout.role.attrib "%role.attrib;"> + +<!ENTITY % literallayout.element "INCLUDE"> +<![%literallayout.element;[ +<!--doc:A block of text in which line breaks and white space are to be reproduced faithfully.--> +<!ELEMENT literallayout %ho; (%para.char.mix;|co|coref|textobject|lineannotation)*> +<!--end of literallayout.element-->]]> + +<!ENTITY % literallayout.attlist "INCLUDE"> +<![%literallayout.attlist;[ +<!ATTLIST literallayout + %width.attrib; + %linespecific.attrib; + class (monospaced|normal) "normal" + %common.attrib; + %literallayout.role.attrib; + %local.literallayout.attrib; +> +<!--end of literallayout.attlist-->]]> +<!-- LineAnnotation (defined in the Inlines section, below)--> +<!--end of literallayout.module-->]]> + +<!ENTITY % screenco.module "INCLUDE"> +<![%screenco.module;[ +<!ENTITY % local.screenco.attrib ""> +<!ENTITY % screenco.role.attrib "%role.attrib;"> + +<!ENTITY % screenco.element "INCLUDE"> +<![%screenco.element;[ +<!--doc:A screen with associated areas used in callouts.--> +<!ELEMENT screenco %ho; (areaspec, screen, calloutlist*)> +<!--end of screenco.element-->]]> + +<!ENTITY % screenco.attlist "INCLUDE"> +<![%screenco.attlist;[ +<!ATTLIST screenco + %common.attrib; + %screenco.role.attrib; + %local.screenco.attrib; +> +<!--end of screenco.attlist-->]]> +<!-- AreaSpec (defined above)--> +<!-- CalloutList (defined above in Lists)--> +<!--end of screenco.module-->]]> + +<!ENTITY % screen.module "INCLUDE"> +<![%screen.module;[ +<!ENTITY % local.screen.attrib ""> +<!ENTITY % screen.role.attrib "%role.attrib;"> + +<!ENTITY % screen.element "INCLUDE"> +<![%screen.element;[ +<!--doc:Text that a user sees or might see on a computer screen.--> +<!ELEMENT screen %ho; (%para.char.mix;|co|coref|textobject|lineannotation)*> +<!--end of screen.element-->]]> + +<!ENTITY % screen.attlist "INCLUDE"> +<![%screen.attlist;[ +<!ATTLIST screen + %width.attrib; + %linespecific.attrib; + %common.attrib; + %screen.role.attrib; + %local.screen.attrib; +> +<!--end of screen.attlist-->]]> +<!--end of screen.module-->]]> + +<!ENTITY % screenshot.content.module "INCLUDE"> +<![%screenshot.content.module;[ +<!ENTITY % screenshot.module "INCLUDE"> +<![%screenshot.module;[ +<!ENTITY % local.screenshot.attrib ""> +<!ENTITY % screenshot.role.attrib "%role.attrib;"> + +<!ENTITY % screenshot.element "INCLUDE"> +<![%screenshot.element;[ +<!--doc:A representation of what the user sees or might see on a computer screen.--> +<!ELEMENT screenshot %ho; (screeninfo?, + (graphic|graphicco + |mediaobject|mediaobjectco))> +<!--end of screenshot.element-->]]> + +<!ENTITY % screenshot.attlist "INCLUDE"> +<![%screenshot.attlist;[ +<!ATTLIST screenshot + %common.attrib; + %screenshot.role.attrib; + %local.screenshot.attrib; +> +<!--end of screenshot.attlist-->]]> +<!--end of screenshot.module-->]]> + +<!ENTITY % screeninfo.module "INCLUDE"> +<![%screeninfo.module;[ +<!ENTITY % local.screeninfo.attrib ""> +<!ENTITY % screeninfo.role.attrib "%role.attrib;"> + +<!ENTITY % screeninfo.element "INCLUDE"> +<![%screeninfo.element;[ +<!--doc:Information about how a screen shot was produced.--> +<!ELEMENT screeninfo %ho; (%para.char.mix;)* + %ubiq.exclusion;> +<!--end of screeninfo.element-->]]> + +<!ENTITY % screeninfo.attlist "INCLUDE"> +<![%screeninfo.attlist;[ +<!ATTLIST screeninfo + %common.attrib; + %screeninfo.role.attrib; + %local.screeninfo.attrib; +> +<!--end of screeninfo.attlist-->]]> +<!--end of screeninfo.module-->]]> +<!--end of screenshot.content.module-->]]> + +<!-- Figures etc. ..................... --> + +<!ENTITY % figure.module "INCLUDE"> +<![%figure.module;[ +<!ENTITY % local.figure.attrib ""> +<!ENTITY % figure.role.attrib "%role.attrib;"> + +<!ENTITY % figure.element "INCLUDE"> +<![%figure.element;[ +<!--doc:A formal figure, generally an illustration, with a title.--> +<!ELEMENT figure %ho; (blockinfo?, (%formalobject.title.content;), + (%figure.mix; | %link.char.class;)+)> +<!--end of figure.element-->]]> + +<!-- Float: Whether the Figure is supposed to be rendered + where convenient (yes (1) value) or at the place it occurs + in the text (no (0) value, the default) --> + + +<!ENTITY % figure.attlist "INCLUDE"> +<![%figure.attlist;[ +<!ATTLIST figure + float %yesorno.attvals; '0' + floatstyle CDATA #IMPLIED + pgwide %yesorno.attvals; #IMPLIED + %label.attrib; + %common.attrib; + %figure.role.attrib; + %local.figure.attrib; +> +<!--end of figure.attlist-->]]> +<!--end of figure.module-->]]> + +<!ENTITY % informalfigure.module "INCLUDE"> +<![ %informalfigure.module; [ +<!ENTITY % local.informalfigure.attrib ""> +<!ENTITY % informalfigure.role.attrib "%role.attrib;"> + +<!ENTITY % informalfigure.element "INCLUDE"> +<![ %informalfigure.element; [ +<!--doc:A untitled figure.--> +<!ELEMENT informalfigure %ho; (blockinfo?, (%figure.mix; | %link.char.class;)+)> +<!--end of informalfigure.element-->]]> + +<!ENTITY % informalfigure.attlist "INCLUDE"> +<![ %informalfigure.attlist; [ +<!-- +Float: Whether the Figure is supposed to be rendered +where convenient (yes (1) value) or at the place it occurs +in the text (no (0) value, the default) +--> +<!ATTLIST informalfigure + float %yesorno.attvals; "0" + floatstyle CDATA #IMPLIED + pgwide %yesorno.attvals; #IMPLIED + %label.attrib; + %common.attrib; + %informalfigure.role.attrib; + %local.informalfigure.attrib; +> +<!--end of informalfigure.attlist-->]]> +<!--end of informalfigure.module-->]]> + +<!ENTITY % graphicco.module "INCLUDE"> +<![%graphicco.module;[ +<!ENTITY % local.graphicco.attrib ""> +<!ENTITY % graphicco.role.attrib "%role.attrib;"> + +<!ENTITY % graphicco.element "INCLUDE"> +<![%graphicco.element;[ +<!--doc:A graphic that contains callout areas.--> +<!ELEMENT graphicco %ho; (areaspec, graphic, calloutlist*)> +<!--end of graphicco.element-->]]> + +<!ENTITY % graphicco.attlist "INCLUDE"> +<![%graphicco.attlist;[ +<!ATTLIST graphicco + %common.attrib; + %graphicco.role.attrib; + %local.graphicco.attrib; +> +<!--end of graphicco.attlist-->]]> +<!-- AreaSpec (defined above in Examples)--> +<!-- CalloutList (defined above in Lists)--> +<!--end of graphicco.module-->]]> + +<!-- Graphical data can be the content of Graphic, or you can reference + an external file either as an entity (Entitref) or a filename + (Fileref). --> + +<!ENTITY % graphic.module "INCLUDE"> +<![%graphic.module;[ +<!ENTITY % local.graphic.attrib ""> +<!ENTITY % graphic.role.attrib "%role.attrib;"> + +<!ENTITY % graphic.element "INCLUDE"> +<![%graphic.element;[ +<!--doc:A displayed graphical object (not an inline).--> +<!ELEMENT graphic %ho; EMPTY> +<!--end of graphic.element-->]]> + +<!ENTITY % graphic.attlist "INCLUDE"> +<![%graphic.attlist;[ +<!ATTLIST graphic + %graphics.attrib; + %common.attrib; + %graphic.role.attrib; + %local.graphic.attrib; +> +<!--end of graphic.attlist-->]]> +<!--end of graphic.module-->]]> + +<!ENTITY % inlinegraphic.module "INCLUDE"> +<![%inlinegraphic.module;[ +<!ENTITY % local.inlinegraphic.attrib ""> +<!ENTITY % inlinegraphic.role.attrib "%role.attrib;"> + +<!ENTITY % inlinegraphic.element "INCLUDE"> +<![%inlinegraphic.element;[ +<!--doc:An object containing or pointing to graphical data that will be rendered inline.--> +<!ELEMENT inlinegraphic %ho; EMPTY> +<!--end of inlinegraphic.element-->]]> + +<!ENTITY % inlinegraphic.attlist "INCLUDE"> +<![%inlinegraphic.attlist;[ +<!ATTLIST inlinegraphic + %graphics.attrib; + %common.attrib; + %inlinegraphic.role.attrib; + %local.inlinegraphic.attrib; +> +<!--end of inlinegraphic.attlist-->]]> +<!--end of inlinegraphic.module-->]]> + +<!ENTITY % mediaobject.content.module "INCLUDE"> +<![ %mediaobject.content.module; [ + +<!ENTITY % mediaobject.module "INCLUDE"> +<![ %mediaobject.module; [ +<!ENTITY % local.mediaobject.attrib ""> +<!ENTITY % mediaobject.role.attrib "%role.attrib;"> + +<!ENTITY % mediaobject.element "INCLUDE"> +<![ %mediaobject.element; [ +<!--doc:A displayed media object (video, audio, image, etc.).--> +<!ELEMENT mediaobject %ho; (objectinfo?, + (%mediaobject.mix;)+, + caption?)> +<!--end of mediaobject.element-->]]> + +<!ENTITY % mediaobject.attlist "INCLUDE"> +<![ %mediaobject.attlist; [ +<!ATTLIST mediaobject + %common.attrib; + %mediaobject.role.attrib; + %local.mediaobject.attrib; +> +<!--end of mediaobject.attlist-->]]> +<!--end of mediaobject.module-->]]> + +<!ENTITY % inlinemediaobject.module "INCLUDE"> +<![ %inlinemediaobject.module; [ +<!ENTITY % local.inlinemediaobject.attrib ""> +<!ENTITY % inlinemediaobject.role.attrib "%role.attrib;"> + +<!ENTITY % inlinemediaobject.element "INCLUDE"> +<![ %inlinemediaobject.element; [ +<!--doc:An inline media object (video, audio, image, and so on).--> +<!ELEMENT inlinemediaobject %ho; (objectinfo?, + (%mediaobject.mix;)+)> +<!--end of inlinemediaobject.element-->]]> + +<!ENTITY % inlinemediaobject.attlist "INCLUDE"> +<![ %inlinemediaobject.attlist; [ +<!ATTLIST inlinemediaobject + %common.attrib; + %inlinemediaobject.role.attrib; + %local.inlinemediaobject.attrib; +> +<!--end of inlinemediaobject.attlist-->]]> +<!--end of inlinemediaobject.module-->]]> + +<!ENTITY % videoobject.module "INCLUDE"> +<![ %videoobject.module; [ +<!ENTITY % local.videoobject.attrib ""> +<!ENTITY % videoobject.role.attrib "%role.attrib;"> + +<!ENTITY % videoobject.element "INCLUDE"> +<![ %videoobject.element; [ +<!--doc:A wrapper for video data and its associated meta-information.--> +<!ELEMENT videoobject %ho; (objectinfo?, videodata)> +<!--end of videoobject.element-->]]> + +<!ENTITY % videoobject.attlist "INCLUDE"> +<![ %videoobject.attlist; [ +<!ATTLIST videoobject + %common.attrib; + %videoobject.role.attrib; + %local.videoobject.attrib; +> +<!--end of videoobject.attlist-->]]> +<!--end of videoobject.module-->]]> + +<!ENTITY % audioobject.module "INCLUDE"> +<![ %audioobject.module; [ +<!ENTITY % local.audioobject.attrib ""> +<!ENTITY % audioobject.role.attrib "%role.attrib;"> + +<!ENTITY % audioobject.element "INCLUDE"> +<![ %audioobject.element; [ +<!--doc:A wrapper for audio data and its associated meta-information.--> +<!ELEMENT audioobject %ho; (objectinfo?, audiodata)> +<!--end of audioobject.element-->]]> + +<!ENTITY % audioobject.attlist "INCLUDE"> +<![ %audioobject.attlist; [ +<!ATTLIST audioobject + %common.attrib; + %audioobject.role.attrib; + %local.audioobject.attrib; +> +<!--end of audioobject.attlist-->]]> +<!--end of audioobject.module-->]]> + +<!ENTITY % imageobject.module "INCLUDE"> +<![ %imageobject.module; [ +<!ENTITY % local.imageobject.attrib ""> +<!ENTITY % imageobject.role.attrib "%role.attrib;"> + +<!ENTITY % imageobject.element "INCLUDE"> +<![ %imageobject.element; [ +<!--doc:A wrapper for image data and its associated meta-information.--> +<!ELEMENT imageobject %ho; (objectinfo?, imagedata)> +<!--end of imageobject.element-->]]> + +<!ENTITY % imageobject.attlist "INCLUDE"> +<![ %imageobject.attlist; [ +<!ATTLIST imageobject + %common.attrib; + %imageobject.role.attrib; + %local.imageobject.attrib; +> +<!--end of imageobject.attlist-->]]> +<!--end of imageobject.module-->]]> + +<!ENTITY % textobject.module "INCLUDE"> +<![ %textobject.module; [ +<!ENTITY % local.textobject.attrib ""> +<!ENTITY % textobject.role.attrib "%role.attrib;"> + +<!ENTITY % textobject.element "INCLUDE"> +<![ %textobject.element; [ +<!--doc:A wrapper for a text description of an object and its associated meta-information.--> +<!ELEMENT textobject %ho; (objectinfo?, (phrase|textdata|(%textobject.mix;)+))> +<!--end of textobject.element-->]]> + +<!ENTITY % textobject.attlist "INCLUDE"> +<![ %textobject.attlist; [ +<!ATTLIST textobject + %common.attrib; + %textobject.role.attrib; + %local.textobject.attrib; +> +<!--end of textobject.attlist-->]]> +<!--end of textobject.module-->]]> + +<!ENTITY % objectinfo.module "INCLUDE"> +<![ %objectinfo.module; [ +<!ENTITY % local.objectinfo.attrib ""> +<!ENTITY % objectinfo.role.attrib "%role.attrib;"> + +<!ENTITY % objectinfo.element "INCLUDE"> +<![ %objectinfo.element; [ +<!--doc:Meta-information for an object.--> +<!ELEMENT objectinfo %ho; ((%info.class;)+) + %beginpage.exclusion;> +<!--end of objectinfo.element-->]]> + +<!ENTITY % objectinfo.attlist "INCLUDE"> +<![ %objectinfo.attlist; [ +<!ATTLIST objectinfo + %common.attrib; + %objectinfo.role.attrib; + %local.objectinfo.attrib; +> +<!--end of objectinfo.attlist-->]]> +<!--end of objectinfo.module-->]]> + +<!--EntityRef: Name of an external entity containing the content + of the object data--> +<!--FileRef: Filename, qualified by a pathname if desired, + designating the file containing the content of the object data--> +<!--Format: Notation of the element content, if any--> +<!--SrcCredit: Information about the source of the image--> +<!ENTITY % local.objectdata.attrib ""> +<!ENTITY % objectdata.attrib + " + entityref ENTITY #IMPLIED + fileref CDATA #IMPLIED + format (%notation.class;) + #IMPLIED + srccredit CDATA #IMPLIED + %local.objectdata.attrib;" +> + +<!ENTITY % videodata.module "INCLUDE"> +<![ %videodata.module; [ +<!ENTITY % local.videodata.attrib ""> +<!ENTITY % videodata.role.attrib "%role.attrib;"> + +<!ENTITY % videodata.element "INCLUDE"> +<![ %videodata.element; [ +<!--doc:Pointer to external video data.--> +<!ELEMENT videodata %ho; EMPTY> +<!--end of videodata.element-->]]> + +<!ENTITY % videodata.attlist "INCLUDE"> +<![ %videodata.attlist; [ + +<!--Width: Same as CALS reprowid (desired width)--> +<!--Depth: Same as CALS reprodep (desired depth)--> +<!--Align: Same as CALS hplace with 'none' removed; #IMPLIED means + application-specific--> +<!--Scale: Conflation of CALS hscale and vscale--> +<!--Scalefit: Same as CALS scalefit--> +<!ATTLIST videodata + width CDATA #IMPLIED + contentwidth CDATA #IMPLIED + depth CDATA #IMPLIED + contentdepth CDATA #IMPLIED + align (left + |right + |center) #IMPLIED + valign (top + |middle + |bottom) #IMPLIED + scale CDATA #IMPLIED + scalefit %yesorno.attvals; + #IMPLIED + %objectdata.attrib; + %common.attrib; + %videodata.role.attrib; + %local.videodata.attrib; +> +<!--end of videodata.attlist-->]]> +<!--end of videodata.module-->]]> + +<!ENTITY % audiodata.module "INCLUDE"> +<![ %audiodata.module; [ +<!ENTITY % local.audiodata.attrib ""> +<!ENTITY % audiodata.role.attrib "%role.attrib;"> + +<!ENTITY % audiodata.element "INCLUDE"> +<![ %audiodata.element; [ +<!--doc:Pointer to external audio data.--> +<!ELEMENT audiodata %ho; EMPTY> +<!--end of audiodata.element-->]]> + +<!ENTITY % audiodata.attlist "INCLUDE"> +<![ %audiodata.attlist; [ +<!ATTLIST audiodata + %objectdata.attrib; + %common.attrib; + %audiodata.role.attrib; + %local.audiodata.attrib; +> +<!--end of audiodata.attlist-->]]> +<!--end of audiodata.module-->]]> + +<!ENTITY % imagedata.module "INCLUDE"> +<![ %imagedata.module; [ +<!ENTITY % local.imagedata.attrib ""> +<!ENTITY % imagedata.role.attrib "%role.attrib;"> + +<!ENTITY % imagedata.element "INCLUDE"> +<![ %imagedata.element; [ +<!--doc:Pointer to external image data.--> +<!ELEMENT imagedata %ho; EMPTY> +<!--end of imagedata.element-->]]> + +<!ENTITY % imagedata.attlist "INCLUDE"> +<![ %imagedata.attlist; [ + +<!--Width: Same as CALS reprowid (desired width)--> +<!--Depth: Same as CALS reprodep (desired depth)--> +<!--Align: Same as CALS hplace with 'none' removed; #IMPLIED means + application-specific--> +<!--Scale: Conflation of CALS hscale and vscale--> +<!--Scalefit: Same as CALS scalefit--> +<!ATTLIST imagedata + width CDATA #IMPLIED + contentwidth CDATA #IMPLIED + depth CDATA #IMPLIED + contentdepth CDATA #IMPLIED + align (left + |right + |center) #IMPLIED + valign (top + |middle + |bottom) #IMPLIED + scale CDATA #IMPLIED + scalefit %yesorno.attvals; + #IMPLIED + %objectdata.attrib; + %common.attrib; + %imagedata.role.attrib; + %local.imagedata.attrib; +> +<!--end of imagedata.attlist-->]]> +<!--end of imagedata.module-->]]> + +<!ENTITY % textdata.module "INCLUDE"> +<![ %textdata.module; [ +<!ENTITY % local.textdata.attrib ""> +<!ENTITY % textdata.role.attrib "%role.attrib;"> + +<!ENTITY % textdata.element "INCLUDE"> +<![ %textdata.element; [ +<!--doc:Pointer to external text data.--> +<!ELEMENT textdata %ho; EMPTY> +<!--end of textdata.element-->]]> + +<!ENTITY % textdata.attlist "INCLUDE"> +<![ %textdata.attlist; [ +<!ATTLIST textdata + encoding CDATA #IMPLIED + %objectdata.attrib; + %common.attrib; + %textdata.role.attrib; + %local.textdata.attrib; +> +<!--end of textdata.attlist-->]]> +<!--end of textdata.module-->]]> + +<!ENTITY % mediaobjectco.module "INCLUDE"> +<![ %mediaobjectco.module; [ +<!ENTITY % local.mediaobjectco.attrib ""> +<!ENTITY % mediaobjectco.role.attrib "%role.attrib;"> + +<!ENTITY % mediaobjectco.element "INCLUDE"> +<![ %mediaobjectco.element; [ +<!--doc:A media object that contains callouts.--> +<!ELEMENT mediaobjectco %ho; (objectinfo?, imageobjectco, + (imageobjectco|textobject)*)> +<!--end of mediaobjectco.element-->]]> + +<!ENTITY % mediaobjectco.attlist "INCLUDE"> +<![ %mediaobjectco.attlist; [ +<!ATTLIST mediaobjectco + %common.attrib; + %mediaobjectco.role.attrib; + %local.mediaobjectco.attrib; +> +<!--end of mediaobjectco.attlist-->]]> +<!--end of mediaobjectco.module-->]]> + +<!ENTITY % imageobjectco.module "INCLUDE"> +<![ %imageobjectco.module; [ +<!ENTITY % local.imageobjectco.attrib ""> +<!ENTITY % imageobjectco.role.attrib "%role.attrib;"> + +<!ENTITY % imageobjectco.element "INCLUDE"> +<![ %imageobjectco.element; [ +<!--doc:A wrapper for an image object with callouts.--> +<!ELEMENT imageobjectco %ho; (areaspec, imageobject, calloutlist*)> +<!--end of imageobjectco.element-->]]> + +<!ENTITY % imageobjectco.attlist "INCLUDE"> +<![ %imageobjectco.attlist; [ +<!ATTLIST imageobjectco + %common.attrib; + %imageobjectco.role.attrib; + %local.imageobjectco.attrib; +> +<!--end of imageobjectco.attlist-->]]> +<!--end of imageobjectco.module-->]]> +<!--end of mediaobject.content.module-->]]> + +<!-- Equations ........................ --> + +<!-- This PE provides a mechanism for replacing equation content, --> +<!-- perhaps adding a new or different model (e.g., MathML) --> +<!ENTITY % equation.content "(alt?, (graphic+|mediaobject+|mathphrase+))"> +<!ENTITY % inlineequation.content "(alt?, (graphic+|inlinemediaobject+|mathphrase+))"> + +<!ENTITY % equation.module "INCLUDE"> +<![%equation.module;[ +<!ENTITY % local.equation.attrib ""> +<!ENTITY % equation.role.attrib "%role.attrib;"> + +<!ENTITY % equation.element "INCLUDE"> +<![%equation.element;[ +<!--doc:A displayed mathematical equation.--> +<!ELEMENT equation %ho; (blockinfo?, (%formalobject.title.content;)?, + (informalequation | %equation.content;))> +<!--end of equation.element-->]]> + +<!ENTITY % equation.attlist "INCLUDE"> +<![%equation.attlist;[ +<!ATTLIST equation + floatstyle CDATA #IMPLIED + %label.attrib; + %common.attrib; + %equation.role.attrib; + %local.equation.attrib; +> +<!--end of equation.attlist-->]]> +<!--end of equation.module-->]]> + +<!ENTITY % informalequation.module "INCLUDE"> +<![%informalequation.module;[ +<!ENTITY % local.informalequation.attrib ""> +<!ENTITY % informalequation.role.attrib "%role.attrib;"> + +<!ENTITY % informalequation.element "INCLUDE"> +<![%informalequation.element;[ +<!--doc:A displayed mathematical equation without a title.--> +<!ELEMENT informalequation %ho; (blockinfo?, %equation.content;) > +<!--end of informalequation.element-->]]> + +<!ENTITY % informalequation.attlist "INCLUDE"> +<![%informalequation.attlist;[ +<!ATTLIST informalequation + floatstyle CDATA #IMPLIED + %common.attrib; + %informalequation.role.attrib; + %local.informalequation.attrib; +> +<!--end of informalequation.attlist-->]]> +<!--end of informalequation.module-->]]> + +<!ENTITY % inlineequation.module "INCLUDE"> +<![%inlineequation.module;[ +<!ENTITY % local.inlineequation.attrib ""> +<!ENTITY % inlineequation.role.attrib "%role.attrib;"> + +<!ENTITY % inlineequation.element "INCLUDE"> +<![%inlineequation.element;[ +<!--doc:A mathematical equation or expression occurring inline.--> +<!ELEMENT inlineequation %ho; (%inlineequation.content;)> +<!--end of inlineequation.element-->]]> + +<!ENTITY % inlineequation.attlist "INCLUDE"> +<![%inlineequation.attlist;[ +<!ATTLIST inlineequation + %common.attrib; + %inlineequation.role.attrib; + %local.inlineequation.attrib; +> +<!--end of inlineequation.attlist-->]]> +<!--end of inlineequation.module-->]]> + +<!ENTITY % alt.module "INCLUDE"> +<![%alt.module;[ +<!ENTITY % local.alt.attrib ""> +<!ENTITY % alt.role.attrib "%role.attrib;"> + +<!ENTITY % alt.element "INCLUDE"> +<![%alt.element;[ +<!--doc:Text representation for a graphical element.--> +<!ELEMENT alt %ho; (#PCDATA)> +<!--end of alt.element-->]]> + +<!ENTITY % alt.attlist "INCLUDE"> +<![%alt.attlist;[ +<!ATTLIST alt + %common.attrib; + %alt.role.attrib; + %local.alt.attrib; +> +<!--end of alt.attlist-->]]> +<!--end of alt.module-->]]> + +<!ENTITY % mathphrase.module "INCLUDE"> +<![%mathphrase.module;[ +<!ENTITY % local.mathphrase.attrib ""> +<!ENTITY % mathphrase.role.attrib "%role.attrib;"> + +<!ENTITY % mathphrase.element "INCLUDE"> +<![%mathphrase.element;[ +<!--doc:A mathematical phrase, an expression that can be represented with ordinary text and a small amount of markup.--> +<!ELEMENT mathphrase %ho; (#PCDATA|subscript|superscript|emphasis)*> +<!--end of mathphrase.element-->]]> + +<!ENTITY % mathphrase.attlist "INCLUDE"> +<![%mathphrase.attlist;[ +<!ATTLIST mathphrase + %common.attrib; + %mathphrase.role.attrib; + %local.mathphrase.attrib; +> +<!--end of mathphrase.attlist-->]]> +<!--end of mathphrase.module-->]]> + +<!-- Tables ........................... --> + +<!ENTITY % table.module "INCLUDE"> +<![%table.module;[ + +<!-- Choose a table model. CALS or OASIS XML Exchange --> + +<!ENTITY % cals.table.module "INCLUDE"> +<![%cals.table.module;[ +<!ENTITY % exchange.table.module "IGNORE"> +]]> +<!ENTITY % exchange.table.module "INCLUDE"> + +<!-- Do we allow the HTML table model as well? --> +<!ENTITY % allow.html.tables "INCLUDE"> +<![%allow.html.tables;[ + <!-- ====================================================== --> + <!-- xhtmltbl.mod defines HTML tables and sets parameter + entities so that, when the CALS table module is read, + we end up allowing any table to be CALS or HTML. + i.e. This include must come first! --> + <!-- ====================================================== --> + +<!ENTITY % htmltbl + PUBLIC "-//OASIS//ELEMENTS DocBook XML HTML Tables V4.5//EN" + "htmltblx.mod"> +%htmltbl; +<!--end of allow.html.tables-->]]> + +<!ENTITY % tables.role.attrib "%role.attrib;"> + +<![%cals.table.module;[ +<!-- Add label and role attributes to table and informaltable --> +<!ENTITY % bodyatt " + floatstyle CDATA #IMPLIED + rowheader (firstcol|norowheader) #IMPLIED + %label.attrib;" +> + +<!-- Add common attributes to Table, TGroup, TBody, THead, TFoot, Row, + EntryTbl, and Entry (and InformalTable element). --> +<!ENTITY % secur + "%common.attrib; + %tables.role.attrib;"> + +<!ENTITY % common.table.attribs + "%bodyatt; + %secur;"> + +<!-- Content model for Table. --> +<!ENTITY % tbl.table.mdl + "(blockinfo?, (%formalobject.title.content;), (%ndxterm.class;)*, + textobject*, + (graphic+|mediaobject+|tgroup+))"> + +<!-- Allow either objects or inlines; beware of REs between elements. --> +<!ENTITY % tbl.entry.mdl "%para.char.mix; | %tabentry.mix;"> + +<!-- Reference CALS Table Model --> +<!ENTITY % tablemodel + PUBLIC "-//OASIS//DTD DocBook CALS Table Model V4.5//EN" + "calstblx.dtd"> +]]> + +<![%exchange.table.module;[ +<!-- Add common attributes and the Label attribute to Table and --> +<!-- InformalTable. --> +<!ENTITY % bodyatt + "%common.attrib; + rowheader (firstcol|norowheader) #IMPLIED + %label.attrib; + %tables.role.attrib;"> + +<!ENTITY % common.table.attribs + "%bodyatt;"> + +<!-- Add common attributes to TGroup, ColSpec, TBody, THead, Row, Entry --> + +<!ENTITY % tbl.tgroup.att "%common.attrib;"> +<!ENTITY % tbl.colspec.att "%common.attrib;"> +<!ENTITY % tbl.tbody.att "%common.attrib;"> +<!ENTITY % tbl.thead.att "%common.attrib;"> +<!ENTITY % tbl.row.att "%common.attrib;"> +<!ENTITY % tbl.entry.att "%common.attrib;"> + +<!-- Content model for Table. --> +<!ENTITY % tbl.table.mdl + "(blockinfo?, (%formalobject.title.content;), (%ndxterm.class;)*, + textobject*, + (graphic+|mediaobject+|tgroup+))"> + +<!-- Allow either objects or inlines; beware of REs between elements. --> +<!ENTITY % tbl.entry.mdl "(%para.char.mix; | %tabentry.mix;)*"> + +<!-- Reference OASIS Exchange Table Model --> +<!ENTITY % tablemodel + PUBLIC "-//OASIS//DTD XML Exchange Table Model 19990315//EN" + "soextblx.dtd"> +]]> + +%tablemodel; + +<!--end of table.module-->]]> + +<!ENTITY % informaltable.module "INCLUDE"> +<![%informaltable.module;[ + +<!-- Note that InformalTable is dependent on some of the entity + declarations that customize Table. --> + +<!ENTITY % local.informaltable.attrib ""> + +<!-- the following entity may have been declared by the XHTML table module --> +<!ENTITY % informal.tbl.table.mdl "textobject*, (graphic+|mediaobject+|tgroup+)"> + +<!ENTITY % informaltable.element "INCLUDE"> +<![%informaltable.element;[ +<!--doc:A table without a title.--> +<!ELEMENT informaltable %ho; (blockinfo?, (%informal.tbl.table.mdl;))> +<!--end of informaltable.element-->]]> + +<!-- Frame, Colsep, and Rowsep must be repeated because + they are not in entities in the table module. --> +<!-- includes TabStyle, ToCentry, ShortEntry, + Orient, PgWide --> +<!-- includes Label --> +<!-- includes common attributes --> + +<!ENTITY % informaltable.attlist "INCLUDE"> +<![%informaltable.attlist;[ +<!ATTLIST informaltable + frame (%tbl.frame.attval;) #IMPLIED + colsep %yesorno.attvals; #IMPLIED + rowsep %yesorno.attvals; #IMPLIED + %common.table.attribs; + %tbl.table.att; + %local.informaltable.attrib; +> +<!--end of informaltable.attlist-->]]> +<!--end of informaltable.module-->]]> + +<!ENTITY % caption.module "INCLUDE"> +<![ %caption.module; [ +<!ENTITY % local.caption.attrib ""> +<!ENTITY % caption.role.attrib "%role.attrib;"> + +<!ENTITY % caption.element "INCLUDE"> +<![ %caption.element; [ +<!--doc:A caption.--> +<!ELEMENT caption %ho; (#PCDATA | %textobject.mix;)*> +<!--end of caption.element-->]]> + +<!ENTITY % caption.attlist "INCLUDE"> +<![ %caption.attlist; [ +<!-- attrs comes from HTML tables ... --> + +<![ %allow.html.tables; [ +<!-- common.attrib, but without ID because ID is in attrs --> +<!ENTITY % caption.attlist.content " + %caption.role.attrib; + %attrs; + align (top|bottom|left|right) #IMPLIED + %local.caption.attrib; +"> +]]> +<!ENTITY % caption.attlist.content " + %common.attrib; + %caption.role.attrib; + %local.caption.attrib; +"> + +<!ATTLIST caption %caption.attlist.content;> + +<!--end of caption.attlist-->]]> +<!--end of caption.module-->]]> + +<!-- ...................................................................... --> +<!-- Synopses ............................................................. --> + +<!-- Synopsis ......................... --> + +<!ENTITY % synopsis.module "INCLUDE"> +<![%synopsis.module;[ +<!ENTITY % local.synopsis.attrib ""> +<!ENTITY % synopsis.role.attrib "%role.attrib;"> + +<!ENTITY % synopsis.element "INCLUDE"> +<![%synopsis.element;[ +<!--doc:A general-purpose element for representing the syntax of commands or functions.--> +<!ELEMENT synopsis %ho; (%para.char.mix;|graphic|mediaobject|co|coref|textobject|lineannotation)*> +<!--end of synopsis.element-->]]> + +<!ENTITY % synopsis.attlist "INCLUDE"> +<![%synopsis.attlist;[ +<!ATTLIST synopsis + %label.attrib; + %linespecific.attrib; + %common.attrib; + %synopsis.role.attrib; + %local.synopsis.attrib; +> +<!--end of synopsis.attlist-->]]> + +<!-- LineAnnotation (defined in the Inlines section, below)--> +<!--end of synopsis.module-->]]> + +<!-- CmdSynopsis ...................... --> + +<!ENTITY % cmdsynopsis.content.module "INCLUDE"> +<![%cmdsynopsis.content.module;[ +<!ENTITY % cmdsynopsis.module "INCLUDE"> +<![%cmdsynopsis.module;[ +<!ENTITY % local.cmdsynopsis.attrib ""> +<!ENTITY % cmdsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % cmdsynopsis.element "INCLUDE"> +<![%cmdsynopsis.element;[ +<!--doc:A syntax summary for a software command.--> +<!ELEMENT cmdsynopsis %ho; ((command | arg | group | sbr)+, synopfragment*)> +<!--end of cmdsynopsis.element-->]]> + +<!-- Sepchar: Character that should separate command and all + top-level arguments; alternate value might be e.g., Δ --> + + +<!ENTITY % cmdsynopsis.attlist "INCLUDE"> +<![%cmdsynopsis.attlist;[ +<!ATTLIST cmdsynopsis + %label.attrib; + sepchar CDATA " " + cmdlength CDATA #IMPLIED + %common.attrib; + %cmdsynopsis.role.attrib; + %local.cmdsynopsis.attrib; +> +<!--end of cmdsynopsis.attlist-->]]> +<!--end of cmdsynopsis.module-->]]> + +<!ENTITY % arg.module "INCLUDE"> +<![%arg.module;[ +<!ENTITY % local.arg.attrib ""> +<!ENTITY % arg.role.attrib "%role.attrib;"> + +<!ENTITY % arg.element "INCLUDE"> +<![%arg.element;[ +<!--doc:An argument in a CmdSynopsis.--> +<!ELEMENT arg %ho; (#PCDATA + | arg + | group + | option + | synopfragmentref + | replaceable + | sbr)*> +<!--end of arg.element-->]]> + +<!-- Choice: Whether Arg must be supplied: Opt (optional to + supply, e.g. [arg]; the default), Req (required to supply, + e.g. {arg}), or Plain (required to supply, e.g. arg) --> +<!-- Rep: whether Arg is repeatable: Norepeat (e.g. arg without + ellipsis; the default), or Repeat (e.g. arg...) --> + + +<!ENTITY % arg.attlist "INCLUDE"> +<![%arg.attlist;[ +<!ATTLIST arg + choice (opt + |req + |plain) 'opt' + rep (norepeat + |repeat) 'norepeat' + %common.attrib; + %arg.role.attrib; + %local.arg.attrib; +> +<!--end of arg.attlist-->]]> +<!--end of arg.module-->]]> + +<!ENTITY % group.module "INCLUDE"> +<![%group.module;[ + +<!ENTITY % local.group.attrib ""> +<!ENTITY % group.role.attrib "%role.attrib;"> + +<!ENTITY % group.element "INCLUDE"> +<![%group.element;[ +<!--doc:A group of elements in a CmdSynopsis.--> +<!ELEMENT group %ho; ((arg | group | option | synopfragmentref + | replaceable | sbr)+)> +<!--end of group.element-->]]> + +<!-- Choice: Whether Group must be supplied: Opt (optional to + supply, e.g. [g1|g2|g3]; the default), Req (required to + supply, e.g. {g1|g2|g3}), Plain (required to supply, + e.g. g1|g2|g3), OptMult (can supply zero or more, e.g. + [[g1|g2|g3]]), or ReqMult (must supply one or more, e.g. + {{g1|g2|g3}}) --> +<!-- Rep: whether Group is repeatable: Norepeat (e.g. group + without ellipsis; the default), or Repeat (e.g. group...) --> + + +<!ENTITY % group.attlist "INCLUDE"> +<![%group.attlist;[ +<!ATTLIST group + choice (opt + |req + |plain) 'opt' + rep (norepeat + |repeat) 'norepeat' + %common.attrib; + %group.role.attrib; + %local.group.attrib; +> +<!--end of group.attlist-->]]> +<!--end of group.module-->]]> + +<!ENTITY % sbr.module "INCLUDE"> +<![%sbr.module;[ +<!ENTITY % local.sbr.attrib ""> +<!-- Synopsis break --> +<!ENTITY % sbr.role.attrib "%role.attrib;"> + +<!ENTITY % sbr.element "INCLUDE"> +<![%sbr.element;[ +<!--doc:An explicit line break in a command synopsis.--> +<!ELEMENT sbr %ho; EMPTY> +<!--end of sbr.element-->]]> + +<!ENTITY % sbr.attlist "INCLUDE"> +<![%sbr.attlist;[ +<!ATTLIST sbr + %common.attrib; + %sbr.role.attrib; + %local.sbr.attrib; +> +<!--end of sbr.attlist-->]]> +<!--end of sbr.module-->]]> + +<!ENTITY % synopfragmentref.module "INCLUDE"> +<![%synopfragmentref.module;[ +<!ENTITY % local.synopfragmentref.attrib ""> +<!ENTITY % synopfragmentref.role.attrib "%role.attrib;"> + +<!ENTITY % synopfragmentref.element "INCLUDE"> +<![%synopfragmentref.element;[ +<!--doc:A reference to a fragment of a command synopsis.--> +<!ELEMENT synopfragmentref %ho; (#PCDATA)> +<!--end of synopfragmentref.element-->]]> + +<!-- to SynopFragment of complex synopsis + material for separate referencing --> + + +<!ENTITY % synopfragmentref.attlist "INCLUDE"> +<![%synopfragmentref.attlist;[ +<!ATTLIST synopfragmentref + %linkendreq.attrib; %common.attrib; + %synopfragmentref.role.attrib; + %local.synopfragmentref.attrib; +> +<!--end of synopfragmentref.attlist-->]]> +<!--end of synopfragmentref.module-->]]> + +<!ENTITY % synopfragment.module "INCLUDE"> +<![%synopfragment.module;[ +<!ENTITY % local.synopfragment.attrib ""> +<!ENTITY % synopfragment.role.attrib "%role.attrib;"> + +<!ENTITY % synopfragment.element "INCLUDE"> +<![%synopfragment.element;[ +<!--doc:A portion of a CmdSynopsis broken out from the main body of the synopsis.--> +<!ELEMENT synopfragment %ho; ((arg | group)+)> +<!--end of synopfragment.element-->]]> + +<!ENTITY % synopfragment.attlist "INCLUDE"> +<![%synopfragment.attlist;[ +<!ATTLIST synopfragment + %idreq.common.attrib; + %synopfragment.role.attrib; + %local.synopfragment.attrib; +> +<!--end of synopfragment.attlist-->]]> +<!--end of synopfragment.module-->]]> + +<!-- Command (defined in the Inlines section, below)--> +<!-- Option (defined in the Inlines section, below)--> +<!-- Replaceable (defined in the Inlines section, below)--> +<!--end of cmdsynopsis.content.module-->]]> + +<!-- FuncSynopsis ..................... --> + +<!ENTITY % funcsynopsis.content.module "INCLUDE"> +<![%funcsynopsis.content.module;[ +<!ENTITY % funcsynopsis.module "INCLUDE"> +<![%funcsynopsis.module;[ + +<!ENTITY % local.funcsynopsis.attrib ""> +<!ENTITY % funcsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % funcsynopsis.element "INCLUDE"> +<![%funcsynopsis.element;[ +<!--doc:The syntax summary for a function definition.--> +<!ELEMENT funcsynopsis %ho; ((funcsynopsisinfo | funcprototype)+)> +<!--end of funcsynopsis.element-->]]> + +<!ENTITY % funcsynopsis.attlist "INCLUDE"> +<![%funcsynopsis.attlist;[ +<!ATTLIST funcsynopsis + %label.attrib; + %common.attrib; + %funcsynopsis.role.attrib; + %local.funcsynopsis.attrib; +> +<!--end of funcsynopsis.attlist-->]]> +<!--end of funcsynopsis.module-->]]> + +<!ENTITY % funcsynopsisinfo.module "INCLUDE"> +<![%funcsynopsisinfo.module;[ +<!ENTITY % local.funcsynopsisinfo.attrib ""> +<!ENTITY % funcsynopsisinfo.role.attrib "%role.attrib;"> + +<!ENTITY % funcsynopsisinfo.element "INCLUDE"> +<![%funcsynopsisinfo.element;[ +<!--doc:Information supplementing the FuncDefs of a FuncSynopsis.--> +<!ELEMENT funcsynopsisinfo %ho; (%cptr.char.mix;|textobject|lineannotation)*> +<!--end of funcsynopsisinfo.element-->]]> + +<!ENTITY % funcsynopsisinfo.attlist "INCLUDE"> +<![%funcsynopsisinfo.attlist;[ +<!ATTLIST funcsynopsisinfo + %linespecific.attrib; + %common.attrib; + %funcsynopsisinfo.role.attrib; + %local.funcsynopsisinfo.attrib; +> +<!--end of funcsynopsisinfo.attlist-->]]> +<!--end of funcsynopsisinfo.module-->]]> + +<!ENTITY % funcprototype.module "INCLUDE"> +<![%funcprototype.module;[ +<!ENTITY % local.funcprototype.attrib ""> +<!ENTITY % funcprototype.role.attrib "%role.attrib;"> + +<!ENTITY % funcprototype.element "INCLUDE"> +<![%funcprototype.element;[ +<!--doc:The prototype of a function.--> +<!ELEMENT funcprototype %ho; (modifier*, + funcdef, + (void|varargs|(paramdef+, varargs?)), + modifier*)> + +<!--end of funcprototype.element-->]]> + +<!ENTITY % funcprototype.attlist "INCLUDE"> +<![%funcprototype.attlist;[ +<!ATTLIST funcprototype + %common.attrib; + %funcprototype.role.attrib; + %local.funcprototype.attrib; +> +<!--end of funcprototype.attlist-->]]> +<!--end of funcprototype.module-->]]> + +<!ENTITY % funcdef.module "INCLUDE"> +<![%funcdef.module;[ +<!ENTITY % local.funcdef.attrib ""> +<!ENTITY % funcdef.role.attrib "%role.attrib;"> + +<!ENTITY % funcdef.element "INCLUDE"> +<![%funcdef.element;[ +<!--doc:A function (subroutine) name and its return type.--> +<!ELEMENT funcdef %ho; (#PCDATA + | type + | replaceable + | function)*> +<!--end of funcdef.element-->]]> + +<!ENTITY % funcdef.attlist "INCLUDE"> +<![%funcdef.attlist;[ +<!ATTLIST funcdef + %common.attrib; + %funcdef.role.attrib; + %local.funcdef.attrib; +> +<!--end of funcdef.attlist-->]]> +<!--end of funcdef.module-->]]> + +<!ENTITY % void.module "INCLUDE"> +<![%void.module;[ +<!ENTITY % local.void.attrib ""> +<!ENTITY % void.role.attrib "%role.attrib;"> + +<!ENTITY % void.element "INCLUDE"> +<![%void.element;[ +<!--doc:An empty element in a function synopsis indicating that the function in question takes no arguments.--> +<!ELEMENT void %ho; EMPTY> +<!--end of void.element-->]]> + +<!ENTITY % void.attlist "INCLUDE"> +<![%void.attlist;[ +<!ATTLIST void + %common.attrib; + %void.role.attrib; + %local.void.attrib; +> +<!--end of void.attlist-->]]> +<!--end of void.module-->]]> + +<!ENTITY % varargs.module "INCLUDE"> +<![%varargs.module;[ +<!ENTITY % local.varargs.attrib ""> +<!ENTITY % varargs.role.attrib "%role.attrib;"> + +<!ENTITY % varargs.element "INCLUDE"> +<![%varargs.element;[ +<!--doc:An empty element in a function synopsis indicating a variable number of arguments.--> +<!ELEMENT varargs %ho; EMPTY> +<!--end of varargs.element-->]]> + +<!ENTITY % varargs.attlist "INCLUDE"> +<![%varargs.attlist;[ +<!ATTLIST varargs + %common.attrib; + %varargs.role.attrib; + %local.varargs.attrib; +> +<!--end of varargs.attlist-->]]> +<!--end of varargs.module-->]]> + +<!-- Processing assumes that only one Parameter will appear in a + ParamDef, and that FuncParams will be used at most once, for + providing information on the "inner parameters" for parameters that + are pointers to functions. --> + +<!ENTITY % paramdef.module "INCLUDE"> +<![%paramdef.module;[ +<!ENTITY % local.paramdef.attrib ""> +<!ENTITY % paramdef.role.attrib "%role.attrib;"> + +<!ENTITY % paramdef.element "INCLUDE"> +<![%paramdef.element;[ +<!--doc:Information about a function parameter in a programming language.--> +<!ELEMENT paramdef %ho; (#PCDATA + | initializer + | type + | replaceable + | parameter + | funcparams)*> +<!--end of paramdef.element-->]]> + +<!ENTITY % paramdef.attlist "INCLUDE"> +<![%paramdef.attlist;[ +<!ATTLIST paramdef + choice (opt + |req) #IMPLIED + %common.attrib; + %paramdef.role.attrib; + %local.paramdef.attrib; +> +<!--end of paramdef.attlist-->]]> +<!--end of paramdef.module-->]]> + +<!ENTITY % funcparams.module "INCLUDE"> +<![%funcparams.module;[ +<!ENTITY % local.funcparams.attrib ""> +<!ENTITY % funcparams.role.attrib "%role.attrib;"> + +<!ENTITY % funcparams.element "INCLUDE"> +<![%funcparams.element;[ +<!--doc:Parameters for a function referenced through a function pointer in a synopsis.--> +<!ELEMENT funcparams %ho; (%cptr.char.mix;)*> +<!--end of funcparams.element-->]]> + +<!ENTITY % funcparams.attlist "INCLUDE"> +<![%funcparams.attlist;[ +<!ATTLIST funcparams + %common.attrib; + %funcparams.role.attrib; + %local.funcparams.attrib; +> +<!--end of funcparams.attlist-->]]> +<!--end of funcparams.module-->]]> + +<!-- LineAnnotation (defined in the Inlines section, below)--> +<!-- Replaceable (defined in the Inlines section, below)--> +<!-- Function (defined in the Inlines section, below)--> +<!-- Parameter (defined in the Inlines section, below)--> +<!--end of funcsynopsis.content.module-->]]> + +<!-- ClassSynopsis ..................... --> + +<!ENTITY % classsynopsis.content.module "INCLUDE"> +<![%classsynopsis.content.module;[ + +<!ENTITY % classsynopsis.module "INCLUDE"> +<![%classsynopsis.module;[ +<!ENTITY % local.classsynopsis.attrib ""> +<!ENTITY % classsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % classsynopsis.element "INCLUDE"> +<![%classsynopsis.element;[ +<!--doc:The syntax summary for a class definition.--> +<!ELEMENT classsynopsis %ho; ((ooclass|oointerface|ooexception)+, + (classsynopsisinfo + |fieldsynopsis|%method.synop.class;)*)> +<!--end of classsynopsis.element-->]]> + +<!ENTITY % classsynopsis.attlist "INCLUDE"> +<![%classsynopsis.attlist;[ +<!ATTLIST classsynopsis + language CDATA #IMPLIED + class (class|interface) "class" + %common.attrib; + %classsynopsis.role.attrib; + %local.classsynopsis.attrib; +> +<!--end of classsynopsis.attlist-->]]> +<!--end of classsynopsis.module-->]]> + +<!ENTITY % classsynopsisinfo.module "INCLUDE"> +<![ %classsynopsisinfo.module; [ +<!ENTITY % local.classsynopsisinfo.attrib ""> +<!ENTITY % classsynopsisinfo.role.attrib "%role.attrib;"> + +<!ENTITY % classsynopsisinfo.element "INCLUDE"> +<![ %classsynopsisinfo.element; [ +<!--doc:Information supplementing the contents of a ClassSynopsis.--> +<!ELEMENT classsynopsisinfo %ho; (%cptr.char.mix;|textobject|lineannotation)*> +<!--end of classsynopsisinfo.element-->]]> + +<!ENTITY % classsynopsisinfo.attlist "INCLUDE"> +<![ %classsynopsisinfo.attlist; [ +<!ATTLIST classsynopsisinfo + %linespecific.attrib; + %common.attrib; + %classsynopsisinfo.role.attrib; + %local.classsynopsisinfo.attrib; +> +<!--end of classsynopsisinfo.attlist-->]]> +<!--end of classsynopsisinfo.module-->]]> + +<!ENTITY % ooclass.module "INCLUDE"> +<![%ooclass.module;[ +<!ENTITY % local.ooclass.attrib ""> +<!ENTITY % ooclass.role.attrib "%role.attrib;"> + +<!ENTITY % ooclass.element "INCLUDE"> +<![%ooclass.element;[ +<!--doc:A class in an object-oriented programming language.--> +<!ELEMENT ooclass %ho; ((modifier|package)*, classname)> +<!--end of ooclass.element-->]]> + +<!ENTITY % ooclass.attlist "INCLUDE"> +<![%ooclass.attlist;[ +<!ATTLIST ooclass + %common.attrib; + %ooclass.role.attrib; + %local.ooclass.attrib; +> +<!--end of ooclass.attlist-->]]> +<!--end of ooclass.module-->]]> + +<!ENTITY % oointerface.module "INCLUDE"> +<![%oointerface.module;[ +<!ENTITY % local.oointerface.attrib ""> +<!ENTITY % oointerface.role.attrib "%role.attrib;"> + +<!ENTITY % oointerface.element "INCLUDE"> +<![%oointerface.element;[ +<!--doc:An interface in an object-oriented programming language.--> +<!ELEMENT oointerface %ho; ((modifier|package)*, interfacename)> +<!--end of oointerface.element-->]]> + +<!ENTITY % oointerface.attlist "INCLUDE"> +<![%oointerface.attlist;[ +<!ATTLIST oointerface + %common.attrib; + %oointerface.role.attrib; + %local.oointerface.attrib; +> +<!--end of oointerface.attlist-->]]> +<!--end of oointerface.module-->]]> + +<!ENTITY % ooexception.module "INCLUDE"> +<![%ooexception.module;[ +<!ENTITY % local.ooexception.attrib ""> +<!ENTITY % ooexception.role.attrib "%role.attrib;"> + +<!ENTITY % ooexception.element "INCLUDE"> +<![%ooexception.element;[ +<!--doc:An exception in an object-oriented programming language.--> +<!ELEMENT ooexception %ho; ((modifier|package)*, exceptionname)> +<!--end of ooexception.element-->]]> + +<!ENTITY % ooexception.attlist "INCLUDE"> +<![%ooexception.attlist;[ +<!ATTLIST ooexception + %common.attrib; + %ooexception.role.attrib; + %local.ooexception.attrib; +> +<!--end of ooexception.attlist-->]]> +<!--end of ooexception.module-->]]> + +<!ENTITY % modifier.module "INCLUDE"> +<![%modifier.module;[ +<!ENTITY % local.modifier.attrib ""> +<!ENTITY % modifier.role.attrib "%role.attrib;"> + +<!ENTITY % modifier.element "INCLUDE"> +<![%modifier.element;[ +<!--doc:Modifiers in a synopsis.--> +<!ELEMENT modifier %ho; (%smallcptr.char.mix;)*> +<!--end of modifier.element-->]]> + +<!ENTITY % modifier.attlist "INCLUDE"> +<![%modifier.attlist;[ +<!ATTLIST modifier + %common.attrib; + %modifier.role.attrib; + %local.modifier.attrib; +> +<!--end of modifier.attlist-->]]> +<!--end of modifier.module-->]]> + +<!ENTITY % interfacename.module "INCLUDE"> +<![%interfacename.module;[ +<!ENTITY % local.interfacename.attrib ""> +<!ENTITY % interfacename.role.attrib "%role.attrib;"> + +<!ENTITY % interfacename.element "INCLUDE"> +<![%interfacename.element;[ +<!--doc:The name of an interface.--> +<!ELEMENT interfacename %ho; (%cptr.char.mix;)*> +<!--end of interfacename.element-->]]> + +<!ENTITY % interfacename.attlist "INCLUDE"> +<![%interfacename.attlist;[ +<!ATTLIST interfacename + %common.attrib; + %interfacename.role.attrib; + %local.interfacename.attrib; +> +<!--end of interfacename.attlist-->]]> +<!--end of interfacename.module-->]]> + +<!ENTITY % exceptionname.module "INCLUDE"> +<![%exceptionname.module;[ +<!ENTITY % local.exceptionname.attrib ""> +<!ENTITY % exceptionname.role.attrib "%role.attrib;"> + +<!ENTITY % exceptionname.element "INCLUDE"> +<![%exceptionname.element;[ +<!--doc:The name of an exception.--> +<!ELEMENT exceptionname %ho; (%smallcptr.char.mix;)*> +<!--end of exceptionname.element-->]]> + +<!ENTITY % exceptionname.attlist "INCLUDE"> +<![%exceptionname.attlist;[ +<!ATTLIST exceptionname + %common.attrib; + %exceptionname.role.attrib; + %local.exceptionname.attrib; +> +<!--end of exceptionname.attlist-->]]> +<!--end of exceptionname.module-->]]> + +<!ENTITY % fieldsynopsis.module "INCLUDE"> +<![%fieldsynopsis.module;[ +<!ENTITY % local.fieldsynopsis.attrib ""> +<!ENTITY % fieldsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % fieldsynopsis.element "INCLUDE"> +<![%fieldsynopsis.element;[ +<!--doc:The name of a field in a class definition.--> +<!ELEMENT fieldsynopsis %ho; (modifier*, type?, varname, initializer?)> +<!--end of fieldsynopsis.element-->]]> + +<!ENTITY % fieldsynopsis.attlist "INCLUDE"> +<![%fieldsynopsis.attlist;[ +<!ATTLIST fieldsynopsis + language CDATA #IMPLIED + %common.attrib; + %fieldsynopsis.role.attrib; + %local.fieldsynopsis.attrib; +> +<!--end of fieldsynopsis.attlist-->]]> +<!--end of fieldsynopsis.module-->]]> + +<!ENTITY % initializer.module "INCLUDE"> +<![%initializer.module;[ +<!ENTITY % local.initializer.attrib ""> +<!ENTITY % initializer.role.attrib "%role.attrib;"> + +<!ENTITY % initializer.element "INCLUDE"> +<![%initializer.element;[ +<!--doc:The initializer for a FieldSynopsis.--> +<!ELEMENT initializer %ho; (%smallcptr.char.mix;)*> +<!--end of initializer.element-->]]> + +<!ENTITY % initializer.attlist "INCLUDE"> +<![%initializer.attlist;[ +<!ATTLIST initializer + %common.attrib; + %initializer.role.attrib; + %local.initializer.attrib; +> +<!--end of initializer.attlist-->]]> +<!--end of initializer.module-->]]> + +<!ENTITY % constructorsynopsis.module "INCLUDE"> +<![%constructorsynopsis.module;[ +<!ENTITY % local.constructorsynopsis.attrib ""> +<!ENTITY % constructorsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % constructorsynopsis.element "INCLUDE"> +<![%constructorsynopsis.element;[ +<!--doc:A syntax summary for a constructor.--> +<!ELEMENT constructorsynopsis %ho; (modifier*, + methodname?, + (methodparam+|void?), + exceptionname*)> +<!--end of constructorsynopsis.element-->]]> + +<!ENTITY % constructorsynopsis.attlist "INCLUDE"> +<![%constructorsynopsis.attlist;[ +<!ATTLIST constructorsynopsis + language CDATA #IMPLIED + %common.attrib; + %constructorsynopsis.role.attrib; + %local.constructorsynopsis.attrib; +> +<!--end of constructorsynopsis.attlist-->]]> +<!--end of constructorsynopsis.module-->]]> + +<!ENTITY % destructorsynopsis.module "INCLUDE"> +<![%destructorsynopsis.module;[ +<!ENTITY % local.destructorsynopsis.attrib ""> +<!ENTITY % destructorsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % destructorsynopsis.element "INCLUDE"> +<![%destructorsynopsis.element;[ +<!--doc:A syntax summary for a destructor.--> +<!ELEMENT destructorsynopsis %ho; (modifier*, + methodname?, + (methodparam+|void?), + exceptionname*)> +<!--end of destructorsynopsis.element-->]]> + +<!ENTITY % destructorsynopsis.attlist "INCLUDE"> +<![%destructorsynopsis.attlist;[ +<!ATTLIST destructorsynopsis + language CDATA #IMPLIED + %common.attrib; + %destructorsynopsis.role.attrib; + %local.destructorsynopsis.attrib; +> +<!--end of destructorsynopsis.attlist-->]]> +<!--end of destructorsynopsis.module-->]]> + +<!ENTITY % methodsynopsis.module "INCLUDE"> +<![%methodsynopsis.module;[ +<!ENTITY % local.methodsynopsis.attrib ""> +<!ENTITY % methodsynopsis.role.attrib "%role.attrib;"> + +<!ENTITY % methodsynopsis.element "INCLUDE"> +<![%methodsynopsis.element;[ +<!--doc:A syntax summary for a method.--> +<!ELEMENT methodsynopsis %ho; (modifier*, + (type|void)?, + methodname, + (methodparam+|void?), + exceptionname*, + modifier*)> +<!--end of methodsynopsis.element-->]]> + +<!ENTITY % methodsynopsis.attlist "INCLUDE"> +<![%methodsynopsis.attlist;[ +<!ATTLIST methodsynopsis + language CDATA #IMPLIED + %common.attrib; + %methodsynopsis.role.attrib; + %local.methodsynopsis.attrib; +> +<!--end of methodsynopsis.attlist-->]]> +<!--end of methodsynopsis.module-->]]> + +<!ENTITY % methodname.module "INCLUDE"> +<![%methodname.module;[ +<!ENTITY % local.methodname.attrib ""> +<!ENTITY % methodname.role.attrib "%role.attrib;"> + +<!ENTITY % methodname.element "INCLUDE"> +<![%methodname.element;[ +<!--doc:The name of a method.--> +<!ELEMENT methodname %ho; (%smallcptr.char.mix;)*> +<!--end of methodname.element-->]]> + +<!ENTITY % methodname.attlist "INCLUDE"> +<![%methodname.attlist;[ +<!ATTLIST methodname + %common.attrib; + %methodname.role.attrib; + %local.methodname.attrib; +> +<!--end of methodname.attlist-->]]> +<!--end of methodname.module-->]]> + +<!ENTITY % methodparam.module "INCLUDE"> +<![%methodparam.module;[ +<!ENTITY % local.methodparam.attrib ""> +<!ENTITY % methodparam.role.attrib "%role.attrib;"> + +<!ENTITY % methodparam.element "INCLUDE"> +<![%methodparam.element;[ +<!--doc:Parameters to a method.--> +<!ELEMENT methodparam %ho; (modifier*, + type?, + ((parameter,initializer?)|funcparams), + modifier*)> +<!--end of methodparam.element-->]]> + +<!ENTITY % methodparam.attlist "INCLUDE"> +<![%methodparam.attlist;[ +<!ATTLIST methodparam + choice (opt + |req + |plain) "req" + rep (norepeat + |repeat) "norepeat" + %common.attrib; + %methodparam.role.attrib; + %local.methodparam.attrib; +> +<!--end of methodparam.attlist-->]]> +<!--end of methodparam.module-->]]> +<!--end of classsynopsis.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Document information entities and elements ........................... --> + +<!-- The document information elements include some elements that are + currently used only in the document hierarchy module. They are + defined here so that they will be available for use in customized + document hierarchies. --> + +<!-- .................................. --> + +<!ENTITY % docinfo.content.module "INCLUDE"> +<![%docinfo.content.module;[ + +<!-- Ackno ............................ --> + +<!ENTITY % ackno.module "INCLUDE"> +<![%ackno.module;[ +<!ENTITY % local.ackno.attrib ""> +<!ENTITY % ackno.role.attrib "%role.attrib;"> + +<!ENTITY % ackno.element "INCLUDE"> +<![%ackno.element;[ +<!--doc:Acknowledgements in an Article.--> +<!ELEMENT ackno %ho; (%docinfo.char.mix;)*> +<!--end of ackno.element-->]]> + +<!ENTITY % ackno.attlist "INCLUDE"> +<![%ackno.attlist;[ +<!ATTLIST ackno + %common.attrib; + %ackno.role.attrib; + %local.ackno.attrib; +> +<!--end of ackno.attlist-->]]> +<!--end of ackno.module-->]]> + +<!-- Address .......................... --> + +<!ENTITY % address.content.module "INCLUDE"> +<![%address.content.module;[ +<!ENTITY % address.module "INCLUDE"> +<![%address.module;[ +<!ENTITY % local.address.attrib ""> +<!ENTITY % address.role.attrib "%role.attrib;"> + +<!ENTITY % address.element "INCLUDE"> +<![%address.element;[ +<!--doc:A real-world address, generally a postal address.--> +<!ELEMENT address %ho; (#PCDATA|personname|%person.ident.mix; + |street|pob|postcode|city|state|country|phone + |fax|email|otheraddr)*> +<!--end of address.element-->]]> + +<!ENTITY % address.attlist "INCLUDE"> +<![%address.attlist;[ +<!ATTLIST address + %linespecific.attrib; + %common.attrib; + %address.role.attrib; + %local.address.attrib; +> +<!--end of address.attlist-->]]> +<!--end of address.module-->]]> + + <!ENTITY % street.module "INCLUDE"> + <![%street.module;[ + <!ENTITY % local.street.attrib ""> + <!ENTITY % street.role.attrib "%role.attrib;"> + +<!ENTITY % street.element "INCLUDE"> +<![%street.element;[ +<!--doc:A street address in an address.--> +<!ELEMENT street %ho; (%docinfo.char.mix;)*> +<!--end of street.element-->]]> + +<!ENTITY % street.attlist "INCLUDE"> +<![%street.attlist;[ +<!ATTLIST street + %common.attrib; + %street.role.attrib; + %local.street.attrib; +> +<!--end of street.attlist-->]]> + <!--end of street.module-->]]> + + <!ENTITY % pob.module "INCLUDE"> + <![%pob.module;[ + <!ENTITY % local.pob.attrib ""> + <!ENTITY % pob.role.attrib "%role.attrib;"> + +<!ENTITY % pob.element "INCLUDE"> +<![%pob.element;[ +<!--doc:A post office box in an address.--> +<!ELEMENT pob %ho; (%docinfo.char.mix;)*> +<!--end of pob.element-->]]> + +<!ENTITY % pob.attlist "INCLUDE"> +<![%pob.attlist;[ +<!ATTLIST pob + %common.attrib; + %pob.role.attrib; + %local.pob.attrib; +> +<!--end of pob.attlist-->]]> + <!--end of pob.module-->]]> + + <!ENTITY % postcode.module "INCLUDE"> + <![%postcode.module;[ + <!ENTITY % local.postcode.attrib ""> + <!ENTITY % postcode.role.attrib "%role.attrib;"> + +<!ENTITY % postcode.element "INCLUDE"> +<![%postcode.element;[ +<!--doc:A postal code in an address.--> +<!ELEMENT postcode %ho; (%docinfo.char.mix;)*> +<!--end of postcode.element-->]]> + +<!ENTITY % postcode.attlist "INCLUDE"> +<![%postcode.attlist;[ +<!ATTLIST postcode + %common.attrib; + %postcode.role.attrib; + %local.postcode.attrib; +> +<!--end of postcode.attlist-->]]> + <!--end of postcode.module-->]]> + + <!ENTITY % city.module "INCLUDE"> + <![%city.module;[ + <!ENTITY % local.city.attrib ""> + <!ENTITY % city.role.attrib "%role.attrib;"> + +<!ENTITY % city.element "INCLUDE"> +<![%city.element;[ +<!--doc:The name of a city in an address.--> +<!ELEMENT city %ho; (%docinfo.char.mix;)*> +<!--end of city.element-->]]> + +<!ENTITY % city.attlist "INCLUDE"> +<![%city.attlist;[ +<!ATTLIST city + %common.attrib; + %city.role.attrib; + %local.city.attrib; +> +<!--end of city.attlist-->]]> + <!--end of city.module-->]]> + + <!ENTITY % state.module "INCLUDE"> + <![%state.module;[ + <!ENTITY % local.state.attrib ""> + <!ENTITY % state.role.attrib "%role.attrib;"> + +<!ENTITY % state.element "INCLUDE"> +<![%state.element;[ +<!--doc:A state or province in an address.--> +<!ELEMENT state %ho; (%docinfo.char.mix;)*> +<!--end of state.element-->]]> + +<!ENTITY % state.attlist "INCLUDE"> +<![%state.attlist;[ +<!ATTLIST state + %common.attrib; + %state.role.attrib; + %local.state.attrib; +> +<!--end of state.attlist-->]]> + <!--end of state.module-->]]> + + <!ENTITY % country.module "INCLUDE"> + <![%country.module;[ + <!ENTITY % local.country.attrib ""> + <!ENTITY % country.role.attrib "%role.attrib;"> + +<!ENTITY % country.element "INCLUDE"> +<![%country.element;[ +<!--doc:The name of a country.--> +<!ELEMENT country %ho; (%docinfo.char.mix;)*> +<!--end of country.element-->]]> + +<!ENTITY % country.attlist "INCLUDE"> +<![%country.attlist;[ +<!ATTLIST country + %common.attrib; + %country.role.attrib; + %local.country.attrib; +> +<!--end of country.attlist-->]]> + <!--end of country.module-->]]> + + <!ENTITY % phone.module "INCLUDE"> + <![%phone.module;[ + <!ENTITY % local.phone.attrib ""> + <!ENTITY % phone.role.attrib "%role.attrib;"> + +<!ENTITY % phone.element "INCLUDE"> +<![%phone.element;[ +<!--doc:A telephone number.--> +<!ELEMENT phone %ho; (%docinfo.char.mix;)*> +<!--end of phone.element-->]]> + +<!ENTITY % phone.attlist "INCLUDE"> +<![%phone.attlist;[ +<!ATTLIST phone + %common.attrib; + %phone.role.attrib; + %local.phone.attrib; +> +<!--end of phone.attlist-->]]> + <!--end of phone.module-->]]> + + <!ENTITY % fax.module "INCLUDE"> + <![%fax.module;[ + <!ENTITY % local.fax.attrib ""> + <!ENTITY % fax.role.attrib "%role.attrib;"> + +<!ENTITY % fax.element "INCLUDE"> +<![%fax.element;[ +<!--doc:A fax number.--> +<!ELEMENT fax %ho; (%docinfo.char.mix;)*> +<!--end of fax.element-->]]> + +<!ENTITY % fax.attlist "INCLUDE"> +<![%fax.attlist;[ +<!ATTLIST fax + %common.attrib; + %fax.role.attrib; + %local.fax.attrib; +> +<!--end of fax.attlist-->]]> + <!--end of fax.module-->]]> + + <!-- Email (defined in the Inlines section, below)--> + + <!ENTITY % otheraddr.module "INCLUDE"> + <![%otheraddr.module;[ + <!ENTITY % local.otheraddr.attrib ""> + <!ENTITY % otheraddr.role.attrib "%role.attrib;"> + +<!ENTITY % otheraddr.element "INCLUDE"> +<![%otheraddr.element;[ +<!--doc:Uncategorized information in address.--> +<!ELEMENT otheraddr %ho; (%docinfo.char.mix;)*> +<!--end of otheraddr.element-->]]> + +<!ENTITY % otheraddr.attlist "INCLUDE"> +<![%otheraddr.attlist;[ +<!ATTLIST otheraddr + %common.attrib; + %otheraddr.role.attrib; + %local.otheraddr.attrib; +> +<!--end of otheraddr.attlist-->]]> + <!--end of otheraddr.module-->]]> +<!--end of address.content.module-->]]> + +<!-- Affiliation ...................... --> + +<!ENTITY % affiliation.content.module "INCLUDE"> +<![%affiliation.content.module;[ +<!ENTITY % affiliation.module "INCLUDE"> +<![%affiliation.module;[ +<!ENTITY % local.affiliation.attrib ""> +<!ENTITY % affiliation.role.attrib "%role.attrib;"> + +<!ENTITY % affiliation.element "INCLUDE"> +<![%affiliation.element;[ +<!--doc:The institutional affiliation of an individual.--> +<!ELEMENT affiliation %ho; (shortaffil?, jobtitle*, orgname?, orgdiv*, + address*)> +<!--end of affiliation.element-->]]> + +<!ENTITY % affiliation.attlist "INCLUDE"> +<![%affiliation.attlist;[ +<!ATTLIST affiliation + %common.attrib; + %affiliation.role.attrib; + %local.affiliation.attrib; +> +<!--end of affiliation.attlist-->]]> +<!--end of affiliation.module-->]]> + + <!ENTITY % shortaffil.module "INCLUDE"> + <![%shortaffil.module;[ + <!ENTITY % local.shortaffil.attrib ""> + <!ENTITY % shortaffil.role.attrib "%role.attrib;"> + +<!ENTITY % shortaffil.element "INCLUDE"> +<![%shortaffil.element;[ +<!--doc:A brief description of an affiliation.--> +<!ELEMENT shortaffil %ho; (%docinfo.char.mix;)*> +<!--end of shortaffil.element-->]]> + +<!ENTITY % shortaffil.attlist "INCLUDE"> +<![%shortaffil.attlist;[ +<!ATTLIST shortaffil + %common.attrib; + %shortaffil.role.attrib; + %local.shortaffil.attrib; +> +<!--end of shortaffil.attlist-->]]> + <!--end of shortaffil.module-->]]> + + <!ENTITY % jobtitle.module "INCLUDE"> + <![%jobtitle.module;[ + <!ENTITY % local.jobtitle.attrib ""> + <!ENTITY % jobtitle.role.attrib "%role.attrib;"> + +<!ENTITY % jobtitle.element "INCLUDE"> +<![%jobtitle.element;[ +<!--doc:The title of an individual in an organization.--> +<!ELEMENT jobtitle %ho; (%docinfo.char.mix;)*> +<!--end of jobtitle.element-->]]> + +<!ENTITY % jobtitle.attlist "INCLUDE"> +<![%jobtitle.attlist;[ +<!ATTLIST jobtitle + %common.attrib; + %jobtitle.role.attrib; + %local.jobtitle.attrib; +> +<!--end of jobtitle.attlist-->]]> + <!--end of jobtitle.module-->]]> + + <!-- OrgName (defined elsewhere in this section)--> + + <!ENTITY % orgdiv.module "INCLUDE"> + <![%orgdiv.module;[ + <!ENTITY % local.orgdiv.attrib ""> + <!ENTITY % orgdiv.role.attrib "%role.attrib;"> + +<!ENTITY % orgdiv.element "INCLUDE"> +<![%orgdiv.element;[ +<!--doc:A division of an organization.--> +<!ELEMENT orgdiv %ho; (%docinfo.char.mix;)*> +<!--end of orgdiv.element-->]]> + +<!ENTITY % orgdiv.attlist "INCLUDE"> +<![%orgdiv.attlist;[ +<!ATTLIST orgdiv + %common.attrib; + %orgdiv.role.attrib; + %local.orgdiv.attrib; +> +<!--end of orgdiv.attlist-->]]> + <!--end of orgdiv.module-->]]> + + <!-- Address (defined elsewhere in this section)--> +<!--end of affiliation.content.module-->]]> + +<!-- ArtPageNums ...................... --> + +<!ENTITY % artpagenums.module "INCLUDE"> +<![%artpagenums.module;[ +<!ENTITY % local.artpagenums.attrib ""> +<!ENTITY % artpagenums.role.attrib "%role.attrib;"> + +<!ENTITY % artpagenums.element "INCLUDE"> +<![%artpagenums.element;[ +<!--doc:The page numbers of an article as published.--> +<!ELEMENT artpagenums %ho; (%docinfo.char.mix;)*> +<!--end of artpagenums.element-->]]> + +<!ENTITY % artpagenums.attlist "INCLUDE"> +<![%artpagenums.attlist;[ +<!ATTLIST artpagenums + %common.attrib; + %artpagenums.role.attrib; + %local.artpagenums.attrib; +> +<!--end of artpagenums.attlist-->]]> +<!--end of artpagenums.module-->]]> + +<!-- PersonName --> + +<!ENTITY % personname.module "INCLUDE"> +<![%personname.module;[ +<!ENTITY % local.personname.attrib ""> +<!ENTITY % personname.role.attrib "%role.attrib;"> + +<!ENTITY % personname.element "INCLUDE"> +<![%personname.element;[ +<!--doc:The personal name of an individual.--> +<!ELEMENT personname %ho; ((honorific|firstname|surname|lineage|othername)+)> +<!--end of personname.element-->]]> + +<!ENTITY % personname.attlist "INCLUDE"> +<![%personname.attlist;[ +<!ATTLIST personname + %common.attrib; + %personname.role.attrib; + %local.personname.attrib; +> +<!--end of personname.attlist-->]]> +<!--end of personname.module-->]]> + +<!-- Author ........................... --> + +<!ENTITY % author.module "INCLUDE"> +<![%author.module;[ +<!ENTITY % local.author.attrib ""> +<!ENTITY % author.role.attrib "%role.attrib;"> + +<!ENTITY % author.element "INCLUDE"> +<![%author.element;[ +<!--doc:The name of an individual author.--> +<!ELEMENT author %ho; ((personname|(%person.ident.mix;)+),(personblurb|email|address)*)> +<!--end of author.element-->]]> + +<!ENTITY % author.attlist "INCLUDE"> +<![%author.attlist;[ +<!ATTLIST author + %common.attrib; + %author.role.attrib; + %local.author.attrib; +> +<!--end of author.attlist-->]]> +<!--(see "Personal identity elements" for %person.ident.mix;)--> +<!--end of author.module-->]]> + +<!-- AuthorGroup ...................... --> + +<!ENTITY % authorgroup.content.module "INCLUDE"> +<![%authorgroup.content.module;[ +<!ENTITY % authorgroup.module "INCLUDE"> +<![%authorgroup.module;[ +<!ENTITY % local.authorgroup.attrib ""> +<!ENTITY % authorgroup.role.attrib "%role.attrib;"> + +<!ENTITY % authorgroup.element "INCLUDE"> +<![%authorgroup.element;[ +<!--doc:Wrapper for author information when a document has multiple authors or collabarators.--> +<!ELEMENT authorgroup %ho; ((author|editor|collab|corpauthor|corpcredit|othercredit)+)> +<!--end of authorgroup.element-->]]> + +<!ENTITY % authorgroup.attlist "INCLUDE"> +<![%authorgroup.attlist;[ +<!ATTLIST authorgroup + %common.attrib; + %authorgroup.role.attrib; + %local.authorgroup.attrib; +> +<!--end of authorgroup.attlist-->]]> +<!--end of authorgroup.module-->]]> + + <!-- Author (defined elsewhere in this section)--> + <!-- Editor (defined elsewhere in this section)--> + + <!ENTITY % collab.content.module "INCLUDE"> + <![%collab.content.module;[ + <!ENTITY % collab.module "INCLUDE"> + <![%collab.module;[ + <!ENTITY % local.collab.attrib ""> + <!ENTITY % collab.role.attrib "%role.attrib;"> + +<!ENTITY % collab.element "INCLUDE"> +<![%collab.element;[ +<!--doc:Identifies a collaborator.--> +<!ELEMENT collab %ho; (collabname, affiliation*)> +<!--end of collab.element-->]]> + +<!ENTITY % collab.attlist "INCLUDE"> +<![%collab.attlist;[ +<!ATTLIST collab + %common.attrib; + %collab.role.attrib; + %local.collab.attrib; +> +<!--end of collab.attlist-->]]> + <!--end of collab.module-->]]> + + <!ENTITY % collabname.module "INCLUDE"> + <![%collabname.module;[ + <!ENTITY % local.collabname.attrib ""> + <!ENTITY % collabname.role.attrib "%role.attrib;"> + +<!ENTITY % collabname.element "INCLUDE"> +<![%collabname.element;[ +<!--doc:The name of a collaborator.--> +<!ELEMENT collabname %ho; (%docinfo.char.mix;)*> +<!--end of collabname.element-->]]> + +<!ENTITY % collabname.attlist "INCLUDE"> +<![%collabname.attlist;[ +<!ATTLIST collabname + %common.attrib; + %collabname.role.attrib; + %local.collabname.attrib; +> +<!--end of collabname.attlist-->]]> + <!--end of collabname.module-->]]> + + <!-- Affiliation (defined elsewhere in this section)--> + <!--end of collab.content.module-->]]> + + <!-- CorpAuthor (defined elsewhere in this section)--> + <!-- OtherCredit (defined elsewhere in this section)--> + +<!--end of authorgroup.content.module-->]]> + +<!-- AuthorInitials ................... --> + +<!ENTITY % authorinitials.module "INCLUDE"> +<![%authorinitials.module;[ +<!ENTITY % local.authorinitials.attrib ""> +<!ENTITY % authorinitials.role.attrib "%role.attrib;"> + +<!ENTITY % authorinitials.element "INCLUDE"> +<![%authorinitials.element;[ +<!--doc:The initials or other short identifier for an author.--> +<!ELEMENT authorinitials %ho; (%docinfo.char.mix;)*> +<!--end of authorinitials.element-->]]> + +<!ENTITY % authorinitials.attlist "INCLUDE"> +<![%authorinitials.attlist;[ +<!ATTLIST authorinitials + %common.attrib; + %authorinitials.role.attrib; + %local.authorinitials.attrib; +> +<!--end of authorinitials.attlist-->]]> +<!--end of authorinitials.module-->]]> + +<!-- ConfGroup ........................ --> + +<!ENTITY % confgroup.content.module "INCLUDE"> +<![%confgroup.content.module;[ +<!ENTITY % confgroup.module "INCLUDE"> +<![%confgroup.module;[ +<!ENTITY % local.confgroup.attrib ""> +<!ENTITY % confgroup.role.attrib "%role.attrib;"> + +<!ENTITY % confgroup.element "INCLUDE"> +<![%confgroup.element;[ +<!--doc:A wrapper for document meta-information about a conference.--> +<!ELEMENT confgroup %ho; ((confdates|conftitle|confnum|address|confsponsor)*)> +<!--end of confgroup.element-->]]> + +<!ENTITY % confgroup.attlist "INCLUDE"> +<![%confgroup.attlist;[ +<!ATTLIST confgroup + %common.attrib; + %confgroup.role.attrib; + %local.confgroup.attrib; +> +<!--end of confgroup.attlist-->]]> +<!--end of confgroup.module-->]]> + + <!ENTITY % confdates.module "INCLUDE"> + <![%confdates.module;[ + <!ENTITY % local.confdates.attrib ""> + <!ENTITY % confdates.role.attrib "%role.attrib;"> + +<!ENTITY % confdates.element "INCLUDE"> +<![%confdates.element;[ +<!--doc:The dates of a conference for which a document was written.--> +<!ELEMENT confdates %ho; (%docinfo.char.mix;)*> +<!--end of confdates.element-->]]> + +<!ENTITY % confdates.attlist "INCLUDE"> +<![%confdates.attlist;[ +<!ATTLIST confdates + %common.attrib; + %confdates.role.attrib; + %local.confdates.attrib; +> +<!--end of confdates.attlist-->]]> + <!--end of confdates.module-->]]> + + <!ENTITY % conftitle.module "INCLUDE"> + <![%conftitle.module;[ + <!ENTITY % local.conftitle.attrib ""> + <!ENTITY % conftitle.role.attrib "%role.attrib;"> + +<!ENTITY % conftitle.element "INCLUDE"> +<![%conftitle.element;[ +<!--doc:The title of a conference for which a document was written.--> +<!ELEMENT conftitle %ho; (%docinfo.char.mix;)*> +<!--end of conftitle.element-->]]> + +<!ENTITY % conftitle.attlist "INCLUDE"> +<![%conftitle.attlist;[ +<!ATTLIST conftitle + %common.attrib; + %conftitle.role.attrib; + %local.conftitle.attrib; +> +<!--end of conftitle.attlist-->]]> + <!--end of conftitle.module-->]]> + + <!ENTITY % confnum.module "INCLUDE"> + <![%confnum.module;[ + <!ENTITY % local.confnum.attrib ""> + <!ENTITY % confnum.role.attrib "%role.attrib;"> + +<!ENTITY % confnum.element "INCLUDE"> +<![%confnum.element;[ +<!--doc:An identifier, frequently numerical, associated with a conference for which a document was written.--> +<!ELEMENT confnum %ho; (%docinfo.char.mix;)*> +<!--end of confnum.element-->]]> + +<!ENTITY % confnum.attlist "INCLUDE"> +<![%confnum.attlist;[ +<!ATTLIST confnum + %common.attrib; + %confnum.role.attrib; + %local.confnum.attrib; +> +<!--end of confnum.attlist-->]]> + <!--end of confnum.module-->]]> + + <!-- Address (defined elsewhere in this section)--> + + <!ENTITY % confsponsor.module "INCLUDE"> + <![%confsponsor.module;[ + <!ENTITY % local.confsponsor.attrib ""> + <!ENTITY % confsponsor.role.attrib "%role.attrib;"> + +<!ENTITY % confsponsor.element "INCLUDE"> +<![%confsponsor.element;[ +<!--doc:The sponsor of a conference for which a document was written.--> +<!ELEMENT confsponsor %ho; (%docinfo.char.mix;)*> +<!--end of confsponsor.element-->]]> + +<!ENTITY % confsponsor.attlist "INCLUDE"> +<![%confsponsor.attlist;[ +<!ATTLIST confsponsor + %common.attrib; + %confsponsor.role.attrib; + %local.confsponsor.attrib; +> +<!--end of confsponsor.attlist-->]]> + <!--end of confsponsor.module-->]]> +<!--end of confgroup.content.module-->]]> + +<!-- ContractNum ...................... --> + +<!ENTITY % contractnum.module "INCLUDE"> +<![%contractnum.module;[ +<!ENTITY % local.contractnum.attrib ""> +<!ENTITY % contractnum.role.attrib "%role.attrib;"> + +<!ENTITY % contractnum.element "INCLUDE"> +<![%contractnum.element;[ +<!--doc:The contract number of a document.--> +<!ELEMENT contractnum %ho; (%docinfo.char.mix;)*> +<!--end of contractnum.element-->]]> + +<!ENTITY % contractnum.attlist "INCLUDE"> +<![%contractnum.attlist;[ +<!ATTLIST contractnum + %common.attrib; + %contractnum.role.attrib; + %local.contractnum.attrib; +> +<!--end of contractnum.attlist-->]]> +<!--end of contractnum.module-->]]> + +<!-- ContractSponsor .................. --> + +<!ENTITY % contractsponsor.module "INCLUDE"> +<![%contractsponsor.module;[ +<!ENTITY % local.contractsponsor.attrib ""> +<!ENTITY % contractsponsor.role.attrib "%role.attrib;"> + +<!ENTITY % contractsponsor.element "INCLUDE"> +<![%contractsponsor.element;[ +<!--doc:The sponsor of a contract.--> +<!ELEMENT contractsponsor %ho; (%docinfo.char.mix;)*> +<!--end of contractsponsor.element-->]]> + +<!ENTITY % contractsponsor.attlist "INCLUDE"> +<![%contractsponsor.attlist;[ +<!ATTLIST contractsponsor + %common.attrib; + %contractsponsor.role.attrib; + %local.contractsponsor.attrib; +> +<!--end of contractsponsor.attlist-->]]> +<!--end of contractsponsor.module-->]]> + +<!-- Copyright ........................ --> + +<!ENTITY % copyright.content.module "INCLUDE"> +<![%copyright.content.module;[ +<!ENTITY % copyright.module "INCLUDE"> +<![%copyright.module;[ +<!ENTITY % local.copyright.attrib ""> +<!ENTITY % copyright.role.attrib "%role.attrib;"> + +<!ENTITY % copyright.element "INCLUDE"> +<![%copyright.element;[ +<!--doc:Copyright information about a document.--> +<!ELEMENT copyright %ho; (year+, holder*)> +<!--end of copyright.element-->]]> + +<!ENTITY % copyright.attlist "INCLUDE"> +<![%copyright.attlist;[ +<!ATTLIST copyright + %common.attrib; + %copyright.role.attrib; + %local.copyright.attrib; +> +<!--end of copyright.attlist-->]]> +<!--end of copyright.module-->]]> + + <!ENTITY % year.module "INCLUDE"> + <![%year.module;[ + <!ENTITY % local.year.attrib ""> + <!ENTITY % year.role.attrib "%role.attrib;"> + +<!ENTITY % year.element "INCLUDE"> +<![%year.element;[ +<!--doc:The year of publication of a document.--> +<!ELEMENT year %ho; (%docinfo.char.mix;)*> +<!--end of year.element-->]]> + +<!ENTITY % year.attlist "INCLUDE"> +<![%year.attlist;[ +<!ATTLIST year + %common.attrib; + %year.role.attrib; + %local.year.attrib; +> +<!--end of year.attlist-->]]> + <!--end of year.module-->]]> + + <!ENTITY % holder.module "INCLUDE"> + <![%holder.module;[ + <!ENTITY % local.holder.attrib ""> + <!ENTITY % holder.role.attrib "%role.attrib;"> + +<!ENTITY % holder.element "INCLUDE"> +<![%holder.element;[ +<!--doc:The name of the individual or organization that holds a copyright.--> +<!ELEMENT holder %ho; (%docinfo.char.mix;)*> +<!--end of holder.element-->]]> + +<!ENTITY % holder.attlist "INCLUDE"> +<![%holder.attlist;[ +<!ATTLIST holder + %common.attrib; + %holder.role.attrib; + %local.holder.attrib; +> +<!--end of holder.attlist-->]]> + <!--end of holder.module-->]]> +<!--end of copyright.content.module-->]]> + +<!-- CorpAuthor ....................... --> + +<!ENTITY % corpauthor.module "INCLUDE"> +<![%corpauthor.module;[ +<!ENTITY % local.corpauthor.attrib ""> +<!ENTITY % corpauthor.role.attrib "%role.attrib;"> + +<!ENTITY % corpauthor.element "INCLUDE"> +<![%corpauthor.element;[ +<!--doc:A corporate author, as opposed to an individual.--> +<!ELEMENT corpauthor %ho; (%docinfo.char.mix;)*> +<!--end of corpauthor.element-->]]> + +<!ENTITY % corpauthor.attlist "INCLUDE"> +<![%corpauthor.attlist;[ +<!ATTLIST corpauthor + %common.attrib; + %corpauthor.role.attrib; + %local.corpauthor.attrib; +> +<!--end of corpauthor.attlist-->]]> +<!--end of corpauthor.module-->]]> + +<!-- CorpCredit ...................... --> + +<!ENTITY % corpcredit.module "INCLUDE"> +<![%corpcredit.module;[ +<!ENTITY % local.corpcredit.attrib ""> +<!ENTITY % corpcredit.role.attrib "%role.attrib;"> + +<!ENTITY % corpcredit.element "INCLUDE"> +<![%corpcredit.element;[ +<!--doc:A corporation or organization credited in a document.--> +<!ELEMENT corpcredit %ho; (%docinfo.char.mix;)*> +<!--end of corpcredit.element-->]]> + +<!ENTITY % corpcredit.attlist "INCLUDE"> +<![%corpcredit.attlist;[ +<!ATTLIST corpcredit + class (graphicdesigner + |productioneditor + |copyeditor + |technicaleditor + |translator + |other) #IMPLIED + %common.attrib; + %corpcredit.role.attrib; + %local.corpcredit.attrib; +> +<!--end of corpcredit.attlist-->]]> +<!--end of corpcredit.module-->]]> + +<!-- CorpName ......................... --> + +<!ENTITY % corpname.module "INCLUDE"> +<![%corpname.module;[ +<!ENTITY % local.corpname.attrib ""> + +<!ENTITY % corpname.element "INCLUDE"> +<![%corpname.element;[ +<!--doc:The name of a corporation.--> +<!ELEMENT corpname %ho; (%docinfo.char.mix;)*> +<!--end of corpname.element-->]]> +<!ENTITY % corpname.role.attrib "%role.attrib;"> + +<!ENTITY % corpname.attlist "INCLUDE"> +<![%corpname.attlist;[ +<!ATTLIST corpname + %common.attrib; + %corpname.role.attrib; + %local.corpname.attrib; +> +<!--end of corpname.attlist-->]]> +<!--end of corpname.module-->]]> + +<!-- Date ............................. --> + +<!ENTITY % date.module "INCLUDE"> +<![%date.module;[ +<!ENTITY % local.date.attrib ""> +<!ENTITY % date.role.attrib "%role.attrib;"> + +<!ENTITY % date.element "INCLUDE"> +<![%date.element;[ +<!--doc:The date of publication or revision of a document.--> +<!ELEMENT date %ho; (%docinfo.char.mix;)*> +<!--end of date.element-->]]> + +<!ENTITY % date.attlist "INCLUDE"> +<![%date.attlist;[ +<!ATTLIST date + %common.attrib; + %date.role.attrib; + %local.date.attrib; +> +<!--end of date.attlist-->]]> +<!--end of date.module-->]]> + +<!-- Edition .......................... --> + +<!ENTITY % edition.module "INCLUDE"> +<![%edition.module;[ +<!ENTITY % local.edition.attrib ""> +<!ENTITY % edition.role.attrib "%role.attrib;"> + +<!ENTITY % edition.element "INCLUDE"> +<![%edition.element;[ +<!--doc:The name or number of an edition of a document.--> +<!ELEMENT edition %ho; (%docinfo.char.mix;)*> +<!--end of edition.element-->]]> + +<!ENTITY % edition.attlist "INCLUDE"> +<![%edition.attlist;[ +<!ATTLIST edition + %common.attrib; + %edition.role.attrib; + %local.edition.attrib; +> +<!--end of edition.attlist-->]]> +<!--end of edition.module-->]]> + +<!-- Editor ........................... --> + +<!ENTITY % editor.module "INCLUDE"> +<![%editor.module;[ +<!ENTITY % local.editor.attrib ""> +<!ENTITY % editor.role.attrib "%role.attrib;"> + +<!ENTITY % editor.element "INCLUDE"> +<![%editor.element;[ +<!--doc:The name of the editor of a document.--> +<!ELEMENT editor %ho; ((personname|(%person.ident.mix;)+),(personblurb|email|address)*)> +<!--end of editor.element-->]]> + +<!ENTITY % editor.attlist "INCLUDE"> +<![%editor.attlist;[ +<!ATTLIST editor + %common.attrib; + %editor.role.attrib; + %local.editor.attrib; +> +<!--end of editor.attlist-->]]> + <!--(see "Personal identity elements" for %person.ident.mix;)--> +<!--end of editor.module-->]]> + +<!-- ISBN ............................. --> + +<!ENTITY % isbn.module "INCLUDE"> +<![%isbn.module;[ +<!ENTITY % local.isbn.attrib ""> +<!ENTITY % isbn.role.attrib "%role.attrib;"> + +<!ENTITY % isbn.element "INCLUDE"> +<![%isbn.element;[ +<!--doc:The International Standard Book Number of a document.--> +<!ELEMENT isbn %ho; (%docinfo.char.mix;)*> +<!--end of isbn.element-->]]> + +<!ENTITY % isbn.attlist "INCLUDE"> +<![%isbn.attlist;[ +<!ATTLIST isbn + %common.attrib; + %isbn.role.attrib; + %local.isbn.attrib; +> +<!--end of isbn.attlist-->]]> +<!--end of isbn.module-->]]> + +<!-- ISSN ............................. --> + +<!ENTITY % issn.module "INCLUDE"> +<![%issn.module;[ +<!ENTITY % local.issn.attrib ""> +<!ENTITY % issn.role.attrib "%role.attrib;"> + +<!ENTITY % issn.element "INCLUDE"> +<![%issn.element;[ +<!--doc:The International Standard Serial Number of a periodical.--> +<!ELEMENT issn %ho; (%docinfo.char.mix;)*> +<!--end of issn.element-->]]> + +<!ENTITY % issn.attlist "INCLUDE"> +<![%issn.attlist;[ +<!ATTLIST issn + %common.attrib; + %issn.role.attrib; + %local.issn.attrib; +> +<!--end of issn.attlist-->]]> +<!--end of issn.module-->]]> + +<!-- BiblioId ................. --> +<!ENTITY % biblio.class.attrib + "class (uri + |doi + |isbn + |isrn + |issn + |libraryofcongress + |pubnumber + |other) #IMPLIED + otherclass CDATA #IMPLIED" +> + +<!ENTITY % biblioid.module "INCLUDE"> +<![%biblioid.module;[ +<!ENTITY % local.biblioid.attrib ""> +<!ENTITY % biblioid.role.attrib "%role.attrib;"> + +<!ENTITY % biblioid.element "INCLUDE"> +<![%biblioid.element;[ +<!--doc:An identifier for a document.--> +<!ELEMENT biblioid %ho; (%docinfo.char.mix;)*> +<!--end of biblioid.element-->]]> + +<!ENTITY % biblioid.attlist "INCLUDE"> +<![%biblioid.attlist;[ +<!ATTLIST biblioid + %biblio.class.attrib; + %common.attrib; + %biblioid.role.attrib; + %local.biblioid.attrib; +> +<!--end of biblioid.attlist-->]]> +<!--end of biblioid.module-->]]> + +<!-- CiteBiblioId ................. --> + +<!ENTITY % citebiblioid.module "INCLUDE"> +<![%citebiblioid.module;[ +<!ENTITY % local.citebiblioid.attrib ""> +<!ENTITY % citebiblioid.role.attrib "%role.attrib;"> + +<!ENTITY % citebiblioid.element "INCLUDE"> +<![%citebiblioid.element;[ +<!--doc:A citation of a bibliographic identifier.--> +<!ELEMENT citebiblioid %ho; (%docinfo.char.mix;)*> +<!--end of citebiblioid.element-->]]> + +<!ENTITY % citebiblioid.attlist "INCLUDE"> +<![%citebiblioid.attlist;[ +<!ATTLIST citebiblioid + %biblio.class.attrib; + %common.attrib; + %citebiblioid.role.attrib; + %local.citebiblioid.attrib; +> +<!--end of citebiblioid.attlist-->]]> +<!--end of citebiblioid.module-->]]> + +<!-- BiblioSource ................. --> + +<!ENTITY % bibliosource.module "INCLUDE"> +<![%bibliosource.module;[ +<!ENTITY % local.bibliosource.attrib ""> +<!ENTITY % bibliosource.role.attrib "%role.attrib;"> + +<!ENTITY % bibliosource.element "INCLUDE"> +<![%bibliosource.element;[ +<!--doc:The source of a document.--> +<!ELEMENT bibliosource %ho; (%docinfo.char.mix;)*> +<!--end of bibliosource.element-->]]> + +<!ENTITY % bibliosource.attlist "INCLUDE"> +<![%bibliosource.attlist;[ +<!ATTLIST bibliosource + %biblio.class.attrib; + %common.attrib; + %bibliosource.role.attrib; + %local.bibliosource.attrib; +> +<!--end of bibliosource.attlist-->]]> +<!--end of bibliosource.module-->]]> + +<!-- BiblioRelation ................. --> + +<!ENTITY % bibliorelation.module "INCLUDE"> +<![%bibliorelation.module;[ +<!ENTITY % local.bibliorelation.attrib ""> +<!ENTITY % local.bibliorelation.types ""> + +<!ENTITY % bibliorelation.type.attrib + "type (isversionof + |hasversion + |isreplacedby + |replaces + |isrequiredby + |requires + |ispartof + |haspart + |isreferencedby + |references + |isformatof + |hasformat + |othertype + %local.bibliorelation.types;) #IMPLIED + othertype CDATA #IMPLIED +"> + +<!ENTITY % bibliorelation.role.attrib "%role.attrib;"> + +<!ENTITY % bibliorelation.element "INCLUDE"> +<![%bibliorelation.element;[ +<!--doc:The relationship of a document to another.--> +<!ELEMENT bibliorelation %ho; (%docinfo.char.mix;)*> +<!--end of bibliorelation.element-->]]> + +<!ENTITY % bibliorelation.attlist "INCLUDE"> +<![%bibliorelation.attlist;[ +<!ATTLIST bibliorelation + %biblio.class.attrib; + %bibliorelation.type.attrib; + %common.attrib; + %bibliorelation.role.attrib; + %local.bibliorelation.attrib; +> +<!--end of bibliorelation.attlist-->]]> +<!--end of bibliorelation.module-->]]> + +<!-- BiblioCoverage ................. --> + +<!ENTITY % bibliocoverage.module "INCLUDE"> +<![%bibliocoverage.module;[ +<!ENTITY % local.bibliocoverage.attrib ""> +<!ENTITY % bibliocoverage.role.attrib "%role.attrib;"> + +<!ENTITY % bibliocoverage.element "INCLUDE"> +<![%bibliocoverage.element;[ +<!--doc:The spatial or temporal coverage of a document.--> +<!ELEMENT bibliocoverage %ho; (%docinfo.char.mix;)*> +<!--end of bibliocoverage.element-->]]> + +<!ENTITY % bibliocoverage.attlist "INCLUDE"> +<![%bibliocoverage.attlist;[ +<!ATTLIST bibliocoverage + spatial (dcmipoint|iso3166|dcmibox|tgn|otherspatial) #IMPLIED + otherspatial CDATA #IMPLIED + temporal (dcmiperiod|w3c-dtf|othertemporal) #IMPLIED + othertemporal CDATA #IMPLIED + %common.attrib; + %bibliocoverage.role.attrib; + %local.bibliocoverage.attrib; +> +<!--end of bibliocoverage.attlist-->]]> +<!--end of bibliocoverage.module-->]]> + +<!-- InvPartNumber .................... --> + +<!ENTITY % invpartnumber.module "INCLUDE"> +<![%invpartnumber.module;[ +<!ENTITY % local.invpartnumber.attrib ""> +<!ENTITY % invpartnumber.role.attrib "%role.attrib;"> + +<!ENTITY % invpartnumber.element "INCLUDE"> +<![%invpartnumber.element;[ +<!--doc:An inventory part number.--> +<!ELEMENT invpartnumber %ho; (%docinfo.char.mix;)*> +<!--end of invpartnumber.element-->]]> + +<!ENTITY % invpartnumber.attlist "INCLUDE"> +<![%invpartnumber.attlist;[ +<!ATTLIST invpartnumber + %common.attrib; + %invpartnumber.role.attrib; + %local.invpartnumber.attrib; +> +<!--end of invpartnumber.attlist-->]]> +<!--end of invpartnumber.module-->]]> + +<!-- IssueNum ......................... --> + +<!ENTITY % issuenum.module "INCLUDE"> +<![%issuenum.module;[ +<!ENTITY % local.issuenum.attrib ""> +<!ENTITY % issuenum.role.attrib "%role.attrib;"> + +<!ENTITY % issuenum.element "INCLUDE"> +<![%issuenum.element;[ +<!--doc:The number of an issue of a journal.--> +<!ELEMENT issuenum %ho; (%docinfo.char.mix;)*> +<!--end of issuenum.element-->]]> + +<!ENTITY % issuenum.attlist "INCLUDE"> +<![%issuenum.attlist;[ +<!ATTLIST issuenum + %common.attrib; + %issuenum.role.attrib; + %local.issuenum.attrib; +> +<!--end of issuenum.attlist-->]]> +<!--end of issuenum.module-->]]> + +<!-- LegalNotice ...................... --> + +<!ENTITY % legalnotice.module "INCLUDE"> +<![%legalnotice.module;[ +<!ENTITY % local.legalnotice.attrib ""> +<!ENTITY % legalnotice.role.attrib "%role.attrib;"> + +<!ENTITY % legalnotice.element "INCLUDE"> +<![%legalnotice.element;[ +<!--doc:A statement of legal obligations or requirements.--> +<!ELEMENT legalnotice %ho; (blockinfo?, title?, (%legalnotice.mix;)+) + %formal.exclusion;> +<!--end of legalnotice.element-->]]> + +<!ENTITY % legalnotice.attlist "INCLUDE"> +<![%legalnotice.attlist;[ +<!ATTLIST legalnotice + %common.attrib; + %legalnotice.role.attrib; + %local.legalnotice.attrib; +> +<!--end of legalnotice.attlist-->]]> +<!--end of legalnotice.module-->]]> + +<!-- ModeSpec ......................... --> + +<!ENTITY % modespec.module "INCLUDE"> +<![%modespec.module;[ +<!ENTITY % local.modespec.attrib ""> +<!ENTITY % modespec.role.attrib "%role.attrib;"> + +<!ENTITY % modespec.element "INCLUDE"> +<![%modespec.element;[ +<!--doc:Application-specific information necessary for the completion of an OLink.--> +<!ELEMENT modespec %ho; (%docinfo.char.mix;)* + %ubiq.exclusion;> +<!--end of modespec.element-->]]> + +<!-- Application: Type of action required for completion + of the links to which the ModeSpec is relevant (e.g., + retrieval query) --> + + +<!ENTITY % modespec.attlist "INCLUDE"> +<![%modespec.attlist;[ +<!ATTLIST modespec + application NOTATION + (%notation.class;) #IMPLIED + %common.attrib; + %modespec.role.attrib; + %local.modespec.attrib; +> +<!--end of modespec.attlist-->]]> +<!--end of modespec.module-->]]> + +<!-- OrgName .......................... --> + +<!ENTITY % orgname.module "INCLUDE"> +<![%orgname.module;[ +<!ENTITY % local.orgname.attrib ""> +<!ENTITY % orgname.role.attrib "%role.attrib;"> + +<!ENTITY % orgname.element "INCLUDE"> +<![%orgname.element;[ +<!--doc:The name of an organization other than a corporation.--> +<!ELEMENT orgname %ho; (%docinfo.char.mix;)*> +<!--end of orgname.element-->]]> + +<!ENTITY % orgname.attlist "INCLUDE"> +<![%orgname.attlist;[ +<!ATTLIST orgname + %common.attrib; + class (corporation|nonprofit|consortium|informal|other) #IMPLIED + otherclass CDATA #IMPLIED + %orgname.role.attrib; + %local.orgname.attrib; +> +<!--end of orgname.attlist-->]]> +<!--end of orgname.module-->]]> + +<!-- OtherCredit ...................... --> + +<!ENTITY % othercredit.module "INCLUDE"> +<![%othercredit.module;[ +<!ENTITY % local.othercredit.attrib ""> +<!ENTITY % othercredit.role.attrib "%role.attrib;"> + +<!ENTITY % othercredit.element "INCLUDE"> +<![%othercredit.element;[ +<!--doc:A person or entity, other than an author or editor, credited in a document.--> +<!ELEMENT othercredit %ho; ((personname|(%person.ident.mix;)+), + (personblurb|email|address)*)> +<!--end of othercredit.element-->]]> + +<!ENTITY % othercredit.attlist "INCLUDE"> +<![%othercredit.attlist;[ +<!ATTLIST othercredit + class (graphicdesigner + |productioneditor + |copyeditor + |technicaleditor + |translator + |other) #IMPLIED + %common.attrib; + %othercredit.role.attrib; + %local.othercredit.attrib; +> +<!--end of othercredit.attlist-->]]> + <!--(see "Personal identity elements" for %person.ident.mix;)--> +<!--end of othercredit.module-->]]> + +<!-- PageNums ......................... --> + +<!ENTITY % pagenums.module "INCLUDE"> +<![%pagenums.module;[ +<!ENTITY % local.pagenums.attrib ""> +<!ENTITY % pagenums.role.attrib "%role.attrib;"> + +<!ENTITY % pagenums.element "INCLUDE"> +<![%pagenums.element;[ +<!--doc:The numbers of the pages in a book, for use in a bibliographic entry.--> +<!ELEMENT pagenums %ho; (%docinfo.char.mix;)*> +<!--end of pagenums.element-->]]> + +<!ENTITY % pagenums.attlist "INCLUDE"> +<![%pagenums.attlist;[ +<!ATTLIST pagenums + %common.attrib; + %pagenums.role.attrib; + %local.pagenums.attrib; +> +<!--end of pagenums.attlist-->]]> +<!--end of pagenums.module-->]]> + +<!-- Personal identity elements ....... --> + +<!-- These elements are used only within Author, Editor, and +OtherCredit. --> + +<!ENTITY % person.ident.module "INCLUDE"> +<![%person.ident.module;[ + <!ENTITY % contrib.module "INCLUDE"> + <![%contrib.module;[ + <!ENTITY % local.contrib.attrib ""> + <!ENTITY % contrib.role.attrib "%role.attrib;"> + +<!ENTITY % contrib.element "INCLUDE"> +<![%contrib.element;[ +<!--doc:A summary of the contributions made to a document by a credited source.--> +<!ELEMENT contrib %ho; (%docinfo.char.mix;)*> +<!--end of contrib.element-->]]> + +<!ENTITY % contrib.attlist "INCLUDE"> +<![%contrib.attlist;[ +<!ATTLIST contrib + %common.attrib; + %contrib.role.attrib; + %local.contrib.attrib; +> +<!--end of contrib.attlist-->]]> + <!--end of contrib.module-->]]> + + <!ENTITY % firstname.module "INCLUDE"> + <![%firstname.module;[ + <!ENTITY % local.firstname.attrib ""> + <!ENTITY % firstname.role.attrib "%role.attrib;"> + +<!ENTITY % firstname.element "INCLUDE"> +<![%firstname.element;[ +<!--doc:The first name of a person.--> +<!ELEMENT firstname %ho; (%docinfo.char.mix;)*> +<!--end of firstname.element-->]]> + +<!ENTITY % firstname.attlist "INCLUDE"> +<![%firstname.attlist;[ +<!ATTLIST firstname + %common.attrib; + %firstname.role.attrib; + %local.firstname.attrib; +> +<!--end of firstname.attlist-->]]> + <!--end of firstname.module-->]]> + + <!ENTITY % honorific.module "INCLUDE"> + <![%honorific.module;[ + <!ENTITY % local.honorific.attrib ""> + <!ENTITY % honorific.role.attrib "%role.attrib;"> + +<!ENTITY % honorific.element "INCLUDE"> +<![%honorific.element;[ +<!--doc:The title of a person.--> +<!ELEMENT honorific %ho; (%docinfo.char.mix;)*> +<!--end of honorific.element-->]]> + +<!ENTITY % honorific.attlist "INCLUDE"> +<![%honorific.attlist;[ +<!ATTLIST honorific + %common.attrib; + %honorific.role.attrib; + %local.honorific.attrib; +> +<!--end of honorific.attlist-->]]> + <!--end of honorific.module-->]]> + + <!ENTITY % lineage.module "INCLUDE"> + <![%lineage.module;[ + <!ENTITY % local.lineage.attrib ""> + <!ENTITY % lineage.role.attrib "%role.attrib;"> + +<!ENTITY % lineage.element "INCLUDE"> +<![%lineage.element;[ +<!--doc:The portion of a person's name indicating a relationship to ancestors.--> +<!ELEMENT lineage %ho; (%docinfo.char.mix;)*> +<!--end of lineage.element-->]]> + +<!ENTITY % lineage.attlist "INCLUDE"> +<![%lineage.attlist;[ +<!ATTLIST lineage + %common.attrib; + %lineage.role.attrib; + %local.lineage.attrib; +> +<!--end of lineage.attlist-->]]> + <!--end of lineage.module-->]]> + + <!ENTITY % othername.module "INCLUDE"> + <![%othername.module;[ + <!ENTITY % local.othername.attrib ""> + <!ENTITY % othername.role.attrib "%role.attrib;"> + +<!ENTITY % othername.element "INCLUDE"> +<![%othername.element;[ +<!--doc:A component of a persons name that is not a first name, surname, or lineage.--> +<!ELEMENT othername %ho; (%docinfo.char.mix;)*> +<!--end of othername.element-->]]> + +<!ENTITY % othername.attlist "INCLUDE"> +<![%othername.attlist;[ +<!ATTLIST othername + %common.attrib; + %othername.role.attrib; + %local.othername.attrib; +> +<!--end of othername.attlist-->]]> + <!--end of othername.module-->]]> + + <!ENTITY % surname.module "INCLUDE"> + <![%surname.module;[ + <!ENTITY % local.surname.attrib ""> + <!ENTITY % surname.role.attrib "%role.attrib;"> + +<!ENTITY % surname.element "INCLUDE"> +<![%surname.element;[ +<!--doc:A family name; in western cultures the last name.--> +<!ELEMENT surname %ho; (%docinfo.char.mix;)*> +<!--end of surname.element-->]]> + +<!ENTITY % surname.attlist "INCLUDE"> +<![%surname.attlist;[ +<!ATTLIST surname + %common.attrib; + %surname.role.attrib; + %local.surname.attrib; +> +<!--end of surname.attlist-->]]> + <!--end of surname.module-->]]> +<!--end of person.ident.module-->]]> + +<!-- PrintHistory ..................... --> + +<!ENTITY % printhistory.module "INCLUDE"> +<![%printhistory.module;[ +<!ENTITY % local.printhistory.attrib ""> +<!ENTITY % printhistory.role.attrib "%role.attrib;"> + +<!ENTITY % printhistory.element "INCLUDE"> +<![%printhistory.element;[ +<!--doc:The printing history of a document.--> +<!ELEMENT printhistory %ho; ((%para.class;)+)> +<!--end of printhistory.element-->]]> + +<!ENTITY % printhistory.attlist "INCLUDE"> +<![%printhistory.attlist;[ +<!ATTLIST printhistory + %common.attrib; + %printhistory.role.attrib; + %local.printhistory.attrib; +> +<!--end of printhistory.attlist-->]]> +<!--end of printhistory.module-->]]> + +<!-- ProductName ...................... --> + +<!ENTITY % productname.module "INCLUDE"> +<![%productname.module;[ +<!ENTITY % local.productname.attrib ""> +<!ENTITY % productname.role.attrib "%role.attrib;"> + +<!ENTITY % productname.element "INCLUDE"> +<![%productname.element;[ +<!--doc:The formal name of a product.--> +<!ELEMENT productname %ho; (%para.char.mix;)*> +<!--end of productname.element-->]]> + +<!-- Class: More precisely identifies the item the element names --> + + +<!ENTITY % productname.attlist "INCLUDE"> +<![%productname.attlist;[ +<!ATTLIST productname + class (service + |trade + |registered + |copyright) 'trade' + %common.attrib; + %productname.role.attrib; + %local.productname.attrib; +> +<!--end of productname.attlist-->]]> +<!--end of productname.module-->]]> + +<!-- ProductNumber .................... --> + +<!ENTITY % productnumber.module "INCLUDE"> +<![%productnumber.module;[ +<!ENTITY % local.productnumber.attrib ""> +<!ENTITY % productnumber.role.attrib "%role.attrib;"> + +<!ENTITY % productnumber.element "INCLUDE"> +<![%productnumber.element;[ +<!--doc:A number assigned to a product.--> +<!ELEMENT productnumber %ho; (%docinfo.char.mix;)*> +<!--end of productnumber.element-->]]> + +<!ENTITY % productnumber.attlist "INCLUDE"> +<![%productnumber.attlist;[ +<!ATTLIST productnumber + %common.attrib; + %productnumber.role.attrib; + %local.productnumber.attrib; +> +<!--end of productnumber.attlist-->]]> +<!--end of productnumber.module-->]]> + +<!-- PubDate .......................... --> + +<!ENTITY % pubdate.module "INCLUDE"> +<![%pubdate.module;[ +<!ENTITY % local.pubdate.attrib ""> +<!ENTITY % pubdate.role.attrib "%role.attrib;"> + +<!ENTITY % pubdate.element "INCLUDE"> +<![%pubdate.element;[ +<!--doc:The date of publication of a document.--> +<!ELEMENT pubdate %ho; (%docinfo.char.mix;)*> +<!--end of pubdate.element-->]]> + +<!ENTITY % pubdate.attlist "INCLUDE"> +<![%pubdate.attlist;[ +<!ATTLIST pubdate + %common.attrib; + %pubdate.role.attrib; + %local.pubdate.attrib; +> +<!--end of pubdate.attlist-->]]> +<!--end of pubdate.module-->]]> + +<!-- Publisher ........................ --> + +<!ENTITY % publisher.content.module "INCLUDE"> +<![%publisher.content.module;[ +<!ENTITY % publisher.module "INCLUDE"> +<![%publisher.module;[ +<!ENTITY % local.publisher.attrib ""> +<!ENTITY % publisher.role.attrib "%role.attrib;"> + +<!ENTITY % publisher.element "INCLUDE"> +<![%publisher.element;[ +<!--doc:The publisher of a document.--> +<!ELEMENT publisher %ho; (publishername, address*)> +<!--end of publisher.element-->]]> + +<!ENTITY % publisher.attlist "INCLUDE"> +<![%publisher.attlist;[ +<!ATTLIST publisher + %common.attrib; + %publisher.role.attrib; + %local.publisher.attrib; +> +<!--end of publisher.attlist-->]]> +<!--end of publisher.module-->]]> + + <!ENTITY % publishername.module "INCLUDE"> + <![%publishername.module;[ + <!ENTITY % local.publishername.attrib ""> + <!ENTITY % publishername.role.attrib "%role.attrib;"> + +<!ENTITY % publishername.element "INCLUDE"> +<![%publishername.element;[ +<!--doc:The name of the publisher of a document.--> +<!ELEMENT publishername %ho; (%docinfo.char.mix;)*> +<!--end of publishername.element-->]]> + +<!ENTITY % publishername.attlist "INCLUDE"> +<![%publishername.attlist;[ +<!ATTLIST publishername + %common.attrib; + %publishername.role.attrib; + %local.publishername.attrib; +> +<!--end of publishername.attlist-->]]> + <!--end of publishername.module-->]]> + + <!-- Address (defined elsewhere in this section)--> +<!--end of publisher.content.module-->]]> + +<!-- PubsNumber ....................... --> + +<!ENTITY % pubsnumber.module "INCLUDE"> +<![%pubsnumber.module;[ +<!ENTITY % local.pubsnumber.attrib ""> +<!ENTITY % pubsnumber.role.attrib "%role.attrib;"> + +<!ENTITY % pubsnumber.element "INCLUDE"> +<![%pubsnumber.element;[ +<!--doc:A number assigned to a publication other than an ISBN or ISSN or inventory part number.--> +<!ELEMENT pubsnumber %ho; (%docinfo.char.mix;)*> +<!--end of pubsnumber.element-->]]> + +<!ENTITY % pubsnumber.attlist "INCLUDE"> +<![%pubsnumber.attlist;[ +<!ATTLIST pubsnumber + %common.attrib; + %pubsnumber.role.attrib; + %local.pubsnumber.attrib; +> +<!--end of pubsnumber.attlist-->]]> +<!--end of pubsnumber.module-->]]> + +<!-- ReleaseInfo ...................... --> + +<!ENTITY % releaseinfo.module "INCLUDE"> +<![%releaseinfo.module;[ +<!ENTITY % local.releaseinfo.attrib ""> +<!ENTITY % releaseinfo.role.attrib "%role.attrib;"> + +<!ENTITY % releaseinfo.element "INCLUDE"> +<![%releaseinfo.element;[ +<!--doc:Information about a particular release of a document.--> +<!ELEMENT releaseinfo %ho; (%docinfo.char.mix;)*> +<!--end of releaseinfo.element-->]]> + +<!ENTITY % releaseinfo.attlist "INCLUDE"> +<![%releaseinfo.attlist;[ +<!ATTLIST releaseinfo + %common.attrib; + %releaseinfo.role.attrib; + %local.releaseinfo.attrib; +> +<!--end of releaseinfo.attlist-->]]> +<!--end of releaseinfo.module-->]]> + +<!-- RevHistory ....................... --> + +<!ENTITY % revhistory.content.module "INCLUDE"> +<![%revhistory.content.module;[ +<!ENTITY % revhistory.module "INCLUDE"> +<![%revhistory.module;[ +<!ENTITY % local.revhistory.attrib ""> +<!ENTITY % revhistory.role.attrib "%role.attrib;"> + +<!ENTITY % revhistory.element "INCLUDE"> +<![%revhistory.element;[ +<!--doc:A history of the revisions to a document.--> +<!ELEMENT revhistory %ho; (revision+)> +<!--end of revhistory.element-->]]> + +<!ENTITY % revhistory.attlist "INCLUDE"> +<![%revhistory.attlist;[ +<!ATTLIST revhistory + %common.attrib; + %revhistory.role.attrib; + %local.revhistory.attrib; +> +<!--end of revhistory.attlist-->]]> +<!--end of revhistory.module-->]]> + +<!ENTITY % revision.module "INCLUDE"> +<![%revision.module;[ +<!ENTITY % local.revision.attrib ""> +<!ENTITY % revision.role.attrib "%role.attrib;"> + +<!ENTITY % revision.element "INCLUDE"> +<![%revision.element;[ +<!--doc:An entry describing a single revision in the history of the revisions to a document.--> +<!ELEMENT revision %ho; (revnumber?, date, (author|authorinitials)*, + (revremark|revdescription)?)> +<!--end of revision.element-->]]> + +<!ENTITY % revision.attlist "INCLUDE"> +<![%revision.attlist;[ +<!ATTLIST revision + %common.attrib; + %revision.role.attrib; + %local.revision.attrib; +> +<!--end of revision.attlist-->]]> +<!--end of revision.module-->]]> + +<!ENTITY % revnumber.module "INCLUDE"> +<![%revnumber.module;[ +<!ENTITY % local.revnumber.attrib ""> +<!ENTITY % revnumber.role.attrib "%role.attrib;"> + +<!ENTITY % revnumber.element "INCLUDE"> +<![%revnumber.element;[ +<!--doc:A document revision number.--> +<!ELEMENT revnumber %ho; (%docinfo.char.mix;)*> +<!--end of revnumber.element-->]]> + +<!ENTITY % revnumber.attlist "INCLUDE"> +<![%revnumber.attlist;[ +<!ATTLIST revnumber + %common.attrib; + %revnumber.role.attrib; + %local.revnumber.attrib; +> +<!--end of revnumber.attlist-->]]> +<!--end of revnumber.module-->]]> + +<!-- Date (defined elsewhere in this section)--> +<!-- AuthorInitials (defined elsewhere in this section)--> + +<!ENTITY % revremark.module "INCLUDE"> +<![%revremark.module;[ +<!ENTITY % local.revremark.attrib ""> +<!ENTITY % revremark.role.attrib "%role.attrib;"> + +<!ENTITY % revremark.element "INCLUDE"> +<![%revremark.element;[ +<!--doc:A description of a revision to a document.--> +<!ELEMENT revremark %ho; (%docinfo.char.mix;)*> +<!--end of revremark.element-->]]> + +<!ENTITY % revremark.attlist "INCLUDE"> +<![%revremark.attlist;[ +<!ATTLIST revremark + %common.attrib; + %revremark.role.attrib; + %local.revremark.attrib; +> +<!--end of revremark.attlist-->]]> +<!--end of revremark.module-->]]> + +<!ENTITY % revdescription.module "INCLUDE"> +<![ %revdescription.module; [ +<!ENTITY % local.revdescription.attrib ""> +<!ENTITY % revdescription.role.attrib "%role.attrib;"> + +<!ENTITY % revdescription.element "INCLUDE"> +<![ %revdescription.element; [ +<!--doc:A extended description of a revision to a document.--> +<!ELEMENT revdescription %ho; ((%revdescription.mix;)+)> +<!--end of revdescription.element-->]]> + +<!ENTITY % revdescription.attlist "INCLUDE"> +<![ %revdescription.attlist; [ +<!ATTLIST revdescription + %common.attrib; + %revdescription.role.attrib; + %local.revdescription.attrib; +> +<!--end of revdescription.attlist-->]]> +<!--end of revdescription.module-->]]> +<!--end of revhistory.content.module-->]]> + +<!-- SeriesVolNums .................... --> + +<!ENTITY % seriesvolnums.module "INCLUDE"> +<![%seriesvolnums.module;[ +<!ENTITY % local.seriesvolnums.attrib ""> +<!ENTITY % seriesvolnums.role.attrib "%role.attrib;"> + +<!ENTITY % seriesvolnums.element "INCLUDE"> +<![%seriesvolnums.element;[ +<!--doc:Numbers of the volumes in a series of books.--> +<!ELEMENT seriesvolnums %ho; (%docinfo.char.mix;)*> +<!--end of seriesvolnums.element-->]]> + +<!ENTITY % seriesvolnums.attlist "INCLUDE"> +<![%seriesvolnums.attlist;[ +<!ATTLIST seriesvolnums + %common.attrib; + %seriesvolnums.role.attrib; + %local.seriesvolnums.attrib; +> +<!--end of seriesvolnums.attlist-->]]> +<!--end of seriesvolnums.module-->]]> + +<!-- VolumeNum ........................ --> + +<!ENTITY % volumenum.module "INCLUDE"> +<![%volumenum.module;[ +<!ENTITY % local.volumenum.attrib ""> +<!ENTITY % volumenum.role.attrib "%role.attrib;"> + +<!ENTITY % volumenum.element "INCLUDE"> +<![%volumenum.element;[ +<!--doc:The volume number of a document in a set (as of books in a set or articles in a journal).--> +<!ELEMENT volumenum %ho; (%docinfo.char.mix;)*> +<!--end of volumenum.element-->]]> + +<!ENTITY % volumenum.attlist "INCLUDE"> +<![%volumenum.attlist;[ +<!ATTLIST volumenum + %common.attrib; + %volumenum.role.attrib; + %local.volumenum.attrib; +> +<!--end of volumenum.attlist-->]]> +<!--end of volumenum.module-->]]> + +<!-- .................................. --> + +<!--end of docinfo.content.module-->]]> + +<!-- ...................................................................... --> +<!-- Inline, link, and ubiquitous elements ................................ --> + +<!-- Technical and computer terms ......................................... --> + +<!ENTITY % accel.module "INCLUDE"> +<![%accel.module;[ +<!ENTITY % local.accel.attrib ""> +<!ENTITY % accel.role.attrib "%role.attrib;"> + +<!ENTITY % accel.element "INCLUDE"> +<![%accel.element;[ +<!--doc:A graphical user interface (GUI) keyboard shortcut.--> +<!ELEMENT accel %ho; (%smallcptr.char.mix;)*> +<!--end of accel.element-->]]> + +<!ENTITY % accel.attlist "INCLUDE"> +<![%accel.attlist;[ +<!ATTLIST accel + %common.attrib; + %accel.role.attrib; + %local.accel.attrib; +> +<!--end of accel.attlist-->]]> +<!--end of accel.module-->]]> + +<!ENTITY % action.module "INCLUDE"> +<![%action.module;[ +<!ENTITY % local.action.attrib ""> +<!ENTITY % action.role.attrib "%role.attrib;"> + +<!ENTITY % action.element "INCLUDE"> +<![%action.element;[ +<!--doc:A response to a user event.--> +<!ELEMENT action %ho; (%cptr.char.mix;)*> +<!--end of action.element-->]]> + +<!ENTITY % action.attlist "INCLUDE"> +<![%action.attlist;[ +<!ATTLIST action + %moreinfo.attrib; + %common.attrib; + %action.role.attrib; + %local.action.attrib; +> +<!--end of action.attlist-->]]> +<!--end of action.module-->]]> + +<!ENTITY % application.module "INCLUDE"> +<![%application.module;[ +<!ENTITY % local.application.attrib ""> +<!ENTITY % application.role.attrib "%role.attrib;"> + +<!ENTITY % application.element "INCLUDE"> +<![%application.element;[ +<!--doc:The name of a software program.--> +<!ELEMENT application %ho; (%para.char.mix;)*> +<!--end of application.element-->]]> + +<!ENTITY % application.attlist "INCLUDE"> +<![%application.attlist;[ +<!ATTLIST application + class (hardware + |software) #IMPLIED + %moreinfo.attrib; + %common.attrib; + %application.role.attrib; + %local.application.attrib; +> +<!--end of application.attlist-->]]> +<!--end of application.module-->]]> + +<!ENTITY % classname.module "INCLUDE"> +<![%classname.module;[ +<!ENTITY % local.classname.attrib ""> +<!ENTITY % classname.role.attrib "%role.attrib;"> + +<!ENTITY % classname.element "INCLUDE"> +<![%classname.element;[ +<!--doc:The name of a class, in the object-oriented programming sense.--> +<!ELEMENT classname %ho; (%smallcptr.char.mix;)*> +<!--end of classname.element-->]]> + +<!ENTITY % classname.attlist "INCLUDE"> +<![%classname.attlist;[ +<!ATTLIST classname + %common.attrib; + %classname.role.attrib; + %local.classname.attrib; +> +<!--end of classname.attlist-->]]> +<!--end of classname.module-->]]> + +<!ENTITY % package.module "INCLUDE"> +<![%package.module;[ +<!ENTITY % local.package.attrib ""> +<!ENTITY % package.role.attrib "%role.attrib;"> + +<!ENTITY % package.element "INCLUDE"> +<![%package.element;[ +<!--doc:A package.--> +<!ELEMENT package %ho; (%smallcptr.char.mix;)*> +<!--end of package.element-->]]> + +<!ENTITY % package.attlist "INCLUDE"> +<![%package.attlist;[ +<!ATTLIST package + %common.attrib; + %package.role.attrib; + %local.package.attrib; +> +<!--end of package.attlist-->]]> +<!--end of package.module-->]]> + +<!ENTITY % co.module "INCLUDE"> +<![%co.module;[ +<!ENTITY % local.co.attrib ""> +<!-- CO is a callout area of the LineColumn unit type (a single character + position); the position is directly indicated by the location of CO. --> +<!ENTITY % co.role.attrib "%role.attrib;"> + +<!ENTITY % co.element "INCLUDE"> +<![%co.element;[ +<!--doc:The location of a callout embedded in text.--> +<!ELEMENT co %ho; EMPTY> +<!--end of co.element-->]]> + +<!-- bug number/symbol override or initialization --> +<!-- to any related information --> + + +<!ENTITY % co.attlist "INCLUDE"> +<![%co.attlist;[ +<!ATTLIST co + %label.attrib; + %linkends.attrib; + %idreq.common.attrib; + %co.role.attrib; + %local.co.attrib; +> +<!--end of co.attlist-->]]> +<!--end of co.module-->]]> + +<!ENTITY % coref.module "INCLUDE"> +<![%coref.module;[ +<!ENTITY % local.coref.attrib ""> +<!-- COREF is a reference to a CO --> +<!ENTITY % coref.role.attrib "%role.attrib;"> + +<!ENTITY % coref.element "INCLUDE"> +<![%coref.element;[ +<!--doc:A cross reference to a co.--> +<!ELEMENT coref %ho; EMPTY> +<!--end of coref.element-->]]> + +<!-- bug number/symbol override or initialization --> +<!-- to any related information --> + +<!ENTITY % coref.attlist "INCLUDE"> +<![%coref.attlist;[ +<!ATTLIST coref + %label.attrib; + %linkendreq.attrib; + %common.attrib; + %coref.role.attrib; + %local.coref.attrib; +> +<!--end of coref.attlist-->]]> +<!--end of coref.module-->]]> + +<!ENTITY % command.module "INCLUDE"> +<![%command.module;[ +<!ENTITY % local.command.attrib ""> +<!ENTITY % command.role.attrib "%role.attrib;"> + +<!ENTITY % command.element "INCLUDE"> +<![%command.element;[ +<!--doc:The name of an executable program or other software command.--> +<!ELEMENT command %ho; (%cptr.char.mix;)*> +<!--end of command.element-->]]> + +<!ENTITY % command.attlist "INCLUDE"> +<![%command.attlist;[ +<!ATTLIST command + %moreinfo.attrib; + %common.attrib; + %command.role.attrib; + %local.command.attrib; +> +<!--end of command.attlist-->]]> +<!--end of command.module-->]]> + +<!ENTITY % computeroutput.module "INCLUDE"> +<![%computeroutput.module;[ +<!ENTITY % local.computeroutput.attrib ""> +<!ENTITY % computeroutput.role.attrib "%role.attrib;"> + +<!ENTITY % computeroutput.element "INCLUDE"> +<![%computeroutput.element;[ +<!--doc:Data, generally text, displayed or presented by a computer.--> +<!ELEMENT computeroutput %ho; (%cptr.char.mix;|co)*> +<!--end of computeroutput.element-->]]> + +<!ENTITY % computeroutput.attlist "INCLUDE"> +<![%computeroutput.attlist;[ +<!ATTLIST computeroutput + %moreinfo.attrib; + %common.attrib; + %computeroutput.role.attrib; + %local.computeroutput.attrib; +> +<!--end of computeroutput.attlist-->]]> +<!--end of computeroutput.module-->]]> + +<!ENTITY % database.module "INCLUDE"> +<![%database.module;[ +<!ENTITY % local.database.attrib ""> +<!ENTITY % database.role.attrib "%role.attrib;"> + +<!ENTITY % database.element "INCLUDE"> +<![%database.element;[ +<!--doc:The name of a database, or part of a database.--> +<!ELEMENT database %ho; (%cptr.char.mix;)*> +<!--end of database.element-->]]> + +<!-- Class: Type of database the element names; no default --> + + +<!ENTITY % database.attlist "INCLUDE"> +<![%database.attlist;[ +<!ATTLIST database + class (name + |table + |field + |key1 + |key2 + |record + |index + |view + |primarykey + |secondarykey + |foreignkey + |altkey + |procedure + |datatype + |constraint + |rule + |user + |group) #IMPLIED + %moreinfo.attrib; + %common.attrib; + %database.role.attrib; + %local.database.attrib; +> +<!--end of database.attlist-->]]> +<!--end of database.module-->]]> + +<!ENTITY % email.module "INCLUDE"> +<![%email.module;[ +<!ENTITY % local.email.attrib ""> +<!ENTITY % email.role.attrib "%role.attrib;"> + +<!ENTITY % email.element "INCLUDE"> +<![%email.element;[ +<!--doc:An email address.--> +<!ELEMENT email %ho; (%docinfo.char.mix;)*> +<!--end of email.element-->]]> + +<!ENTITY % email.attlist "INCLUDE"> +<![%email.attlist;[ +<!ATTLIST email + %common.attrib; + %email.role.attrib; + %local.email.attrib; +> +<!--end of email.attlist-->]]> +<!--end of email.module-->]]> + +<!ENTITY % envar.module "INCLUDE"> +<![%envar.module;[ +<!ENTITY % local.envar.attrib ""> +<!ENTITY % envar.role.attrib "%role.attrib;"> + +<!ENTITY % envar.element "INCLUDE"> +<![%envar.element;[ +<!--doc:A software environment variable.--> +<!ELEMENT envar %ho; (%smallcptr.char.mix;)*> +<!--end of envar.element-->]]> + +<!ENTITY % envar.attlist "INCLUDE"> +<![%envar.attlist;[ +<!ATTLIST envar + %common.attrib; + %envar.role.attrib; + %local.envar.attrib; +> +<!--end of envar.attlist-->]]> +<!--end of envar.module-->]]> + + +<!ENTITY % errorcode.module "INCLUDE"> +<![%errorcode.module;[ +<!ENTITY % local.errorcode.attrib ""> +<!ENTITY % errorcode.role.attrib "%role.attrib;"> + +<!ENTITY % errorcode.element "INCLUDE"> +<![%errorcode.element;[ +<!--doc:An error code.--> +<!ELEMENT errorcode %ho; (%smallcptr.char.mix;)*> +<!--end of errorcode.element-->]]> + +<!ENTITY % errorcode.attlist "INCLUDE"> +<![%errorcode.attlist;[ +<!ATTLIST errorcode + %moreinfo.attrib; + %common.attrib; + %errorcode.role.attrib; + %local.errorcode.attrib; +> +<!--end of errorcode.attlist-->]]> +<!--end of errorcode.module-->]]> + +<!ENTITY % errorname.module "INCLUDE"> +<![%errorname.module;[ +<!ENTITY % local.errorname.attrib ""> +<!ENTITY % errorname.role.attrib "%role.attrib;"> + +<!ENTITY % errorname.element "INCLUDE"> +<![%errorname.element;[ +<!--doc:An error name.--> +<!ELEMENT errorname %ho; (%smallcptr.char.mix;)*> +<!--end of errorname.element-->]]> + +<!ENTITY % errorname.attlist "INCLUDE"> +<![%errorname.attlist;[ +<!ATTLIST errorname + %common.attrib; + %errorname.role.attrib; + %local.errorname.attrib; +> +<!--end of errorname.attlist-->]]> +<!--end of errorname.module-->]]> + +<!ENTITY % errortext.module "INCLUDE"> +<![%errortext.module;[ +<!ENTITY % local.errortext.attrib ""> +<!ENTITY % errortext.role.attrib "%role.attrib;"> + +<!ENTITY % errortext.element "INCLUDE"> +<![%errortext.element;[ +<!--doc:An error message..--> +<!ELEMENT errortext %ho; (%smallcptr.char.mix;)*> +<!--end of errortext.element-->]]> + +<!ENTITY % errortext.attlist "INCLUDE"> +<![%errortext.attlist;[ +<!ATTLIST errortext + %common.attrib; + %errortext.role.attrib; + %local.errortext.attrib; +> +<!--end of errortext.attlist-->]]> +<!--end of errortext.module-->]]> + +<!ENTITY % errortype.module "INCLUDE"> +<![%errortype.module;[ +<!ENTITY % local.errortype.attrib ""> +<!ENTITY % errortype.role.attrib "%role.attrib;"> + +<!ENTITY % errortype.element "INCLUDE"> +<![%errortype.element;[ +<!--doc:The classification of an error message.--> +<!ELEMENT errortype %ho; (%smallcptr.char.mix;)*> +<!--end of errortype.element-->]]> + +<!ENTITY % errortype.attlist "INCLUDE"> +<![%errortype.attlist;[ +<!ATTLIST errortype + %common.attrib; + %errortype.role.attrib; + %local.errortype.attrib; +> +<!--end of errortype.attlist-->]]> +<!--end of errortype.module-->]]> + +<!ENTITY % filename.module "INCLUDE"> +<![%filename.module;[ +<!ENTITY % local.filename.attrib ""> +<!ENTITY % filename.role.attrib "%role.attrib;"> + +<!ENTITY % filename.element "INCLUDE"> +<![%filename.element;[ +<!--doc:The name of a file.--> +<!ELEMENT filename %ho; (%cptr.char.mix;)*> +<!--end of filename.element-->]]> + +<!-- Class: Type of filename the element names; no default --> +<!-- Path: Search path (possibly system-specific) in which + file can be found --> + + +<!ENTITY % filename.attlist "INCLUDE"> +<![%filename.attlist;[ +<!ATTLIST filename + class (headerfile + |partition + |devicefile + |libraryfile + |directory + |extension + |symlink) #IMPLIED + path CDATA #IMPLIED + %moreinfo.attrib; + %common.attrib; + %filename.role.attrib; + %local.filename.attrib; +> +<!--end of filename.attlist-->]]> +<!--end of filename.module-->]]> + +<!ENTITY % function.module "INCLUDE"> +<![%function.module;[ +<!ENTITY % local.function.attrib ""> +<!ENTITY % function.role.attrib "%role.attrib;"> + +<!ENTITY % function.element "INCLUDE"> +<![%function.element;[ +<!--doc:The name of a function or subroutine, as in a programming language.--> +<!ELEMENT function %ho; (%cptr.char.mix;)*> +<!--end of function.element-->]]> + +<!ENTITY % function.attlist "INCLUDE"> +<![%function.attlist;[ +<!ATTLIST function + %moreinfo.attrib; + %common.attrib; + %function.role.attrib; + %local.function.attrib; +> +<!--end of function.attlist-->]]> +<!--end of function.module-->]]> + +<!ENTITY % guibutton.module "INCLUDE"> +<![%guibutton.module;[ +<!ENTITY % local.guibutton.attrib ""> +<!ENTITY % guibutton.role.attrib "%role.attrib;"> + +<!ENTITY % guibutton.element "INCLUDE"> +<![%guibutton.element;[ +<!--doc:The text on a button in a GUI.--> +<!ELEMENT guibutton %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guibutton.element-->]]> + +<!ENTITY % guibutton.attlist "INCLUDE"> +<![%guibutton.attlist;[ +<!ATTLIST guibutton + %moreinfo.attrib; + %common.attrib; + %guibutton.role.attrib; + %local.guibutton.attrib; +> +<!--end of guibutton.attlist-->]]> +<!--end of guibutton.module-->]]> + +<!ENTITY % guiicon.module "INCLUDE"> +<![%guiicon.module;[ +<!ENTITY % local.guiicon.attrib ""> +<!ENTITY % guiicon.role.attrib "%role.attrib;"> + +<!ENTITY % guiicon.element "INCLUDE"> +<![%guiicon.element;[ +<!--doc:Graphic and/or text appearing as a icon in a GUI.--> +<!ELEMENT guiicon %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guiicon.element-->]]> + +<!ENTITY % guiicon.attlist "INCLUDE"> +<![%guiicon.attlist;[ +<!ATTLIST guiicon + %moreinfo.attrib; + %common.attrib; + %guiicon.role.attrib; + %local.guiicon.attrib; +> +<!--end of guiicon.attlist-->]]> +<!--end of guiicon.module-->]]> + +<!ENTITY % guilabel.module "INCLUDE"> +<![%guilabel.module;[ +<!ENTITY % local.guilabel.attrib ""> +<!ENTITY % guilabel.role.attrib "%role.attrib;"> + +<!ENTITY % guilabel.element "INCLUDE"> +<![%guilabel.element;[ +<!--doc:The text of a label in a GUI.--> +<!ELEMENT guilabel %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guilabel.element-->]]> + +<!ENTITY % guilabel.attlist "INCLUDE"> +<![%guilabel.attlist;[ +<!ATTLIST guilabel + %moreinfo.attrib; + %common.attrib; + %guilabel.role.attrib; + %local.guilabel.attrib; +> +<!--end of guilabel.attlist-->]]> +<!--end of guilabel.module-->]]> + +<!ENTITY % guimenu.module "INCLUDE"> +<![%guimenu.module;[ +<!ENTITY % local.guimenu.attrib ""> +<!ENTITY % guimenu.role.attrib "%role.attrib;"> + +<!ENTITY % guimenu.element "INCLUDE"> +<![%guimenu.element;[ +<!--doc:The name of a menu in a GUI.--> +<!ELEMENT guimenu %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guimenu.element-->]]> + +<!ENTITY % guimenu.attlist "INCLUDE"> +<![%guimenu.attlist;[ +<!ATTLIST guimenu + %moreinfo.attrib; + %common.attrib; + %guimenu.role.attrib; + %local.guimenu.attrib; +> +<!--end of guimenu.attlist-->]]> +<!--end of guimenu.module-->]]> + +<!ENTITY % guimenuitem.module "INCLUDE"> +<![%guimenuitem.module;[ +<!ENTITY % local.guimenuitem.attrib ""> +<!ENTITY % guimenuitem.role.attrib "%role.attrib;"> + +<!ENTITY % guimenuitem.element "INCLUDE"> +<![%guimenuitem.element;[ +<!--doc:The name of a terminal menu item in a GUI.--> +<!ELEMENT guimenuitem %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guimenuitem.element-->]]> + +<!ENTITY % guimenuitem.attlist "INCLUDE"> +<![%guimenuitem.attlist;[ +<!ATTLIST guimenuitem + %moreinfo.attrib; + %common.attrib; + %guimenuitem.role.attrib; + %local.guimenuitem.attrib; +> +<!--end of guimenuitem.attlist-->]]> +<!--end of guimenuitem.module-->]]> + +<!ENTITY % guisubmenu.module "INCLUDE"> +<![%guisubmenu.module;[ +<!ENTITY % local.guisubmenu.attrib ""> +<!ENTITY % guisubmenu.role.attrib "%role.attrib;"> + +<!ENTITY % guisubmenu.element "INCLUDE"> +<![%guisubmenu.element;[ +<!--doc:The name of a submenu in a GUI.--> +<!ELEMENT guisubmenu %ho; (%smallcptr.char.mix;|accel|superscript|subscript)*> +<!--end of guisubmenu.element-->]]> + +<!ENTITY % guisubmenu.attlist "INCLUDE"> +<![%guisubmenu.attlist;[ +<!ATTLIST guisubmenu + %moreinfo.attrib; + %common.attrib; + %guisubmenu.role.attrib; + %local.guisubmenu.attrib; +> +<!--end of guisubmenu.attlist-->]]> +<!--end of guisubmenu.module-->]]> + +<!ENTITY % hardware.module "INCLUDE"> +<![%hardware.module;[ +<!ENTITY % local.hardware.attrib ""> +<!ENTITY % hardware.role.attrib "%role.attrib;"> + +<!ENTITY % hardware.element "INCLUDE"> +<![%hardware.element;[ +<!--doc:A physical part of a computer system.--> +<!ELEMENT hardware %ho; (%cptr.char.mix;)*> +<!--end of hardware.element-->]]> + +<!ENTITY % hardware.attlist "INCLUDE"> +<![%hardware.attlist;[ +<!ATTLIST hardware + %moreinfo.attrib; + %common.attrib; + %hardware.role.attrib; + %local.hardware.attrib; +> +<!--end of hardware.attlist-->]]> +<!--end of hardware.module-->]]> + +<!ENTITY % interface.module "INCLUDE"> +<![%interface.module;[ +<!ENTITY % local.interface.attrib ""> +<!ENTITY % interface.role.attrib "%role.attrib;"> + +<!ENTITY % interface.element "INCLUDE"> +<![%interface.element;[ +<!--doc:An element of a GUI.--> +<!ELEMENT interface %ho; (%smallcptr.char.mix;|accel)*> +<!--end of interface.element-->]]> + +<!-- Class: Type of the Interface item; no default --> + + +<!ENTITY % interface.attlist "INCLUDE"> +<![%interface.attlist;[ +<!ATTLIST interface + %moreinfo.attrib; + %common.attrib; + %interface.role.attrib; + %local.interface.attrib; +> +<!--end of interface.attlist-->]]> +<!--end of interface.module-->]]> + +<!ENTITY % keycap.module "INCLUDE"> +<![%keycap.module;[ +<!ENTITY % local.keycap.attrib ""> +<!ENTITY % keycap.role.attrib "%role.attrib;"> + +<!ENTITY % keycap.element "INCLUDE"> +<![%keycap.element;[ +<!--doc:The text printed on a key on a keyboard.--> +<!ELEMENT keycap %ho; (%cptr.char.mix;)*> +<!--end of keycap.element-->]]> + +<!ENTITY % keycap.attlist "INCLUDE"> +<![%keycap.attlist;[ +<!ATTLIST keycap + function (alt + |control + |shift + |meta + |escape + |enter + |tab + |backspace + |command + |option + |space + |delete + |insert + |up + |down + |left + |right + |home + |end + |pageup + |pagedown + |other) #IMPLIED + otherfunction CDATA #IMPLIED + %moreinfo.attrib; + %common.attrib; + %keycap.role.attrib; + %local.keycap.attrib; +> +<!--end of keycap.attlist-->]]> +<!--end of keycap.module-->]]> + +<!ENTITY % keycode.module "INCLUDE"> +<![%keycode.module;[ +<!ENTITY % local.keycode.attrib ""> +<!ENTITY % keycode.role.attrib "%role.attrib;"> + +<!ENTITY % keycode.element "INCLUDE"> +<![%keycode.element;[ +<!--doc:The internal, frequently numeric, identifier for a key on a keyboard.--> +<!ELEMENT keycode %ho; (%smallcptr.char.mix;)*> +<!--end of keycode.element-->]]> + +<!ENTITY % keycode.attlist "INCLUDE"> +<![%keycode.attlist;[ +<!ATTLIST keycode + %common.attrib; + %keycode.role.attrib; + %local.keycode.attrib; +> +<!--end of keycode.attlist-->]]> +<!--end of keycode.module-->]]> + +<!ENTITY % keycombo.module "INCLUDE"> +<![%keycombo.module;[ +<!ENTITY % local.keycombo.attrib ""> +<!ENTITY % keycombo.role.attrib "%role.attrib;"> + +<!ENTITY % keycombo.element "INCLUDE"> +<![%keycombo.element;[ +<!--doc:A combination of input actions.--> +<!ELEMENT keycombo %ho; ((keycap|keycombo|keysym|mousebutton)+)> +<!--end of keycombo.element-->]]> + +<!ENTITY % keycombo.attlist "INCLUDE"> +<![%keycombo.attlist;[ +<!ATTLIST keycombo + %keyaction.attrib; + %moreinfo.attrib; + %common.attrib; + %keycombo.role.attrib; + %local.keycombo.attrib; +> +<!--end of keycombo.attlist-->]]> +<!--end of keycombo.module-->]]> + +<!ENTITY % keysym.module "INCLUDE"> +<![%keysym.module;[ +<!ENTITY % local.keysym.attrib ""> +<!ENTITY % keysysm.role.attrib "%role.attrib;"> + +<!ENTITY % keysym.element "INCLUDE"> +<![%keysym.element;[ +<!--doc:The symbolic name of a key on a keyboard.--> +<!ELEMENT keysym %ho; (%smallcptr.char.mix;)*> +<!--end of keysym.element-->]]> + +<!ENTITY % keysym.attlist "INCLUDE"> +<![%keysym.attlist;[ +<!ATTLIST keysym + %common.attrib; + %keysysm.role.attrib; + %local.keysym.attrib; +> +<!--end of keysym.attlist-->]]> +<!--end of keysym.module-->]]> + +<!ENTITY % lineannotation.module "INCLUDE"> +<![%lineannotation.module;[ +<!ENTITY % local.lineannotation.attrib ""> +<!ENTITY % lineannotation.role.attrib "%role.attrib;"> + +<!ENTITY % lineannotation.element "INCLUDE"> +<![%lineannotation.element;[ +<!--doc:A comment on a line in a verbatim listing.--> +<!ELEMENT lineannotation %ho; (%para.char.mix;)*> +<!--end of lineannotation.element-->]]> + +<!ENTITY % lineannotation.attlist "INCLUDE"> +<![%lineannotation.attlist;[ +<!ATTLIST lineannotation + %common.attrib; + %lineannotation.role.attrib; + %local.lineannotation.attrib; +> +<!--end of lineannotation.attlist-->]]> +<!--end of lineannotation.module-->]]> + +<!ENTITY % literal.module "INCLUDE"> +<![%literal.module;[ +<!ENTITY % local.literal.attrib ""> +<!ENTITY % literal.role.attrib "%role.attrib;"> + +<!ENTITY % literal.element "INCLUDE"> +<![%literal.element;[ +<!--doc:Inline text that is some literal value.--> +<!ELEMENT literal %ho; (%cptr.char.mix;)*> +<!--end of literal.element-->]]> + +<!ENTITY % literal.attlist "INCLUDE"> +<![%literal.attlist;[ +<!ATTLIST literal + %moreinfo.attrib; + %common.attrib; + %literal.role.attrib; + %local.literal.attrib; +> +<!--end of literal.attlist-->]]> +<!--end of literal.module-->]]> + +<!ENTITY % code.module "INCLUDE"> +<![%code.module;[ +<!ENTITY % local.code.attrib ""> +<!ENTITY % code.role.attrib "%role.attrib;"> + +<!ENTITY % code.element "INCLUDE"> +<![%code.element;[ +<!--doc:An inline code fragment.--> +<!ELEMENT code %ho; (%cptr.char.mix;)*> +<!--end of code.element-->]]> + +<!ENTITY % code.attlist "INCLUDE"> +<![%code.attlist;[ +<!ATTLIST code + language CDATA #IMPLIED + %common.attrib; + %code.role.attrib; + %local.code.attrib; +> +<!--end of code.attlist-->]]> +<!--end of code.module-->]]> + +<!ENTITY % constant.module "INCLUDE"> +<![ %constant.module; [ +<!ENTITY % local.constant.attrib ""> +<!ENTITY % constant.role.attrib "%role.attrib;"> + +<!ENTITY % constant.element "INCLUDE"> +<![ %constant.element; [ +<!--doc:A programming or system constant.--> +<!ELEMENT constant %ho; (%smallcptr.char.mix;)*> +<!--end of constant.element-->]]> + +<!ENTITY % constant.attlist "INCLUDE"> +<![ %constant.attlist; [ +<!ATTLIST constant + class (limit) #IMPLIED + %common.attrib; + %constant.role.attrib; + %local.constant.attrib; +> +<!--end of constant.attlist-->]]> +<!--end of constant.module-->]]> + +<!ENTITY % varname.module "INCLUDE"> +<![ %varname.module; [ +<!ENTITY % local.varname.attrib ""> +<!ENTITY % varname.role.attrib "%role.attrib;"> + +<!ENTITY % varname.element "INCLUDE"> +<![ %varname.element; [ +<!--doc:The name of a variable.--> +<!ELEMENT varname %ho; (%smallcptr.char.mix;)*> +<!--end of varname.element-->]]> + +<!ENTITY % varname.attlist "INCLUDE"> +<![ %varname.attlist; [ +<!ATTLIST varname + %common.attrib; + %varname.role.attrib; + %local.varname.attrib; +> +<!--end of varname.attlist-->]]> +<!--end of varname.module-->]]> + +<!ENTITY % markup.module "INCLUDE"> +<![%markup.module;[ +<!ENTITY % local.markup.attrib ""> +<!ENTITY % markup.role.attrib "%role.attrib;"> + +<!ENTITY % markup.element "INCLUDE"> +<![%markup.element;[ +<!--doc:A string of formatting markup in text that is to be represented literally.--> +<!ELEMENT markup %ho; (%smallcptr.char.mix;)*> +<!--end of markup.element-->]]> + +<!ENTITY % markup.attlist "INCLUDE"> +<![%markup.attlist;[ +<!ATTLIST markup + %common.attrib; + %markup.role.attrib; + %local.markup.attrib; +> +<!--end of markup.attlist-->]]> +<!--end of markup.module-->]]> + +<!ENTITY % medialabel.module "INCLUDE"> +<![%medialabel.module;[ +<!ENTITY % local.medialabel.attrib ""> +<!ENTITY % medialabel.role.attrib "%role.attrib;"> + +<!ENTITY % medialabel.element "INCLUDE"> +<![%medialabel.element;[ +<!--doc:A name that identifies the physical medium on which some information resides.--> +<!ELEMENT medialabel %ho; (%smallcptr.char.mix;)*> +<!--end of medialabel.element-->]]> + +<!-- Class: Type of medium named by the element; no default --> + + +<!ENTITY % medialabel.attlist "INCLUDE"> +<![%medialabel.attlist;[ +<!ATTLIST medialabel + class (cartridge + |cdrom + |disk + |tape) #IMPLIED + %common.attrib; + %medialabel.role.attrib; + %local.medialabel.attrib; +> +<!--end of medialabel.attlist-->]]> +<!--end of medialabel.module-->]]> + +<!ENTITY % menuchoice.content.module "INCLUDE"> +<![%menuchoice.content.module;[ +<!ENTITY % menuchoice.module "INCLUDE"> +<![%menuchoice.module;[ +<!ENTITY % local.menuchoice.attrib ""> +<!ENTITY % menuchoice.role.attrib "%role.attrib;"> + +<!ENTITY % menuchoice.element "INCLUDE"> +<![%menuchoice.element;[ +<!--doc:A selection or series of selections from a menu.--> +<!ELEMENT menuchoice %ho; (shortcut?, (guibutton|guiicon|guilabel + |guimenu|guimenuitem|guisubmenu|interface)+)> +<!--end of menuchoice.element-->]]> + +<!ENTITY % menuchoice.attlist "INCLUDE"> +<![%menuchoice.attlist;[ +<!ATTLIST menuchoice + %moreinfo.attrib; + %common.attrib; + %menuchoice.role.attrib; + %local.menuchoice.attrib; +> +<!--end of menuchoice.attlist-->]]> +<!--end of menuchoice.module-->]]> + +<!ENTITY % shortcut.module "INCLUDE"> +<![%shortcut.module;[ +<!-- See also KeyCombo --> +<!ENTITY % local.shortcut.attrib ""> +<!ENTITY % shortcut.role.attrib "%role.attrib;"> + +<!ENTITY % shortcut.element "INCLUDE"> +<![%shortcut.element;[ +<!--doc:A key combination for an action that is also accessible through a menu.--> +<!ELEMENT shortcut %ho; ((keycap|keycombo|keysym|mousebutton)+)> +<!--end of shortcut.element-->]]> + +<!ENTITY % shortcut.attlist "INCLUDE"> +<![%shortcut.attlist;[ +<!ATTLIST shortcut + %keyaction.attrib; + %moreinfo.attrib; + %common.attrib; + %shortcut.role.attrib; + %local.shortcut.attrib; +> +<!--end of shortcut.attlist-->]]> +<!--end of shortcut.module-->]]> +<!--end of menuchoice.content.module-->]]> + +<!ENTITY % mousebutton.module "INCLUDE"> +<![%mousebutton.module;[ +<!ENTITY % local.mousebutton.attrib ""> +<!ENTITY % mousebutton.role.attrib "%role.attrib;"> + +<!ENTITY % mousebutton.element "INCLUDE"> +<![%mousebutton.element;[ +<!--doc:The conventional name of a mouse button.--> +<!ELEMENT mousebutton %ho; (%smallcptr.char.mix;)*> +<!--end of mousebutton.element-->]]> + +<!ENTITY % mousebutton.attlist "INCLUDE"> +<![%mousebutton.attlist;[ +<!ATTLIST mousebutton + %moreinfo.attrib; + %common.attrib; + %mousebutton.role.attrib; + %local.mousebutton.attrib; +> +<!--end of mousebutton.attlist-->]]> +<!--end of mousebutton.module-->]]> + +<!ENTITY % msgtext.module "INCLUDE"> +<![%msgtext.module;[ +<!ENTITY % local.msgtext.attrib ""> +<!ENTITY % msgtext.role.attrib "%role.attrib;"> + +<!ENTITY % msgtext.element "INCLUDE"> +<![%msgtext.element;[ +<!--doc:The actual text of a message component in a message set.--> +<!ELEMENT msgtext %ho; ((%component.mix;)+)> +<!--end of msgtext.element-->]]> + +<!ENTITY % msgtext.attlist "INCLUDE"> +<![%msgtext.attlist;[ +<!ATTLIST msgtext + %common.attrib; + %msgtext.role.attrib; + %local.msgtext.attrib; +> +<!--end of msgtext.attlist-->]]> +<!--end of msgtext.module-->]]> + +<!ENTITY % option.module "INCLUDE"> +<![%option.module;[ +<!ENTITY % local.option.attrib ""> +<!ENTITY % option.role.attrib "%role.attrib;"> + +<!ENTITY % option.element "INCLUDE"> +<![%option.element;[ +<!--doc:An option for a software command.--> +<!ELEMENT option %ho; (%cptr.char.mix;)*> +<!--end of option.element-->]]> + +<!ENTITY % option.attlist "INCLUDE"> +<![%option.attlist;[ +<!ATTLIST option + %common.attrib; + %option.role.attrib; + %local.option.attrib; +> +<!--end of option.attlist-->]]> +<!--end of option.module-->]]> + +<!ENTITY % optional.module "INCLUDE"> +<![%optional.module;[ +<!ENTITY % local.optional.attrib ""> +<!ENTITY % optional.role.attrib "%role.attrib;"> + +<!ENTITY % optional.element "INCLUDE"> +<![%optional.element;[ +<!--doc:Optional information.--> +<!ELEMENT optional %ho; (%cptr.char.mix;)*> +<!--end of optional.element-->]]> + +<!ENTITY % optional.attlist "INCLUDE"> +<![%optional.attlist;[ +<!ATTLIST optional + %common.attrib; + %optional.role.attrib; + %local.optional.attrib; +> +<!--end of optional.attlist-->]]> +<!--end of optional.module-->]]> + +<!ENTITY % parameter.module "INCLUDE"> +<![%parameter.module;[ +<!ENTITY % local.parameter.attrib ""> +<!ENTITY % parameter.role.attrib "%role.attrib;"> + +<!ENTITY % parameter.element "INCLUDE"> +<![%parameter.element;[ +<!--doc:A value or a symbolic reference to a value.--> +<!ELEMENT parameter %ho; (%cptr.char.mix;)*> +<!--end of parameter.element-->]]> + +<!-- Class: Type of the Parameter; no default --> + + +<!ENTITY % parameter.attlist "INCLUDE"> +<![%parameter.attlist;[ +<!ATTLIST parameter + class (command + |function + |option) #IMPLIED + %moreinfo.attrib; + %common.attrib; + %parameter.role.attrib; + %local.parameter.attrib; +> +<!--end of parameter.attlist-->]]> +<!--end of parameter.module-->]]> + +<!ENTITY % prompt.module "INCLUDE"> +<![%prompt.module;[ +<!ENTITY % local.prompt.attrib ""> +<!ENTITY % prompt.role.attrib "%role.attrib;"> + +<!ENTITY % prompt.element "INCLUDE"> +<![%prompt.element;[ +<!--doc:A character or string indicating the start of an input field in a computer display.--> +<!ELEMENT prompt %ho; (%smallcptr.char.mix;|co)*> +<!--end of prompt.element-->]]> + +<!ENTITY % prompt.attlist "INCLUDE"> +<![%prompt.attlist;[ +<!ATTLIST prompt + %moreinfo.attrib; + %common.attrib; + %prompt.role.attrib; + %local.prompt.attrib; +> +<!--end of prompt.attlist-->]]> +<!--end of prompt.module-->]]> + +<!ENTITY % property.module "INCLUDE"> +<![%property.module;[ +<!ENTITY % local.property.attrib ""> +<!ENTITY % property.role.attrib "%role.attrib;"> + +<!ENTITY % property.element "INCLUDE"> +<![%property.element;[ +<!--doc:A unit of data associated with some part of a computer system.--> +<!ELEMENT property %ho; (%cptr.char.mix;)*> +<!--end of property.element-->]]> + +<!ENTITY % property.attlist "INCLUDE"> +<![%property.attlist;[ +<!ATTLIST property + %moreinfo.attrib; + %common.attrib; + %property.role.attrib; + %local.property.attrib; +> +<!--end of property.attlist-->]]> +<!--end of property.module-->]]> + +<!ENTITY % replaceable.module "INCLUDE"> +<![%replaceable.module;[ +<!ENTITY % local.replaceable.attrib ""> +<!ENTITY % replaceable.role.attrib "%role.attrib;"> + +<!ENTITY % replaceable.element "INCLUDE"> +<![%replaceable.element;[ +<!--doc:Content that may or must be replaced by the user.--> +<!ELEMENT replaceable %ho; (#PCDATA + | %link.char.class; + | optional + | %base.char.class; + | %other.char.class; + | inlinegraphic + | inlinemediaobject + | co)*> +<!--end of replaceable.element-->]]> + +<!-- Class: Type of information the element represents; no + default --> + + +<!ENTITY % replaceable.attlist "INCLUDE"> +<![%replaceable.attlist;[ +<!ATTLIST replaceable + class (command + |function + |option + |parameter) #IMPLIED + %common.attrib; + %replaceable.role.attrib; + %local.replaceable.attrib; +> +<!--end of replaceable.attlist-->]]> +<!--end of replaceable.module-->]]> + +<!ENTITY % returnvalue.module "INCLUDE"> +<![%returnvalue.module;[ +<!ENTITY % local.returnvalue.attrib ""> +<!ENTITY % returnvalue.role.attrib "%role.attrib;"> + +<!ENTITY % returnvalue.element "INCLUDE"> +<![%returnvalue.element;[ +<!--doc:The value returned by a function.--> +<!ELEMENT returnvalue %ho; (%smallcptr.char.mix;)*> +<!--end of returnvalue.element-->]]> + +<!ENTITY % returnvalue.attlist "INCLUDE"> +<![%returnvalue.attlist;[ +<!ATTLIST returnvalue + %common.attrib; + %returnvalue.role.attrib; + %local.returnvalue.attrib; +> +<!--end of returnvalue.attlist-->]]> +<!--end of returnvalue.module-->]]> + +<!ENTITY % sgmltag.module "INCLUDE"> +<![%sgmltag.module;[ +<!ENTITY % local.sgmltag.attrib ""> +<!ENTITY % sgmltag.role.attrib "%role.attrib;"> + +<!ENTITY % sgmltag.element "INCLUDE"> +<![%sgmltag.element;[ +<!--doc:A component of SGML markup.--> +<!ELEMENT sgmltag %ho; (%smallcptr.char.mix;)*> +<!--end of sgmltag.element-->]]> + +<!-- Class: Type of SGML construct the element names; no default --> + + +<!ENTITY % sgmltag.attlist "INCLUDE"> +<![%sgmltag.attlist;[ +<!ATTLIST sgmltag + class (attribute + |attvalue + |element + |endtag + |emptytag + |genentity + |numcharref + |paramentity + |pi + |xmlpi + |starttag + |sgmlcomment + |prefix + |namespace + |localname) #IMPLIED + namespace CDATA #IMPLIED + %common.attrib; + %sgmltag.role.attrib; + %local.sgmltag.attrib; +> +<!--end of sgmltag.attlist-->]]> +<!--end of sgmltag.module-->]]> + +<!ENTITY % structfield.module "INCLUDE"> +<![%structfield.module;[ +<!ENTITY % local.structfield.attrib ""> +<!ENTITY % structfield.role.attrib "%role.attrib;"> + +<!ENTITY % structfield.element "INCLUDE"> +<![%structfield.element;[ +<!--doc:A field in a structure (in the programming language sense).--> +<!ELEMENT structfield %ho; (%smallcptr.char.mix;)*> +<!--end of structfield.element-->]]> + +<!ENTITY % structfield.attlist "INCLUDE"> +<![%structfield.attlist;[ +<!ATTLIST structfield + %common.attrib; + %structfield.role.attrib; + %local.structfield.attrib; +> +<!--end of structfield.attlist-->]]> +<!--end of structfield.module-->]]> + +<!ENTITY % structname.module "INCLUDE"> +<![%structname.module;[ +<!ENTITY % local.structname.attrib ""> +<!ENTITY % structname.role.attrib "%role.attrib;"> + +<!ENTITY % structname.element "INCLUDE"> +<![%structname.element;[ +<!--doc:The name of a structure (in the programming language sense).--> +<!ELEMENT structname %ho; (%smallcptr.char.mix;)*> +<!--end of structname.element-->]]> + +<!ENTITY % structname.attlist "INCLUDE"> +<![%structname.attlist;[ +<!ATTLIST structname + %common.attrib; + %structname.role.attrib; + %local.structname.attrib; +> +<!--end of structname.attlist-->]]> +<!--end of structname.module-->]]> + +<!ENTITY % symbol.module "INCLUDE"> +<![%symbol.module;[ +<!ENTITY % local.symbol.attrib ""> +<!ENTITY % symbol.role.attrib "%role.attrib;"> + +<!ENTITY % symbol.element "INCLUDE"> +<![%symbol.element;[ +<!--doc:A name that is replaced by a value before processing.--> +<!ELEMENT symbol %ho; (%smallcptr.char.mix;)*> +<!--end of symbol.element-->]]> + +<!-- Class: Type of symbol; no default --> + + +<!ENTITY % symbol.attlist "INCLUDE"> +<![%symbol.attlist;[ +<!ATTLIST symbol + class (limit) #IMPLIED + %common.attrib; + %symbol.role.attrib; + %local.symbol.attrib; +> +<!--end of symbol.attlist-->]]> +<!--end of symbol.module-->]]> + +<!ENTITY % systemitem.module "INCLUDE"> +<![%systemitem.module;[ +<!ENTITY % local.systemitem.attrib ""> +<!ENTITY % systemitem.role.attrib "%role.attrib;"> + +<!ENTITY % systemitem.element "INCLUDE"> +<![%systemitem.element;[ +<!--doc:A system-related item or term.--> +<!ELEMENT systemitem %ho; (%cptr.char.mix; | acronym | co)*> +<!--end of systemitem.element-->]]> + +<!-- Class: Type of system item the element names; no default --> + +<!ENTITY % systemitem.attlist "INCLUDE"> +<![%systemitem.attlist;[ +<!ATTLIST systemitem + class (constant + |daemon + |domainname + |etheraddress + |event + |eventhandler + |filesystem + |fqdomainname + |groupname + |ipaddress + |library + |macro + |netmask + |newsgroup + |osname + |protocol + |resource + |systemname + |username + |process + |server + |service) #IMPLIED + %moreinfo.attrib; + %common.attrib; + %systemitem.role.attrib; + %local.systemitem.attrib; +> +<!--end of systemitem.attlist-->]]> +<!--end of systemitem.module-->]]> + +<!ENTITY % uri.module "INCLUDE"> +<![%uri.module;[ +<!ENTITY % local.uri.attrib ""> +<!ENTITY % uri.role.attrib "%role.attrib;"> + +<!ENTITY % uri.element "INCLUDE"> +<![%uri.element;[ +<!--doc:A Uniform Resource Identifier.--> +<!ELEMENT uri %ho; (%smallcptr.char.mix;)*> +<!--end of uri.element-->]]> + +<!-- Type: Type of URI; no default --> + +<!ENTITY % uri.attlist "INCLUDE"> +<![%uri.attlist;[ +<!ATTLIST uri + type CDATA #IMPLIED + %common.attrib; + %uri.role.attrib; + %local.uri.attrib; +> +<!--end of uri.attlist-->]]> +<!--end of uri.module-->]]> + +<!ENTITY % token.module "INCLUDE"> +<![%token.module;[ +<!ENTITY % local.token.attrib ""> +<!ENTITY % token.role.attrib "%role.attrib;"> + +<!ENTITY % token.element "INCLUDE"> +<![%token.element;[ +<!--doc:A unit of information.--> +<!ELEMENT token %ho; (%smallcptr.char.mix;)*> +<!--end of token.element-->]]> + +<!ENTITY % token.attlist "INCLUDE"> +<![%token.attlist;[ +<!ATTLIST token + %common.attrib; + %token.role.attrib; + %local.token.attrib; +> +<!--end of token.attlist-->]]> +<!--end of token.module-->]]> + +<!ENTITY % type.module "INCLUDE"> +<![%type.module;[ +<!ENTITY % local.type.attrib ""> +<!ENTITY % type.role.attrib "%role.attrib;"> + +<!ENTITY % type.element "INCLUDE"> +<![%type.element;[ +<!--doc:The classification of a value.--> +<!ELEMENT type %ho; (%smallcptr.char.mix;)*> +<!--end of type.element-->]]> + +<!ENTITY % type.attlist "INCLUDE"> +<![%type.attlist;[ +<!ATTLIST type + %common.attrib; + %type.role.attrib; + %local.type.attrib; +> +<!--end of type.attlist-->]]> +<!--end of type.module-->]]> + +<!ENTITY % userinput.module "INCLUDE"> +<![%userinput.module;[ +<!ENTITY % local.userinput.attrib ""> +<!ENTITY % userinput.role.attrib "%role.attrib;"> + +<!ENTITY % userinput.element "INCLUDE"> +<![%userinput.element;[ +<!--doc:Data entered by the user.--> +<!ELEMENT userinput %ho; (%cptr.char.mix;|co)*> +<!--end of userinput.element-->]]> + +<!ENTITY % userinput.attlist "INCLUDE"> +<![%userinput.attlist;[ +<!ATTLIST userinput + %moreinfo.attrib; + %common.attrib; + %userinput.role.attrib; + %local.userinput.attrib; +> +<!--end of userinput.attlist-->]]> +<!--end of userinput.module-->]]> + +<!ENTITY % termdef.module "INCLUDE"> +<![%termdef.module;[ +<!ENTITY % local.termdef.attrib ""> +<!ENTITY % termdef.role.attrib "%role.attrib;"> + +<!ENTITY % termdef.element "INCLUDE"> +<![%termdef.element;[ +<!--doc:An inline definition of a term.--> +<!ELEMENT termdef %ho; (%para.char.mix;)*> +<!--end of termdef.element-->]]> + +<!ENTITY % termdef.attlist "INCLUDE"> +<![%termdef.attlist;[ +<!ATTLIST termdef + %common.attrib; + %termdef.role.attrib; + %local.termdef.attrib; +> +<!--end of termdef.attlist-->]]> +<!--end of termdef.module-->]]> + +<!-- General words and phrases ............................................ --> + +<!ENTITY % abbrev.module "INCLUDE"> +<![%abbrev.module;[ +<!ENTITY % local.abbrev.attrib ""> +<!ENTITY % abbrev.role.attrib "%role.attrib;"> + +<!ENTITY % abbrev.element "INCLUDE"> +<![%abbrev.element;[ +<!--doc:An abbreviation, especially one followed by a period.--> +<!ELEMENT abbrev %ho; (%word.char.mix;)*> +<!--end of abbrev.element-->]]> + +<!ENTITY % abbrev.attlist "INCLUDE"> +<![%abbrev.attlist;[ +<!ATTLIST abbrev + %common.attrib; + %abbrev.role.attrib; + %local.abbrev.attrib; +> +<!--end of abbrev.attlist-->]]> +<!--end of abbrev.module-->]]> + +<!ENTITY % acronym.module "INCLUDE"> +<![%acronym.module;[ +<!ENTITY % local.acronym.attrib ""> +<!ENTITY % acronym.role.attrib "%role.attrib;"> + +<!ENTITY % acronym.element "INCLUDE"> +<![%acronym.element;[ +<!--doc:An often pronounceable word made from the initial (or selected) letters of a name or phrase.--> +<!ELEMENT acronym %ho; (%word.char.mix;)* + %acronym.exclusion;> +<!--end of acronym.element-->]]> + +<!ENTITY % acronym.attlist "INCLUDE"> +<![%acronym.attlist;[ +<!ATTLIST acronym + %common.attrib; + %acronym.role.attrib; + %local.acronym.attrib; +> +<!--end of acronym.attlist-->]]> +<!--end of acronym.module-->]]> + +<!ENTITY % citation.module "INCLUDE"> +<![%citation.module;[ +<!ENTITY % local.citation.attrib ""> +<!ENTITY % citation.role.attrib "%role.attrib;"> + +<!ENTITY % citation.element "INCLUDE"> +<![%citation.element;[ +<!--doc:An inline bibliographic reference to another published work.--> +<!ELEMENT citation %ho; (%para.char.mix;)*> +<!--end of citation.element-->]]> + +<!ENTITY % citation.attlist "INCLUDE"> +<![%citation.attlist;[ +<!ATTLIST citation + %common.attrib; + %citation.role.attrib; + %local.citation.attrib; +> +<!--end of citation.attlist-->]]> +<!--end of citation.module-->]]> + +<!ENTITY % citerefentry.module "INCLUDE"> +<![%citerefentry.module;[ +<!ENTITY % local.citerefentry.attrib ""> +<!ENTITY % citerefentry.role.attrib "%role.attrib;"> + +<!ENTITY % citerefentry.element "INCLUDE"> +<![%citerefentry.element;[ +<!--doc:A citation to a reference page.--> +<!ELEMENT citerefentry %ho; (refentrytitle, manvolnum?)> +<!--end of citerefentry.element-->]]> + +<!ENTITY % citerefentry.attlist "INCLUDE"> +<![%citerefentry.attlist;[ +<!ATTLIST citerefentry + %common.attrib; + %citerefentry.role.attrib; + %local.citerefentry.attrib; +> +<!--end of citerefentry.attlist-->]]> +<!--end of citerefentry.module-->]]> + +<!ENTITY % refentrytitle.module "INCLUDE"> +<![%refentrytitle.module;[ +<!ENTITY % local.refentrytitle.attrib ""> +<!ENTITY % refentrytitle.role.attrib "%role.attrib;"> + +<!ENTITY % refentrytitle.element "INCLUDE"> +<![%refentrytitle.element;[ +<!--doc:The title of a reference page.--> +<!ELEMENT refentrytitle %ho; (%para.char.mix;)*> +<!--end of refentrytitle.element-->]]> + +<!ENTITY % refentrytitle.attlist "INCLUDE"> +<![%refentrytitle.attlist;[ +<!ATTLIST refentrytitle + %common.attrib; + %refentrytitle.role.attrib; + %local.refentrytitle.attrib; +> +<!--end of refentrytitle.attlist-->]]> +<!--end of refentrytitle.module-->]]> + +<!ENTITY % manvolnum.module "INCLUDE"> +<![%manvolnum.module;[ +<!ENTITY % local.manvolnum.attrib ""> +<!ENTITY % namvolnum.role.attrib "%role.attrib;"> + +<!ENTITY % manvolnum.element "INCLUDE"> +<![%manvolnum.element;[ +<!--doc:A reference volume number.--> +<!ELEMENT manvolnum %ho; (%word.char.mix;)*> +<!--end of manvolnum.element-->]]> + +<!ENTITY % manvolnum.attlist "INCLUDE"> +<![%manvolnum.attlist;[ +<!ATTLIST manvolnum + %common.attrib; + %namvolnum.role.attrib; + %local.manvolnum.attrib; +> +<!--end of manvolnum.attlist-->]]> +<!--end of manvolnum.module-->]]> + +<!ENTITY % citetitle.module "INCLUDE"> +<![%citetitle.module;[ +<!ENTITY % local.citetitle.attrib ""> +<!ENTITY % citetitle.role.attrib "%role.attrib;"> + +<!ENTITY % citetitle.element "INCLUDE"> +<![%citetitle.element;[ +<!--doc:The title of a cited work.--> +<!ELEMENT citetitle %ho; (%para.char.mix;)*> +<!--end of citetitle.element-->]]> + +<!-- Pubwork: Genre of published work cited; no default --> + + +<!ENTITY % citetitle.attlist "INCLUDE"> +<![%citetitle.attlist;[ +<!ATTLIST citetitle + pubwork (article + |book + |chapter + |part + |refentry + |section + |journal + |series + |set + |manuscript + |cdrom + |dvd + |wiki + |gopher + |bbs + |emailmessage + |webpage + |newsposting) #IMPLIED + %common.attrib; + %citetitle.role.attrib; + %local.citetitle.attrib; +> +<!--end of citetitle.attlist-->]]> +<!--end of citetitle.module-->]]> + +<!ENTITY % emphasis.module "INCLUDE"> +<![%emphasis.module;[ +<!ENTITY % local.emphasis.attrib ""> +<!ENTITY % emphasis.role.attrib "%role.attrib;"> + +<!ENTITY % emphasis.element "INCLUDE"> +<![%emphasis.element;[ +<!--doc:Emphasized text.--> +<!ELEMENT emphasis %ho; (%para.char.mix;)*> +<!--end of emphasis.element-->]]> + +<!ENTITY % emphasis.attlist "INCLUDE"> +<![%emphasis.attlist;[ +<!ATTLIST emphasis + %common.attrib; + %emphasis.role.attrib; + %local.emphasis.attrib; +> +<!--end of emphasis.attlist-->]]> +<!--end of emphasis.module-->]]> + +<!ENTITY % foreignphrase.module "INCLUDE"> +<![%foreignphrase.module;[ +<!ENTITY % local.foreignphrase.attrib ""> +<!ENTITY % foreignphrase.role.attrib "%role.attrib;"> + +<!ENTITY % foreignphrase.element "INCLUDE"> +<![%foreignphrase.element;[ +<!--doc:A word or phrase in a language other than the primary language of the document.--> +<!ELEMENT foreignphrase %ho; (%para.char.mix;)*> +<!--end of foreignphrase.element-->]]> + +<!ENTITY % foreignphrase.attlist "INCLUDE"> +<![%foreignphrase.attlist;[ +<!ATTLIST foreignphrase + %common.attrib; + %foreignphrase.role.attrib; + %local.foreignphrase.attrib; +> +<!--end of foreignphrase.attlist-->]]> +<!--end of foreignphrase.module-->]]> + +<!ENTITY % glossterm.module "INCLUDE"> +<![%glossterm.module;[ +<!ENTITY % local.glossterm.attrib ""> +<!ENTITY % glossterm.role.attrib "%role.attrib;"> + +<!ENTITY % glossterm.element "INCLUDE"> +<![%glossterm.element;[ +<!--doc:A glossary term.--> +<!ELEMENT glossterm %ho; (%para.char.mix;)* + %glossterm.exclusion;> +<!--end of glossterm.element-->]]> + +<!-- to GlossEntry if Glossterm used in text --> +<!-- BaseForm: Provides the form of GlossTerm to be used + for indexing --> + +<!ENTITY % glossterm.attlist "INCLUDE"> +<![%glossterm.attlist;[ +<!ATTLIST glossterm + baseform CDATA #IMPLIED + %linkend.attrib; + %common.attrib; + %glossterm.role.attrib; + %local.glossterm.attrib; +> +<!--end of glossterm.attlist-->]]> +<!--end of glossterm.module-->]]> + +<!ENTITY % firstterm.module "INCLUDE"> +<![%firstterm.module;[ +<!ENTITY % local.firstterm.attrib ""> +<!ENTITY % firstterm.role.attrib "%role.attrib;"> + +<!ENTITY % firstterm.element "INCLUDE"> +<![%firstterm.element;[ +<!--doc:The first occurrence of a term.--> +<!ELEMENT firstterm %ho; (%para.char.mix;)* + %glossterm.exclusion;> +<!--end of firstterm.element-->]]> + +<!-- to GlossEntry or other explanation --> + + +<!ENTITY % firstterm.attlist "INCLUDE"> +<![%firstterm.attlist;[ +<!ATTLIST firstterm + baseform CDATA #IMPLIED + %linkend.attrib; + %common.attrib; + %firstterm.role.attrib; + %local.firstterm.attrib; +> +<!--end of firstterm.attlist-->]]> +<!--end of firstterm.module-->]]> + +<!ENTITY % phrase.module "INCLUDE"> +<![%phrase.module;[ +<!ENTITY % local.phrase.attrib ""> +<!ENTITY % phrase.role.attrib "%role.attrib;"> + +<!ENTITY % phrase.element "INCLUDE"> +<![%phrase.element;[ +<!--doc:A span of text.--> +<!ELEMENT phrase %ho; (%para.char.mix;)*> +<!--end of phrase.element-->]]> + +<!ENTITY % phrase.attlist "INCLUDE"> +<![%phrase.attlist;[ +<!ATTLIST phrase + %common.attrib; + %phrase.role.attrib; + %local.phrase.attrib; +> +<!--end of phrase.attlist-->]]> +<!--end of phrase.module-->]]> + +<!ENTITY % quote.module "INCLUDE"> +<![%quote.module;[ +<!ENTITY % local.quote.attrib ""> +<!ENTITY % quote.role.attrib "%role.attrib;"> + +<!ENTITY % quote.element "INCLUDE"> +<![%quote.element;[ +<!--doc:An inline quotation.--> +<!ELEMENT quote %ho; (%para.char.mix;)*> +<!--end of quote.element-->]]> + +<!ENTITY % quote.attlist "INCLUDE"> +<![%quote.attlist;[ +<!ATTLIST quote + %common.attrib; + %quote.role.attrib; + %local.quote.attrib; +> +<!--end of quote.attlist-->]]> +<!--end of quote.module-->]]> + +<!ENTITY % ssscript.module "INCLUDE"> +<![%ssscript.module;[ +<!ENTITY % local.ssscript.attrib ""> +<!ENTITY % ssscript.role.attrib "%role.attrib;"> + +<!ENTITY % subscript.element "INCLUDE"> +<![%subscript.element;[ +<!--doc:A subscript (as in H{^2}O, the molecular formula for water).--> +<!ELEMENT subscript %ho; (#PCDATA + | %link.char.class; + | emphasis + | replaceable + | symbol + | inlinegraphic + | inlinemediaobject + | %base.char.class; + | %other.char.class;)* + %ubiq.exclusion;> +<!--end of subscript.element-->]]> + +<!ENTITY % subscript.attlist "INCLUDE"> +<![%subscript.attlist;[ +<!ATTLIST subscript + %common.attrib; + %ssscript.role.attrib; + %local.ssscript.attrib; +> +<!--end of subscript.attlist-->]]> + +<!ENTITY % superscript.element "INCLUDE"> +<![%superscript.element;[ +<!--doc:A superscript (as in x^2, the mathematical notation for x multiplied by itself).--> +<!ELEMENT superscript %ho; (#PCDATA + | %link.char.class; + | emphasis + | replaceable + | symbol + | inlinegraphic + | inlinemediaobject + | %base.char.class; + | %other.char.class;)* + %ubiq.exclusion;> +<!--end of superscript.element-->]]> + +<!ENTITY % superscript.attlist "INCLUDE"> +<![%superscript.attlist;[ +<!ATTLIST superscript + %common.attrib; + %ssscript.role.attrib; + %local.ssscript.attrib; +> +<!--end of superscript.attlist-->]]> +<!--end of ssscript.module-->]]> + +<!ENTITY % trademark.module "INCLUDE"> +<![%trademark.module;[ +<!ENTITY % local.trademark.attrib ""> +<!ENTITY % trademark.role.attrib "%role.attrib;"> + +<!ENTITY % trademark.element "INCLUDE"> +<![%trademark.element;[ +<!--doc:A trademark.--> +<!ELEMENT trademark %ho; (#PCDATA + | %link.char.class; + | %tech.char.class; + | %base.char.class; + | %other.char.class; + | inlinegraphic + | inlinemediaobject + | emphasis)*> +<!--end of trademark.element-->]]> + +<!-- Class: More precisely identifies the item the element names --> + + +<!ENTITY % trademark.attlist "INCLUDE"> +<![%trademark.attlist;[ +<!ATTLIST trademark + class (service + |trade + |registered + |copyright) 'trade' + %common.attrib; + %trademark.role.attrib; + %local.trademark.attrib; +> +<!--end of trademark.attlist-->]]> +<!--end of trademark.module-->]]> + +<!ENTITY % wordasword.module "INCLUDE"> +<![%wordasword.module;[ +<!ENTITY % local.wordasword.attrib ""> +<!ENTITY % wordasword.role.attrib "%role.attrib;"> + +<!ENTITY % wordasword.element "INCLUDE"> +<![%wordasword.element;[ +<!--doc:A word meant specifically as a word and not representing anything else.--> +<!ELEMENT wordasword %ho; (%word.char.mix;)*> +<!--end of wordasword.element-->]]> + +<!ENTITY % wordasword.attlist "INCLUDE"> +<![%wordasword.attlist;[ +<!ATTLIST wordasword + %common.attrib; + %wordasword.role.attrib; + %local.wordasword.attrib; +> +<!--end of wordasword.attlist-->]]> +<!--end of wordasword.module-->]]> + +<!-- Links and cross-references ........................................... --> + +<!ENTITY % link.module "INCLUDE"> +<![%link.module;[ +<!ENTITY % local.link.attrib ""> +<!ENTITY % link.role.attrib "%role.attrib;"> + +<!ENTITY % link.element "INCLUDE"> +<![%link.element;[ +<!--doc:A hypertext link.--> +<!ELEMENT link %ho; (%para.char.mix;)* + %links.exclusion;> +<!--end of link.element-->]]> + +<!-- Endterm: ID of element containing text that is to be + fetched from elsewhere in the document to appear as + the content of this element --> +<!-- to linked-to object --> +<!-- Type: Freely assignable parameter --> + + +<!ENTITY % link.attlist "INCLUDE"> +<![%link.attlist;[ +<!ATTLIST link + endterm IDREF #IMPLIED + xrefstyle CDATA #IMPLIED + type CDATA #IMPLIED + %linkendreq.attrib; + %common.attrib; + %link.role.attrib; + %local.link.attrib; +> +<!--end of link.attlist-->]]> +<!--end of link.module-->]]> + +<!ENTITY % olink.module "INCLUDE"> +<![%olink.module;[ +<!ENTITY % local.olink.attrib ""> +<!ENTITY % olink.role.attrib "%role.attrib;"> + +<!ENTITY % olink.element "INCLUDE"> +<![%olink.element;[ +<!--doc:A link that addresses its target indirectly, through an entity.--> +<!ELEMENT olink %ho; (%para.char.mix;)* + %links.exclusion;> +<!--end of olink.element-->]]> + +<!-- TargetDocEnt: Name of an entity to be the target of the link --> +<!-- LinkMode: ID of a ModeSpec containing instructions for + operating on the entity named by TargetDocEnt --> +<!-- LocalInfo: Information that may be passed to ModeSpec --> +<!-- Type: Freely assignable parameter --> + + +<!ENTITY % olink.attlist "INCLUDE"> +<![%olink.attlist;[ +<!ATTLIST olink + targetdocent ENTITY #IMPLIED + linkmode IDREF #IMPLIED + localinfo CDATA #IMPLIED + type CDATA #IMPLIED + targetdoc CDATA #IMPLIED + targetptr CDATA #IMPLIED + xrefstyle CDATA #IMPLIED + %common.attrib; + %olink.role.attrib; + %local.olink.attrib; +> +<!--end of olink.attlist-->]]> +<!--end of olink.module-->]]> + +<!ENTITY % ulink.module "INCLUDE"> +<![%ulink.module;[ +<!ENTITY % local.ulink.attrib ""> +<!ENTITY % ulink.role.attrib "%role.attrib;"> + +<!ENTITY % ulink.element "INCLUDE"> +<![%ulink.element;[ +<!--doc:A link that addresses its target by means of a URL (Uniform Resource Locator).--> +<!ELEMENT ulink %ho; (%para.char.mix;)* + %links.exclusion;> +<!--end of ulink.element-->]]> + +<!-- URL: uniform resource locator; the target of the ULink --> +<!-- Type: Freely assignable parameter --> + + +<!ENTITY % ulink.attlist "INCLUDE"> +<![%ulink.attlist;[ +<!ATTLIST ulink + url CDATA #REQUIRED + type CDATA #IMPLIED + xrefstyle CDATA #IMPLIED + %common.attrib; + %ulink.role.attrib; + %local.ulink.attrib; +> +<!--end of ulink.attlist-->]]> +<!--end of ulink.module-->]]> + +<!ENTITY % footnoteref.module "INCLUDE"> +<![%footnoteref.module;[ +<!ENTITY % local.footnoteref.attrib ""> +<!ENTITY % footnoteref.role.attrib "%role.attrib;"> + +<!ENTITY % footnoteref.element "INCLUDE"> +<![%footnoteref.element;[ +<!--doc:A cross reference to a footnote (a footnote mark).--> +<!ELEMENT footnoteref %ho; EMPTY> +<!--end of footnoteref.element-->]]> + +<!-- to footnote content supplied elsewhere --> + + +<!ENTITY % footnoteref.attlist "INCLUDE"> +<![%footnoteref.attlist;[ +<!ATTLIST footnoteref + %linkendreq.attrib; %label.attrib; + %common.attrib; + %footnoteref.role.attrib; + %local.footnoteref.attrib; +> +<!--end of footnoteref.attlist-->]]> +<!--end of footnoteref.module-->]]> + +<!ENTITY % xref.module "INCLUDE"> +<![%xref.module;[ +<!ENTITY % local.xref.attrib ""> +<!ENTITY % xref.role.attrib "%role.attrib;"> + +<!ENTITY % xref.element "INCLUDE"> +<![%xref.element;[ +<!--doc:A cross reference to another part of the document.--> +<!ELEMENT xref %ho; EMPTY> +<!--end of xref.element-->]]> + +<!-- Endterm: ID of element containing text that is to be + fetched from elsewhere in the document to appear as + the content of this element --> +<!-- to linked-to object --> + + +<!ENTITY % xref.attlist "INCLUDE"> +<![%xref.attlist;[ +<!ATTLIST xref + endterm IDREF #IMPLIED + xrefstyle CDATA #IMPLIED + %common.attrib; + %linkendreq.attrib; + %xref.role.attrib; + %local.xref.attrib; +> +<!--end of xref.attlist-->]]> +<!--end of xref.module-->]]> + +<!ENTITY % biblioref.module "INCLUDE"> +<![%biblioref.module;[ +<!ENTITY % local.biblioref.attrib ""> +<!ENTITY % biblioref.role.attrib "%role.attrib;"> + +<!ENTITY % biblioref.element "INCLUDE"> +<![%biblioref.element;[ +<!--doc:A cross reference to a bibliographic entry.--> +<!ELEMENT biblioref %ho; EMPTY> +<!--end of biblioref.element-->]]> + +<!ENTITY % biblioref.attlist "INCLUDE"> +<![%biblioref.attlist;[ +<!ATTLIST biblioref + endterm IDREF #IMPLIED + xrefstyle CDATA #IMPLIED + units CDATA #IMPLIED + begin CDATA #IMPLIED + end CDATA #IMPLIED + %common.attrib; + %linkendreq.attrib; + %biblioref.role.attrib; + %local.biblioref.attrib; +> +<!--end of biblioref.attlist-->]]> +<!--end of biblioref.module-->]]> + +<!-- Ubiquitous elements .................................................. --> + +<!ENTITY % anchor.module "INCLUDE"> +<![%anchor.module;[ +<!ENTITY % local.anchor.attrib ""> +<!ENTITY % anchor.role.attrib "%role.attrib;"> + +<!ENTITY % anchor.element "INCLUDE"> +<![%anchor.element;[ +<!--doc:A spot in the document.--> +<!ELEMENT anchor %ho; EMPTY> +<!--end of anchor.element-->]]> + +<!-- required --> +<!-- replaces Lang --> + + +<!ENTITY % anchor.attlist "INCLUDE"> +<![%anchor.attlist;[ +<!ATTLIST anchor + %idreq.attrib; %pagenum.attrib; %remap.attrib; + %xreflabel.attrib; + %revisionflag.attrib; + %effectivity.attrib; + %anchor.role.attrib; + %local.anchor.attrib; +> +<!--end of anchor.attlist-->]]> +<!--end of anchor.module-->]]> + +<!ENTITY % beginpage.module "INCLUDE"> +<![%beginpage.module;[ +<!ENTITY % local.beginpage.attrib ""> +<!ENTITY % beginpage.role.attrib "%role.attrib;"> + +<!ENTITY % beginpage.element "INCLUDE"> +<![%beginpage.element;[ +<!--doc:The location of a page break in a print version of the document.--> +<!ELEMENT beginpage %ho; EMPTY> +<!--end of beginpage.element-->]]> + +<!-- PageNum: Number of page that begins at this point --> + + +<!ENTITY % beginpage.attlist "INCLUDE"> +<![%beginpage.attlist;[ +<!ATTLIST beginpage + %pagenum.attrib; + %common.attrib; + %beginpage.role.attrib; + %local.beginpage.attrib; +> +<!--end of beginpage.attlist-->]]> +<!--end of beginpage.module-->]]> + +<!-- IndexTerms appear in the text flow for generating or linking an + index. --> + +<!ENTITY % indexterm.content.module "INCLUDE"> +<![%indexterm.content.module;[ +<!ENTITY % indexterm.module "INCLUDE"> +<![%indexterm.module;[ +<!ENTITY % local.indexterm.attrib ""> +<!ENTITY % indexterm.role.attrib "%role.attrib;"> + +<!ENTITY % indexterm.element "INCLUDE"> +<![%indexterm.element;[ +<!--doc:A wrapper for terms to be indexed.--> +<!ELEMENT indexterm %ho; (primary?, ((secondary, ((tertiary, (see|seealso+)?) + | see | seealso+)?) | see | seealso+)?) + %ubiq.exclusion;> +<!--end of indexterm.element-->]]> + +<!-- Scope: Indicates which generated indices the IndexTerm + should appear in: Global (whole document set), Local (this + document only), or All (both) --> +<!-- Significance: Whether this IndexTerm is the most pertinent + of its series (Preferred) or not (Normal, the default) --> +<!-- Class: Indicates type of IndexTerm; default is Singular, + or EndOfRange if StartRef is supplied; StartOfRange value + must be supplied explicitly on starts of ranges --> +<!-- StartRef: ID of the IndexTerm that starts the indexing + range ended by this IndexTerm --> +<!-- Zone: IDs of the elements to which the IndexTerm applies, + and indicates that the IndexTerm applies to those entire + elements rather than the point at which the IndexTerm + occurs --> + + +<!ENTITY % indexterm.attlist "INCLUDE"> +<![%indexterm.attlist;[ +<!ATTLIST indexterm + %pagenum.attrib; + scope (all + |global + |local) #IMPLIED + significance (preferred + |normal) "normal" + class (singular + |startofrange + |endofrange) #IMPLIED + startref IDREF #IMPLIED + zone IDREFS #IMPLIED + type CDATA #IMPLIED + %common.attrib; + %indexterm.role.attrib; + %local.indexterm.attrib; +> +<!--end of indexterm.attlist-->]]> +<!--end of indexterm.module-->]]> + +<!ENTITY % primsecter.module "INCLUDE"> +<![%primsecter.module;[ +<!ENTITY % local.primsecter.attrib ""> +<!ENTITY % primsecter.role.attrib "%role.attrib;"> + + +<!ENTITY % primary.element "INCLUDE"> +<![%primary.element;[ +<!--doc:The primary word or phrase under which an index term should be sorted.--> +<!ELEMENT primary %ho; (%ndxterm.char.mix;)*> +<!--end of primary.element-->]]> +<!-- SortAs: Alternate sort string for index sorting, e.g., + "fourteen" for an element containing "14" --> + +<!ENTITY % primary.attlist "INCLUDE"> +<![%primary.attlist;[ +<!ATTLIST primary + sortas CDATA #IMPLIED + %common.attrib; + %primsecter.role.attrib; + %local.primsecter.attrib; +> +<!--end of primary.attlist-->]]> + + +<!ENTITY % secondary.element "INCLUDE"> +<![%secondary.element;[ +<!--doc:A secondary word or phrase in an index term.--> +<!ELEMENT secondary %ho; (%ndxterm.char.mix;)*> +<!--end of secondary.element-->]]> +<!-- SortAs: Alternate sort string for index sorting, e.g., + "fourteen" for an element containing "14" --> + +<!ENTITY % secondary.attlist "INCLUDE"> +<![%secondary.attlist;[ +<!ATTLIST secondary + sortas CDATA #IMPLIED + %common.attrib; + %primsecter.role.attrib; + %local.primsecter.attrib; +> +<!--end of secondary.attlist-->]]> + + +<!ENTITY % tertiary.element "INCLUDE"> +<![%tertiary.element;[ +<!--doc:A tertiary word or phrase in an index term.--> +<!ELEMENT tertiary %ho; (%ndxterm.char.mix;)*> +<!--end of tertiary.element-->]]> +<!-- SortAs: Alternate sort string for index sorting, e.g., + "fourteen" for an element containing "14" --> + +<!ENTITY % tertiary.attlist "INCLUDE"> +<![%tertiary.attlist;[ +<!ATTLIST tertiary + sortas CDATA #IMPLIED + %common.attrib; + %primsecter.role.attrib; + %local.primsecter.attrib; +> +<!--end of tertiary.attlist-->]]> + +<!--end of primsecter.module-->]]> + +<!ENTITY % seeseealso.module "INCLUDE"> +<![%seeseealso.module;[ +<!ENTITY % local.seeseealso.attrib ""> +<!ENTITY % seeseealso.role.attrib "%role.attrib;"> + +<!ENTITY % see.element "INCLUDE"> +<![%see.element;[ +<!--doc:Part of an index term directing the reader instead to another entry in the index.--> +<!ELEMENT see %ho; (%ndxterm.char.mix;)*> +<!--end of see.element-->]]> + +<!ENTITY % see.attlist "INCLUDE"> +<![%see.attlist;[ +<!ATTLIST see + %common.attrib; + %seeseealso.role.attrib; + %local.seeseealso.attrib; +> +<!--end of see.attlist-->]]> + +<!ENTITY % seealso.element "INCLUDE"> +<![%seealso.element;[ +<!--doc:Part of an index term directing the reader also to another entry in the index.--> +<!ELEMENT seealso %ho; (%ndxterm.char.mix;)*> +<!--end of seealso.element-->]]> + +<!ENTITY % seealso.attlist "INCLUDE"> +<![%seealso.attlist;[ +<!ATTLIST seealso + %common.attrib; + %seeseealso.role.attrib; + %local.seeseealso.attrib; +> +<!--end of seealso.attlist-->]]> +<!--end of seeseealso.module-->]]> +<!--end of indexterm.content.module-->]]> + +<!-- End of DocBook XML information pool module V4.5 ...................... --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/docbookx.dtd b/doc/creating_themes/C/docbookx.dtd new file mode 100644 index 00000000..8b43c59b --- /dev/null +++ b/doc/creating_themes/C/docbookx.dtd @@ -0,0 +1,170 @@ +<!-- ...................................................................... --> +<!-- DocBook XML DTD V4.5 ................................................. --> +<!-- File docbookx.dtd .................................................... --> + +<!-- Copyright 1992-2006 HaL Computer Systems, Inc., + O'Reilly & Associates, Inc., ArborText, Inc., Fujitsu Software + Corporation, Norman Walsh, Sun Microsystems, Inc., and the + Organization for the Advancement of Structured Information + Standards (OASIS). + + See also http://docbook.org/specs/ + + $Id: docbookx.dtd 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook XML DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This is the driver file for V4.5 of the DocBook DTD. + Please use the following formal public identifier to identify it: + + "-//OASIS//DTD DocBook XML V4.5//EN" + + For example, if your document's top-level element is Book, and + you are using DocBook directly, use the FPI in the DOCTYPE + declaration: + + <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" + [...]> + + Or, if you have a higher-level driver file that customizes DocBook, + use the FPI in the parameter entity declaration: + + <!ENTITY % DocBookDTD PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> + %DocBookDTD; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!-- ...................................................................... --> +<!-- Enable SGML features ................................................. --> + +<!ENTITY % sgml.features "IGNORE"> +<![%sgml.features;[ +<!ENTITY % xml.features "IGNORE"> +]]> +<!ENTITY % xml.features "INCLUDE"> + +<![%sgml.features;[ +<![%xml.features;[ + +<!-- ERROR: Exactly one of xml.features and sgml.features must be turned on! --> +<!ENTITY % dbnotn SYSTEM "http://www.oasis-open.org/docbook/xml/configerror.txt"> +<!ENTITY % dbcent SYSTEM "http://www.oasis-open.org/docbook/xml/configerror.txt"> +<!ENTITY % dbpool SYSTEM "http://www.oasis-open.org/docbook/xml/configerror.txt"> +<!ENTITY % dbhier SYSTEM "http://www.oasis-open.org/docbook/xml/configerror.txt"> +<!ENTITY % dbgenent SYSTEM "http://www.oasis-open.org/docbook/xml/configerror.txt"> + +]]> +]]> + +<![%sgml.features;[ +<!ENTITY % ho "- O"> +<!ENTITY % hh "- -"> +]]> + +<![%xml.features;[ +<!ENTITY % ho ""> +<!ENTITY % hh ""> +]]> + +<!-- ...................................................................... --> +<!-- Notation declarations ................................................ --> + +<!ENTITY % dbnotn.module "INCLUDE"> +<![%dbnotn.module;[ +<!ENTITY % dbnotn PUBLIC +"-//OASIS//ENTITIES DocBook Notations V4.5//EN" +"dbnotnx.mod"> +%dbnotn; +]]> + +<!-- ...................................................................... --> +<!-- ISO character entity sets ............................................ --> + +<!ENTITY % dbcent.module "INCLUDE"> +<![%dbcent.module;[ + +<!ENTITY % dbcent.euro "INCLUDE"> +<![%dbcent.euro;[ +<![%sgml.features;[ +<!ENTITY euro SDATA "[euro ]"><!-- euro sign --> +]]> +<![%xml.features;[ +<!ENTITY euro "€"><!-- euro sign, U+20AC NEW --> +]]> +]]> + +<!ENTITY % dbcent PUBLIC +"-//OASIS//ENTITIES DocBook Character Entities V4.5//EN" +"dbcentx.mod"> +%dbcent; +]]> + +<!-- ...................................................................... --> +<!-- DTD modules .......................................................... --> + +<!-- Information pool .............. --> + +<!ENTITY % dbpool.module "INCLUDE"> +<![ %dbpool.module; [ +<!ENTITY % dbpool PUBLIC +"-//OASIS//ELEMENTS DocBook Information Pool V4.5//EN" +"dbpoolx.mod"> +%dbpool; +]]> + +<!-- Redeclaration placeholder ..... --> + +<!ENTITY % intermod.redecl.module "IGNORE"> +<![%intermod.redecl.module;[ +<!-- Defining rdbmods here makes some buggy XML parsers happy. --> +<!ENTITY % rdbmods ""> +%rdbmods; +<!--end of intermod.redecl.module-->]]> + +<!-- Document hierarchy ............ --> + +<!ENTITY % dbhier.module "INCLUDE"> +<![ %dbhier.module; [ +<!ENTITY % dbhier PUBLIC +"-//OASIS//ELEMENTS DocBook Document Hierarchy V4.5//EN" +"dbhierx.mod"> +%dbhier; +]]> + +<!-- ...................................................................... --> +<!-- Other general entities ............................................... --> + +<!ENTITY % dbgenent.module "INCLUDE"> +<![ %dbgenent.module; [ +<!ENTITY % dbgenent PUBLIC +"-//OASIS//ENTITIES DocBook Additional General Entities V4.5//EN" +"dbgenent.mod"> +%dbgenent; +]]> + +<!-- End of DocBook XML DTD V4.5 .......................................... --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/htmltblx.mod b/doc/creating_themes/C/htmltblx.mod new file mode 100644 index 00000000..cdaefed4 --- /dev/null +++ b/doc/creating_themes/C/htmltblx.mod @@ -0,0 +1,245 @@ +<!-- ...................................................................... --> +<!-- DocBook XML HTML Table Module V4.5 ................................... --> +<!-- File htmltblx.mod .................................................... --> + +<!-- Copyright 2003-2006 ArborText, Inc., Norman Walsh, Sun Microsystems, + Inc., and the Organization for the Advancement of Structured Information + Standards (OASIS). + + $Id: htmltblx.mod 6340 2006-10-03 13:23:24Z nwalsh $ + + Permission to use, copy, modify and distribute the DocBook XML DTD + and its accompanying documentation for any purpose and without fee + is hereby granted in perpetuity, provided that the above copyright + notice and this paragraph appear in all copies. The copyright + holders make no representation about the suitability of the DTD for + any purpose. It is provided "as is" without expressed or implied + warranty. + + If you modify the DocBook XML DTD in any way, except for declaring and + referencing additional sets of general entities and declaring + additional notations, label your DTD as a variant of DocBook. See + the maintenance documentation for more information. + + Please direct all questions, bug reports, or suggestions for + changes to the [email protected] mailing list. For more + information, see http://www.oasis-open.org/docbook/. +--> + +<!-- ...................................................................... --> + +<!-- This module contains the definitions for elements that are + isomorphic to the HTML elements. One could argue we should + instead have based ourselves on the XHTML Table Module, but the + HTML one is more like what browsers are likely to accept today + and users are likely to use. + + This module has been developed for use with the DocBook V4.5 + "union table model" in which elements and attlists common to both + models are defined (as the union) in the CALS table module by + setting various parameter entities appropriately in this file. + + In DTD driver files referring to this module, please use an entity + declaration that uses the public identifier shown below: + + <!ENTITY % htmltbl PUBLIC + "-//OASIS//ELEMENTS DocBook XML HTML Tables V4.5//EN" + "htmltblx.mod"> + %htmltbl; + + See the documentation for detailed information on the parameter + entity and module scheme used in DocBook, customizing DocBook and + planning for interchange, and changes made since the last release + of DocBook. +--> + +<!--======================= XHTML Tables =======================================--> + +<!ENTITY % html.coreattrs + "%common.attrib; + class CDATA #IMPLIED + style CDATA #IMPLIED + title CDATA #IMPLIED" + > + +<!-- Does not contain lang or dir because they are in %common.attribs --> +<![%sgml.features;[ +<!ENTITY % i18n ""> +]]> +<!ENTITY % i18n + "xml:lang NMTOKEN #IMPLIED" + > + +<!ENTITY % events + "onclick CDATA #IMPLIED + ondblclick CDATA #IMPLIED + onmousedown CDATA #IMPLIED + onmouseup CDATA #IMPLIED + onmouseover CDATA #IMPLIED + onmousemove CDATA #IMPLIED + onmouseout CDATA #IMPLIED + onkeypress CDATA #IMPLIED + onkeydown CDATA #IMPLIED + onkeyup CDATA #IMPLIED" + > + +<!ENTITY % attrs "%html.coreattrs; %i18n; %events;"> + +<!ENTITY % cellhalign + "align (left|center|right|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff CDATA #IMPLIED" + > + +<!ENTITY % cellvalign + "valign (top|middle|bottom|baseline) #IMPLIED" + > + +<!--doc:A group of columns in an HTML table.--> +<!ELEMENT colgroup %ho; (col)*> +<!--doc:Specifications for a column in an HTML table.--> +<!ELEMENT col %ho; EMPTY> +<!--doc:A row in an HTML table.--> +<!ELEMENT tr %ho; (th|td)+> +<!--doc:A table header entry in an HTML table.--> +<!ELEMENT th %ho; (%para.char.mix; | %tabentry.mix; | table | informaltable)*> +<!--doc:A table ntry in an HTML table.--> +<!ELEMENT td %ho; (%para.char.mix; | %tabentry.mix; | table | informaltable)*> + +<!ATTLIST colgroup + %attrs; + span CDATA "1" + width CDATA #IMPLIED + %cellhalign; + %cellvalign; + > + +<!ATTLIST col + %attrs; + span CDATA "1" + width CDATA #IMPLIED + %cellhalign; + %cellvalign; + > + +<!ATTLIST tr + %attrs; + %cellhalign; + %cellvalign; + bgcolor CDATA #IMPLIED + > + +<!ATTLIST th + %attrs; + abbr CDATA #IMPLIED + axis CDATA #IMPLIED + headers IDREFS #IMPLIED + scope (row|col|rowgroup|colgroup) #IMPLIED + rowspan CDATA "1" + colspan CDATA "1" + %cellhalign; + %cellvalign; + nowrap (nowrap) #IMPLIED + bgcolor CDATA #IMPLIED + width CDATA #IMPLIED + height CDATA #IMPLIED + > + +<!ATTLIST td + %attrs; + abbr CDATA #IMPLIED + axis CDATA #IMPLIED + headers IDREFS #IMPLIED + scope (row|col|rowgroup|colgroup) #IMPLIED + rowspan CDATA "1" + colspan CDATA "1" + %cellhalign; + %cellvalign; + nowrap (nowrap) #IMPLIED + bgcolor CDATA #IMPLIED + width CDATA #IMPLIED + height CDATA #IMPLIED + > + +<!-- ====================================================== --> +<!-- Set up to read in the CALS model configured to + merge with the XHTML table model --> +<!-- ====================================================== --> + +<!ENTITY % tables.role.attrib "%role.attrib;"> + +<!-- Add label and role attributes to table and informaltable --> +<!ENTITY % bodyatt " + floatstyle CDATA #IMPLIED + rowheader (firstcol|norowheader) #IMPLIED + %label.attrib;" +> + +<!-- Add common attributes to Table, TGroup, TBody, THead, TFoot, Row, + EntryTbl, and Entry (and InformalTable element). --> + +<!ENTITY % secur " + %common.attrib; + class CDATA #IMPLIED + style CDATA #IMPLIED + title CDATA #IMPLIED + %i18n; + %events; + %tables.role.attrib;"> + +<!ENTITY % common.table.attribs + "%bodyatt; + %secur;"> + +<!-- Content model for Table (that also allows HTML tables) --> +<!ENTITY % tbl.table.mdl + "((blockinfo?, + (%formalobject.title.content;), + (%ndxterm.class;)*, + textobject*, + (graphic+|mediaobject+|tgroup+)) + |(caption, (col*|colgroup*), thead?, tfoot?, (tbody+|tr+)))"> + +<!ENTITY % informal.tbl.table.mdl + "(textobject*, + (graphic+|mediaobject+|tgroup+)) + | ((col*|colgroup*), thead?, tfoot?, (tbody+|tr+))"> + +<!-- Attributes for Table (including HTML ones) --> + +<!-- N.B. rules = (none | groups | rows | cols | all) but it can't be spec'd --> +<!-- that way because 'all' already occurs in a different enumeration in --> +<!-- CALS tables (frame). --> + +<!ENTITY % tbl.table.att ' + tabstyle CDATA #IMPLIED + tocentry %yesorno.attvals; #IMPLIED + shortentry %yesorno.attvals; #IMPLIED + orient (port|land) #IMPLIED + pgwide %yesorno.attvals; #IMPLIED + summary CDATA #IMPLIED + width CDATA #IMPLIED + border CDATA #IMPLIED + rules CDATA #IMPLIED + cellspacing CDATA #IMPLIED + cellpadding CDATA #IMPLIED + align (left|center|right) #IMPLIED + bgcolor CDATA #IMPLIED +'> + +<!ENTITY % tbl.frame.attval "void|above|below|hsides|lhs|rhs|vsides|box|border| +top|bottom|topbot|all|sides|none"> + +<!-- Allow either objects or inlines; beware of REs between elements. --> +<!ENTITY % tbl.entry.mdl "%para.char.mix; | %tabentry.mix;"> + +<!-- thead, tfoot, and tbody are defined in both table models, + so we set up parameter entities to define union models for them + --> + +<!ENTITY % tbl.hdft.mdl "(tr+|(colspec*,row+))"> +<!ENTITY % tbl.tbody.mdl "(tr+|row+)"> +<!ENTITY % tbl.valign.attval "top|middle|bottom|baseline"> + +<!-- End of DocBook XML HTML Table Module V4.5 ............................ --> +<!-- ...................................................................... --> diff --git a/doc/creating_themes/C/soextblx.dtd b/doc/creating_themes/C/soextblx.dtd new file mode 100644 index 00000000..4a92e116 --- /dev/null +++ b/doc/creating_themes/C/soextblx.dtd @@ -0,0 +1,321 @@ +<!-- XML EXCHANGE TABLE MODEL DECLARATION MODULE --> + +<!-- This set of declarations defines the XML version of the Exchange + Table Model as of the date shown in the Formal Public Identifier + (FPI) for this entity. + + This set of declarations may be referred to using a public external + entity declaration and reference as shown in the following three + lines: + + <!ENTITY % calstblx + PUBLIC "-//OASIS//DTD XML Exchange Table Model 19990315//EN"> + %calstblx; + + If various parameter entities used within this set of declarations + are to be given non-default values, the appropriate declarations + should be given before calling in this package (i.e., before the + "%calstblx;" reference). +--> + +<!-- The motivation for this XML version of the Exchange Table Model + is simply to create an XML version of the SGML Exchange Table + Model. By design, no effort has been made to "improve" the model. + + This XML version incorporates the logical bare minimum changes + necessary to make the Exchange Table Model a valid XML DTD. + + It has been modified slightly for use in the combined HTML/CALS models + supported by DocBook V4.3 and later. +--> + +<!-- The XML version of the Exchange Table Model differs from + the SGML version in the following ways: + + The following parameter entities have been removed: + + - tbl.table.excep, tbl.hdft.excep, tbl.row.excep, tbl.entry.excep + There are no exceptions in XML. The following normative statement + is made in lieu of exceptions: the exchange table model explicitly + forbids a table from occurring within another table. If the + content model of an entry includes a table element, then this + cannot be enforced by the DTD, but it is a deviation from the + exchange table model to include a table within a table. + + - tbl.hdft.name, tbl.hdft.mdl, tbl.hdft.excep, tbl.hdft.att + The motivation for these elements was to change the table + header/footer elements. Since XML does not allow element declarations + to contain name groups, and the exchange table model does not + allow a table to contain footers, the continued presence of these + attributes seems unnecessary. + + The following parameter entity has been added: + + - tbl.thead.att + This entity parameterizes the attributes on thead. It replaces + the tbl.hdft.att parameter entity. + + Other miscellaneous changes: + + - Tag ommission indicators have been removed + - Comments have been removed from declarations + - NUMBER attributes have been changed to NMTOKEN + - NUTOKEN attributes have been to changed to NMTOKEN + - Removed the grouping characters around the content model + parameter entry for the 'entry' element. This is necessary + so that an entry can contain #PCDATA and be defined as an + optional, repeatable OR group beginning with #PCDATA. +--> + +<!-- This entity includes a set of element and attribute declarations + that partially defines the Exchange table model. However, the model + is not well-defined without the accompanying natural language + description of the semantics (meanings) of these various elements, + attributes, and attribute values. The semantic writeup, also available + from SGML Open, should be used in conjunction with this entity. +--> + +<!-- In order to use the Exchange table model, various parameter entity + declarations are required. A brief description is as follows: + + ENTITY NAME WHERE USED WHAT IT IS + + %yesorno In ATTLIST of: An attribute declared value + almost all elements for a "boolean" attribute + + %paracon In content model of: The "text" (logical content) + <entry> of the model group for <entry> + + %titles In content model of: The "title" part of the model + table element group for the table element + + %tbl.table.name In declaration of: The name of the "table" + table element element + + %tbl.table-titles.mdl In content model of: The model group for the title + table elements part of the content model for + table element + + %tbl.table.mdl In content model of: The model group for the content + table elements model for table element, + often (and by default) defined + in terms of %tbl.table-titles.mdl + and tgroup + + %tbl.table.att In ATTLIST of: Additional attributes on the + table element table element + + %bodyatt In ATTLIST of: Additional attributes on the + table element table element (for backward + compatibility with the SGML + model) + + %tbl.tgroup.mdl In content model of: The model group for the content + <tgroup> model for <tgroup> + + %tbl.tgroup.att In ATTLIST of: Additional attributes on the + <tgroup> <tgroup> element + + %tbl.thead.att In ATTLIST of: Additional attributes on the + <thead> <thead> element + + %tbl.tbody.att In ATTLIST of: Additional attributes on the + <tbody> <tbody> element + + %tbl.colspec.att In ATTLIST of: Additional attributes on the + <colspec> <colspec> element + + %tbl.row.mdl In content model of: The model group for the content + <row> model for <row> + + %tbl.row.att In ATTLIST of: Additional attributes on the + <row> <row> element + + %tbl.entry.mdl In content model of: The model group for the content + <entry> model for <entry> + + %tbl.entry.att In ATTLIST of: Additional attributes on the + <entry> <entry> element + + This set of declarations will use the default definitions shown below + for any of these parameter entities that are not declared before this + set of declarations is referenced. +--> + +<!-- These definitions are not directly related to the table model, but are + used in the default CALS table model and may be defined elsewhere (and + prior to the inclusion of this table module) in the referencing DTD. --> + +<!ENTITY % yesorno 'NMTOKEN'> <!-- no if zero(s), yes if any other value --> +<!ENTITY % titles 'title?'> +<!ENTITY % pcd "#PCDATA"> +<!ENTITY % paracon '%pcd;'> <!-- default for use in entry content --> + +<!-- +The parameter entities as defined below change and simplify the CALS table +model as published (as part of the Example DTD) in MIL-HDBK-28001. The +resulting simplified DTD has support from the SGML Open vendors and is +therefore more interoperable among different systems. + +These following declarations provide the Exchange default definitions +for these entities. However, these entities can be redefined (by giving +the appropriate parameter entity declaration(s) prior to the reference +to this Table Model declaration set entity) to fit the needs of the +current application. + +Note, however, that changes may have significant effect on the ability to +interchange table information. These changes may manifest themselves +in useability, presentation, and possible structure information degradation. +--> + +<!ENTITY % tbl.table.name "table"> +<!ENTITY % tbl.table-titles.mdl "%titles;,"> +<!ENTITY % tbl.table-main.mdl "tgroup+"> +<!ENTITY % tbl.table.mdl "%tbl.table-titles.mdl; %tbl.table-main.mdl;"> +<!ENTITY % tbl.table.att " + pgwide %yesorno; #IMPLIED "> +<!ENTITY % bodyatt ""> +<!ENTITY % tbl.tgroup.mdl "colspec*,thead?,tbody"> +<!ENTITY % tbl.tgroup.att ""> +<!ENTITY % tbl.thead.att ""> +<!ENTITY % tbl.tbody.att ""> +<!ENTITY % tbl.colspec.att ""> +<!ENTITY % tbl.row.mdl "entry+"> +<!ENTITY % tbl.row.att ""> +<!ENTITY % tbl.entry.mdl "(%paracon;)*"> +<!ENTITY % tbl.entry.att ""> + +<!ENTITY % tbl.frame.attval "top|bottom|topbot|all|sides|none"> +<!ENTITY % tbl.tbody.mdl "row+"> + +<!-- ===== Element and attribute declarations follow. ===== --> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.table.name "table" + ENTITY % tbl.table-titles.mdl "%titles;," + ENTITY % tbl.table.mdl "%tbl.table-titles; tgroup+" + ENTITY % tbl.table.att " + pgwide %yesorno; #IMPLIED " +--> + +<!--doc:???--> +<!ELEMENT %tbl.table.name; (%tbl.table.mdl;)> + +<!ATTLIST %tbl.table.name; + frame (%tbl.frame.attval;) #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + %tbl.table.att; + %bodyatt; +> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.tgroup.mdl "colspec*,thead?,tbody" + ENTITY % tbl.tgroup.att "" +--> + +<!--doc:A wrapper for the main content of a table, or part of a table.--> +<!ELEMENT tgroup (%tbl.tgroup.mdl;) > + +<!ATTLIST tgroup + cols NMTOKEN #REQUIRED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + %tbl.tgroup.att; +> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.colspec.att "" +--> + +<!--doc:Specifications for a column in a table.--> +<!ELEMENT colspec EMPTY > + +<!ATTLIST colspec + colnum NMTOKEN #IMPLIED + colname NMTOKEN #IMPLIED + colwidth CDATA #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff NMTOKEN #IMPLIED + %tbl.colspec.att; +> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.thead.att "" +--> + +<!--doc:A table header consisting of one or more rows.--> +<!ELEMENT thead (row+)> + +<!ATTLIST thead + valign (top|middle|bottom) #IMPLIED + %tbl.thead.att; +> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.tbody.att "" +--> + +<!--doc:A wrapper for the rows of a table or informal table.--> +<!ELEMENT tbody (%tbl.tbody.mdl;)> + +<!ATTLIST tbody + valign (top|middle|bottom) #IMPLIED + %tbl.tbody.att; +> + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % tbl.row.mdl "entry+" + ENTITY % tbl.row.att "" +--> + +<!--doc:A row in a table.--> +<!ELEMENT row (%tbl.row.mdl;)> + +<!ATTLIST row + rowsep %yesorno; #IMPLIED + valign (top|middle|bottom) #IMPLIED + %tbl.row.att; +> + + +<!-- + Default declarations previously defined in this entity and + referenced below include: + ENTITY % paracon "#PCDATA" + ENTITY % tbl.entry.mdl "(%paracon;)*" + ENTITY % tbl.entry.att "" +--> + +<!--doc:A cell in a table.--> +<!ELEMENT entry (%tbl.entry.mdl;)*> + +<!ATTLIST entry + colname NMTOKEN #IMPLIED + namest NMTOKEN #IMPLIED + nameend NMTOKEN #IMPLIED + morerows NMTOKEN #IMPLIED + colsep %yesorno; #IMPLIED + rowsep %yesorno; #IMPLIED + align (left|right|center|justify|char) #IMPLIED + char CDATA #IMPLIED + charoff NMTOKEN #IMPLIED + valign (top|middle|bottom) #IMPLIED + %tbl.entry.att; +> diff --git a/doc/creating_themes/Makefile.am b/doc/creating_themes/Makefile.am new file mode 100644 index 00000000..b848256c --- /dev/null +++ b/doc/creating_themes/Makefile.am @@ -0,0 +1,24 @@ +### This part of Makefile.am can be customized by you. + +# mate-doc-utils standard variables: +include $(top_srcdir)/mate-doc-utils.make +dist-hook: doc-dist-hook + +# The name of the directory in /usr/share/mate/help/, +# and the name of the main .xml file: +DOC_MODULE = creating-marco-themes + +# The names of any files included via entity declarations. +DOC_ENTITIES = + +# The names of any files included by xincluded (preferred): +DOC_INCLUDES = + +# The names of any pictures: +DOC_FIGURES = + +# The names of any locales for which documentation translations exist: +DOC_LINGUAS = + + + diff --git a/doc/creating_themes/Makefile.in b/doc/creating_themes/Makefile.in new file mode 100644 index 00000000..86601c10 --- /dev/null +++ b/doc/creating_themes/Makefile.in @@ -0,0 +1,981 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +### This part of Makefile.am can be customized by you. + +# mate-doc-utils.make - make magic for building documentation +# Copyright (C) 2004-2005 Shaun McCance <[email protected]> +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software Foundation, +# Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +# +# As a special exception to the GNU General Public License, if you +# distribute this file as part of a program that contains a +# configuration script generated by Autoconf, you may include it under +# the same distribution terms that you use for the rest of that program. + +################################################################################ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \ + $(top_srcdir)/mate-doc-utils.make +subdir = doc/creating_themes +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +SOURCES = +DIST_SOURCES = +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ACLOCAL_AMFLAGS = @ACLOCAL_AMFLAGS@ +ALL_CFLAGS = @ALL_CFLAGS@ +ALL_LIBS = @ALL_LIBS@ +ALL_LINGUAS = @ALL_LINGUAS@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOGS = @CATALOGS@ +CATOBJEXT = @CATOBJEXT@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DATADIRNAME = @DATADIRNAME@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DISTCHECK_CONFIGURE_FLAGS = @DISTCHECK_CONFIGURE_FLAGS@ +DLLTOOL = @DLLTOOL@ +DOC_USER_FORMATS = @DOC_USER_FORMATS@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GMOFILES = @GMOFILES@ +GMSGFMT = @GMSGFMT@ +GREP = @GREP@ +GTK_API_VERSION = @GTK_API_VERSION@ +HELP_DIR = @HELP_DIR@ +HOST_ALIAS = @HOST_ALIAS@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INSTOBJEXT = @INSTOBJEXT@ +INTLLIBS = @INTLLIBS@ +INTLTOOL_EXTRACT = @INTLTOOL_EXTRACT@ +INTLTOOL_MERGE = @INTLTOOL_MERGE@ +INTLTOOL_PERL = @INTLTOOL_PERL@ +INTLTOOL_UPDATE = @INTLTOOL_UPDATE@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MARCO_CFLAGS = @MARCO_CFLAGS@ +MARCO_LIBS = @MARCO_LIBS@ +MARCO_MESSAGE_CFLAGS = @MARCO_MESSAGE_CFLAGS@ +MARCO_MESSAGE_LIBS = @MARCO_MESSAGE_LIBS@ +MARCO_WINDOW_DEMO_CFLAGS = @MARCO_WINDOW_DEMO_CFLAGS@ +MARCO_WINDOW_DEMO_LIBS = @MARCO_WINDOW_DEMO_LIBS@ +MATECONFTOOL = @MATECONFTOOL@ +MATECONF_SCHEMA_CONFIG_SOURCE = @MATECONF_SCHEMA_CONFIG_SOURCE@ +MATECONF_SCHEMA_FILE_DIR = @MATECONF_SCHEMA_FILE_DIR@ +MATEDIALOG = @MATEDIALOG@ +MATE_KEYBINDINGS_KEYSDIR = @MATE_KEYBINDINGS_KEYSDIR@ +MKDIR_P = @MKDIR_P@ +MKINSTALLDIRS = @MKINSTALLDIRS@ +MSGFMT = @MSGFMT@ +MSGFMT_OPTS = @MSGFMT_OPTS@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OMF_DIR = @OMF_DIR@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +POFILES = @POFILES@ +POSUB = @POSUB@ +PO_IN_DATADIR_FALSE = @PO_IN_DATADIR_FALSE@ +PO_IN_DATADIR_TRUE = @PO_IN_DATADIR_TRUE@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMKMF = @XMKMF@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +_clean_doc_header = $(if $(DOC_H_FILE),clean-doc-header) +_DOC_REAL_FORMATS = $(if $(DOC_USER_FORMATS),$(DOC_USER_FORMATS),$(DOC_FORMATS)) +_DOC_REAL_LINGUAS = $(if $(filter environment,$(origin LINGUAS)), \ + $(filter $(LINGUAS),$(DOC_LINGUAS)), \ + $(DOC_LINGUAS)) + +_DOC_ABS_SRCDIR = @abs_srcdir@ +_xml2po_mode = $(if $(DOC_ID),mallard,docbook) +@ENABLE_SK_TRUE@_ENABLE_SK = true + +################################################################################ +db2omf_args = \ + --stringparam db2omf.basename $(DOC_MODULE) \ + --stringparam db2omf.format $(3) \ + --stringparam db2omf.dtd \ + $(shell xmllint --format $(2) | grep -h PUBLIC | head -n 1 \ + | sed -e 's/.*PUBLIC \(\"[^\"]*\"\).*/\1/') \ + --stringparam db2omf.lang $(notdir $(patsubst %/$(notdir $(2)),%,$(2))) \ + --stringparam db2omf.omf_dir "$(OMF_DIR)" \ + --stringparam db2omf.help_dir "$(HELP_DIR)" \ + --stringparam db2omf.omf_in "$(_DOC_OMF_IN)" \ + $(if $(_ENABLE_SK), \ + --stringparam db2omf.scrollkeeper_cl "$(_skcontentslist)") \ + $(_db2omf) $(2) + +_DOC_OMF_IN = $(if $(DOC_MODULE),$(wildcard $(_DOC_ABS_SRCDIR)/$(DOC_MODULE).omf.in)) +_DOC_OMF_DB = $(if $(_DOC_OMF_IN), \ + $(foreach lc,C $(_DOC_REAL_LINGUAS),$(DOC_MODULE)-$(lc).omf)) + +_DOC_OMF_HTML = $(if $(_DOC_OMF_IN), \ + $(foreach lc,C $(_DOC_REAL_LINGUAS),$(DOC_MODULE)-html-$(lc).omf)) + + +# FIXME +_DOC_OMF_ALL = \ + $(if $(filter docbook,$(_DOC_REAL_FORMATS)),$(_DOC_OMF_DB)) \ + $(if $(filter html HTML,$(_DOC_REAL_FORMATS)),$(_DOC_OMF_HTML)) + + +################################################################################ +_DOC_C_MODULE = $(if $(DOC_MODULE),C/$(DOC_MODULE).xml) +_DOC_C_PAGES = $(foreach page,$(DOC_PAGES),C/$(page)) +_DOC_C_ENTITIES = $(foreach ent,$(DOC_ENTITIES),C/$(ent)) +_DOC_C_INCLUDES = $(foreach inc,$(DOC_INCLUDES),C/$(inc)) +_DOC_C_DOCS = \ + $(_DOC_C_ENTITIES) $(_DOC_C_INCLUDES) \ + $(_DOC_C_PAGES) $(_DOC_C_MODULE) + +_DOC_C_DOCS_NOENT = \ + $(_DOC_C_MODULE) $(_DOC_C_INCLUDES) \ + $(_DOC_C_PAGES) + +_DOC_C_FIGURES = $(if $(DOC_FIGURES), \ + $(foreach fig,$(DOC_FIGURES),C/$(fig)), \ + $(patsubst $(srcdir)/%,%,$(wildcard $(srcdir)/C/figures/*.png))) + + +# FIXME: probably have to shell escape to determine the file names +_DOC_C_HTML = $(foreach f, \ + $(shell xsltproc --xinclude \ + --stringparam db.chunk.basename "$(DOC_MODULE)" \ + $(_chunks) "C/$(DOC_MODULE).xml"), \ + C/$(f).xhtml) + + +############################################################################### +_DOC_POFILES = $(if $(DOC_MODULE)$(DOC_ID), \ + $(foreach lc,$(_DOC_REAL_LINGUAS),$(lc)/$(lc).po)) + +_DOC_MOFILES = $(patsubst %.po,%.mo,$(_DOC_POFILES)) +_DOC_LC_MODULES = $(if $(DOC_MODULE), \ + $(foreach lc,$(_DOC_REAL_LINGUAS),$(lc)/$(DOC_MODULE).xml)) + +_DOC_LC_PAGES = \ + $(foreach lc,$(_DOC_REAL_LINGUAS),$(foreach page,$(_DOC_C_PAGES), \ + $(lc)/$(notdir $(page)) )) + +_DOC_LC_INCLUDES = \ + $(foreach lc,$(_DOC_REAL_LINGUAS),$(foreach inc,$(_DOC_C_INCLUDES), \ + $(lc)/$(notdir $(inc)) )) + + +# FIXME: probably have to shell escape to determine the file names +_DOC_LC_HTML = \ + $(foreach lc,$(_DOC_REAL_LINGUAS),$(foreach doc,$(_DOC_C_HTML), \ + $(lc)/$(notdir $(doc)) )) + +_DOC_LC_DOCS = \ + $(_DOC_LC_MODULES) $(_DOC_LC_INCLUDES) $(_DOC_LC_PAGES) \ + $(if $(filter html HTML,$(_DOC_REAL_FORMATS)),$(_DOC_LC_HTML)) + +_DOC_LC_FIGURES = $(foreach lc,$(_DOC_REAL_LINGUAS), \ + $(patsubst C/%,$(lc)/%,$(_DOC_C_FIGURES)) ) + +_DOC_SRC_FIGURES = \ + $(foreach fig,$(_DOC_C_FIGURES), $(foreach lc,C $(_DOC_REAL_LINGUAS), \ + $(wildcard $(srcdir)/$(lc)/$(patsubst C/%,%,$(fig))) )) + +_DOC_POT = $(if $(DOC_MODULE),$(DOC_MODULE).pot) + +################################################################################ +_DOC_HTML_ALL = $(if $(filter html HTML,$(_DOC_REAL_FORMATS)), \ + $(_DOC_C_HTML) $(_DOC_LC_HTML)) + +_DOC_HTML_TOPS = $(foreach lc,C $(_DOC_REAL_LINGUAS),$(lc)/$(DOC_MODULE).xhtml) +_clean_omf = $(if $(_DOC_OMF_IN),clean-doc-omf) +_clean_dsk = $(if $(_DOC_DSK_IN),clean-doc-dsk) +_clean_lc = $(if $(_DOC_REAL_LINGUAS),clean-doc-lc) +_clean_dir = $(if $(DOC_MODULE)$(DOC_ID),clean-doc-dir) +_doc_install_dir = $(if $(DOC_ID),$(DOC_ID),$(DOC_MODULE)) + +# The name of the directory in /usr/share/mate/help/, +# and the name of the main .xml file: +DOC_MODULE = creating-marco-themes + +# The names of any files included via entity declarations. +DOC_ENTITIES = + +# The names of any files included by xincluded (preferred): +DOC_INCLUDES = + +# The names of any pictures: +DOC_FIGURES = + +# The names of any locales for which documentation translations exist: +DOC_LINGUAS = +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/mate-doc-utils.make $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/creating_themes/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/creating_themes/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$(top_distdir)" distdir="$(distdir)" \ + dist-hook +check-am: all-am +check: check-am +all-am: Makefile +installdirs: +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool clean-local mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-local + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-data-local + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic \ + maintainer-clean-local + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool \ + mostlyclean-local + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-local + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + clean-local dist-hook distclean distclean-generic \ + distclean-libtool distclean-local distdir dvi dvi-am html \ + html-am info info-am install install-am install-data \ + install-data-am install-data-local install-dvi install-dvi-am \ + install-exec install-exec-am install-html install-html-am \ + install-info install-info-am install-man install-pdf \ + install-pdf-am install-ps install-ps-am install-strip \ + installcheck installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic maintainer-clean-local mostlyclean \ + mostlyclean-generic mostlyclean-libtool mostlyclean-local pdf \ + pdf-am ps ps-am uninstall uninstall-am uninstall-local + + +DOC_H_FILE ?= + +DOC_H_DOCS ?= + +$(DOC_H_FILE): $(DOC_H_DOCS); + @rm -f [email protected]; touch [email protected]; + echo 'const gchar* documentation_credits[] = {' >> [email protected] + list='$(DOC_H_DOCS)'; for doc in $$list; do \ + xmlpath="`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`:$(srcdir)/`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`"; \ + if ! test -f "$$doc"; then doc="$(srcdir)/$$doc"; fi; \ + xsltproc --path "$$xmlpath" $(_credits) $$doc; \ + done | sort | uniq \ + | awk 'BEGIN{s=""}{n=split($$0,w,"<");if(s!=""&&s!=substr(w[1],1,length(w[1])-1)){print s};if(n>1){print $$0;s=""}else{s=$$0}};END{if(s!=""){print s}}' \ + | sed -e 's/\\/\\\\/' -e 's/"/\\"/' -e 's/\(.*\)/\t"\1",/' >> [email protected] + echo ' NULL' >> [email protected] + echo '};' >> [email protected] + echo >> [email protected] + list='$(DOC_H_DOCS)'; for doc in $$list; do \ + xmlpath="`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`:$(srcdir)/`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`"; \ + if ! test -f "$$doc"; then doc="$(srcdir)/$$doc"; fi; \ + docid=`echo "$$doc" | sed -e 's/.*\/\([^/]*\)\.xml/\1/' \ + | sed -e 's/[^a-zA-Z_]/_/g' | tr 'a-z' 'A-Z'`; \ + echo $$xmlpath; \ + ids=`xsltproc --xinclude --path "$$xmlpath" $(_ids) $$doc`; \ + for id in $$ids; do \ + echo '#define HELP_'`echo $$docid`'_'`echo $$id \ + | sed -e 's/[^a-zA-Z_]/_/g' | tr 'a-z' 'A-Z'`' "'$$id'"' >> [email protected]; \ + done; \ + echo >> [email protected]; \ + done; + cp [email protected] $@ && rm -f [email protected] + +dist-check-gdu: +@HAVE_MATE_DOC_UTILS_FALSE@ @echo "*** MATE Doc Utils must be installed in order to make dist" +@HAVE_MATE_DOC_UTILS_FALSE@ @false + +.PHONY: dist-doc-header +dist-doc-header: $(DOC_H_FILE) + @if test -f "$(DOC_H_FILE)"; then d=; else d="$(srcdir)/"; fi; \ + echo "$(INSTALL_DATA) $${d}$(DOC_H_FILE) $(distdir)/$(DOC_H_FILE)"; \ + $(INSTALL_DATA) "$${d}$(DOC_H_FILE)" "$(distdir)/$(DOC_H_FILE)"; + +doc-dist-hook: dist-check-gdu $(if $(DOC_H_FILE),dist-doc-header) + +.PHONY: clean-doc-header +clean-local: $(_clean_doc_header) +distclean-local: $(_clean_doc_header) +mostlyclean-local: $(_clean_doc_header) +maintainer-clean-local: $(_clean_doc_header) +clean-doc-header: + rm -f $(DOC_H_FILE) + +all: $(DOC_H_FILE) + +################################################################################ + +DOC_MODULE ?= + +DOC_ID ?= + +DOC_PAGES ?= + +DOC_ENTITIES ?= + +DOC_INCLUDES ?= + +DOC_FIGURES ?= + +DOC_FORMATS ?= docbook + +DOC_LINGUAS ?= + +################################################################################ + +_xml2po ?= `which xml2po` + +_db2html ?= `$(PKG_CONFIG) --variable db2html mate-doc-utils` +_db2omf ?= `$(PKG_CONFIG) --variable db2omf mate-doc-utils` +_malrng ?= `$(PKG_CONFIG) --variable malrng mate-doc-utils` +_chunks ?= `$(PKG_CONFIG) --variable xmldir mate-doc-utils`/mate/xslt/docbook/utils/chunks.xsl +_credits ?= `$(PKG_CONFIG) --variable xmldir mate-doc-utils`/mate/xslt/docbook/utils/credits.xsl +_ids ?= `$(PKG_CONFIG) --variable xmldir mate-doc-utils`/mate/xslt/docbook/utils/ids.xsl +@ENABLE_SK_TRUE@_skpkgdatadir ?= `scrollkeeper-config --pkgdatadir` +@ENABLE_SK_TRUE@_sklocalstatedir ?= `scrollkeeper-config --pkglocalstatedir` +@ENABLE_SK_TRUE@_skcontentslist ?= $(_skpkgdatadir)/Templates/C/scrollkeeper_cl.xml + +$(_DOC_OMF_DB) : $(_DOC_OMF_IN) +$(_DOC_OMF_DB) : $(DOC_MODULE)-%.omf : %/$(DOC_MODULE).xml + @test "x$(_ENABLE_SK)" != "xtrue" -o -f "$(_skcontentslist)" || { \ + echo "The file '$(_skcontentslist)' does not exist." >&2; \ + echo "Please check your ScrollKeeper installation." >&2; \ + exit 1; } + xsltproc -o $@ $(call db2omf_args,$@,$<,'docbook') || { rm -f "$@"; exit 1; } + +$(_DOC_OMF_HTML) : $(_DOC_OMF_IN) +$(_DOC_OMF_HTML) : $(DOC_MODULE)-html-%.omf : %/$(DOC_MODULE).xml +@ENABLE_SK_TRUE@ @test "x$(_ENABLE_SK)" != "xtrue" -o -f "$(_skcontentslist)" || { \ +@ENABLE_SK_TRUE@ echo "The file '$(_skcontentslist)' does not exist" >&2; \ +@ENABLE_SK_TRUE@ echo "Please check your ScrollKeeper installation." >&2; \ +@ENABLE_SK_TRUE@ exit 1; } + xsltproc -o $@ $(call db2omf_args,$@,$<,'xhtml') || { rm -f "$@"; exit 1; } + +.PHONY: omf +omf: $(_DOC_OMF_ALL) + +.PHONY: po +po: $(_DOC_POFILES) + +.PHONY: mo +mo: $(_DOC_MOFILES) + +$(_DOC_POFILES): + @if ! test -d $(dir $@); then \ + echo "mkdir $(dir $@)"; \ + mkdir "$(dir $@)"; \ + fi + @if test ! -f $@ -a -f $(srcdir)/$@; then \ + echo "cp $(srcdir)/$@ $@"; \ + cp "$(srcdir)/$@" "$@"; \ + fi; + @docs=; \ + list='$(_DOC_C_DOCS_NOENT)'; for doc in $$list; do \ + docs="$$docs $(_DOC_ABS_SRCDIR)/$$doc"; \ + done; \ + if ! test -f $@; then \ + echo "(cd $(dir $@) && \ + $(_xml2po) -m $(_xml2po_mode) -e $$docs > $(notdir $@).tmp && \ + cp $(notdir $@).tmp $(notdir $@) && rm -f $(notdir $@).tmp)"; \ + (cd $(dir $@) && \ + $(_xml2po) -m $(_xml2po_mode) -e $$docs > $(notdir $@).tmp && \ + cp $(notdir $@).tmp $(notdir $@) && rm -f $(notdir $@).tmp); \ + else \ + echo "(cd $(dir $@) && \ + $(_xml2po) -m $(_xml2po_mode) -e -u $(notdir $@) $$docs)"; \ + (cd $(dir $@) && \ + $(_xml2po) -m $(_xml2po_mode) -e -u $(notdir $@) $$docs); \ + fi + +$(_DOC_MOFILES): %.mo: %.po + @if ! test -d $(dir $@); then \ + echo "mkdir $(dir $@)"; \ + mkdir "$(dir $@)"; \ + fi + msgfmt -o $@ $< + +# FIXME: fix the dependancy +# FIXME: hook xml2po up +$(_DOC_LC_DOCS) : $(_DOC_MOFILES) +$(_DOC_LC_DOCS) : $(_DOC_C_DOCS) + if ! test -d $(dir $@); then mkdir $(dir $@); fi + if [ -f "C/$(notdir $@)" ]; then d="../"; else d="$(_DOC_ABS_SRCDIR)/"; fi; \ + mo="$(dir $@)$(patsubst %/$(notdir $@),%,$@).mo"; \ + if [ -f "$${mo}" ]; then mo="../$${mo}"; else mo="$(_DOC_ABS_SRCDIR)/$${mo}"; fi; \ + (cd $(dir $@) && \ + $(_xml2po) -m $(_xml2po_mode) -e -t "$${mo}" \ + "$${d}C/$(notdir $@)" > $(notdir $@).tmp && \ + cp $(notdir $@).tmp $(notdir $@) && rm -f $(notdir $@).tmp) +.PHONY: pot +pot: $(_DOC_POT) +$(_DOC_POT): $(_DOC_C_DOCS_NOENT) + $(_xml2po) -m $(_xml2po_mode) -e -o $@ $^ + +$(_DOC_HTML_TOPS): $(_DOC_C_DOCS) $(_DOC_LC_DOCS) + xsltproc -o $@ --xinclude --param db.chunk.chunk_top "false()" --stringparam db.chunk.basename "$(DOC_MODULE)" --stringparam db.chunk.extension ".xhtml" $(_db2html) $(patsubst %.xhtml,%.xml,$@) + +################################################################################ + +all: \ + $(_DOC_C_DOCS) $(_DOC_LC_DOCS) \ + $(_DOC_OMF_ALL) $(_DOC_DSK_ALL) \ + $(_DOC_HTML_ALL) $(_DOC_POFILES) + +################################################################################ + +.PHONY: clean-doc-omf clean-doc-dsk clean-doc-lc clean-doc-dir + +clean-doc-omf: ; rm -f $(_DOC_OMF_DB) $(_DOC_OMF_HTML) +clean-doc-dsk: ; rm -f $(_DOC_DSK_DB) $(_DOC_DSK_HTML) +clean-doc-lc: + rm -f $(_DOC_LC_DOCS) + rm -f $(_DOC_MOFILES) + @list='$(_DOC_POFILES)'; for po in $$list; do \ + if ! test "$$po" -ef "$(srcdir)/$$po"; then \ + echo "rm -f $$po"; \ + rm -f "$$po"; \ + fi; \ + done +# .xml2.po.mo cleaning is obsolete as of 0.18.1 and could be removed in 0.20.x + @for lc in C $(_DOC_REAL_LINGUAS); do \ + if test -f "$$lc/.xml2po.mo"; then \ + echo "rm -f $$lc/.xml2po.mo"; \ + rm -f "$$lc/.xml2po.mo"; \ + fi; \ + done +clean-doc-dir: clean-doc-lc + @for lc in C $(_DOC_REAL_LINGUAS); do \ + for dir in `find $$lc -depth -type d`; do \ + if ! test $$dir -ef $(srcdir)/$$dir; then \ + echo "rmdir $$dir"; \ + rmdir "$$dir"; \ + fi; \ + done; \ + done + +clean-local: \ + $(_clean_omf) $(_clean_dsk) \ + $(_clean_lc) $(_clean_dir) +distclean-local: \ + $(_clean_omf) $(_clean_dsk) \ + $(_clean_lc) $(_clean_dir) +mostlyclean-local: \ + $(_clean_omf) $(_clean_dsk) \ + $(_clean_lc) $(_clean_dir) +maintainer-clean-local: \ + $(_clean_omf) $(_clean_dsk) \ + $(_clean_lc) $(_clean_dir) + +################################################################################ + +.PHONY: dist-doc-docs dist-doc-pages dist-doc-figs dist-doc-omf dist-doc-dsk +doc-dist-hook: \ + $(if $(DOC_MODULE)$(DOC_ID),dist-doc-docs) \ + $(if $(_DOC_C_FIGURES),dist-doc-figs) \ + $(if $(_DOC_OMF_IN),dist-doc-omf) +# $(if $(_DOC_DSK_IN),dist-doc-dsk) + +dist-doc-docs: $(_DOC_C_DOCS) $(_DOC_LC_DOCS) $(_DOC_POFILES) + @for lc in C $(_DOC_REAL_LINGUAS); do \ + echo " $(mkinstalldirs) $(distdir)/$$lc"; \ + $(mkinstalldirs) "$(distdir)/$$lc"; \ + done + @list='$(_DOC_C_DOCS) $(_DOC_LC_DOCS) $(_DOC_POFILES)'; \ + for doc in $$list; do \ + if test -f "$$doc"; then d=; else d="$(srcdir)/"; fi; \ + docdir=`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`; \ + if ! test -d "$(distdir)/$$docdir"; then \ + echo "$(mkinstalldirs) $(distdir)/$$docdir"; \ + $(mkinstalldirs) "$(distdir)/$$docdir"; \ + fi; \ + echo "$(INSTALL_DATA) $$d$$doc $(distdir)/$$doc"; \ + $(INSTALL_DATA) "$$d$$doc" "$(distdir)/$$doc"; \ + done + +dist-doc-figs: $(_DOC_SRC_FIGURES) + @list='$(_DOC_C_FIGURES) $(_DOC_LC_FIGURES)'; \ + for fig in $$list; do \ + if test -f "$$fig"; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$fig"; then \ + figdir=`echo $$fig | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`; \ + if ! test -d "$(distdir)/$$figdir"; then \ + echo "$(mkinstalldirs) $(distdir)/$$figdir"; \ + $(mkinstalldirs) "$(distdir)/$$figdir"; \ + fi; \ + echo "$(INSTALL_DATA) $$d$$fig $(distdir)/$$fig"; \ + $(INSTALL_DATA) "$$d$$fig" "$(distdir)/$$fig"; \ + fi; \ + done; + +dist-doc-omf: + @if test -f "$(_DOC_OMF_IN)"; then d=; else d="$(srcdir)/"; fi; \ + echo "$(INSTALL_DATA) $$d$(_DOC_OMF_IN) $(distdir)/$(notdir $(_DOC_OMF_IN))"; \ + $(INSTALL_DATA) "$$d$(_DOC_OMF_IN)" "$(distdir)/$(notdir $(_DOC_OMF_IN))" + +dist-doc-dsk: + @if test -f "$(_DOC_DSK_IN)"; then d=; else d="$(srcdir)/"; fi; \ + echo "$(INSTALL_DATA) $$d$(_DOC_DSK_IN) $(distdir)/$(notdir $(_DOC_DSK_IN))"; \ + $(INSTALL_DATA) "$$d$(_DOC_DSK_IN)" "$(distdir)/$(notdir $(_DOC_DSK_IN))" + +################################################################################ + +.PHONY: check-doc-docs check-doc-omf +check: \ + $(if $(DOC_MODULE),check-doc-docs) \ + $(if $(DOC_ID),check-doc-pages) \ + $(if $(_DOC_OMF_IN),check-doc-omf) + +check-doc-docs: $(_DOC_C_DOCS) $(_DOC_LC_DOCS) + @for lc in C $(_DOC_REAL_LINGUAS); do \ + if test -f "$$lc"; \ + then d=; \ + xmlpath="$$lc"; \ + else \ + d="$(srcdir)/"; \ + xmlpath="$$lc:$(srcdir)/$$lc"; \ + fi; \ + echo "xmllint --noout --noent --path $$xmlpath --xinclude --postvalid $$d$$lc/$(DOC_MODULE).xml"; \ + xmllint --noout --noent --path "$$xmlpath" --xinclude --postvalid "$$d$$lc/$(DOC_MODULE).xml"; \ + done + +check-doc-pages: $(_DOC_C_PAGES) $(_DOC_LC_PAGES) + for lc in C $(_DOC_REAL_LINGUAS); do \ + if test -f "$$lc"; \ + then d=; \ + xmlpath="$$lc"; \ + else \ + d="$(srcdir)/"; \ + xmlpath="$$lc:$(srcdir)/$$lc"; \ + fi; \ + for page in $(DOC_PAGES); do \ + echo "xmllint --noout --noent --path $$xmlpath --xinclude --relaxng $(_malrng) $$d$$lc/$$page"; \ + xmllint --noout --noent --path "$$xmlpath" --xinclude --relaxng "$(_malrng)" "$$d$$lc/$$page"; \ + done; \ + done + +check-doc-omf: $(_DOC_OMF_ALL) + @list='$(_DOC_OMF_ALL)'; for omf in $$list; do \ + echo "xmllint --noout --xinclude --dtdvalid 'http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd' $$omf"; \ + xmllint --noout --xinclude --dtdvalid 'http://scrollkeeper.sourceforge.net/dtds/scrollkeeper-omf-1.0/scrollkeeper-omf.dtd' $$omf; \ + done + +################################################################################ + +.PHONY: install-doc-docs install-doc-html install-doc-figs install-doc-omf install-doc-dsk + +install-data-local: \ + $(if $(DOC_MODULE)$(DOC_ID),install-doc-docs) \ + $(if $(_DOC_HTML_ALL),install-doc-html) \ + $(if $(_DOC_C_FIGURES),install-doc-figs) \ + $(if $(_DOC_OMF_IN),install-doc-omf) +# $(if $(_DOC_DSK_IN),install-doc-dsk) + +install-doc-docs: + @for lc in C $(_DOC_REAL_LINGUAS); do \ + echo "$(mkinstalldirs) $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$lc"; \ + $(mkinstalldirs) $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$lc; \ + done + @list='$(_DOC_C_DOCS) $(_DOC_LC_DOCS)'; for doc in $$list; do \ + if test -f "$$doc"; then d=; else d="$(srcdir)/"; fi; \ + docdir="$$lc/"`echo $$doc | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`; \ + docdir="$(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$docdir"; \ + if ! test -d "$$docdir"; then \ + echo "$(mkinstalldirs) $$docdir"; \ + $(mkinstalldirs) "$$docdir"; \ + fi; \ + echo "$(INSTALL_DATA) $$d$$doc $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$doc"; \ + $(INSTALL_DATA) $$d$$doc $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$doc; \ + done + +install-doc-figs: + @list='$(patsubst C/%,%,$(_DOC_C_FIGURES))'; for fig in $$list; do \ + for lc in C $(_DOC_REAL_LINGUAS); do \ + figsymlink=false; \ + if test -f "$$lc/$$fig"; then \ + figfile="$$lc/$$fig"; \ + elif test -f "$(srcdir)/$$lc/$$fig"; then \ + figfile="$(srcdir)/$$lc/$$fig"; \ + else \ + figsymlink=true; \ + fi; \ + figdir="$$lc/"`echo $$fig | sed -e 's/^\(.*\/\).*/\1/' -e '/\//!s/.*//'`; \ + figdir="$(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$figdir"; \ + if ! test -d "$$figdir"; then \ + echo "$(mkinstalldirs) $$figdir"; \ + $(mkinstalldirs) "$$figdir"; \ + fi; \ + figbase=`echo $$fig | sed -e 's/^.*\///'`; \ + if $$figsymlink; then \ + echo "cd $$figdir && $(LN_S) -f ../../C/$$fig $$figbase"; \ + ( cd "$$figdir" && $(LN_S) -f "../../C/$$fig" "$$figbase" ); \ + else \ + echo "$(INSTALL_DATA) $$figfile $$figdir$$figbase"; \ + $(INSTALL_DATA) "$$figfile" "$$figdir$$figbase"; \ + fi; \ + done; \ + done + +install-doc-html: + echo install-html + +install-doc-omf: + $(mkinstalldirs) $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir) + @list='$(_DOC_OMF_ALL)'; for omf in $$list; do \ + echo "$(INSTALL_DATA) $$omf $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf"; \ + $(INSTALL_DATA) $$omf $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf; \ + done + @if test "x$(_ENABLE_SK)" = "xtrue"; then \ + echo "scrollkeeper-update -p $(DESTDIR)$(_sklocalstatedir) -o $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)"; \ + scrollkeeper-update -p "$(DESTDIR)$(_sklocalstatedir)" -o "$(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)"; \ + fi; + +install-doc-dsk: + echo install-dsk + +################################################################################ + +.PHONY: uninstall-doc-docs uninstall-doc-html uninstall-doc-figs uninstall-doc-omf uninstall-doc-dsk +uninstall-local: \ + $(if $(DOC_MODULE)$(DOC_ID),uninstall-doc-docs) \ + $(if $(_DOC_HTML_ALL),uninstall-doc-html) \ + $(if $(_DOC_C_FIGURES),uninstall-doc-figs) \ + $(if $(_DOC_OMF_IN),uninstall-doc-omf) +# $(if $(_DOC_DSK_IN),uninstall-doc-dsk) + +uninstall-doc-docs: + @list='$(_DOC_C_DOCS) $(_DOC_LC_DOCS)'; for doc in $$list; do \ + echo " rm -f $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$doc"; \ + rm -f "$(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$doc"; \ + done + +uninstall-doc-figs: + @list='$(_DOC_C_FIGURES) $(_DOC_LC_FIGURES)'; for fig in $$list; do \ + echo "rm -f $(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$fig"; \ + rm -f "$(DESTDIR)$(HELP_DIR)/$(_doc_install_dir)/$$fig"; \ + done; + +uninstall-doc-omf: + @list='$(_DOC_OMF_ALL)'; for omf in $$list; do \ + if test "x$(_ENABLE_SK)" = "xtrue"; then \ + echo "scrollkeeper-uninstall -p $(_sklocalstatedir) $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf"; \ + scrollkeeper-uninstall -p "$(_sklocalstatedir)" "$(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf"; \ + fi; \ + echo "rm -f $(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf"; \ + rm -f "$(DESTDIR)$(OMF_DIR)/$(_doc_install_dir)/$$omf"; \ + done + +# mate-doc-utils standard variables: +dist-hook: doc-dist-hook + +# 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/dialogs.txt b/doc/dialogs.txt new file mode 100644 index 00000000..1a28e6ab --- /dev/null +++ b/doc/dialogs.txt @@ -0,0 +1,32 @@ +Dialogs which have no transient parent or root window being +their tranisent parent are the ones which will be visible in +the tasklist. + +All such dialogs will be *always* on top of the window +group i.e they would transients for the whole group. + + +1) Modal dialogs + + + * If you wish to open another window from a modal dialog + + open *only* a modal dialog and set it's transient parent. + + +2) Normal dialog + + + without transient parent + + * If you wish to open another window from a normal dialog + + open either a normal dialog or a modal dialog only. + Set the transient parent for the child dialog if you do not + want them to be transient for all the other windows in the group. + + with transient parent + + * If you wish to open another window from a normal dialog + + you could open any type of window. diff --git a/doc/how-to-get-focus-right.txt b/doc/how-to-get-focus-right.txt new file mode 100644 index 00000000..45c0f378 --- /dev/null +++ b/doc/how-to-get-focus-right.txt @@ -0,0 +1,253 @@ +To make choice of focus window consistent for each focus method, a +number of guidelines should be followed. (For purposes of discussion +here, I'm excluding things like the panel and the desktop from +"windows". It is technically incorrect to do this, but I'm lazy and +"windows" is shorter than something like "normal windows". See the +end of the discussion for how these special cases are handled.) The +basics are easy: + +Focus method Behavior + click When a user clicks on a window, focus it + sloppy When an EnterNotify is received, focus the window + mouse Same as sloppy, but also defocus when mouse enters DESKTOP + window + +Note that these choices (along with the choice that clicking on a +window raises it for the click focus method) introduces the following +invariants for focus from mouse activity: + +Focus method Invariant + click The window on top is focused + sloppy If the mouse is in a window, then it is focused; if the + mouse is not in a window, then the most recently used + window is focused. + mouse If the mouse is in a non-DESKTOP window, then it is focused; + otherwise, the designated "no_focus_window" is focused + +However, there are a number of cases where the current focus window +becomes invalid and another should be chosen. Some examples are when +a focused window is closed or minimized, or when the user changes +workspaces. In these cases, there needs to be a rule consistent with +the above about the new window to choose. + +Focus method Behavior + click Focus the most recently used window (same as the window + on top) + sloppy Focus the window containing the pointer if there is such + a window, otherwise focus the most recently used window. + mouse Focus the non-DESKTOP window containing the pointer if + there is one, otherwise focus the designated + "no_focus_window". + +Note that "most recently used window", as used here, has a slightly +different connotation than "most recent to have keyboard focus". This +is because when a user activates a window that is a transient, its +ancestor(s) should be considered to be more recently used than other +windows that have had the keyboard focus more recently. (See bug +157360; this may mean that the alt-tab order should also change +simultaneously, although the current implementation does not do that.) + +Also, sometimes a new window will be mapped (e.g. unminimizing a +window or launching a new application). Most users want to interact +with new windows right away, so these should typically be focused. +This does conflict with the invariants for sloppy and mouse focus +modes, so this wouldn't be true for a strict-pointer-focus mode. For +all other modes (non-strict-pointer-focus modes), there are only two +cases in which a new window shouldn't be focused: + + 1) If the window takes a while to launch and the user starts + interacting with a different application, the new window should + not take focus. + 2) If the window that will appear was not launched by the user + (error dialogs, instant messaging windows, etc.), then the window + should not take focus when it appears. + +To handle these cases, Marco compares timestamps of the event that +caused the launch and the timestamp of the last interaction with the +focused window. (Case 2 is handled by the application providing a +special timestamp of 0 for the launch time, which ensures that the +window that appears doesn't get focus) + +If the newly launched window isn't focused, some things should be done +to alert the user that there is a window to work with: + 1) The _NET_WM_DEMANDS_ATTENTION hint should be set + 2) If the new window isn't modal for the focused window, it should + appear below the focused window so that it doesn't obscure the + focused window that the user is interacting with. + 3) If the new window is modal to the focused window, the currently + focused window should lose focus but the modal window should + appear on top. + +Additionally, the user may decide to use the keyboard instead of the mouse +to navigate between windows (referred to as "keynav"). This poses no +problems for click-to-focus (because the same invariant can be +maintained), but for sloppy and mouse focus it requires extra work to +attempt to handle the INHERENTLY CONFLICTING CONSTRAINTS. Marco does +this by having a mouse_mode boolean used to determine which of the two +sets of invariants holds. This mode is set according to which method was +most recently used to choose a focus window: + 1) When receiving EnterNotify events from mouse movement, set + mouse_mode to TRUE. + 2) When using keynav to choose a focus window (e.g. alt-tab, alt-esc, + alt-f2, move-window-to-workspace keybindings), set mouse_mode to FALSE. + 3) When handling events that don't choose a focus window but rather need + a focus_window chosen for them (e.g. switch-to-workspace keybindings), + don't change the mouse_mode and just use the current value. +Note that grabs present a special case since they can generate EnterNotify +and LeaveNotify events without using the mouse, thus these events should be +ignored when the crossing mode is NotifyGrab or NotifyUngrab. THIS +MOUSENAV/KEYNAV MODERATION METHOD IS NOT PERFECT--there are corner cases +when trying to mix-and-match between mousenav and keynav simultaneously +that cause problems; but it appears to be the most reasonable tradeoff and +works well in most cases, especially if the user sticks to just mousenav +for a long time or just keynav for a long time. + +Finally, windows of type WM_DOCK or WM_DESKTOP (e.g. the desktop and +the panel) present a special case, at least partially due to the lack +of decorations. For WM_DESKTOP windows, we only focus them if the +user explicitly requests it (e.g. clicks on the window, uses +Ctrl-Alt-Tab to navigate to it, uses a keybinding to show the desktop, +etc.). For WM_DOCK windows, we do not focus unless we receive a very +explicit request (e.g. Ctrl-Alt-Tab or a _NET_ACTIVE_WINDOW message; +not normal clicks). + + + + +To read more about the bugs that inspired these choices: + - When a focused window becomes invalid and another should be chosen + http://bugzilla.gnome.org/show_bug.cgi?id=135810 + - When a new window is mapped + http://bugzilla.gnome.org/show_bug.cgi?id=118372 + Also, the EWMH spec, especially the parts relating to _NET_WM_USER_TIME + - Modal vs. non-modal dialogs that get denied focus when mapped + http://bugzilla.gnome.org/show_bug.cgi?id=151996 + - Mousenav vs. Keynav in mouse and sloppy focus modes + http://bugzilla.gnome.org/show_bug.cgi?id=167545 + http://bugzilla.gnome.org/show_bug.cgi?id=101190 + http://bugzilla.gnome.org/show_bug.cgi?id=357695 + - Not focusing panels + http://bugzilla.gnome.org/show_bug.cgi?id=160470 + http://bugzilla.gnome.org/show_bug.cgi?id=120100 + +There were many bugs which had to be fixed to get all the above +working; they helped form these policies and/or show the difficulties +in implementing this policy (my apologies in advance for producing a +list heavily lopsided to what I've done; it's just that these bugs are +the ones I'm the most familiar with): + bug 72314 ignore LeaveNotify events from grabs + bug 82921 focus windows on map + bug 87531 only show focus for sticky windows on active workspace (pager) + bug 94545 focus window on workspace switch is non-deterministic + bug 95747 should ignore EnterNotify events with NotifyInferior detail set + bug 97635 sticky windows always keep focus when switching workspaces + bug 102665 a window unminimized from the tasklist should be focused + bug 107347 focus windows that manually position themselves too + bug 108643 focus in MRU order instead of stack order + bug 110970 moving a window to another workspace loses focus + bug 112031 closing a dialog can result in a strange focus window + bug 115650 add _NET_WM_USER_TIME support to gtk+ (see also 150502) + bug 120100 panel shouldn't be focused after workspace applet usage + bug 123803 need final EnterNotify after workspace switch (see also 124798) + bug 124981 focus clicked window in pager only if on current workspace + bug 125492 catch the xserver unfocusing everything and fix its braindeadedness + bug 128200 focus correct window on libwnck window minimize (see 107681 too) + bug 131582 fix race condition on window minimize/close + bug 133120 wrong window focused when changing workspaces + bug 135024 _NET_ACTIVE_WINDOW messages need timestamps + bug 135786 middle-clicking on focused window to lower it should defocus too + bug 136581 window minimization vs. activation for mouse focus + bug 144900 fix focus choice on "un-showing" the desktop + bug 147475 don't lock keyboard on workspace change + bug 148364 DEMANDS_ATTENTION support for marco & libwnck (and other stuff) + bug 149028 focus-stealing-prevention for marco-dialog (and other stuff) + bug 149366 windows denied focus on map occur in wrong order in alt-tab list + bug 149543 consistent focus window when unshowing desktop + bug 149589 race in focus choice from libwnck messages + bug 150271 make sure "run application" dialog gets focused + bug 150668 update gtk+ _NET_ACTIVE_WINDOW support + bug 151245 application startup notification forwarding (partially rejected) + bug 151984 Soeren's idea--backup timestamp when startup notification not used + bug 151990 prevent focus inconsistencies by only providing one focus method + bug 151996 modal dialogs denied focus should not be lowered + bug 152000 fix race on window close followed by rapid mouse movement + bug 152004 ways to handle new window versus mouse invariants + bug 153220 catch the root window getting focus and reset to default window + bug 157360 focus parents of dismissed transient windows in preference to + the window that most recently had focus + bug 159257 focus the desktop when showing it + bug 160470 don't focus panels on click + bug 163450 correct highlighting in workspace switcher popup + bug 164716 refuse to focus a window with a modal transient, and focus + the transient instead + bug 166524 avoid new windows being obscured by the focus window + bug 167545 mousenav vs. keynav in mouse and sloppy focus modes + <a massive heap of bugs relating to focus stealing prevention...> + + +Addendum on sloppy and mouse focus + You may occasionally hear people refer to sloppy or mouse focus + modes as inherently buggy. This is what they mean by that: + + 1) Keynav doesn't maintain the same invariants as mouse navigation + for these focus modes; switching back and forth between + navigation methods, therefore, may have or appear to have + inconsistencies. Examples: + a) If the user uses Alt-Tab to change the window with focus, then + starts to move the mouse, at that moment the window where the + mouse is does not have focus. + b) Users expect that a workspace they previously used will not + change when the return to it. This means things like window + position and stacking order, but also the focus window. + Unfortunately, using the original focus window (which would be + the most recently used window on that workspace) will + sometimes conflict with the invariants for mouse and sloppy + focus modes. Users are much more surprised by the invariant + being broken than by having the focus window changed (see bug + 94545 and probably others), so we maintain the invariant. + This only matters when using Ctrl-Alt-Arrow to switch + workspaces instead of clicking in the workspace switcher, so + this really is a keynav vs mouse issue. Either that, or a + windows-are-being-mapped exception. ;-) + c) Opening a menu, then moving the mouse to a different window, + and then pressing escape to dismiss the menu will result in + the window containing the mouse not being focused. This is + actually correct behavior (because pressing escape shows that + the user is using key navigation to interact with the window + containing the menu) but is one of those hard-to-get-right + keynav and mouse focus mixture cases. (See bug 101190 for + more details) + d) Similar to (c), moving the mouse off the menu doesn't immediately + focus the window that the mouse goes over, due to an application + grab (we couldn't change this and wouldn't want to, but + technically it does break the invariant). + e) If mouse_mode is off and the user does something to cause focus to + change (e.g. switch workspaces, close or minimize a window, etc.) + and simultaneously tries to move the mouse, the choice of which + window to focus is inherently race-y. (You probably can't satisfy + both keynav and mousenav invariants simultaneously...) + 2) The sloppy/mouse invariants are often not strictly maintained; + for example, we provide an exception to the invariant for newly + mapped windows. (Most find that not allowing this exception is + confusing) + 3) There are an awful lot of little cases to handle to get any focus + mode right, even for click-to-focus. Since mouse and sloppy + focus have sometimes been hard to even determine what correct + behavior is, it is much harder to get them completely right. + Plus mouse and sloppy focus users are a minority, decreasing the + motivation of window manager implementors to get those focus + modes right. + 4) Because of -1-, -2-, and -3-, implementations are often buggy or + inconsistent and people form their opinions from usage of these + implementations. + 5) Sloppy focus suffers from a bit of a discoverability problem (for + example, I have seen a scientist sit down to a computer for which + sloppy focus was in use and take a few minutes before figuring + out how window activation worked; granted the layout of the + windows in that situation was a bit unusual but it still + illustrates that sloppy focus is harder than it should be to + figure out). Mouse focus solves this problem; however, people + that have experience with other computing environments are + accustomed to being able to move their mouse outside the window + they are working with and still continue interacting with that + window, which conflicts with mouse focus. diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am new file mode 100644 index 00000000..cca52d5c --- /dev/null +++ b/doc/man/Makefile.am @@ -0,0 +1,4 @@ +man_MANS = marco.1 marco-theme-viewer.1 \ + marco-window-demo.1 marco-message.1 + +EXTRA_DIST = $(man_MANS) diff --git a/doc/man/Makefile.in b/doc/man/Makefile.in new file mode 100644 index 00000000..797b06f7 --- /dev/null +++ b/doc/man/Makefile.in @@ -0,0 +1,489 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = doc/man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +SOURCES = +DIST_SOURCES = +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 = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +man1dir = $(mandir)/man1 +am__installdirs = "$(DESTDIR)$(man1dir)" +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ACLOCAL_AMFLAGS = @ACLOCAL_AMFLAGS@ +ALL_CFLAGS = @ALL_CFLAGS@ +ALL_LIBS = @ALL_LIBS@ +ALL_LINGUAS = @ALL_LINGUAS@ +AMTAR = @AMTAR@ +AR = @AR@ +AS = @AS@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CATALOGS = @CATALOGS@ +CATOBJEXT = @CATOBJEXT@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DATADIRNAME = @DATADIRNAME@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DISTCHECK_CONFIGURE_FLAGS = @DISTCHECK_CONFIGURE_FLAGS@ +DLLTOOL = @DLLTOOL@ +DOC_USER_FORMATS = @DOC_USER_FORMATS@ +DSYMUTIL = @DSYMUTIL@ +DUMPBIN = @DUMPBIN@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +FGREP = @FGREP@ +GDK_PIXBUF_CSOURCE = @GDK_PIXBUF_CSOURCE@ +GETTEXT_PACKAGE = @GETTEXT_PACKAGE@ +GMOFILES = @GMOFILES@ +GMSGFMT = @GMSGFMT@ +GREP = @GREP@ +GTK_API_VERSION = @GTK_API_VERSION@ +HELP_DIR = @HELP_DIR@ +HOST_ALIAS = @HOST_ALIAS@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +INSTOBJEXT = @INSTOBJEXT@ +INTLLIBS = @INTLLIBS@ +INTLTOOL_EXTRACT = @INTLTOOL_EXTRACT@ +INTLTOOL_MERGE = @INTLTOOL_MERGE@ +INTLTOOL_PERL = @INTLTOOL_PERL@ +INTLTOOL_UPDATE = @INTLTOOL_UPDATE@ +LD = @LD@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIBTOOL = @LIBTOOL@ +LIPO = @LIPO@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAKEINFO = @MAKEINFO@ +MANIFEST_TOOL = @MANIFEST_TOOL@ +MARCO_CFLAGS = @MARCO_CFLAGS@ +MARCO_LIBS = @MARCO_LIBS@ +MARCO_MESSAGE_CFLAGS = @MARCO_MESSAGE_CFLAGS@ +MARCO_MESSAGE_LIBS = @MARCO_MESSAGE_LIBS@ +MARCO_WINDOW_DEMO_CFLAGS = @MARCO_WINDOW_DEMO_CFLAGS@ +MARCO_WINDOW_DEMO_LIBS = @MARCO_WINDOW_DEMO_LIBS@ +MATECONFTOOL = @MATECONFTOOL@ +MATECONF_SCHEMA_CONFIG_SOURCE = @MATECONF_SCHEMA_CONFIG_SOURCE@ +MATECONF_SCHEMA_FILE_DIR = @MATECONF_SCHEMA_FILE_DIR@ +MATEDIALOG = @MATEDIALOG@ +MATE_KEYBINDINGS_KEYSDIR = @MATE_KEYBINDINGS_KEYSDIR@ +MKDIR_P = @MKDIR_P@ +MKINSTALLDIRS = @MKINSTALLDIRS@ +MSGFMT = @MSGFMT@ +MSGFMT_OPTS = @MSGFMT_OPTS@ +MSGMERGE = @MSGMERGE@ +NM = @NM@ +NMEDIT = @NMEDIT@ +OBJDUMP = @OBJDUMP@ +OBJEXT = @OBJEXT@ +OMF_DIR = @OMF_DIR@ +OTOOL = @OTOOL@ +OTOOL64 = @OTOOL64@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +POFILES = @POFILES@ +POSUB = @POSUB@ +PO_IN_DATADIR_FALSE = @PO_IN_DATADIR_FALSE@ +PO_IN_DATADIR_TRUE = @PO_IN_DATADIR_TRUE@ +RANLIB = @RANLIB@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_NLS = @USE_NLS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMKMF = @XMKMF@ +X_CFLAGS = @X_CFLAGS@ +X_EXTRA_LIBS = @X_EXTRA_LIBS@ +X_LIBS = @X_LIBS@ +X_PRE_LIBS = @X_PRE_LIBS@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_AR = @ac_ct_AR@ +ac_ct_CC = @ac_ct_CC@ +ac_ct_DUMPBIN = @ac_ct_DUMPBIN@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +man_MANS = marco.1 marco-theme-viewer.1 \ + marco-window-demo.1 marco-message.1 + +EXTRA_DIST = $(man_MANS) +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/man/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu doc/man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): + +mostlyclean-libtool: + -rm -f *.lo + +clean-libtool: + -rm -rf .libs _libs +install-man1: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" + @list=''; test -n "$(man1dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically \`make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(MANS) +installdirs: + for dir in "$(DESTDIR)$(man1dir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic clean-libtool mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-man + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: install-man1 + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic mostlyclean-libtool + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-man + +uninstall-man: uninstall-man1 + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic clean-libtool \ + distclean distclean-generic distclean-libtool distdir dvi \ + dvi-am html html-am info info-am install install-am \ + install-data install-data-am install-dvi install-dvi-am \ + install-exec install-exec-am install-html install-html-am \ + install-info install-info-am install-man install-man1 \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \ + uninstall uninstall-am uninstall-man uninstall-man1 + + +# 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/man/marco-message.1 b/doc/man/marco-message.1 new file mode 100644 index 00000000..62e7a36f --- /dev/null +++ b/doc/man/marco-message.1 @@ -0,0 +1,60 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.\" ----- +.\" This file was confirmed to be licenced under the GPL +.\" by its author and copyright holder, Akira TAGOH, on June 1st 2008: +.\" +.\" > I'm comfortable with DFSG-free. that sounds great if you think it's +.\" > useful and worth containing it in upstream. +.\" ... +.\" > Right I know. any licenses that is DFSG-free, I'm ok with whatever, +.\" > since I have contributed that for Debian. so GPL is no problem for me. +.\" ----- +.TH MARCO\-MESSAGE 1 "28 August 2002" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +MARCO\-MESSAGE \- a command to send a message to Marco +.SH SYNOPSIS +.B MARCO\-MESSAGE +[restart|reload\-theme|enable\-keybindings|disable\-keybindings] +.SH DESCRIPTION +This manual page documents briefly the +.B marco\-message\fP. +This manual page was written for the Debian distribution +because the original program does not have a manual page. +.PP +.\" TeX users may be more comfortable with the \fB<whatever>\fP and +.\" \fI<whatever>\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBmarco\-message\fP send a specified message to \fBmarco\fP(1). +.SH OPTIONS +.TP +.B restart +Restart \fBmarco\fP(1) which is running. +.TP +.B reload-theme +Reload a theme which is specified on mateconf database. +.TP +.B enable-keybindings +Enable all of keybindings which is specified on mateconf database. +.TP +.B disable-keybindings +Disable all of keybindings which is specified on mateconf database. +.SH SEE ALSO +.BR marco (1) +.SH AUTHOR +This manual page was written by Akira TAGOH <[email protected]>, +for the Debian GNU/Linux system (but may be used by others). diff --git a/doc/man/marco-theme-viewer.1 b/doc/man/marco-theme-viewer.1 new file mode 100644 index 00000000..6aafabda --- /dev/null +++ b/doc/man/marco-theme-viewer.1 @@ -0,0 +1,43 @@ +.\" In .TH, FOO should be all caps, SECTION should be 1-8, maybe w/ subsection +.\" other parms are allowed: see man(7), man(1) +.\" +.\" Based on template provided by Tom Christiansen <[email protected]>. +.\" +.TH MARCO-THEME-VIEWER 1 "1 June 2004" +.SH NAME +marco-theme-viewer \- view marco themes +.SH SYNOPSIS +.B marco-theme-viewer +[ +.I THEMENAME +] +.SH DESCRIPTION +.\" Putting a newline after each sentence can generate better output. +.B marco-theme-viewer +allows you to preview any installed Marco theme. +.PP +When designing a new Marco theme, you can use +.B marco-theme-viewer +to measure the performance of a window frame option, and to preview +the option. +.SH OPTIONS +.TP +.I THEMENAME +Name of the theme to be shown (\fIAtlanta\fR by default). +It is case-sensitive. +.SH FILES +.br +.nf +.TP +.I /usr/share/themes +system themes directory +.TP +.I /usr/share/themes/*/marco-1/marco-theme-1.xml +theme specification file +.SH AUTHOR +This manual page was written by Jose M. Moya <[email protected]>, for +the Debian GNU/Linux system (but may be used by others). +.SH "SEE ALSO" +.\" Always quote multiple words for .SH +.BR marco (1), +.BR marco-window-demo (1). diff --git a/doc/man/marco-window-demo.1 b/doc/man/marco-window-demo.1 new file mode 100644 index 00000000..268cb9a4 --- /dev/null +++ b/doc/man/marco-window-demo.1 @@ -0,0 +1,25 @@ +.\" In .TH, FOO should be all caps, SECTION should be 1-8, maybe w/ subsection +.\" other parms are allowed: see man(7), man(1) +.\" +.\" Based on template provided by Tom Christiansen <[email protected]>. +.\" +.TH MARCO-WINDOW-DEMO 1 "1 June 2004" +.SH NAME +marco-window-demo \- demo of window features +.SH SYNOPSIS +.B marco-window-demo +.SH DESCRIPTION +.\" Putting a newline after each sentence can generate better output. +This program demonstrates various kinds of windows that window +managers and window manager themes should handle. +.PP +Be sure to tear off the menu and toolbar, those are also a special +kind of window. +.SH AUTHOR +This manual page was written by Jose M. Moya <[email protected]>, for +the Debian GNU/Linux system (but may be used by others). +.SH "SEE ALSO" +.\" Always quote multiple words for .SH +.BR x-window-manager (1), +.BR marco (1), +.BR marco-theme-viewer (1). diff --git a/doc/man/marco.1 b/doc/man/marco.1 new file mode 100644 index 00000000..793893ba --- /dev/null +++ b/doc/man/marco.1 @@ -0,0 +1,60 @@ +.\" Hey, EMACS: -*- nroff -*- +.\" First parameter, NAME, should be all caps +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection +.\" other parameters are allowed: see man(7), man(1) +.TH MARCO 1 "11 February 2006" +.\" Please adjust this date whenever revising the manpage. +.\" +.\" Some roff macros, for reference: +.\" .nh disable hyphenation +.\" .hy enable hyphenation +.\" .ad l left justify +.\" .ad b justify to both left and right margins +.\" .nf disable filling +.\" .fi enable filling +.\" .br insert line break +.\" .sp <n> insert n+1 empty lines +.\" for manpage-specific macros, see man(7) +.SH NAME +MARCO \- minimal GTK2 Window Manager +.SH SYNOPSIS +.B marco +[\-\-display=\fIDISPLAY\fP] [\-\-replace] [\-\-sm\-client\-id=\fIID\fP] [\-\-sm\-disable] [\-\-sm\-save\-file=\fIFILENAME\fP] [\-\-version] [\-\-help] +.SH DESCRIPTION +This manual page documents briefly +.B marco\fP. +.PP +.\" TeX users may be more comfortable with the \fB<whatever>\fP and +.\" \fI<whatever>\fP escape sequences to invode bold face and italics, +.\" respectively. +\fBmarco\fP is a minimal X window manager aimed at nontechnical users and is designed to integrate well with the MATE desktop. \fBmarco\fP lacks some features that may be expected by traditional UNIX or other technical users; these users may want to investigate other available window managers for use with MATE or standalone. +.SH OPTIONS +.TP +.B \-\-display=DISPLAY +Connect to X display \fIDISPLAY\fP. +.TP +.B \-\-replace +a window manager which is running is replaced by \fBmarco\fP. Users are encouraged to change the MATE window manager by running the new WM with the --replace or -replace option, and subsequently saving the session. +.TP +.B \-\-sm\-client\-id=ID +Specify a session management \fIID\fP. +.TP +.B \-\-sm\-disable +Disable the session management. +.TP +.B \-\-sm\-save\-file=FILENAME +Load a session from \fIFILENAME\fP. +.TP +.B \-\-version +Print the version number. +.TP +.B \-?, \-\-help +Show summary of options. +.SH CONFIGURATION +\fBmarco\fP configuration can be found under \fIPreferences\fP->\fIWindows\fP and \fIPreferences\fP->\fIKeyboard Shortcuts\fP on the menu-panel. Advanced configuration can be achieved directly through mateconf editing (mateconf-editor or mateconftool-2). +.SH SEE ALSO +.BR marco-message (1) +.SH AUTHOR +The original manual page was written by Thom May <[email protected]>. It was updated by Akira TAGOH <[email protected]> +for the Debian GNU/Linux system (with permission to use by others), and then updated by Luke Morton and Philip O'Brien +for inclusion in marco. diff --git a/doc/marco-theme.dtd b/doc/marco-theme.dtd new file mode 100644 index 00000000..7c9d3d20 --- /dev/null +++ b/doc/marco-theme.dtd @@ -0,0 +1,273 @@ +<!-- + DTD for Marco themes, as of Marco 2.4.1 + Author: Ross Burton <[email protected]> + Copyright (C) 2002 Ross Burton + Licensed under the GPL, version 2 +--> + +<!-- Top-level element --> +<!ELEMENT marco_theme (info,(window|frame_style_set|frame_style|frame_geometry|constant|draw_ops|menu_icon)+)> + +<!-- Theme metadata --> +<!ELEMENT info (name?|author?|copyright?|date?|description?)*> +<!ELEMENT name (#PCDATA)> +<!ELEMENT author (#PCDATA)> +<!ELEMENT copyright (#PCDATA)> +<!ELEMENT date (#PCDATA)> +<!ELEMENT description (#PCDATA)> + +<!ENTITY % xyrequired " + x CDATA #REQUIRED + y CDATA #REQUIRED +"> + +<!ENTITY % xyimplied " + x CDATA #IMPLIED + y CDATA #IMPLIED +"> + +<!ENTITY % widthheightrequired " + width CDATA #REQUIRED + height CDATA #REQUIRED +"> + +<!ENTITY % widthheightimplied " + width CDATA #IMPLIED + height CDATA #IMPLIED +"> + +<!ENTITY % boolean "(true|false)"> + +<!ENTITY % piece_positions " +(entire_background|titlebar|titlebar_middle|left_titlebar_edge|right_titlebar_edge|top_titlebar_edge|bottom_titlebar_edge|title|left_edge|right_edge|bottom_edge|overlay) +"> + +<!ENTITY % gtk-state " + state (normal|prelight|active|selected|insensitive) #REQUIRED +"> + +<!ENTITY % gtk-shadow " + shadow (none|in|out|etched_in|etched_out) #REQUIRED +"> + + +<!-- The actual theme --> + +<!ELEMENT window EMPTY> +<!ATTLIST window + type (normal|dialog|modal_dialog|menu|utility|border) #REQUIRED + style_set CDATA #REQUIRED +> + + +<!ELEMENT frame_style_set (frame+)> +<!ATTLIST frame_style_set + name CDATA #REQUIRED + parent CDATA #IMPLIED +> + +<!ELEMENT frame EMPTY> +<!ATTLIST frame + focus (yes|no) #REQUIRED + state (normal|maximized|shaded|maximized_and_shaded) #REQUIRED + resize (both|horizontal|vertical|none) #IMPLIED + style CDATA #REQUIRED +> + +<!ELEMENT frame_style (piece|button)*> +<!ATTLIST frame_style + name CDATA #REQUIRED + geometry CDATA #REQUIRED + parent CDATA #IMPLIED +> + +<!ELEMENT piece (draw_ops?)> +<!ATTLIST piece + position %piece_positions; #REQUIRED + draw_ops CDATA #IMPLIED +> + +<!ELEMENT button (draw_ops?)> +<!ATTLIST button + function (menu|minimize|maximize|close|left_left_background|left_middle_background|left_right_background|right_left_background|right_middle_background|right_right_background) #REQUIRED + state (normal|prelight|pressed) #REQUIRED + draw_ops CDATA #IMPLIED +> + +<!ELEMENT frame_geometry (border|(aspect_ratio|distance))+> +<!ATTLIST frame_geometry + name CDATA #REQUIRED + parent CDATA #IMPLIED + title_scale (xx-small|x-small|small|medium|large|x-large|xx-large) #IMPLIED + has_title (true|false) 'true' + rounded_top_left %boolean; #IMPLIED + rounded_top_right %boolean; #IMPLIED + rounded_bottom_left %boolean; #IMPLIED + rounded_bottom_right %boolean; #IMPLIED +> + +<!ELEMENT distance EMPTY> +<!ATTLIST distance + name (left_width|right_width|bottom_height|title_vertical_pad|right_titlebar_edge|left_titlebar_edge|button_width|button_height) #REQUIRED + value CDATA #REQUIRED +> + +<!ELEMENT border EMPTY> +<!ATTLIST border + name CDATA #REQUIRED + top CDATA #REQUIRED + bottom CDATA #REQUIRED + left CDATA #REQUIRED + right CDATA #REQUIRED +> + +<!ELEMENT aspect_ratio EMPTY> +<!ATTLIST aspect_ratio + name CDATA #REQUIRED + value CDATA #REQUIRED +> + +<!ELEMENT draw_ops (line|rectangle|arc|tint|gradient|image|gtk_arrow|gtk_box|gtk_vline|icon|title|clip|include|tile)*> +<!-- not sure about this.. maybe it should be removed. see #3478 in theme-parser.c --> +<!ATTLIST draw_ops + name CDATA #IMPLIED +> + +<!ELEMENT line EMPTY> +<!ATTLIST line + color CDATA #REQUIRED + x1 CDATA #REQUIRED + y1 CDATA #REQUIRED + x2 CDATA #REQUIRED + y2 CDATA #REQUIRED + width CDATA #IMPLIED + dash_on_length CDATA #IMPLIED + dash_off_length CDATA #IMPLIED +> + +<!ELEMENT rectangle EMPTY> +<!ATTLIST rectangle + color CDATA #REQUIRED + %xyrequired; + %widthheightrequired; + filled %boolean; 'false' +> + +<!ELEMENT arc EMPTY> +<!ATTLIST arc + color CDATA #REQUIRED + %xyrequired; + %widthheightrequired; + start_angle CDATA #REQUIRED + extent_angle CDATA #REQUIRED + filled %boolean; 'false' +> + +<!ELEMENT icon EMPTY> +<!ATTLIST icon + %xyrequired; + width CDATA #REQUIRED + height CDATA #REQUIRED + alpha CDATA #IMPLIED + fill_type (tile|scale) 'scale' +> + +<!ELEMENT image EMPTY> +<!ATTLIST image + filename CDATA #REQUIRED + colorize CDATA #IMPLIED + %xyrequired; + %widthheightrequired; + alpha CDATA #IMPLIED + fill_type (tile|scale) 'scale' +> + +<!ELEMENT tile EMPTY> +<!ATTLIST tile + name CDATA #REQUIRED + %xyrequired; + %widthheightrequired; + tile_xoffset CDATA #IMPLIED + tile_yoffset CDATA #IMPLIED + tile_width CDATA #REQUIRED + tile_height CDATA #REQUIRED +> + +<!ELEMENT clip EMPTY> +<!ATTLIST clip + %xyrequired; + %widthheightrequired; +> + +<!ELEMENT title EMPTY> +<!ATTLIST title + color CDATA #REQUIRED + %xyrequired; +> + +<!ELEMENT tint EMPTY> +<!ATTLIST tint + color CDATA #REQUIRED + %xyrequired; + %widthheightrequired; + alpha CDATA #REQUIRED +> + +<!ELEMENT gtk_box EMPTY> +<!ATTLIST gtk_box + %gtk-state; + %gtk-shadow; + %xyrequired; + %widthheightrequired; +> + +<!ELEMENT gtk_arrow EMPTY> +<!ATTLIST gtk_arrow + %gtk-state; + %gtk-shadow; + arrow (up|down|left|right) #REQUIRED + %xyrequired; + %widthheightrequired; + filed CDATA #IMPLIED +> + +<!ELEMENT gtk_vline EMPTY> +<!ATTLIST gtk_vline + %gtk-state; + x CDATA #REQUIRED + y1 CDATA #REQUIRED + y2 CDATA #REQUIRED +> + +<!ELEMENT gradient (color)+> +<!ATTLIST gradient + type (vertical|horizontal|diagonal) #REQUIRED + %xyrequired; + %widthheightrequired; + alpha CDATA #IMPLIED +> + +<!ELEMENT color EMPTY> +<!ATTLIST color + value CDATA #REQUIRED +> + +<!ELEMENT include EMPTY> +<!ATTLIST include + name CDATA #REQUIRED + %xyimplied; + %widthheightimplied; +> + +<!ELEMENT constant EMPTY> +<!ATTLIST constant + name CDATA #REQUIRED + value CDATA #REQUIRED +> + +<!ELEMENT menu_icon (draw_ops?)> +<!ATTLIST menu_icon + function (close|maximize|minimize|unmaximize) #REQUIRED + %gtk-state; + draw_ops CDATA #IMPLIED +> diff --git a/doc/theme-format.txt b/doc/theme-format.txt new file mode 100644 index 00000000..4881815f --- /dev/null +++ b/doc/theme-format.txt @@ -0,0 +1,330 @@ +Themes are in a simple XML-subset format. There are multiple versions +of the theme format, and a given theme can support more than one format. + +Version 1: THEMEDIR/metacity-1/metacity-theme-1.xml + (original metacity format) +Version 2: THEMEDIR/metacity-1/metacity-theme-2.xml + +The subdirectory name is "metacity-1" in all versions. + +As you might expect, older versions of marco will not understand +newer theme formats. However, newer versions will use old themes. +Marco will always use the newest theme format it understands that +the X server supports. Some format versions are only supported if you +have the right X server features. + +Each format *requires* the corresponding filename. If you put version +2 format features in the metacity-1/metacity-theme-1.xml file, then +marco will get angry. + +This document has separate sections for each format version. You may +want to read the document in reverse order, since the base features +are discussed under version 1. + +New Features in Theme Format Version 2 +====================================== + +The optional attributes rounded_top_left, rounded_top_right, +rounded_bottom_left and rounded_bottom_right on <frame_geometry> +should now be the radius of the corner in pixels. You may still use +the values "false" for 0 and "true" for 5, which means v1 values will +still work just fine. + +<frame_geometry> has a new optional attribute, hide_buttons. If this +is true, no buttons will be displayed on the titlebar. + +Anywhere you can use a positive integer, you can use an integer constant. + +As well as constant integers and reals, you may define constant colours, +thus: + <constant name="RevoltingPink" value="#FF00FF"/> + <constant name="Background" value="gtk:bg[NORMAL]"/> + +<frame_style> has two new optional attributes, background and alpha. +If you specify alpha, you must specify background. background is a +colour used for the background of the frame. alpha is the transparency +as a real between 0.0 and 1.0. If the current X server does not support +alpha channels, the value is ignored. + +The filename attribute of <image> may begin with "theme:". If so, the +rest of the string is the name of a theme icon. The 64x64 version of the +icon is used, except for fallback mini_icons, which use the 16x16 version. +This does not affect ordinary resizing. For example: + <button function="close" state="normal"> + <draw_ops> + <include name="active_button"/> + <image filename="theme:mate-logout" x="2" y="2" + width="width-4" height="height-4"/> + <!-- Note: not "theme:mate-logout.png" or similar. --> + </draw_ops> + </button> + +<menu_icon>s are parsed but ignored. + +Fallback icons can be specified using <fallback>. There are two +optional arguments, icon and mini_icon. The values of these arguments +are identical to that of the filename attribute of <image>. Fallback +icons are used when a window does not supply its own icon. If a fallback +icon is not specified with <fallback>, Marco will use a built-in +icon, as in metacity-theme-1. + +The <arc> element, as well as the original start_angle and end_angle +attributes, may be given from and to attributes. The values of these +attributes are given in degrees clockwise, with 0 being straight up. +For example: + <arc from="0.0" to="90.0" filled="true" color="#FF00FF" + x="0" y="5" width="15" height="15"/> + +<frame state="shaded"> may now take an optional resize attribute, with +the same interpretation as the resize attribute on <frame state="normal">. +If this attribute is omitted for state="shaded", it defaults to "both". +(If it is omitted for state="normal", it remains an error.) + +In addition to the four <button> functions which are required in +metacity-theme-1, there are six new functions in metacity-theme-2: +shade, unshade, above, unabove, stick and unstick. + +Overview of Theme Format Version 1 +================================== + +<?xml version="1.0"?> +<metacity_theme> +<!-- Only one info section is allowed --> +<info> + <name>Foo</name> + <author>Foo P. Bar</author> + <copyright>whoever, 2002</copyright> + <date>Jan 31 2005</date> + <description>A sentence about the theme.</description> +</info> + +<!-- define a frame geometry to be referenced later --> +<!-- frame_geometry has an optional has_title attribute which + determines whether the title text height is included in the + height calculation. if not specified, defaults to true. + It also has an optional text_size="medium" attribute + (same sizes as with Pango markup, xx-small thru medium thru + xx-large) + + Finally it has optional args rounded_top_left=true, + rounded_top_right=true, rounded_bottom_left=true, + rounded_bottom_right=true. + + --> +<frame_geometry name="normal" has_title="true" title_scale="medium"> + <distance name="left_width" value="6"/> + <distance name="right_width" value="6"/> + <distance name="bottom_height" value="7"/> + <distance name="left_titlebar_edge" value="6"/> + <distance name="right_titlebar_edge" value="6"/> + <distance name="button_width" value="17"/> + <distance name="button_height" value="17"/> + <!-- alternative to button_width button_height distances --> + <aspect_ratio name="button" value="1.0"/> + <distance name="title_vertical_pad" value="4"/> + <border name="title_border" left="3" right="12" top="4" bottom="3"/> + <border name="button_border" left="0" right="0" top="1" bottom="1"/> +</frame_geometry> + +<!-- inheritance is allowed; simply overwrites values from parent --> +<frame_geometry name="borderless" parent="normal"> + <distance name="left_width" value="0"/> + <distance name="right_width" value="0"/> + <distance name="bottom_height" value="0"/> + <distance name="left_titlebar_edge" value="0"/> + <distance name="right_titlebar_edge" value="0"/> +</frame_geometry> + +<!-- define a constant to use in positions/sizes of draw operations; + constant names must start with a capital letter. + --> +<constant name="LineOffset" value="3"/> + +<!-- define drawing operations to be referenced later; + these draw-op lists can also be placed inline. + + Positions/lengths are given as expressions. + Operators are: +,-,*,/,%,`max`,`min` + All operators are infix including `max` and `min`, + i.e. "2 `max` 5" + + Some variables are predefined, and constants can also + be used. Variables are: + + width - width of target area + height - height of target area + object_width - natural width of object being drawn + object_height - natural height of object being drawn + left_width - distance from left of frame to client window + right_width - distance from right of frame to client window + top_height - distance from top of frame to client window + bottom_height - distance from bottom of frame to client window + mini_icon_width - width of mini icon for window + mini_icon_height - height of mini icon + icon_width - width of large icon + icon_height - height of large icon + title_width - width of title text + title_height - height of title text + + All these are always defined, except object_width/object_height + which only exists for <image> right now. + + --> + +<draw_ops name="demo_all_ops"> + <line color="#00FF00" x1="LineOffset" y1="0" x2="0" y2="height"/> + <line color="gtk:fg[NORMAL]" + x1="width - 1" y1="0" x2="width - 1" y2="height" + width="3" dash_on_length="2" dash_off_length="3"/> + <rectangle color="blend/gtk:fg[NORMAL]/gtk:bg[NORMAL]/0.7" + x="0" y="0" width="width - 1" height="height - 1" filled="true"/> + <arc color="dark gray" x="0" y="0" width="width - 1" height="height - 1" + filled="false" start_angle="30" extent_angle="180"/> + <tint color="orange" alpha="0.5" x="0" y="0" width="width" height="height"/> + <!-- may be vertical, horizontal, diagonal --> + <gradient type="diagonal" + x="10" y="30" width="width / 3" height="height / 4"> + <!-- any number of colors allowed here. A color can be + a color name like "blue" (look at gcolorsel), a hex color + as in HTML (#FFBB99), or a color from the gtk theme + given as "gtk:base[NORMAL]", "gtk:fg[ACTIVE]", etc. + --> + <color value="gtk:fg[SELECTED]"/> + <!-- color obtained by a 0.5 alpha composite of the second color onto the first --> + <color value="blend/gtk:bg[SELECTED]/gtk:fg[SELECTED]/0.5"/> + </gradient> + <!-- image has an optional colorize="#color" attribute to give the + image a certain color --> + <image filename="foo.png" alpha="0.7" + x="10" y="30" width="width / 3" height="height / 4"/> + <gtk_arrow state="normal" shadow="in" arrow="up" + filled="true" + x="2" y="2" width="width - 4" height="height - 4"/> + <gtk_box state="normal" shadow="out" + x="2" y="2" width="width - 4" height="height - 4"/> + <gtk_vline state="normal" x="2" y1="0" y2="height"/> + <!-- window's icon --> + <icon alpha="0.7" + x="10" y="30" width="width / 3" height="height / 4"/> + <!-- window's title --> + <title color="gtk:text[NORMAL]" x="20" y="30"/> + <!-- include another draw ops list; has optional x/y/width/height attrs --> + <include name="some_other_draw_ops"/> + <!-- tile another draw ops list; has optional + x/y/width/height/tile_xoffset/tile_yoffset --> + <tile name="some_other_draw_ops" tile_width="10" tile_height="10"/> +</draw_ops> + +<frame_style name="normal" geometry="normal"> + <!-- How to draw each piece of the frame. + For each piece, a draw_ops can be given inline or referenced + by name. If a piece is omitted, then nothing will be drawn + for that piece. + + For each piece, the "width" and "height" variables in + coordinate expressions refers to the dimensions of the piece, + the origin is at the top left of the piece. + + So <rectangle x="0" y="0" width="width-1" height="height-1"/> + will outline a piece. + --> + + <piece position="entire_background" draw_ops="demo_all_ops"/> + <piece position="left_titlebar_edge"> + <draw_ops> + <line color="#00FF00" x1="0" y1="0" x2="0" y2="height"/> + </draw_ops> + </piece> + + <!-- The complete list of frame pieces: + + entire_background: whole frame + titlebar: entire area above the app's window + titlebar_middle: area of titlebar_background not considered + part of an edge + left_titlebar_edge: left side of titlebar background + right_titlebar_edge: right side of titlebar background + top_titlebar_edge: top side of titlebar background + bottom_titlebar_edge: bottom side of titlebar background + title: the title area (doesn't include buttons) + left_edge: left edge of the frame + right_edge: right edge of the frame + bottom_edge: bottom edge of the frame + overlay: same area as entire_background, but drawn after + drawing all sub-pieces instead of before + + --> + + <!-- For buttons, drawing methods have to be provided for + each of three states: + normal, pressed, prelight + and the button function or position must be provided: + close, maximize, minimize, menu, + left_left_background, left_middle_background, + left_right_background, right_left_background, + right_middle_background, right_right_background + So a working theme needs 3*4 = 12 button declarations + and a theme may have up to 3*10 = 30 button declarations + in order to handle button-rearrangement preferences. + + (The name "function" for the attribute is from before the + background values existed.) + --> + + <button function="close" state="normal" draw_ops="previously_named"/> + <button function="menu" state="normal"> + <draw_ops> + <icon alpha="0.7" + x="0" y="0" width="object_width" height="object_height"/> + </draw_ops> + </button> + +</frame_style> + +<!-- styles can inherit from each other with the parent="" attribute. + In a subclass anything can be re-specified to override + the parent style. --> +<frame_style name="focused" parent="normal"> + <piece position="title"> + <draw_ops> + <rectangle color="gtk:bg[SELECTED]" + x="0" y="0" width="width-1" height="height-1"/> + <title color="gtk:fg[SELECTED]" x="(width - title_width) / 2" + y="(height - title_height) / 2"/> + </draw_ops> + </piece> +</frame_style> + +<!-- Maps styles to states of frame. + + Focus: yes (focused), no (not focused) + Window states: normal, maximized, shaded, maximized_and_shaded + Window resizability: none, vertical, horizontal, both + + Everything unspecified just does the same as + unfocused/normal/both. + + only state="normal" needs a resize="" attribute. + --> +<frame_style_set name="normal"> +<frame focus="yes" state="normal" resize="both" style="focused"/> +<frame focus="no" state="normal" resize="both" style="normal"/> +</frame_style_set> + +<!-- Each window type needs a style set + Types: normal, dialog, modal_dialog, menu, utility, border + --> +<window type="normal" style_set="normal"/> + + +<!-- For menu icons, drawing methods are needed for the same + four types as the buttons, and GTK states + (insensitive,prelight,normal,etc.) + --> + +<menu_icon function="close" state="normal" draw_ops="previously_named"/> + + +</metacity_theme> + + |