summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Dew <marcoz@osource.org>2011-11-05 19:56:29 -0600
committerMatt Dew <marcoz@osource.org>2011-11-05 19:56:29 -0600
commit51500da421891cd7f67019677b24f848418a17e0 (patch)
tree6ae93bdc8795ecde11b1276895f1c8769fcde5cf
parente379a367178cb3e3475d6bd14573712fafadd1b6 (diff)
Added acknowledgment file.
cleaned up tables.
-rwxr-xr-xspecs/CH01.xml36
-rwxr-xr-xspecs/CH03.xml2
-rwxr-xr-xspecs/CH04.xml346
-rwxr-xr-xspecs/CH05.xml2
-rwxr-xr-xspecs/CH06.xml25
-rwxr-xr-xspecs/CH09.xml53
-rwxr-xr-xspecs/CH10.xml6
-rwxr-xr-xspecs/CH11.xml11
-rwxr-xr-xspecs/CH12.xml18
-rwxr-xr-xspecs/acknowledgement.xml310
-rwxr-xr-xspecs/appA.xml5
-rwxr-xr-xspecs/appB.xml56
-rwxr-xr-xspecs/appD.xml22
-rwxr-xr-xspecs/appE.xml132
-rwxr-xr-xspecs/intrinsics.xml1
-rwxr-xr-xspecs/preface.xml359
16 files changed, 799 insertions, 585 deletions
diff --git a/specs/CH01.xml b/specs/CH01.xml
index 7fcf376..60a19ab 100755
--- a/specs/CH01.xml
+++ b/specs/CH01.xml
@@ -376,13 +376,14 @@ The resource names, classes, and representation types specified in the
<function>coreClassRec</function>
resource list are
</para>
-<informaltable width='100%'>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colname='c1' colwidth='1.0*'/>
<colspec colname='c2' colwidth='1.0*'/>
<colspec colname='c3' colwidth='1.0*'/>
<tbody>
- <row>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
@@ -454,15 +455,18 @@ resource lists; see Sections 12.2 and 12.3 for details.
The default values for the Core fields, which are filled in by the Intrinsics,
from the resource lists, and by the initialize procedures, are
</para>
-<informaltable>
- <tgroup cols='2' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colname='c1' colwidth='1.0*'/>
<colspec colname='c2' colwidth='1.0*'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>self</entry>
<entry>Address of the widget structure (may not be changed).</entry>
@@ -749,17 +753,20 @@ the
resource list are
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colname='c1' colwidth='1.0*'/>
<colspec colname='c2' colwidth='1.0*'/>
<colspec colname='c3' colwidth='1.0*'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNchildren</entry>
<entry>XtCReadOnly</entry>
@@ -791,9 +798,10 @@ Composite
initialize procedure, are
</para>
-<informaltable frame='none' pgwide='0'>
-<?dbfo table-width="50%" ?>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <?dbfo table-width="50%" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colname='c1' colwidth='1.0*' colsep='0'/>
<colspec colname='c2' colwidth='1.0*' colsep='0'/>
<thead>
diff --git a/specs/CH03.xml b/specs/CH03.xml
index 21d713f..6fa3c74 100755
--- a/specs/CH03.xml
+++ b/specs/CH03.xml
@@ -159,7 +159,7 @@ The insert_child procedure pointer in a composite widget is of type
<funcsynopsis id='XtWidgetProc_2'>
<funcprototype>
-<funcdef>void <function>*XtWidgetProc</function></funcdef>
+<funcdef>typedef void <function>(*XtWidgetProc)</function></funcdef>
<paramdef>Widget <parameter>w</parameter></paramdef>
</funcprototype>
</funcsynopsis>
diff --git a/specs/CH04.xml b/specs/CH04.xml
index e7e3a20..00be033 100755
--- a/specs/CH04.xml
+++ b/specs/CH04.xml
@@ -19,43 +19,54 @@ Clients should never attempt to change the size of their shells directly.
</para>
<para>The five types of public shells are:</para>
-<informaltable>
- <tgroup cols='2' align='left'>
- <colspec colwidth='1.0*' colname='c1'/>
- <colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
- <entry><function>OverrideShell</function></entry>
- <entry>Used for shell windows that completely bypass the window manager
- (for example, pop-up menu shells).</entry>
- </row>
- <row>
- <entry><function>TransientShell</function></entry>
- <entry>Used for shell windows that have the
+<variablelist>
+ <varlistentry>
+ <term>OverrideShell</term>
+ <listitem>
+ <para>
+ Used for shell windows that completely bypass the window manager
+ (for example, pop-up menu shells).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TransientShell</term>
+ <listitem>
+ <para>Used for shell windows that have the
<emphasis role='bold'>WM_TRANSIENT_FOR</emphasis>
property set. The effect of this property is dependent upon the
- window manager being used.</entry>
- </row>
- <row>
- <entry><function>TopLevelShell</function></entry>
- <entry>Used for normal top-level windows
- (for example, any additional top-level widgets an application needs).</entry>
- </row>
- <row>
- <entry><function>ApplicationShell</function></entry>
- <entry>Formerly used for the single main top-level window that
+ window manager being used.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TopLevelShell</term>
+ <listitem>
+ <para>Used for normal top-level windows
+ (for example, any additional top-level widgets an application needs).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ApplicationShell</term>
+ <listitem>
+ <para>Formerly used for the single main top-level window that
the window manager identifies as an application instance and
- made obsolete by SessionShell.</entry>
- </row>
- <row>
- <entry><emphasis role='bold'>SessionShell</emphasis></entry>
- <entry>Used for the single main top-level window that
+ made obsolete by SessionShell.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>SessionShell</term>
+ <listitem>
+ <para>
+ Used for the single main top-level window that
the window manager identifies as an application instance and
- that interacts with the session manager.</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
+ that interacts with the session manager.
+ </para>
+ </listitem>
+ </varlistentry>
+</variablelist>
<sect1 id="Shell_Widget_Definitions">
<title>Shell Widget Definitions</title>
@@ -79,56 +90,69 @@ They also can provide a layer of communication with the window manager.
</para>
<para>The eight different types of shells are:</para>
-<informaltable>
- <tgroup cols='2' align='left'>
- <colspec colwidth='1.0*' colname='c1'/>
- <colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
- <entry><emphasis role='bold'>Shell</emphasis></entry>
- <entry>The base class for shell widgets; provides the
+<variablelist>
+ <varlistentry>
+ <term>Shell</term>
+ <listitem>
+ <para>The base class for shell widgets; provides the
fields needed for all types of shells. Shell
is a direct subclass of
- <emphasis role='bold'>compositeWidgetClass</emphasis>.</entry>
- </row>
- <row>
- <entry><function>OverrideShell</function></entry>
- <entry>A subclass of Shell; used for shell windows that completely
- bypass the window manager.</entry>
- </row>
- <row>
- <entry><emphasis role='bold'>WMShell</emphasis></entry>
- <entry>A subclass of Shell; contains fields needed by the
- common window manager protocol.</entry>
- </row>
- <row>
- <entry><function>VendorShell</function></entry>
- <entry>A subclass of WMShell; contains fields used by
- vendor-specific window managers.</entry>
- </row>
- <row>
- <entry><function>TransientShell</function></entry>
- <entry>A subclass of VendorShell; used for shell windows that
+ <emphasis role='bold'>compositeWidgetClass</emphasis>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>OverrideShell</term>
+ <listitem>
+ <para>A subclass of Shell; used for shell windows that completely
+ bypass the window manager.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>WMShell</term>
+ <listitem>
+ <para>A subclass of Shell; contains fields needed by the
+ common window manager protocol.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>VendorShell</term>
+ <listitem>
+ <para>A subclass of WMShell; contains fields used by
+ vendor-specific window managers.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TransientShell</term>
+ <listitem>
+ <para>A subclass of VendorShell; used for shell windows that
desire the <emphasis role='bold'>WM_TRANSIENT_FOR</emphasis>
- property.</entry>
- </row>
- <row>
- <entry><emphasis role='bold'>TopLevelShell</emphasis></entry>
- <entry>A subclass of VendorShell; used for normal top-level windows.</entry>
- </row>
- <row>
- <entry><emphasis role='bold'>ApplicationShell</emphasis></entry>
- <entry>A subclass of TopLevelShell; may be used for an application's additional
- root windows.</entry>
- </row>
- <row>
- <entry><emphasis role='bold'>SessionShell</emphasis></entry>
- <entry>A subclass of ApplicationShell; used for an application's
- main root window.</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
+ property.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>TopLevelShell</term>
+ <listitem>
+ <para>A subclass of VendorShell; used for normal top-level windows.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>ApplicationShell</term>
+ <listitem>
+ <para>A subclass of TopLevelShell; may be used for an application's additional
+ root windows.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>SessionShell</term>
+ <listitem>
+ <para>A subclass of ApplicationShell; used for an application's
+ main root window.</para>
+ </listitem>
+ </varlistentry>
+</variablelist>
<para>
Note that the classes
@@ -289,15 +313,18 @@ for generic operations on widgets whose class is a subclass of
Shell.
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Types</entry>
<entry>Variables</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry><emphasis role='bold'>ShellWidget</emphasis></entry>
<entry><emphasis role='bold'>shellWidgetClass</emphasis></entry>
@@ -643,17 +670,20 @@ the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNallowShellResize</entry>
<entry>XtCAllowShellResize</entry>
@@ -711,17 +741,20 @@ the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNbaseHeight</entry>
<entry>XtCBaseHeight</entry>
@@ -886,17 +919,20 @@ The resource names, classes, and representation types that are specified in the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNtransientFor</entry>
<entry>XtCTransientFor</entry>
@@ -912,17 +948,20 @@ The resource names, classes, and representation types that are specified in the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNiconName</entry>
<entry>XtCIconName</entry>
@@ -948,17 +987,20 @@ The resource names, classes, and representation types that are specified in the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNargc</entry>
<entry>XtCArgc</entry>
@@ -980,17 +1022,20 @@ in the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNcancelCallback</entry>
<entry>XtCCallback</entry>
@@ -1098,15 +1143,18 @@ Shell
initialize procedures) are:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
+ <thead>
<row>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>geometry</entry>
<entry>NULL</entry>
@@ -1195,7 +1243,7 @@ Shell classes; a client specifying the string in an arglist
or varargs list must ensure
that the value remains valid until the shell widget is realized.
For further information on the geometry string, see Section 16.4
-in <emphasis remap='I'>(xL</emphasis>.
+in <emphasis remap='I'>Xlib — C Language X Interface</emphasis>.
</para>
<para>
@@ -1229,8 +1277,8 @@ determines
whether the window manager can intercede when the shell window
is mapped.
For further information on override_redirect,
-see Section 3.2 in <emphasis remap='I'>(xL</emphasis> and Sections 4.1.10 and 4.2.2 in the
-<emphasis remap='I'>(xC</emphasis>.
+see Section 3.2 in <emphasis remap='I'>Xlib — C Language X Interface</emphasis> and Sections 4.1.10 and 4.2.2 in the
+<emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis>.
The pop-up and pop-down callbacks are called during
<xref linkend='XtPopup' xrefstyle='select: title'/>
and
@@ -1253,15 +1301,18 @@ WMShell
and its subclasses are:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='0'>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>title</entry>
<entry>Icon name, if specified, otherwise the application's name</entry>
@@ -1420,7 +1471,7 @@ the
property
will be stored on the shell window with a value as specified below.
The interpretation of this property is specific to the window manager
-under which the application is run; see the <emphasis remap='I'>(xC</emphasis> for more details.
+under which the application is run; see the <emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis> for more details.
</para>
<para>
@@ -1460,15 +1511,18 @@ a flag bit is set that refers to a field with the value
the value of the field is modified as follows:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Replacement</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>base_width, base_height</entry>
<entry>0</entry>
@@ -1533,15 +1587,18 @@ Transient
shells have the following additional resource:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
+ <thead>
<row>
<entry>Field</entry>
<entry>Replacement</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>transient_for</entry>
<entry>NULL</entry>
@@ -1569,15 +1626,18 @@ shells have the the following additional resources:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>icon_name</entry>
<entry>Shell widget's name</entry>
@@ -1616,7 +1676,7 @@ that the window manager iconify or deiconify the shell; the
TopLevelShell
set_values procedure will send the appropriate
<emphasis role='bold'>WM_CHANGE_STATE</emphasis>
-message (as specified by the <emphasis remap='I'>(xC</emphasis>)
+message (as specified by the <emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis>)
if this resource is changed from
<function>False</function>
to
@@ -1644,15 +1704,18 @@ Application
shells have the following additional resources:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>argc</entry>
<entry>0</entry>
@@ -1669,7 +1732,7 @@ shells have the following additional resources:
The <emphasis remap='I'>argc</emphasis> and <emphasis remap='I'>argv</emphasis> fields are used to initialize
the standard property
<emphasis role='bold'>WM_COMMAND</emphasis>.
-See the <emphasis remap='I'>(xC</emphasis> for more information.
+See the <emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis> for more information.
</para>
<para>
@@ -1678,15 +1741,18 @@ which are filled in from the resource lists and by the
initialize procedure, are
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Field</entry>
<entry>Default Value</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>cancel_callbacks</entry>
<entry>NULL</entry>
diff --git a/specs/CH05.xml b/specs/CH05.xml
index 53f17be..90a8c7a 100755
--- a/specs/CH05.xml
+++ b/specs/CH05.xml
@@ -892,7 +892,7 @@ Unmaps <emphasis remap='I'>popup_shell</emphasis>'s window and, if <emphasis rem
<function>False</function>,
sends a synthetic
<function>UnmapNotify</function>
-event as specified by the <emphasis remap='I'>(xC</emphasis>.
+event as specified by the <emphasis remap='I'>Inter-Client Communication Conventions Manual</emphasis>.
</para>
</listitem>
<listitem>
diff --git a/specs/CH06.xml b/specs/CH06.xml
index 28a7118..d6aff3c 100755
--- a/specs/CH06.xml
+++ b/specs/CH06.xml
@@ -285,8 +285,9 @@ The <emphasis remap='I'>request_mode</emphasis> definitions are from
<function>&lt;X11/X.h&gt;</function>.
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
@@ -334,8 +335,9 @@ The <emphasis remap='I'>request_mode</emphasis> definitions are from
The Intrinsics also support the following value.
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
@@ -370,8 +372,9 @@ The <emphasis remap='I'>stack_mode</emphasis> definitions are from
<function>&lt;X11/X.h&gt;</function>:
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
@@ -409,8 +412,9 @@ The <emphasis remap='I'>stack_mode</emphasis> definitions are from
The Intrinsics also support the following value.
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
@@ -1248,6 +1252,9 @@ the query_geometry procedure should return
If the preferred geometry is identical to the current geometry,
the query_geometry procedure should return
<function>XtGeometryNo</function>.
+</para>
+
+<note><para>
The query_geometry procedure may assume
that no
<xref linkend='XtMakeResizeRequest' xrefstyle='select: title'/>
@@ -1257,7 +1264,7 @@ is in progress
for the specified widget; that is, it is not required to construct
a reply consistent with the requested geometry if such a request
were actually outstanding.
-</para>
+</para></note>
<para>
After calling the query_geometry procedure
diff --git a/specs/CH09.xml b/specs/CH09.xml
index 29950f7..811bafc 100755
--- a/specs/CH09.xml
+++ b/specs/CH09.xml
@@ -165,15 +165,18 @@ physical representation (see Section 9.6).
The Intrinsics define the following resource types:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Resource Type</entry>
<entry>Structure or Field Type</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry><function>XtRAcceleratorTable</function></entry>
<entry>XtAccelerators</entry>
@@ -1307,17 +1310,20 @@ input values of representation type
<function>XtRString</function>.
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='0.8*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='0.6*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Target Representation</entry>
<entry>Converter Name</entry>
<entry>Additional Args</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry><function>XtRAcceleratorTable</function></entry>
<entry><function>XtCvtStringToAcceleratorTable</function></entry>
@@ -1590,7 +1596,7 @@ matching Visual on the list. The widget resource list must be certain
to specify any resource of type
<function>XtRVisual</function>
after the depth resource.
-The allowed string values are the visual class names defined in <emphasis remap='I'>(xP</emphasis>,
+The allowed string values are the visual class names defined in <emphasis remap='I'>X Window System Protocol</emphasis>,
Section 8;
<function>StaticGray</function>,
<function>StaticColor</function>,
@@ -1607,17 +1613,20 @@ an input value of representation type
<function>XtRColor</function>.
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Target Representation</entry>
<entry>Converter Name</entry>
<entry>Additional Args</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry><function>XtRPixel</function></entry>
<entry><function>XtCvtColorToPixel</function></entry>
@@ -1632,17 +1641,20 @@ input values of representation type
<function>XtRInt</function>.
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Target Representation</entry>
<entry>Converter Name</entry>
<entry>Additional Args</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry><function>XtRBoolean</function></entry>
<entry><function>XtCvtIntToBoolean</function></entry>
@@ -1698,18 +1710,21 @@ an input value of representation type
<function>XtRPixel</function>.
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Target Representation</entry>
<entry>Converter Name</entry>
<entry>Additional Args</entry>
</row>
- <row>
+ </thead>
+ <tbody>
+ <row rowsep='1'>
<entry><function>XtRColor</function></entry>
<entry><function>XtCvtPixelToColor</function></entry>
</row>
diff --git a/specs/CH10.xml b/specs/CH10.xml
index bdd44fa..71e9003 100755
--- a/specs/CH10.xml
+++ b/specs/CH10.xml
@@ -1428,7 +1428,7 @@ The default translator is
an
<xref linkend='XtKeyProc' xrefstyle='select: title'/>
that uses the Shift, Lock, numlock, and group modifiers
-with the interpretations defined in <emphasis remap='I'>(xP</emphasis>, Section 5.
+with the interpretations defined in <emphasis remap='I'>X Window System Protocol</emphasis>, Section 5.
It is provided so that new translators can call it to get default
KeyCode-to-KeySym translations and so that the default translator
can be reinstalled.
@@ -1648,7 +1648,7 @@ you need to register an identity converter.
When a new converter is registered,
the Intrinsics refresh the keyboard state if necessary.
The default converter understands case conversion for all
-Latin KeySyms defined in <emphasis remap='I'>(xP</emphasis>, Appendix A.
+Latin KeySyms defined in <emphasis remap='I'>X Window System Protocol</emphasis>, Appendix A.
</para>
<para>
@@ -1876,7 +1876,7 @@ procedure returns all the KeyCodes that have <emphasis remap='I'>keysym</emphasi
in their entry for the keyboard mapping table associated with <emphasis remap='I'>display</emphasis>.
For each entry in the
table, the first four KeySyms (groups 1 and 2) are interpreted as
-specified by <emphasis remap='I'>(xP</emphasis>, Section 5. If no KeyCodes map to the
+specified by <emphasis remap='I'>X Window System Protocol</emphasis>, Section 5. If no KeyCodes map to the
specified KeySym, <emphasis remap='I'>keycount_return</emphasis> is zero and *<emphasis remap='I'>keycodes_return</emphasis> is NULL.
</para>
diff --git a/specs/CH11.xml b/specs/CH11.xml
index 958bf80..5f0c537 100755
--- a/specs/CH11.xml
+++ b/specs/CH11.xml
@@ -4834,17 +4834,20 @@ as an argument:
<para>
The resource names, classes, and representation types that are specified
in the hook object resource list are:
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNcreateHook</entry>
<entry>XtCCallback</entry>
diff --git a/specs/CH12.xml b/specs/CH12.xml
index a5d75df..51e8213 100755
--- a/specs/CH12.xml
+++ b/specs/CH12.xml
@@ -229,17 +229,20 @@ The resource names, classes, and representation types specified in the
resource list are:
</para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNdestroyCallback</entry>
<entry>XtCCallback</entry>
@@ -645,17 +648,20 @@ typedef struct _RectObjRec* RectObj;
The resource names, classes, and representation types that are specified in the
<function>rectObjClassRec</function>
resource list are:
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Name</entry>
<entry>Class</entry>
<entry>Representation</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNancestorSensitive</entry>
<entry>XtCSensitive</entry>
diff --git a/specs/acknowledgement.xml b/specs/acknowledgement.xml
new file mode 100755
index 0000000..4458d9f
--- /dev/null
+++ b/specs/acknowledgement.xml
@@ -0,0 +1,310 @@
+<acknowledgements>
+<title>Acknowledgments</title>
+
+<para>
+The design of the X11 Intrinsics was done primarily by Joel McCormack
+of Digital WSL. Major contributions to the design and implementation
+also were done by Charles Haynes, Mike Chow, and Paul Asente of Digital
+WSL. Additional contributors to the design and/or implementation were:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='2' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row><?dbfo row-height="0.2cm"?>
+ <entry>Loretta Guarino-Reid (Digital WSL)</entry>
+ <entry>Rich Hyde (Digital WSL)</entry>
+ </row>
+ <row><?dbfo row-height="0.2cm"?>
+ <entry>Susan Angebranndt (Digital WSL)</entry>
+ <entry>Terry Weissman (Digital WSL)</entry>
+ </row>
+ <row><?dbfo row-height="0.2cm"?>
+ <entry>Mary Larson (Digital UEG)</entry>
+ <entry>Mark Manasse (Digital SRC)</entry>
+ </row>
+ <row><?dbfo row-height="0.5cm"?>
+ <entry>Jim Gettys (Digital SRC)</entry>
+ <entry>Leo Treggiari (Digital SDT)</entry>
+ </row>
+ <row><?dbfo row-height="0.5cm"?>
+ <entry>Ralph Swick (Project Athena and Digital ERP)</entry>
+ <entry>Mark Ackerman (Project Athena)</entry>
+ </row>
+ <row><?dbfo row-height="0.5cm"?>
+ <entry>Ron Newman (Project Athena)</entry>
+ <entry>Bob Scheifler (MIT LCS)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+The contributors to the X10 toolkit also deserve mention. Although the X11 Intrinsics present an
+entirely different programming style, they borrow heavily from the implicit and
+explicit concepts in the X10 toolkit.
+</para>
+
+<para>
+The design and implementation of the X10 Intrinsics were done by:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='1' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row>
+ <entry>Terry Weissman (Digital WSL)</entry>
+ </row>
+ <row>
+ <entry>Smokey Wallace (Digital WSL)</entry>
+ </row>
+ <row>
+ <entry>Phil Karlton (Digital WSL)</entry>
+ </row>
+ <row>
+ <entry>Charles Haynes (Digital WSL)</entry>
+ </row>
+ <row>
+ <entry>Frank Hall (HP)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+The design and implementation of the X10 toolkit’s sample widgets were by
+the above, as well as by:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='1' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row>
+ <entry>Ram Rao (Digital UEG)</entry>
+ </row>
+ <row>
+ <entry>Mary Larson (Digital UEG)</entry>
+ </row>
+ <row>
+ <entry>Mike Gancarz (Digital UEG)</entry>
+ </row>
+ <row>
+ <entry>Kathleen Langone (Digital UEG)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics.
+</para>
+<para>
+Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally
+improving this document and to John Ousterhout of Berkeley for extensively reviewing early
+drafts of it.
+</para>
+<para>
+Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit
+provided the justification to redesign it entirely for X11.
+</para>
+
+<literallayout>
+Joel McCormack
+Western Software Laboratory
+Digital Equipment Corporation
+March 1988
+</literallayout>
+
+
+<para>
+The current design of the Intrinsics has benefited greatly from the
+input of several dedicated reviewers in the membership of the X
+Consortium. In addition to those already mentioned, the following
+individuals have dedicated significant time to suggesting improvements
+to the Intrinsics:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='2' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row>
+ <entry>Steve Pitschke (Stellar)</entry>
+ <entry>C.Doug Blewett (AT&amp;T)</entry>
+ </row>
+ <row>
+ <entry>Bob Miller (HP)</entry>
+ <entry>David Schiferl (Tektronix)</entry>
+ </row>
+ <row>
+ <entry>Fred Taft (HP)</entry>
+ <entry>Michael Squires (Sequent)</entry>
+ </row>
+ <row>
+ <entry>Marcel Meth (AT&amp;T)</entry>
+ <entry>JimFulton (MIT)</entry>
+ </row>
+ <row>
+ <entry>Mike Collins (Digital)</entry>
+ <entry>Kerry Kimbrough (Texas Instruments)</entry>
+ </row>
+ <row>
+ <entry>Scott McGregor (Digital)</entry>
+ <entry>Phil Karlton (Digital)</entry>
+ </row>
+ <row>
+ <entry>Julian Payne (ESS)</entry>
+ <entry>Jacques Davy (Bull)</entry>
+ </row>
+ <row>
+ <entry>Gabriel Beged-Dov (HP)</entry>
+ <entry>GlennWidener (Tektronix)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+Thanks go to each of them for the countless hours spent reviewing drafts and code.
+</para>
+
+<literallayout>
+Ralph R. Swick
+External Research Group
+Digital Equipment Corporation
+MIT Project Athena
+June 1988
+</literallayout>
+
+
+<para>
+From Release 3 to Release 4, several new members joined the design team. We greatly appreciate
+the thoughtful comments, suggestions, lengthy discussions, and in some cases implementation
+code contributed by each of the following:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='2' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row>
+ <entry>Don Alecci (AT&amp;T)</entry>
+ <entry>EllisCohen (OSF)</entry>
+ </row>
+ <row>
+ <entry>Donna Converse (MIT)</entry>
+ <entry>Clive Feather (IXI)</entry>
+ </row>
+ <row>
+ <entry>Nayeem Islam (Sun)</entry>
+ <entry>Dana Laursen (HP)</entry>
+ </row>
+ <row>
+ <entry>Keith Packard (MIT)</entry>
+ <entry>Chris Peterson (MIT)</entry>
+ </row>
+ <row>
+ <entry>Richard Probst (Sun)</entry>
+ <entry>Larry Cable (Sun)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+In Release 5, the effort to define the internationalization additions was headed by Bill McMahon
+of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of
+us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed
+to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov,
+and especially Donna Converse for this release are also gratefully acknowledged.
+</para>
+
+<literallayout>
+Ralph R. Swick
+December 1989
+and
+July 1991
+</literallayout>
+
+<?dbfo-need height="5in" space-before="30em" ?>
+<para>
+The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s
+intrinsics working group. A few individuals contributed substantial design proposals, participated
+in lengthy discussions, reviewed final specifications, and in most cases, were also
+responsible for sections of the implementation. They deserve recognition and thanks for their
+major contributions:
+</para>
+
+<sidebar>
+<informaltable frame='none'>
+<?dbfo keep-together="always" ?>
+ <tgroup cols='2' rowsep='0' colsep='0'>
+ <colspec colwidth='1.0*' />
+ <colspec colwidth='1.0*' />
+ <tbody>
+ <row>
+ <entry>Paul Asente (Adobe)</entry>
+ <entry>Larry Cable (SunSoft)</entry>
+ </row>
+ <row>
+ <entry>Ellis Cohen (OSF)</entry>
+ <entry>Daniel Dardailler (OSF)</entry>
+ </row>
+ <row>
+ <entry>Vania Joloboff (OSF)</entry>
+ <entry>KalebKeithley (X Consortium)</entry>
+ </row>
+ <row>
+ <entry>Courtney Loomis (HP)</entry>
+ <entry>Douglas Rand (OSF)</entry>
+ </row>
+ <row>
+ <entry>Bob Scheifler (X Consortium)</entry>
+ <entry>Ajay Vohra (SunSoft)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+</informaltable>
+</sidebar>
+
+<para>
+Many others analyzed designs, offered useful comments and suggestions, and participated in a
+significant subset of the process. The following people deserve thanks for their contributions:
+Andy Bovingdon, Sam Chang, Chris Craig, George Erwin-Grotsky, Keith Edwards, Clive
+Feather, Stephen Gildea, Dan Heller, Steve Humphrey, David Kaelbling, Jaime Lau, Rob Lembree,
+Stuart Marks, Beth Mynatt, Tom Paquin, Chris Peterson, Kamesh Ramakrishna, Tom
+Rodriguez, Jim VanGilder, Will Walker, and Mike Wexler.
+</para>
+
+<para>
+I am especially grateful to two of my colleagues: Ralph Swick for expert editorial guidance, and
+Kaleb Keithley for leadership in the implementation and the specification work.
+</para>
+
+<literallayout>
+Donna Converse
+X Consortium
+April 1994
+</literallayout>
+</acknowledgements>
diff --git a/specs/appA.xml b/specs/appA.xml
index 9d657a4..647bb94 100755
--- a/specs/appA.xml
+++ b/specs/appA.xml
@@ -12,8 +12,9 @@ for convenience only.
</para>
<para>The format of a resource specification is</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
diff --git a/specs/appB.xml b/specs/appB.xml
index b5ca625..2ace627 100755
--- a/specs/appB.xml
+++ b/specs/appB.xml
@@ -6,8 +6,9 @@
Syntax is specified in EBNF notation with the following conventions:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
@@ -38,8 +39,9 @@ Syntax
</para>
<para>The syntax of a translation table is</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
@@ -247,17 +249,20 @@ The use of "None" for a modifier list is identical to the use
of an exclamation point with no modifers.
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Modifier</entry>
<entry>Abbreviation</entry>
<entry>Meaning</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>Ctrl</entry>
<entry>c</entry>
@@ -415,15 +420,18 @@ Xlib symbolic event type names, the following event type synonyms
are defined:
</para>
-<informaltable>
- <tgroup cols='2' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Type</entry>
<entry>Meaning</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>Key</entry>
<entry><function>KeyPress</function></entry>
@@ -582,17 +590,20 @@ are defined:
<para>The supported abbreviations are:</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
+ <thead>
<row>
<entry>Abbreviation</entry>
<entry>Event Type</entry>
<entry>Including</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>Ctrl</entry>
<entry><function>KeyPress</function></entry>
@@ -699,8 +710,9 @@ by <emphasis remap='I'>X Window System Protocol</emphasis>, Section 11.
The detail field is supported for the following event types:
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
@@ -830,8 +842,9 @@ The canonical representation of a translation table is (see also
"Syntax")
</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
@@ -936,8 +949,9 @@ The canonical representation of a translation table is (see also
<para>The canonical event types are</para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='none'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<tbody>
diff --git a/specs/appD.xml b/specs/appD.xml
index 28a4e64..88be1c0 100755
--- a/specs/appD.xml
+++ b/specs/appD.xml
@@ -10,17 +10,20 @@ Additional implementation-dependent messages are permitted.
Error Messages
</para>
-<informaltable>
- <tgroup cols='3' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Type</entry>
<entry>Default Message</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>allocError</entry>
<entry>calloc</entry>
@@ -262,17 +265,20 @@ Error Messages
<para><emphasis role='bold'>Warning Messages</emphasis></para>
-<informaltable>
- <tgroup cols='3' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='3' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
<colspec colwidth='1.0*' colname='c3'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Name</entry>
<entry>Type</entry>
<entry>Default Message</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>ambiguousParent</entry>
<entry>xtChangeManagedSet</entry>
diff --git a/specs/appE.xml b/specs/appE.xml
index a361a37..64bf97e 100755
--- a/specs/appE.xml
+++ b/specs/appE.xml
@@ -8,15 +8,18 @@ class, and representation type symbolic constants.
</para>
<para><emphasis role='bold'>Resource names:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNaccelerators</entry>
<entry>"accelerators"</entry>
@@ -402,15 +405,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Resource classes:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtCAccelerators</entry>
<entry>"Accelerators"</entry>
@@ -689,15 +695,18 @@ class, and representation type symbolic constants.
<para><emphasis role='bold'>Resource representation types:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='0'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtRAcceleratorTable</entry>
<entry>"AcceleratorTable"</entry>
@@ -907,15 +916,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Boolean enumeration constants:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtEoff</entry>
<entry>"off"</entry>
@@ -945,15 +957,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Orientation enumeration constants:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='center'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtEvertical</entry>
<entry>"vertical"</entry>
@@ -968,15 +983,18 @@ class, and representation type symbolic constants.
<para><emphasis role='bold'>Text edit enumeration constants:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtEtextRead</entry>
<entry>"read"</entry>
@@ -994,15 +1012,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Color enumeration constants:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' rowsep='0' colsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtExtdefaultbackground</entry>
<entry>"xtdefaultbackground"</entry>
@@ -1016,15 +1037,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Font constant:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtExtdefaultfont</entry>
<entry>"xtdefaultfont"</entry>
@@ -1034,15 +1058,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Hooks for External Agents constants:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtHcreate</entry>
<entry>"Xtcreate"</entry>
@@ -1163,15 +1190,18 @@ class, and representation type symbolic constants.
</para>
<para><emphasis role='bold'>Resource names:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtNallowShellResize</entry>
<entry>"allowShellResize"</entry>
@@ -1417,15 +1447,18 @@ class, and representation type symbolic constants.
</informaltable>
<para><emphasis role='bold'>Resource classes:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtCAllowShellResize</entry>
<entry>"allowShellResize"</entry>
@@ -1648,15 +1681,18 @@ class, and representation type symbolic constants.
<para><emphasis role='bold'>Resource representation types:</emphasis></para>
-<informaltable>
- <tgroup cols='2' align='left'>
+<informaltable frame='topbot'>
+ <?dbfo keep-together="always" ?>
+ <tgroup cols='2' align='left' colsep='0' rowsep='0'>
<colspec colwidth='1.0*' colname='c1'/>
<colspec colwidth='1.0*' colname='c2'/>
- <tbody>
- <row>
+ <thead>
+ <row rowsep='1'>
<entry>Symbol</entry>
<entry>Definition</entry>
</row>
+ </thead>
+ <tbody>
<row>
<entry>XtRAtom</entry>
<entry>"Atom"</entry>
diff --git a/specs/intrinsics.xml b/specs/intrinsics.xml
index 256d0be..c6f23a8 100755
--- a/specs/intrinsics.xml
+++ b/specs/intrinsics.xml
@@ -96,6 +96,7 @@ It is provided "as is" without express or implied warranty.
</bookinfo>
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acknowledgement.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="preface.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH01.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="CH02.xml"/>
diff --git a/specs/preface.xml b/specs/preface.xml
index efb5897..8d6c134 100755
--- a/specs/preface.xml
+++ b/specs/preface.xml
@@ -1,310 +1,51 @@
-<preface>
-<title>Acknowledgments</title>
-
-<para>
-The design of the X11 Intrinsics was done primarily by Joel McCormack
-of Digital WSL. Major contributions to the design and implementation
-also were done by Charles Haynes, Mike Chow, and Paul Asente of Digital
-WSL. Additional contributors to the design and/or implementation were:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='2' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <colspec colwidth='1.0*' />
- <tbody>
- <row><?dbfo row-height="0.2cm"?>
- <entry>Loretta Guarino-Reid (Digital WSL)</entry>
- <entry>Rich Hyde (Digital WSL)</entry>
- </row>
- <row><?dbfo row-height="0.2cm"?>
- <entry>Susan Angebranndt (Digital WSL)</entry>
- <entry>Terry Weissman (Digital WSL)</entry>
- </row>
- <row><?dbfo row-height="0.2cm"?>
- <entry>Mary Larson (Digital UEG)</entry>
- <entry>Mark Manasse (Digital SRC)</entry>
- </row>
- <row><?dbfo row-height="0.5cm"?>
- <entry>Jim Gettys (Digital SRC)</entry>
- <entry>Leo Treggiari (Digital SDT)</entry>
- </row>
- <row><?dbfo row-height="0.5cm"?>
- <entry>Ralph Swick (Project Athena and Digital ERP)</entry>
- <entry>Mark Ackerman (Project Athena)</entry>
- </row>
- <row><?dbfo row-height="0.5cm"?>
- <entry>Ron Newman (Project Athena)</entry>
- <entry>Bob Scheifler (MIT LCS)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-The contributors to the X10 toolkit also deserve mention. Although the X11 Intrinsics present an
-entirely different programming style, they borrow heavily from the implicit and
-explicit concepts in the X10 toolkit.
-</para>
-
-<para>
-The design and implementation of the X10 Intrinsics were done by:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='1' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <tbody>
- <row>
- <entry>Terry Weissman (Digital WSL)</entry>
- </row>
- <row>
- <entry>Smokey Wallace (Digital WSL)</entry>
- </row>
- <row>
- <entry>Phil Karlton (Digital WSL)</entry>
- </row>
- <row>
- <entry>Charles Haynes (Digital WSL)</entry>
- </row>
- <row>
- <entry>Frank Hall (HP)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-The design and implementation of the X10 toolkit’s sample widgets were by
-the above, as well as by:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='1' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <tbody>
- <row>
- <entry>Ram Rao (Digital UEG)</entry>
- </row>
- <row>
- <entry>Mary Larson (Digital UEG)</entry>
- </row>
- <row>
- <entry>Mike Gancarz (Digital UEG)</entry>
- </row>
- <row>
- <entry>Kathleen Langone (Digital UEG)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-These widgets provided a checklist of requirements that we had to address in the X11 Intrinsics.
-</para>
-<para>
-Thanks go to Al Mento of Digital’s UEG Documentation Group for formatting and generally
-improving this document and to John Ousterhout of Berkeley for extensively reviewing early
-drafts of it.
-</para>
-<para>
-Finally, a special thanks to Mike Chow, whose extensive performance analysis of the X10 toolkit
-provided the justification to redesign it entirely for X11.
-</para>
-
-<literallayout>
-Joel McCormack
-Western Software Laboratory
-Digital Equipment Corporation
-March 1988
-</literallayout>
-
-
-<para>
-The current design of the Intrinsics has benefited greatly from the
-input of several dedicated reviewers in the membership of the X
-Consortium. In addition to those already mentioned, the following
-individuals have dedicated significant time to suggesting improvements
-to the Intrinsics:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='2' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <colspec colwidth='1.0*' />
- <tbody>
- <row>
- <entry>Steve Pitschke (Stellar)</entry>
- <entry>C.Doug Blewett (AT&amp;T)</entry>
- </row>
- <row>
- <entry>Bob Miller (HP)</entry>
- <entry>David Schiferl (Tektronix)</entry>
- </row>
- <row>
- <entry>Fred Taft (HP)</entry>
- <entry>Michael Squires (Sequent)</entry>
- </row>
- <row>
- <entry>Marcel Meth (AT&amp;T)</entry>
- <entry>JimFulton (MIT)</entry>
- </row>
- <row>
- <entry>Mike Collins (Digital)</entry>
- <entry>Kerry Kimbrough (Texas Instruments)</entry>
- </row>
- <row>
- <entry>Scott McGregor (Digital)</entry>
- <entry>Phil Karlton (Digital)</entry>
- </row>
- <row>
- <entry>Julian Payne (ESS)</entry>
- <entry>Jacques Davy (Bull)</entry>
- </row>
- <row>
- <entry>Gabriel Beged-Dov (HP)</entry>
- <entry>GlennWidener (Tektronix)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-Thanks go to each of them for the countless hours spent reviewing drafts and code.
-</para>
-
-<literallayout>
-Ralph R. Swick
-External Research Group
-Digital Equipment Corporation
-MIT Project Athena
-June 1988
-</literallayout>
-
-
-<para>
-From Release 3 to Release 4, several new members joined the design team. We greatly appreciate
-the thoughtful comments, suggestions, lengthy discussions, and in some cases implementation
-code contributed by each of the following:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='2' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <colspec colwidth='1.0*' />
- <tbody>
- <row>
- <entry>Don Alecci (AT&amp;T)</entry>
- <entry>EllisCohen (OSF)</entry>
- </row>
- <row>
- <entry>Donna Converse (MIT)</entry>
- <entry>Clive Feather (IXI)</entry>
- </row>
- <row>
- <entry>Nayeem Islam (Sun)</entry>
- <entry>Dana Laursen (HP)</entry>
- </row>
- <row>
- <entry>Keith Packard (MIT)</entry>
- <entry>Chris Peterson (MIT)</entry>
- </row>
- <row>
- <entry>Richard Probst (Sun)</entry>
- <entry>Larry Cable (Sun)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-In Release 5, the effort to define the internationalization additions was headed by Bill McMahon
-of Hewlett Packard and Frank Rojas of IBM. This has been an educational process for many of
-us, and Bill and Frank’s tutelage has carried us through. Vania Joloboff of the OSF also contributed
-to the internationalization additions. The implementation efforts of Bill, Gabe Beged-Dov,
-and especially Donna Converse for this release are also gratefully acknowledged.
-</para>
-
-<literallayout>
-Ralph R. Swick
-December 1989
-and
-July 1991
-</literallayout>
-
-<?dbfo-need height="5in" space-before="30em" ?>
-<para>
-The Release 6 Intrinsics is a result of the collaborative efforts of participants in the X Consortium’s
-intrinsics working group. A few individuals contributed substantial design proposals, participated
-in lengthy discussions, reviewed final specifications, and in most cases, were also
-responsible for sections of the implementation. They deserve recognition and thanks for their
-major contributions:
-</para>
-
-<sidebar>
-<informaltable frame='none'>
-<?dbfo keep-together="always" ?>
- <tgroup cols='2' rowsep='0' colsep='0'>
- <colspec colwidth='1.0*' />
- <colspec colwidth='1.0*' />
- <tbody>
- <row>
- <entry>Paul Asente (Adobe)</entry>
- <entry>Larry Cable (SunSoft)</entry>
- </row>
- <row>
- <entry>Ellis Cohen (OSF)</entry>
- <entry>Daniel Dardailler (OSF)</entry>
- </row>
- <row>
- <entry>Vania Joloboff (OSF)</entry>
- <entry>KalebKeithley (X Consortium)</entry>
- </row>
- <row>
- <entry>Courtney Loomis (HP)</entry>
- <entry>Douglas Rand (OSF)</entry>
- </row>
- <row>
- <entry>Bob Scheifler (X Consortium)</entry>
- <entry>Ajay Vohra (SunSoft)</entry>
- </row>
- </tbody>
- </tgroup>
-</informaltable>
-</sidebar>
-
-<para>
-Many others analyzed designs, offered useful comments and suggestions, and participated in a
-significant subset of the process. The following people deserve thanks for their contributions:
-Andy Bovingdon, Sam Chang, Chris Craig, George Erwin-Grotsky, Keith Edwards, Clive
-Feather, Stephen Gildea, Dan Heller, Steve Humphrey, David Kaelbling, Jaime Lau, Rob Lembree,
-Stuart Marks, Beth Mynatt, Tom Paquin, Chris Peterson, Kamesh Ramakrishna, Tom
-Rodriguez, Jim VanGilder, Will Walker, and Mike Wexler.
-</para>
-
-<para>
-I am especially grateful to two of my colleagues: Ralph Swick for expert editorial guidance, and
-Kaleb Keithley for leadership in the implementation and the specification work.
-</para>
-
-<literallayout>
-Donna Converse
-X Consortium
-April 1994
-</literallayout>
+<preface id='About_This_Manual'>
+<title>About This Manual</title>
+
+<para>
+X Toolkit Intrinsics — C Language Interface is intended to be read by both application programmers
+who will use one or more of the many widget sets built with the Intrinsics and by widget
+programmers who will use the Intrinsics to build widgets for one of the widget sets. Not all the
+information in this manual, however, applies to both audiences. That is, because the application
+programmer is likely to use only a number of the Intrinsics functions in writing an application and
+because the widget programmer is likely to use many more, if not all, of the Intrinsics functions
+in building a widget, an attempt has been made to highlight those areas of information that are
+deemed to be of special interest for the application programmer. (It is assumed the widget programmer
+will have to be familiar with all the information.) Therefore, all entries in the table of
+contents that are printed in <emphasis role='bold'>bold</emphasis> indicate the information that
+should be of special interest to an application programmer.
+</para>
+<para>
+It is also assumed that, as application programmers become more familiar with the concepts discussed
+in this manual, they will find it more convenient to implement portions of their applications
+as special-purpose or custom widgets. It is possible, nonetheless, to use widgets without
+knowing how to build them.
+</para>
+
+<bridgehead><emphasis role='bold'>Conventions Used in this Manual</emphasis></bridgehead>
+<para>This document uses the following conventions:</para>
+<itemizedlist>
+ <listitem>
+ <para>
+Global symbols are printed in <function>this special font</function>. These can be either
+function names, symbols defined in include files, data types, or structure names. Arguments to
+functions, procedures, or macros are printed in italics.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+Each function is introduced by a general discussion that distinguishes it from other functions.
+The function declaration itself follows, and each argument is specifically explained.
+General discussion of the function, if any is required, follows the arguments.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+To eliminate any ambiguity between those arguments that you pass and those that a function
+returns to you, the explanations for all arguments that you pass start with the word
+specifies or, in the case of multiple arguments, the word specify. The explanations for all
+arguments that are returned to you start with the word <emphasis>returns</emphasis> or, in
+the case of multiple arguments, the word <emphasis>return</emphasis>.
+ </para>
+ </listitem>
+</itemizedlist>
</preface>